third_party/rust/xml-rs/design.md

   1 # Reader
   2
   3 Basic features:
   4  * [x] Parsing XML 1.0 documents and returning a stream of events
   5    - [ ] Support reading embedded DTD schemas
   6    - [ ] Support for embedded entities
   7  * [x] Support for namespaces and emitting namespace information in events
   8  * [ ] \[maybe\] push-based wrapper
   9  * Missing XML features
  10    - [ ] Support for different encodings
  11    - [ ] Attribute values normalization
  12    - [ ] EOL characters normalization
  13
  14 Advanced features:
  15  * [ ] DTD schema validation
  16  * [ ] XSD schema validation
  17
  18 # Writer
  19
  20 Basic features:
  21   * [x] Writing basic XML 1.0 documents in UTF-8
  22   * [x] Writing XML 1.0 documents with namespace support
  23   * [x] Support for writing elements with empty body as empty elements
  24   * [x] Pretty-printed and compact output
  25   * [ ] Writing XML document with embedded DTDs and DTD references
  26   * Misc features:
  27     - [ ] Support for different encodings
  28     - [x] Support for writing CDATA as characters
  29     - [ ] Checking events for invalid characters (e.g. `--` in comments)
  30     - [ ] Check for namespaces more correctly, i.e. check both for prefix and namespace URI
  31     - [ ] Support checking namespace prefix presence in the current namespace for events with prefix but without namespace
  32     - [ ] Support checking namespace prefix for events with both prefix and namespace URI
  33
  34 # Other
  35
  36 DOM-based API:
  37  * [ ] Basic support for DOM-based API