Metadata-Version: 2.4
Name: entirius-py-gov-rejestr-wl-sdk
Version: 2.0.0
Summary: SDK for the Polish government VAT taxpayers registry (Wykaz podatników VAT / GOV Rejestr WL)
Project-URL: Repository, https://github.com/entirius/entirius-py-gov-rejestr-wl-sdk
Author: Entirius
Maintainer-email: Piotr Brzozowski <piotrb@entirius.com>, Paweł Kiełt <cptshooter12@gmail.com>, Mateusz Baran <mateuszbaranpv@gmail.com>, Michał Kloczkowski <michal@kloczkowski.pl>
License-Expression: MPL-2.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: requests>=2.31
Provides-Extra: dev
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Description-Content-Type: text/markdown

# GOV Rejestr WL SDK

SDK for the Polish government VAT taxpayers registry (Wykaz podatników VAT / GOV Rejestr WL) —
a REST client for `wl-api.mf.gov.pl` with NIP/REGON search and address parsing helpers.

## Install

```bash
uv pip install entirius-py-gov-rejestr-wl-sdk
```

Or as a dependency in `pyproject.toml`:

```toml
"entirius-py-gov-rejestr-wl-sdk>=2.0.0"
```

## Use

```python
from gov_rejestr_wl_sdk.services.client import GovRejestrWL

client = GovRejestrWL(use_prod_environment=True)  # False = sandbox API
```

## Development and testing

```bash
make install   # uv sync, incl. extras
make check     # ruff lint + format-check
make test      # pytest
```
