headson 0.5.2__cp310-abi3-macosx_11_0_arm64.whl → 0.5.3__cp310-abi3-macosx_11_0_arm64.whl

{headson-0.5.2.dist-info → headson-0.5.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: headson
-Version: 0.5.2
+Version: 0.5.3
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
@@ -58,8 +58,9 @@ If you’re comfortable with tools like `head` and `tail`, use `headson` when yo
 
 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`.
+- `-n, --budget <BYTES>`: per‑file output budget. When multiple input files are provided, the default 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).
+  - When used together with `--budget`, the final total budget is `min(global, per_file * number_of_inputs)`. Files are only truncated if they don't fit into this final global limit, and no single file expands beyond the per‑file budget.
 - `-f, --template <json|pseudo|js>`: output style (default: `pseudo`)
 - `-m, --compact`: no indentation, no spaces, no newlines
 - `--no-newline`: single line output
@@ -167,7 +168,7 @@ print(
 
 # Algorithm
 
-![Algorithm overview](docs/assets/algorithm.svg)
+![Algorithm overview](https://raw.githubusercontent.com/kantord/headson/main/docs/assets/algorithm.svg)
 
 ## Footnotes
  - <sup><b>[1]</b></sup> <b>Optimized tree representation</b>: An arena‑style tree stored in flat, contiguous buffers. Each node records its kind and value plus index ranges into shared child and key arrays. Arrays are ingested in a single pass and may be deterministically pre‑sampled: the first element is always kept; additional elements are selected via a fixed per‑index inclusion test; for kept elements, original indices are stored and full lengths are counted. This enables accurate omission info and internal gap markers later, while minimizing pointer chasing.

headson-0.5.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+headson-0.5.3.dist-info/METADATA,sha256=K4NeyheAWgMcRn7lk0w5ec6sVoMtO_QnkpO_UaEDuMw,8529
+headson-0.5.3.dist-info/WHEEL,sha256=-lwEpi49KOTCcgx48T3fLSP8Dxynwa-iRMZNo-JZaqc,103
+headson-0.5.3.dist-info/licenses/LICENSE,sha256=GZ9row3L2LsnOSbEuGMQZ0zKOIEd5tHr76cZHpg4KK8,1072
+headson/__init__.py,sha256=8DXFB8ahlywyQXJsscl3w_wgbcQi7sj7zEuV28wR60E,187
+headson/headson.abi3.so,sha256=ENRkGrOY31NNISdSQXMfKB88WM3kjYWiTp1nu6U05kE,604752
+headson-0.5.3.dist-info/RECORD,,

headson-0.5.2.dist-info/RECORD

@@ -1,6 +0,0 @@
-headson-0.5.2.dist-info/METADATA,sha256=lK92oHOsJnM4sbZYRpY4Fp1j7ueyG9QFZE1RH1emr2o,8262
-headson-0.5.2.dist-info/WHEEL,sha256=-lwEpi49KOTCcgx48T3fLSP8Dxynwa-iRMZNo-JZaqc,103
-headson-0.5.2.dist-info/licenses/LICENSE,sha256=GZ9row3L2LsnOSbEuGMQZ0zKOIEd5tHr76cZHpg4KK8,1072
-headson/__init__.py,sha256=8DXFB8ahlywyQXJsscl3w_wgbcQi7sj7zEuV28wR60E,187
-headson/headson.abi3.so,sha256=oghWxiBoIzGY-WMbDSe8v5bqXGZCf6hx5v47mEN_5x0,604752
-headson-0.5.2.dist-info/RECORD,,