hyperscale-stack / businessid / 28644725413

100%

main: 94%

Build Type

Pull #3

github

Committed by euskadi31

Commit Message

feat: strengthen EUID/VAT/SIREN/SIRET reliability

Reach ~90% checksum confidence on EU business identifiers by
implementing per-country VAT algorithms, delegating EUID
validation to national sub-validators, and hardening SIREN/SIRET
with reserved-NIC rejection and an extensible dérogation table.

Changes per provider:

* VAT: implement checksums for 28 codes (EU-27 + XI + GB). Each
  algorithm sourced from the national tax authority and
  cross-verified against python-stdnum test vectors. Add GR→EL
  alias in Canonicalize. Add WithLegacy() option accepting the
  pre-2013 Irish '+' and '*' position-2 characters. NO/IS/LI stay
  format-only (no published algorithm).
* EUID: reframe as a meta-format. Country code selects a
  sub-validator (SIREN wired for FR by defaults.New). ValidateFormat
  and ValidateChecksum delegate the REGISTRATION segment. Add
  WithSubValidator() option. Registration charset now accepts '+'.
* SIRET: reject NIC "00000" (INSEE-reserved) at Format level. Move
  La Poste rule to an extensible dérogation table. Add
  WithDerogation() option for client-registered exceptions.
* SIREN: add WithDerogation() option and dérogation table
  (empty by default; extensible for historical entities).
* All 4 providers gain New(opts ...Option) constructors.

Testing:

* +250 new test cases (per-country VAT format + checksum, EUID
  meta-format delegation, SIREN/SIRET dérogation and NIC).
* Fuzz tests on the 4 providers via `make fuzz`.
* All 556 tests pass with -race, lint clean.
* Per-country VAT vectors documented with `// Source: <URL>`
  comments referencing national tax authorities and imprints.

Docs: README expanded with a per-country checksum coverage
statement and the option-pattern examples.

Pull Request Pull Request #3: feat: strengthen EUID/VAT/SIREN/SIRET reliability

Coverage Stats

735 of 875 new or added lines in 10 files covered. (84.0%)

10 existing lines in 2 files now uncovered.

1774 of 1914 relevant lines covered (92.69%)

16.31 hits per line