Environment Variables and Configuration in Python

Intermediate

Environment variables let the program that starts Python provide configuration without putting every setting in source code. Python exposes the current process environment through os.environ and provides os.getenv() for optional lookups. This lesson stays with ordinary application configuration; it does not repeat argparse argument parsing or subprocess process launching.

Treat environment values as external input

Environment variables are named text values supplied by a shell, service manager, container, or other launcher. Their names conventionally use uppercase letters and underscores, such as APP_MODE. The names and values are strings: a value such as 8080 is not automatically an integer, and false is not automatically a Boolean. Treat these values as input and validate them before relying on them.

For a repeatable demonstration, the next example temporarily supplies a sample value and restores the previous environment afterward. In an ordinary application, the launcher would normally set APP_THEME before Python starts.

Read optional values with a default

Use os.getenv("APP_THEME", "light") or os.environ.get("APP_THEME", "light") when a setting is optional. If the key is absent, the supplied default is returned. Use os.environ["APP_THEME"] when absence should be reported as a KeyError; do not silently invent a default for a required setting.

A key that exists with an empty string is different from a missing key. If blank values are not meaningful for your application, check for both absence and whitespace-only text.

settings = {}
print(settings.get("APP_THEME", "light"))?

Convert and validate values

Convert a setting only after reading its text. Handle invalid input and validate the permitted range or choices; successful conversion does not automatically mean the value is sensible. Keep the configuration-reading logic in a function that accepts a mapping so the same logic can be tested with sample values instead of depending on a developer’s machine.

value = {"APP_PORT": "8080"}["APP_PORT"]
print(type(value).__name__)?

value = "   "
print(not value.strip())?

Parse Boolean settings deliberately

Do not use bool(raw) to parse a textual flag: every non-empty string is truthy, including "false". Decide which spellings your application accepts, normalize the text, handle true and false spellings explicitly, and reject unknown values rather than guessing.

print(bool("false"))?

Keep secrets and process boundaries in mind

Environment variables can separate configuration from source code, but they are not a complete secrets-management system. Do not commit real credentials, paste them into examples, print them in logs, or assume every operating system and deployment setup protects them from every other process or diagnostic channel. Prefer checking whether a required secret is present without revealing its value.

settings = {"APP_API_TOKEN": "example-placeholder-only"}
print(bool(settings.get("APP_API_TOKEN")))?

Modify the environment only when needed

Python allows deliberate changes through os.environ; assigning or deleting an item updates the environment for the current process and can affect child processes launched afterward. Prefer changing the mapping itself instead of calling os.putenv() directly, because direct putenv() calls do not update the os.environ mapping. Most applications should read settings prepared by their launcher rather than mutate their environment during normal configuration. Child-process arguments and explicit child environments are covered in the subprocess lesson.

One advanced detail in the current reference: os.environ is a mapping captured when the os module is imported. Changes made outside Python may not appear automatically in that mapping. Python 3.14 added os.reload_environ() for refreshing it, but the official reference warns that it is not thread-safe. That specialized API is intentionally not used in this lesson’s examples.

Quick check recap

For exact behavior and platform notes, use the live official Python documentation: os.environ, os.getenv, and the standard-library tutorial on the operating-system interface.