addresscleaner

# Betwen the Bars address cleaner

This is a simple library to clean and normalize textual addresses.  It is
biased toward the sorts of addresses people in prison are given.

## Example usage

    from addresscleaner import parse_address, format_address

    >>> parsed = parse_address("""John Dough
    ... #1234567
    ... 7819 228th St.
    ... Raiford, FL 32026-1120""")
    >>> print parsed
    {'name': 'John Dough', 'address1': '#1234567', 'address2': '7819 228th St.', 'city': 'Raiford',  'state': 'FL', 'zip': '32026-1120'}

    >>> format_address(parsed)
    u'John Dough\n#1234567\n7819 228th St.\nRaiford, FL  32026-1120'

An exception of type ``addresscleaner.AddressException`` is raised if the
parser is unable to figure out something about the address.  The exception's
message tries to explain as much as possible where it went wrong.