Pular para conteúdo

Alterações

🕑 Changelogs

Versão 0.6.0 (2026-10-29)

⚡ NOVAS FUNCIONALIDADES

  • A lista de aplicações pode ser recolhida e redimensionada, e a largura escolhida é lembrada. O painel de parâmetro fecha ao clicar no vazio da área de conteúdo ou com Esc.
  • Aplicações e parâmetros ganharam filtro: digite para buscar por nome, descrição ou tipo, e tecle Enter para fixar o termo como etiqueta — vários termos se acumulam. Parâmetros também filtram por tipo, e o contador mostra quantos de quantos estão à vista.
  • Avisos do catálogo de tipos aparecem na tela ao salvar um parâmetro — limite de comprimento, faixa de valor, tipo desconhecido. Continuam sendo conselho e não impedem a gravação: quem valida de verdade é o servidor. Antes só existiam no log.
  • Cada tipo de parâmetro ganhou o editor que lhe cabe: listas e dicionários com linhas que se adicionam e removem, booleano como par de botões, data e hora com o seletor do sistema, referência escolhendo entre os parâmetros que existem no aplicativo, e usuários numa tabela. Digitar JSON à mão deixou de ser necessário fora do tipo json.
  • Gerencie parâmetros por um aplicativo de desktop, instalado com pip install "param-manager[front]" e aberto pelo comando param-manager-front. Ele cobre aplicações e parâmetros, o plano de sincronização e o catálogo de tipos, em português e inglês, com tema claro e escuro. Disponível do Python 3.11 ao 3.13.
  • Liste os parâmetros de uma aplicação com tipo, descrição e estado de sincronização, sem trazer os valores, por api.list_params.
  • O painel de detalhe mostra os limites, o estado de sincronização, a data da última alteração e a recusa que o servidor tenha registrado. Aplicações e parâmetros ganharam navegação por páginas.
  • Os tipos json e pattern passam a ser editados num campo com numeração de linha e realce de sintaxe, com o mesmo tratamento para os dois.
  • Valores que não cabem no painel lateral — json, pattern, user e users — ganharam um botão que abre o editor em tela larga.

🚀 OTIMIZAÇÕES

  • A biblioteca passa a instalar em qualquer Python a partir do 3.10, sem limite superior. Antes, o limite declarado recusava até as correções do 3.14, como o 3.14.1. O extra front continua indisponível a partir do 3.14, porque o componente nativo de que ele depende ainda não publica pacote para essas versões.
  • A descrição da aplicação aparece acima da tabela, e o painel de detalhe passa a mostrar aplicação e tipo junto aos demais metadados. As datas são exibidas em linguagem corrente — "há 2 horas" —, com a data exata ao repousar o ponteiro. Criar uma aplicação leva direto para a aba de parâmetros.
  • A edição de usuários virou uma tabela com cabeçalho e um interruptor de status que mostra por escrito se está ativo ou inativo. O editor expandido ficou maior e com tratamento de editor de código para json e pattern.
  • A marca ficou alinhada ao título na barra superior, as tabelas ganharam linhas em zebra no roxo do produto, e a descrição virou um campo de várias linhas onde ela costuma precisar.
  • A paginação passou a numerar as páginas e a permitir escolher quantas linhas exibir. Listas, dicionários e usuários dentro de um parâmetro também paginam, em vez de crescer até empurrar os botões para fora da tela.
  • A tela de sessão esconde URL, usuário e senha quando o modo escolhido é o local, onde não há rede, e explica onde os parâmetros serão gravados.
  • Ações e listas ganharam ícones, que acompanham o rótulo e seguem a cor do tema em uso.
  • Excluir uma aplicação ou um parâmetro passa a exigir que o nome seja digitado. O aviso também diz quantos parâmetros vão junto ao excluir uma aplicação.
  • Nome de aplicação e chave de parâmetro passam a trocar espaços por hífen enquanto se digita, já que viram parte do endereço no servidor.
  • O aplicativo passa a usar a marca e o roxo do Param Manager, os mesmos do site de documentação.
  • O editor de json e pattern abre um pouco mais alto e levemente mais estreito que os demais campos.
  • O editor de json e pattern perdeu o contorno duro que aparecia no tema escuro. O formulário de usuário ficou contido e centrado, com o identificador como etiqueta em vez de campo. Listas, dicionários e segredos ganharam moldura própria, e os campos numéricos perderam as setas de incremento.
  • Texto maior, linhas de tabela mais folgadas e contraste ampliado nos dois temas. O tema passa a ser trocado por um botão de ícone que percorre sistema, claro e escuro, e cada tipo de parâmetro ganhou um ícone próprio na listagem.
  • Usuários ganharam identificador gerado automaticamente, garantidamente sem repetição, exibido na tabela e no formulário. O formulário de usuário passou a seguir o mesmo desenho do painel administrativo web.

