Need an example and please explain me the purpose of python-dotenv.
I am kind of confused with the documentation.
5 Answers
From the Github page:
Reads the key,value pair from .env and adds them to environment variable. It is great of managing app settings during development and in production using 12-factor principles.
Assuming you have created the .env
file along-side your settings module.
.
├── .env
└── settings.py
Add the following code to your settings.py
:
# settings.py
import os
from os.path import join, dirname
from dotenv import load_dotenv
dotenv_path = join(dirname(__file__), '.env')
load_dotenv(dotenv_path)
SECRET_KEY = os.environ.get("SECRET_KEY")
DATABASE_PASSWORD = os.environ.get("DATABASE_PASSWORD")
.env
is a simple text file with each environment variable listed one per line, in the format of KEY="Value". The lines starting with # are ignored.
SOME_VAR=someval
# I am a comment and that is OK
FOO="BAR"
-
2
-
41just want to add, to have to be careful if key/value pair looks like
GIRLFRIEND=None
asprint
showsNone
so in this case you have to check fortype
of the variable to distinguish.– daparicMar 27, 2018 at 15:59 -
6Can anyone explain the difference / pros and cons of dotenv vs autoenv? Nov 1, 2018 at 8:40
-
3@user9074332 The
.env
file convention includes a leading.
which makes it hidden on mac & linux systems. You would also add.env
to your.gitignore
file so it can't be committed to version control. If it is only local and gitignored then it is fine to have a password in it. It should only be called.env
not many of them. If you want to use dotenv in CI/CD on different environments then something like stackoverflow.com/a/55581164/1335793 can work but depends on your deployment platform and process.– DavosJan 20, 2021 at 13:09 -
14
in production using 12-factor principles
refers to the principle 12factor.net/config of storing config in env vars. Storing them in a local gitignored.env
file is just an implicit helper to export env vars, so you don't forget to export or to run a shell script. When deploying to prod you abandon the.env
file. Theload_dotenv()
and theos.environ.get
calls are independent;dotenv
works for local development and you use some other mechanism such as your CI/CD system's env vars secrets manager in prod, either way theos.environ.get
part always works.– DavosJan 20, 2021 at 13:37
In addition to @Will's answer, the python-dotenv module comes with a find_dotenv()
that will try to find the .env file.
# settings.py
import os
from dotenv import load_dotenv, find_dotenv
load_dotenv(find_dotenv())
SECRET_KEY = os.environ.get("SECRET_KEY")
DATABASE_PASSWORD = os.environ.get("DATABASE_PASSWORD")
-
17load_dotenv() is enough if you have the
.env
file in the current directory Jul 20, 2021 at 14:05
You could set the env variables like this:
export PRIVATE_KEY=0X32323
and then read it with os
module.
import os
private_key=os.getenv("PRIVATE_KEY")
But this way, environment variable works only for the duration that shell is live. If you close the shell and restart it, you have to set environmental variable again. python-dotenv
prevents us from doing this repetitive work.For this create .env
file and add variables in this format
PRIVATE_KEY=fb6b05d6e75a93e30e22334443379292ccd29f5d815ad93a86ee23e749227
then in the file u want to access anv variables
import os
from dotenv import load_dotenv
#default directory for .env file is the current directory
#if you set .env in different directory, put the directory address load_dotenv("directory_of_.env)
load_dotenv()
load_dotenv()
will set the environment variables from .env
and we access with os
module
private_key=os.getenv("PRIVATE_KEY")
Adding to @cannin's answer, if you want to specify the which file you want to find:
from dotenv import find_dotenv
from dotenv import load_dotenv
env_file = find_dotenv(".env.dev")
load_dotenv(env_file)
If you're starting your app from a shell such as bash or zsh, then the point of .env management utilities like (npm) dotenv or python-dotenv becomes moot.
Here's an example of how to manage .env with bash that simply, directly, and safely addresses configuration as recommended by the 12-Factor App. It also requires no additional dependencies.
Given a project hosted under ~/projects/foobar/
, create an environment file in a safe location outside your project's space (e.g. ~/.envs/foobar/dev
). Its content may look something like this:
set -a
PROJECT=foobar
DB_NAME=foobar_dev
DB_PASSWORD=5ecret
CACHE_ENABLED=
DEBUG=yes
LOG=/tmp/foobar.log
...
set +a
Then create a symlink to that file from your project's space:
$ ln -s ~/.envs/foobar/dev ~/projects/foobar/.env
The project now has a .env
file symlinking to the actual file. When you source the symlink, all variables between set -a
and set +a
are exported to the environment.
$ source ~/projects/foobar/.env
And voila! If you run python from the same shell instance you sourced the environment file, you can retrieve the latter and update your config with it:
import os
config.update(os.environ)
The point of making .env
a symlink to ~/.envs/foobar/dev
is an added precaution to listing it in .gititgnore. If for whatever reasons the file were to be checked into version control, its contents would just show that it's a link to another file.
-
2Interesting edge case: I was using Prefect to orchestrate python code, and the default upload behavior is to follow symlinks and upload the file (to local storage or S3 for example.) Therefore, protecting a local file from a repo by symlinking can fail, where using an
env
variable to referece a file location will be OK.– MerlinJan 31 at 3:01 -
1@Merlin My answer presumes common knowledge that .env is a private, user specific file and thus should be included in .gitignore. No one wants to deal with teammates's .env in the repo, symlinks or not. That's why I say that making it a symlink is an added precaution to listing it in .gitignore. It's not a replacement. But people can forget. If I accidentally check it in, I'd prefer to have the added likelihood that it's checked in as a symlink, even if that's not an absolute certainty (with Prefect and such). Jan 31 at 14:18