Metadata-Version: 2.4
Name: agecheck
Version: 0.1.0
Summary: Date-of-birth / age-threshold utility with timezone-correct date math.
Project-URL: Homepage, https://github.com/coldbricks/agecheck
Project-URL: Repository, https://github.com/coldbricks/agecheck
Project-URL: Issues, https://github.com/coldbricks/agecheck/issues
Author-email: Coldbricks <coldbricks@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: age,compliance,date-of-birth,dob,timezone
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# agecheck

Date-of-birth / age-threshold utility with timezone-correct date math. Answer
whether someone meets a jurisdiction minimum age using the calendar date in
that jurisdiction's timezone.

## Install

```bash
pip install agecheck
```

## Usage

```python
from datetime import date
from agecheck import is_of_age, age_on

dob = date(2000, 6, 15)
assert is_of_age(dob, 18, on=date(2018, 6, 15), tz="UTC") is True
assert is_of_age(dob, 18, on=date(2018, 6, 14), tz="UTC") is False
assert age_on(dob, on=date(2026, 6, 15), tz="UTC") == 26
```

## Roadmap

This is an early **0.1.0** release with active development planned:

- Jurisdiction preset table (US states, EU defaults)
- Optional document-level verification helpers
- Stricter input parsing modes

## Author

Coldbricks — coldbricks@gmail.com
