validators - Python Data Validation for Humans
===============================================

.. only:: html

   |PyCQA| |SAST| |Docs| |Version| |Downloads|

.. raw:: html


Python has all kinds of data validation tools, but every one of them
seems to require defining a schema or form. I wanted to create a simple
validation library where validating a simple value does not require
defining a form or a schema.

.. code:: shell

   pip install validators

Then,

.. code:: python

   >>> import validators
   >>>
   >>> validators.email('someone@example.com')
   True

Resources
---------

.. raw:: html


.. raw:: html


- `Documentation `__
- `Bugtracker `__
- `Security `__
- `Code `__

..

   The documentation is published through GitHub Pages on the
   maintainers `fork `__,
   because the maintainer has only contributor access to this repository
   and cannot enable Pages for it.

.. raw:: html


--------------

   **Python 3.11** `reaches EOL in `__
   **October 2027.**

.. raw:: html


.. raw:: html


.. |PyCQA| image:: https://github.com/python-validators/validators/actions/workflows/pycqa.yaml/badge.svg
   :target: https://github.com/python-validators/validators/actions/workflows/pycqa.yaml
.. |SAST| image:: https://github.com/python-validators/validators/actions/workflows/sast.yaml/badge.svg
   :target: https://github.com/python-validators/validators/actions/workflows/sast.yaml
.. |Docs| image:: https://github.com/nandgator/pyvalidators/actions/workflows/pages/pages-build-deployment/badge.svg
   :target: https://github.com/nandgator/pyvalidators/actions/workflows/pages/pages-build-deployment
.. |Version| image:: https://img.shields.io/pypi/v/validators?logo=pypi&logoColor=white&label=version&color=blue
   :target: https://pypi.python.org/pypi/validators/
.. |Downloads| image:: https://img.shields.io/pypi/dm/validators?logo=pypi&logoColor=white&color=blue
   :target: https://pypi.python.org/pypi/validators/


.. toctree::
   :hidden:
   :maxdepth: 2
   :caption: Quick Start:
   :glob:

   install_and_use

.. toctree::
   :hidden:
   :maxdepth: 2
   :caption: API Reference:
   :glob:

   api/*