spanish-nif 0.3.0

Pydantic validators for spanish identification codes: NIF, DNI and NIE.

spanish-nif

Pydantic validators for spanish identification codes: NIF, DNI and NIE.

Documentation

---

⚠️ AI-generated library: This library may contain severe vulnerabilities and should not be trusted for critical workflows. Use at your own risk; it was produced with the Codex AI assistant.

This library turns Spanish identification numbers into first-class Python types. Each class (NIF, DNI, NIE) subclasses str, validates its control letter on construction, and plugs straight into Pydantic so you can drop it into your data models without writing bespoke validators.

Installation

• pip

  python -m pip install spanish-nif
  

• uv

  uv pip install spanish-nif
  

Quick examples

from spanish_nif import DNI, NIE, NIF

DNI("12345678Z")          # returns a validated DNI string
NIE.is_valid("X1234567L") # -> True
NIF("K0867756N").variant  # -> "legacy"

from pydantic import BaseModel
from spanish_nif import NIF

class TaxPayer(BaseModel):
    nif: NIF

tax_payer = TaxPayer(nif="12345678Z")
assert tax_payer.nif == "12345678Z"

• Invalid inputs raise an InvalidIdentification subclass with a helpful message.
• Normalisation uppercases the value and validates the control-letter sequence; inputs must already be correctly formatted.