Metadata-Version: 2.1
Name: addrx
Version: 0.1.0
Summary: A Python client for parsing address using Libpostal API service.
Home-page: https://github.com/joydeep-ghatak/AddrX
Author: Joydeep Ghatak
Author-email: joydeep.ghatak007@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: annotated-types (==0.7.0)
Requires-Dist: anyio (==4.8.0)
Requires-Dist: certifi (==2025.1.31)
Requires-Dist: charset-normalizer (==3.4.1)
Requires-Dist: h11 (==0.14.0)
Requires-Dist: httpcore (==1.0.7)
Requires-Dist: httpx (==0.28.1)
Requires-Dist: idna (==3.10)
Requires-Dist: pydantic (==2.10.6)
Requires-Dist: pydantic-core (==2.27.2)
Requires-Dist: requests (==2.32.3)
Requires-Dist: sniffio (==1.3.1)
Requires-Dist: typing-extensions (==4.12.2)
Requires-Dist: urllib3 (==2.3.0)

# AddrX

Python client for parsing address using Libpostal API service.

AddrX is a Python-based client for parsing addresses using the [libpostal](https://github.com/openvenues/libpostal) API service. This service can be used to parse single addresses or a list of addresses both synchronously and asynchronously.

## Features

- Parse single and multiple addresses in a list.
- Supports both synchronous and asynchronous execution.
- Inspired by the [Dripostal](https://github.com/dribia/dripostal) service.

## Installation

You can install AddrX via pip:

```sh
pip install addrx
```

## API Methods

- **`AddrX.single_parser(url: str, address: str, exclude_address_type: list[str] = None)`**

  - Parse a single address.
  - **Parameters**:

    - `url` - The API endpoint for the libpostal service.
    - `address` - Addresses to parse.
    - `exclude_address_type` - A list of address type that is not required | default None **Returns**: Parsed address.

- **`AddrX.parser(url: str, address: str, exclude_address_type: list[str] = None)`**

  - Parses a list of addresses synchronously.
  - **Parameters**:

    - `url` - The API endpoint for the libpostal service.
    - `address_list` - A list of addresses to parse.
    - `exclude_address_type` - A list of address type that is not required | default None

  - **Returns**: List of parsed address.

- **`AddrX.async_parser(url: str, address: str, exclude_address_type: list[str] = None)`**

  - Parses a list of addresses asynchronously.
  - **Parameters**:

    - `url` - The API endpoint for the libpostal service.
    - `address_list` - A list of addresses to parse.
    - `exclude_address_type` - A list of address type that is not required | default None

  - **Returns**: List of parsed address.

## License

This project is licensed under the MIT License.

--------------------------------------------------------------------------------

AddrX is built to simplify address parsing using Libpostal while offering both synchronous and asynchronous capabilities.

Happy coding!


