ciuy

Paquete para validar números de documentos de identidad Uruguayos.

Las funciones en este paquete funcionan con strings e ignoran cualquier caracter que no sea un número. También se pueden usar números. Entonces por ejemplo, las siguientes expresiones representan el mismo número de documento:

'1.234.567-2'
'12345672'
12345672

Instalación

ciuy puede ser instalado con pip:

Uso

>>> import ciuy
>>> ciuy.validate_ci("1.234.567-2")
True
>>> ciuy.validation_digit("1.234.567")
'2'
>>> ciuy.random()
'82405816'

Ver Funciones y ejemplos para información más detallada acerca de cada función.

Testing

Este paquete incluye algunos doctests, así como también tests unitarios que pueden ser ejecutados con pytest.

Luego de clonar el repositorio, puedes ejecutar los doctests con:

$ python3 -m doctest ./ciuy/__init__.py -v
(several lines ommited)
11 passed and 0 failed.
Test passed.

Usa pytest para ejecutar los tests unitarios:

$ py.test
============================= test session starts ==============================
platform linux -- Python 3.8.1, pytest-5.3.5, py-1.8.1, pluggy-0.13.1
rootdir: /home/ciuy
collected 98 items

tests\test_clean.py ..........                                           [ 10%]
tests\test_command_line.py ........................                      [ 34%]
tests\test_random_ci.py ..                                               [ 36%]
tests\test_validate_ci.py .......................................        [ 76%]
tests\test_validation_digit.py .......................                   [100%]

============================== 98 passed in 1.09s =============================

También es posible usar pytest para correr todos los tests, incluyendo los doctests, con:

$ py.test --doctest-modules

Línea de comandos

Luego de la instalación, los siguientes comandos estarán disponibles:

$ validate_ci 1.234.567-2
True
$ validation_digit 1.234.567
2
$ random_ci
82405816