hexatess-code 0.1.0__tar.gz → 0.2.0__tar.gz

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/LICENSE

@@ -27,4 +27,4 @@ The format specification (SPECIFICATION.md) is additionally released under
 the Creative Commons Attribution 4.0 International license (CC-BY-4.0), so
 that anyone may implement compatible encoders/decoders in any language,
 under any license, without restriction. Provide attribution as:
-"Hexatess Code Specification v0.1, https://github.com/<you>/hexatess-code".
+"Hexatess Code Specification v0.2, https://github.com/<you>/hexatess-code".

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexatess-code
-Version: 0.1.0
+Version: 0.2.0
 Summary: Hexatess Code - an experimental 2D barcode on a hexagonal grid with Reed-Solomon error correction
 Author: The Hexatess Code Authors
 License: MIT License
@@ -32,7 +32,7 @@ License: MIT License
         the Creative Commons Attribution 4.0 International license (CC-BY-4.0), so
         that anyone may implement compatible encoders/decoders in any language,
         under any license, without restriction. Provide attribution as:
-        "Hexatess Code Specification v0.1, https://github.com/<you>/hexatess-code".
+        "Hexatess Code Specification v0.2, https://github.com/<you>/hexatess-code".
         
 Project-URL: Homepage, https://github.com/lovro-abram/hexatess-code
 Project-URL: Specification, https://github.com/lovro-abram/hexatess-code/blob/main/SPECIFICATION.md
@@ -59,6 +59,11 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 Dynamic: license-file
 
 # Hexatess Code 🐝
