Metadata-Version: 2.1
Name: saudi-id-validator
Version: 1.0.2
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

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

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

|travis| |codecov| |supported-versions| |version|

.. |travis| image:: https://travis-ci.org/dralshehri/saudi-id-validator.svg?branch=master
    :alt: Travis-CI Build Status
    :target: https://travis-ci.org/dralshehri/saudi-id-validator

.. |codecov| image:: https://codecov.io/gh/dralshehri/saudi-id-validator/branch/master/graph/badge.svg
    :alt: Coverage Status
    :target: https://codecov.io/gh/dralshehri/saudi-id-validator

.. |supported-versions| 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 latest release
    :target: https://pypi.python.org/pypi/saudi-id-validator

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

    validate(1071724369)
    # Returns 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.rst`` file.

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

**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.


