Repolode
Enviar
theskumar

theskumar/python-dotenv

Biblioteca Python que carrega pares chave-valor de um arquivo .env para variáveis de ambiente, seguindo as práticas de aplicativos 12-factor.

Ver no GitHubSite
Estrelas
8,916
Forks
619
Issues abertas
126
Último commit
há 10 dias

O que é?

python-dotenv lê pares chave-valor de um arquivo .env e os define como variáveis de ambiente. A biblioteca é voltada a aplicativos 12-factor, que obtêm sua configuração do ambiente. Assim, durante o desenvolvimento, os desenvolvedores podem manter essas configurações em um arquivo local sem precisar exportá-las no shell a cada execução.

O principal ponto de entrada é load_dotenv(), que, por padrão, procura um arquivo .env, adiciona seus valores a os.environ e mantém as variáveis existentes, a menos que override=True seja informado. dotenv_values() retorna os valores interpretados como um dict sem alterar o ambiente, e ambas as funções podem ler de um fluxo em vez de um arquivo. A ferramenta de linha de comando dotenv permite definir e listar variáveis e executar comandos com os valores carregados do arquivo.

O formato do arquivo é semelhante ao do Bash e oferece suporte a aspas, comentários, ao prefixo export, a valores em várias linhas e à expansão de ${VAR}. O pacote pode ser instalado com pip e inclui uma extensão para IPython.

Recursos principais

  • 01Carrega os valores de arquivos .env em os.environ sem substituir variáveis existentes por padrão.
  • 02Retorna os valores interpretados como um dict por meio de dotenv_values(), sem modificar o ambiente.
  • 03Lê configurações de fluxos e também de arquivos.
  • 04Oferece suporte à sintaxe semelhante à do Bash, com aspas, comentários, prefixo export e valores em várias linhas.
  • 05Expande variáveis escritas como ${VAR} nos valores.
  • 06Inclui uma CLI dotenv para definir e listar variáveis e executar comandos com os valores carregados.
  • 07Disponibiliza uma extensão para IPython que carrega arquivos .env.

Casos de uso

  • Manter URLs de banco de dados e chaves de API de um aplicativo web em Python em um arquivo .env local durante o desenvolvimento.
  • Carregar configurações de uma fonte que não seja o sistema de arquivos, como um fluxo de rede, em um programa Python.
  • Executar um script com variáveis de um arquivo .env usando o comando dotenv run.
  • Ler valores de um arquivo .env para um dict e mesclar configurações sem alterar os.environ.

Início rápido

  1. 1

    Instale a biblioteca pelo PyPI

    pip install python-dotenv
  2. 2

    Crie um arquivo .env na raiz do projeto com suas configurações

  3. 3

    Chame load_dotenv() no início da aplicação

Antes de usar

  • O formato do arquivo .env não é especificado formalmente e pode mudar com o tempo.

Tópicos

#python#configuration#environment-variables#dotenv#12-factor#devops#12-factor-app#devops-tools#env

Perguntas frequentes

O que é python-dotenv?
Biblioteca Python que carrega pares chave-valor de um arquivo .env para variáveis de ambiente, seguindo as práticas de aplicativos 12-factor. python-dotenv lê pares chave-valor de um arquivo .env e os define como variáveis de ambiente. A biblioteca é voltada a aplicativos 12-factor, que obtêm sua configuração do ambiente. Assim, durante o desenvolvimento, os desenvolvedores podem manter essas configurações em um arquivo local sem precisar exportá-las no shell a cada execução.
python-dotenv é gratuito? Qual é a licença?
python-dotenv é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
python-dotenv ainda é mantido?
Manutenção ativa. O último commit de python-dotenv foi em 28 de out. de 2026.
Para que posso usar python-dotenv?
Manter URLs de banco de dados e chaves de API de um aplicativo web em Python em um arquivo .env local durante o desenvolvimento. Carregar configurações de uma fonte que não seja o sistema de arquivos, como um fluxo de rede, em um programa Python. Executar um script com variáveis de um arquivo .env usando o comando dotenv run. Ler valores de um arquivo .env para um dict e mesclar configurações sem alterar os.environ.
Como instalar python-dotenv?
Instale a biblioteca pelo PyPI: pip install python-dotenv Crie um arquivo .env na raiz do projeto com suas configurações Chame load_dotenv() no início da aplicação
Onde consigo python-dotenv?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/theskumar/python-dotenv

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados