human-input-validator 0.1.0__tar.gz → 0.1.2__tar.gz

{human_input_validator-0.1.0 → human_input_validator-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: human-input-validator
-Version: 0.1.0
+Version: 0.1.2
 Summary: Small validators for common human-entered data.
 Author: Snorlena
 License-Expression: MIT
@@ -41,7 +41,8 @@ invalid input.
 
 - `email(value)` — returns a trimmed, lower-cased email address.
 - `country(value)` — returns the official ISO 3166-1 country name, given a
-  name or code.
+  name or code. Also accepts localized country names (e.g. "Deutschland",
+  "España") via pycountry's bundled translations.
 - `username(value, max_length=12)` — returns a lower-cased username, checking
   length and allowed characters.
 - `phonenumber(value, pattern)` — checks a phone number against one or more

{human_input_validator-0.1.0 → human_input_validator-0.1.2}/README.md

@@ -31,7 +31,8 @@ invalid input.
 
 - `email(value)` — returns a trimmed, lower-cased email address.
 - `country(value)` — returns the official ISO 3166-1 country name, given a
-  name or code.
+  name or code. Also accepts localized country names (e.g. "Deutschland",
+  "España") via pycountry's bundled translations.
 - `username(value, max_length=12)` — returns a lower-cased username, checking
   length and allowed characters.
 - `phonenumber(value, pattern)` — checks a phone number against one or more

{human_input_validator-0.1.0 → human_input_validator-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "human-input-validator"
-version = "0.1.0"
+version = "0.1.2"
 description = "Small validators for common human-entered data."
 readme = "README.md"
 requires-python = ">=3.10"

{human_input_validator-0.1.0 → human_input_validator-0.1.2}/src/human_input_validator/validators.py

@@ -5,6 +5,7 @@ Each function returns a normalized value or raises :class:`ValidationError`.
 
 from __future__ import annotations
 
+import difflib
 import functools
 import gettext
 import os
@@ -31,7 +32,12 @@ def _localized_country_names() -> dict[str, str]:
         except FileNotFoundError:
             continue
         for entry in pycountry.countries:
-            for candidate in filter(None, (entry.name, getattr(entry, "official_name", None))):
+            names = (
+                entry.name,
+                getattr(entry, "official_name", None),
+                getattr(entry, "common_name", None),
+            )
+            for candidate in filter(None, names):
                 translated = translation.gettext(candidate).strip().lower()
                 index.setdefault(translated, entry.alpha_2)
     return index
@@ -45,22 +51,40 @@ def email(value: str) -> str:
     return normalized
 
 
+_FUZZY_MATCH_CUTOFF = 0.8
+
+
+def _display_name(entry: object) -> str:
+    """Prefer the short common name (e.g. 'Tanzania') over the formal ISO name."""
+    common_name: str | None = getattr(entry, "common_name", None)
+    name: str = getattr(entry, "name")
+    return common_name or name
+
+
 def country(value: str) -> str:
-    """Return the official name of an ISO 3166-1 country, given its name or code in any supported language."""
+    """Return the common name of an ISO 3166-1 country, given its name or code in any supported language."""
     normalized = value.strip()
     try:
         result = pycountry.countries.lookup(normalized)
-        return result.name
+        return _display_name(result)
     except LookupError:
         pass
 
-    alpha_2 = _localized_country_names().get(normalized.lower())
+    index = _localized_country_names()
+    lowered = normalized.lower()
+    alpha_2 = index.get(lowered)
+    if alpha_2 is None:
+        # Fall back to fuzzy matching for close spelling variants (e.g. hyphenation
+        # or transliteration differences) not covered by the exact translation.
+        close_matches = difflib.get_close_matches(lowered, index.keys(), n=1, cutoff=_FUZZY_MATCH_CUTOFF)
+        if close_matches:
+            alpha_2 = index[close_matches[0]]
     if alpha_2 is None:
         raise ValidationError("Please enter a valid country")
     result = pycountry.countries.get(alpha_2=alpha_2)
     if result is None:
         raise ValidationError("Please enter a valid country")
-    return result.name
+    return _display_name(result)
 
 
 def username(value: str, max_length: int = 12) -> str:

{human_input_validator-0.1.0 → human_input_validator-0.1.2}/src/human_input_validator.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: human-input-validator
-Version: 0.1.0
+Version: 0.1.2
 Summary: Small validators for common human-entered data.
 Author: Snorlena
 License-Expression: MIT
@@ -41,7 +41,8 @@ invalid input.
 
 - `email(value)` — returns a trimmed, lower-cased email address.
 - `country(value)` — returns the official ISO 3166-1 country name, given a
-  name or code.
+  name or code. Also accepts localized country names (e.g. "Deutschland",
+  "España") via pycountry's bundled translations.
 - `username(value, max_length=12)` — returns a lower-cased username, checking
   length and allowed characters.
 - `phonenumber(value, pattern)` — checks a phone number against one or more