Django 디버그 툴바(Django Debug Toolbar)는 데이터베이스 쿼리, Django 웹사이트의 로딩 속도 등 다양한 항목을 실시간으로 확인하고 분석할 수 있는 강력한 디버깅 도구입니다. 개발자들 사이에서 가장 널리 사용되는 필수 도구 중 하나이기 때문에, 지금부터 설치와 설정 방법을 단계별로 자세히 알아보겠습니다.
예제
먼저 "myapp"이라는 이름의 앱을 생성합니다.
1. django-debug-toolbar 설치
가장 먼저 django-debug-toolbar를 설치합니다.
pip install django-debug-toolbar
2. INSTALLED_APPS에 등록하기
settings.py 파일의 INSTALLED_APPS 목록에 'debug_toolbar'를 추가합니다.
INSTALLED_APPS = [ # ... 'debug_toolbar', 'myapp' ]
이렇게 하면 디버그 툴바가 프로젝트의 하나의 앱으로 등록됩니다.
3. 미들웨어(Middleware) 설정
다음으로 미들웨어 목록에 아래 코드를 추가합니다.
MIDDLEWARE = [ # ... 'debug_toolbar.middleware.DebugToolbarMiddleware', # ... ]
이 미들웨어는 데이터베이스에 대한 접근 권한을 제공하는 역할을 합니다.
4. URL 설정
프로젝트 메인 디렉터리의 urls.py에 디버그 툴바 URL을 추가합니다.
import debug_toolbar
from django.conf import settings
from django.urls import include, path
urlpatterns = [
...
path('__debug__/', include(debug_toolbar.urls)),
path('', include('myapp.urls'))
]
URL 설정은 디버그 리포트가 어디에 표시되고, 디버그 툴바가 어디에 호스팅될지를 정의하는 역할을 합니다.
5. INTERNAL_IPS 설정
settings.py에 INTERNAL_IPS 변수를 추가하고 localhost 주소를 지정합니다.
INTERNAL_IPS = [ # ... '127.0.0.1', # ... ]
이 변수는 어떤 URL에서 디버깅을 수행하고 디버그 정보를 화면에 표시할지를 결정합니다.
6. 뷰(View) 작성하기
앱의 views.py에 다음 코드를 추가합니다.
from django.shortcuts import render # Create your views here. def home(request): return render(request,"home.html")
이 뷰는 프론트엔드 파일을 렌더링합니다.
7. 앱 URL 설정
앱의 urls.py에 다음 코드를 추가합니다.
from django.urls import path
from . import views
urlpatterns = [
path('',views.home,name="home" ),
]
이렇게 하면 메인 뷰가 정상적으로 렌더링됩니다.
8. 템플릿(Template) 생성
앱 디렉터리 안에 templates라는 이름의 폴더를 생성하고, 그 안에 home.html 파일을 만듭니다. home.html에는 다음과 같은 간단한 코드를 작성합니다.
<!DOCTYPE html> <html> <head> </head> <body> <h1>success</h1> </body> </html>
이 코드는 화면에 단순한 메시지를 출력합니다.
실행 결과
모든 설정이 완료되면 서버를 실행했을 때 모든 URL 엔드포인트 화면의 오른쪽에 아래와 같은 툴바가 나타나는 것을 확인할 수 있습니다.