🐛 CORREÇÕES

  • A coluna "atualizado" volta a mostrar a data em modo remoto, e no fuso certo. Ela aparecia como travessão, e antes disso como uma hora no futuro, porque o carimbo do servidor é UTC e vinha sem essa marcação.
  • A janela deixa de quebrar ao ser reduzida: a lista de aplicações vira uma gaveta, o cabeçalho reorganiza os controles e a tabela rola dentro da própria área. Os diálogos ganharam tamanho confortável e transição de entrada.
  • A tela deixa de ficar em branco quando a janela é reduzida ao limite com a lista de aplicações recolhida.
  • As barras de rolagem deixam de ficar claras no tema escuro.
  • Campos de número inteiro deixam de aceitar e, letras e sinais fora de lugar. Antes um valor como 12e5 era gravado como 12, silenciosamente.
  • Conectar uma sessão que já existe, escolhendo outro modo, deixa de anunciar sucesso. O front agora explica que a instância continua no modo anterior e oferece um nome novo para abrir a sessão no modo pedido.
  • Corrija o front desktop instalado a partir do wheel, que abria sem ícones, sem rótulos e sem opções nos seletores: um comentário do código carregava por coincidência a assinatura de arquivo tar num byte que o protocolo interno do aplicativo usa para adivinhar o tipo de conteúdo, fazendo o navegador recusar aquele módulo e, em cascata, quase toda a tela.
  • Editar um parâmetro pelo front deixa de apagar os campos que o formulário não mostra. user_editable, os limites e os parâmetros referenciados eram perdidos ao salvar, sem nenhum aviso.
  • Excluir uma aplicação deixa de manter aberto o painel de um parâmetro que já não existe. Trocar de aplicação também descarta a edição em andamento, que antes seguia oferecendo salvar num parâmetro de outro lugar.
  • Trocar o tema ou a página deixa de reconstruir a tela inteira: o que estava sendo editado no painel de parâmetro é preservado, sem o piscar do redesenho.

📂 DOCUMENTAÇÃO

  • A documentação ganhou as páginas de Configuração, com todas as variáveis de ambiente e a ordem de precedência, e do Front desktop. O README, que é também a página do pacote no PyPI, deixou de descrever a biblioteca como singleton e de prometer cache de uma hora, e passou a exibir o fluxograma do cliente também no PyPI. O tutorial corrige uma promessa: metadados omitidos em upsert_params só são preservados quando o servidor roda com USER_EDITABLE_ENFORCEMENT=explicit.

🏛 INFRAESTRUTURA

  • A auditoria de vulnerabilidades passa a separar a ferramenta do pacote auditado e a rodar em dois pisos: o da biblioteca (3.10) e o do extra front (3.11). Antes, falhas nas dependências da própria ferramenta reprovavam a auditoria sem nunca chegar a quem instala a biblioteca, e o extra era auditado num Python em que ele já não pode ser instalado.

Versão 0.5.0 (2026-08-10)

⚠ MUDANÇAS QUEBRADAS

  • Eleve a versão mínima de Python para 3.10. A correção da vulnerabilidade PYSEC-2026-2270 está em uma versão do python-dotenv publicada apenas para 3.10 ou superior; as versões alcançáveis em 3.8 e 3.9 continuam expostas, e mantê-las significaria distribuir a falha.

⚡ NOVAS FUNCIONALIDADES

  • Agora é possível desenvolver sem subir o servidor. Passando mode='local' — ou definindo PARAM_MANAGER_MODE=local — as mesmas funções de sempre (create_app, upsert_params, delete_param, delete_app, get_param, get_all_params) passam a trabalhar num arquivo local, sem nenhuma chamada de rede. O padrão continua sendo o servidor, então quem não pedir nada não percebe diferença.

