rexpat 0.8.0

data/ext/rexpat/rexpat.h

@@ -0,0 +1,8 @@
+/* This work is licensed under the Ruby license or the Expat license. */
+
+#ifndef REXPAT_H
+#define REXPAT_H 1
+
+#include "ruby.h"
+
+#endif /* REXPAT_H */

data/lib/rexpat/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# This work is licensed under the Ruby license or the Expat license.
+
+class RExpat
+  VERSION = "0.8.0"
+end

data/lib/rexpat.rb

@@ -0,0 +1,539 @@
+# frozen_string_literal: true
+
+# This work is licensed under the Ruby license or the Expat license.
+
+require_relative "rexpat/version"
+require "rexpat/rexpat"
+
+##
+# This is a main parser class.
+#
+# The +on_+ methods are event handlers.
+class RExpat
+  class << self
+    ##
+    # :method: expat_version
+    #
+    # Get expat version.
+    #
+    # expat のバージョンを得ます。
+
+    ##
+    # :method: features
+    #
+    # Get a hash list of expat API's features.
+  end
+
+  ##
+  # :method: initialize
+  # :call-seq: new (encoding: nil, nssep: nil) -> RExpat
+  #
+  # +encoding+ can be specified to ISO-8859-1, UTF-8, US-ASCII and
+  # UTF-16, which Expat can recognize.
+  #
+  # +nssep+ enables namespace extension.  The namespace-prefixed
+  # element and attribute names are concatenated with the namespace's
+  # URI and a separator (the first byte of +nssep+).
+  #
+  # For example, with <tt>nssep = '!'</tt>,
+  #
+  #    <hoge:test xmlns:hoge="http://www.yoshidam.net/ns/hoge">
+  #
+  # is parsed into
+  #
+  #    http://www.yoshidam.net/ns/hoge!test
+  #
+  # It can raise RExpat::Error.
+  #
+  # See also #reset for reusing the parser.  Note that the xmlparser
+  # gem prohibits the reuse, I don't know why.
+  #
+  # 作成に失敗すると RExpat::Error 例外が発生します。 +encoding+ とし
+  # て文字エンコーディングを外部から指定することも出来ます。Expat が対
+  # 応しているエンコーディング名(ISO-8859-1, UTF-8, US-ASCII, UTF-16)
+  # が使えます。
+  #
+  # +nssep+ を指定すると名前空間拡張が有効になります。エレメントや属性
+  # の名前にプレフィックスを指定すると，エレメント名や属性名が URI と
+  # ローカルパートを連結した名前になります。 +nssep+ で指定された文字
+  # 列の最初の文字がセパレータになります。
+  #
+  # 例えば
+  #
+  #    <hoge:test xmlns:hoge="http://www.yoshidam.net/ns/hoge">
+  #
+  # を <tt>nssep = '!'</tt> でパースすると，エレメント名は
+  #
+  #    http://www.yoshidam.net/ns/hoge!test
+  #
+  # になります。
+
+  ##
+  # :method: external_entity_parser
+  # :call-seq: external_entity_parser (context: nil, encoding: nil) -> RExpat
+  #
+  # This creates an XML parser object that can parse an external
+  # entity.  It can raise RExpat::Error.
+  #
+  # This can be called at any point after the first
+  # +#on_external_entity_ref+ event call.
+  #
+  # The +context+ parameter should be the parsing context given by the
+  # +#on_external_entity_ref+ event.
+  #
+  # The +encoding+ parameter is an optional character encoding.
+  #
+  # The returned parser can be reused by calling #reset.
+
+  ##
+  # :method: parse
+  # :call-seq: parse(str = nil, final: true)
+  #
+  # Parse a string.  The parse results can be processed by event
+  # handlers.
+  #
+  # +final+ parameter must true on last call of this method.  Default
+  # is true.  No parameter call of this method indicates the end of
+  # parsing.
+  #
+  # A failure to parse raises a RExpat::Error exception.
+  #
+  # +str+ をパースします。パース結果としてイベントハンドラが呼び出され
+  # ます。
+  #
+  # +final+ は XML の途中までパースする場合は false, 最後までの場合は
+  # true を指定して下さい。省略時は true です。引数無しで呼び出すこと
+  # で，パースの終了を指示することもできます。
+  #
+  # パースエラーを検出すると RExpat::Error 例外が発生します。
+
+  ##
+  # :method: default_current
+  #
+  # Raise a +#on_default+ event within any event handlers.  You can
+  # get the corresponding markup.
+  #
+  # If within a event handler, it raise a +#on_default+ event
+  # immediately.
+  #
+  # イベントハンドラ内で呼び出します。 +#on_default+ イベントを発生さ
+  # せ，パース前の生のデータを得ることができます。イベントハンドラ内で
+  # すぐさま +#on_default+ イベントが発生します。 +#on_default+ ハンド
+  # ラーは呼び出されないことに注意して下さい。
+
+  ##
+  # :method: base=
+  # :call-seq: parser.base = base
+  #
+  # The value is assigned as the URL base for external entities.  See
+  # also the +#on_external_entity_ref+ event handler.
+  #
+  # This can raise RExpat::Error when out of memory.
+
+  ##
+  # :method: line
+  #
+  # Get current parsing location.
+  #
+  # When a #parse method raises RExpat::Error, these method return the
+  # position of the error detected.
+  #
+  # See also #column and #byte_index.
+  #
+  # イベントハンドラ内で呼び出します。現在のパース位置を返します。また，
+  # +#parse+ メソッドが RExpat::Error 例外で発生した時に呼び出すとエラー
+  # 位置を返します。
+
+  ##
+  # :method: column
+  #
+  # Get current parsing location.
+  #
+  # When a #parse method raises RExpat::Error, these method return the
+  # position of the error detected.
+  #
+  # See also #line and #byte_index.
+  #
+  # イベントハンドラ内で呼び出します。現在のパース位置を返します。また，
+  # +#parse+ メソッドが RExpat::Error 例外で発生した時に呼び出すとエラー
+  # 位置を返します。
+
+  # :method: byte_index
+  #
+  # Get current parsing location.
+  #
+  # When #parse method raises RExpat::Error, these method return the
+  # position of the error detected.
+  #
+  # See also #line and #column.
+  #
+  # イベントハンドラ内で呼び出します。現在のパース位置を返します。また，
+  # +#parse+ メソッドが RExpat::Error 例外で発生した時に呼び出すとエラー
+  # 位置を返します。
+
+  ##
+  # :method: byte_count
+  #
+  # Get the number of bytes in the current event.  This should be
+  # called in event handlers.
+  #
+  # When the event is in an internal entity, this method returns 0.
+  #
+  # イベントハンドラ内で呼び出します。現在のイベント対象の
+  # 長さを返します。内部実体では 0 を返します。
+
+  ##
+  # :method: specified_attributes
+  #
+  # This returns an array of specified attribute names.  This method
+  # should be used in the +#on_start_element+ event handler.
+
+  ##
+  # :method: param_entity_parsing=
+  # :call-seq: parser.param_entity_parsing = parsing
+  #
+  # Controls parsing of parameter entities, including the external DTD
+  # subset.
+  #
+  # +parsing+ parameter is either of +:never+, +:unless_standalone+,
+  # or +:always+.
+  #
+  # References to external parameter entities will invoke the
+  # +#on_external_entity_ref+ event.  The +context+ will be nil.
+  #
+  # This can raise RExpat::Error.
+  #
+  # 外部パラメータ実体(外部 DTD サブセットも含む) をパースするかどうか
+  # を指定します。 +parsing+ には +:never+, +:unless_standalone+,
+  # +:always+のいずれかを指定してください。
+  #
+  # 外部パラメータエンティティをパースする場合，
+  # +#on_external_entity_ref+イベントが呼び出されます。 +context+ は
+  # nil になります。
+
+  ##
+  # :method: return_ns_triplet=
+  # :call-seq: return_ns_triplet = do_nst
+  #
+  # Sets namespace triplet flag.  It tells whether to use the URI, the
+  # local name, and the prefix if the namespace is enabled, or always
+  # use the URI and the local name if false.
+  #
+  # 名前空間が有効なときに，URI + ローカル名 + プレフィックスを使うか
+  # どうか指示します。 +false+ の時はURI + ローカル名です。
+
+  ##
+  # :method: input_context
+  #
+  # Returns the parser's input buffer and current parse
+  # posion.
+  #
+  # 入力バッファと現在パース位置を得ます。
+
+  ##
+  # :method: id_attribute
+  #
+  # Gets the ID attribute name.
+  #
+  # This method should be used in +#on_start_element+ event handler.
+  #
+  # Note that the ID attribute here is the one declared in the doctype
+  # declaration, rather than the one with an +xml:id+ attribute nor a
+  # plain +id+ attribute.  For example, in this XML document, +foo+ is
+  # the ID attribute:
+  #
+  #   <!DOCTYPE test [
+  #     <!ELEMENT root EMPTY>
+  #     <!ATTLIST root
+  #       foo ID #REQUIRED
+  #     >
+  #   ]>
+  #   <root foo="bar"/>
+  #
+  # ID 属性の名前を得ます。+#on_start_element+ イベント内で呼び出して
+  # ください。
+
+  ##
+  # :method: reset
+  # :call-seq: reset(encoding: nil)
+  #
+  # Resets the parser object to be reused.  The +encoding+ parameter
+  # can specify the character encoding.
+  #
+  # See also #external_entity_parser.
+  #
+  # パーサオブジェクトを再利用するためにリセットします。+encoding+ と
+  # して文字エンコーディングを外部から指定することもできます。
+
+  ##
+  # :method: use_foreign_dtd=
+  # :call-seq: use_foreign_dtd = use_dtd
+  #
+  # Specifies to parse an external DTD subset without the
+  # DOCTYPE declaration.
+  #
+  # In +#on_external_entity_ref+, th esystem ID and the public ID will
+  # be nil.
+  #
+  # See also #param_entity_parsing=.
+
+  ##
+  # :method: on_start_element
+  # :call-seq: on_start_element(name, attrs)
+  #
+  # This method is called when element start tags are detected.
+  # +name+ is the element name, +attrs+ is a hash of attributes, the
+  # keys are the attribute's name, the values are attribute's values.
+  #
+  # エレメント開始タグを見付けると呼び出されます。 +name+ はエレメント
+  # 名， +attrs+ は属性名をキー，属性値を値とするハッシュです。
+
+  ##
+  # :method: on_end_element
+  # :call-seq: on_end_element(name)
+  #
+  # This method is called when element end tags are detected.  +name+
+  # is the element name.
+  #
+  # エレメント終了タグを見付けると呼び出されます。 +name+ はエレメント
+  # 名です。
+
+  ##
+  # :method: on_character_data
+  # :call-seq: on_character_data(data)
+  #
+  # This method is called when texts or CDATA sections are detected.
+  # Internal entities are expanded as long as +#on_default+ handler is
+  # not defined.
+  #
+  # テキスト，CDATA セクションを見付けると呼び出されます。
+  # +#on_default+ ハンドラが未定義のときは内部実体は展開されます。
+
+  ##
+  # :method: on_processing_instruction
+  # :call-seq: on_processing_instruction(target, data)
+  #
+  # This method is called when processing instructions are detected.
+  #
+  # PI を見付けると呼び出されます。
+
+  ##
+  # :method: on_notation_decl
+  # :call-seq: on_notation_decl(notationName, base, systemId, publicId)
+  #
+  # This methods is called when notation declarations are detected.
+  # +notationName+, +base+, +systemId+, and +publicId+ are the
+  # notation name, the URL base, the system identifier and the public
+  # identifier.  The URL base, the system identifier and the public
+  # identifier can be nil.
+  #
+  # 記法宣言を見付けると呼び出されます。 +notationName+, +base+,
+  # +systemId+, +publicId+ はそれぞれ記法名，URL ベース，システム識別
+  # 子，公開識別子です。URL ベース，システム識別子，公開識別子 は nil
+  # になることがあります。
+
+  ##
+  # :method: on_external_entity_ref
+  # :call-seq: on_external_entity_ref(context, base, systemId, publicId)
+  #
+  # This method is called when external entity references are
+  # detected.  +context+, +base+, +systemId+, and +publicId+ are the
+  # parsing context, the URL base, the system identifier, and the
+  # public identifier.  The URL base, the system identifier, and the
+  # public identifier can be nil.  The context can use the +context+
+  # parameter of the constructor of the external entity parser.
+  #
+  # If you do not parse the external entities by this
+  # event, the external entities are never parsed.
+  #
+  # It is called when external parameter entity refs (including
+  # external DTD subset) are detected.  In this case, +context+ will
+  # be nil.  The parser for the external parameter entitiy must be
+  # created with +#parse+ in this event.  See also
+  # +#param_entity_parsing=+.
+  #
+  # Example:
+  #
+  #   def externalEntityRef(context, base, systemId, publicId)
+  #     extp = self.type.new(self, context)
+  #     file = if base.nil?; systemId; else base + "/" + systemId; end
+  #     extp.parse(open(file))
+  #   end
+  #
+  # 外部実体参照を見付けると呼び出されます。 +context+, +base+,
+  # +systemId+, +publicId+ はそれぞれパースコンテクスト，URL ベース，
+  # システム識別子，公開識別子です。URL ベース，公開識別子 は nil にな
+  # ることがあります。パースコンテクストは外部実体パース用のパーサを生
+  # 成するときの +context+ 引数として利用可能です。
+  #
+  # このイベントで外部実体をパースしなければ，外部実体はパースされるこ
+  # とはありません。
+  #
+  # 外部パラメータ実体参照 (および外部 DTD サブセット) を見付けた場合
+  # にも呼び出されます。この場合は +context+ は nil になります。外部パ
+  # ラメータ実体をパースする場合は必ずこのハンドラ内でパースしてくださ
+  # い。 +#param_entity_parsing=+ も参照してください。
+
+  ##
+  # :method: on_comment
+  # :call-seq: on_comment(data)
+  #
+  # This methods is called when comments are detected.
+  #
+  # コメントを見付けると呼び出されます。
+
+  ##
+  # :method: on_start_cdata_section
+  #
+  # This methods is called when CDATA sections start.  The contents of
+  # the CDATA sections are reported by +#on_character_data+ event.
+  #
+  # CDATA セクションの開始時に呼び出されます。CDATA セクションの内容は
+  # +#on_character_data+ イベントで報告されます。
+
+  ##
+  # :method: on_end_cdata_section
+  #
+  # This method is called when CDATA sections end.
+  #
+  # CDATA セクションの終了時に呼び出されます。
+
+  ##
+  # :method: on_start_namespace_decl
+  # :call-seq: on_start_namespace_decl(prefix, uri)
+  #
+  # This methods is called before the element that has namespace
+  # declaration.
+  #
+  # +prefix+ and +uri+ can be nil.
+  #
+  # Note that the namespace support is enabled only when
+  # +RExpat.new+'s +nssep+ is set.
+  #
+  # Namespace 宣言されたエレメントの開始前に呼び出されます。+prefix+
+  # は xmlns 属性が指定された場合は nil になり， +uri+は空 URI が指定
+  # された場合に nil になります。
+
+  ##
+  # :method: on_end_namespace_decl
+  # :call-seq: on_end_namespace_decl(prefix)
+  #
+  # This methods is called after the element that has namespace
+  # declaration.
+  #
+  # Prefix can be nil.
+  #
+  # Note that the namespace support is enabled only when
+  # +RExpat.new+'s +nssep+ is set.
+  #
+  # Namespace 宣言されたエレメントの終了後に呼び出されます。
+  # prefix は xmlns 属性が指定された場合は nil になります。
+
+  ##
+  # :method: on_start_doctype_decl
+  # :call-seq: on_start_doctype_decl(doctypeName, sysid, pubid, has_internal_subset)
+  #
+  # This methods is called when the name of the DOCTYPE is
+  # encountered.
+  #
+  # DOCTYPE 宣言の文書型名を見つけると呼び出されます。
+  # +doctypeName+ は文書型名です。
+
+  ##
+  # :method: on_end_doctype_decl
+  #
+  # This methods is called when the closing <tt>></tt> is encountered,
+  # but after processing any external subset.
+  #
+  # DOCTYPE 宣言の終了時に呼び出されます。
+
+  ##
+  # :method: on_default
+  # :call-seq: on_default(data)
+  #
+  # This method is called when there is no applicable
+  # event handler.
+  #
+  # If this method is defined, expansion of internal
+  # entities are inhibited.
+  #
+  # 他のイベントが呼び出されなかった場合に呼び出されます。このメソッド
+  # を定義すると内部実体の展開が抑止されます。
+
+  ##
+  # :method: on_default_expand
+  # :call-seq: on_default_expand(data)
+  #
+  # This method is called when there is no applicable event handlers.
+  # This is almost same as +#on_default+, except it expands internal
+  # entity references.
+  #
+  # This method have higher priority than +#on_default+ method.
+  #
+  # 他のイベントが呼び出されなかった場合に呼び出されます。
+  # +#on_default_expand+ は +#on_default+ メソッドに優先します。
+
+  ##
+  # :method: on_not_standalone
+  #
+  # This methods is called if the document is not standalone (it has
+  # an external subset or a reference to a parameter entity, but does
+  # not have <tt>standalone="yes"</tt>).
+  #
+  # If you may return false to raise an error, or return true to
+  # continue the parsing.
+  #
+  # <tt>standalone="yes"</tt> でない時，外部 DTD サブセットやパラメー
+  # タ実体を参照すると呼び出されます。
+  #
+  # エラーを発生させたい場合は false，処理を続行させたい場合は true を
+  # 返してください。
+  #
+  # expat は外部 DTD サブセットやパラメータ実体を解決でき
+  # ないので，このイベントが発生した場合は他の XML プロセッ
+  # サを呼び出すなり，処理を中断するなりすべきかもしれませ
+  # ん。
+
+  ##
+  # :method: on_element_decl
+  # :call-seq: on_element_decl(name, model)
+  #
+  # 要素宣言時に呼び出されます。 +name+ は要素名， +model+ は内容モデ
+  # ルをあらわす<tt>[type, quant, name, [children_model, ...]]</tt>の
+  # ような配列です。 +type+ は +:empty+, +:any+, +:mixed+, +:choice+,
+  # +:seq+ のいずれか， +quant+ は +:none+, +:opt+, +:rep+, +:plus+ の
+  # いずれかです。 +name+ は nil か要素名， +children_model+ は子モデ
+  # ルです。
+
+  ##
+  # :method: on_attlist_decl
+  # :call-seq: on_attlist_decl(elname, attname, att_type, dflt, isrequired)
+  #
+  # 属性宣言時に呼び出されます。 +elname+ は要素名， +attname+ は属性
+  # 名， +att_type+ は属性の型， +dflt+ は省略値，+isrequired+ は
+  # +#REQUIRED+ かどうかをあらわします。
+
+  ##
+  # :method: on_xml_decl
+  # :call-seq: on_xml_decl(version, encoding, standalone)
+  #
+  # +standalone+ can be either +nil+, +false+, or +true+, which means
+  # "no standalone attribute", "standalone attribute is set to no",
+  # and "standalone attribute is set to yes", respectably.
+  #
+  # 文書先頭の XML 宣言および解析可能実体のテキスト宣言時に呼び出され
+  # ます。テキスト宣言では +version+ が nil に，XML 宣言では
+  # +encoding+ が nil になることがあります。+standalone+ は +nil+,
+  # +false+, +true+ の値をとります。
+
+  ##
+  # :method: on_entity_decl
+  # :call-seq: on_entity_decl(entityName, isparameter_entity, vale,
+  #            base, systemId, publicId, notationName)
+  #
+  # 実体宣言時に呼び出されます。
+
+  ##
+  # :method: on_skipped_entity
+  # :call-seq: on_skipped_entity(entityName, is_parameter_entity)
+end

