vendor/gopkg.in/yaml.v2/yamlh.go

   1 package yaml
   2
   3 import (
   4         "io"
   5 )
   6
   7 // The version directive data.
   8 type 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.
  14 type yaml_tag_directive_t struct {
  15         handle []byte // The tag handle.
  16         prefix []byte // The tag prefix.
  17 }
  18
  19 type yaml_encoding_t int
  20
  21 // The stream encoding.
  22 const (
  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
  31 type yaml_break_t int
  32
  33 // Line break types.
  34 const (
  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
  43 type yaml_error_type_t int
  44
  45 // Many bad things could happen with the parser and emitter.
  46 const (
  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.
  60 type 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
  68 type yaml_style_t int8
  69
  70 type yaml_scalar_style_t yaml_style_t
  71
  72 // Scalar styles.
  73 const (
  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
  84 type yaml_sequence_style_t yaml_style_t
  85
  86 // Sequence styles.
  87 const (
  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
  95 type yaml_mapping_style_t yaml_style_t
  96
  97 // Mapping styles.
  98 const (
  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
 108 type yaml_token_type_t int
 109
 110 // Token types.
 111 const (
 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
 143 func (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.
 194 type 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
 223 type yaml_event_type_t int8
 224
 225 // Event types.
 226 const (
 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.
 243 type 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
 280 func (e *yaml_event_t) scalar_style() yaml_scalar_style_t     { return yaml_scalar_style_t(e.style) }
 281 func (e *yaml_event_t) sequence_style() yaml_sequence_style_t { return yaml_sequence_style_t(e.style) }
 282 func (e *yaml_event_t) mapping_style() yaml_mapping_style_t   { return yaml_mapping_style_t(e.style) }
 283
 284 // Nodes
 285
 286 const (
 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
 306 type yaml_node_type_t int
 307
 308 // Node types.
 309 const (
 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.
 319 type yaml_node_item_t int
 320
 321 // An element of a mapping node.
 322 type 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.
 328 type 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.
 362 type 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.
 397 type 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.
 400 type 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.
 408 type yaml_parser_state_t int
 409
 410 const (
 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
 438 func (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.
 493 type 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.
 503 type 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 //
 591 type yaml_write_handler_t func(emitter *yaml_emitter_t, buffer []byte) error
 592
 593 type yaml_emitter_state_t int
 594
 595 // The emitter states.
 596 const (
 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.
 623 type 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 }