Metadata-Version: 2.4
Name: address-finder-data
Version: 1.0.3
Summary: Companion data package for address-finder (libpostal model files)
Author: Karthikeyan Balasundaram
License: MIT
Project-URL: Homepage, https://github.com/karthikbd/address-finder
Project-URL: Source Code, https://github.com/karthikbd/address-finder
Project-URL: Repository, https://github.com/karthikbd/address-finder
Project-URL: Bug Tracker, https://github.com/karthikbd/address-finder/issues
Project-URL: Documentation, https://github.com/karthikbd/address-finder#readme
Keywords: address-finder,address parser,offline,libpostal,data,geocode
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: address-finder-data-p00>=1.0.2
Requires-Dist: address-finder-data-p01>=1.0.2
Requires-Dist: address-finder-data-p02>=1.0.2
Requires-Dist: address-finder-data-p03>=1.0.2
Requires-Dist: address-finder-data-p04>=1.0.2
Requires-Dist: address-finder-data-p05>=1.0.2
Requires-Dist: address-finder-data-p06>=1.0.2
Requires-Dist: address-finder-data-p07>=1.0.2
Requires-Dist: address-finder-data-p08>=1.0.2
Requires-Dist: address-finder-data-p09>=1.0.2
Requires-Dist: address-finder-data-p10>=1.0.2
Requires-Dist: address-finder-data-p11>=1.0.2

# address-finder-data

Companion data package (~1.9 GB of libpostal model files) for
[address-finder](https://pypi.org/project/address-finder/).

## Install

```
pip install address-finder address-finder-data
```

## Usage

On first use after installation, call `assemble()` to decompress the
data into your local cache:

```python
import address_finder_data
address_finder_data.assemble()   # one-time decompression ~1.9 GB

import address_finder
address_finder.expand_address("123 main st")
```

Or simply import `address_finder` — it will auto-detect that
`address-finder-data` is installed and assemble the files on first use.

## Details

- Contains 12 compressed data chunk packages
- Total compressed size: ~824 MB across all chunks
- Decompressed size: ~1.9 GB (stored in `~/.cache/address_finder/v1.0.0/`)
- No internet access needed after install
- Data format: lzma/xz (Python stdlib, no extra dependencies)