+[![PyPI](https://img.shields.io/pypi/v/hexatess-code)](https://pypi.org/project/hexatess-code/) 
+
+[![Python](https://img.shields.io/pypi/pyversions/hexatess-code)](https://pypi.org/project/hexatess-code/) 
+
+[![CI](https://github.com/lovro-abram/hexatess-code/actions/workflows/ci.yml/badge.svg)](https://github.com/lovro-abram/hexatess-code/actions/workflows/ci.yml) 
 
 **An experimental 2D barcode on a hexagonal grid** — with a hexagonal
 bullseye finder, spiral serialization and a continuously selectable
@@ -81,7 +86,7 @@ text, stats = decode(grid)          # ('Hello, Hexatess!', {...})
 * **A** — a real encoded symbol: hexagonal bullseye finder (rings 0–4),
   orientation key (ring 5: two dark cells), data region (rings 6…)
   filled in spiral order, and a quiet zone of at least 1 module;
-* **B** — finder close-up: light centre (v0.1 rule `bit = ring mod 2`),
+* **B** — finder close-up: dark centre (rule `bit = 1 − ring mod 2`),
   alternating dark/light rings, and the key — the first two canonical
   ring-5 cells set dark, breaking the 60-fold symmetry and marking the
   spiral start direction;
@@ -162,7 +167,7 @@ concentrate inside whole bytes.
 The format is deliberately **specification-first**: everything needed
 for an independent implementation is in
 [`SPECIFICATION.md`](SPECIFICATION.md), and
-[`test_vectors/vectors_v0.1.json`](test_vectors/vectors_v0.1.json)
+[`test_vectors/vectors_v0.2.json`](test_vectors/vectors_v0.2.json)
 contains fixed inputs/outputs (grids, headers, damaged symbols, expected
 results) to verify conformance. If your Rust/Go/JS decoder passes the
 vectors, it speaks Hexatess Code.

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/README.md

@@ -1,4 +1,9 @@
 # Hexatess Code 🐝
+[![PyPI](https://img.shields.io/pypi/v/hexatess-code)](https://pypi.org/project/hexatess-code/) 
+
+[![Python](https://img.shields.io/pypi/pyversions/hexatess-code)](https://pypi.org/project/hexatess-code/) 
+
+[![CI](https://github.com/lovro-abram/hexatess-code/actions/workflows/ci.yml/badge.svg)](https://github.com/lovro-abram/hexatess-code/actions/workflows/ci.yml) 
 
 **An experimental 2D barcode on a hexagonal grid** — with a hexagonal
 bullseye finder, spiral serialization and a continuously selectable
@@ -21,7 +26,7 @@ text, stats = decode(grid)          # ('Hello, Hexatess!', {...})
 * **A** — a real encoded symbol: hexagonal bullseye finder (rings 0–4),
   orientation key (ring 5: two dark cells), data region (rings 6…)
   filled in spiral order, and a quiet zone of at least 1 module;
-* **B** — finder close-up: light centre (v0.1 rule `bit = ring mod 2`),
+* **B** — finder close-up: dark centre (rule `bit = 1 − ring mod 2`),
   alternating dark/light rings, and the key — the first two canonical
   ring-5 cells set dark, breaking the 60-fold symmetry and marking the
   spiral start direction;
@@ -102,7 +107,7 @@ concentrate inside whole bytes.
 The format is deliberately **specification-first**: everything needed
 for an independent implementation is in
 [`SPECIFICATION.md`](SPECIFICATION.md), and
-[`test_vectors/vectors_v0.1.json`](test_vectors/vectors_v0.1.json)
+[`test_vectors/vectors_v0.2.json`](test_vectors/vectors_v0.2.json)
 contains fixed inputs/outputs (grids, headers, damaged symbols, expected
 results) to verify conformance. If your Rust/Go/JS decoder passes the
 vectors, it speaks Hexatess Code.

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hexatess-code"
-version = "0.1.0"
+version = "0.2.0"
 description = "Hexatess Code - an experimental 2D barcode on a hexagonal grid with Reed-Solomon error correction"
 readme = "README.md"
 requires-python = ">=3.8"

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/src/hexatess/__init__.py

@@ -1,6 +1,6 @@
 """Hexatess Code - an experimental 2D barcode on a hexagonal grid.
 
-Reference implementation of specification v0.1.  The symbol is a
+Reference implementation of specification v0.2.  The symbol is a
 hexagonal lattice with a hexagonal bullseye finder, an
 orientation key ring, spiral serialization from the centre outwards,
 a Reed-Solomon protected header and a continuously selectable
@@ -18,7 +18,7 @@ Quick start
 'Hello, Hexatess!'
 
 See SPECIFICATION.md in the repository for the full format
-specification, and test_vectors/vectors_v0.1.json for conformance
+specification, and test_vectors/vectors_v0.2.json for conformance
 data usable by independent implementations.
 """
 
@@ -57,8 +57,8 @@ from .reedsolomon import rs_correct_msg, rs_encode_msg
 from .render import render, sample_grid_from_image
 from .resilience import add_blob_damage, add_random_noise, run_tests
 
-__version__ = "0.1.0"
-SPEC_VERSION = "0.1"
+__version__ = "0.2.0"
+SPEC_VERSION = "0.2"
 
 __all__ = [
     # high-level API

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/src/hexatess/cli.py

@@ -25,7 +25,7 @@ def main(argv=None):
     ap = argparse.ArgumentParser(
         prog="hexatess",
         description="Hexatess Code - hexagonal-grid 2D barcode "
-                    "(reference implementation, spec v0.1)")
+                    "(reference implementation, spec v0.2)")
     ap.add_argument("text", nargs="?", help="text to encode (UTF-8)")
     ap.add_argument("-o", "--output", default="hexatess.png",
                     help="output PNG path (default: %(default)s)")
@@ -46,7 +46,7 @@ def main(argv=None):
         run_tests()
 
     if args.demo or args.text:
-        text = args.text or "Hexatess Code v0.1 - " * 6
+        text = args.text or "Hexatess Code v0.2 - " * 6
         grid, params = encode(text, ec_pct=args.ec, mask_id="auto"
                               if args.mask is None else args.mask)
         render(grid, args.output, size_px=args.size)

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/src/hexatess/decoder.py

@@ -28,7 +28,7 @@ def decode(grid, params=None):
     grid : dict
         Mapping ``{(q, r): 0|1}``.
     params : dict, optional
-        Ignored; kept for API symmetry with v0.1 of the prototype.
+        Ignored; kept for API symmetry with the original prototype.
 
     Returns
     -------

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/src/hexatess/encoder.py

@@ -2,10 +2,11 @@
 
 Turns UTF-8 text into a hexagonal module grid ``{(q, r): 0|1}``.
 
-Layout summary (specification v0.1):
+Layout summary (specification v0.2):
 
 * rings 0..4 -- hexagonal bullseye finder, ring ``k`` filled with
-  ``k mod 2`` (bit 1 = dark module; the centre module is LIGHT in v0.1);
+  ``1 - (k mod 2)`` (bit 1 = dark module; the centre module is DARK
+  since spec v0.2);
 * ring 5     -- orientation key: all modules light except the first two
   cells of ``hex_ring(5)`` (``(-5, 5)`` and ``(-4, 5)``) which are dark;
 * rings 6..rmax -- payload bits in spiral order: header (80 bits,
@@ -62,7 +63,8 @@ def encode(text: str, ec_pct: int = 30, mask_id="auto", min_rings=None):
     data = text.encode("utf-8")
     if len(data) > MAX_DATA_BYTES:
         raise ValueError(
-            "v0.1 supports up to %d bytes of data" % MAX_DATA_BYTES)
+            "the radius limit supports up to %d bytes of data"
+            % MAX_DATA_BYTES)
     blocks = plan_blocks(len(data), ec_pct)
     ecc_total = sum(e for _, e in blocks)
     need_bits = MODE_BITS + (len(data) + ecc_total) * 8
@@ -110,7 +112,7 @@ def encode(text: str, ec_pct: int = 30, mask_id="auto", min_rings=None):
     grid = {}
     for k in range(BULLSEYE_RINGS + 1):
         for c in hex_ring(k):
-            grid[c] = k % 2          # centre LIGHT in v0.1, rings alternate
+            grid[c] = 1 - (k % 2)    # centre DARK (v0.2), rings alternate
     for c in hex_ring(KEY_RING):
         grid[c] = 0
     key = hex_ring(KEY_RING)

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/src/hexatess/header.py

@@ -7,7 +7,7 @@ import math
 from .reedsolomon import rs_encode_msg, rs_correct_msg
 
 # ----------------------------------------------------------------------
-# Symbol constants (fixed in specification v0.1)
+# Symbol constants (fixed in specification v0.2)
 # ----------------------------------------------------------------------
 
 BULLSEYE_RINGS = 4     # rings 0..4 form the hexagonal bullseye finder

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/src/hexatess_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexatess-code
-Version: 0.1.0
+Version: 0.2.0
 Summary: Hexatess Code - an experimental 2D barcode on a hexagonal grid with Reed-Solomon error correction
 Author: The Hexatess Code Authors
 License: MIT License
@@ -32,7 +32,7 @@ License: MIT License
         the Creative Commons Attribution 4.0 International license (CC-BY-4.0), so
         that anyone may implement compatible encoders/decoders in any language,
         under any license, without restriction. Provide attribution as:
-        "Hexatess Code Specification v0.1, https://github.com/<you>/hexatess-code".
+        "Hexatess Code Specification v0.2, https://github.com/<you>/hexatess-code".
         
 Project-URL: Homepage, https://github.com/lovro-abram/hexatess-code
 Project-URL: Specification, https://github.com/lovro-abram/hexatess-code/blob/main/SPECIFICATION.md
@@ -59,6 +59,11 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 Dynamic: license-file
 
 # Hexatess Code 🐝
+[![PyPI](https://img.shields.io/pypi/v/hexatess-code)](https://pypi.org/project/hexatess-code/) 
+
+[![Python](https://img.shields.io/pypi/pyversions/hexatess-code)](https://pypi.org/project/hexatess-code/) 
+
+[![CI](https://github.com/lovro-abram/hexatess-code/actions/workflows/ci.yml/badge.svg)](https://github.com/lovro-abram/hexatess-code/actions/workflows/ci.yml) 
 
 **An experimental 2D barcode on a hexagonal grid** — with a hexagonal
 bullseye finder, spiral serialization and a continuously selectable
@@ -81,7 +86,7 @@ text, stats = decode(grid)          # ('Hello, Hexatess!', {...})
 * **A** — a real encoded symbol: hexagonal bullseye finder (rings 0–4),
   orientation key (ring 5: two dark cells), data region (rings 6…)
   filled in spiral order, and a quiet zone of at least 1 module;
-* **B** — finder close-up: light centre (v0.1 rule `bit = ring mod 2`),
+* **B** — finder close-up: dark centre (rule `bit = 1 − ring mod 2`),
   alternating dark/light rings, and the key — the first two canonical
   ring-5 cells set dark, breaking the 60-fold symmetry and marking the
   spiral start direction;
@@ -162,7 +167,7 @@ concentrate inside whole bytes.
 The format is deliberately **specification-first**: everything needed
 for an independent implementation is in
 [`SPECIFICATION.md`](SPECIFICATION.md), and
-[`test_vectors/vectors_v0.1.json`](test_vectors/vectors_v0.1.json)
+[`test_vectors/vectors_v0.2.json`](test_vectors/vectors_v0.2.json)
 contains fixed inputs/outputs (grids, headers, damaged symbols, expected
 results) to verify conformance. If your Rust/Go/JS decoder passes the
 vectors, it speaks Hexatess Code.

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/tests/test_codec.py

@@ -67,7 +67,7 @@ def test_bullseye_pattern():
     grid, params = encode("bullseye", ec_pct=30)
     for k in range(BULLSEYE_RINGS + 1):
         for c in hex_ring(k):
-            assert grid[c] == k % 2
+            assert grid[c] == 1 - (k % 2)   # centre DARK (spec v0.2)
     key = hex_ring(KEY_RING)
     for c in key[2:]:
         assert grid[c] == 0

{hexatess_code-0.1.0 → hexatess_code-0.2.0}/tests/test_conformance.py

@@ -16,7 +16,7 @@ from test_vectors.generate_vectors import grid_from_hex
 
 HERE = os.path.dirname(os.path.abspath(__file__))
 ROOT = os.path.dirname(HERE)
-VECTOR_FILE = os.path.join(ROOT, "test_vectors", "vectors_v0.1.json")
+VECTOR_FILE = os.path.join(ROOT, "test_vectors", "vectors_v0.2.json")
 
 with open(VECTOR_FILE, "r", encoding="utf-8") as fh:
     VECTORS = json.load(fh)