Download dynaconf - download do código-fonte dynaconf

dynaconf

Pitão

3.2.6

Baixar

Características

Inspirado no guia de aplicação de 12 fatores
Gerenciamento de configurações (valores padrão, validação, análise, modelos)
Proteção de informações confidenciais (senhas/tokens)
Vários formatos de arquivo toml|yaml|json|ini|py e também carregadores personalizáveis.
Suporte completo para variáveis de ambiente para substituir configurações existentes (suporte dotenv incluído).
Sistema opcional em camadas para vários ambientes [default, development, testing, production]
Suporte integrado para Hashicorp Vault e Redis como configurações e armazenamento de segredos.
Extensões integradas para estruturas web Django e Flask .
CLI para operações comuns como init, list, write, validate, export .
documentação completa em https://dynaconf.com

Instalar

$ pip install dynaconf

Inicialize o Dynaconf no diretório raiz do projeto

 $ cd path/to/your/project/

$ dynaconf init -f toml

  Configuring your Dynaconf environment
------------------------------------------
? The file `config.py` was generated.

?️  settings.toml created to hold your settings.

? .secrets.toml created to hold your secrets.

? the .secrets.* is also included in `.gitignore`
  beware to not push your secrets to a public repo.

? Dynaconf is configured! read more on https://dynaconf.com

DICA: Você pode selecionar toml|yaml|json|ini|py em dynaconf init -f <fileformat> toml é o formato padrão e também o mais recomendado para configuração.

Dynaconf init cria os seguintes arquivos

 .
├── config.py       # This is from where you import your settings object (required)
├── .secrets.toml   # This is to hold sensitive data like passwords and tokens (optional)
└── settings.toml   # This is to hold your application settings (optional)

No arquivo config.py Dynaconf init gera o seguinte padrão

 from dynaconf import Dynaconf

settings = Dynaconf (
    envvar_prefix = "DYNACONF" ,  # export envvars with `export DYNACONF_FOO=bar`.
    settings_files = [ 'settings.yaml' , '.secrets.yaml' ],  # Load files in the given order.
)

DICA: Você mesmo pode criar os arquivos em vez de usar o comando init como mostrado acima e pode dar qualquer nome que desejar em vez do config.py padrão (o arquivo deve estar no caminho python importável) - Veja mais opções que você pode passe para o inicializador da classe Dynaconf em https://dynaconf.com

Usando Dynaconf

Coloque suas configurações em settings.{toml|yaml|ini|json|py}

 username = " admin "
port = 5555
database = { name = ' mydb ' , schema = ' main ' }

Coloque informações confidenciais em .secrets.{toml|yaml|ini|json|py}

 password = " secret123 "

IMPORTANTE: o comando dynaconf init coloca o .secrets.* no seu .gitignore para evitar que ele seja exposto em repositórios públicos, mas é sua responsabilidade mantê-lo seguro em seu ambiente local, também a recomendação para ambientes de produção é usar o build- no suporte ao serviço Hashicorp Vault para senhas e tokens.

Opcionalmente, agora você pode usar variáveis de ambiente para substituir valores por execução ou por ambiente.

 # override `port` from settings.toml file and automatically casts as `int` value.
export DYNACONF_PORT=9900

No seu código, importe o objeto settings

 from path . to . project . config import settings

# Reading the settings

settings . username == "admin"  # dot notation with multi nesting support
settings . PORT == 9900  # case insensitive
settings [ 'password' ] == "secret123"  # dict like access
settings . get ( "nonexisting" , "default value" )  # Default values just like a dict
settings . databases . name == "mydb"  # Nested key traversing
settings [ 'databases.schema' ] == "main"  # Nested key traversing