[Python Cheatsheet] 16. Environment Variables - os.environ/dotenv 패턴

1
2
3
4
5
6
7
8

import os

# 환경 변수 읽기 (기본값 지정)
db_host = os.environ.get("DB_HOST", "localhost")
db_port = int(os.environ.get("DB_PORT", "5432"))
debug = os.environ.get("DEBUG", "false").lower() == "true"

print(f"Connecting to {db_host}:{db_port}, debug={debug}")

1
2
3
4

# 환경 변수 필수 값 (없으면 바로 에러)
import os

api_key = os.environ["API_KEY"]  # KeyError if not set

1
2
3
4
5

# 환경 변수 쓰기 (현재 프로세스에서만 유효)
import os

os.environ["MY_VAR"] = "value"
print(os.environ.get("MY_VAR"))  # "value"

1
2
3
4
5

# 모든 환경 변수 확인
import os

for key, value in os.environ.items():
    print(f"{key}={value}")

1
2

# 설치
pip install python-dotenv

1
2
3
4
5
6

# .env 파일 예시 (프로젝트 루트에 생성)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=myapp
API_KEY=your-secret-key-here
DEBUG=true

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# .env 파일 로드
from dotenv import load_dotenv
import os

# .env 파일에서 환경 변수 로드
load_dotenv()  # 기본: 현재 디렉토리의 .env

# 이제 os.environ으로 접근 가능
api_key = os.environ.get("API_KEY")
debug = os.environ.get("DEBUG", "false").lower() == "true"

1
2
3
4
5
6

# 특정 경로의 .env 파일 로드
from dotenv import load_dotenv
from pathlib import Path

env_path = Path(__file__).parent / ".env.local"
load_dotenv(dotenv_path=env_path)

1
2
3
4
5

# .env 파일 내용을 dict로 가져오기 (os.environ에 로드하지 않음)
from dotenv import dotenv_values

config = dotenv_values(".env")
print(config["DB_HOST"])

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

import os
from dataclasses import dataclass
from dotenv import load_dotenv

load_dotenv()

@dataclass
class Config:
    db_host: str = os.environ.get("DB_HOST", "localhost")
    db_port: int = int(os.environ.get("DB_PORT", "5432"))
    db_name: str = os.environ.get("DB_NAME", "myapp")
    api_key: str = os.environ.get("API_KEY", "")
    debug: bool = os.environ.get("DEBUG", "false").lower() == "true"

config = Config()
print(config.db_host, config.debug)

1
2
3
4
5
6

# .gitignore에 반드시 추가
.env
.env.local
.env.*.local
*.pem
*.key

1
2
3
4
5
6
7
8

# .env.example (커밋 가능)
# 이 파일을 .env로 복사하고 실제 값을 채우세요

DB_HOST=localhost
DB_PORT=5432
DB_NAME=
API_KEY=
DEBUG=false