Parâmetros dos tipos secret, user e users não podem ser criados nesse modo: a cifragem acontece no servidor, e gravá-los localmente significaria guardar o valor em claro. A tentativa falha com uma mensagem explicando isso.

Também foi acrescentada a função list_apps(), que lista as aplicações nos dois modos. - Base para o modo de desenvolvimento local: a biblioteca passou a manter um arquivo próprio, ao lado do cache, para guardar parâmetros criados sem o servidor. Ele é separado de propósito — a limpeza automática do cache, que acontece quando a API responde algo ilegível, não alcança o que você ainda não sincronizou. Ainda sem efeito visível: nenhuma função pública usa esse arquivo nesta versão. - No modo local, a biblioteca passou a avisar quando um valor provavelmente será recusado pelo servidor — comprimento acima do limite, número fora da faixa ou tipo desconhecido. O aviso não impede a gravação: quem valida de verdade continua sendo o servidor, na sincronização. Serve para o erro aparecer na hora, e não no fim de uma sessão inteira de trabalho offline.

A nova função refresh_type_catalog() busca no servidor a lista de tipos aceitos e os limites padrão, guardando-a para uso offline. Sem ela, vale uma cópia embarcada, que pode ficar desatualizada. - Novo módulo param_manager.api, pensado para aplicações com interface gráfica. Ele expõe as mesmas operações em funções que sempre devolvem um dicionário simples com ok indicando sucesso ou falha, em vez de lançar exceções — o que evita que um erro atravesse a ponte entre a interface e o Python como um rastreamento de pilha.

Os dados devolvidos são cópias independentes, então alterá-los na interface não afeta o estado interno da biblioteca.

As funções são bloqueantes: chame-as fora do laço de eventos da interface, sob pena de a janela travar durante uma requisição ou a leitura de um parâmetro protegido. - Os parâmetros criados no modo local agora podem ser enviados ao servidor. A sincronização acontece em duas etapas: sync_plan() mostra o que seria feito — o que será criado, o que será atualizado e o que está em conflito — sem tocar em nada; sync_apply() executa apenas o que foi apresentado no plano.

Conflito nunca é resolvido sozinho. Quando o mesmo parâmetro mudou dos dois lados, ele fica de fora e é apresentado com os dois valores, para que a decisão seja de quem está operando.

Um parâmetro recusado pelo servidor permanece guardado localmente, com a mensagem exata que o servidor devolveu, e os demais continuam sendo enviados normalmente. Falta de permissão é tratada de forma distinta de valor inválido: o parâmetro segue pendente e volta a ser tentado quando a credencial for corrigida.

🚀 OTIMIZAÇÕES

  • A exceção de parâmetro não encontrado passou a se chamar ParamNotFoundError, acompanhando o restante da biblioteca, que agora usa nomes em inglês. Nada precisa ser alterado em código já escrito: ParamNaoEncontradoError continua exportado e é a mesma classe, então um except existente segue capturando normalmente.
  • Inclua api_error_cooldown (e as variáveis {INSTANCIA}_API_ERROR_COOLDOWN / API_ERROR_COOLDOWN) para configurar por quanto tempo a biblioteca evita novas tentativas após uma falha da API. Sem configuração, o valor continua sendo o mesmo da duração do cache. Valores inválidos ou vazios são ignorados com aviso, caindo na duração do cache.
  • Omita user_editable do payload quando o chamador não informa o campo, permitindo ao servidor distinguir "não enviado" de "enviado como falso" e liberar a edição de parâmetros marcados como editáveis por usuário comum.

