headson 0.5.3__tar.gz → 0.6.0__tar.gz

{headson-0.5.3 → headson-0.6.0}/Cargo.lock

@@ -266,7 +266,7 @@ dependencies = [
 
 [[package]]
 name = "headson"
-version = "0.5.3"
+version = "0.6.0"
 dependencies = [
  "anyhow",
  "assert_cmd",

{headson-0.5.3 → headson-0.6.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "headson"
-version = "0.5.3"
+version = "0.6.0"
 edition = "2024"
 description = "Budget‑constrained JSON preview renderer"
 readme = "README.md"

{headson-0.5.3 → headson-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: headson
-Version: 0.5.3
+Version: 0.6.0
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
@@ -13,7 +13,13 @@ Keywords: json,preview,summarize,cli,bindings
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 
-# headson
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/logo.svg" alt="headson" width="600" height="99" />
+</h1>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/tapes/demo.gif" alt="Terminal demo" width="1560" height="900" />
+  <br/>
+</p>
 
 Head/tail for JSON — but structure‑aware. Get a compact preview that shows both the shape and representative values of your data, all within a strict character budget.
 
@@ -134,6 +140,14 @@ headson -n 120 -f json users.json
 # {"users":[{"id":1,"name":"Ana","roles":["admin"]}],"meta":{"count":2}}
 ```
 
+## Terminal Demos
+
+Regenerate locally:
+
+- Place tapes under docs/tapes (e.g., docs/tapes/demo.tape)
+- 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.5.3 → headson-0.6.0}/README.md

@@ -1,4 +1,10 @@
-# headson
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/logo.svg" alt="headson" width="600" height="99" />
+</h1>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kantord/headson/main/docs/assets/tapes/demo.gif" alt="Terminal demo" width="1560" height="900" />
+  <br/>
+</p>
 
 Head/tail for JSON — but structure‑aware. Get a compact preview that shows both the shape and representative values of your data, all within a strict character budget.
 
@@ -119,6 +125,14 @@ headson -n 120 -f json users.json
 # {"users":[{"id":1,"name":"Ana","roles":["admin"]}],"meta":{"count":2}}
 ```
 
+## Terminal Demos
+
+Regenerate locally:
+
+- Place tapes under docs/tapes (e.g., docs/tapes/demo.tape)
+- 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.0/docs/assets/logo.svg

@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="18.529102mm"
+   height="3.043225mm"
+   viewBox="0 0 18.529102 3.043225"
+   version="1.1"
+   id="svg1"
+   inkscape:version="1.4.2 (ebf0e940d0, 2025-05-08)"
+   sodipodi:docname="logo.svg"
+   inkscape:export-filename="logo.png"
+   inkscape:export-xdpi="500"
+   inkscape:export-ydpi="500"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="mm"
+     inkscape:zoom="27.623569"
+     inkscape:cx="27.856647"
+     inkscape:cy="5.8645572"
+     inkscape:window-width="3840"
+     inkscape:window-height="2124"
+     inkscape:window-x="1080"
+     inkscape:window-y="748"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="layer1" />
+  <defs id="defs1">
+    <style type="text/css"><![CDATA[
+      .wordmark { fill: #000000; }
+      @media (prefers-color-scheme: dark) {
+        .wordmark { fill: #ffffff; }
+      }
+    ]]></style>
+  </defs>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-62.9858,-133.27801)">
+    <g
+       id="text1"
+       class="wordmark"
+       style="font-size:3.175px;stroke-width:0.244"
+       aria-label="head{…}son">
+      <path
+         style="font-family:'Roboto Mono';-inkscape-font-specification:'Roboto Mono'"
+         d="m 63.272604,134.32601 v -0.95343 H 62.9858 v 2.38125 h 0.286804 v -1.21853 q 0.03101,-0.0496 0.06976,-0.0899 0.04031,-0.0419 0.08682,-0.0729 0.05891,-0.0403 0.128674,-0.062 0.06976,-0.0217 0.147278,-0.0217 0.09457,-0.002 0.167432,0.0264 0.07286,0.0264 0.120923,0.0806 0.04496,0.0496 0.06821,0.12558 0.02326,0.0744 0.02326,0.17363 v 1.05885 h 0.286804 v -1.05575 q 0,-0.16898 -0.04186,-0.29145 -0.04031,-0.12403 -0.116272,-0.20464 -0.07596,-0.0806 -0.184485,-0.11783 -0.10697,-0.0387 -0.238745,-0.0387 -0.100769,0.002 -0.190686,0.0294 -0.08837,0.0279 -0.162781,0.0822 -0.04651,0.0326 -0.08837,0.076 -0.04186,0.0419 -0.07596,0.093 z m 2.359546,1.45883 q 0.244947,0 0.410828,-0.0977 0.167431,-0.0992 0.251147,-0.22635 l -0.175183,-0.13642 q -0.07906,0.10232 -0.198437,0.16433 -0.119373,0.062 -0.272852,0.062 -0.116272,0 -0.21239,-0.0434 -0.09612,-0.0434 -0.164331,-0.11937 -0.06666,-0.0713 -0.10542,-0.16433 -0.03721,-0.093 -0.04806,-0.21549 v -0.0109 h 1.198376 v -0.12868 q 0,-0.17518 -0.04496,-0.32556 -0.04341,-0.15038 -0.133325,-0.262 -0.08992,-0.11007 -0.226343,-0.17208 -0.134876,-0.0636 -0.31626,-0.0636 -0.144177,0 -0.282153,0.0589 -0.136426,0.0589 -0.243396,0.16898 -0.108521,0.11162 -0.173633,0.27285 -0.06511,0.15968 -0.06511,0.36277 v 0.0651 q 0,0.17519 0.05891,0.32401 0.05891,0.14883 0.164331,0.25735 0.10542,0.10852 0.252698,0.16898 0.148828,0.0605 0.325561,0.0605 z m -0.03721,-1.50379 q 0.110071,0 0.189136,0.0403 0.08061,0.0403 0.133325,0.10542 0.05271,0.0651 0.08217,0.15503 0.02945,0.0884 0.02945,0.16588 v 0.0139 h -0.90227 q 0.01705,-0.11627 0.05891,-0.20464 0.04341,-0.0899 0.10542,-0.15192 0.06201,-0.0605 0.139526,-0.0915 0.07752,-0.0326 0.164331,-0.0326 z m 2.303736,1.47278 h 0.299206 v -0.0248 q -0.02791,-0.0698 -0.04341,-0.16279 -0.0155,-0.0946 -0.0155,-0.17828 v -0.7798 q 0,-0.14107 -0.05116,-0.24649 -0.05116,-0.10542 -0.139526,-0.17674 -0.08992,-0.0698 -0.21239,-0.10387 -0.122473,-0.0357 -0.2651,-0.0357 -0.15658,0 -0.280603,0.0434 -0.122473,0.0434 -0.20774,0.11317 -0.08682,0.0713 -0.133325,0.15968 -0.04496,0.0884 -0.04651,0.17983 h 0.288355 q 0,-0.0527 0.02481,-0.10077 0.02635,-0.0496 0.07286,-0.0853 0.04651,-0.0357 0.113172,-0.0574 0.06821,-0.0217 0.153479,-0.0217 0.09147,0 0.164331,0.0233 0.07441,0.0233 0.125574,0.0651 0.05116,0.0434 0.07906,0.10387 0.02791,0.0605 0.02791,0.13642 v 0.13178 h -0.313159 q -0.175184,0 -0.31781,0.0341 -0.141077,0.0341 -0.241846,0.10232 -0.100769,0.0698 -0.15658,0.17364 -0.05426,0.10387 -0.05426,0.24184 0,0.10542 0.04031,0.19689 0.04186,0.0899 0.117822,0.15503 0.07441,0.0667 0.181384,0.10542 0.108521,0.0388 0.241846,0.0388 0.08217,0 0.155029,-0.0171 0.07286,-0.017 0.137976,-0.0465 0.06356,-0.0294 0.116272,-0.0682 0.05426,-0.0388 0.09767,-0.0822 0.0046,0.0527 0.01395,0.10231 0.01085,0.0481 0.02791,0.0806 z m -0.506946,-0.21859 q -0.08372,0 -0.147278,-0.0217 -0.06356,-0.0217 -0.10542,-0.0605 -0.04186,-0.0372 -0.06356,-0.0899 -0.02015,-0.0527 -0.02015,-0.11473 0,-0.0651 0.02326,-0.11627 0.0248,-0.0512 0.07131,-0.0884 0.06511,-0.0527 0.175183,-0.0775 0.111621,-0.0264 0.260449,-0.0264 h 0.266651 v 0.33951 q -0.02481,0.0496 -0.06821,0.0961 -0.04341,0.045 -0.102319,0.0806 -0.06046,0.0357 -0.133326,0.0574 -0.07286,0.0217 -0.156579,0.0217 z m 1.255737,-0.63407 v 0.0325 q 0,0.17984 0.04806,0.33642 0.04806,0.15503 0.134875,0.26975 0.08682,0.11472 0.20929,0.17983 0.124023,0.0651 0.275952,0.0651 0.155029,0 0.271301,-0.0527 0.116272,-0.0527 0.199988,-0.15503 l 0.0124,0.17673 h 0.263549 v -2.38125 h -0.286804 v 0.86971 q -0.08217,-0.0961 -0.195337,-0.14572 -0.111621,-0.0512 -0.261999,-0.0512 -0.153479,0 -0.277503,0.0636 -0.124023,0.0636 -0.21084,0.17673 -0.08837,0.11317 -0.136425,0.2713 -0.04651,0.15658 -0.04651,0.34417 z m 0.286804,0.0325 v -0.0325 q 0,-0.12247 0.02635,-0.23255 0.02636,-0.11162 0.08217,-0.19688 0.05426,-0.0837 0.139526,-0.13333 0.08682,-0.0496 0.207739,-0.0496 0.141077,0 0.235645,0.0667 0.09457,0.0651 0.150378,0.16743 v 0.77824 q -0.05581,0.11008 -0.150378,0.17519 -0.09457,0.0651 -0.238745,0.0651 -0.119373,0 -0.204639,-0.0481 -0.08527,-0.0496 -0.139526,-0.13332 -0.05581,-0.0837 -0.08217,-0.19379 -0.02635,-0.11007 -0.02635,-0.23255 z m 2.919202,1.38752 0.03256,-0.17829 q -0.09612,-0.003 -0.15968,-0.0527 -0.06201,-0.0496 -0.09922,-0.12712 -0.03876,-0.076 -0.05426,-0.17208 -0.0155,-0.0946 -0.0155,-0.19069 v -0.262 q -0.0016,-0.18448 -0.08682,-0.32401 -0.08527,-0.14108 -0.2651,-0.21239 0.179834,-0.0729 0.2651,-0.21239 0.08682,-0.14108 0.08682,-0.32711 v -0.26355 q 0,-0.0946 0.0093,-0.19069 0.0093,-0.0961 0.04341,-0.17363 0.03256,-0.076 0.09767,-0.12557 0.06666,-0.0496 0.178284,-0.0527 l -0.03256,-0.17829 q -0.15658,0.005 -0.266651,0.0682 -0.11007,0.062 -0.178283,0.16123 -0.07286,0.10387 -0.10697,0.23564 -0.03256,0.13022 -0.03256,0.2558 v 0.26355 q 0,0.22479 -0.10697,0.32556 -0.10542,0.0992 -0.324011,0.0992 v 0.22479 q 0.218591,0.002 0.324011,0.10232 0.10697,0.10077 0.10697,0.32401 v 0.262 q 0,0.12402 0.03566,0.2496 0.03566,0.12712 0.10542,0.22944 0.07286,0.10697 0.182935,0.17208 0.11007,0.0651 0.260449,0.0698 z"
+         id="path3" />
+      <path
+         style="font-family:'Roboto Mono';-inkscape-font-specification:'Roboto Mono';fill:#ff0000"
+         d="m 72.653427,135.56779 q 0,0.0899 0.05581,0.15348 0.05736,0.062 0.168982,0.062 0.11007,0 0.168982,-0.062 0.05891,-0.062 0.05891,-0.15348 0,-0.093 -0.05891,-0.15657 -0.05736,-0.0651 -0.168982,-0.0651 -0.113172,0 -0.168982,0.0651 -0.05581,0.0651 -0.05581,0.15657 z m 0.599963,0 q 0,0.0899 0.05581,0.15348 0.05736,0.062 0.168982,0.062 0.110071,0 0.168982,-0.062 0.05891,-0.062 0.05891,-0.15348 0,-0.093 -0.05891,-0.15657 -0.05736,-0.0651 -0.168982,-0.0651 -0.113171,0 -0.168982,0.0651 -0.05581,0.0651 -0.05581,0.15657 z m 0.57981,0 q 0,0.0899 0.05581,0.15348 0.05736,0.062 0.168982,0.062 0.11007,0 0.168981,-0.062 0.05891,-0.062 0.05891,-0.15348 0,-0.093 -0.05891,-0.15657 -0.05736,-0.0651 -0.168981,-0.0651 -0.113172,0 -0.168982,0.0651 -0.05581,0.0651 -0.05581,0.15657 z"
+         id="path4" />
+      <path
+         style="font-family:'Roboto Mono';-inkscape-font-specification:'Roboto Mono'"
+         d="m 74.648654,136.14295 0.03256,0.17829 q 0.151929,-0.003 0.261999,-0.0698 0.110071,-0.0667 0.182935,-0.17053 0.07131,-0.10387 0.10542,-0.23099 0.03411,-0.12558 0.03411,-0.2496 v -0.262 q 0,-0.10852 0.02481,-0.18758 0.02481,-0.0791 0.07596,-0.13178 0.05271,-0.0543 0.134876,-0.0791 0.08372,-0.0264 0.195337,-0.0279 v -0.22479 q -0.127124,0 -0.218591,-0.0326 -0.08992,-0.0341 -0.141077,-0.10697 -0.03566,-0.0512 -0.05426,-0.12092 -0.01705,-0.0713 -0.01705,-0.16433 v -0.26355 q 0,-0.13023 -0.03566,-0.26355 -0.03411,-0.13333 -0.113172,-0.2403 -0.06976,-0.0946 -0.178283,-0.15348 -0.106971,-0.0589 -0.257349,-0.0636 l -0.03101,0.17829 q 0.111621,0.003 0.176733,0.0527 0.06511,0.0496 0.09922,0.12557 0.03256,0.0775 0.04186,0.17363 0.01085,0.0961 0.01085,0.19069 v 0.26355 q 0,0.12092 0.03566,0.22479 0.03566,0.10232 0.110071,0.17983 0.03876,0.0419 0.08992,0.076 0.05271,0.0341 0.114721,0.0589 -0.06046,0.0248 -0.111621,0.0574 -0.04961,0.0326 -0.08992,0.0729 -0.07596,0.076 -0.113171,0.17984 -0.03566,0.10387 -0.03566,0.22634 v 0.262 q 0,0.0961 -0.01705,0.19069 -0.0155,0.0961 -0.05271,0.17208 -0.03876,0.0775 -0.102319,0.12712 -0.06356,0.0496 -0.15813,0.0527 z m 2.788977,-0.83405 q 0,0.0403 -0.0155,0.076 -0.0155,0.0357 -0.04496,0.0651 -0.04806,0.0481 -0.133325,0.076 -0.08527,0.0264 -0.199988,0.0264 -0.07286,0 -0.147278,-0.0155 -0.07441,-0.0155 -0.134875,-0.0527 -0.06201,-0.0372 -0.10387,-0.0977 -0.04031,-0.0605 -0.04651,-0.14883 h -0.286804 q 0,0.10697 0.04806,0.20619 0.04961,0.0992 0.142627,0.17363 0.09147,0.076 0.224793,0.12248 0.133325,0.045 0.303857,0.045 0.148828,0 0.274402,-0.0357 0.125574,-0.0357 0.215491,-0.10077 0.08992,-0.0651 0.139526,-0.15658 0.05116,-0.0915 0.05116,-0.20309 0,-0.10387 -0.04496,-0.18293 -0.04341,-0.0791 -0.127124,-0.13953 -0.08372,-0.0589 -0.206189,-0.10077 -0.122473,-0.0434 -0.277502,-0.076 -0.117823,-0.0233 -0.195337,-0.0481 -0.07596,-0.0248 -0.120923,-0.0558 -0.04651,-0.031 -0.06511,-0.0698 -0.0186,-0.0388 -0.0186,-0.0884 0,-0.0481 0.02325,-0.093 0.02325,-0.045 0.06976,-0.0791 0.04496,-0.0341 0.113171,-0.0543 0.06976,-0.0202 0.161231,-0.0202 0.08837,0 0.158129,0.0248 0.07131,0.0248 0.120923,0.0651 0.04961,0.0403 0.07752,0.093 0.02791,0.0512 0.02791,0.10542 h 0.286804 q 0,-0.11007 -0.04806,-0.20464 -0.04651,-0.0961 -0.133325,-0.16743 -0.08682,-0.0713 -0.21084,-0.11163 -0.124023,-0.0403 -0.279052,-0.0403 -0.144178,0 -0.265101,0.0387 -0.119372,0.0388 -0.206189,0.10542 -0.08682,0.0667 -0.134875,0.15658 -0.04806,0.0884 -0.04806,0.19069 0,0.10387 0.04651,0.18293 0.04651,0.0775 0.131775,0.13488 0.08371,0.0589 0.201538,0.10077 0.119372,0.0419 0.263549,0.0713 0.117823,0.0233 0.196888,0.0527 0.07906,0.0279 0.127124,0.062 0.04806,0.0341 0.06821,0.076 0.02015,0.0403 0.02015,0.0915 z m 0.710034,-0.40928 v 0.0341 q 0,0.18139 0.05271,0.33642 0.05271,0.15503 0.151929,0.26975 0.09767,0.11472 0.238745,0.17983 0.142627,0.0651 0.320911,0.0651 0.176733,0 0.31781,-0.0651 0.141076,-0.0651 0.240295,-0.17983 0.09767,-0.11472 0.150379,-0.26975 0.05271,-0.15503 0.05271,-0.33642 v -0.0341 q 0,-0.18139 -0.05271,-0.33642 -0.05271,-0.15657 -0.150379,-0.2713 -0.09922,-0.11472 -0.241846,-0.17983 -0.141076,-0.0667 -0.31936,-0.0667 -0.176733,0 -0.31781,0.0667 -0.141077,0.0651 -0.238745,0.17983 -0.09922,0.11473 -0.151929,0.2713 -0.05271,0.15503 -0.05271,0.33642 z m 0.286804,0.0341 v -0.0341 q 0,-0.12247 0.02946,-0.2341 0.02946,-0.11317 0.08992,-0.19843 0.05891,-0.0853 0.147278,-0.13488 0.08837,-0.0512 0.207739,-0.0512 0.119373,0 0.207739,0.0512 0.08992,0.0496 0.150379,0.13488 0.05891,0.0853 0.08837,0.19843 0.03101,0.11163 0.03101,0.2341 v 0.0341 q 0,0.12403 -0.02945,0.2372 -0.02946,0.11162 -0.08837,0.19689 -0.06046,0.0853 -0.150378,0.13487 -0.08837,0.0496 -0.206189,0.0496 -0.119373,0 -0.20929,-0.0496 -0.08992,-0.0496 -0.148828,-0.13487 -0.06046,-0.0853 -0.08992,-0.19689 -0.02946,-0.11317 -0.02946,-0.2372 z m 1.699122,0.82011 h 0.286804 v -1.20303 q 0.02946,-0.0543 0.06821,-0.0992 0.04031,-0.045 0.08682,-0.0791 0.05736,-0.0388 0.125573,-0.0605 0.06821,-0.0233 0.147278,-0.0233 0.09147,0 0.161231,0.0217 0.07131,0.0217 0.120922,0.0698 0.04806,0.0481 0.07286,0.12557 0.02481,0.0775 0.02481,0.18914 v 1.05885 h 0.286804 v -1.06505 q 0,-0.16743 -0.04186,-0.28836 -0.04031,-0.12247 -0.116272,-0.20153 -0.07596,-0.0791 -0.184485,-0.11628 -0.10697,-0.0372 -0.238745,-0.0372 -0.09767,0.002 -0.186035,0.0294 -0.08682,0.0264 -0.16123,0.076 -0.04961,0.0325 -0.09457,0.0775 -0.04341,0.0434 -0.08061,0.0961 l -0.02015,-0.24805 h -0.257349 z"
+         id="path5" />
+    </g>
+  </g>
+</svg>

{headson-0.5.3 → headson-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "headson"
-version = "0.5.3"
+version = "0.6.0"
 description = "Budget‑constrained JSON preview renderer (Python bindings)"
 readme = "README.md"
 requires-python = ">=3.10"

{headson-0.5.3 → headson-0.6.0}/python/Cargo.lock

@@ -169,7 +169,7 @@ dependencies = [
 
 [[package]]
 name = "headson"
-version = "0.5.3"
+version = "0.6.0"
 dependencies = [
  "anyhow",
  "clap",
@@ -182,7 +182,7 @@ dependencies = [
 
 [[package]]
 name = "headson-python"
-version = "0.5.3"
+version = "0.6.0"
 dependencies = [
  "anyhow",
  "headson",

{headson-0.5.3 → headson-0.6.0}/python/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "headson-python"
-version = "0.5.3"
+version = "0.6.0"
 edition = "2021"
 publish = false
 readme = "README.md"

{headson-0.5.3 → headson-0.6.0}/python/src/lib.rs

@@ -2,7 +2,7 @@ use anyhow::{bail, Result};
 use pyo3::exceptions::PyRuntimeError;
 use pyo3::prelude::*;
 use pyo3::types::PyModule;
-use headson_core::{ArraySamplerStrategy, OutputTemplate, PriorityConfig, RenderConfig};
+use headson_core::{ArraySamplerStrategy, ColorMode, OutputTemplate, PriorityConfig, RenderConfig};
 
 fn to_template(s: &str) -> Result<OutputTemplate> {
     match s.to_ascii_lowercase().as_str() {
@@ -22,7 +22,7 @@ fn render_config_with_sampler(
     let newline = "\n".to_string();
     let indent_unit = "  ".to_string();
     let prefer_tail_arrays = matches!(sampler, ArraySamplerStrategy::Tail);
-    Ok(RenderConfig { template: t, indent_unit, space, newline, prefer_tail_arrays })
+    Ok(RenderConfig { template: t, indent_unit, space, newline, prefer_tail_arrays, color_mode: ColorMode::Auto, color_enabled: false })
 }
 
 fn parse_skew(skew: &str) -> Result<ArraySamplerStrategy> {

{headson-0.5.3 → headson-0.6.0}/src/json_ingest/samplers/default.rs

@@ -21,7 +21,6 @@ struct SampleAccumulator<'a> {
     indices: &'a mut Vec<usize>,
 }
 
-#[inline]
 fn mix64(mut x: u64) -> u64 {
     x ^= x >> 30;
     x = x.wrapping_mul(0xbf58_476d_1ce4_e5b9);
@@ -30,7 +29,6 @@ fn mix64(mut x: u64) -> u64 {
     x ^ (x >> 31)
 }
 
-#[inline]
 fn accept_index(i: u64) -> bool {
     let h = mix64(i ^ RANDOM_ACCEPT_SEED);
     ((h >> 32) as u32) < RANDOM_ACCEPT_THRESHOLD

{headson-0.5.3 → headson-0.6.0}/src/lib.rs

@@ -25,7 +25,8 @@ pub use order::{
     NodeId, NodeKind, PriorityConfig, PriorityOrder, RankedNode, build_order,
 };
 
-pub use serialization::types::{OutputTemplate, RenderConfig};
+pub use serialization::color::resolve_color_enabled;
+pub use serialization::types::{ColorMode, OutputTemplate, RenderConfig};
 
 pub fn headson(
     input: Vec<u8>,
@@ -76,7 +77,11 @@ fn find_largest_render_under_budget(
     let mut inclusion_flags: Vec<u32> = vec![0; total];
     // Each render attempt bumps this non-zero identifier to create a fresh inclusion set.
     let mut render_set_id: u32 = 1;
-    let mut best_str: Option<String> = None;
+    // Measure length without color so ANSI escapes do not count toward the
+    // character budget. Then render once more with the requested color setting.
+    let mut best_k: Option<usize> = None;
+    let mut measure_cfg = config.clone();
+    measure_cfg.color_enabled = false;
 
     let _ = crate::utils::search::binary_search_max(lo, hi, |mid| {
         let s = crate::serialization::render_top_k(
@@ -84,19 +89,26 @@ fn find_largest_render_under_budget(
             mid,
             &mut inclusion_flags,
             render_set_id,
-            config,
+            &measure_cfg,
         );
         render_set_id = render_set_id.wrapping_add(1).max(1);
         if s.len() <= char_budget {
-            best_str = Some(s);
+            best_k = Some(mid);
             true
         } else {
             false
         }
     });
 
-    if let Some(s) = best_str {
-        s
+    if let Some(k) = best_k {
+        // Final render with original color settings
+        crate::serialization::render_top_k(
+            order_build,
+            k,
+            &mut inclusion_flags,
+            render_set_id,
+            config,
+        )
     } else {
         // Fallback: always render a single node (k=1) to produce the
         // shortest possible preview, even if it exceeds the byte budget.

{headson-0.5.3 → headson-0.6.0}/src/main.rs

@@ -1,9 +1,10 @@
 use std::fs::File;
+use std::io::IsTerminal as _;
 use std::io::{self, Read};
 use std::path::{Path, PathBuf};
 
 use anyhow::{Context, Result};
-use clap::{Parser, ValueEnum};
+use clap::{ArgAction, Parser, ValueEnum};
 use content_inspector::{ContentType, inspect};
 
 type InputEntry = (String, Vec<u8>);
@@ -65,6 +66,20 @@ struct Cli {
         help = "Prefer the beginning of arrays when truncating (keep first N)."
     )]
     head: bool,
+    #[arg(
+        long = "color",
+        action = ArgAction::SetTrue,
+        conflicts_with = "no_color",
+        help = "Force enable ANSI colors in output"
+    )]
+    color: bool,
+    #[arg(
+        long = "no-color",
+        action = ArgAction::SetTrue,
+        conflicts_with = "color",
+        help = "Disable ANSI colors in output"
+    )]
+    no_color: bool,
     #[arg(
         value_name = "INPUT",
         value_hint = clap::ValueHint::FilePath,
@@ -85,6 +100,9 @@ fn main() -> Result<()> {
     let cli = Cli::parse();
 
     let render_cfg = get_render_config_from(&cli);
+    // Resolve color auto-detection now (stdout is the surface for user output).
+    let _color_enabled =
+        render_cfg.color_mode.effective(io::stdout().is_terminal());
     let (output, ignore_notices) = if cli.inputs.is_empty() {
         (run_from_stdin(&cli, &render_cfg)?, Vec::new())
     } else {
@@ -222,11 +240,24 @@ fn ingest_paths(paths: &[PathBuf]) -> Result<(InputEntries, IgnoreNotices)> {
 }
 
 fn get_render_config_from(cli: &Cli) -> headson::RenderConfig {
-    let template = match cli.template {
-        Template::Json => headson::OutputTemplate::Json,
-        Template::Pseudo => headson::OutputTemplate::Pseudo,
-        Template::Js => headson::OutputTemplate::Js,
-    };
+    fn to_output_template(t: Template) -> headson::OutputTemplate {
+        match t {
+            Template::Json => headson::OutputTemplate::Json,
+            Template::Pseudo => headson::OutputTemplate::Pseudo,
+            Template::Js => headson::OutputTemplate::Js,
+        }
+    }
+    fn color_mode_from_flags(cli: &Cli) -> headson::ColorMode {
+        if cli.color {
+            headson::ColorMode::On
+        } else if cli.no_color {
+            headson::ColorMode::Off
+        } else {
+            headson::ColorMode::Auto
+        }
+    }
+
+    let template = to_output_template(cli.template);
     let space = if cli.compact || cli.no_space { "" } else { " " }.to_string();
     let newline = if cli.compact || cli.no_newline {
         ""
@@ -239,6 +270,8 @@ fn get_render_config_from(cli: &Cli) -> headson::RenderConfig {
     } else {
         cli.indent.clone()
     };
+    let color_mode = color_mode_from_flags(cli);
+    let color_enabled = headson::resolve_color_enabled(color_mode);
 
     headson::RenderConfig {
         template,
@@ -246,6 +279,8 @@ fn get_render_config_from(cli: &Cli) -> headson::RenderConfig {
         space,
         newline,
         prefer_tail_arrays: cli.tail,
+        color_mode,
+        color_enabled,
     }
 }
 

headson-0.6.0/src/serialization/color.rs

@@ -0,0 +1,113 @@
+use std::io::IsTerminal as _;
+
+use crate::serialization::types::ColorMode;
+
+// ANSI SGR fragments
+const RESET: &str = "\u{001b}[0m";
+const BOLD_BLUE: &str = "\u{001b}[1;34m";
+const GREEN: &str = "\u{001b}[32m";
+const CYAN: &str = "\u{001b}[36m";
+const BRIGHT_GRAY: &str = "\u{001b}[37m";
+const DARK_GRAY: &str = "\u{001b}[90m";
+
+#[derive(Copy, Clone, Debug, Eq, PartialEq)]
+pub enum ColorRole {
+    Key,
+    String,
+    Number,
+    Bool,
+    Null,
+}
+
+pub fn wrap_role<S: Into<String>>(
+    s: S,
+    role: ColorRole,
+    enabled: bool,
+) -> String {
+    let s: String = s.into();
+    if !enabled {
+        return s;
+    }
+    let prefix = match role {
+        ColorRole::Key => BOLD_BLUE,
+        ColorRole::String => GREEN,
+        ColorRole::Number => CYAN,
+        ColorRole::Bool | ColorRole::Null => BRIGHT_GRAY,
+    };
+    let mut out = String::with_capacity(8 + 8 + s.len());
+    out.push_str(prefix);
+    out.push_str(&s);
+    out.push_str(RESET);
+    out
+}
+
+pub fn omission_marker(enabled: bool) -> &'static str {
+    if enabled {
+        "\u{001b}[90m…\u{001b}[0m"
+    } else {
+        "…"
+    }
+}
+
+pub fn color_comment<S: Into<String>>(body: S, enabled: bool) -> String {
+    if !enabled {
+        return body.into();
+    }
+    let b = body.into();
+    let mut out = String::with_capacity(b.len() + 8 + 4);
+    out.push_str(DARK_GRAY);
+    out.push_str(&b);
+    out.push_str(RESET);
+    out
+}
+
+fn env_bool(var: &str) -> Option<bool> {
+    std::env::var_os(var).map(|v| {
+        let s = v.to_string_lossy();
+        !(s == "0" || s.is_empty())
+    })
+}
+
+struct ColorEnv {
+    force: bool,            // CLICOLOR_FORCE=1
+    force_color: bool,      // FORCE_COLOR=1
+    no_color: bool,         // NO_COLOR present
+    dumb: bool,             // TERM=dumb
+    clicolor: Option<bool>, // CLICOLOR=0/1
+    is_tty: bool,
+}
+
+fn read_color_env() -> ColorEnv {
+    let term_dumb = std::env::var_os("TERM")
+        .map(|t| t.to_string_lossy() == "dumb")
+        .unwrap_or(false);
+    ColorEnv {
+        force: matches!(env_bool("CLICOLOR_FORCE"), Some(true)),
+        force_color: matches!(env_bool("FORCE_COLOR"), Some(true)),
+        no_color: std::env::var_os("NO_COLOR").is_some(),
+        dumb: term_dumb,
+        clicolor: env_bool("CLICOLOR"),
+        is_tty: std::io::stdout().is_terminal(),
+    }
+}
+
+fn auto_color_enabled(env: &ColorEnv) -> bool {
+    if env.force || env.force_color {
+        return true;
+    }
+    if env.no_color || env.dumb {
+        return false;
+    }
+    if let Some(b) = env.clicolor {
+        return b && env.is_tty;
+    }
+    env.is_tty
+}
+
+pub fn resolve_color_enabled(mode: ColorMode) -> bool {
+    match mode {
+        ColorMode::On => true,
+        ColorMode::Off => false,
+        ColorMode::Auto => auto_color_enabled(&read_color_env()),
+    }
+}

{headson-0.5.3 → headson-0.6.0}/src/serialization/fileset.rs

@@ -17,7 +17,7 @@ impl<'a> RenderScope<'a> {
         out.push_str("// ");
         out.push_str(raw_key);
         out.push_str(nl);
-        let rendered = self.serialize_node(child_pq_id, depth, false);
+        let rendered = self.render_node_to_string(child_pq_id, depth, false);
         out.push_str(&rendered);
         out.push(';');
         out.push_str(nl);
@@ -58,7 +58,7 @@ impl<'a> RenderScope<'a> {
         out.push_str(raw_key);
         out.push_str(" <==");
         out.push_str(nl);
-        let rendered = self.serialize_node(child_pq_id, depth, false);
+        let rendered = self.render_node_to_string(child_pq_id, depth, false);
         out.push_str(&rendered);
     }