celq 0.3.2__tar.gz → 0.3.3__tar.gz

{celq-0.3.2 → celq-0.3.3}/CHANGELOG.md

@@ -1,13 +1,25 @@
 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
 
 * Downgraded the MSRV to Rust 1.90
 
 [v0.3.1](https://github.com/IvanIsCoding/celq/releases/tag/v0.3.1) - 2026-01-27
+------------------------------------------------------------------------
+
 
 ### Added
 

{celq-0.3.2 → celq-0.3.3}/Cargo.lock

@@ -201,7 +201,7 @@ dependencies = [
 
 [[package]]
 name = "celq"
-version = "0.3.2"
+version = "0.3.3"
 dependencies = [
  "anyhow",
  "cel",
@@ -216,6 +216,7 @@ dependencies = [
  "serde_json",
  "tempfile",
  "toml",
+ "xml2json-rs",
 ]
 
 [[package]]
@@ -583,6 +584,15 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "quick-xml"
+version = "0.23.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11bafc859c6815fbaffbbbf4229ecb767ac913fecb27f9ad4343662e9ef099ea"
+dependencies = [
+ "memchr",
+]
+
 [[package]]
 name = "quote"
 version = "1.0.42"
@@ -1143,6 +1153,19 @@ version = "0.46.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f17a85883d4e6d00e8a97c586de764dabcc06133f7f1d55dce5cdc070ad7fe59"
 
+[[package]]
+name = "xml2json-rs"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c6ba4fb1256176d2eb02e25065efade8e43215a4d0743cb823991aea314077ea"
+dependencies = [
+ "lazy_static",
+ "quick-xml",
+ "regex",
+ "serde",
+ "serde_json",
+]
+
 [[package]]
 name = "zerocopy"
 version = "0.8.33"

{celq-0.3.2 → celq-0.3.3}/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "celq"
 description = "A CEL command-line query tool for JSON data"
-version = "0.3.2"
+version = "0.3.3"
 edition = "2024"
 rust-version = "1.90"
 authors = ["Ivan Carvalho <ivancarvalho@gatech.edu>"]
@@ -34,9 +34,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]
@@ -52,6 +53,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"

{celq-0.3.2 → celq-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: celq
-Version: 0.3.2
+Version: 0.3.3
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
@@ -40,7 +40,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/).
 
@@ -101,6 +101,14 @@ If you are a [Chocolatey](https://community.chocolatey.org/) user on Windows, yo
 choco install celq
 ```
 
+### WinGet (Windows)
+
+If you are a [WinGet](https://learn.microsoft.com/windows/package-manager/winget/) user on Windows, you can install `celq` with:
+
+```bash
+winget install IvanIsCoding.celq
+```
+
 ### Cargo
 
 #### Installing From Source 
@@ -179,7 +187,11 @@ su root -c 'install -m 755 celq /usr/local/bin/'
 
 ### OpenBSD
 
-OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for instructions.
+OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for installation instructions.
+
+### NetBSD
+
+NetBSD builds are tested in CI against the latest stable release. `celq` aims to remain compatible with the Rust version provided by the NetBSD pkgsrc quarterly branch. See the [Cargo](#cargo) section for installation instructions.
 
 ### NPM (Node.js/JavaScript)
 
@@ -208,6 +220,35 @@ If you have [uv](https://github.com/astral-sh/uv) installed, `celq` can be used
 uvx celq -n '"Hello World"'
 ```
 
+### Conda Forge
+
+celq is available on [conda-forge](https://anaconda.org/channels/conda-forge/packages/celq/overview) and can be installed with `conda`, `mamba`, `micromamba`, and `pixi`:
+
+```bash
+conda install -c conda-forge celq
+```
+
+If you have [pixi](https://pixi.prefix.dev/latest/), you can run celq in a temporary environment with:
+
+```bash
+pixi exec celq -n '"Hello World"'
+```
+
+### Mise
+
+celq can be used with [mise](https://mise.jdx.dev/). To install celq, use the Conda back-end:
+
+```bash
+mise use -g conda:celq
+```
+
+Alternatively, add this to `mise.toml`:
+
+```toml
+[tools]
+"conda:celq" = "latest"
+```
+
 ## Limitations
 
 ### Eager JSON Parsing

{celq-0.3.2 → celq-0.3.3}/README.md

@@ -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/).
 
@@ -80,6 +80,14 @@ If you are a [Chocolatey](https://community.chocolatey.org/) user on Windows, yo
 choco install celq
 ```
 
+### WinGet (Windows)
+
+If you are a [WinGet](https://learn.microsoft.com/windows/package-manager/winget/) user on Windows, you can install `celq` with:
+
+```bash
+winget install IvanIsCoding.celq
+```
+
 ### Cargo
 
 #### Installing From Source 
@@ -158,7 +166,11 @@ su root -c 'install -m 755 celq /usr/local/bin/'
 
 ### OpenBSD
 
-OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for instructions.
+OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for installation instructions.
+
+### NetBSD
+
+NetBSD builds are tested in CI against the latest stable release. `celq` aims to remain compatible with the Rust version provided by the NetBSD pkgsrc quarterly branch. See the [Cargo](#cargo) section for installation instructions.
 
 ### NPM (Node.js/JavaScript)
 
@@ -187,6 +199,35 @@ If you have [uv](https://github.com/astral-sh/uv) installed, `celq` can be used
 uvx celq -n '"Hello World"'
 ```
 
+### Conda Forge
+
+celq is available on [conda-forge](https://anaconda.org/channels/conda-forge/packages/celq/overview) and can be installed with `conda`, `mamba`, `micromamba`, and `pixi`:
+
+```bash
+conda install -c conda-forge celq
+```
+
+If you have [pixi](https://pixi.prefix.dev/latest/), you can run celq in a temporary environment with:
+
+```bash
+pixi exec celq -n '"Hello World"'
+```
+
+### Mise
+
+celq can be used with [mise](https://mise.jdx.dev/). To install celq, use the Conda back-end:
+
+```bash
+mise use -g conda:celq
+```
+
+Alternatively, add this to `mise.toml`:
+
+```toml
+[tools]
+"conda:celq" = "latest"
+```
+
 ## Limitations
 
 ### Eager JSON Parsing

{celq-0.3.2 → celq-0.3.3}/docs/installation_guide.md

@@ -68,6 +68,14 @@ If you are a [Chocolatey](https://community.chocolatey.org/) user on Windows, yo
 choco install celq
 ```
 
+### WinGet (Windows)
+
+If you are a [WinGet](https://learn.microsoft.com/windows/package-manager/winget/) user on Windows, you can install `celq` with:
+
+```bash
+winget install IvanIsCoding.celq
+```
+
 ### Cargo
 
 #### Installing From Source 
@@ -168,7 +176,11 @@ su root -c 'install -m 755 celq /usr/local/bin/'
 
 ### OpenBSD
 
-OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for instructions.
+OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for installation instructions.
+
+### NetBSD
+
+NetBSD builds are tested in CI against the latest stable release. `celq` aims to remain compatible with the Rust version provided by the NetBSD pkgsrc quarterly branch. See the [Cargo](#cargo) section for installation instructions.
 
 ### NPM (Node.js/JavaScript)
 
@@ -197,6 +209,35 @@ If you have [uv](https://github.com/astral-sh/uv) installed, `celq` can be used
 uvx celq -n '"Hello World"'
 ```
 
+### Conda Forge
+
+celq is available on [conda-forge](https://anaconda.org/channels/conda-forge/packages/celq/overview) and can be installed with `conda`, `mamba`, `micromamba`, and `pixi`:
+
+```bash
+conda install -c conda-forge celq
+```
+
+If you have [pixi](https://pixi.prefix.dev/latest/), you can run celq in a temporary environment with:
+
+```bash
+pixi exec celq -n '"Hello World"'
+```
+
+### Mise
+
+celq can be used with [mise](https://mise.jdx.dev/). To install celq, use the Conda back-end:
+
+```bash
+mise use -g conda:celq
+```
+
+Alternatively, add this to `mise.toml`:
+
+```toml
+[tools]
+"conda:celq" = "latest"
+```
+
 ## Integrity and Authenticity
 
 `celq` publishes a `SHA256SUMS` file for each of its release in the [GitHub Releases page](https://github.com/IvanIsCoding/celq/releases). The checksum can be used to verify integrity of the downloaded files.

{celq-0.3.2 → celq-0.3.3}/docs/manual.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.

{celq-0.3.2 → celq-0.3.3}/pypi/README.md

@@ -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/).
 
@@ -80,6 +80,14 @@ If you are a [Chocolatey](https://community.chocolatey.org/) user on Windows, yo
 choco install celq
 ```
 
+### WinGet (Windows)
+
+If you are a [WinGet](https://learn.microsoft.com/windows/package-manager/winget/) user on Windows, you can install `celq` with:
+
+```bash
+winget install IvanIsCoding.celq
+```
+
 ### Cargo
 
 #### Installing From Source 
@@ -158,7 +166,11 @@ su root -c 'install -m 755 celq /usr/local/bin/'
 
 ### OpenBSD
 
-OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for instructions.
+OpenBSD builds are tested in CI using the latest stable release. `celq` strives to always compile with the Rust version provided in the ports tree. Refer to the [Cargo](#cargo) section for installation instructions.
+
+### NetBSD
+
+NetBSD builds are tested in CI against the latest stable release. `celq` aims to remain compatible with the Rust version provided by the NetBSD pkgsrc quarterly branch. See the [Cargo](#cargo) section for installation instructions.
 
 ### NPM (Node.js/JavaScript)
 
@@ -187,6 +199,35 @@ If you have [uv](https://github.com/astral-sh/uv) installed, `celq` can be used
 uvx celq -n '"Hello World"'
 ```
 
+### Conda Forge
+
+celq is available on [conda-forge](https://anaconda.org/channels/conda-forge/packages/celq/overview) and can be installed with `conda`, `mamba`, `micromamba`, and `pixi`:
+
+```bash
+conda install -c conda-forge celq
+```
+
+If you have [pixi](https://pixi.prefix.dev/latest/), you can run celq in a temporary environment with:
+
+```bash
+pixi exec celq -n '"Hello World"'
+```
+
+### Mise
+
+celq can be used with [mise](https://mise.jdx.dev/). To install celq, use the Conda back-end:
+
+```bash
+mise use -g conda:celq
+```
+
+Alternatively, add this to `mise.toml`:
+
+```toml
+[tools]
+"conda:celq" = "latest"
+```
+
 ## Limitations
 
 ### Eager JSON Parsing

{celq-0.3.2 → celq-0.3.3}/src/cli.rs

@@ -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 {

{celq-0.3.2 → celq-0.3.3}/src/json2cel.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")]
             {

{celq-0.3.2 → celq-0.3.3}/tests/golden.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"
+    }
+  }
+}"#
+);