Metadata-Version: 1.1
Name: postal-address
Version: 0.3.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+
Description: 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 the
        famous `Falsehoods programmers believe about addresses
        <http://www.mjt.me.uk/posts/falsehoods-programmers-believe-about-addresses/>`_
        pamphlet.
        
        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.
        
        
        Release process
        ---------------
        
        Start from the ``develop`` branch:
        
        .. code-block:: bash
        
            git clone git@github.com:online-labs/postal-address.git
            git checkout develop
        
        Update revision to its release number and update change log:
        
        .. code-block:: bash
        
            vi ./postal_address/__init__.py
            vi ./CHANGES.rst
        
        Create a release commit, tag it and merge it back to ``master`` branch:
        
        .. code-block:: bash
        
            git add ./postal_address/__init__.py ./CHANGES.rst
            git commit -m "Release vXX.XX.XX"
            git tag "vXX.XX.XX"
            git push
            git push --tags
            git checkout master
            git pull
            git merge "vXX.XX.XX"
            git push
        
        Push packaging to the test cheeseshop:
        
        .. code-block:: bash
        
            python setup.py register -r testpypi
            pip install wheel
            python setup.py sdist bdist_egg bdist_wheel upload -r testpypi
        
        Publish packaging to PyPi:
        
        .. code-block:: bash
        
            python setup.py register -r pypi
            python setup.py sdist bdist_egg bdist_wheel upload -r pypi
        
        Bump revision back to its development state:
        
        .. code-block:: bash
        
            git checkout develop
            vi ./postal_address/__init__.py
            vi ./CHANGES.rst
            git add ./postal_address/__init__.py ./CHANGES.rst
            git commit -m "Post release version bump."
        
        
        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.3.0 (2015-03-04)
        ------------------
        
        * Remove backward compatibility with 0.1.0.
        * Allow direct import of classes from module root.
        * Split territory utils out to their own file. See #3.
        * Rename ``normalize_country_code`` to ``country_from_subdivision``. Mark the
          former as deprecated.
        * Address normalization is now non-blocking. It simply reset invalid components
          to None. Only a call to ``validate`` method check data consistency.
        
        
        0.2.1 (2014-12-22)
        ------------------
        
        * Push a new release to fix cached desynced packages on cheeseshops and clones.
        
        
        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.
        
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