🐛 CORREÇÕES

  • Aplique o tempo limite configurado também nas requisições de autenticação e serialize a renovação de token, evitando travar a aplicação chamadora e disparar renovações concorrentes.
  • Ative o intervalo de espera também quando a API responde com erro HTTP, evitando novas tentativas a cada chamada contra um servidor indisponível.
  • Buscar um parâmetro ou aplicação inexistentes (404) deixa de ativar o circuit breaker, permitindo novas tentativas sem entrar em modo offline. Apenas erros de indisponibilidade real (5xx, timeout, conexão) ativam o mecanismo de fallback.
  • Corrigida uma falha rara em que get_param podia lançar KeyError na aplicação que a consome, em vez de devolver o valor ou None. Acontecia quando outra thread apagava ou regravava o mesmo parâmetro no exato instante da leitura — algo que delete_param e upsert_params fazem internamente. A leitura do cache passou a ser feita de uma vez só, sem essa brecha.
  • Corrija from param_manager import *, que falhava por listar em __all__ um símbolo não exportado.
  • Corrija a corrupção do cache local sob uso concorrente. Em uma aplicação com várias threads, a limpeza de uma tabela simultânea a uma gravação podia truncar o arquivo do cache e derrubar o conteúdo de todos os aplicativos — justamente durante a indisponibilidade da API, que é quando esse cache é a única fonte de dados restante.
  • Corrija o registro da instância quando instance_name é informado de forma posicional: antes, o gerenciador era configurado com o nome correto mas registrado sob o nome padrão, fazendo duas instâncias lógicas compartilharem o mesmo espaço.
  • Corrija o uso de um token de acesso já vencido, que sob concorrência podia ser tratado como válido por até 29 minutos e fazer toda requisição falhar com 401. Threads que chegam juntas com o token vencido passam a renovar uma vez só, em vez de uma renovação por thread: como o refresh token é de uso único na configuração padrão do Keycloak, a segunda renovação invalidava a sessão que a primeira acabara de abrir.
  • Elimina race conditions no acesso ao cache em memória: iterações seguras durante modificação concorrente, atualização atômica (CAS) do cache e do circuit breaker, e impossibilidade de resposta atrasada sobrescrever dado mais recente.
  • Execute a inicialização da instância sob o lock do multiton, evitando que duas threads inicializem a mesma instância e substituam o lock interno, os caches e o arquivo do TinyDB.
  • Limpe também o cache em memória do parâmetro ao apagá-lo por delete_param: o valor excluído — possivelmente uma credencial revogada — continuava sendo devolvido por get_param até o fim da janela de cache.
  • Limpe também o cache em memória do parâmetro ao atualizá-lo por upsert_params: o valor anterior continuava sendo devolvido por get_param até o fim da janela de cache.
  • Remova do banco local o parâmetro apagado por delete_param, impedindo que um valor excluído — possivelmente uma credencial revogada — continue sendo servido pelo modo offline.
  • Restrinja a limpeza do banco local ao app envolvido: um erro de leitura da API ou do próprio arquivo passa a descartar apenas a tabela daquele app, em vez de apagar o cache offline de todas as aplicações.
  • Serialize a renovação de token disparada por respostas 401, evitando que chamadas concorrentes usem o mesmo refresh token e invalidem a sessão umas das outras.
  • Um parâmetro cujo valor gravado localmente era nulo não era removido do banco local quando solicitado, causando ressurreição inadvertida na recuperação offline.
  • Uma falha ao criar o gerenciador deixa de contaminar as tentativas seguintes. Antes, um erro durante a inicialização — diretório sem permissão de escrita, cache local corrompido — guardava internamente um objeto pela metade, e toda chamada posterior recebia esse mesmo objeto quebrado até o processo ser reiniciado. O cache local que já tenha sido aberto também é fechado, para que a falha não deixe o arquivo travado no Windows.
  • Valores inválidos ou vazios de CACHE_DURATION e TIMEOUT passam a ser ignorados com aviso, em vez de impedir a criação do gerenciador. Antes o erro subia durante a construção e deixava no lugar uma instância inutilizável, cujo uso seguinte falhava com uma mensagem sem relação com a causa. Um CACHE_DURATION negativo continua desligando o cache, como já acontecia.

🛡 SEGURANÇA

  • Envie o cabeçalho Authorization também nas leituras de parâmetros quando houver credencial configurada, mantendo a leitura anônima funcional quando não houver.
  • Impeça que valores de parâmetros secret, user e users sejam gravados em claro no banco local: a decifragem passa a operar sobre cópia e o cache guarda apenas o envelope cifrado.
  • Inclua a variável PARAM_MANAGER_PURGE_PLAINTEXT_CACHE (desligada por padrão) para remover do banco local valores sensíveis gravados em claro por versões anteriores.
  • Inclua o parâmetro verify_ssl para controlar a verificação de certificado TLS nas leituras, com precedência construtor > {INSTANCIA}_VERIFY_SSL > VERIFY_SSL. O padrão continua desligado, por conta dos ambientes com certificado interno.

📂 DOCUMENTAÇÃO

  • A documentação passou a cobrir o modo local: como ligá-lo, o que muda no armazenamento, por que parâmetros protegidos não podem ser criados offline, como funciona o envio em duas etapas para o servidor e como conflitos são apresentados para você decidir.

