Boas Práticas da Biblioteca Padrão

Utilize os módulos "batteries-included" antes de recorrer ao PyPI - e saiba quando a biblioteca padrão não é suficiente.

Como Usar Esta Lista

• Verifique a biblioteca padrão durante a revisão de design antes de adicionar dependências.
• Documente "escape hatches" quando o PyPI for escolhido (httpx, pydantic, argon2).
• Fixe os recursos da versão do Python para o manifesto (3.14) na documentação da equipe.

A - Seleção

• Tente pathlib + json + logging antes de micro-pacotes. A maioria dos scripts não precisa de mais nada.
• Adicione PyPI quando a biblioteca padrão carecer de recursos ou ergonomia na sua escala. HTTP/2, validação, hashing de senha.
• Prefira tomllib para TOML a partir do 3.11+. Alinhe-se com o ecossistema pyproject.toml e uv 0.6+.
• Use zoneinfo + datetimes UTC cientes. Instale tzdata em implantações Windows.
• argparse é suficiente para CLIs internas; typer quando a UX importa. Scripts sem dependências permanecem com argparse.

B - Segurança

• subprocess com argumentos em lista, shell=False por padrão. Audite qualquer shell=True com entrada do usuário.
• secrets para tokens; nunca o módulo random. Links de sessão e redefinição usam CSPRNG.
• Nunca use sha256 sozinho para senhas. Use argon2/bcrypt através de bibliotecas estabelecidas.
• json.loads de entrada não confiável com limites de tamanho. Evite DoS por payload gigante.
• Padrões re revisados para backtracking catastrófico. Use timeout ou simplifique o padrão.

C - Arquivos e Tempo

• Objetos Path e codificação utf-8 explícita em I/O de texto. Sem concatenação de caminhos em string.
• Armazene UTC; converta com zoneinfo para exibição. Rejeite datetimes ingênuos no domínio.
• hashlib.file_digest ou atualização em blocos para arquivos grandes. Não leia multi-GB para RAM.
• Precedência de configuração: CLI > env > arquivo > padrões. Documente a ordem no README.
• Sem segredos em INI commitados no git. Injeção de ambiente para chaves.

D - Ergonomia

• dataclass + StrEnum para DTOs internos; Pydantic na borda da API. Limite de validação claro.
• contextmanager para escopos pequenos; ExitStack para muitos. Teardown garantido.
• itertools com cadeias preguiçosas para iteráveis grandes. Use islice/batched em vez de materializar listas.
• functools.lru_cache apenas em funções puras hashable. Sem cache ilimitado em argumentos ilimitados.
• Compile regex na importação para caminhos críticos. Use grupos nomeados para manutenibilidade.

E - Operações

• logging configurado no main, não em bibliotecas. Bibliotecas usam getLogger(__name__).
• subprocess com timeouts em todas as chamadas de serviço. Sem processos filhos travados.
• uuid4 para IDs opacos; considere uuid7 para localidade de banco de dados a partir do 3.14+. Corresponda ao tipo de armazenamento.
• compare_digest para comparações de segredos. Verificações seguras contra tempo.
• Reavalie a biblioteca padrão a cada atualização do Python. Novas baterias (tomllib, batched, uuid7) podem remover dependências.

FAQs

Relacionados

• Visão Geral da Biblioteca Padrão - mapa de módulos
• pathlib & os - sistema de arquivos
• hashlib, secrets & uuid - higiene criptográfica
• Boas Práticas de Erros e Logging - política de logging

Versões da Stack: Esta página foi escrita para Python 3.14.0 (3.14 estável, 3.13 em manutenção), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, e uv 0.6+.