headson 0.6.2__cp310-abi3-macosx_11_0_arm64.whl → 0.6.3__cp310-abi3-macosx_11_0_arm64.whl

{headson-0.6.2.dist-info → headson-0.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: headson
-Version: 0.6.2
+Version: 0.6.3
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
   <br/>
 </p>
 
-Head/tail for JSON and YAML — but structure‑aware. Get a compact preview that shows both the shape and representative values of your data, all within a strict character budget.
+`heal`/`tail` for JSON, YAML - but structure‑aware. Get a compact preview that shows both the shape and representative values of your data, all within a strict character budget. (Just like `head`/`tail`, `headson` can also work with unstructured text files.)
 
 Available as:
 - CLI (see [Usage](#usage))
@@ -41,10 +41,11 @@ From source:
 ## Features
 
 - Budgeted output: specify exactly how much you want to see
-- Output formats: `auto | json | yaml`
+- Output formats: `auto | json | yaml | text`
   - Styles: `strict | default | detailed`
     - JSON family: `strict` → strict JSON, `default` → human‑friendly Pseudo, `detailed` → JS with inline comments
     - YAML: always YAML; `strict` has no comments, `default` uses “# …”, `detailed` uses “# N more …”
+    - Text: prints raw lines. In `default` style, omissions are shown as a single line `…`; in `detailed`, as `… N more lines …`. `strict` omits array‑level summaries.
 - Multiple inputs: preview many files at once with a shared or per‑file budget
 - Fast: processes gigabyte‑scale files in seconds (mostly disk‑bound)
 - Available as a CLI app and as a Python library
@@ -68,12 +69,12 @@ Common flags:
 
 - `-n, --budget <BYTES>`: per‑file output budget. For multiple inputs, default total budget is `<BYTES> * number_of_inputs`.
 - `-N, --global-budget <BYTES>`: total output budget across all inputs. With `--budget`, the effective total is the smaller of the two.
-- `-f, --format <auto|json|yaml>`: output format (default: `auto`).
-  - Auto: stdin → JSON family; filesets → per‑file based on extension (`.json` → JSON family, `.yaml`/`.yml` → YAML).
+- `-f, --format <auto|json|yaml|text>`: output format (default: `auto`).
+  - Auto: stdin → JSON family; filesets → per‑file based on extension (`.json` → JSON family, `.yaml`/`.yml` → YAML, unknown → Text).
 - `-t, --template <strict|default|detailed>`: output style (default: `default`).
   - JSON family: `strict` → strict JSON; `default` → Pseudo; `detailed` → JS with inline comments.
   - YAML: always YAML; style only affects comments (`strict` none, `default` “# …”, `detailed` “# N more …”).
-- `-i, --input-format <json|yaml>`: ingestion format (default: `json`). For filesets in `auto` format, ingestion is chosen by extensions.
+- `-i, --input-format <json|yaml|text>`: ingestion format (default: `json`). For filesets in `auto` format, ingestion is chosen by extensions.
 - `-m, --compact`: no indentation, no spaces, no newlines
 - `--no-newline`: single line output
 - `--no-space`: no space after `:` in objects
@@ -86,7 +87,8 @@ Notes:
 
 - Multiple inputs:
   - With newlines enabled, file sections are rendered with human‑readable headers. In compact/single‑line modes, headers are omitted.
-  - In `--format auto`, each file uses its own best format: JSON family for `.json`, YAML for `.yaml`/`.yml`.
+- In `--format auto`, each file uses its own best format: JSON family for `.json`, YAML for `.yaml`/`.yml`.
+  - Unknown extensions are treated as Text (raw lines) — safe for logs and `.txt` files.
   - `--global-budget` may truncate or omit entire files to respect the total budget.
   - The tool finds the largest preview that fits the budget; even if extremely tight, you still get a minimal, valid preview.
   - Directories and binary files are ignored; a notice is printed to stderr for each. Stdin reads the stream as‑is.
@@ -110,6 +112,25 @@ Quick one‑liners:
 
       headson -n 400 -f yaml -t detailed config.yaml
 
+### Text mode
+
+- Single file (auto):
+
+      headson -n 200 notes.txt
+
+- Force Text ingest/output (useful when mixing with other extensions):
+
+      headson -n 200 -i text -f text notes.txt
+
+- Many text files (fileset):
+
+      headson -n 800 -i text -f text logs/*.txt
+
+- Styles on Text:
+  - default: omission as a standalone `…` line.
+  - detailed: omission as `… N more lines …`.
+  - strict: no array‑level omission line (individual long lines may still truncate with `…`).
+
 Show help:
 
     headson --help
@@ -157,6 +178,7 @@ Regenerate locally:
 - Run: cargo make tapes
 - Outputs are written to docs/assets/tapes
 
+
 ## Python Bindings
 
 A thin Python extension module is available on PyPI as `headson`.

headson-0.6.3.dist-info/RECORD

@@ -0,0 +1,5 @@
+headson-0.6.3.dist-info/METADATA,sha256=-XUXLS7kujupBt2kqNLMoKyx6GJmbq0E415Nh_Qs7xk,10500
+headson-0.6.3.dist-info/WHEEL,sha256=-lwEpi49KOTCcgx48T3fLSP8Dxynwa-iRMZNo-JZaqc,103
+headson/__init__.py,sha256=Z-vwzLN9ptomZrtRqVUuUKSAaidOSVcjFI6Ojbuj-dU,219
+headson/headson.abi3.so,sha256=-BlSgXzSGKMPZcFekoLb4pfuIhPfs27yfCIcZ-2c4_8,853440
+headson-0.6.3.dist-info/RECORD,,

headson-0.6.2.dist-info/RECORD

@@ -1,5 +0,0 @@
-headson-0.6.2.dist-info/METADATA,sha256=IaXCHGSe2P5J8sYRrtH2nxeVEmHaJhL8UcVE-U_5CmU,9633
-headson-0.6.2.dist-info/WHEEL,sha256=-lwEpi49KOTCcgx48T3fLSP8Dxynwa-iRMZNo-JZaqc,103
-headson/__init__.py,sha256=Z-vwzLN9ptomZrtRqVUuUKSAaidOSVcjFI6Ojbuj-dU,219
-headson/headson.abi3.so,sha256=IMrU0pZRokn-BkhGgaZtnsMjfUZSIv6Dw5Kp5kVQxkk,853424
-headson-0.6.2.dist-info/RECORD,,