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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexatess-code
-Version: 0.2.0
+Version: 0.3.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
@@ -56,6 +56,10 @@ License-File: LICENSE
 Requires-Dist: pillow>=9.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
+Provides-Extra: camera
+Requires-Dist: numpy>=1.24; extra == "camera"
+Requires-Dist: opencv-python>=4.8; extra == "camera"
+Requires-Dist: scipy>=1.10; extra == "camera"
 Dynamic: license-file
 
 # Hexatess Code 🐝
@@ -109,27 +113,32 @@ text, stats = decode(grid)          # ('Hello, Hexatess!', {...})
 
 > **Status: experimental.** This is a young format: the symbol
 > specification and reference implementation are solid and heavily
-> tested (2,500+ tests, conformance vectors), but there is **no camera
-> decoder yet** — reading images assumes ideal upright sampling. See
-> the roadmap below. Adopting a young format is a deliberate bet; the
-> [full format specification](SPECIFICATION.md) is the insurance.
+> tested (2,500+ tests, conformance vectors).  A **camera decoder**
+> (`hexatess.camera`, optional `[camera]` extra) already reads symbols
+> from real photographs — printed labels, foil transparencies, tilted
+> and rotated shots.  See the roadmap below.  Adopting a young format
+> is a deliberate bet; the [full format specification](SPECIFICATION.md)
+> is the insurance.
 
 ## Installation
 
 ```bash
 pip install hexatess-code            # from PyPI (once published)
+pip install "hexatess-code[camera]"  # + photo decoding (numpy, opencv, scipy)
 # or from a source checkout:
 pip install -e .
 ```
 
-Requires Python ≥ 3.8 and Pillow (for rendering only).
+Requires Python ≥ 3.8; Pillow for rendering, numpy + OpenCV + SciPy
+for the optional camera decoder.
 
 ## Command line
 
 ```bash
 hexatess "Hello world" -o koda.png --ec 30
 hexatess "Important URL https://example.org" -o url.png --ec 55
-hexatess-code --demo        # demo symbol + robustness statistics
+hexatess --demo                       # demo symbol + robustness statistics
+hexatess decode-photo photo1.jpg photo2.jpg   # read symbols from photos
 ```
 
 ## API
@@ -141,6 +150,7 @@ hexatess-code --demo        # demo symbol + robustness statistics
 | `render(grid, path, size_px=18, ...)` | grid → PNG (pointy-top hexagons, quiet zone, supersampling) |
 | `sample_grid_from_image(path, rmax, ...)` | ideal re-sampling of a rendered PNG (self-test helper) |
 | `run_tests(...)` | noise/blob robustness statistics |
+| `hexatess.camera.decode_photo(path)` | photograph → `(text, stats)`; finder detection, perspective handling, adaptive sampling (optional `[camera]` extra) |
 
 `params` / `stats` contain `rmax` (radius in rings), `mask`, `ec`,
 `blocks` (list of `(data_bytes, ecc_bytes)`) and `data_len`.
@@ -174,9 +184,11 @@ vectors, it speaks Hexatess Code.
 
 ## Roadmap
 
-1. **v0.2 — camera decoding:** bullseye detection + perspective
-   correction (the critical ecosystem step).
-2. **v0.2 — erasure decoding:** declare blob-occluded modules as
+1. ~~v0.2/0.3 — camera decoding~~ **done (v0.3.0):** `hexatess.camera`
+   reads symbols from photographs — bullseye detection, homography +
+   correction-field warp handling, adaptive sampling; validated on
+   printed foil with curl and glare.
+2. **Erasure decoding:** declare blob-occluded modules as
    erasures → doubles correctable symbol counts.
 3. **JavaScript/TypeScript SDK** + online playground (generate a code
    in the browser in 10 seconds).

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

@@ -49,27 +49,32 @@ text, stats = decode(grid)          # ('Hello, Hexatess!', {...})
 
 > **Status: experimental.** This is a young format: the symbol
 > specification and reference implementation are solid and heavily
-> tested (2,500+ tests, conformance vectors), but there is **no camera
-> decoder yet** — reading images assumes ideal upright sampling. See
-> the roadmap below. Adopting a young format is a deliberate bet; the
-> [full format specification](SPECIFICATION.md) is the insurance.
+> tested (2,500+ tests, conformance vectors).  A **camera decoder**
+> (`hexatess.camera`, optional `[camera]` extra) already reads symbols
+> from real photographs — printed labels, foil transparencies, tilted
+> and rotated shots.  See the roadmap below.  Adopting a young format
+> is a deliberate bet; the [full format specification](SPECIFICATION.md)
+> is the insurance.
 
 ## Installation
 
 ```bash
 pip install hexatess-code            # from PyPI (once published)
+pip install "hexatess-code[camera]"  # + photo decoding (numpy, opencv, scipy)
 # or from a source checkout:
 pip install -e .
 ```
 
-Requires Python ≥ 3.8 and Pillow (for rendering only).
+Requires Python ≥ 3.8; Pillow for rendering, numpy + OpenCV + SciPy
+for the optional camera decoder.
 
 ## Command line
 
 ```bash
 hexatess "Hello world" -o koda.png --ec 30
 hexatess "Important URL https://example.org" -o url.png --ec 55
-hexatess-code --demo        # demo symbol + robustness statistics
+hexatess --demo                       # demo symbol + robustness statistics
+hexatess decode-photo photo1.jpg photo2.jpg   # read symbols from photos
 ```
 
 ## API
@@ -81,6 +86,7 @@ hexatess-code --demo        # demo symbol + robustness statistics
 | `render(grid, path, size_px=18, ...)` | grid → PNG (pointy-top hexagons, quiet zone, supersampling) |
 | `sample_grid_from_image(path, rmax, ...)` | ideal re-sampling of a rendered PNG (self-test helper) |
 | `run_tests(...)` | noise/blob robustness statistics |
+| `hexatess.camera.decode_photo(path)` | photograph → `(text, stats)`; finder detection, perspective handling, adaptive sampling (optional `[camera]` extra) |
 
 `params` / `stats` contain `rmax` (radius in rings), `mask`, `ec`,
 `blocks` (list of `(data_bytes, ecc_bytes)`) and `data_len`.
@@ -114,9 +120,11 @@ vectors, it speaks Hexatess Code.
 
 ## Roadmap
 
-1. **v0.2 — camera decoding:** bullseye detection + perspective
-   correction (the critical ecosystem step).
-2. **v0.2 — erasure decoding:** declare blob-occluded modules as
+1. ~~v0.2/0.3 — camera decoding~~ **done (v0.3.0):** `hexatess.camera`
+   reads symbols from photographs — bullseye detection, homography +
+   correction-field warp handling, adaptive sampling; validated on
+   printed foil with curl and glare.
+2. **Erasure decoding:** declare blob-occluded modules as
    erasures → doubles correctable symbol counts.
 3. **JavaScript/TypeScript SDK** + online playground (generate a code
    in the browser in 10 seconds).

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hexatess-code"
-version = "0.2.0"
+version = "0.3.0"
 description = "Hexatess Code - an experimental 2D barcode on a hexagonal grid with Reed-Solomon error correction"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -36,6 +36,11 @@ dependencies = [
 dev = [
     "pytest>=7.0",
 ]
+camera = [
+    "numpy>=1.24",
+    "opencv-python>=4.8",
+    "scipy>=1.10",
+]
 
 [project.urls]
 Homepage = "https://github.com/lovro-abram/hexatess-code"

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

@@ -57,7 +57,7 @@ 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.2.0"
+__version__ = "0.3.0"
 SPEC_VERSION = "0.2"
 
 __all__ = [