csonpath 0.15.0__tar.gz → 0.17.0__tar.gz

{csonpath-0.15.0 → csonpath-0.17.0}/Makefile

@@ -5,7 +5,7 @@ YYJSON_LDFLAGS=$(shell pkg-config --libs yyjson)
 
 include config.mk
 
-all: test-json-c-get-a test-json-update test-json-filter test-json-subpath test-json-c-array-root test-json-filter-and-missing-key test-json-get-array-big-index test-json-union
+all: test-json-c-get-a test-json-update test-json-filter test-json-subpath test-json-c-array-root test-json-filter-and-missing-key test-json-get-array-big-index test-json-union test-json-audit-bugs test-json-crash-vectors test-json-my-fuzz
 
 YYJSON_TESTS=test-yyjson
 
@@ -15,7 +15,7 @@ bench:
 bench-clean:
 	make -C bench clean
 
-.PHONY: all clean tests pip-dev pip-dev bench bench-clean
+.PHONY: all clean tests pip-dev pip-dev bench bench-clean tests-cli
 
 CFLAGS+= -Wall -Wextra -Wno-unused-function -Wno-unused-parameter -O0 -g
 
@@ -43,10 +43,19 @@ test-json-get-array-big-index: tests/json-c/get-array-big-index.c csonpath_json-
 test-json-union: tests/json-c/union.c csonpath_json-c.h csonpath.h csonpath_do.h
 	$(CC) tests/json-c/union.c $(EXTRA_FILES) $(JSON_C_CFLAGS) $(CFLAGS) -Wno-format -I./ -o test-json-union  $(JSON_C_LDFLAGS) $(LDFLAGS)
 
+test-json-audit-bugs: tests/json-c/audit-bugs.c csonpath_json-c.h csonpath.h csonpath_do.h
+	$(CC) tests/json-c/audit-bugs.c $(EXTRA_FILES) $(JSON_C_CFLAGS) $(CFLAGS) -Wno-format -I./ -o test-json-audit-bugs  $(JSON_C_LDFLAGS) $(LDFLAGS)
+
+test-json-crash-vectors: tests/json-c/crash-vectors.c csonpath_json-c.h csonpath.h csonpath_do.h
+	$(CC) tests/json-c/crash-vectors.c $(EXTRA_FILES) $(JSON_C_CFLAGS) $(CFLAGS) -Wno-format -I./ -o test-json-crash-vectors  $(JSON_C_LDFLAGS) $(LDFLAGS)
+
+test-json-my-fuzz: tests/json-c/my_fuzz.c csonpath_json-c.h csonpath_my_fuzzing.h csonpath.h csonpath_do.h
+	$(CC) tests/json-c/my_fuzz.c $(EXTRA_FILES) $(JSON_C_CFLAGS) $(CFLAGS) -Wno-format -I./ -o test-json-my-fuzz $(JSON_C_LDFLAGS) $(LDFLAGS)
+
 test-yyjson: tests/yyjson/test-yyjson.c csonpath_yyjson.h csonpath.h csonpath_do.h
 	$(CC) tests/yyjson/test-yyjson.c $(EXTRA_FILES) $(YYJSON_CFLAGS) $(CFLAGS) -Wno-format -I./ -o test-yyjson $(YYJSON_LDFLAGS) $(LDFLAGS)
 
- tests-c: test-json-c-get-a test-json-update test-json-filter test-json-subpath test-json-c-array-root test-json-filter-and-missing-key test-json-get-array-big-index test-json-union test-yyjson
+tests-c: test-json-c-get-a test-json-update test-json-filter test-json-subpath test-json-c-array-root test-json-filter-and-missing-key test-json-get-array-big-index test-json-union test-json-audit-bugs test-json-crash-vectors test-yyjson test-json-my-fuzz
 	./test-json-c-get-a
 	./test-json-update
 	./test-json-filter
