Skip to main content

Constantes

Este módulo centraliza a configuração de variáveis de ambiente utilizadas pela API hidrológica, como a URL base e os endpoints específicos de estações e cotas horárias. Também define parâmetros globais de cache (capacidade máxima e tempo de vida dos itens).

Índice​

  1. Visão Geral
  2. Configuração de Ambiente
  3. Parâmetros de Cache

Visão Geral​

Este módulo tem como objetivo carregar variáveis de ambiente a partir de um arquivo .env e fornecer constantes globais para os demais módulos do sistema.

Funcionalidades principais:

  • Carregamento seguro das configurações via dotenv
  • Validação da variável obrigatória API_URL
  • Definição centralizada dos endpoints utilizados na API
  • Parâmetros de configuração de cache com valores padrão

Configuração de Ambiente​

O módulo utiliza o python-dotenv para carregar variáveis de ambiente.

Exemplo de .env:

API_URL=https://api.hidrobr.example
CACHE_MAXSIZE=100
CACHE_TTL=3600

Parâmetros de Cache​

CACHE_MAXSIZE = int(os.environ.get("CACHE_MAXSIZE", 96)) CACHE_TTL = int(os.environ.get("CACHE_TTL", 3600))