ambipy-utils 0.2.2

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

ambipy-utils

Pacote interno da Ambipar Carbon

Prerequisitos

• Python 3.12+
• uv

Ambiente de desenvolvimento

Este projeto está configurado para utilizar uv como gerenciador de dependências e ferramentas como ruff, taskipy e pytests para linting, formatação e testes. Ainda conta com pre-commit para rodar os hooks de linting, formatação e algumas verificações uteis antes de cada commit.

Instalação do ambiente de desenvolvimento

# 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

task test  # executa pytest conforme configurado no pyproject.toml

Publicação de novas versões

Para publicar uma nova versão, é necessário criar um novo tag no git e fazer o build do pacote. Com isso, o pacote pode ser publicado no PyPI.

Criar tag:

git tag -a v0.1.0 -m "Release v0.1.0"

Geração de build:

# veja: https://docs.astral.sh/uv/guides/package/
uv build

Publicação no PyPI:

# veja: https://docs.astral.sh/uv/guides/package/#publishing-your-package
uv publish --token <token_pypi>