CLABE
Librería para validar y calcular un número CLABE basado en https://es.wikipedia.org/wiki/CLABE
Requerimientos
Python 3.8 o superior.
Instalación
Se puede instalar desde Pypi usando
pip install clabe
Pruebas
Para ejecutar las pruebas
$ make test
Uso básico
Como tipo personalizado en un modelo de Pydantic
from pydantic import BaseModel, ValidationError
from clabe import Clabe
class Account(BaseModel):
id: str
clabe: Clabe
account = Account(id='123', clabe='723010123456789019')
print(account)
"""
id='123' clabe='723010123456789019'
"""
try:
account = Account(id='321', clabe='000000000000000011')
except ValidationError as exc:
print(exc)
"""
1 validation error for Account
clabe
código de banco no es válido [type=clabe.bank_code, input_value='000000000000000011', input_type=str]
"""
Obtener el dígito de control de un número CLABE
import clabe
clabe.compute_control_digit('00200000000000000')
Para validar si un número CLABE es válido
import clabe
clabe.validate_clabe('002000000000000008')
Para obtener el banco a partir de 3 dígitos
import clabe
clabe.get_bank_name('002')
Para generar nuevo válido CLABES
import clabe
clabe.generate_new_clabes(10, '002123456')
Agregar un nuevo banco
A partir de la versión 2.0.0, el paquete ha sido actualizado para utilizar Pydantic v2, lo que implica que las versiones anteriores ya no recibirán soporte ni actualizaciones.
No obstante, en versiones anteriores hemos agregado una función que permite añadir bancos adicionales a la lista sin necesidad de crear un PR. Esto es útil para quienes aún utilicen versiones anteriores. Sin embargo, a partir de la versión 2, continuaremos manteniendo y actualizando la lista oficial de bancos mediante PRs en el repositorio.
Cómo agregar un banco
Para agregar un banco, llama a la función add_bank pasando el código de Banxico y el nombre del banco como parámetros.
import clabe
clabe.add_bank('12345', 'New Bank')
Cómo eliminar un banco
De manera similar, puedes eliminar un banco llamando a la función remove_bank con el código del banco que deseas eliminar.
import clabe
clabe.remove_bank('12345')
Nota: Aunque estas funciones están disponibles para un uso más flexible, recomendamos utilizar siempre la lista oficial de bancos actualizada en la versión 2+.
Mantener actualizada la lista de participantes
Para mantener sincronizada la lista de participantes del SPEI con la información oficial de Banxico, este repositorio incluye un script que compara automáticamente los datos locales con la lista actualizada de instituciones financieras.
Verificar cambios en la lista de participantes
El script compare_banks.py detecta:
- Nuevos participantes: Instituciones que aparecen en Banxico pero no están en el paquete
- Bajas de participantes: Instituciones que ya no aparecen en la lista oficial de Banxico
- Cambios de nombre: Participantes que mantienen el mismo código pero han cambiado su nombre
Para ejecutar la verificación:
export PYTHONPATH=$(pwd)
python scripts/compare_banks.py
Interpretar los resultados
El script mostrará un reporte con las diferencias encontradas:
- ADDITIONS: Nuevos participantes que deben agregarse al archivo
clabe/banks.py - REMOVALS: Participantes que deben eliminarse por ya no estar activos
- CHANGES: Cambios de nombre que requieren actualización
Si no hay diferencias, el script confirmará que los datos están sincronizados.
Actualizar la lista de participantes
Una vez identificados los cambios, actualiza manualmente el archivo clabe/banks.py y crea un pull request para mantener la lista actualizada.
Metadata
Release files for clabe 2.1.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| clabe-2.1.11.tar.gz | 9.2 kB | Without provenance | Details for clabe-2.1.11.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| clabe-2.1.11-py3-none-any.whl | Python 3 | none | any | Details for clabe-2.1.11-py3-none-any.whl |
Total release size: 19.6 kB
Release files / clabe-2.1.11.tar.gz
| Download URL | clabe-2.1.11.tar.gz |
|---|---|
| Size | 9.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4de92ec0c81af00647d5d9e0c45584867bb1654fb1148539091da4775e5f82cf
|
|
BLAKE2b-256 checksum How to use checksums |
1b2dd99eb2f42bcbd597eb18e9022629e8f190ced88284c298c035af1ed85afe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / clabe-2.1.11-py3-none-any.whl
| Download URL | clabe-2.1.11-py3-none-any.whl |
|---|---|
| Size | 10.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e961d324b9f2d72b184ceec896737d486c7fa5e646813fc5231b990e58ac833
|
|
BLAKE2b-256 checksum How to use checksums |
258e82d51bd2a8be288123c08374f813370c6199b85df9a5567500ce28e298d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for clabe 2.1.11
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.