Corrigidos também três pontos do tutorial que descreviam funções e nomes que não existem — update_param, get_param_schema, as variáveis de ambiente de credencial e o caminho do arquivo de fallback —, e a página de contribuição, que estava em branco.

Blocos de código voltaram a ser exibidos como código nas páginas. Antes apareciam como texto corrido, com as crases à mostra. - Esclareça na documentação interna que verify_ssl governa apenas as leituras, e que a cópia devolvida na decifragem é garantida somente para parâmetros sensíveis. - O README agora traz um fluxograma do cliente, mostrando como um get_param é resolvido entre cache, cooldown de erro, chamada à API e o fallback local.

🧪 TESTES

  • A biblioteca ganhou uma verificação que confronta o esquema publicado pelo servidor com as rotas, os códigos de sucesso e os campos que ela de fato consome — de modo que uma mudança incompatível do lado do servidor apareça como falha de teste, e não como erro em produção. A verificação se pula sozinha quando não há esquema disponível.
  • A garantia de que a biblioteca não pode entrar em deadlock deixou de depender de revisão e passou a ser verificada automaticamente a cada build, em duas frentes: a execução real dos métodos públicos, inclusive sob concorrência, e uma varredura do código que reprova qualquer gravação de cache feita por fora do caminho seguro.

🏛 INFRAESTRUTURA

  • A auditoria de vulnerabilidades passa a rodar na versão mínima de Python suportada, e não na mais recente: é ali que as dependências resolvem para as versões mais antigas, onde as falhas conhecidas estão.
  • Inclua pipeline de integração contínua com varredura de segredos no histórico, auditoria de vulnerabilidades das dependências, verificação de estilo e testes automatizados em Python 3.8, 3.11 e 3.13, além de uma suíte de integração que exercita o banco local real em vez de um substituto em memória.
  • Regrave requirements-dev.txt em UTF-8 e preserve a lista padrão de exclusões do ruff, que era substituída pela configuração do projeto.

🧹 LIMPEZA

  • Elimine uma gravação redundante no banco local durante delete_param, que repetia o ciclo de leitura e escrita sem alterar o resultado.

Versão 0.4.2 (2026-07-29)

🐛 CORREÇÕES

  • Adicione mais uma tentativa em upsert_params apos renovar o token.

🏛 INFRAESTRUTURA

  • Altere a versão do python-dotenv para atual que não tem alerta no pip-audit.

Versão 0.4.1 (2026-03-26)

🐛 CORREÇÕES

  • Remova propagação de cache em chamada de parâmetro especifico para todos os parâmetros da aplicação.

Versão 0.4.0 (2026-03-26)

⚡ NOVAS FUNCIONALIDADES

  • Aprimore a gestão de variáveis de ambiente: Implemente prioridade para variáveis de ambiente prefixadas com o nome da instância (ex: PLUGIN_API_URL), permitindo configurações granulares sem afetar o escopo global.
  • Garanta a segurança entre threads (Thread-Safety): Implemente um lock de classe no método new para evitar condições de corrida na criação de instâncias nomeadas.
  • Isole o armazenamento do TinyDB: Configure cada instância para utilizar seu próprio arquivo JSON (ex: params_default.json) em subdiretórios distintos, eliminando conflitos de escrita e travas de arquivo.
  • Otimize a recuperação de falhas: Refine os mecanismos de cooldown e fallback local para que falhas de conexão em uma instância não bloqueiem as requisições das demais.
  • Persista o contexto no objeto: Armazene o instance_name dentro de cada instância para que logs, erros e metadados reflitam exatamente qual gerenciador está operando.
  • Personalize o Logging por instância: Atualize todas as mensagens de logger para incluir o nome da instância ativa, facilitando o rastreamento em ambientes complexos.
  • Preserve a compatibilidade do Singleton: Mantenha o funcionamento padrão para chamadas sem argumentos, direcionando-as automaticamente para a instância "default".
  • Refatore a estrutura de instâncias para o padrão Multiton: Substitua o atributo único __instance por um dicionário _instances para permitir múltiplos gerenciadores (ex: "default", "plugin_x") no mesmo processo.
  • Refatore a limpeza de cache: Ajuste o método clear_cache para que a purga de dados seja restrita à instância atual, sem interferir no cache de outros gerenciadores.

