Parse, normalize and render postal addresses.
Project description
Postal Address
Python module to parse, normalize and render postal addresses.
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 developUpdate revision to its release number and update change log:
vi ./postal_address/__init__.py
vi ./CHANGES.rstCreate 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 pushPush packaging to the test cheeseshop:
python setup.py register -r testpypi
pip install wheel
python setup.py sdist bdist_egg bdist_wheel upload -r testpypiPublish packaging to PyPi:
python setup.py register -r pypi
python setup.py sdist bdist_egg bdist_wheel upload -r pypiBump 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.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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for postal_address-0.3.0-py2-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | fdef08cb5b3aef3804b99aa2c40c5c6a3ce3fe076ebe88f71568d5e50a67f4e1 |
|
| MD5 | 595a35c0b4ad5ccc7d7dd897366aed99 |
|
| BLAKE2b-256 | ebbc04ede15c7771429d335b2064513cd17b2a61732567652a00bbdedf528834 |
