How to Use .env Files for Environment Variables in Python

If you are just starting out with Python, you might hear about something called ".env files" or environment variables. These terms may sound a bit complicated, but they are really helpful tools for writing Python code, especially if you are working on a bigger project. Let me explain what they are, why they matter, and how you can use them in a simple way.

What Are Environment Variables?

Imagine you're making a game, and you need to store some secret information, like the password to your game server or an important API key that connects your game to other services. You don't want this information to be seen by everyone who looks at your code. This is where environment variables come in handy.

Environment variables are special values that you keep outside of your main code. You use them to store sensitive information or anything that could change based on where your code is running. For example, an environment variable could hold a password or a different setting for testing versus running your code in real life.

Why Use a .env File?

A .env file is just a simple text file that you use to store these environment variables. It's like having a secret notebook where you keep important information separate from your main work. In Python projects, .env files help keep your code clean and protect sensitive data from being shared accidentally.

If you ever share your project on GitHub or another platform, you won't have to worry about accidentally leaking your passwords or secret keys because they are safely stored in the .env file, which you can choose not to share.

How to Create a .env File

Creating a .env file is easy. Here are the steps:

Create a new file in the same folder as your Python script and name it .env.
In this file, write your variables in the format VARIABLE_NAME=value. For example:

SECRET_KEY=mysecretkey123
DATABASE_PASSWORD=supersecretpassword

The .env file keeps your secret values separate from the rest of your code.

How to Use a .env File in Python

To use the .env file in Python, you need a package called python-dotenv. This package reads your .env file and makes those variables available to your code.

Step 1: Install python-dotenv

You can install python-dotenv using pip, the Python package manager. Open your terminal and run:

pip install python-dotenv

Step 2: Load Variables in Your Python Code

Once you've installed python-dotenv, you can load the values from your .env file. Here's an example of how to do it:

from dotenv import load_dotenv
import os

# Load the variables from the .env file
load_dotenv()

# Access the variables
secret_key = os.getenv("SECRET_KEY")
database_password = os.getenv("DATABASE_PASSWORD")

print(f"Your secret key is: {secret_key}")

In this code:

load_dotenv() reads the .env file.
os.getenv("VARIABLE_NAME") lets you access the value of a specific variable from the .env file.

Using .env files for environment variables is a simple way to keep your Python applications safe and organized. They help you keep sensitive information private and make it easier to manage changes. With a tool like python-dotenv, you can easily load these variables into your code and keep your project clean and secure.

python