cuenca-validations 2.1.28__tar.gz → 2.1.29.dev0__tar.gz

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca_validations
-Version: 2.1.28
+Version: 2.1.29.dev0
 Summary: Cuenca common validations
 Home-page: https://github.com/cuenca-mx/cuenca-validations
 Author: Cuenca

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/cuenca_validations/types/general.py

@@ -3,6 +3,7 @@ from dataclasses import dataclass
 from typing import Annotated, Any, Optional
 
 from pydantic import (
+    AfterValidator,
     AnyUrl,
     Field,
     HttpUrl,
@@ -11,7 +12,7 @@ from pydantic import (
     StringConstraints,
 )
 
-from ..validators import sanitize_dict, sanitize_item
+from ..validators import normalize_name, sanitize_dict, sanitize_item
 from .enums import (
     AccountUseType,
     IncomeType,
@@ -33,6 +34,12 @@ NonEmptyStr = Annotated[
     str, StringConstraints(strip_whitespace=True, min_length=1)
 ]
 
+NormalizedName = Annotated[
+    str,
+    StringConstraints(strip_whitespace=True, min_length=2),
+    AfterValidator(normalize_name),
+]
+
 
 class SantizedDict(dict):
     def __init__(self, *args, **kwargs):

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/cuenca_validations/types/queries.py

@@ -1,6 +1,7 @@
 import datetime as dt
 from typing import Annotated, Optional
 
+from clabe import Clabe
 from pydantic import (
     BaseModel,
     ConfigDict,
@@ -26,6 +27,7 @@ from .enums import (
     TransferNetwork,
     UserStatus,
 )
+from .general import NormalizedName
 from .identities import Curp
 
 MAX_PAGE_SIZE = 100
@@ -157,6 +159,9 @@ class UserQuery(QueryParams):
     status: Optional[UserStatus] = None
     identity_uri: Optional[str] = None
     has_curp_document: Optional[bool] = None
+    clabe: Optional[Clabe] = None
+    curp: Optional[Curp] = None
+    name: Optional[NormalizedName] = None
 
 
 class IdentityQuery(QueryParams):

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/cuenca_validations/validators.py

@@ -1,6 +1,7 @@
 import base64
 import datetime as dt
 import re
+import unicodedata
 from enum import Enum
 from typing import Any, Callable, Optional, Union
 
@@ -34,6 +35,19 @@ def normalize_phone_number(phone_number: str) -> str:
     return f'+{pn}'
 
 
+def normalize_name(name: str) -> str:
+    """Normalize names for search/index matching.
+
+    Strips accents, lowercases, and collapses internal whitespace.
+
+    Raúl  Andrés   -> raul andres
+    MARÍA JOSÉ     -> maria jose
+    """
+    collapsed = ' '.join(name.split())
+    nfkd = unicodedata.normalize('NFKD', collapsed)
+    return ''.join(c for c in nfkd if not unicodedata.combining(c)).lower()
+
+
 def sanitize_dict(d: dict) -> dict:
     for k, v in d.items():
         d[k] = sanitize_item(v)

cuenca_validations-2.1.29.dev0/cuenca_validations/version.py

@@ -0,0 +1 @@
+__version__ = '2.1.29.dev0'

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/cuenca_validations.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca_validations
-Version: 2.1.28
+Version: 2.1.29.dev0
 Summary: Cuenca common validations
 Home-page: https://github.com/cuenca-mx/cuenca-validations
 Author: Cuenca

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/tests/test_types.py

@@ -5,6 +5,7 @@ from enum import Enum
 from typing import Annotated
 
 import pytest
+from clabe import Clabe
 from freezegun import freeze_time
 from pydantic import AfterValidator, BaseModel, SecretStr, ValidationError
 from pydantic.fields import FieldInfo
@@ -16,6 +17,7 @@ from cuenca_validations.types import (
     SantizedDict,
     SessionRequest,
     TransactionStatus,
+    UserQuery,
     digits,
     get_account_use_type_name,
     get_income_type_name,
@@ -201,6 +203,50 @@ def test_card_query_exp_cvv_if_number_not_set(input_value):
         CardQuery(**input_value)
 
 
+def test_user_query_accepts_new_fields():
+    query = UserQuery(
+        clabe='646180157098510917',
+        curp='ABCD920604HDFSRN03',
+        name='Pedro Páramo',
+    )
+    assert isinstance(query.clabe, Clabe)
+    assert query.clabe == '646180157098510917'
+    assert query.curp == 'ABCD920604HDFSRN03'
+    assert query.name == 'pedro paramo'
+
+
+@pytest.mark.parametrize(
+    'raw, normalized',
+    [
+        ('ab', 'ab'),
+        ('  ab  ', 'ab'),
+        ('Raúl Andrés', 'raul andres'),
+        ('raul Andres', 'raul andres'),
+        ('  RAÚL   ANDRÉS  ', 'raul andres'),
+        ('María José', 'maria jose'),
+        ('ÑANDÚ', 'nandu'),
+    ],
+)
+def test_user_query_name_normalizes(raw, normalized):
+    assert UserQuery(name=raw).name == normalized
+
+
+@pytest.mark.parametrize(
+    'field, value',
+    [
+        ('clabe', 'not-a-clabe'),
+        ('curp', 'not-a-curp'),
+        ('name', ''),
+        ('name', ' '),
+        ('name', 'a'),
+        ('name', ' a '),
+    ],
+)
+def test_user_query_rejects_invalid(field, value):
+    with pytest.raises(ValidationError):
+        UserQuery(**{field: value})
+
+
 def test_exclude_none_in_dict():
     request = ApiKeyUpdateRequest(user_id='US123')
     assert request.model_dump() == dict(user_id='US123')

{cuenca_validations-2.1.28 → cuenca_validations-2.1.29.dev0}/tests/test_validators.py

@@ -2,6 +2,7 @@ import pytest
 
 from cuenca_validations.validators import (
     normalize_email,
+    normalize_name,
     normalize_phone_number,
 )
 
@@ -33,3 +34,19 @@ def test_normalize_email(raw: str, normalized: str) -> None:
 )
 def test_normalize_phone_number(raw: str, normalized: str) -> None:
     assert normalize_phone_number(raw) == normalized
+
+
+@pytest.mark.parametrize(
+    'raw, normalized',
+    [
+        ('Raúl Andrés', 'raul andres'),  # accents + mixed case
+        ('raul andres', 'raul andres'),  # already normalized
+        ('RAÚL ANDRÉS', 'raul andres'),  # uppercase with accents
+        ('ÑANDÚ', 'nandu'),  # ñ and accent
+        ('María  José', 'maria jose'),  # collapse internal whitespace
+        ('  Raúl  ', 'raul'),  # trim + lowercase
+        ('Nuño Garçía', 'nuno garcia'),  # tilde and cedilla
+    ],
+)
+def test_normalize_name(raw: str, normalized: str) -> None:
+    assert normalize_name(raw) == normalized

cuenca_validations-2.1.28/cuenca_validations/version.py

@@ -1 +0,0 @@
-__version__ = '2.1.28'