Metadata-Version: 2.5
Name: kenya-data
Version: 0.1.2
Summary: Python SDK for Kenyan administrative data (counties, constituencies, wards) bundled as a SQLite database
Project-URL: Homepage, https://github.com/ToshGitonga0/kenya-data
Project-URL: Repository, https://github.com/ToshGitonga0/kenya-data
Project-URL: Issues, https://github.com/ToshGitonga0/kenya-data/issues
Project-URL: Changelog, https://github.com/ToshGitonga0/kenya-data/blob/main/CHANGELOG.md
Author-email: Charles Gitonga <gitongachas@gmail.com>
License: MIT
Keywords: administrative-data,constituencies,counties,geodata,kenya,sdk,sqlite,wards
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# kenya-data (Python SDK)

Install the published package:

```bash
pip install kenya-data
```

```python
from kenya_data import Kenya

kenya = Kenya()                       # loads the bundled data/kenya.db by default
kenya = Kenya(db_path="/path/to/kenya.db")  # or point at a specific build

kenya.counties.list()
kenya.counties.get("Nakuru")
kenya.constituencies.in_county("Nakuru")
kenya.wards.in_constituency("Naivasha")

kenya.dataset.version
kenya.dataset.updated_at
```

The package includes the SQLite database and is backed by the database built
from `database/schema/schema.sql` — see the repository root [README](../../README.md)
and [docs/sdk-design.md](../../docs/sdk-design.md).
