Metadata-Version: 2.0
Name: postal-address
Version: 1.3.1
Summary: Parse, normalize and render postal addresses.
Home-page: https://github.com/scaleway/postal-address
Author: Scaleway
Author-email: opensource@scaleway.com
License: BSD
Keywords: address,l10n,i18n
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Internationalization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Localization
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Python: >= 2.7, != 3.0.*, != 3.1.*, != 3.2.*
Requires-Dist: Faker (>=0.7.4)
Requires-Dist: boltons
Requires-Dist: pycountry (<16.11.27,>=16.11.08)
Provides-Extra: develop
Requires-Dist: bumpversion; extra == 'develop'
Requires-Dist: isort; extra == 'develop'
Requires-Dist: readme-renderer; extra == 'develop'
Requires-Dist: setuptools (>=24.2.1wheel); extra == 'develop'
Provides-Extra: docs
Requires-Dist: sphinx (>=1.4); extra == 'docs'
Requires-Dist: sphinx-rtd-theme; extra == 'docs'
Provides-Extra: tests
Requires-Dist: coverage; extra == 'tests'
Requires-Dist: nose; extra == 'tests'
Requires-Dist: pycodestyle (>=2.1.0); extra == 'tests'
Requires-Dist: pylint; extra == 'tests'

Postal Address
==============

Python module to parse, normalize and render postal addresses.

Stable release: |release| |versions| |license| |dependencies|

Development: |build| |docs| |coverage| |quality|

.. |release| image:: https://img.shields.io/pypi/v/postal-address.svg
    :target: https://pypi.python.org/pypi/postal-address
    :alt: Last release
.. |versions| image:: https://img.shields.io/pypi/pyversions/postal-address.svg
    :target: https://pypi.python.org/pypi/postal-address
    :alt: Python versions
.. |license| image:: https://img.shields.io/pypi/l/postal-address.svg
    :target: http://opensource.org/licenses/BSD-2-Clause
    :alt: Software license
.. |dependencies| image:: https://requires.io/github/scaleway/postal-address/requirements.svg?branch=master
    :target: https://requires.io/github/scaleway/postal-address/requirements/?branch=master
    :alt: Requirements freshness
.. |build| image:: https://travis-ci.org/scaleway/postal-address.svg?branch=develop
    :target: https://travis-ci.org/scaleway/postal-address
    :alt: Unit-tests status
.. |docs| image:: https://readthedocs.org/projects/postal-address/badge/?version=develop
    :target: http://postal-address.readthedocs.io/en/develop/
    :alt: Documentation Status
.. |coverage| image:: https://codecov.io/gh/scaleway/postal-address/branch/develop/graph/badge.svg
    :target: https://codecov.io/github/scaleway/postal-address?branch=develop
    :alt: Coverage Status
.. |quality| image:: https://scrutinizer-ci.com/g/scaleway/postal-address/badges/quality-score.png?b=develop
    :target: https://scrutinizer-ci.com/g/scaleway/postal-address/?branch=develop
    :alt: Code Quality


Motivation
----------

    « What ties us to territory is tax. »
    -- Kevin Deldycke, 2014-11-07

The reason above is why we need fine-grained and meticulous territory
management and normalization. This project aims to solve this problem once for
all.

Don't get me wrong, this work is a huge undertaking. Postal address parsing,
normalization and rendering is hard. See the collection of `falsehoods
programmers believe about postal addresses
<https://github.com/kdeldycke/awesome-falsehood#postal-addresses>`_.

This library is still in its early stages, but is good enough to implement
the new European Directives on VAT, which requires all e-commerce shops to
guess the locality of their EU customers depending on their billing address.


`Changes for v1.3.1 (2016-12-20) <https://github.com/scaleway/postal-address/compare/v1.3.0...v1.3.1>`_
-------------------------------------------------------------------------------------------------------

.. note:: This version is not yet released and is under active development.

* Fix selection of random locale in ``random_address()``.
* Bump dependency to ``Faker >= 0.7.4``.
* Exclude production of invalid random addresses in ``no_NO`` locale.
* Fix rendering of changelog link in RST.


`Full changelog <https://postal-address.readthedocs.io/en/develop/changelog.html#changelog>`_.

