wehandle-aws-utils 0.1.0

Biblioteca para utilitários relacionados a AWS do time de automação

wehandle-aws-utils

Biblioteca Python interna para utilitários relacionados a AWS do time de automação.

Requisitos

• Python >= 3.11
• uv (gerenciador de pacotes)

Instalação

Para desenvolvimento:

uv sync --dev

Para uso em produção:

uv pip install .

Uso em outros projetos

A biblioteca ainda não é distribuída em um registry PyPI. Enquanto isso, consuma a versão tagueada diretamente do Git utilizando o uv:

uv add "wehandle-aws-utils @ git+ssh://[e-mail]/WeHandle/wehandle-aws-utils.git@v0.1.0"

Substitua v0.1.0 pela tag desejada quando novas versões forem criadas.

Desenvolvimento

Ferramentas

• pytest: Framework de testes
• ruff: Linter e formatador de código
• mypy: Verificação estática de tipos

Executar testes

uv run pytest

Verificar código

uv run ruff check src/
uv run mypy src/

Formatar código

uv run ruff format src/

Funcionalidades Atuais

Utilitários de S3

O módulo wehandle_aws_utils.s3.utils centraliza operações comuns com o Amazon S3 e expõe funções com tolerância a falhas típicas (timeouts, AccessDenied, NoSuchKey):

from wehandle_aws_utils.s3 import utils as s3_utils

local_path = s3_utils.download_file_from_s3("meu-bucket", "dados/arquivo.csv", "/tmp/arquivo.csv")
s3_utils.upload_file_to_s3(local_path, "meu-bucket-processado", "outputs/arquivo.csv")
metadata = s3_utils.get_object_metadata("meu-bucket", "dados/arquivo.csv")

As funções disparam exceções específicas (S3FileNotFoundError, S3AccessDeniedError, S3DownloadError, S3UploadError) para que o chamador possa decidir se deve agendar um retry ou tratar como falha definitiva.

AWS Secrets Manager

O módulo wehandle_aws_utils.secrets_manager.utils encapsula o fluxo recorrente de buscar segredos (como credenciais do Google) e salvá-los no disco com permissões restritas:

from wehandle_aws_utils.secrets_manager import utils as secrets_manager

google_creds = secrets_manager.fetch_secret_json("acesso-google")
secrets_manager.write_secret_to_file("acesso-google", "/tmp/google.json")

Exceções específicas (SecretNotFoundError, SecretAccessDeniedError, SecretDecryptionError, SecretRetrievalError) ajudam o serviço a decidir se deve reprocessar o evento ou falhar definitivamente.

Publicação do Pacote

A action .github/workflows/publish.yml executa lint (ruff), testes (pytest), build e publicação do pacote sempre que um release é publicado ou manualmente.

Fluxo sugerido para lançar uma nova versão interna:

1. Atualize pyproject.toml / __version__.
2. Crie um release tagueado (ex.: v0.2.0) pelo GitHub.
3. A action será executada automaticamente.