data/licenses/Expat-license.txt

@@ -0,0 +1,21 @@
+Copyright (c) 1998-2000 Thai Open Source Software Center Ltd and Clark Cooper
+Copyright (c) 2001-2026 Expat maintainers
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/licenses/Ruby-license.txt

@@ -0,0 +1,56 @@
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.jp>.
+You can redistribute it and/or modify it under either the terms of the
+2-clause BSDL (see the file BSDL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or binary form,
+     provided that you do at least ONE of the following:
+
+       a) distribute the binaries and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them,
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/sig/rexpat.rbs

@@ -0,0 +1,50 @@
+# This work is licensed under the Ruby license or the Expat license.
+
+module RExpat
+  VERSION: String
+  def self.expat_version: -> String
+  def self.features: -> Hash[String, Integer]
+  def initialize: (encoding: String?, nssep: String?) -> RExpat
+  def external_entity_parser: (context: String, encoding: String?) -> RExpat
+  def byte_count: -> Integer
+  def byte_index: -> Integer
+  def column: -> Integer
+  def default_current: -> void
+  def id_attribute: -> String
+  def input_context: -> [String, Integer]
+  def specified_attributes: -> Array[String]
+  def line: -> Integer
+  def reset: (encoding: String?) -> void
+  def base=: (String) -> void
+  def param_entity_parsing=: (:never | :unless_standalone | :always) -> void
+  def return_ns_triplet=: (bool) -> void
+  def use_foreign_dtd=: (bool) -> void
+  def parse: (String?, final: bool) -> void
+  def on_attlist_decl: (String, String, String?, String, bool) -> void
+  def on_character_data: (String) -> void
+  def on_comment: (String) -> void
+  def on_default: (String) -> void
+  def on_xml_decl: (String, String, bool?) -> void
+  def on_default_expand: (String) -> void
+
+  type model_type = [:empty | :any | :mixed | :choice | :seq,
+    :none | :opt | :rep | :plus,
+    String,
+    Array[model_type]]
+
+  def on_element_decl: (String, model_type) -> void
+  def on_end_cdata_section: -> void
+  def on_end_element: (String) -> void
+  def on_end_doctype_decl: -> void
+  def on_start_cdata: -> void
+  def on_not_standalone: -> bool
+  def on_end_namespace_decl: (String?) -> void
+  def on_start_namespace_decl: (String?, String?) -> void
+  def on_processing_instruction: (String, String) -> void
+  def on_start_element: (String, Hash[String, String]) -> void
+  def on_notation_decl: (String, String?, String?, String?) -> void
+  def on_start_doctype_decl: (String, String?, String?, bool) -> void
+  def on_entity_decl: (String, bool, String, String?, String?, String?, String?) -> void
+  def on_external_entity_ref: (String, String?, String?, String?) -> void
+  def on_skipped_entity: (String, bool) -> void
+end