@@ -55,7 +64,16 @@ test-yyjson: tests/yyjson/test-yyjson.c csonpath_yyjson.h csonpath.h csonpath_do
 	./test-json-filter-and-missing-key
 	./test-json-get-array-big-index
 	./test-json-union
+	./test-json-audit-bugs
+	./test-json-crash-vectors
 	./test-yyjson
+	./test-json-my-fuzz
+
+csonpath: cli/csonpath_cli.c csonpath_json-c.h csonpath.h csonpath_do.h
+	$(CC) cli/csonpath_cli.c $(EXTRA_FILES) $(JSON_C_CFLAGS) $(CFLAGS) -I./ -o csonpath $(JSON_C_LDFLAGS) $(LDFLAGS)
+
+tests-cli: csonpath
+	bash tests/cli/run.sh
 
 pip-dev:
 	pip install -e .[dev] --force-reinstall
@@ -66,5 +84,5 @@ tests-py: pip-dev
 tests: tests-py tests-c
 
 clean:
-	rm -rvf test-json-c-get-a test-json-update test-json-filter test-json-subpath test-json-c-array-root test-json-filter-and-missing-key test-json-get-array-big-index test-json-union test-yyjson
+	rm -rvf test-json-c-get-a test-json-update test-json-filter test-json-subpath test-json-c-array-root test-json-filter-and-missing-key test-json-get-array-big-index test-json-union test-json-audit-bugs test-json-crash-vectors test-yyjson test-json-my-fuzz csonpath
 

