Add --from-xml

Author: IvanIsCoding

CHANGELOG.md

@@ -1,6 +1,12 @@
 Changelog
 =========
 
+[v0.3.3](https://github.com/IvanIsCoding/celq/releases/tag/v0.3.1) - 2026-02-05
+
+### Added
+
+* Added XML support via the `--from-xml` flag.
+
 [v0.3.2](https://github.com/IvanIsCoding/celq/releases/tag/v0.3.2) - 2026-01-31
 
 ### Miscellaneous

Cargo.lock

@@ -33,9 +33,10 @@ name = "celq"
 path = "src/documentation.rs"
 
 [features]
-default = ["mimalloc", "from-toml", "from-yaml", "greppable"]
+default = ["mimalloc", "from-toml", "from-yaml", "greppable", "from-xml"]
 from-toml = ["dep:toml"]
 from-yaml = ["dep:serde-saphyr"]
+from-xml = ["dep:xml2json-rs"]
 greppable = ["dep:ressa", "dep:resast"]
 
 [dependencies]
@@ -51,6 +52,7 @@ toml = { version = "=0.9.8", default-features = false, features = ["parse", "ser
 serde-saphyr = { version = "=0.0.16", default-features = false, optional = true }
 ressa = { version = "=0.8.2", optional = true}
 resast = { version = "=0.5.0", optional = true }
+xml2json-rs = {version = "=1.0.1", optional = true }
 
 [dev-dependencies]
 tempfile = "3"

Cargo.toml

@@ -19,7 +19,7 @@ celq -n --arg='fruit:string=apple' 'fruit.contains("a")'
 # Outputs: true
 ```
 
-Popular configuration formats such as JSON5, YAML, and TOML are supported. The closely related format NDJSON is also supported.
+Popular configuration formats such as JSON5, YAML, TOML, and XML are supported. The closely related format NDJSON is also supported.
 
 For detailed usage examples and recipes, see the [manual](https://docs.rs/celq/latest/celq/).
 

README.md

@@ -39,10 +39,10 @@ See the [installation guide](`crate::installation_guide`) for installation instr
 ```none
 A CEL command-line query tool for JSON data
 
-Usage: celq [OPTIONS] <expr|--from-file <FILE>>
+Usage: celq [OPTIONS] [expr]
 
 Arguments:
-  [expr]  CEL expression to evaluate
+  [expr]  CEL expression to evaluate [default: this]
 
 Options:
   -a, --arg <name:type=value>  Define argument variables, types, and values. Format: name:type=value. Supported types: int, uint, float, bool, string
@@ -53,6 +53,7 @@ Options:
       --from-json5             Parse input as JSON5 instead of JSON
       --from-toml              Parse input as TOML instead of JSON
       --from-yaml              Parse input as YAML instead of JSON
+      --from-xml               Parse input as XML instead of JSON
       --from-gron              Parse input as gron (greppable output) instead of JSON
   -j, --jobs <N>               Parallelism level for NDJSON inputs (number of threads, -1 for all available) [default: 1]
   -R, --root-var <ROOT_VAR>    Variable name for the root JSON input [default: this]
@@ -144,8 +145,8 @@ This file contains the simplified response from the Yahoo Finance Unofficial JSO
   * [this keyword](#this-keyword)
   * [Writing Files](#writing-files)
   * [Output JSON](#output-json)
-  * [Slicing lists](#slicing-lists)
   * [Reading CEL from a file](#reading-cel-from-a-file)
+  * [Slicing lists](#slicing-lists)
   * [Dealing with NDJSON](#dealing-with-ndjson)
   * [Slurping](#slurping)
   * [Logical Calculator](#logical-calculator)
@@ -156,6 +157,7 @@ This file contains the simplified response from the Yahoo Finance Unofficial JSO
   * [TOML Support](#toml-support)
   * [YAML Support](#yaml-support)
   * [YAML with multiple documents](#yaml-with-multiple-documents)
+  * [XML Support](#xml-support)
   * [Pretty Printing](#pretty-printing)
   * [Raw Output](#raw-output)
   * [Grep friendly output](#grep-friendly-output)
@@ -444,6 +446,59 @@ The document gets parsed as a list of documents. To access the `tags` field of t
 celq --from-yaml 'this[1].tags' < multi.yaml
 ```
 
+### XML Support
+
+`celq` supports XML via the `--froml-xml` flag. Take `example.xml`:
+
+<details>
+<summary>example.xml</summary>
+
+```xml
+<?xml version="1.0"?>
+<items>
+  <item id="1">
+    <name>apple</name>
+    <price>1.25</price>
+  </item>
+  <item id="2">
+    <name>banana</name>
+    <price>0.75</price>
+  </item>
+</items>
+```
+</details>
+
+Running `celq --from-xml -S < example.xml` converts it to the following:
+
+<details>
+<summary>example_xml.json</summary>
+
+```json
+{
+  "items": {
+    "item": [
+      {
+        "$": {
+          "id": "1"
+        },
+        "name": "apple",
+        "price": "1.25"
+      },
+      {
+        "$": {
+          "id": "2"
+        },
+        "name": "banana",
+        "price": "0.75"
+      }
+    ]
+  }
+}
+```
+</details>
+
+`celq`'s XML parser does not try to convert types and puts attributes in the `$` field.
+
 ### Pretty Printing
 
 `celq` by default uses a compact output. This is a contrast to `jq` where the compact output is an opt-in with the `-c` flag.

docs/manual.md

@@ -24,6 +24,7 @@ pub enum InputFormat {
     Json5,
     Toml,
     Yaml,
+    Xml,
     Gron,
 }
 
@@ -129,6 +130,10 @@ pub struct Cli {
     #[arg(long = "from-yaml")]
     pub from_yaml: bool,
 
+    /// Parse input as XML instead of JSON
+    #[arg(long = "from-xml")]
+    pub from_xml: bool,
+
     /// Parse input as gron (greppable output) instead of JSON
     #[arg(long = "from-gron")]
     pub from_gron: bool,
@@ -184,6 +189,8 @@ impl Cli {
             InputFormat::Yaml
         } else if self.from_toml {
             InputFormat::Toml
+        } else if self.from_xml {
+            InputFormat::Xml
         } else if self.from_json5 {
             InputFormat::Json5
         } else if self.slurp {

src/cli.rs

@@ -62,6 +62,23 @@ pub fn json_to_cel_variables(
                 ));
             }
         }
+        InputFormat::Xml => {
+            #[cfg(feature = "from-xml")]
+            {
+                xml2json_rs::JsonConfig::new()
+                    .explicit_array(false)
+                    .finalize()
+                    .build_from_xml(json_str)
+                    .map_err(serde_json::Error::custom)?
+            }
+
+            #[cfg(not(feature = "from-xml"))]
+            {
+                return Err(serde_json::Error::custom(
+                    "Binary was compiled without XML support",
+                ));
+            }
+        }
         InputFormat::Gron => {
             #[cfg(feature = "greppable")]
             {

src/json2cel.rs

@@ -951,3 +951,106 @@ fn test_slice_fails_without_extensions() -> io::Result<()> {
 
     Ok(())
 }
+
+// XML tests
+
+// XML with nested elements
+#[cfg(feature = "from-xml")]
+test!(
+    xml_nested_elements,
+    &[
+        "--from-xml",
+        "this.database.host + ':' + string(this.database.port)"
+    ],
+    r#"<database>
+  <host>localhost</host>
+  <port>5432</port>
+</database>"#,
+    "\"localhost:5432\""
+);
+
+#[cfg(feature = "from-xml")]
+test!(
+    xml_array_of_elements,
+    &["--from-xml", "this.servers.server.map(s, s.ip)"],
+    r#"<servers>
+  <server>
+    <ip>192.168.1.1</ip>
+    <name>alpha</name>
+  </server>
+  <server>
+    <ip>192.168.1.2</ip>
+    <name>beta</name>
+  </server>
+</servers>"#,
+    "[\"192.168.1.1\",\"192.168.1.2\"]"
+);
+
+#[cfg(feature = "from-xml")]
+test!(
+    xml_with_attributes,
+    &[
+        "--from-xml",
+        "this.user.name + ' <' + this.user.email + '>'"
+    ],
+    r#"<user>
+  <name>Alice</name>
+  <email>alice@example.com</email>
+</user>"#,
+    "\"Alice <alice@example.com>\""
+);
+
+#[cfg(feature = "from-xml")]
+test!(
+    xml_simple_structure,
+    &["--from-xml", "int(this.point.x) + int(this.point.y)"],
+    r#"<point>
+  <x>10</x>
+  <y>20</y>
+</point>"#,
+    "30"
+);
+
+#[cfg(feature = "from-xml")]
+test!(
+    xml_text_content,
+    &["--from-xml", "this.message"],
+    r#"<message>Hello, World!</message>"#,
+    r#""Hello, World!""#
+);
+
+#[cfg(feature = "from-xml")]
+test!(
+    xml_mixed_content,
+    &[
+        "--from-xml",
+        "this.person.name + ' is ' + string(this.person.age)"
+    ],
+    r#"<person>
+  <name>Bob</name>
+  <age>25</age>
+</person>"#,
+    "\"Bob is 25\""
+);
+
+#[cfg(feature = "from-xml")]
+test!(
+    xml_to_pretty_sorted_json,
+    &["--from-xml", "--sort-keys", "--pretty-print", "this"],
+    r#"<root>
+  <person>
+    <name>Alice</name>
+    <age>30</age>
+  </person>
+  <id>1</id>
+</root>"#,
+    r#"{
+  "root": {
+    "id": "1",
+    "person": {
+      "age": "30",
+      "name": "Alice"
+    }
+  }
+}"#
+);