Rust high performance xml reader and writer
MSRV bumped to 1.56! Crate now uses Rust 2021 edition.
:warning: BREAKING CHANGE! Serde's enum representation was changed (it was buggy anyway) to ensure compatibility with serde >= 1.0.181.
xml and xmlns) to their appropriate URIs. Also, enforce namespace constraints related to these well-known namespaces.ElementWriter operations.xs:lists from empty tags (<tag/> or <tag></tag>). Previously an DeError::UnexpectedEof") was returned in that case.<int>123<something-else/></int> is no longer valid content. Previously all data after 123 up to closing tag would be silently skipped.simpleTypes (for example, attributes) into Option fields: now they are always deserialized as Some("").Error variant -- Error::InvalidPrefixBind.arbitrary dependency -- we're actually compatible with version 1.0.0 and up.ElementWriter::write_inner_content (and newly added ElementWriter::write_inner_content_async of course).xs:lists when some elements serialized to an empty string.Full Changelog: https://github.com/tafia/quick-xml/compare/v0.30.0...v0.31.0
Writer::write_serializable to provide the capability to serialize arbitrary types using serde when using the lower-level Writer API.Deserializer::from_str_with_resolver to set entity resolver when deserialize using borrowing reader.Serializer::expand_empty_elements to enforce the expansion of empty elements.<!--> when using read_event_into* functions.Full Changelog: https://github.com/tafia/quick-xml/compare/v0.29.0...v0.30.0
serde_helper module to the crate root with some useful utility
functions and document using of enum's unit variants as a text content of element.AsyncWrite trait implementations.DeError::ExpectedStart
Error::EmptyDocType on empty doctype instead
of crashing because of a debug assertion.Full Changelog: https://github.com/tafia/quick-xml/compare/v0.28.2...v0.29.0
Deserializer to set quick_xml::de::EntityResolver for resolving unknown entities that would otherwise cause the parser to return an [EscapeError::UnrecognizedSymbol] error.EscapeError from the crateunsescape_* set of functions -- their now use FnMut instead of Fn for resolve_entity parameters, like Iterator::map from std.Full Changelog: https://github.com/tafia/quick-xml/compare/v0.28.1...v0.28.2
ElementWriter.write_inner_content now uses a FnOnce instead of a more restrictive Fn closureFull Changelog: https://github.com/tafia/quick-xml/compare/v0.28.0...v0.28.1
$text enum variant in externally tagged
enums to / from textual contentto_writer and to_string now accept ?Sized typesto_writer_with_root and to_string_with_root helper functionsBytesText::inplace_trim_start and BytesText::inplace_trim_end
to trim leading and trailing spaces from text events$value and $text into borrowed
fields when use serde deserializerWritter::inner into Writter::get_mut
Writter::get_ref
Reader::read_event_into_async as an async fn, making the future Send if possible.<element>) when deserialize with serde.
This change allow to deserialize into HashMap<&str, T>, for exampleAsyncWrite.xmlns:xxx) that was broken since #490
Option<T> fields where T is some
sequence type (for example, Vec or tuple)Serializer::new and Serializer::with_root now accepts only references to Writer.DeEvent::Text and
DeEvent::CData events was replaced by DeEvent::Text with merged content.
The same behavior for the Reader does not implemented (yet?) and should be
implemented manuallyFull Changelog: https://github.com/tafia/quick-xml/compare/v0.27.1...v0.28.0
overlapped-lists feature active.Deserializer::read_to_end when overlapped-lists
feature is active and malformed XML is parsedFull Changelog: https://github.com/tafia/quick-xml/compare/v0.27.0...v0.27.1
MSRV was increased from 1.46 to 1.52 in #521.
Clone for all error types. This required changing Error::Io to contain
Arc<std::io::Error> instead of std::io::Error since std::io::Error does not implement
Clone."42") no longer can be serialized because XML name cannot start
from a digit<?xml version="1.0" encoding="UTF-8"?>
<!-- list of enum Enum { A, B, С } -->
<A/>
<B/>
<C/>
Error::EndEventMismatch after disabling and enabling
.check_end_names
\r and \n characters when escaping themunwanted text<struct>...</struct>
xs:lists with encoded spaces: they still
act as delimiters, which is confirmed also by mature XmlBeans Java libraryderive feature to get
quick-xml's serialize feature for edition = 2021 or resolver = 2 crates#490: Removed $unflatten= special prefix for fields for serde (de)serializer, because:
This prefix allowed you to serialize struct field as an XML element and now
replaced by a more thoughtful system explicitly indicating that a field should
be serialized as an attribute by prepending @ character to its name
#490: Removed $primitive= prefix. That prefix allowed you to serialize struct
field as an attribute instead of an element and now replaced by a more thoughtful
system explicitly indicating that a field should be serialized as an attribute
by prepending @ character to its name
#490: In addition to the $value special name for a field a new $text
special name was added:
$text is used if you want to map field to text content only. No markup is
expected (but text can represent a list as defined by xs:list type)$value is used if you want to map elements with different names to one field,
that should be represented either by an enum, or by sequence of enums
(Vec, tuple, etc.), or by string. Use it when you want to map field to any
content of the field, text or markupRefer to documentation for details.
#521: MSRV bumped to 1.52.
#473: serde feature that used to make some types serializable, renamed to serde-types
#528: Added documentation for XML to serde mapping
Full Changelog: https://github.com/tafia/quick-xml/compare/v0.26.0...v0.27.0