@ivaniscoding/celq-linux-arm64 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +47 -37
  2. package/bin/celq +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  # celq
2
- [![Crates.io](https://img.shields.io/crates/v/celq.svg)](https://crates.io/crates/celq) [![Documentation](https://docs.rs/celq/badge.svg)](https://docs.rs/celq) [![Playground](https://img.shields.io/badge/playground-live-brightgreen)](https://celq-playground.github.io/) [![Minimum rustc 1.91](https://img.shields.io/badge/rustc-1.91+-blue.svg)](https://rust-lang.github.io/rfcs/2495-min-rust-version.html)
2
+ [![Crates.io](https://img.shields.io/crates/v/celq.svg)](https://crates.io/crates/celq) [![Documentation](https://docs.rs/celq/badge.svg)](https://docs.rs/celq) [![Playground](https://img.shields.io/badge/playground-live-brightgreen)](https://celq-playground.github.io/) [![Minimum rustc 1.90](https://img.shields.io/badge/rustc-1.90+-blue.svg)](https://rust-lang.github.io/rfcs/2495-min-rust-version.html)
3
3
 
4
4
  **celq** is a command-line tool for evaluating [Common Expression Language (CEL)](https://cel.dev/) expressions. It processes JSON input, performs computations, and outputs results. Think of it as if [jq](https://jqlang.org/) supported CEL.
5
5
 
@@ -63,21 +63,21 @@ If you are a [macOS Homebrew](https://brew.sh/) user, then you can install celq
63
63
  brew install get-celq/tap/celq
64
64
  ```
65
65
 
66
- ### Chocolatey (Windows)
66
+ ### Scoop (Windows)
67
67
 
68
- If you are a [Chocolatey](https://community.chocolatey.org/) user on Windows, you can install `celq` with:
68
+ If you are a [Scoop](https://scoop.sh/) user on Windows, you can install `celq` with:
69
69
 
70
70
  ```bash
71
- choco install celq
71
+ scoop bucket add get-celq https://github.com/get-celq/scoop-bucket
72
+ scoop install get-celq/celq
72
73
  ```
73
74
 
74
- ### Scoop (Windows)
75
+ ### Chocolatey (Windows)
75
76
 
76
- If you are a [Scoop](https://scoop.sh/) user on Windows, you can install `celq` with:
77
+ If you are a [Chocolatey](https://community.chocolatey.org/) user on Windows, you can install `celq` with:
77
78
 
78
79
  ```bash
79
- scoop bucket add get-celq https://github.com/get-celq/scoop-bucket
80
- scoop install get-celq/celq
80
+ choco install celq
81
81
  ```
82
82
 
83
83
  ### Cargo
@@ -98,33 +98,6 @@ If you have [cargo-binstall](https://github.com/cargo-bins/cargo-binstall) insta
98
98
  cargo binstall celq
99
99
  ```
100
100
 
101
- ### Python
102
-
103
- celq is packaged for [PyPI](https://pypi.org/project/celq/). Python users can install it with `pip`:
104
-
105
- ```bash
106
- pip install celq
107
- ```
108
-
109
- If you have [uv](https://github.com/astral-sh/uv) installed, `celq` can be used as a tool:
110
- ```bash
111
- uvx celq -n '"Hello World"'
112
- ```
113
-
114
- ### NPM (Node.js/JavaScript)
115
-
116
- `celq` is packaged for [NPM](https://www.npmjs.com/package/celq). Node.js users can install celq in their project with:
117
-
118
- ```bash
119
- npm install celq
120
- ```
121
-
122
- This adds celq to `package.json` and makes it available for scripts. It's also possible to run single commands with [npx](https://docs.npmjs.com/cli/v8/commands/npx):
123
-
124
- ```bash
125
- npx celq -n '"Hello World"'
126
- ```
127
-
128
101
  ### GitHub Actions
129
102
 
130
103
  `celq` can be used in GitHub actions. For one-off commands, the [get-celq/celq-action](https://github.com/get-celq/celq-action) is the quickest way:
@@ -158,6 +131,12 @@ If you are going to use `celq` in scripts or for multiple calls, we recommend us
158
131
  nix run github:IvanIsCoding/celq -- -n '"Hello World"'
159
132
  ```
160
133
 
134
+ By default, Nix fetches the stable version from crates.io. If you want to run the code from HEAD, use the `dev` derivation:
135
+
136
+ ```bash
137
+ nix run github:IvanIsCoding/celq#dev -- -n '"Hello World"'
138
+ ```
139
+
161
140
  See the [installation guide](https://docs.rs/celq/latest/celq/installation_guide) for other Nix setups.
162
141
 
163
142
  ### FreeBSD
@@ -177,13 +156,44 @@ su root -c 'install -m 755 celq /usr/local/bin/'
177
156
 
178
157
  `celq` can also be installed from source following the [Cargo](#cargo) section. We strive to always compile with the Rust version provided in the ports tree.
179
158
 
159
+ ### OpenBSD
160
+
161
+ 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.
162
+
163
+ ### NPM (Node.js/JavaScript)
164
+
165
+ `celq` is packaged for [NPM](https://www.npmjs.com/package/celq). Node.js users can install celq in their project with:
166
+
167
+ ```bash
168
+ npm install celq
169
+ ```
170
+
171
+ This adds celq to `package.json` and makes it available for scripts. It's also possible to run single commands with [npx](https://docs.npmjs.com/cli/v8/commands/npx):
172
+
173
+ ```bash
174
+ npx celq -n '"Hello World"'
175
+ ```
176
+
177
+ ### Python
178
+
179
+ celq is packaged for [PyPI](https://pypi.org/project/celq/). Python users can install it with `pip`:
180
+
181
+ ```bash
182
+ pip install celq
183
+ ```
184
+
185
+ If you have [uv](https://github.com/astral-sh/uv) installed, `celq` can be used as a tool:
186
+ ```bash
187
+ uvx celq -n '"Hello World"'
188
+ ```
189
+
180
190
  ## Limitations
181
191
 
182
192
  ### Eager JSON Parsing
183
193
 
184
194
  `celq` eagerly parses all JSON input into memory before evaluation. This design was made to simplify the code implementation, at the cost of memory and performance.
185
195
 
186
- Currently, there are no benchmarks for `celq`. I believe the tool is "good enough" for my personal use. That might be revisited in the future. In the meantime, expect `celq` to be slower than `jq`.
196
+ Currently, there are no benchmarks for `celq`. I believe the tool is "good enough" for my personal use. That might be revisited in the future. In the meantime, expect `celq` to be slower than `jq`. With that being said, `celq` feels snappy in practice. `celq` glues together Rust parsers that are performant with a CEL engine that strives to be fast.
187
197
 
188
198
  ### CEL Implementation Differences
189
199
 
@@ -219,7 +229,7 @@ Special thanks to the maintainers of:
219
229
 
220
230
  ## Large Language Models Disclosure
221
231
 
222
- Many commits in this repository were co-authored by LLMs. All commits were guided and reviewed by a human. The original author has significantly refactored the AI output to conform to his opinionated view.
232
+ Many commits in this repository were co-authored by LLMs. All commits were guided and reviewed by a human. I tried my best to keep things simple and auditable.
223
233
 
224
234
  All the documentation in the manual has been hand-crafted. That was done to keep the tone of the original author. If you find a typo or a grammar mistake, please send a pull request.
225
235
 
package/bin/celq CHANGED
Binary file
package/package.json CHANGED
@@ -21,5 +21,5 @@
21
21
  "type": "git",
22
22
  "url": "git+https://github.com/IvanIsCoding/celq.git"
23
23
  },
24
- "version": "0.3.0"
24
+ "version": "0.3.2"
25
25
  }