Metadata-Version: 2.4
Name: pypncp
Version: 1.1.1
Summary: pypncp — Cliente Python assíncrono para a API de Consulta do PNCP
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.13.4
Requires-Dist: tenacity>=9.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
Requires-Dist: pytest-httpx>=0.35.0; extra == "dev"
Requires-Dist: ruff>=0.11.0; extra == "dev"
Requires-Dist: mypy>=1.15.0; extra == "dev"
Dynamic: license-file

# pypncp

[![CI](https://github.com/gabrielgz0/pypncp/actions/workflows/ci.yml/badge.svg)](https://github.com/gabrielgz0/pypncp/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/pypncp)](https://pypi.org/project/pypncp/)
[![Python Version](https://img.shields.io/pypi/pyversions/pypncp)](https://pypi.org/project/pypncp/)
[![License](https://img.shields.io/pypi/l/pypncp)](https://pypi.org/project/pypncp/)
[![Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/gabrielgz0/.../raw/coverage.json)](https://github.com/gabrielgz0/pypncp/actions)

**Cliente Python assíncrono para a API de Consulta do PNCP** — Portal Nacional de Contratações Públicas.

```python
from pypncp import PNCPClient

async with PNCPClient() as client:
    async for p in client.precos.buscar_precos(
        q="dipirona",
        tipos_documento="edital",
        uf="SP",
    ):
        print(f"{p['descricao']} | {p['fornecedor']} | R$ {p['valor_unitario']}")
```

```bash
uv add pypncp
```

---

Documentação completa em [`docs/`](docs/quickstart.md):

| Seção | Descrição |
|-------|-----------|
| [Quickstart](docs/quickstart.md) | Instalação, exemplos básicos, FastAPI |
| [Paginação](docs/pagination.md) | `list_all*`, prefetch, workers concorrentes |
| **Recursos** | |
| [Contratos](docs/resources/contratos.md) | Consulta de contratos |
| [Contratações](docs/resources/contratacoes.md) | Licitações, publicações, propostas |
| [Atas](docs/resources/atas.md) | Atas de registro de preço |
| [Busca no catálogo](docs/resources/search.md) | Busca full-text em todo o PNCP |
| [Preços homologados](docs/resources/precos.md) | Pipeline busca → itens → preços |
| [Modelos](docs/models.md) | Todos os campos e tipos |
| [Erros](docs/errors.md) | Hierarquia de exceções, retry automático |
| [Contribuindo](docs/contributing.md) | Setup, testes, lint |

Documentação oficial: [Swagger da API PNCP](https://pncp.gov.br/api/pncp/swagger-ui/index.html)

Licença: MIT
