Metadata-Version: 2.4
Name: ambipy-utils
Version: 0.0.1
Summary: Pacote interno da Ambipar Carbon para manipulação de dados geoespaciais, carbono e tabulares. Inclui suporte para conexão com bancos de dados, templates de e-mail e correção de dados
Author-email: GeoTech <geotech@ambipar.com>
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: geoalchemy2>=0.17.1
Requires-Dist: geopandas>=1.0.1
Requires-Dist: numpy>=2.2.4
Requires-Dist: pandas>=2.2.3
Requires-Dist: psycopg2>=2.9.10
Requires-Dist: sendgrid>=6.11.0
Requires-Dist: shapely>=2.0.7
Requires-Dist: sqlalchemy>=2.0.39
Description-Content-Type: text/markdown

# ambipy-utils
### Pacote interno da Ambipar Carbon

## Prerequisitos
- [Python 3.12+](https://www.python.org/downloads/)
- [uv](https://docs.astral.sh/uv/)

## Ambiente de desenvolvimento

Este projeto está configurado para utilizar [uv](https://docs.astral.sh/uv/) como gerenciador de dependências e ferramentas como [ruff](https://docs.astral.sh/ruff/), [taskipy](https://github.com/taskipy/taskipy) e [pytests](https://docs.pytest.org/) para linting, formatação e testes. Ainda conta com [pre-commit](https://pre-commit.com/) para rodar os hooks de linting, formatação e algumas verificações uteis antes de cada commit.

## Instalação do ambiente de desenvolvimento

```bash
# instalação e/ou sincronização do ambiente virtual (.venv por padrão)
uv sync

# instalação do pre-commit
pre-commit install

# adicionar dependências ao ambiente virtual
# veja: https://docs.astral.sh/uv/concepts/projects/dependencies/#development-dependencies
uv add <dependencia>
uv add --dev  <dependencia>  # para dependências de desenvolvimento

# fazer o build do projeto e ter o instalável do pacote
# veja: https://docs.astral.sh/uv/concepts/projects/build/
uv build
```

## Executando os testes

```bash
task test  # executa pytest conforme configurado no pyproject.toml
```

Documentação em construção...
