Pyap2 is a maintained fork of pyap, a regex-based library for parsing US, CA, and UK addresses. The fork adds typing support, handles more address formats and edge cases.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for argyle from gravatar.com argyle

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT)
  • Author: Argyle Developers
  • Tags address , parser , regex
  • Requires: Python <4.0, >=3.9
Classifiers
Report project as malware

Project description

Pyap2 is a maintained fork of Pyap, a regex-based python library for detecting and parsing addresses. Currently it supports US 🇺🇸, Canadian 🇨🇦 and British 🇬🇧 addresses.

>>> import pyap
>>> test_address = """
    Lorem ipsum
    225 E. John Carpenter Freeway,
    Suite 1500 Irving, Texas 75062
    Dorem sit amet
    """
>>> addresses = pyap.parse(test_address, country='US')
>>> for address in addresses:
        # shows found address
        print(address)
        # shows address parts
        print(address.as_dict())
...

Installation

To install Pyap2, simply:

$ pip install pyap2

About

We started improving the original pyap by adopting poetry and adding typing support. It was extensively tested in web-scraping operations on thousands of US addresses. Gradually, we added support for many rarer address formats and edge cases, as well as the ability to parse a partial address where only street info is available.

Typical workflow

Pyap should be used as a first thing when you need to detect an address inside a text when you don’t know for sure whether the text contains addresses or not.

Limitations

Because Pyap2 (and Pyap) is based on regular expressions it provides fast results. This is also a limitation because regexps intentionally do not use too much context to detect an address.

In other words in order to detect US address, the library doesn’t use any list of US cities or a list of typical street names. It looks for a pattern which is most likely to be an address.

For example the string below would be detected as a valid address: “1 SPIRITUAL HEALER DR SHARIF NSAMBU SPECIALISING IN”

It happens because this string has all the components of a valid address: street number “1”, street name “SPIRITUAL HEALER” followed by a street identifier “DR” (Drive), city “SHARIF NSAMBU SPECIALISING” and a state name abbreviation “IN” (Indiana).

The good news is that the above mentioned errors are quite rare.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for argyle from gravatar.com argyle

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT)
  • Author: Argyle Developers
  • Tags address , parser , regex
  • Requires: Python <4.0, >=3.9
Classifiers

Release history Release notifications | RSS feed

This version

0.2.1

0.2.0

0.1.18

0.1.17

0.1.16

0.1.15

0.1.14

0.1.13

0.1.12

0.1.11

0.1.10

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

0.0.1

Download files

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

Source Distribution

pyap2-0.2.1.tar.gz (19.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyap2-0.2.1-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

Details for the file pyap2-0.2.1.tar.gz.

File metadata

  • Download URL: pyap2-0.2.1.tar.gz
  • Upload date:
  • Size: 19.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pyap2-0.2.1.tar.gz
Algorithm Hash digest
SHA256 0b2184616ddb05f01c6e63c2bff18384db5063124e7da56416d58c82b1205c8b
MD5 069c43c514cbbc625de07df5260852de
BLAKE2b-256 4cd20d0696b522cd5f91f8683ea4e84d5eace3c3b78ad4b5db3792b731131d93

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyap2-0.2.1.tar.gz:

Publisher: publish-to-pypi.yml on argyle-engineering/pyap

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pyap2-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: pyap2-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 23.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pyap2-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cfd18526d0927519faae08c861210f79ee760dfbaa884ea91bfcb2730ec778e8
MD5 2d7a9931b0f17252e4bcd725352549be
BLAKE2b-256 31283c3f77b9a25ff434fd7178d6377f872bf2190f5794abaa8d3a331538e31a

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyap2-0.2.1-py3-none-any.whl:

Publisher: publish-to-pypi.yml on argyle-engineering/pyap

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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