#xml #patch #yaml #change #load #generic #stable

nightly bin+lib patch-xml

Load and patch xml files. Pre-alpha version. No stable interface until version 0.1.0.

3 releases

0.0.3 Apr 18, 2021
0.0.2 Apr 7, 2021
0.0.1 Mar 13, 2021

#86 in #patch


Used in patch-svd

MIT/Apache

185KB
2K SLoC

Crates.io Docs Actions Status grcov

patch-xml is a tool and library that reads and patches XML files.

Usage

patch-xml can be used to change XML files with a generic patch in YAML format.
The general idea of this tool is to change parts of the XML file dynamically based on rules that are defined in the patch.

A sample code that shows the usage of this library is shown below.
After that, an introduction to the patch rules is described in detail.

How to use patch-xml library

Currently, patch-xml will require the unstable Rust toolchain because the external_doc-feature is used. The current state of this feature depends on this pull request.

use indoc::indoc;
let original_xml = r#"<element>Foo</element>"#;
let patch = indoc!(
    r#"
    element:
        Bar"#
    );
let result_xml = r#"<?xml version="1.0" encoding="UTF-8"?><element>Bar</element>"#;
// Load XML string, patch it and return the result as string
let result = patch_xml::patch_xml(original_xml.to_string(), patch.to_string()).unwrap();
assert_eq!(result, result_xml);

It is also possible to use patch-xml as command line tool.

Patch syntax

The syntax is almost stable and will be documented here soon...

Dependencies

~4.5–6.5MB
~120K SLoC