eu-licence-validator 0.1.18__tar.gz

eu_licence_validator-0.1.18/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: eu-licence-validator
+Version: 0.1.18
+Summary: European licence plate validation. Single Go core compiled to WebAssembly, bundled for Python.
+Author: TrueJacobG
+License: MIT
+Project-URL: Homepage, https://github.com/TrueJacobG/eu-licence-validator
+Project-URL: Repository, https://github.com/TrueJacobG/eu-licence-validator
+Project-URL: Issues, https://github.com/TrueJacobG/eu-licence-validator/issues
+Keywords: licence,license,plate,european,eu,validation,wasm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: wasmtime>=14.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+
+# eu-licence-validator (Python)
+
+European licence plate validation for Python, powered by a shared Go/WebAssembly core.
+
+## Install
+
+```bash
+pip install eu-licence-validator
+```
+
+## Usage
+
+```python
+from eu_licence_validator import is_valid
+
+is_valid("WPI 1234X", "PL")   # True
+is_valid("AA-123-SS", "FR")   # False
+```

eu_licence_validator-0.1.18/README.md

@@ -0,0 +1,18 @@
+# eu-licence-validator (Python)
+
+European licence plate validation for Python, powered by a shared Go/WebAssembly core.
+
+## Install
+
+```bash
+pip install eu-licence-validator
+```
+
+## Usage
+
+```python
+from eu_licence_validator import is_valid
+
+is_valid("WPI 1234X", "PL")   # True
+is_valid("AA-123-SS", "FR")   # False
+```

eu_licence_validator-0.1.18/eu_licence_validator/__init__.py

@@ -0,0 +1,73 @@
+"""European licence plate validation (Python binding).
+
+Loads the shared Go-compiled WebAssembly core once and exposes
+``is_valid(plate, country_code) -> bool``.
+"""
+
+from __future__ import annotations
+
+import os
+from functools import lru_cache
+from typing import Tuple
+
+from wasmtime import Engine, ExitTrap, Instance, Linker, Module, Store, WasiConfig
+
+__all__ = ["is_valid", "isValid"]
+
+_WASM_PATH = os.path.join(os.path.dirname(__file__), "wasm", "core.wasm")
+
+
+@lru_cache(maxsize=1)
+def _instance() -> Tuple[Store, Instance]:
+    engine = Engine()
+    store = Store(engine)
+    store.set_wasi(WasiConfig())
+    module = Module.from_file(engine, _WASM_PATH)
+    linker = Linker(engine)
+    linker.define_wasi()
+    instance = linker.instantiate(store, module)
+    exports = instance.exports(store)
+
+    start = exports["_start"]
+    if start is not None:
+        try:
+            start(store)
+        except (ExitTrap, SystemExit, RuntimeError):
+            pass
+    return store, instance
+
+
+def _write(store: Store, instance: Instance, data: bytes) -> Tuple[int, int]:
+    exports = instance.exports(store)
+    alloc = exports["alloc"]
+    ptr = alloc(store, len(data))
+    if ptr == 0 and len(data) > 0:
+        raise MemoryError("wasm alloc returned 0")
+    mem = exports["memory"]
+    raw = mem.data_ptr(store)
+    for i, b in enumerate(data):
+        raw[ptr + i] = b
+    return ptr, len(data)
+
+
+def is_valid(plate: str, country_code: str) -> bool:
+    """Return True if ``plate`` is a valid licence plate for ``country_code``."""
+    store, instance = _instance()
+    exports = instance.exports(store)
+
+    plate_bytes = plate.encode("utf-8")
+    country_bytes = country_code.encode("utf-8")
+
+    p_ptr, p_len = _write(store, instance, plate_bytes)
+    c_ptr, c_len = _write(store, instance, country_bytes)
+
+    validate = exports["validate"]
+    result = validate(store, p_ptr, p_len, c_ptr, c_len)
+
+    dealloc = exports["dealloc"]
+    dealloc(store, p_ptr)
+    dealloc(store, c_ptr)
+    return result == 1
+
+
+isValid = is_valid

