requirements.txt 사용방법

requirements.txt을 사용하는 방법을 다룹니다. 보통 특정 파이썬 프로젝트를 위한 패키지들을  requirements.txt에 저장하기 위해 사용합니다.

 

pip를 사용하여 설치했던 패키지들을  requirements.txt 파일에 저장했다가 새로운 개발환경에서 똑같은 패키지들을 한번에 설치할 수 있습니다.

2024. 2. 24  최초작성

Miniconda/Anaconda를 사용하면 진행하는 Python 프로젝트 별로 패키지를 별도로 관리할 수 있어 좋습니다.  Miniconda를 처음 사용할땐 왜 사용하는지 이해할 수 없었지만 익숙해지고 나니 프로젝트별로 패키지를 따로 관리하는게 더 편합니다. 여러가지 이유가 있지만 그중 하나는 여러 개의 프로젝트의 패키지를 하나에 설치하다보면 버전 충돌이 나서 문제가 되는 경우가 있더군요. 두 개의 파이썬 패키지가 요구하는 또다른 패키지의 버전이 차이가 나는 경우가 생기기 때문입니다. 

본 포스트는 다음 포스트대로 설치환경이 구성된 이후라 가정하고 설명하지만 필요한 부분만 취하여 requirements.txt를 사용하여 패키지를 관리해도 됩니다. 

 

Visual Studio Code와 Miniconda를 사용한 Python 개발 환경 만들기( Windows, Ubuntu)

https://webnautes.tistory.com/1842 

진행을 윈도우에서 하고 있지만 동일하게 리눅스에서도 사용가능합니다.

opencv 패키지를 설치하여 사용할 opencv 이름의 가상환경을 생성합니다. 파이썬 버전은 3.12를 사용합니다.

(base) C:\Users\webnautes>conda create -n opencv python=3.12

opencv 가상환경을 활성화하면 프롬프트 앞에 (opencv)가 붙습니다.

(base) C:\Users\webnautes>conda activate opencv

(opencv) C:\Users\webnautes>

opencv 패키지를 설치합니다.

(opencv) C:\Users\webnautes>pip install opencv-python

설치된 패키지 목록을 확인합니다.

(opencv) C:\Users\webnautes>pip list

Package       Version

------------- --------

numpy         1.26.4

opencv-python 4.9.0.80

pip           23.3.1

setuptools    68.2.2

wheel         0.41.2

이제 새로운 파이썬 가상 환경을 생성하여 opencv 가상환경과 동일하게 opencv 패키지가 설치된 상태로 만들어 보겠습니다.

우선 설치된 패키지 목록을  requirements.txt 파일에 저장합니다. 

requirements.txt 파일의 내용을 확인해봅니다. 패키지 이름과 버전이 적혀 있습니다. 그사이에 ==의 의미는 똑같은 버전의 패키지를 설치해야 한다는 의미입니다.  리눅스에선 cat requirements.txt 명령을 사용하세요.

 

(opencv) C:\Users\webnautes>type requirements.txt

numpy==1.26.4

opencv-python==4.9.0.80

setuptools==68.2.2

wheel==0.41.2

이제 새로운 파이썬 가상환경을 생성하고 활성화합니다. 파이썬 3.9를 사용하는 test 이름의 파이썬 가상환경입니다. 

(opencv) C:\Users\webnautes>conda create -n test python=3.9

test 파이썬 가상환경을 활성화합니다. 여전히 같은 경로인 것을 알 수 있습니다. 파이썬 가상환경을 바꾼다고해서 현재 경로가 바뀌는것은 아니고 사용가능한 파이썬 버전이나 패키지만 바뀌는 것입니다. 

(opencv) C:\Users\webnautes>conda activate test

 

(test) C:\Users\webnautes>

다음 명령을 사용하여 requirements.txt를 현재 파이썬 가상환경에 반영합니다. 패키지 설치가 진행됩니다.

(test) C:\Users\webnautes>pip install -r requirements.txt

설치된 패키지와 버전을 확인해보면 requirements.txt 파일과 동일합니다. 만약 파이썬 가상환경에 다른 패키지들이 설치되어 있었다면 그 패키지들은 유지되고 추가로 requirements.txt 파일에 있는 패키지가 설치됩니다. 만약 동일한 패키지가 이미 설치되어 있다면 requirements.txt 파일에 있는 버전으로 패키지가 변경됩니다. 

 

(test) C:\Users\webnautes>pip list

Package       Version

------------- --------

numpy         1.26.4

opencv-python 4.9.0.80

pip           23.3.1

setuptools    68.2.2

wheel         0.41.2

참고

https://itholic.github.io/python-requirements/