Skip to main content

Parse, normalize and render postal addresses.

Project description

Postal Address

Python module to parse, normalize and render postal addresses.

Last release Unit-tests status Coverage Status Requirements freshness Software license 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 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:

git clone git@github.com:online-labs/postal-address.git
git checkout develop

Update revision to its release number and update change log:

vi ./postal_address/__init__.py
vi ./CHANGES.rst

Create a release commit, tag it and merge it back to master branch:

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:

python setup.py register -r testpypi
pip install wheel
python setup.py sdist bdist_egg bdist_wheel upload -r testpypi

Publish packaging to PyPi:

python setup.py register -r pypi
python setup.py sdist bdist_egg bdist_wheel upload -r pypi

Bump revision back to its development state:

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+).

ChangeLog

0.3.3 (2015-03-25)

  • Fix bad released version.

0.3.2 (2015-03-25)

  • Add backward compatibility to the 0.2 series following territory utils split out of the address module. See #8 and #9.

0.3.1 (2015-03-05)

  • Fix rendering of state in address.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

postal-address-0.3.3.tar.gz (23.5 kB view details)

Uploaded Source

Built Distributions

postal_address-0.3.3-py2.7.egg (19.3 kB view details)

Uploaded Source

postal_address-0.3.3-py2-none-any.whl (22.4 kB view details)

Uploaded Python 2

File details

Details for the file postal-address-0.3.3.tar.gz.

File metadata

File hashes

Hashes for postal-address-0.3.3.tar.gz
Algorithm Hash digest
SHA256 847514e4e5fdf4413779b08c3d67ba14ab9d63b01fefef2a2188b6c0b10b8254
MD5 52051d3ca05deb67118f019b6ffa4c8e
BLAKE2b-256 1d759e12d7f1d8d7213efec0fa5d9b2ab516f8f18a002fc6973b78ca37edf112

See more details on using hashes here.

File details

Details for the file postal_address-0.3.3-py2.7.egg.

File metadata

File hashes

Hashes for postal_address-0.3.3-py2.7.egg
Algorithm Hash digest
SHA256 7ba17fa7d6b78d4e67154492a0bb6eacef7dea38a53d27afc667f7cc89548fe5
MD5 f47a9a56a27a612fd3369800a7047be7
BLAKE2b-256 d24d67b586b552cce3c0f77882471fd912d837a15110e685b17041fa3a86b5c1

See more details on using hashes here.

File details

Details for the file postal_address-0.3.3-py2-none-any.whl.

File metadata

File hashes

Hashes for postal_address-0.3.3-py2-none-any.whl
Algorithm Hash digest
SHA256 2cff984d4d16663551b08e56f30ea53df57e602610185263fc900b26201cbc11
MD5 0c2e957168b1b317d3ccd214f046c141
BLAKE2b-256 3d134502d8dd975787d849233ff396df2a510628ee2e7e825bbe4349ff9b7e91

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page