eu_licence_validator-0.1.18/eu_licence_validator.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: eu-licence-validator
+Version: 0.1.18
+Summary: European licence plate validation. Single Go core compiled to WebAssembly, bundled for Python.
+Author: TrueJacobG
+License: MIT
+Project-URL: Homepage, https://github.com/TrueJacobG/eu-licence-validator
+Project-URL: Repository, https://github.com/TrueJacobG/eu-licence-validator
+Project-URL: Issues, https://github.com/TrueJacobG/eu-licence-validator/issues
+Keywords: licence,license,plate,european,eu,validation,wasm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: wasmtime>=14.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+
+# eu-licence-validator (Python)
+
+European licence plate validation for Python, powered by a shared Go/WebAssembly core.
+
+## Install
+
+```bash
+pip install eu-licence-validator
+```
+
+## Usage
+
+```python
+from eu_licence_validator import is_valid
+
+is_valid("WPI 1234X", "PL")   # True
+is_valid("AA-123-SS", "FR")   # False
+```

eu_licence_validator-0.1.18/eu_licence_validator.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+eu_licence_validator/__init__.py
+eu_licence_validator.egg-info/PKG-INFO
+eu_licence_validator.egg-info/SOURCES.txt
+eu_licence_validator.egg-info/dependency_links.txt
+eu_licence_validator.egg-info/requires.txt
+eu_licence_validator.egg-info/top_level.txt
+eu_licence_validator/wasm/core.wasm
+tests/test_validator.py

eu_licence_validator-0.1.18/eu_licence_validator.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

eu_licence_validator-0.1.18/eu_licence_validator.egg-info/requires.txt

@@ -0,0 +1,4 @@
+wasmtime>=14.0.0
+
+[dev]
+pytest>=7.0.0

eu_licence_validator-0.1.18/eu_licence_validator.egg-info/top_level.txt

@@ -0,0 +1 @@
+eu_licence_validator

eu_licence_validator-0.1.18/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eu-licence-validator"
+version = "0.1.18"
+description = "European licence plate validation. Single Go core compiled to WebAssembly, bundled for Python."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "TrueJacobG" }]
+requires-python = ">=3.9"
+dependencies = ["wasmtime>=14.0.0"]
+keywords = ["licence", "license", "plate", "european", "eu", "validation", "wasm"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Libraries",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0.0"]
+
+[project.urls]
+Homepage = "https://github.com/TrueJacobG/eu-licence-validator"
+Repository = "https://github.com/TrueJacobG/eu-licence-validator"
+Issues = "https://github.com/TrueJacobG/eu-licence-validator/issues"
+
+[tool.setuptools]
+packages = ["eu_licence_validator"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+eu_licence_validator = ["wasm/core.wasm"]

eu_licence_validator-0.1.18/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

eu_licence_validator-0.1.18/tests/test_validator.py

@@ -0,0 +1,37 @@
+import json
+import os
+from pathlib import Path
+
+import pytest
+
+from eu_licence_validator import is_valid
+
+_CASES_PATH = Path(__file__).resolve().parents[3] / "test_cases.json"
+
+
+@pytest.fixture(scope="module")
+def cases():
+    with open(_CASES_PATH) as f:
+        data = json.load(f)
+    assert data, "test_cases.json is empty"
+    return data
+
+
+@pytest.mark.parametrize("case", [{}])  # replaced dynamically below
+def test_cases_placeholder(case):
+    pass
+
+
+def _ids(cases):
+    return [f"{c['country']}:{c['plate']}" for c in cases]
+
+
+def test_all_cases(cases):
+    failures = []
+    for c in cases:
+        got = is_valid(c["plate"], c["country"])
+        if got != c["expected"]:
+            failures.append(
+                f"is_valid({c['plate']!r}, {c['country']!r}) = {got}, want {c['expected']}"
+            )
+    assert not failures, "\n".join(failures)