준비 사항
타사 라이브러리의 소스코드를 탐구할 때는 규모가 작은 프로젝트부터 접근하는 것이 좋다. 이해하기 어려운 부분은 일단 넘기고, 파악 가능한 부분을 중심으로 관련 문서와 함께 분석하자.
Django 설정 파일의 이중 구조
Django는 두 가지 설정 파일을 운용한다:
- 사용자 정의 설정: 프로젝트 루트의
settings.py로, 개발자가 직접 수정하는 파일 - 프레임워크 기본값: 사용자가 아무것도 지정하지 않았을 때 자동으로 적용되는 기본 설정
핵심 의문
소스코드를 통해 다음 두 가지를 명확히 이해할 수 있다:
- 설정 항목이 대문자로만 구성되는 이유
- 사용자 정의 값이 존재하면 해당 값을, 없으면 기본값을 채택하는 우선순위 로직
LazySettings 객체의 초기화 과정
설정 객체는 django.conf 모듈에서 가져온다:
from django.conf import settings해당 모듈 내부를 살펴보 settings = LazySettings()라는 구문이 보인다. 이 객체는 실제로 설정값에 접근하는 순간 Settings 클래스를 인스턴스화하는 지연 초기화(lazy initialization) 패턴을 따른다.
LazySettings의 __init__ 메서드에서 다음 코드를 확인할 수 있다:
config_path = os.environ.get(ENVIRONMENT_VARIABLE)여기서 os.environ는 운영체제의 환경 변수를 딕너리 형태로 제공하며, ENVIRONMENT_VARIABLE은 문자열 "DJANGO_SETTINGS_MODULE"을 담고 있다.
manage.py에서의 환경 변수 주입
Django 프로젝트를 실행할 때 manage.py의 시작 부분에서 다음과 같은 코드를 볼 수 있다:
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.config')이는 환경 변수 딕너리에 DJANGO_SETTINGS_MODULE 키가 없을 경우, 기본값으로 프로젝트 설정 모듈의 경로를 등록하는 역할을 한다.
Settings 클래스의 병합 로직
LazySettings는 최종적으로 Settings 클래스를 인스턴스화하며, 이 때 앞서 확보한 모듈 경로를 인자로 전달한다:
self._wrapped = Settings(settings_module)Settings 클래스의 초기화 메서드 내부에서 두 단계의 설정 병합이 이어진다.
1단계: 기본 설정 로드
from django.conf import global_settings
for attr_name in dir(global_settings):
if attr_name.isupper():
default_val = getattr(global_settings, attr_name)
setattr(self, attr_name, default_val)global_settings는 Django가 내장하고 있는 기본 설정 모듈이다. 이 모듈의 속성을 순회하며 대문자인 이름만 필터링하여 현재 Settings 인스턴스의 속성으로 복사한다. 이것이 설정 항목이 대문자여야 하는 이유다—소문자 속성은 내부 유틸리티나 기타 목적으로 사용될 수 있으므로, 실제 설정값과 구분하기 위한 명명 규칙인 것이다.
2단계: 사용자 설정 오버라이드
self.SETTINGS_MODULE = settings_module
user_config = importlib.import_module(self.SETTINGS_MODULE)
for attr_name in dir(user_config):
if attr_name.isupper():
user_value = getattr(user_config, attr_name)
setattr(self, attr_name, user_value)
self._explicit_settings.add(attr_name)importlib.import_module을 통해 문자열 경로로 사용자의 settings.py를 동적으로 임포트한다. 이후 같은 방식으로 대문자 속성을 순회하며, 이번에는 기본 설정 위에 사용자 값을 덮어쓴다. 동일한 속성명이 존재할 경우 setattr에 의해 이전 값이 대체되로, 사용자 정의가 기본값보다 우선하게 된다.
속성 접근의 지연 바인딩
LazySettings는 직접적인 Settings 인스턴스가 아니라, 실제 접근 시점에 초기화를 수행하는 프록시 역할을 한다. 이는 __getattr__ 메서드를 통해 구현되며, 모듈 임포트 시점의 순환 참조 문제나 불필요한 초기를 방지하는 효과가 있다.
class LazySettings:
def __getattr__(self, name):
if self._wrapped is empty:
self._setup()
return getattr(self._wrapped, name)설정 우선순위의 시각화
전체 흐름을 정리하면 다음과 같다:
- Django 시작 시
manage.py가 환경 변수에 설정 모듈 경로를 등록 - 최 설정 접근 시
LazySettings가Settings인스턴스 생성을触發 Settings.__init__에서 기본 설정 모듈의 대문자 속성을 먼저 자신에게 복사- 이어서 사용자 설정 모듈을 임포트하고 동일한 방식으로 속성을 덮어
- 동일 속성에 대해 사용자 값이 마지막으로 적용되므로 우선순위가 보장됨
이러한 설계 덕분에 Django는 명시적인 설정만으로도 직관적인 커스터마이징 환경을 제공하며, 동시에 프레임워크 전반에 걸쳐 일관된 기본 동작을 보장할 수 있다.