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