Metadata-Version: 2.1
Name: saudi-id-validator
Version: 1.0.3
Summary: Validate ID numbers of Saudi Arabian identity cards
Home-page: https://github.com/dralshehri/sa-id-validator
Author: Mohammed Alshehri
Author-email: 
License: MIT
Keywords: saudi government validator identity number
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Utilities
Requires-Python: >=3.5
Description-Content-Type: text/x-rst

Saudi ID Validator
==================

A Python package to validate ID numbers of Saudi Arabian identity cards for
both citizens and residents.

|travis| |codecov| |supported| |version| |license|

.. |travis| image:: https://img.shields.io/travis/dralshehri/saudi-id-validator.svg
   :alt: Build Status
   :target: https://travis-ci.org/dralshehri/saudi-id-validator

.. |codecov| image:: https://img.shields.io/codecov/c/github/dralshehri/saudi-id-validator.svg
   :alt: Coverage Status
   :target: https://codecov.io/github/dralshehri/saudi-id-validator

.. |supported| image:: https://img.shields.io/pypi/pyversions/saudi-id-validator.svg
   :alt: Supported versions
   :target: https://pypi.python.org/pypi/saudi-id-validator

.. |version| image:: https://img.shields.io/pypi/v/saudi-id-validator.svg
   :alt: PyPI Package version
   :target: https://pypi.python.org/pypi/saudi-id-validator

.. |license|
   image:: https://img.shields.io/github/license/dralshehri/saudi-id-validator.svg
   :alt: License
   :target: https://github.com/dralshehri/saudi-id-validator/blob/master/LICENSE

The validation formula is based on `Luhn algorithm`_ which is in wide use
today by many governments to distinguish valid numbers from mistyped or
otherwise incorrect numbers.

.. _`Luhn algorithm`: https://en.wikipedia.org/wiki/Luhn_algorithm

Installation
------------

.. code-block:: bash

    $ pip install saudi-id-validator

Basic Usage
-----------

To validate an ID:

.. code:: python

    from saudi_id_validator import validate

    v = validate(1071724369)
    print(v)
    # False

The `validate` method will return a boolean (``True`` or ``False``) indicating whether
ID is valid or not.

License
-------

This package is distributed under an MIT licence. See `LICENSE`_ file.

.. _LICENSE: https://github.com/dralshehri/saudi-id-validator/blob/master/LICENSE

Change Log
----------

**1.0.3 (2019-05-22)**

- Updated usage example.
- Updated README badges.
- Removed LICENSE file extension.

**1.0.2 (2018-11-18)**

- Improved README content.

**1.0.1 (2018-12-06)**

- Fixed some typos in README file.

**1.0.0 (2018-11-18)**

- First release.


