Biblioteca ParamManager
Descrição
Biblioteca Python para consumir a API de parâmetros Fast Param Manager. Oferece cache em memória, armazenamento local com TinyDB, fallback automático quando a API está indisponível, um modo de desenvolvimento sem servidor e, como extra, um aplicativo de desktop.
Documentação completa: https://matheuslpolidoro.github.io/param-manager/
Funcionalidades
- Instâncias nomeadas: cada
instance_nametem uma única instância por processo, com cache, configuração e arquivo local próprios. Sem nome, todas as chamadas compartilham a instânciadefault. - Cache: guarda os resultados em memória para reduzir chamadas à API — 300 s com
ParamManager(...), 3600 s comParamManager.get_instance(...), ou o que você passar emcache_duration. - Armazenamento local: usa TinyDB para persistir os parâmetros lidos.
- Fallback automático: usa os dados locais quando a API está indisponível, e espera um intervalo configurável (
api_error_cooldown) antes de tentar de novo. - Escrita: cria e atualiza aplicações e parâmetros (
create_app,upsert_params,delete_param,delete_app). - Modo local:
mode='local'trabalha num arquivo, sem rede, e sincroniza depois comsync_plan()/sync_apply(). - Front desktop:
pip install "param-manager[front]"traz o aplicativoparam-manager-front(Python 3.11 a 3.13).
Fluxo de resolução
Instalação
pip install param-manager
Com o aplicativo de desktop:
pip install "param-manager[front]"
Uso Básico
from param_manager import ParamManager
# Obter a instância do gerenciador
param_manager = ParamManager.get_instance()
# Recuperar todos os parâmetros de um app
params = param_manager.get_all_params('nome_do_app')
# Recuperar um parâmetro específico
param = param_manager.get_param('nome_do_app', 'NOME_PARAMETRO')
# Limpar o cache para um app específico
param_manager.clear_cache('nome_do_app')
# Obter informações sobre o cache atual
cache_info = param_manager.get_cache_info()
Configuração Avançada
param_manager = ParamManager.get_instance(
api_url="http://minha-api.exemplo.com",
cache_duration=1800, # 30 minutos
timeout=10, # 10 segundos
api_error_cooldown=60, # espera após uma falha da API
verify_ssl=True, # verificação TLS nas leituras
)
Todas essas opções também podem vir de variáveis de ambiente ou do .env, com ou sem o prefixo do nome da instância. A lista completa e a ordem de precedência estão em Configuração.
Comportamento de Fallback
Quando a API está indisponível, a biblioteca automaticamente:
- Tenta acessar a API
- Em caso de falha, busca dados do armazenamento local
- Retorna os dados mais recentes disponíveis localmente
- Durante o intervalo de espera, segue usando os dados locais sem chamar a API
Dependências
- Python 3.10+ (o extra
frontexige 3.11 a 3.13) - requests
- tinydb
- pycryptodome
- python-dotenv
Metadata
Release files for param-manager 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| param_manager-0.6.0.tar.gz | 171.1 kB | Without provenance | Details for param_manager-0.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| param_manager-0.6.0-py3-none-any.whl | Python 3 | none | any | Details for param_manager-0.6.0-py3-none-any.whl |
Total release size: 370.6 kB
Release files / param_manager-0.6.0.tar.gz
| Download URL | param_manager-0.6.0.tar.gz |
|---|---|
| Size | 171.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
98bc55360fdc22d3afb219e76f182a6521b665d3dc40a771ff8f362918c46088
|
|
BLAKE2b-256 checksum How to use checksums |
f2ed0ba77cf1e40daeb88a86760a06708ab7aea1d4c637b7e9aab4d6baeeac37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.1
|
Release files / param_manager-0.6.0-py3-none-any.whl
| Download URL | param_manager-0.6.0-py3-none-any.whl |
|---|---|
| Size | 199.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
49c67c17c00c249b6e84f3c39ef15c1f966b4d1f2ec5333d5b8f24eb975aa373
|
|
BLAKE2b-256 checksum How to use checksums |
af651938a1874a8cea24f4ab60ab147d34835e2f6de9628a959a3749ec9883e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.1
|
Security for param-manager 0.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.