|
74
|
1 //
|
|
|
2 // Copyright (c) 2011-2019 Canonical Ltd
|
|
|
3 // Copyright (c) 2006-2010 Kirill Simonov
|
|
|
4 //
|
|
|
5 // Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
|
6 // this software and associated documentation files (the "Software"), to deal in
|
|
|
7 // the Software without restriction, including without limitation the rights to
|
|
|
8 // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
|
9 // of the Software, and to permit persons to whom the Software is furnished to do
|
|
|
10 // so, subject to the following conditions:
|
|
|
11 //
|
|
|
12 // The above copyright notice and this permission notice shall be included in all
|
|
|
13 // copies or substantial portions of the Software.
|
|
|
14 //
|
|
|
15 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
16 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
17 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
18 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
19 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
20 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
|
21 // SOFTWARE.
|
|
|
22
|
|
|
23 package yaml
|
|
|
24
|
|
|
25 import (
|
|
|
26 "fmt"
|
|
|
27 "io"
|
|
|
28 )
|
|
|
29
|
|
|
30 // The version directive data.
|
|
|
31 type yaml_version_directive_t struct {
|
|
|
32 major int8 // The major version number.
|
|
|
33 minor int8 // The minor version number.
|
|
|
34 }
|
|
|
35
|
|
|
36 // The tag directive data.
|
|
|
37 type yaml_tag_directive_t struct {
|
|
|
38 handle []byte // The tag handle.
|
|
|
39 prefix []byte // The tag prefix.
|
|
|
40 }
|
|
|
41
|
|
|
42 type yaml_encoding_t int
|
|
|
43
|
|
|
44 // The stream encoding.
|
|
|
45 const (
|
|
|
46 // Let the parser choose the encoding.
|
|
|
47 yaml_ANY_ENCODING yaml_encoding_t = iota
|
|
|
48
|
|
|
49 yaml_UTF8_ENCODING // The default UTF-8 encoding.
|
|
|
50 yaml_UTF16LE_ENCODING // The UTF-16-LE encoding with BOM.
|
|
|
51 yaml_UTF16BE_ENCODING // The UTF-16-BE encoding with BOM.
|
|
|
52 )
|
|
|
53
|
|
|
54 type yaml_break_t int
|
|
|
55
|
|
|
56 // Line break types.
|
|
|
57 const (
|
|
|
58 // Let the parser choose the break type.
|
|
|
59 yaml_ANY_BREAK yaml_break_t = iota
|
|
|
60
|
|
|
61 yaml_CR_BREAK // Use CR for line breaks (Mac style).
|
|
|
62 yaml_LN_BREAK // Use LN for line breaks (Unix style).
|
|
|
63 yaml_CRLN_BREAK // Use CR LN for line breaks (DOS style).
|
|
|
64 )
|
|
|
65
|
|
|
66 type yaml_error_type_t int
|
|
|
67
|
|
|
68 // Many bad things could happen with the parser and emitter.
|
|
|
69 const (
|
|
|
70 // No error is produced.
|
|
|
71 yaml_NO_ERROR yaml_error_type_t = iota
|
|
|
72
|
|
|
73 yaml_MEMORY_ERROR // Cannot allocate or reallocate a block of memory.
|
|
|
74 yaml_READER_ERROR // Cannot read or decode the input stream.
|
|
|
75 yaml_SCANNER_ERROR // Cannot scan the input stream.
|
|
|
76 yaml_PARSER_ERROR // Cannot parse the input stream.
|
|
|
77 yaml_COMPOSER_ERROR // Cannot compose a YAML document.
|
|
|
78 yaml_WRITER_ERROR // Cannot write to the output stream.
|
|
|
79 yaml_EMITTER_ERROR // Cannot emit a YAML stream.
|
|
|
80 )
|
|
|
81
|
|
|
82 // The pointer position.
|
|
|
83 type yaml_mark_t struct {
|
|
|
84 index int // The position index.
|
|
|
85 line int // The position line.
|
|
|
86 column int // The position column.
|
|
|
87 }
|
|
|
88
|
|
|
89 // Node Styles
|
|
|
90
|
|
|
91 type yaml_style_t int8
|
|
|
92
|
|
|
93 type yaml_scalar_style_t yaml_style_t
|
|
|
94
|
|
|
95 // Scalar styles.
|
|
|
96 const (
|
|
|
97 // Let the emitter choose the style.
|
|
|
98 yaml_ANY_SCALAR_STYLE yaml_scalar_style_t = 0
|
|
|
99
|
|
|
100 yaml_PLAIN_SCALAR_STYLE yaml_scalar_style_t = 1 << iota // The plain scalar style.
|
|
|
101 yaml_SINGLE_QUOTED_SCALAR_STYLE // The single-quoted scalar style.
|
|
|
102 yaml_DOUBLE_QUOTED_SCALAR_STYLE // The double-quoted scalar style.
|
|
|
103 yaml_LITERAL_SCALAR_STYLE // The literal scalar style.
|
|
|
104 yaml_FOLDED_SCALAR_STYLE // The folded scalar style.
|
|
|
105 )
|
|
|
106
|
|
|
107 type yaml_sequence_style_t yaml_style_t
|
|
|
108
|
|
|
109 // Sequence styles.
|
|
|
110 const (
|
|
|
111 // Let the emitter choose the style.
|
|
|
112 yaml_ANY_SEQUENCE_STYLE yaml_sequence_style_t = iota
|
|
|
113
|
|
|
114 yaml_BLOCK_SEQUENCE_STYLE // The block sequence style.
|
|
|
115 yaml_FLOW_SEQUENCE_STYLE // The flow sequence style.
|
|
|
116 )
|
|
|
117
|
|
|
118 type yaml_mapping_style_t yaml_style_t
|
|
|
119
|
|
|
120 // Mapping styles.
|
|
|
121 const (
|
|
|
122 // Let the emitter choose the style.
|
|
|
123 yaml_ANY_MAPPING_STYLE yaml_mapping_style_t = iota
|
|
|
124
|
|
|
125 yaml_BLOCK_MAPPING_STYLE // The block mapping style.
|
|
|
126 yaml_FLOW_MAPPING_STYLE // The flow mapping style.
|
|
|
127 )
|
|
|
128
|
|
|
129 // Tokens
|
|
|
130
|
|
|
131 type yaml_token_type_t int
|
|
|
132
|
|
|
133 // Token types.
|
|
|
134 const (
|
|
|
135 // An empty token.
|
|
|
136 yaml_NO_TOKEN yaml_token_type_t = iota
|
|
|
137
|
|
|
138 yaml_STREAM_START_TOKEN // A STREAM-START token.
|
|
|
139 yaml_STREAM_END_TOKEN // A STREAM-END token.
|
|
|
140
|
|
|
141 yaml_VERSION_DIRECTIVE_TOKEN // A VERSION-DIRECTIVE token.
|
|
|
142 yaml_TAG_DIRECTIVE_TOKEN // A TAG-DIRECTIVE token.
|
|
|
143 yaml_DOCUMENT_START_TOKEN // A DOCUMENT-START token.
|
|
|
144 yaml_DOCUMENT_END_TOKEN // A DOCUMENT-END token.
|
|
|
145
|
|
|
146 yaml_BLOCK_SEQUENCE_START_TOKEN // A BLOCK-SEQUENCE-START token.
|
|
|
147 yaml_BLOCK_MAPPING_START_TOKEN // A BLOCK-SEQUENCE-END token.
|
|
|
148 yaml_BLOCK_END_TOKEN // A BLOCK-END token.
|
|
|
149
|
|
|
150 yaml_FLOW_SEQUENCE_START_TOKEN // A FLOW-SEQUENCE-START token.
|
|
|
151 yaml_FLOW_SEQUENCE_END_TOKEN // A FLOW-SEQUENCE-END token.
|
|
|
152 yaml_FLOW_MAPPING_START_TOKEN // A FLOW-MAPPING-START token.
|
|
|
153 yaml_FLOW_MAPPING_END_TOKEN // A FLOW-MAPPING-END token.
|
|
|
154
|
|
|
155 yaml_BLOCK_ENTRY_TOKEN // A BLOCK-ENTRY token.
|
|
|
156 yaml_FLOW_ENTRY_TOKEN // A FLOW-ENTRY token.
|
|
|
157 yaml_KEY_TOKEN // A KEY token.
|
|
|
158 yaml_VALUE_TOKEN // A VALUE token.
|
|
|
159
|
|
|
160 yaml_ALIAS_TOKEN // An ALIAS token.
|
|
|
161 yaml_ANCHOR_TOKEN // An ANCHOR token.
|
|
|
162 yaml_TAG_TOKEN // A TAG token.
|
|
|
163 yaml_SCALAR_TOKEN // A SCALAR token.
|
|
|
164 )
|
|
|
165
|
|
|
166 func (tt yaml_token_type_t) String() string {
|
|
|
167 switch tt {
|
|
|
168 case yaml_NO_TOKEN:
|
|
|
169 return "yaml_NO_TOKEN"
|
|
|
170 case yaml_STREAM_START_TOKEN:
|
|
|
171 return "yaml_STREAM_START_TOKEN"
|
|
|
172 case yaml_STREAM_END_TOKEN:
|
|
|
173 return "yaml_STREAM_END_TOKEN"
|
|
|
174 case yaml_VERSION_DIRECTIVE_TOKEN:
|
|
|
175 return "yaml_VERSION_DIRECTIVE_TOKEN"
|
|
|
176 case yaml_TAG_DIRECTIVE_TOKEN:
|
|
|
177 return "yaml_TAG_DIRECTIVE_TOKEN"
|
|
|
178 case yaml_DOCUMENT_START_TOKEN:
|
|
|
179 return "yaml_DOCUMENT_START_TOKEN"
|
|
|
180 case yaml_DOCUMENT_END_TOKEN:
|
|
|
181 return "yaml_DOCUMENT_END_TOKEN"
|
|
|
182 case yaml_BLOCK_SEQUENCE_START_TOKEN:
|
|
|
183 return "yaml_BLOCK_SEQUENCE_START_TOKEN"
|
|
|
184 case yaml_BLOCK_MAPPING_START_TOKEN:
|
|
|
185 return "yaml_BLOCK_MAPPING_START_TOKEN"
|
|
|
186 case yaml_BLOCK_END_TOKEN:
|
|
|
187 return "yaml_BLOCK_END_TOKEN"
|
|
|
188 case yaml_FLOW_SEQUENCE_START_TOKEN:
|
|
|
189 return "yaml_FLOW_SEQUENCE_START_TOKEN"
|
|
|
190 case yaml_FLOW_SEQUENCE_END_TOKEN:
|
|
|
191 return "yaml_FLOW_SEQUENCE_END_TOKEN"
|
|
|
192 case yaml_FLOW_MAPPING_START_TOKEN:
|
|
|
193 return "yaml_FLOW_MAPPING_START_TOKEN"
|
|
|
194 case yaml_FLOW_MAPPING_END_TOKEN:
|
|
|
195 return "yaml_FLOW_MAPPING_END_TOKEN"
|
|
|
196 case yaml_BLOCK_ENTRY_TOKEN:
|
|
|
197 return "yaml_BLOCK_ENTRY_TOKEN"
|
|
|
198 case yaml_FLOW_ENTRY_TOKEN:
|
|
|
199 return "yaml_FLOW_ENTRY_TOKEN"
|
|
|
200 case yaml_KEY_TOKEN:
|
|
|
201 return "yaml_KEY_TOKEN"
|
|
|
202 case yaml_VALUE_TOKEN:
|
|
|
203 return "yaml_VALUE_TOKEN"
|
|
|
204 case yaml_ALIAS_TOKEN:
|
|
|
205 return "yaml_ALIAS_TOKEN"
|
|
|
206 case yaml_ANCHOR_TOKEN:
|
|
|
207 return "yaml_ANCHOR_TOKEN"
|
|
|
208 case yaml_TAG_TOKEN:
|
|
|
209 return "yaml_TAG_TOKEN"
|
|
|
210 case yaml_SCALAR_TOKEN:
|
|
|
211 return "yaml_SCALAR_TOKEN"
|
|
|
212 }
|
|
|
213 return "<unknown token>"
|
|
|
214 }
|
|
|
215
|
|
|
216 // The token structure.
|
|
|
217 type yaml_token_t struct {
|
|
|
218 // The token type.
|
|
|
219 typ yaml_token_type_t
|
|
|
220
|
|
|
221 // The start/end of the token.
|
|
|
222 start_mark, end_mark yaml_mark_t
|
|
|
223
|
|
|
224 // The stream encoding (for yaml_STREAM_START_TOKEN).
|
|
|
225 encoding yaml_encoding_t
|
|
|
226
|
|
|
227 // The alias/anchor/scalar value or tag/tag directive handle
|
|
|
228 // (for yaml_ALIAS_TOKEN, yaml_ANCHOR_TOKEN, yaml_SCALAR_TOKEN, yaml_TAG_TOKEN, yaml_TAG_DIRECTIVE_TOKEN).
|
|
|
229 value []byte
|
|
|
230
|
|
|
231 // The tag suffix (for yaml_TAG_TOKEN).
|
|
|
232 suffix []byte
|
|
|
233
|
|
|
234 // The tag directive prefix (for yaml_TAG_DIRECTIVE_TOKEN).
|
|
|
235 prefix []byte
|
|
|
236
|
|
|
237 // The scalar style (for yaml_SCALAR_TOKEN).
|
|
|
238 style yaml_scalar_style_t
|
|
|
239
|
|
|
240 // The version directive major/minor (for yaml_VERSION_DIRECTIVE_TOKEN).
|
|
|
241 major, minor int8
|
|
|
242 }
|
|
|
243
|
|
|
244 // Events
|
|
|
245
|
|
|
246 type yaml_event_type_t int8
|
|
|
247
|
|
|
248 // Event types.
|
|
|
249 const (
|
|
|
250 // An empty event.
|
|
|
251 yaml_NO_EVENT yaml_event_type_t = iota
|
|
|
252
|
|
|
253 yaml_STREAM_START_EVENT // A STREAM-START event.
|
|
|
254 yaml_STREAM_END_EVENT // A STREAM-END event.
|
|
|
255 yaml_DOCUMENT_START_EVENT // A DOCUMENT-START event.
|
|
|
256 yaml_DOCUMENT_END_EVENT // A DOCUMENT-END event.
|
|
|
257 yaml_ALIAS_EVENT // An ALIAS event.
|
|
|
258 yaml_SCALAR_EVENT // A SCALAR event.
|
|
|
259 yaml_SEQUENCE_START_EVENT // A SEQUENCE-START event.
|
|
|
260 yaml_SEQUENCE_END_EVENT // A SEQUENCE-END event.
|
|
|
261 yaml_MAPPING_START_EVENT // A MAPPING-START event.
|
|
|
262 yaml_MAPPING_END_EVENT // A MAPPING-END event.
|
|
|
263 yaml_TAIL_COMMENT_EVENT
|
|
|
264 )
|
|
|
265
|
|
|
266 var eventStrings = []string{
|
|
|
267 yaml_NO_EVENT: "none",
|
|
|
268 yaml_STREAM_START_EVENT: "stream start",
|
|
|
269 yaml_STREAM_END_EVENT: "stream end",
|
|
|
270 yaml_DOCUMENT_START_EVENT: "document start",
|
|
|
271 yaml_DOCUMENT_END_EVENT: "document end",
|
|
|
272 yaml_ALIAS_EVENT: "alias",
|
|
|
273 yaml_SCALAR_EVENT: "scalar",
|
|
|
274 yaml_SEQUENCE_START_EVENT: "sequence start",
|
|
|
275 yaml_SEQUENCE_END_EVENT: "sequence end",
|
|
|
276 yaml_MAPPING_START_EVENT: "mapping start",
|
|
|
277 yaml_MAPPING_END_EVENT: "mapping end",
|
|
|
278 yaml_TAIL_COMMENT_EVENT: "tail comment",
|
|
|
279 }
|
|
|
280
|
|
|
281 func (e yaml_event_type_t) String() string {
|
|
|
282 if e < 0 || int(e) >= len(eventStrings) {
|
|
|
283 return fmt.Sprintf("unknown event %d", e)
|
|
|
284 }
|
|
|
285 return eventStrings[e]
|
|
|
286 }
|
|
|
287
|
|
|
288 // The event structure.
|
|
|
289 type yaml_event_t struct {
|
|
|
290
|
|
|
291 // The event type.
|
|
|
292 typ yaml_event_type_t
|
|
|
293
|
|
|
294 // The start and end of the event.
|
|
|
295 start_mark, end_mark yaml_mark_t
|
|
|
296
|
|
|
297 // The document encoding (for yaml_STREAM_START_EVENT).
|
|
|
298 encoding yaml_encoding_t
|
|
|
299
|
|
|
300 // The version directive (for yaml_DOCUMENT_START_EVENT).
|
|
|
301 version_directive *yaml_version_directive_t
|
|
|
302
|
|
|
303 // The list of tag directives (for yaml_DOCUMENT_START_EVENT).
|
|
|
304 tag_directives []yaml_tag_directive_t
|
|
|
305
|
|
|
306 // The comments
|
|
|
307 head_comment []byte
|
|
|
308 line_comment []byte
|
|
|
309 foot_comment []byte
|
|
|
310 tail_comment []byte
|
|
|
311
|
|
|
312 // The anchor (for yaml_SCALAR_EVENT, yaml_SEQUENCE_START_EVENT, yaml_MAPPING_START_EVENT, yaml_ALIAS_EVENT).
|
|
|
313 anchor []byte
|
|
|
314
|
|
|
315 // The tag (for yaml_SCALAR_EVENT, yaml_SEQUENCE_START_EVENT, yaml_MAPPING_START_EVENT).
|
|
|
316 tag []byte
|
|
|
317
|
|
|
318 // The scalar value (for yaml_SCALAR_EVENT).
|
|
|
319 value []byte
|
|
|
320
|
|
|
321 // Is the document start/end indicator implicit, or the tag optional?
|
|
|
322 // (for yaml_DOCUMENT_START_EVENT, yaml_DOCUMENT_END_EVENT, yaml_SEQUENCE_START_EVENT, yaml_MAPPING_START_EVENT, yaml_SCALAR_EVENT).
|
|
|
323 implicit bool
|
|
|
324
|
|
|
325 // Is the tag optional for any non-plain style? (for yaml_SCALAR_EVENT).
|
|
|
326 quoted_implicit bool
|
|
|
327
|
|
|
328 // The style (for yaml_SCALAR_EVENT, yaml_SEQUENCE_START_EVENT, yaml_MAPPING_START_EVENT).
|
|
|
329 style yaml_style_t
|
|
|
330 }
|
|
|
331
|
|
|
332 func (e *yaml_event_t) scalar_style() yaml_scalar_style_t { return yaml_scalar_style_t(e.style) }
|
|
|
333 func (e *yaml_event_t) sequence_style() yaml_sequence_style_t { return yaml_sequence_style_t(e.style) }
|
|
|
334 func (e *yaml_event_t) mapping_style() yaml_mapping_style_t { return yaml_mapping_style_t(e.style) }
|
|
|
335
|
|
|
336 // Nodes
|
|
|
337
|
|
|
338 const (
|
|
|
339 yaml_NULL_TAG = "tag:yaml.org,2002:null" // The tag !!null with the only possible value: null.
|
|
|
340 yaml_BOOL_TAG = "tag:yaml.org,2002:bool" // The tag !!bool with the values: true and false.
|
|
|
341 yaml_STR_TAG = "tag:yaml.org,2002:str" // The tag !!str for string values.
|
|
|
342 yaml_INT_TAG = "tag:yaml.org,2002:int" // The tag !!int for integer values.
|
|
|
343 yaml_FLOAT_TAG = "tag:yaml.org,2002:float" // The tag !!float for float values.
|
|
|
344 yaml_TIMESTAMP_TAG = "tag:yaml.org,2002:timestamp" // The tag !!timestamp for date and time values.
|
|
|
345
|
|
|
346 yaml_SEQ_TAG = "tag:yaml.org,2002:seq" // The tag !!seq is used to denote sequences.
|
|
|
347 yaml_MAP_TAG = "tag:yaml.org,2002:map" // The tag !!map is used to denote mapping.
|
|
|
348
|
|
|
349 // Not in original libyaml.
|
|
|
350 yaml_BINARY_TAG = "tag:yaml.org,2002:binary"
|
|
|
351 yaml_MERGE_TAG = "tag:yaml.org,2002:merge"
|
|
|
352
|
|
|
353 yaml_DEFAULT_SCALAR_TAG = yaml_STR_TAG // The default scalar tag is !!str.
|
|
|
354 yaml_DEFAULT_SEQUENCE_TAG = yaml_SEQ_TAG // The default sequence tag is !!seq.
|
|
|
355 yaml_DEFAULT_MAPPING_TAG = yaml_MAP_TAG // The default mapping tag is !!map.
|
|
|
356 )
|
|
|
357
|
|
|
358 type yaml_node_type_t int
|
|
|
359
|
|
|
360 // Node types.
|
|
|
361 const (
|
|
|
362 // An empty node.
|
|
|
363 yaml_NO_NODE yaml_node_type_t = iota
|
|
|
364
|
|
|
365 yaml_SCALAR_NODE // A scalar node.
|
|
|
366 yaml_SEQUENCE_NODE // A sequence node.
|
|
|
367 yaml_MAPPING_NODE // A mapping node.
|
|
|
368 )
|
|
|
369
|
|
|
370 // An element of a sequence node.
|
|
|
371 type yaml_node_item_t int
|
|
|
372
|
|
|
373 // An element of a mapping node.
|
|
|
374 type yaml_node_pair_t struct {
|
|
|
375 key int // The key of the element.
|
|
|
376 value int // The value of the element.
|
|
|
377 }
|
|
|
378
|
|
|
379 // The node structure.
|
|
|
380 type yaml_node_t struct {
|
|
|
381 typ yaml_node_type_t // The node type.
|
|
|
382 tag []byte // The node tag.
|
|
|
383
|
|
|
384 // The node data.
|
|
|
385
|
|
|
386 // The scalar parameters (for yaml_SCALAR_NODE).
|
|
|
387 scalar struct {
|
|
|
388 value []byte // The scalar value.
|
|
|
389 length int // The length of the scalar value.
|
|
|
390 style yaml_scalar_style_t // The scalar style.
|
|
|
391 }
|
|
|
392
|
|
|
393 // The sequence parameters (for YAML_SEQUENCE_NODE).
|
|
|
394 sequence struct {
|
|
|
395 items_data []yaml_node_item_t // The stack of sequence items.
|
|
|
396 style yaml_sequence_style_t // The sequence style.
|
|
|
397 }
|
|
|
398
|
|
|
399 // The mapping parameters (for yaml_MAPPING_NODE).
|
|
|
400 mapping struct {
|
|
|
401 pairs_data []yaml_node_pair_t // The stack of mapping pairs (key, value).
|
|
|
402 pairs_start *yaml_node_pair_t // The beginning of the stack.
|
|
|
403 pairs_end *yaml_node_pair_t // The end of the stack.
|
|
|
404 pairs_top *yaml_node_pair_t // The top of the stack.
|
|
|
405 style yaml_mapping_style_t // The mapping style.
|
|
|
406 }
|
|
|
407
|
|
|
408 start_mark yaml_mark_t // The beginning of the node.
|
|
|
409 end_mark yaml_mark_t // The end of the node.
|
|
|
410
|
|
|
411 }
|
|
|
412
|
|
|
413 // The document structure.
|
|
|
414 type yaml_document_t struct {
|
|
|
415
|
|
|
416 // The document nodes.
|
|
|
417 nodes []yaml_node_t
|
|
|
418
|
|
|
419 // The version directive.
|
|
|
420 version_directive *yaml_version_directive_t
|
|
|
421
|
|
|
422 // The list of tag directives.
|
|
|
423 tag_directives_data []yaml_tag_directive_t
|
|
|
424 tag_directives_start int // The beginning of the tag directives list.
|
|
|
425 tag_directives_end int // The end of the tag directives list.
|
|
|
426
|
|
|
427 start_implicit int // Is the document start indicator implicit?
|
|
|
428 end_implicit int // Is the document end indicator implicit?
|
|
|
429
|
|
|
430 // The start/end of the document.
|
|
|
431 start_mark, end_mark yaml_mark_t
|
|
|
432 }
|
|
|
433
|
|
|
434 // The prototype of a read handler.
|
|
|
435 //
|
|
|
436 // The read handler is called when the parser needs to read more bytes from the
|
|
|
437 // source. The handler should write not more than size bytes to the buffer.
|
|
|
438 // The number of written bytes should be set to the size_read variable.
|
|
|
439 //
|
|
|
440 // [in,out] data A pointer to an application data specified by
|
|
|
441 // yaml_parser_set_input().
|
|
|
442 // [out] buffer The buffer to write the data from the source.
|
|
|
443 // [in] size The size of the buffer.
|
|
|
444 // [out] size_read The actual number of bytes read from the source.
|
|
|
445 //
|
|
|
446 // On success, the handler should return 1. If the handler failed,
|
|
|
447 // the returned value should be 0. On EOF, the handler should set the
|
|
|
448 // size_read to 0 and return 1.
|
|
|
449 type yaml_read_handler_t func(parser *yaml_parser_t, buffer []byte) (n int, err error)
|
|
|
450
|
|
|
451 // This structure holds information about a potential simple key.
|
|
|
452 type yaml_simple_key_t struct {
|
|
|
453 possible bool // Is a simple key possible?
|
|
|
454 required bool // Is a simple key required?
|
|
|
455 token_number int // The number of the token.
|
|
|
456 mark yaml_mark_t // The position mark.
|
|
|
457 }
|
|
|
458
|
|
|
459 // The states of the parser.
|
|
|
460 type yaml_parser_state_t int
|
|
|
461
|
|
|
462 const (
|
|
|
463 yaml_PARSE_STREAM_START_STATE yaml_parser_state_t = iota
|
|
|
464
|
|
|
465 yaml_PARSE_IMPLICIT_DOCUMENT_START_STATE // Expect the beginning of an implicit document.
|
|
|
466 yaml_PARSE_DOCUMENT_START_STATE // Expect DOCUMENT-START.
|
|
|
467 yaml_PARSE_DOCUMENT_CONTENT_STATE // Expect the content of a document.
|
|
|
468 yaml_PARSE_DOCUMENT_END_STATE // Expect DOCUMENT-END.
|
|
|
469 yaml_PARSE_BLOCK_NODE_STATE // Expect a block node.
|
|
|
470 yaml_PARSE_BLOCK_NODE_OR_INDENTLESS_SEQUENCE_STATE // Expect a block node or indentless sequence.
|
|
|
471 yaml_PARSE_FLOW_NODE_STATE // Expect a flow node.
|
|
|
472 yaml_PARSE_BLOCK_SEQUENCE_FIRST_ENTRY_STATE // Expect the first entry of a block sequence.
|
|
|
473 yaml_PARSE_BLOCK_SEQUENCE_ENTRY_STATE // Expect an entry of a block sequence.
|
|
|
474 yaml_PARSE_INDENTLESS_SEQUENCE_ENTRY_STATE // Expect an entry of an indentless sequence.
|
|
|
475 yaml_PARSE_BLOCK_MAPPING_FIRST_KEY_STATE // Expect the first key of a block mapping.
|
|
|
476 yaml_PARSE_BLOCK_MAPPING_KEY_STATE // Expect a block mapping key.
|
|
|
477 yaml_PARSE_BLOCK_MAPPING_VALUE_STATE // Expect a block mapping value.
|
|
|
478 yaml_PARSE_FLOW_SEQUENCE_FIRST_ENTRY_STATE // Expect the first entry of a flow sequence.
|
|
|
479 yaml_PARSE_FLOW_SEQUENCE_ENTRY_STATE // Expect an entry of a flow sequence.
|
|
|
480 yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_KEY_STATE // Expect a key of an ordered mapping.
|
|
|
481 yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_VALUE_STATE // Expect a value of an ordered mapping.
|
|
|
482 yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_END_STATE // Expect the and of an ordered mapping entry.
|
|
|
483 yaml_PARSE_FLOW_MAPPING_FIRST_KEY_STATE // Expect the first key of a flow mapping.
|
|
|
484 yaml_PARSE_FLOW_MAPPING_KEY_STATE // Expect a key of a flow mapping.
|
|
|
485 yaml_PARSE_FLOW_MAPPING_VALUE_STATE // Expect a value of a flow mapping.
|
|
|
486 yaml_PARSE_FLOW_MAPPING_EMPTY_VALUE_STATE // Expect an empty value of a flow mapping.
|
|
|
487 yaml_PARSE_END_STATE // Expect nothing.
|
|
|
488 )
|
|
|
489
|
|
|
490 func (ps yaml_parser_state_t) String() string {
|
|
|
491 switch ps {
|
|
|
492 case yaml_PARSE_STREAM_START_STATE:
|
|
|
493 return "yaml_PARSE_STREAM_START_STATE"
|
|
|
494 case yaml_PARSE_IMPLICIT_DOCUMENT_START_STATE:
|
|
|
495 return "yaml_PARSE_IMPLICIT_DOCUMENT_START_STATE"
|
|
|
496 case yaml_PARSE_DOCUMENT_START_STATE:
|
|
|
497 return "yaml_PARSE_DOCUMENT_START_STATE"
|
|
|
498 case yaml_PARSE_DOCUMENT_CONTENT_STATE:
|
|
|
499 return "yaml_PARSE_DOCUMENT_CONTENT_STATE"
|
|
|
500 case yaml_PARSE_DOCUMENT_END_STATE:
|
|
|
501 return "yaml_PARSE_DOCUMENT_END_STATE"
|
|
|
502 case yaml_PARSE_BLOCK_NODE_STATE:
|
|
|
503 return "yaml_PARSE_BLOCK_NODE_STATE"
|
|
|
504 case yaml_PARSE_BLOCK_NODE_OR_INDENTLESS_SEQUENCE_STATE:
|
|
|
505 return "yaml_PARSE_BLOCK_NODE_OR_INDENTLESS_SEQUENCE_STATE"
|
|
|
506 case yaml_PARSE_FLOW_NODE_STATE:
|
|
|
507 return "yaml_PARSE_FLOW_NODE_STATE"
|
|
|
508 case yaml_PARSE_BLOCK_SEQUENCE_FIRST_ENTRY_STATE:
|
|
|
509 return "yaml_PARSE_BLOCK_SEQUENCE_FIRST_ENTRY_STATE"
|
|
|
510 case yaml_PARSE_BLOCK_SEQUENCE_ENTRY_STATE:
|
|
|
511 return "yaml_PARSE_BLOCK_SEQUENCE_ENTRY_STATE"
|
|
|
512 case yaml_PARSE_INDENTLESS_SEQUENCE_ENTRY_STATE:
|
|
|
513 return "yaml_PARSE_INDENTLESS_SEQUENCE_ENTRY_STATE"
|
|
|
514 case yaml_PARSE_BLOCK_MAPPING_FIRST_KEY_STATE:
|
|
|
515 return "yaml_PARSE_BLOCK_MAPPING_FIRST_KEY_STATE"
|
|
|
516 case yaml_PARSE_BLOCK_MAPPING_KEY_STATE:
|
|
|
517 return "yaml_PARSE_BLOCK_MAPPING_KEY_STATE"
|
|
|
518 case yaml_PARSE_BLOCK_MAPPING_VALUE_STATE:
|
|
|
519 return "yaml_PARSE_BLOCK_MAPPING_VALUE_STATE"
|
|
|
520 case yaml_PARSE_FLOW_SEQUENCE_FIRST_ENTRY_STATE:
|
|
|
521 return "yaml_PARSE_FLOW_SEQUENCE_FIRST_ENTRY_STATE"
|
|
|
522 case yaml_PARSE_FLOW_SEQUENCE_ENTRY_STATE:
|
|
|
523 return "yaml_PARSE_FLOW_SEQUENCE_ENTRY_STATE"
|
|
|
524 case yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_KEY_STATE:
|
|
|
525 return "yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_KEY_STATE"
|
|
|
526 case yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_VALUE_STATE:
|
|
|
527 return "yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_VALUE_STATE"
|
|
|
528 case yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_END_STATE:
|
|
|
529 return "yaml_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_END_STATE"
|
|
|
530 case yaml_PARSE_FLOW_MAPPING_FIRST_KEY_STATE:
|
|
|
531 return "yaml_PARSE_FLOW_MAPPING_FIRST_KEY_STATE"
|
|
|
532 case yaml_PARSE_FLOW_MAPPING_KEY_STATE:
|
|
|
533 return "yaml_PARSE_FLOW_MAPPING_KEY_STATE"
|
|
|
534 case yaml_PARSE_FLOW_MAPPING_VALUE_STATE:
|
|
|
535 return "yaml_PARSE_FLOW_MAPPING_VALUE_STATE"
|
|
|
536 case yaml_PARSE_FLOW_MAPPING_EMPTY_VALUE_STATE:
|
|
|
537 return "yaml_PARSE_FLOW_MAPPING_EMPTY_VALUE_STATE"
|
|
|
538 case yaml_PARSE_END_STATE:
|
|
|
539 return "yaml_PARSE_END_STATE"
|
|
|
540 }
|
|
|
541 return "<unknown parser state>"
|
|
|
542 }
|
|
|
543
|
|
|
544 // This structure holds aliases data.
|
|
|
545 type yaml_alias_data_t struct {
|
|
|
546 anchor []byte // The anchor.
|
|
|
547 index int // The node id.
|
|
|
548 mark yaml_mark_t // The anchor mark.
|
|
|
549 }
|
|
|
550
|
|
|
551 // The parser structure.
|
|
|
552 //
|
|
|
553 // All members are internal. Manage the structure using the
|
|
|
554 // yaml_parser_ family of functions.
|
|
|
555 type yaml_parser_t struct {
|
|
|
556
|
|
|
557 // Error handling
|
|
|
558
|
|
|
559 error yaml_error_type_t // Error type.
|
|
|
560
|
|
|
561 problem string // Error description.
|
|
|
562
|
|
|
563 // The byte about which the problem occurred.
|
|
|
564 problem_offset int
|
|
|
565 problem_value int
|
|
|
566 problem_mark yaml_mark_t
|
|
|
567
|
|
|
568 // The error context.
|
|
|
569 context string
|
|
|
570 context_mark yaml_mark_t
|
|
|
571
|
|
|
572 // Reader stuff
|
|
|
573
|
|
|
574 read_handler yaml_read_handler_t // Read handler.
|
|
|
575
|
|
|
576 input_reader io.Reader // File input data.
|
|
|
577 input []byte // String input data.
|
|
|
578 input_pos int
|
|
|
579
|
|
|
580 eof bool // EOF flag
|
|
|
581
|
|
|
582 buffer []byte // The working buffer.
|
|
|
583 buffer_pos int // The current position of the buffer.
|
|
|
584
|
|
|
585 unread int // The number of unread characters in the buffer.
|
|
|
586
|
|
|
587 newlines int // The number of line breaks since last non-break/non-blank character
|
|
|
588
|
|
|
589 raw_buffer []byte // The raw buffer.
|
|
|
590 raw_buffer_pos int // The current position of the buffer.
|
|
|
591
|
|
|
592 encoding yaml_encoding_t // The input encoding.
|
|
|
593
|
|
|
594 offset int // The offset of the current position (in bytes).
|
|
|
595 mark yaml_mark_t // The mark of the current position.
|
|
|
596
|
|
|
597 // Comments
|
|
|
598
|
|
|
599 head_comment []byte // The current head comments
|
|
|
600 line_comment []byte // The current line comments
|
|
|
601 foot_comment []byte // The current foot comments
|
|
|
602 tail_comment []byte // Foot comment that happens at the end of a block.
|
|
|
603 stem_comment []byte // Comment in item preceding a nested structure (list inside list item, etc)
|
|
|
604
|
|
|
605 comments []yaml_comment_t // The folded comments for all parsed tokens
|
|
|
606 comments_head int
|
|
|
607
|
|
|
608 // Scanner stuff
|
|
|
609
|
|
|
610 stream_start_produced bool // Have we started to scan the input stream?
|
|
|
611 stream_end_produced bool // Have we reached the end of the input stream?
|
|
|
612
|
|
|
613 flow_level int // The number of unclosed '[' and '{' indicators.
|
|
|
614
|
|
|
615 tokens []yaml_token_t // The tokens queue.
|
|
|
616 tokens_head int // The head of the tokens queue.
|
|
|
617 tokens_parsed int // The number of tokens fetched from the queue.
|
|
|
618 token_available bool // Does the tokens queue contain a token ready for dequeueing.
|
|
|
619
|
|
|
620 indent int // The current indentation level.
|
|
|
621 indents []int // The indentation levels stack.
|
|
|
622
|
|
|
623 simple_key_allowed bool // May a simple key occur at the current position?
|
|
|
624 simple_keys []yaml_simple_key_t // The stack of simple keys.
|
|
|
625 simple_keys_by_tok map[int]int // possible simple_key indexes indexed by token_number
|
|
|
626
|
|
|
627 // Parser stuff
|
|
|
628
|
|
|
629 state yaml_parser_state_t // The current parser state.
|
|
|
630 states []yaml_parser_state_t // The parser states stack.
|
|
|
631 marks []yaml_mark_t // The stack of marks.
|
|
|
632 tag_directives []yaml_tag_directive_t // The list of TAG directives.
|
|
|
633
|
|
|
634 // Dumper stuff
|
|
|
635
|
|
|
636 aliases []yaml_alias_data_t // The alias data.
|
|
|
637
|
|
|
638 document *yaml_document_t // The currently parsed document.
|
|
|
639 }
|
|
|
640
|
|
|
641 type yaml_comment_t struct {
|
|
|
642
|
|
|
643 scan_mark yaml_mark_t // Position where scanning for comments started
|
|
|
644 token_mark yaml_mark_t // Position after which tokens will be associated with this comment
|
|
|
645 start_mark yaml_mark_t // Position of '#' comment mark
|
|
|
646 end_mark yaml_mark_t // Position where comment terminated
|
|
|
647
|
|
|
648 head []byte
|
|
|
649 line []byte
|
|
|
650 foot []byte
|
|
|
651 }
|
|
|
652
|
|
|
653 // Emitter Definitions
|
|
|
654
|
|
|
655 // The prototype of a write handler.
|
|
|
656 //
|
|
|
657 // The write handler is called when the emitter needs to flush the accumulated
|
|
|
658 // characters to the output. The handler should write @a size bytes of the
|
|
|
659 // @a buffer to the output.
|
|
|
660 //
|
|
|
661 // @param[in,out] data A pointer to an application data specified by
|
|
|
662 // yaml_emitter_set_output().
|
|
|
663 // @param[in] buffer The buffer with bytes to be written.
|
|
|
664 // @param[in] size The size of the buffer.
|
|
|
665 //
|
|
|
666 // @returns On success, the handler should return @c 1. If the handler failed,
|
|
|
667 // the returned value should be @c 0.
|
|
|
668 //
|
|
|
669 type yaml_write_handler_t func(emitter *yaml_emitter_t, buffer []byte) error
|
|
|
670
|
|
|
671 type yaml_emitter_state_t int
|
|
|
672
|
|
|
673 // The emitter states.
|
|
|
674 const (
|
|
|
675 // Expect STREAM-START.
|
|
|
676 yaml_EMIT_STREAM_START_STATE yaml_emitter_state_t = iota
|
|
|
677
|
|
|
678 yaml_EMIT_FIRST_DOCUMENT_START_STATE // Expect the first DOCUMENT-START or STREAM-END.
|
|
|
679 yaml_EMIT_DOCUMENT_START_STATE // Expect DOCUMENT-START or STREAM-END.
|
|
|
680 yaml_EMIT_DOCUMENT_CONTENT_STATE // Expect the content of a document.
|
|
|
681 yaml_EMIT_DOCUMENT_END_STATE // Expect DOCUMENT-END.
|
|
|
682 yaml_EMIT_FLOW_SEQUENCE_FIRST_ITEM_STATE // Expect the first item of a flow sequence.
|
|
|
683 yaml_EMIT_FLOW_SEQUENCE_TRAIL_ITEM_STATE // Expect the next item of a flow sequence, with the comma already written out
|
|
|
684 yaml_EMIT_FLOW_SEQUENCE_ITEM_STATE // Expect an item of a flow sequence.
|
|
|
685 yaml_EMIT_FLOW_MAPPING_FIRST_KEY_STATE // Expect the first key of a flow mapping.
|
|
|
686 yaml_EMIT_FLOW_MAPPING_TRAIL_KEY_STATE // Expect the next key of a flow mapping, with the comma already written out
|
|
|
687 yaml_EMIT_FLOW_MAPPING_KEY_STATE // Expect a key of a flow mapping.
|
|
|
688 yaml_EMIT_FLOW_MAPPING_SIMPLE_VALUE_STATE // Expect a value for a simple key of a flow mapping.
|
|
|
689 yaml_EMIT_FLOW_MAPPING_VALUE_STATE // Expect a value of a flow mapping.
|
|
|
690 yaml_EMIT_BLOCK_SEQUENCE_FIRST_ITEM_STATE // Expect the first item of a block sequence.
|
|
|
691 yaml_EMIT_BLOCK_SEQUENCE_ITEM_STATE // Expect an item of a block sequence.
|
|
|
692 yaml_EMIT_BLOCK_MAPPING_FIRST_KEY_STATE // Expect the first key of a block mapping.
|
|
|
693 yaml_EMIT_BLOCK_MAPPING_KEY_STATE // Expect the key of a block mapping.
|
|
|
694 yaml_EMIT_BLOCK_MAPPING_SIMPLE_VALUE_STATE // Expect a value for a simple key of a block mapping.
|
|
|
695 yaml_EMIT_BLOCK_MAPPING_VALUE_STATE // Expect a value of a block mapping.
|
|
|
696 yaml_EMIT_END_STATE // Expect nothing.
|
|
|
697 )
|
|
|
698
|
|
|
699 // The emitter structure.
|
|
|
700 //
|
|
|
701 // All members are internal. Manage the structure using the @c yaml_emitter_
|
|
|
702 // family of functions.
|
|
|
703 type yaml_emitter_t struct {
|
|
|
704
|
|
|
705 // Error handling
|
|
|
706
|
|
|
707 error yaml_error_type_t // Error type.
|
|
|
708 problem string // Error description.
|
|
|
709
|
|
|
710 // Writer stuff
|
|
|
711
|
|
|
712 write_handler yaml_write_handler_t // Write handler.
|
|
|
713
|
|
|
714 output_buffer *[]byte // String output data.
|
|
|
715 output_writer io.Writer // File output data.
|
|
|
716
|
|
|
717 buffer []byte // The working buffer.
|
|
|
718 buffer_pos int // The current position of the buffer.
|
|
|
719
|
|
|
720 raw_buffer []byte // The raw buffer.
|
|
|
721 raw_buffer_pos int // The current position of the buffer.
|
|
|
722
|
|
|
723 encoding yaml_encoding_t // The stream encoding.
|
|
|
724
|
|
|
725 // Emitter stuff
|
|
|
726
|
|
|
727 canonical bool // If the output is in the canonical style?
|
|
|
728 best_indent int // The number of indentation spaces.
|
|
|
729 best_width int // The preferred width of the output lines.
|
|
|
730 unicode bool // Allow unescaped non-ASCII characters?
|
|
|
731 line_break yaml_break_t // The preferred line break.
|
|
|
732
|
|
|
733 state yaml_emitter_state_t // The current emitter state.
|
|
|
734 states []yaml_emitter_state_t // The stack of states.
|
|
|
735
|
|
|
736 events []yaml_event_t // The event queue.
|
|
|
737 events_head int // The head of the event queue.
|
|
|
738
|
|
|
739 indents []int // The stack of indentation levels.
|
|
|
740
|
|
|
741 tag_directives []yaml_tag_directive_t // The list of tag directives.
|
|
|
742
|
|
|
743 indent int // The current indentation level.
|
|
|
744
|
|
|
745 flow_level int // The current flow level.
|
|
|
746
|
|
|
747 root_context bool // Is it the document root context?
|
|
|
748 sequence_context bool // Is it a sequence context?
|
|
|
749 mapping_context bool // Is it a mapping context?
|
|
|
750 simple_key_context bool // Is it a simple mapping key context?
|
|
|
751
|
|
|
752 line int // The current line.
|
|
|
753 column int // The current column.
|
|
|
754 whitespace bool // If the last character was a whitespace?
|
|
|
755 indention bool // If the last character was an indentation character (' ', '-', '?', ':')?
|
|
|
756 open_ended bool // If an explicit document end is required?
|
|
|
757
|
|
|
758 space_above bool // Is there's an empty line above?
|
|
|
759 foot_indent int // The indent used to write the foot comment above, or -1 if none.
|
|
|
760
|
|
|
761 // Anchor analysis.
|
|
|
762 anchor_data struct {
|
|
|
763 anchor []byte // The anchor value.
|
|
|
764 alias bool // Is it an alias?
|
|
|
765 }
|
|
|
766
|
|
|
767 // Tag analysis.
|
|
|
768 tag_data struct {
|
|
|
769 handle []byte // The tag handle.
|
|
|
770 suffix []byte // The tag suffix.
|
|
|
771 }
|
|
|
772
|
|
|
773 // Scalar analysis.
|
|
|
774 scalar_data struct {
|
|
|
775 value []byte // The scalar value.
|
|
|
776 multiline bool // Does the scalar contain line breaks?
|
|
|
777 flow_plain_allowed bool // Can the scalar be expessed in the flow plain style?
|
|
|
778 block_plain_allowed bool // Can the scalar be expressed in the block plain style?
|
|
|
779 single_quoted_allowed bool // Can the scalar be expressed in the single quoted style?
|
|
|
780 block_allowed bool // Can the scalar be expressed in the literal or folded styles?
|
|
|
781 style yaml_scalar_style_t // The output style.
|
|
|
782 }
|
|
|
783
|
|
|
784 // Comments
|
|
|
785 head_comment []byte
|
|
|
786 line_comment []byte
|
|
|
787 foot_comment []byte
|
|
|
788 tail_comment []byte
|
|
|
789
|
|
|
790 key_line_comment []byte
|
|
|
791
|
|
|
792 // Dumper stuff
|
|
|
793
|
|
|
794 opened bool // If the stream was already opened?
|
|
|
795 closed bool // If the stream was already closed?
|
|
|
796
|
|
|
797 // The information associated with the document nodes.
|
|
|
798 anchors *struct {
|
|
|
799 references int // The number of references.
|
|
|
800 anchor int // The anchor id.
|
|
|
801 serialized bool // If the node has been emitted?
|
|
|
802 }
|
|
|
803
|
|
|
804 last_anchor_id int // The last assigned anchor id.
|
|
|
805
|
|
|
806 document *yaml_document_t // The currently emitted document.
|
|
|
807 }
|
