Expand description
This crate provides a push based XML parser library that adheres to XML5 specification. In other words this library trades well-formedness for error recovery.
The idea behind this, was to minimize number of errors from
tools that generate XML (e.g. S won’t just return S
as text, but will parse it into S ).
You can check out full specification here.
What this library provides is a solid XML parser that can:
- Parse somewhat erroneous XML input
- Provide support for Numeric character references.
- Provide partial XML namespace support.
- Provide full set of SVG/MathML entities
What isn’t in scope for this library:
- Document Type Definition parsing - this is pretty hard to do right and nowadays, its used
Modules§
- The
BufferQueuestruct and helper types. - Data that is known at compile-time and hard-coded into the binary.
- Driver
- Types for tag and attribute names, and tree-builder functionality.
- Serializer for XML5.
- This module contains a single struct
SmallCharSet. See its documentation for details. - XML5 tokenizer - converts input into tokens
- XML5 tree builder - converts tokens into a tree like structure
Macros§
- Helper to quickly create an expanded name.
- Takes a local name as a string and returns its key in the string cache.
- Takes a namespace prefix string and returns its key in a string cache.
- Takes a namespace url string and returns its key in a string cache.
- Maps the input of
namespace_prefix!to the output ofnamespace_url!. - Create a
SmallCharSet, with each space-separated number stored in the set.
Structs§
- A tag attribute, e.g.
class="test"in<div class="test" ...>. - An expanded name, containing the tag and the namespace.
- A fully qualified name (with a namespace), used to depict names of tags and attributes.
- Represents a set of “small characters”, those with Unicode scalar values less than 64.