[Python] 파이썬 패키지 관리, requirements.txt 쓰는 이유

1. requirements.txt란?

requirements.txt 파일은 프로젝트에서 사용되는 Python 패키지들의 목록을 기록한 텍스트 파일입니다. 이 파일을 통해 다른 개발자나 서버에서도 동일한 패키지와 버전을 손쉽게 설치할 수 있습니다.

2. requirements.txt 만들기

현재 설치된 패키지들을 requirements.txt로 저장하려면 아래 명령어를 사용하면 됩니다.

1. 기본 방법

pip freeze > requirements.txt

pip freeze 명령어는 현재 환경에 설치된 패키지들을 나열하는 데 유용하지만, 로컬 환경이나 VCS에서 직접 설치된 패키지는 @ file 형식으로 나올 수 있습니다. 이런 경우에는 pip list --format=freeze를 사용하는 것이 더 적합합니다.

1. pip list 명령어 사용

 

pip list --format=freeze > requirements.txt

3. requirements.txt로 패키지 설치하기

requirements.txt 파일에 정의된 패키지들을 설치하려면 아래 명령어를 실행합니다.

1. 기본 설치 방법

pip install -r requirements.txt

1. 개별 패키지 설치 방법
   한 패키지의 설치가 실패하더라도 전체 설치가 중단되지 않도록 하려면 아래와 같이 설치할 수 있습니다.

cat requirements.txt | xargs -n 1 pip install

4. 관리의 좋은 습관

• 버전 명시: 패키지의 호환성을 보장하기 위해, 가능한 한 정확한 버전을 명시하는 것이 중요합니다. (예: Django==3.1.4)
• 환경별 파일 관리: 개발, 테스트, 프로덕션 환경에 맞춰 각기 다른 requirements.txt 파일을 관리할 수 있습니다. (예: requirements_dev.txt, requirements_prod.txt)

requirements.txt는 Python 프로젝트의 의존성을 체계적으로 관리하는 데 매우 유용한 도구입니다. 이 파일을 통해 프로젝트를 다른 개발자와 공유하거나 다양한 환경에서 작업할 때 패키지 설치가 한결 수월해집니다.