Skip to content

stepkun/woxml

 
 

Repository files navigation

woxml::XmlWriter

The XmlWriter is designed to write xml in an efficient way without any DOM or other intermediate structures.

The implementation is based on the crate xml_writer by Piotr Zolnierek, but can also be used in 'no_std' environments (use 'default-features = false').

It is not an exact drop-in-replacement for xml_writer's XmlWriter as the access to interiors is prohibitet, you have to use different constructors and accessors respectively. It also is not yet possible to use it for all 'std::io::Write' implementors, missing ones can be added in future versions.

It works for:

  • Vec
  • bytes::BytesMut

Usage

extern crate woxml;
use woxml::XmlWriter;

let mut xml = XmlWriter::pretty_mode(Vec::new()); // supply a woxml::Write implementor
xml.begin_elem("root");
    xml.comment("have a nice day");
    xml.begin_elem("first");
        xml.attr_esc("name", "\"123\"");
        xml.attr("id", "abc");
        xml.text("'text'");
    xml.end_elem();
    xml.begin_elem("stuff");
        xml.cdata("some cdata");
    xml.end_elem();
    xml.set_namespace("area51");
        xml.comment("in namespace 'area51'");
        xml.elem("first");
    xml.unset_namespace();
xml.end_elem();
xml.close(); // This will also close all open elements
xml.flush();

println!("{}", String::try_from(xml).unwrap())

License

Licensed under either of

at your option.

Contribution

Any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.

About

Small and fast XML-Writer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%