json_ada_fda3e8b1/json/src/json-parsers.ads

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
--  SPDX-License-Identifier: Apache-2.0
--
--  Copyright (c) 2016 onox <denkpadje@gmail.com>
--
--  Licensed under the Apache License, Version 2.0 (the "License");
--  you may not use this file except in compliance with the License.
--  You may obtain a copy of the License at
--
--      http://www.apache.org/licenses/LICENSE-2.0
--
--  Unless required by applicable law or agreed to in writing, software
--  distributed under the License is distributed on an "AS IS" BASIS,
--  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
--  See the License for the specific language governing permissions and
--  limitations under the License.

private with Ada.Containers.Indefinite_Holders;
private with Ada.Finalization;

with JSON.Types;
with JSON.Streams;

generic
   with package Types is new JSON.Types (<>);

   Default_Maximum_Depth : Positive := 10;

   Check_Duplicate_Keys  : Boolean  := False;
   --  If enabled, raise a Constraint_Error when an object contains
   --  duplicate keys. Parsing a JSON text will be slower if enabled.
package JSON.Parsers with SPARK_Mode => On is
   pragma Preelaborate;

   type Parser is tagged limited private;

   function Create
     (Pointer       : not null JSON.Streams.Stream_Element_Array_Access;
      Maximum_Depth : Positive := Default_Maximum_Depth) return Parser;

   function Create
     (Text          : String;
      Maximum_Depth : Positive := Default_Maximum_Depth) return Parser;

   function Create_From_File
     (File_Name     : String;
      Maximum_Depth : Positive := Default_Maximum_Depth) return Parser;

   function Parse (Object : in out Parser) return Types.JSON_Value;

   Parse_Error : exception;

private

   package Stream_Holders is new Ada.Containers.Indefinite_Holders
     (Element_Type => Streams.Stream, "=" => Streams."=");

   package Memory_Holders is new Ada.Containers.Indefinite_Holders
     (Element_Type => Types.Memory_Allocator, "=" => Types."=");

   package AF renames Ada.Finalization;

   type Parser is limited new AF.Limited_Controlled with record
      Stream      : Stream_Holders.Holder;
      Allocator   : Memory_Holders.Holder;
      Pointer     : Streams.Stream_Element_Array_Access;
      Own_Pointer : Boolean;
   end record;

   overriding
   procedure Finalize (Object : in out Parser);

end JSON.Parsers;