{csonpath-0.15.0/csonpath.egg-info → csonpath-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csonpath
-Version: 0.15.0
+Version: 0.17.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
@@ -15,7 +15,7 @@ Dynamic: license-file
 
 **csonpath** is a partial [JSONPath](https://goessner.net/articles/JsonPath/) implementation in C, with Python bindings. It allows you to query, update, and remove data from JSON objects using path expressions.
 
-Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work with any C library or environment that manipulates array, object, and scalar types—not just JSON. Out of the box, backends for [json-c](https://github.com/json-c/json-c) and Python are provided.
+Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work with any C library or environment that manipulates array, object, and scalar types—not just JSON. Out of the box, backends for [json-c](https://github.com/json-c/json-c), [yyjson](https://github.com/ibireme/yyjson), Python and Rust (via `serde_json`) are provided.
 
 ---
 
@@ -30,7 +30,8 @@ Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work wi
 | Array index | `$.array[0]` | Access by zero-based index |
 | Wildcard `[*]` | `$.array[*].field` | Iterate all array elements |
 | Recursive descent `..` | `$..name` | Search recursively for a key |
-| Union `\|` / `,` | `$.a \| $.b` or `$['a','b']` | Match multiple paths at once |
+| Union `,` (inside brackets) | `$['a','b']`, `$.array[0,1]`, `$.items[?n==1, ?n==2]` | Match all listed selectors at once |
+| OR fallback `\|` | `$.a \| $.b` | Try the left path first; fall back to the right one if it does not match. Only the first successful path is used. |
 | Filters | `$.items[?price > 10]` | Filter array elements |
 | Regex filters | `$.items[?name =~ "foo"]` | POSIX regex-based filtering |
 | Multiple filters (`&`) | `$.items[?a=1 & b=2]` | Combine conditions |
@@ -61,6 +62,7 @@ Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work wi
 - [Usage](#-usage)
 - [C API Reference](#-c-api-reference)
 - [Python API Reference](#-python-api-reference)
+- [CLI](#%EF%B8%8F-cli)
 - [Custom Backends](#-custom-backends)
 - [Running Tests](#-running-tests)
 - [Directory Structure](#-directory-structure)
@@ -86,6 +88,20 @@ Make sure to link against `json-c` when compiling:
 gcc myapp.c -o myapp $(pkg-config --cflags --libs json-c)
 ```
 
+### C (Rust backend)
+The Rust backend is located in `rust/`. It builds both a safe Rust API and the C glue required by the csonpath core.
+
+```sh
+cd rust
+cargo build
+cargo test
+```
+
+To use it from C, include the backend header and link against the produced static library:
+```c
+#include "rust/csonpath_rust_backend.h"
+```
+
 ### Python
 Install from PyPI:
 ```sh
@@ -251,6 +267,76 @@ Free the csonpath object.
 
 ---
 
+## 🖥️ CLI
+
+A standalone C CLI is available in `cli/csonpath_cli.c`. It links directly against `json-c` and the csonpath C core, so it works without Python.
+
+```sh
+make csonpath          # build ./csonpath
+make tests-cli         # run shell tests
+```
+
+It reads JSON from stdin, a file (`-f`), or a string (`-s`) and exposes the library operations through action flags.
+
+```sh
+# Get the first match (default)
+echo '{"a": "value", "array": [1, 2, 3]}' | ./csonpath '$.a'
+# => "value"
+
+# Find all matches
+echo '{"items": [{"price": 5}, {"price": 15}]}' | ./csonpath -a '$.items[?price > 10]'
+# => [{"price":15}]
+
+# One match per line
+echo '{"array": [1, 2, 3]}' | ./csonpath -a -o lines '$.array[*]'
+# => 1
+# => 2
+# => 3
+
+# Set or create a value
+echo '{"a": 1}' | ./csonpath --set '42' '$.x.y.z'
+# => {"a":1,"x":{"y":{"z":42}}}
+
+# Or with a positional value
+echo '{"a": 1}' | ./csonpath '$.x.y.z' '42'
+
+# Remove matches
+echo '{"a": 1, "b": 2}' | ./csonpath -d '$.b'
+# => {"a":1}
+
+# Edit a file in place
+./csonpath -f data.json -p -i --set '"2.0"' '$.version'
+```
+
+### Options
+
+| Option | Description |
+|---|---|
+| `-a`, `--all` | Return all matches instead of the first one. |
+| `-d`, `--delete` | Remove matches and print the modified JSON. |
+| `--set VALUE` | Set `PATH` to `VALUE` (JSON). |
+| `VALUE` (positional) | Alternative to `--set`. |
+| `-r`, `--raw` | Treat the value as a raw string. |
+| `-i`, `--in-place` | Edit `FILE` in place (requires `--file`). |
+| `--strict` | Exit with an error if `--delete` removes nothing. |
+| `-f FILE`, `--file FILE` | Read JSON from `FILE` instead of stdin. |
+| `-s JSON`, `--string JSON` | Read JSON from a string. |
+| `-j`, `--jq-like` | Allow jq-style paths without a leading `$`. |
+| `-p`, `--pretty` | Pretty-print JSON output. |
+| `-o {json,pretty,raw,lines}` | Output format (default: `json`). |
+| `-e`, `--empty-array` | Return `[]` instead of nothing when `-a` matches nothing. |
+
+### Exit codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success. |
+| `1` | No match found, or `--strict` delete found nothing. |
+| `EINVAL` | Usage error, JSON parse error, JSONPath compilation error, or invalid JSON value. |
+| `errno` | I/O error (e.g. `ENOENT`, `EACCES`). |
+
+---
+
 ## 🔌 Custom Backends
 
 csonpath is designed to be backend-agnostic. It can work with any data structure that supports array, object, and scalar semantics.
@@ -259,7 +345,9 @@ To create a custom backend, define the required macros and types in a header fil
 
 For more details, see the existing backend implementations:
 - `csonpath_json-c.h` — json-c backend
+- `csonpath_yyjson.h` — yyjson backend
 - `csonpath_python.c` — Python backend
+- `rust/csonpath_rust_backend.h` — Rust / serde_json backend
 
 ---
 
@@ -270,6 +358,12 @@ For more details, see the existing backend implementations:
 make tests-c
 ```
 
+### Rust Tests
+```sh
+cd rust
+cargo test
+```
+
 ### Python Tests
 ```sh
 make tests-py
@@ -288,7 +382,10 @@ make tests
 |---|---|
 | `csonpath.h`, `csonpath_do.h` | Core implementation (header-only style) |
 | `csonpath_json-c.h` | json-c backend |
+| `csonpath_yyjson.h` | yyjson backend |
 | `csonpath_python.c` | Python C extension backend |
+| `rust/` | Rust backend (safe API, FFI, C glue) |
+| `csonpath_my_fuzzing.h` | Fuzzer helpers (C) |
 | `tests/` | C and Python test suites |
 | `bench/` | Performance benchmarks |
 

{csonpath-0.15.0 → csonpath-0.17.0}/README.md

@@ -6,7 +6,7 @@
 
 **csonpath** is a partial [JSONPath](https://goessner.net/articles/JsonPath/) implementation in C, with Python bindings. It allows you to query, update, and remove data from JSON objects using path expressions.
 
-Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work with any C library or environment that manipulates array, object, and scalar types—not just JSON. Out of the box, backends for [json-c](https://github.com/json-c/json-c) and Python are provided.
+Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work with any C library or environment that manipulates array, object, and scalar types—not just JSON. Out of the box, backends for [json-c](https://github.com/json-c/json-c), [yyjson](https://github.com/ibireme/yyjson), Python and Rust (via `serde_json`) are provided.
 
 ---
 
@@ -21,7 +21,8 @@ Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work wi
 | Array index | `$.array[0]` | Access by zero-based index |
 | Wildcard `[*]` | `$.array[*].field` | Iterate all array elements |
 | Recursive descent `..` | `$..name` | Search recursively for a key |
-| Union `\|` / `,` | `$.a \| $.b` or `$['a','b']` | Match multiple paths at once |
+| Union `,` (inside brackets) | `$['a','b']`, `$.array[0,1]`, `$.items[?n==1, ?n==2]` | Match all listed selectors at once |
+| OR fallback `\|` | `$.a \| $.b` | Try the left path first; fall back to the right one if it does not match. Only the first successful path is used. |
 | Filters | `$.items[?price > 10]` | Filter array elements |
 | Regex filters | `$.items[?name =~ "foo"]` | POSIX regex-based filtering |
 | Multiple filters (`&`) | `$.items[?a=1 & b=2]` | Combine conditions |
@@ -52,6 +53,7 @@ Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work wi
 - [Usage](#-usage)
 - [C API Reference](#-c-api-reference)
 - [Python API Reference](#-python-api-reference)
+- [CLI](#%EF%B8%8F-cli)
 - [Custom Backends](#-custom-backends)
 - [Running Tests](#-running-tests)
 - [Directory Structure](#-directory-structure)
@@ -77,6 +79,20 @@ Make sure to link against `json-c` when compiling:
 gcc myapp.c -o myapp $(pkg-config --cflags --libs json-c)
 ```
 
+### C (Rust backend)
+The Rust backend is located in `rust/`. It builds both a safe Rust API and the C glue required by the csonpath core.
+
+```sh
+cd rust
+cargo build
+cargo test
+```
+
+To use it from C, include the backend header and link against the produced static library:
+```c
+#include "rust/csonpath_rust_backend.h"
+```
+
 ### Python
 Install from PyPI:
 ```sh
@@ -242,6 +258,76 @@ Free the csonpath object.
 
 ---
 
+## 🖥️ CLI
+
+A standalone C CLI is available in `cli/csonpath_cli.c`. It links directly against `json-c` and the csonpath C core, so it works without Python.
+
+```sh
+make csonpath          # build ./csonpath
+make tests-cli         # run shell tests
+```
+
+It reads JSON from stdin, a file (`-f`), or a string (`-s`) and exposes the library operations through action flags.
+
+```sh
+# Get the first match (default)
+echo '{"a": "value", "array": [1, 2, 3]}' | ./csonpath '$.a'
+# => "value"
+
+# Find all matches
+echo '{"items": [{"price": 5}, {"price": 15}]}' | ./csonpath -a '$.items[?price > 10]'
+# => [{"price":15}]
+
+# One match per line
+echo '{"array": [1, 2, 3]}' | ./csonpath -a -o lines '$.array[*]'
+# => 1
+# => 2
+# => 3
+
+# Set or create a value
+echo '{"a": 1}' | ./csonpath --set '42' '$.x.y.z'
+# => {"a":1,"x":{"y":{"z":42}}}
+
+# Or with a positional value
+echo '{"a": 1}' | ./csonpath '$.x.y.z' '42'
+
+# Remove matches
+echo '{"a": 1, "b": 2}' | ./csonpath -d '$.b'
+# => {"a":1}
+
+# Edit a file in place
+./csonpath -f data.json -p -i --set '"2.0"' '$.version'
+```
+
+### Options
+
+| Option | Description |
+|---|---|
+| `-a`, `--all` | Return all matches instead of the first one. |
+| `-d`, `--delete` | Remove matches and print the modified JSON. |
+| `--set VALUE` | Set `PATH` to `VALUE` (JSON). |
+| `VALUE` (positional) | Alternative to `--set`. |
+| `-r`, `--raw` | Treat the value as a raw string. |
+| `-i`, `--in-place` | Edit `FILE` in place (requires `--file`). |
+| `--strict` | Exit with an error if `--delete` removes nothing. |
+| `-f FILE`, `--file FILE` | Read JSON from `FILE` instead of stdin. |
+| `-s JSON`, `--string JSON` | Read JSON from a string. |
+| `-j`, `--jq-like` | Allow jq-style paths without a leading `$`. |
+| `-p`, `--pretty` | Pretty-print JSON output. |
+| `-o {json,pretty,raw,lines}` | Output format (default: `json`). |
+| `-e`, `--empty-array` | Return `[]` instead of nothing when `-a` matches nothing. |
+
+### Exit codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success. |
+| `1` | No match found, or `--strict` delete found nothing. |
+| `EINVAL` | Usage error, JSON parse error, JSONPath compilation error, or invalid JSON value. |
+| `errno` | I/O error (e.g. `ENOENT`, `EACCES`). |
+
+---
+
 ## 🔌 Custom Backends
 
 csonpath is designed to be backend-agnostic. It can work with any data structure that supports array, object, and scalar semantics.
@@ -250,7 +336,9 @@ To create a custom backend, define the required macros and types in a header fil
 
 For more details, see the existing backend implementations:
 - `csonpath_json-c.h` — json-c backend
+- `csonpath_yyjson.h` — yyjson backend
 - `csonpath_python.c` — Python backend
+- `rust/csonpath_rust_backend.h` — Rust / serde_json backend
 
 ---
 
@@ -261,6 +349,12 @@ For more details, see the existing backend implementations:
 make tests-c
 ```
 
+### Rust Tests
+```sh
+cd rust
+cargo test
+```
+
 ### Python Tests
 ```sh
 make tests-py
@@ -279,7 +373,10 @@ make tests
 |---|---|
 | `csonpath.h`, `csonpath_do.h` | Core implementation (header-only style) |
 | `csonpath_json-c.h` | json-c backend |
+| `csonpath_yyjson.h` | yyjson backend |
 | `csonpath_python.c` | Python C extension backend |
+| `rust/` | Rust backend (safe API, FFI, C glue) |
+| `csonpath_my_fuzzing.h` | Fuzzer helpers (C) |
 | `tests/` | C and Python test suites |
 | `bench/` | Performance benchmarks |
 

{csonpath-0.15.0 → csonpath-0.17.0}/configure

@@ -21,12 +21,17 @@ for arg in $@; do
 	CFLAGS="${CFLAGS} -DCSONPATH_PCRE2_POSIX $(pkg-config --cflags libpcre2-posix)"
 	LDFLAGS="${LDFLAGS} $(pkg-config --libs libpcre2-posix)"
     fi
+    if [ "--asan" = $arg ]; then
+	CFLAGS="${CFLAGS} -fsanitize=address -fno-omit-frame-pointer"
+	LDFLAGS="${LDFLAGS} -fsanitize=address"
+    fi
     if [ "--help" = $arg ]; then
 	echo "help"
 	echo "	--tiny-regex"
 	echo "	--pcre2-regex"
 	echo "	--pcre2-posix"
 	echo "	--no-regex"
+	echo "	--asan"
     fi
 done
 

{csonpath-0.15.0 → csonpath-0.17.0/csonpath.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csonpath
-Version: 0.15.0
+Version: 0.17.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
@@ -15,7 +15,7 @@ Dynamic: license-file
 
 **csonpath** is a partial [JSONPath](https://goessner.net/articles/JsonPath/) implementation in C, with Python bindings. It allows you to query, update, and remove data from JSON objects using path expressions.
 
-Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work with any C library or environment that manipulates array, object, and scalar types—not just JSON. Out of the box, backends for [json-c](https://github.com/json-c/json-c) and Python are provided.
+Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work with any C library or environment that manipulates array, object, and scalar types—not just JSON. Out of the box, backends for [json-c](https://github.com/json-c/json-c), [yyjson](https://github.com/ibireme/yyjson), Python and Rust (via `serde_json`) are provided.
 
 ---
 
@@ -30,7 +30,8 @@ Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work wi
 | Array index | `$.array[0]` | Access by zero-based index |
 | Wildcard `[*]` | `$.array[*].field` | Iterate all array elements |
 | Recursive descent `..` | `$..name` | Search recursively for a key |
-| Union `\|` / `,` | `$.a \| $.b` or `$['a','b']` | Match multiple paths at once |
+| Union `,` (inside brackets) | `$['a','b']`, `$.array[0,1]`, `$.items[?n==1, ?n==2]` | Match all listed selectors at once |
+| OR fallback `\|` | `$.a \| $.b` | Try the left path first; fall back to the right one if it does not match. Only the first successful path is used. |
 | Filters | `$.items[?price > 10]` | Filter array elements |
 | Regex filters | `$.items[?name =~ "foo"]` | POSIX regex-based filtering |
 | Multiple filters (`&`) | `$.items[?a=1 & b=2]` | Combine conditions |
@@ -61,6 +62,7 @@ Unlike many JSONPath libraries, csonpath is **backend-agnostic**: it can work wi
 - [Usage](#-usage)
 - [C API Reference](#-c-api-reference)
 - [Python API Reference](#-python-api-reference)
+- [CLI](#%EF%B8%8F-cli)
 - [Custom Backends](#-custom-backends)
 - [Running Tests](#-running-tests)
 - [Directory Structure](#-directory-structure)
@@ -86,6 +88,20 @@ Make sure to link against `json-c` when compiling:
 gcc myapp.c -o myapp $(pkg-config --cflags --libs json-c)
 ```
 
+### C (Rust backend)
+The Rust backend is located in `rust/`. It builds both a safe Rust API and the C glue required by the csonpath core.
+
+```sh
+cd rust
+cargo build
+cargo test
+```
+
+To use it from C, include the backend header and link against the produced static library:
+```c
+#include "rust/csonpath_rust_backend.h"
+```
+
 ### Python
 Install from PyPI:
 ```sh
@@ -251,6 +267,76 @@ Free the csonpath object.
 
 ---
 
+## 🖥️ CLI
+
+A standalone C CLI is available in `cli/csonpath_cli.c`. It links directly against `json-c` and the csonpath C core, so it works without Python.
+
+```sh
+make csonpath          # build ./csonpath
+make tests-cli         # run shell tests
+```
+
+It reads JSON from stdin, a file (`-f`), or a string (`-s`) and exposes the library operations through action flags.
+
+```sh
+# Get the first match (default)
+echo '{"a": "value", "array": [1, 2, 3]}' | ./csonpath '$.a'
+# => "value"
+
+# Find all matches
+echo '{"items": [{"price": 5}, {"price": 15}]}' | ./csonpath -a '$.items[?price > 10]'
+# => [{"price":15}]
+
+# One match per line
+echo '{"array": [1, 2, 3]}' | ./csonpath -a -o lines '$.array[*]'
+# => 1
+# => 2
+# => 3
+
+# Set or create a value
+echo '{"a": 1}' | ./csonpath --set '42' '$.x.y.z'
+# => {"a":1,"x":{"y":{"z":42}}}
+
+# Or with a positional value
+echo '{"a": 1}' | ./csonpath '$.x.y.z' '42'
+
+# Remove matches
+echo '{"a": 1, "b": 2}' | ./csonpath -d '$.b'
+# => {"a":1}
+
+# Edit a file in place
+./csonpath -f data.json -p -i --set '"2.0"' '$.version'
+```
+
+### Options
+
+| Option | Description |
+|---|---|
+| `-a`, `--all` | Return all matches instead of the first one. |
+| `-d`, `--delete` | Remove matches and print the modified JSON. |
+| `--set VALUE` | Set `PATH` to `VALUE` (JSON). |
+| `VALUE` (positional) | Alternative to `--set`. |
+| `-r`, `--raw` | Treat the value as a raw string. |
+| `-i`, `--in-place` | Edit `FILE` in place (requires `--file`). |
+| `--strict` | Exit with an error if `--delete` removes nothing. |
+| `-f FILE`, `--file FILE` | Read JSON from `FILE` instead of stdin. |
+| `-s JSON`, `--string JSON` | Read JSON from a string. |
+| `-j`, `--jq-like` | Allow jq-style paths without a leading `$`. |
+| `-p`, `--pretty` | Pretty-print JSON output. |
+| `-o {json,pretty,raw,lines}` | Output format (default: `json`). |
+| `-e`, `--empty-array` | Return `[]` instead of nothing when `-a` matches nothing. |
+
+### Exit codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success. |
+| `1` | No match found, or `--strict` delete found nothing. |
+| `EINVAL` | Usage error, JSON parse error, JSONPath compilation error, or invalid JSON value. |
+| `errno` | I/O error (e.g. `ENOENT`, `EACCES`). |
+
+---
+
 ## 🔌 Custom Backends
 
 csonpath is designed to be backend-agnostic. It can work with any data structure that supports array, object, and scalar semantics.
@@ -259,7 +345,9 @@ To create a custom backend, define the required macros and types in a header fil
 
 For more details, see the existing backend implementations:
 - `csonpath_json-c.h` — json-c backend
+- `csonpath_yyjson.h` — yyjson backend
 - `csonpath_python.c` — Python backend
+- `rust/csonpath_rust_backend.h` — Rust / serde_json backend
 
 ---
 
@@ -270,6 +358,12 @@ For more details, see the existing backend implementations:
 make tests-c
 ```
 
+### Rust Tests
+```sh
+cd rust
+cargo test
+```
+
 ### Python Tests
 ```sh
 make tests-py
@@ -288,7 +382,10 @@ make tests
 |---|---|
 | `csonpath.h`, `csonpath_do.h` | Core implementation (header-only style) |
 | `csonpath_json-c.h` | json-c backend |
+| `csonpath_yyjson.h` | yyjson backend |
 | `csonpath_python.c` | Python C extension backend |
+| `rust/` | Rust backend (safe API, FFI, C glue) |
+| `csonpath_my_fuzzing.h` | Fuzzer helpers (C) |
 | `tests/` | C and Python test suites |
 | `bench/` | Performance benchmarks |
 

{csonpath-0.15.0 → csonpath-0.17.0}/csonpath.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ configure
 csonpath.h
 csonpath_do.h
 csonpath_json-c.h
+csonpath_my_fuzzing.h
 csonpath_python.c
 csonpath_yyjson.h
 pyproject.toml