Metadata-Version: 2.0
Name: postal-address
Version: 0.2.0
Summary: Parse, normalize and render postal addresses.
Home-page: http://github.com/online-labs/postal-address
Author: Online Labs
Author-email: opensource@labs.online.net
License: GPLv2+
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
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.4
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Localization
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Dist: awesome-slugify
Requires-Dist: pycountry (>=1.9)

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

Python module to parse, normalize and render postal addresses.

.. image:: https://img.shields.io/pypi/v/postal-address.svg?style=flat
    :target: https://pypi.python.org/pypi/postal-address
    :alt: Last release
.. image:: https://img.shields.io/travis/online-labs/postal-address/develop.svg?style=flat
    :target: https://travis-ci.org/online-labs/postal-address
    :alt: Unit-tests status
.. image:: https://img.shields.io/coveralls/online-labs/postal-address/develop.svg?style=flat
    :target: https://coveralls.io/r/online-labs/postal-address?branch=develop
    :alt: Coverage Status
.. image:: https://img.shields.io/requires/github/online-labs/postal-address/master.svg?style=flat
    :target: https://requires.io/github/online-labs/postal-address/requirements/?branch=master
    :alt: Requirements freshness
.. image:: https://img.shields.io/pypi/l/postal-address.svg?style=flat
    :target: https://www.gnu.org/licenses/gpl-2.0.html
    :alt: Software license
.. image:: https://img.shields.io/pypi/dm/postal-address.svg?style=flat
    :target: https://pypi.python.org/pypi/postal-address#downloads
    :alt: Popularity


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. Much harder than you think. Please read:
http://www.mjt.me.uk/posts/falsehoods-programmers-believe-about-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.


License
-------

This software is licensed under the `GNU General Public License v2 or later
(GPLv2+)
<https://github.com/online-labs/postal-address/blob/master/LICENSE>`_.

ChangeLog
=========

0.2.0 (2014-12-18)
------------------

* Package the whole module for proper distribution.

0.1.1 (2014-12-16)
------------------

* Restore partial backward compatibility with address module from 0.1.0.


0.1.0 (2014-12-15)
------------------

* First public release.


0.0.0 (2013-12-06)
------------------

* First commit.


