dotdiff 0.1.0__py3-none-macosx_11_0_arm64.whl

dotdiff-0.1.0.dist-info/METADATA

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: dotdiff
+Version: 0.1.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Utilities
+License-File: LICENSE
+Summary: Semantic diff for JSON, YAML, TOML, and NDJSON: a structured, agent-friendly change-list instead of line noise.
+Home-Page: https://github.com/rvben/dotdiff
+Author: Ruben J. Jongejan <ruben.jongejan@gmail.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/rvben/dotdiff
+Project-URL: Repository, https://github.com/rvben/dotdiff
+
+# dotdiff
+
+[![CI](https://github.com/rvben/dotdiff/actions/workflows/ci.yml/badge.svg)](https://github.com/rvben/dotdiff/actions/workflows/ci.yml)
+[![crates.io](https://img.shields.io/crates/v/dotdiff.svg)](https://crates.io/crates/dotdiff)
+[![clispec](https://img.shields.io/badge/clispec-v0.2-blue)](https://clispec.dev)
+
+Semantic diff for JSON, YAML, TOML, and NDJSON. Compares two documents
+*structurally* (not line by line) and prints a path-addressed change list
+instead of textual noise. The sibling of [`dotpick`](https://github.com/rvben/dotpick):
+dotpick extracts fields, dotdiff tells you what changed.
+
+## Install
+
+```sh
+cargo install dotdiff
+```
+
+## Usage
+
+```sh
+dotdiff old.json new.json          # text on a TTY, JSON when piped
+dotdiff config.yaml config.json    # cross-format works
+cat new.json | dotdiff old.json -  # `-` reads stdin
+```
+
+```text
+$ dotdiff old.json new.yaml
+~ user.plan       "free" -> "pro"
+- user.trialEnds  "2026-07-01"
++ user.seats      5
+~ items[0].qty    1 -> 3
+```
+
+Output is the `~`/`+`/`-` change list on a TTY, and structured JSON when piped:
+
+```sh
+$ dotdiff old.json new.json | jq .
+{"identical": false, "changes": [
+  {"op": "changed", "path": "user.plan", "old": "free", "new": "pro"}
+]}
+```
+
+Paths use [dotpick](https://github.com/rvben/dotpick)'s dotpath vocabulary
+(`user.plan`, `items[2].qty`, `["quoted key"]`), so you can feed a changed path
+straight back into `dotpick` to inspect it.
+
+### Matching list items by key
+
+By default arrays compare by position, so reordering a list reports everything
+after the move as changed. Pass `--array-key <field>` to match objects in a list
+by an identity field instead - order-independent, and far less noise:
+
+```sh
+# Without: a reordered list looks like 4 changes.
+# With --array-key id: just the one real change.
+$ dotdiff old.json new.json --array-key id
+~ items[id=1].qty  1 -> 3
+```
+
+### Formats
+
+JSON, YAML, TOML, and NDJSON are detected per file (by extension, then content);
+force both sides with `--format`. NDJSON is compared as an array of records, so
+`--array-key` matches records across two streams. Everything is loaded into one
+model, which is why cross-format diffing works.
+
+## Exit codes
+
+| code | meaning |
+| --- | --- |
+| `0` | identical |
+| `1` | differences found (the report is on stdout - not an error) |
+| `2` | an input could not be read or parsed |
+| `3` | usage error |
+
+Exit `1` is a *data state*, not a failure (the `diff`/`grep` convention), so
+dotdiff is scriptable as a gate: `dotdiff a.json b.json && echo unchanged`.
+
+## For agents (clispec)
+
+dotdiff follows [The CLI Spec](https://clispec.dev): structured output on
+stdout, structured error envelopes on the last line of stderr, a `schema`
+subcommand whose output validates against `clispec.dev/schema/v0.2.json`
+(checked by the test suite), and the exit-1-on-differences contract declared as
+an `outcome`. It is read-only (`mutating: false`).
+
+```sh
+dotdiff schema
+```
+
+## License
+
+MIT
+

dotdiff-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+dotdiff-0.1.0.data/scripts/dotdiff,sha256=_ld87HlonQ1Eb-dQSaDwUl76Vq6W4_uSqa_ETjhJJvw,1130416
+dotdiff-0.1.0.dist-info/METADATA,sha256=HrIIduE7fs_yQ-dZnKX-qs1eQZv6vlnKUBAXLesA32Y,3773
+dotdiff-0.1.0.dist-info/WHEEL,sha256=7m8kjhP_K0tQ6qXK8P1IG2YeRznSaoXUEpeK3IfZx-I,102
+dotdiff-0.1.0.dist-info/licenses/LICENSE,sha256=C-fnAxNl5_rkYD0NgIn5gEeZxx-ew8mOfqo_HJk3t4k,1101
+dotdiff-0.1.0.dist-info/sboms/dotdiff.cyclonedx.json,sha256=4NHhCJJXyy9oOperp_19C9KV1IM3Rhh6Hp6EWG4Fzh8,43668
+dotdiff-0.1.0.dist-info/RECORD,,

dotdiff-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.14.1)
+Root-Is-Purelib: false
+Tag: py3-none-macosx_11_0_arm64

dotdiff-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruben J. Jongejan <ruben.jongejan@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.