[장고] 프로젝트 이름 변경하기

Django 프로젝트를 진행하다 보면 프로젝트 이름을 변경해야 할 상황이 생길 수 있습니다. 프로젝트 이름을 변경하는 작업은 앱 이름을 변경하는 것보다 상대적으로 간단합니다. 이 글에서는 Django 프로젝트 이름을 변경하는 방법을 단계별로 설명하겠습니다.

프로젝트 이름이 사용되는 부분 찾기

먼저 프로젝트 이름이 사용된 위치를 모두 찾아야 합니다. 이를 위해 터미널을 열고 프로젝트 폴더로 이동합니다. 그런 다음 grep 명령어를 사용하여 프로젝트 이름이 사용된 모든 파일을 검색합니다. 예를 들어, 프로젝트 이름이 'mysite'라면 다음과 같이 입력합니다.

grep -nir mysite .

이 명령어는 'mysite'가 사용된 모든 파일과 그 위치를 리스트로 출력합니다.

프로젝트 이름 변경하기

프로젝트 이름을 변경하려면 여러 파일에서 수정이 필요합니다. 각 파일을 하나씩 열고 수정해 보겠습니다.

1. 프로젝트 디렉토리 이름 변경

우선 프로젝트 폴더 이름을 새 이름으로 변경합니다. 예를 들어 'mysite'에서 'newsite'로 변경합니다.

2. manage.py 수정

manage.py 파일을 열어 os.environ.setdefault 함수 내의 프로젝트 이름을 수정합니다.

변경 전:

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mysite.settings')

변경 후:

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'newsite.settings')

3. wsgi.py 수정

wsgi.py 파일에서도 os.environ.setdefault 함수를 수정해야 합니다.

변경 전:

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mysite.settings')

변경 후:

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'newsite.settings')

4. settings.py 수정

settings.py 파일에서 ROOT_URLCONF와 WSGI_APPLICATION 값을 새 프로젝트 이름으로 수정합니다.

변경 전:

ROOT_URLCONF = 'mysite.urls'
WSGI_APPLICATION = 'mysite.wsgi.application'

변경 후:

ROOT_URLCONF = 'newsite.urls'
WSGI_APPLICATION = 'newsite.wsgi.application'

5. 기타 파일 수정

프로젝트 이름이 포함된 다른 모든 파일을 찾아 수정해야 합니다. 특히 URL 설정 파일이나 view 파일에서 모듈을 불러오는 부분을 주의깊게 살펴보세요.

변경 전:

from mysite.views import TimeMixin

변경 후:

from newsite.views import TimeMixin

테스트 서버 실행

모든 수정을 마친 후에는 Django 테스트 서버를 실행하여 문제가 없는지 확인합니다. 다음 명령어로 테스트 서버를 실행합니다.

python manage.py runserver

서버가 정상적으로 실행되고 모든 기능이 문제없이 작동한다면 프로젝트 이름 변경이 성공적으로 완료된 것입니다.

결론

Django 프로젝트 이름을 변경하는 과정은 여러 파일을 수정해야 하므로 다소 복잡하게 느껴질 수 있습니다. 그러나 위의 단계를 차근차근 따라가면 쉽게 프로젝트 이름을 변경할 수 있습니다. 프로젝트의 이름을 변경함으로써 더 명확하고 일관된 코드베이스를 유지할 수 있을 것입니다. 프로젝트 이름 변경이 필요한 경우, 이 가이드를 참고하여 작업을 진행해 보세요.