philiprehberger-env-file 0.2.0

.env file parser with interpolation and multi-file support

philiprehberger-env-file

.env file parser with interpolation and multi-file support.

Installation

pip install philiprehberger-env-file

Usage

Load into Environment

from philiprehberger_env_file import load_env

# Load .env (default)
load_env()

# Load multiple files (later files override earlier)
load_env(".env", ".env.local")

# Don't override existing env vars
load_env(override=False)

Parse Without Modifying Environment

from philiprehberger_env_file import parse_env_file

config = parse_env_file(".env")
print(config["DATABASE_URL"])

Writing .env files

from philiprehberger_env_file import dump_env

dump_env(
    {"DATABASE_URL": "postgres://localhost/db", "DEBUG": "1"},
    ".env",
)

Values containing whitespace, #, ", or ' are automatically quoted. Pass quote=False to disable.

Merging without loading

from philiprehberger_env_file import merge_env

# Later files override earlier ones; os.environ is untouched
config = merge_env(".env", ".env.local")

Supported Syntax

# Comments
KEY=value
export KEY=value

# Quoted values
SINGLE='no interpolation here'
DOUBLE="supports\nnewlines"

# Variable interpolation
BASE_URL=https://api.example.com
API_URL=${BASE_URL}/v1

# Empty values
EMPTY_VAR=

# Inline comments (unquoted values only)
HOST=localhost # this is a comment

API

Function / Class	Description
load_env(*paths, override=True)	Load .env files into os.environ, returns dict of loaded vars
parse_env_file(path)	Parse a .env file, returns dict without modifying environment
dump_env(data, path, quote=True)	Write a dict to a .env file, auto-quoting values that need it
merge_env(*paths)	Parse multiple .env files into one dict; missing files are skipped, os.environ is not modified

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT