Front desktop
Aplicativo de desktop para gerenciar parâmetros sem escrever código: aplicações, parâmetros, o plano de sincronização e o catálogo de tipos. Roda em português e inglês, com tema claro e escuro.
Ele vem dentro do próprio pacote, como extra: quem só lê parâmetros num servidor não instala nada a mais.
Instalação
pip install "param-manager[front]"
E para abrir:
param-manager-front
# ou
python -m param_manager.front
Não é preciso Rust nem Node: o extra traz um componente nativo já compilado.
Python 3.11 a 3.13
O extra só instala nessas versões. A biblioteca em si funciona do 3.10 em diante, mas o front não:
- No 3.10, uma dependência do front só corrige suas vulnerabilidades conhecidas em versões que exigem 3.11.
- A partir do 3.14, o componente nativo ainda não publica pacote.
Nessas versões, pip install "param-manager[front]" instala só a
biblioteca, sem erro, e o comando param-manager-front não abre.
Runtime de webview
A janela usa o navegador embutido do sistema operacional:
| Sistema | O que instalar |
|---|---|
| Windows | WebView2 Runtime (Evergreen Bootstrapper) |
| Linux | libwebkit2gtk-4.1-0, libgtk-3-0, libappindicator3-1 |
| macOS | nada, já vem no sistema |
Como usar
A primeira tela é Sessão. Preencha o nome da instância e o modo, conecte, e o resto da interface passa a operar sobre aquela sessão.
- Modo local grava no arquivo local do modo local, sem
rede. É o modo de desenvolver sem servidor. Os tipos
secret,usereuserssão recusados aqui, porque a cifragem acontece no servidor. - Modo remoto fala com a API e exige a URL.
O caminho do arquivo local e as credenciais vêm das mesmas variáveis de
ambiente e do mesmo .env da biblioteca — ver Configuração.
O front guarda só as próprias preferências (tema, idioma, última instância) em
front-prefs.json, no diretório de configuração do sistema.
Trocar de modo exige uma instância nova: uma sessão já aberta não é reconfigurada.
Uma chave de custódia por processo
A chave que decifra os parâmetros protegidos é lida de uma variável de ambiente global. Um processo usa exatamente uma chave, então aplicações com chaves diferentes precisam ser abertas em processos diferentes.