Metadata-Version: 2.1
Name: ciuy
Version: 1.0.0
Summary: Python package for validating Uruguayan identity document numbers.
Home-page: https://github.com/ismaelpadilla/ciuy_py
Author: Ismael Padilla
Author-email: padillaismael92@gmail.com
License: MIT
Project-URL: Documentation, https://ciuy.readthedocs.io/
Description: # ciuy
        
        🇺🇾 🇪🇸 Documentación en español disponible [aquí](https://ciuy.readthedocs.io/es/latest/) / Spanish documentation is available [here](https://ciuy.readthedocs.io/es/latest/).
        
        ----
        
        Package for validating Uruguayan identity document numbers. Full documentation is available [here](https://ciuy.readthedocs.io/es/latest/).
        
        The functions in this package work with strings and ignore any non-digit characters. Numbers are valid too. So for example, the following expressions represent the same document number:
        
        ```
        '1.234.567-2'
        '12345672'
        12345672
        ```
        
        This package includes the following functions:
        
        `validate_ci(ci: str) -> bool`: Returns true if `ci` is a valid document number, returns false otherwise. `ci` is a string which represents a document number, including the validation digit. `ci` can be a number as well.
        
        `validation_digit(ci: str) -> str`: Returns the validation digit for `ci`.
        
        `random() -> str`: Returns a random document number (including validation digit) in the (100.000, 9.999.999) range.
        
        # Installation
        
        ```
        $ pip install ciuy
        ```
        
        # Usage
        
        ```
        >>> import ciuy
        >>> ciuy.validate_ci("1.234.567-2")
        True
        >>> ciuy.validation_digit("1.234.567")
        '2'
        >>> ciuy.random()
        '82405816'
        ```
        
        # Testing
        
        This package includes some doctests, as well as unit tests that can be run with `pytest`.
        
        After cloning the repository, you can run the doctests with:
        
        ```
        $ python3 -m doctest ./ciuy/__init__.py -v
         (several lines ommited)
        11 passed and 0 failed.
        Test passed.
        ```
        
        Use `py.test` to run the unit tests:
        
        ```
        $ 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 =============================
        ```
        
        You can also use `pytest` to run all tests, including doctests, with:
        
        ```
        $ py.test --doctest-modules
        ```
        
        # Command line
        
        After installation, the following commands become available:
        
        ```
        $ validate_ci 1.234.567-2
        True
        $ validation_digit 1.234.567
        2
        $ random_ci
        82405816
        ```
        
        ---
        
        Based on the ci_uy Ruby gem by Fernando Briano ([link](https://github.com/picandocodigo/ci_uy)).
        
Keywords: Uruguay,dni,id,eid,validation,cédula,cédula uruguaya
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.4
Description-Content-Type: text/markdown
