Referencia de API

CURP

class curp.CURP(curp: str, nombre: str | None = None, primer_apellido: str | None = None, segundo_apellido: str | None = None, nombre_completo: str | None = None)[fuente]

Realiza extracción de datos y validación de una CURP (Clave Única de Registro de Población).

Uso:

>>> from curp import CURP
>>> c = CURP("SABC560626MDFLRN01")
>>> c
<CURP [SABC]>

Construye una CURP.

Si sólo se proporciona un nombre completo, se dividirá de acuerdo a la CURP. Si se proporciona el nombre por partes, se usarán en lugar del nombre completo. Sólo se validarán las partes que se proporcionen.

Parámetros:

  • curp (str) – Una CURP de 18 caracteres.

  • nombre (str) – Nombre de pila de la persona.

  • primer_apellido (str) – Primer apellido (paterno) de la persona.

  • segundo_apellido (str) – Segundo apellido (materno) de la persona.

  • nombre_completo (str) – Nombre completo de la persona.

json() → str[fuente]

Objeto JSON conteniendo los datos extraídos de la CURP.

nombre_completo_valido(nombre_completo: str) → tuple[str, ...] | Literal[False][fuente]

Utiliza un nombre completo para validar la CURP.

Parámetros:

nombre_completo (str) – Nombre completo para validar.

Devuelve:

Una tupla con el nombre por partes, o False si el nombre no corresponde.

Tipo del valor devuelto:

tuple or False

nombre_valido(name: str) → bool[fuente]

Verifica que una CURP sea válida para cierto nombre de pila.

Parámetros:

name (str) – Nombre de pila para validar.

Por hacer

Averiguar si la regla de los nombres comunes aplica aún si hay palabras ignoradas antes de ellos.

primer_apellido_valido(primer_apellido: str) → bool[fuente]

Verifica que una CURP sea válida para cierto primer apellido.

Parámetros:

primer_apellido (str) – Primer apellido (usualmente paterno) para validar.

segundo_apellido_valido(segundo_apellido: str) → bool[fuente]

Verifica que una CURP sea válida para cierto segundo apellido.

Parámetros:

segundo_apellido (str) – Segundo apellido (usualmente materno) para validar.

property curp: str

CURP con la que se construyó el objeto.

property entidad: str

Entidad federativa de nacimiento de la CURP.

property entidad_iso: str | None

Código ISO de la entidad federativa de nacimiento de la CURP.

property es_extranjero: bool

True si la CURP pertenece a alguien nacido en el extranjero.

property fecha_nacimiento: date

Fecha de nacimiento extraída de la CURP.

property nombre: str | None

Nombre con el que se construyó el objeto.

property primer_apellido: str | None

Primer apellido con el que se construyó el objeto.

property primer_apellido_vacio: bool

True si la CURP puede corresponder a un primer apellido vacio.

property segundo_apellido: str | None

Segundo apellido con el que se construyó el objeto.

property segundo_apellido_vacio: bool

True si la CURP puede corresponder a un segundo apellido vacio.

property sexo: Sexo

Sexo extraído de la CURP.

Excepciones

exception curp.CURPValueError[fuente]

Indica que la validación de la CURP presentó errores.

exception curp.CURPLengthError[fuente]

La CURP no tiene la longitud correcta de 18 caracteres.

exception curp.CURPVerificationError[fuente]

El dígito verificador de la CURP no es el calculado.

exception curp.CURPNameError[fuente]

El nombre provisto no corresponde a la CURP.

exception curp.CURPFirstSurnameError[fuente]

El primer apellido provisto no corresponde a la CURP.

exception curp.CURPSecondSurnameError[fuente]

El segundo apellido provisto no corresponde a la CURP.

exception curp.CURPFullNameError[fuente]

El nombre completo provisto no corresponde a la CURP.

exception curp.CURPDateError[fuente]

La fecha indicada en la CURP es incorrecta.

exception curp.CURPSexError[fuente]

El sexo indicado en la CURP no es válido.

exception curp.CURPRegionError[fuente]

La entidad federativa indicada en la CURP no es válida.