Versão 0.3.8 (2026-01-02)

🐛 CORREÇÕES

  • Inclua validação de banco truncado e correção de limpeza.

Versão 0.3.7 (2025-12-31)

🐛 CORREÇÕES

  • Ajuste _fetch_from_api para limpar db local caso necessário.

Versão 0.3.6 (2025-12-31)

🐛 CORREÇÕES

  • Inclua ajuste para caso corrompido db local ele faça a limpeza e nova chamada para api de parâmetros em _get_from_local_db.

Versão 0.3.3 (2025-12-17)

🐛 CORREÇÕES

  • Corrija utilização de parâmetro save_cache em _fetch_param_from_api.

Versão 0.3.1 (2025-12-16)

🐛 CORREÇÕES

  • Inclua parâmetro save_cache para definir se ira ou não salvar do .db local.

Versão 0.3.0 (2025-12-12)

⚡ NOVAS FUNCIONALIDADES

  • Inclua métodos para criação/deleção e atualização de aplicações e parâmetros.

📂 DOCUMENTAÇÃO

  • Inclua informações sobre novos parâmetros de criação, atualização e remoção de aplicativos e parâmetros.

🧪 TESTES

  • Inclusa novos testes para novos métodos de criação, deleção e atualização de aplicações e parâmetros.

Versão 0.2.6 (2025-12-01)

⚡ NOVAS FUNCIONALIDADES

  • Inclua descriptografia para type user e users.

Versão 0.2.5 (2025-11-28)

⚡ NOVAS FUNCIONALIDADES

  • Inclua compatibilidade com atualização de API de parâmetros.

🐛 CORREÇÕES

  • Corrija descriptografia para aceitar versão antiga e versão nova.

Versão 0.2.2 (2025-07-10)

🐛 CORREÇÕES

  • Corrigido local_path_db e .env para geração de executaveis com o pyinstaller.

Versão 0.2.1 (2025-07-10)

🐛 CORREÇÕES

  • Adicionado dependências no pyproject.toml.

Versão 0.2.0 (2025-07-09)

⚡ NOVAS FUNCIONALIDADES

  • Adicionado tipo "secret" com descriptografia de dados salvos na API com base no arquivo de variaveis de ambiente ".env".

Versão 0.1.7 (2025-07-03)

🐛 CORREÇÕES

  • adicionado suporte a multi-threads.

Versão 0.1.6 (2025-06-19)

🐛 CORREÇÕES

  • Correção de utilização de cache caso a API esteja fora do ar.

Versão 0.1.5 (2025-06-05)

🐛 CORREÇÕES

  • Corrigido leitura de parâmetros unitários ao realizar consulta pelo método get_param.

Versão 0.1.4 (2025-06-01)

🐛 CORREÇÕES

  • Correção de salvamento de arquivo db local com opção de passar o path.

Versão 0.1.3 (2025-05-30)

🐛 CORREÇÕES

  • Correção de url na requisição de todos os parametros e alteração de salvamento de db local para pasta da biblioteca.

Versão 0.1.2 (2025-05-27)

🐛 CORREÇÕES

  • Corrigido salvamente em DB local para chamada de parametro unitario.

Versão 0.1.0 (2025-05-23)

⚡ NOVAS FUNCIONALIDADES

  • Adicionado sistema de cache global para parâmetros de aplicações, reduzindo chamadas à API e melhorando performance.
  • Adicionado sistema de fallback para TinyDB, permitindo acesso a parâmetros mesmo quando a API está indisponível.
  • Adicionados métodos para limpeza de cache (global, por aplicação e por parâmetro específico), permitindo controle granular sobre dados em cache.
  • Implementada integração com API de parâmetros, permitindo recuperação de dados de configuração de forma centralizada.
  • Implementado cache específico por parâmetro individual, permitindo consultas mais eficientes para parâmetros frequentemente acessados.
  • Implementado padrão Singleton para garantir uma única instância do gerenciador de parâmetros, evitando múltiplas conexões e caches redundantes.

🚀 OTIMIZAÇÕES

  • Adicionado sistema de logging integrado para rastreamento de operações e diagnóstico de problemas.
  • Implementada configuração flexível para URL da API, duração de cache e timeout, permitindo personalização conforme necessidades específicas.
  • Implementado método get_cache_info() para inspeção do estado atual do cache, facilitando diagnóstico e depuração.