headson 0.2.3__cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

headson/__init__.py

@@ -0,0 +1,4 @@
+# Re-export the public API from the compiled extension submodule
+from .headson import summarize  # type: ignore
+
+__all__ = ["summarize"]

headson-0.2.3.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: headson
+Version: 0.2.3
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Operating System :: OS Independent
+Requires-Dist: pytest>=8 ; extra == 'test'
+Provides-Extra: test
+License-File: LICENSE
+Summary: Budget‑constrained JSON preview renderer (Python bindings)
+Keywords: json,preview,summarize,cli,bindings
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# headson
+
+Budget‑constrained JSON preview for the terminal.
+
+## Install
+
+Using Cargo:
+
+    cargo install headson
+
+From source:
+
+    cargo build --release
+    target/release/headson --help
+
+## Usage
+
+    headson [FLAGS] [INPUT...]
+
+- INPUT (optional, repeatable): file path(s). If omitted, reads JSON from stdin. Multiple input files are supported.
+- Prints the preview to stdout. On parse errors, exits non‑zero and prints an error to stderr.
+
+Common flags:
+
+- `-n, --budget <BYTES>`: per‑file output budget. When multiple input files are provided, the total budget equals `<BYTES> * number_of_inputs`.
+- `-N, --global-budget <BYTES>`: total output budget across all inputs. Useful when you want a fixed-size preview across many files (may omit entire files). Mutually exclusive with `--budget`.
+- `-f, --template <json|pseudo|js>`: output style (default: `pseudo`)
+- `-m, --compact`: no indentation, no spaces, no newlines
+- `--no-newline`: single line output
+- `--no-space`: no space after `:` in objects
+- `--indent <STR>`: indentation unit (default: two spaces)
+- `--string-cap <N>`: max graphemes to consider per string (default: 500)
+
+Notes:
+
+- With multiple input files:
+  - JSON template outputs a single JSON object keyed by the input file paths.
+  - Pseudo and JS templates render file sections with human-readable headers.
+  - Using `--global-budget` may truncate or omit entire files to respect the total budget.
+
+Examples:
+
+- Read from stdin with defaults:
+
+      cat data.json | headson
+
+- Read from file, JS style, 200‑byte budget:
+
+      headson -n 200 -f js data.json
+
+- JSON style, compact:
+
+      headson -f json -m data.json
+
+- Multiple files (JSON template produces an object keyed by paths):
+
+      headson -f json a.json b.json
+
+- Global limit across files (fixed total size across all files):
+
+      headson -N 400 -f json a.json b.json
+
+Show help:
+
+    headson --help
+
+## Python package
+
+Headson is also available as a Python extension module built with PyO3/maturin.
+
+Install from PyPI:
+
+    pip install headson
+
+Example:
+
+    import json
+    import headson
+
+    data = {"foo": [1, 2, 3], "bar": {"x": "y"}}
+    preview = headson.summarize(json.dumps(data), template="json", character_budget=200)
+    print(preview)
+

headson-0.2.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+headson-0.2.3.dist-info/METADATA,sha256=_C-vskWIbrSYy6BEZpX0_qH5FQPUHZ0fgQnTw3nNPXI,2776
+headson-0.2.3.dist-info/WHEEL,sha256=V-nRmWteMHF99cdHiqNRprMeNvFExwDHdG-6uj8yckI,129
+headson-0.2.3.dist-info/licenses/LICENSE,sha256=GZ9row3L2LsnOSbEuGMQZ0zKOIEd5tHr76cZHpg4KK8,1072
+headson/__init__.py,sha256=PnXEkHuT6aEqKi8lL11uZU2IZ5cGgFqfO43xShmpros,137
+headson/headson.cpython-311-x86_64-linux-gnu.so,sha256=oFd8woEIwn_fYZqzF3qPKu03HuE_m22CU8e__cXtDYo,669800
+headson-0.2.3.dist-info/RECORD,,

headson-0.2.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64

headson-0.2.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dániel Kántor
+
+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.