[Django REST framework] (1) 프로젝트 생성과 설정

가상환경 설정, 진입

Django는 Python 기반의 웹 프레임워크이고 여타의 Python 프로젝트와 마찬가지로 가상환경을 이용해 Python 버전, 패키지 버전 등을 관리할 수 있다. venv 모듈을 이용해 venv라는 이름의 가상환경을 생성하자. 가상환경 디렉터리에는 Python 인터프리터, 설치한 패키지 등이 저장된다.

python3 -m venv venv
source venv/bin/activate

이때 생성하는 가상환경 디렉터리의 이름이 반드시 venv일 필요는 없으며, 프로젝트 디렉터리 내에 위치할 필요도 없다. 다음과 같은 방식으로 홈 디렉터리 밑에 가상환경 디렉터리를 두고 관리하는 것도 가능하며 이는 어디까지나 이용하는 개발자의 기호이다.

python3 -m venv ~/.venv/djangoproject
source ~/.venv/djangoproject/bin/activate

패키지 설치

가상환경에 진입했으면 이제 Django, Django REST framework를 설치한다.

pip3 install django djangorestframework

협업을 위해 설치한 패키지의 종류와 버전 정보를 아래와 같은 명령어로 requiremnts.txt에 저장하자.

pip3 freeze > requirements.txt

만약 이미 만들어진 프로젝트를 풀받는 입장이라면 다음의 명령어로 requiremnts.txt에 저장된 패키지를 자신의 로컬에 설치할 수 있다.

pip3 install -r requirements.txt

Django 프로젝트 생성

패키지 설치가 완료되었으면 다음의 명령어로 Django 프로젝트를 생성하자. ${PROJECT_NAME}에는 원하는 프로젝트 이름이 위치하면 된다.

django-admin startproject ${PROJECT_NAME}

이러한 명령은 다음과 같은 디렉터리 구조로 프로젝트를 생성한다.

.
|____${PROJECT_NAME}
| |____asgi.py
| |______init__.py
| |____settings.py
| |____urls.py
| |____wsgi.py
|____manage.py

• manage.py
  Django 프로젝트 관리, 개발 도구를 제공한다.
• settings.py
  프로젝트의 설정을 관리한다. Django 프로젝트를 실행하면 이 파일에서 설치된 앱, 이용할 미들웨어, 연결할 데이터베이스 등의 정보를 구성한다.
• wsgi.py (or asgi.py)
  WSGI application(또는 ASGI application)을 구성한다.
• urls.py
  URL 스키마를 정의한다.

INSTALLED_APPS

Django REST framework이 동작하기 위해서는 settings.py의 INSTALLED_APPS에 'rest_framework'를 추가해야 한다.

INSTALLED_APPS = [
    ...

    'rest_framework',

    ...

]

개발서버 실행

다음의 명령어를 이용해 테스트용 개발 서버를 실행할 수 있다.

python3 manage.py runserver