# ilex

[![crates.io](https://img.shields.io/crates/v/ilex_xml.svg)](https://crates.io/crates/ilex_xml)
[![docs](https://img.shields.io/badge/docs-latest-blue)](https://docs.rs/ilex_xml/)

Simple tree structure XML library. Allows reading and writing.

Focus on ease of use while maintaining good performance.

[Documentation](https://docs.rs/ilex_xml/)

## Example
```rust
use ilex_xml::{items_to_string, parse_trimmed, Item};

let xml = r#"
<!-- The cat is cute. -->
<parent>
    <child likes="orange">Alice</child>
    <child likes="teal">Bob</child>
</parent>
"#;

let mut items = parse_trimmed(xml).unwrap();

{
    // Get comment content
    let Item::Comment(comment) = &items[0] else {
        panic!(
            "Huh, odd. Let's look at the first item's raw XML: {}",
            items[0]
        );
    };

    println!("I found a useful comment:{}", comment.get_value()?);
}

let Item::Element(parent) = &mut items[1] else {
    panic!("Pretty sure the second item is an element.")
};

{
    // Print attributes and text contents of children
    for item in &parent.children {
        let Item::Element(child) = item else {
            panic!("The children are elements, too.")
        };

        let name = child.get_text_content();
        let color = child.get_attribute("likes")?.unwrap();

        println!("{name}'s favorite color is {color}!");
    }
}

println!("Hey, their name isn't Bob! It's Peter!");

{
    // Change child

    // Get child
    let Item::Element(child) = &mut parent.children[1] else {
        panic!();
    };

    // Remove the wrong name
    child.children.pop();
    // Add the correct name
    child.children.push(Item::new_text("Peter"));

    println!(
        "Lets take another look at the raw XML, now that the name is fixed: {}",
        items_to_string(&items)
    );
}
```