https://github.com/webern/exile

XML in Rust
https://github.com/webern/exile

rust xml

Last synced: 4 months ago
JSON representation

XML in Rust

• Host: GitHub
• URL: https://github.com/webern/exile
• Owner: webern
• License: mit
• Created: 2020-05-23T00:11:43.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2023-11-13T14:39:51.000Z (over 1 year ago)
• Last Synced: 2024-10-14T14:52:13.621Z (4 months ago)
• Topics: rust, xml
• Language: Rust
• Homepage:
• Size: 329 KB
• Stars: 5
• Watchers: 3
• Forks: 1
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# exile

Current version: 0.0.9

![build](https://github.com/webern/exile/workflows/exile%20ci/badge.svg)

`exile` is a Rust library for reading and writing XML.

The goal, at least initially, is to provide an abstract syntax tree of an XML file.

As such, this is a Exile is a dom parser and loads the complete contents of the document into memory.

Currently supported:

- Attributes

- CDATA Sections

- Comment Parsing

- Elements

- Processing Instructions

- Text Nodes

- UTF-8

- Whitespace Normalization

Not Supported:

- Doctypes

- Entities

- Entity References

- Other Encodings

- Whitesace Preservation: All text nodes are treated as if whitespace `collapse` were in-effect.

## Example

Parsing XML looks like this.

```rust

let xml = r#"

  

  bar

"#;

let doc = exile::parse(xml).unwrap();

for child in doc.root().children() {

    println!("element name: {}", child.name());

    if let Some(attribute) = child.attribute("name") {

        println!("name attribute: {}", attribute);

    }

}

// we can create an index of elements

let index = doc.index();

// the element at index 2 is bar

let thing = index.element(2).unwrap();

// the parent of index 2 is 

let root = index.parent(&thing).unwrap();

assert_eq!("bar", thing.text().unwrap());

assert_eq!("root", root.name());

```

Authoring XML looks like this.

```rust

use exile::{Document, Element, Node};

let mut root = Element::from_name("my_root");

root.add_attribute("foo", "bar");

let mut child = Element::from_name("my_child");

child.add_text("Hello World!");

root.add_child(child);

let doc = Document::from_root(root);

println!("{}", doc.to_string());

```

The above program prints:

```xml

  Hello World!

```