Metadata-Version: 2.1
Name: teritorio
Version: 2022.10.10
Summary: A library for country and currency ISO codes
Home-page: https://github.com/spapanik/teritorio
License: LGPL-3.0+
Keywords: iso,currency,country
Author: Stephanos Kuma
Author-email: stephanos@kuma.ai
Requires-Python: >=3.7.0,<4.0.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Project-URL: Repository, https://github.com/spapanik/teritorio
Description-Content-Type: text/x-rst

=================================================
teritorio: ISO codes for countries and currencies
=================================================

.. image:: https://github.com/spapanik/teritorio/actions/workflows/build.yml/badge.svg
  :alt: Build
  :target: https://github.com/spapanik/teritorio/actions/workflows/build.yml
.. image:: https://img.shields.io/lgtm/alerts/g/spapanik/teritorio.svg
  :alt: Total alerts
  :target: https://lgtm.com/projects/g/spapanik/teritorio/alerts/
.. image:: https://img.shields.io/github/license/spapanik/teritorio
  :alt: License
  :target: https://github.com/spapanik/teritorio/blob/main/LICENSE.txt
.. image:: https://img.shields.io/pypi/v/teritorio
  :alt: PyPI
  :target: https://pypi.org/project/teritorio
.. image:: https://pepy.tech/badge/teritorio
  :alt: Downloads
  :target: https://pepy.tech/project/teritorio
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
  :alt: Code style
  :target: https://github.com/psf/black

``teritorio`` two iterable singletons that ``Countries`` and ``Currencies``, that contain all the
relevant ISO information about countries and currencies, respectively.

In a nutshell
-------------

Installation
^^^^^^^^^^^^

The easiest way is to use `poetry`_ to manage your dependencies and add *teritorio* to them.
It requires Python 3.7.0+ to run.

.. code-block:: toml

    [tool.poetry.dependencies]
    teritorio = "*"

It is advised to always use the latest release, so that you'll get the latest ISO codes

Usage
^^^^^

There are two iterable singletons that can be imported from ``teritorio``: ``Countries`` and ``Currencies``.

.. code:: python

    from teritorio import Countries
    from teritorio import Currencies

Versioning
----------

The project project adheres to `Calendar Versioning`_.
The reason is that the data are dominated by political decisions,
making semantic versioning largely irrelevant.

Links
-----

- `Documentation`_
- `Changelog`_


.. _Calendar Versioning: https://calver.org
.. _poetry: https://python-poetry.org/
.. _Changelog: https://github.com/spapanik/teritorio/blob/main/CHANGELOG.rst
.. _Documentation: https://teritorio.readthedocs.io/en/latest/

