rjurney/libpostal-docker repository overview

⁠Libpostal Docker

This project provides a simple two-command process to try the Libpostal⁠ address parsing library in its interactive mode.

It also includes the Python pypostal⁠ library for you to try.

⁠TLDR Interactive Mode

This mode lets you type addresses and see how Libpostal parses them. To run it, use the following commands:

docker pull rjurney/libpostal-docker:latest
docker run -it rjurney/libpostal-docker:latest address_parser

⁠Trying the PyPostal Python Library

To run the Libpostal Docker container, you can use the following commands:

docker pull rjurney/libpostal-docker:latest
docker run -it rjurney/libpostal-docker:latest bash

Now run:

ipython

And import and use the pypostal⁠ library:

from postal.parser import parse_address


parse_address("781 Franklin Ave Crown Heights Brooklyn NYC NY 11216 USA")

You should see the result:

Out[2]:
[('781', 'house_number'),
 ('franklin ave', 'road'),
 ('crown heights', 'suburb'),
 ('brooklyn', 'city_district'),
 ('nyc', 'city'),
 ('ny', 'state'),
 ('11216', 'postcode'),
 ('usa', 'country')]

⁠Author

This project was created out of love for Libpostal⁠ by Russell Jurney⁠.