[사용법] virtualenvwrapper

 

virtualenv 만 달랑 사용해오다가 virtualenvwrapper 란 패키지를 알게되어 사용법을 기록한다.

---

간단 설명

virtualenvwrapper 는 virtualenv 모듈의 확장팩 격인 패키지이다. virtualenv로 생성한 가상 환경을 보다 편리하게 사용할 수 있도록 이것 저것(ex. 가상환경 생성/삭제, 실행, 조회 등을 한 줄의 명령어로 제공, 여러 개의 가상환경들을 한꺼번에 관리할 수 있는 기능 등)을 제공하는 패키지이다. 

 

전제 조건

• ubuntu 22.04 이상 (필자의 환경)
• python3.8 ~ 3.11
• python3-pip 설치 완료
• virtualenv 모듈 설치 완료

 

설치

python3 -m pip install virtualenvwrapper

이 때 설치 Log를 잘 확인하여 자신의 환경에서 virtualenvwrapper의 설치 경로를 알아두어야 한다. (정확히는 virtualenvwrapper.sh 의 위치)

 

설정

가상환경 기본 경로 설정

 export WORKON_HOME={가상환경들의 기본 경로}

 

프로젝트 기본 경로 설정

export PROJECT_HOME={Project들의 기본 경로}

 

가상환경에서 사용할 Python3 버전 설정

export VIRTUALENVWRAPPER_PYTHON={사용할 python3 특정 버전의 설치 경로}

 

the location of the script installed with this package <<< ?? 정확한 의미는 모르겠으나 필수

source {virtualevnwrapper.sh - 각자의 설치 경로 입력}

 

사용

가상환경 생성

mkvirtualenv {가상환경 명}

 

가상환경 삭제

rmvirtualenv {가상환경 명}

 

가상환경 활성화

workon {가상환경 명}

가상환경1 에서 가상환경2로 전환하고 싶을 때 workon 가상환경2 만 해주면 바로 전환된다.

 

가상환경 비활성화

deactivate

 

가상환경 생성 + 프로젝트 생성

mkproject {프로젝트 명}

프로젝트 명과 동일한 이름을 갖는 가상환경과 프로젝트가 각자의 기본 경로에 생성된다.

 

가상환경 목록 조회

lsvirtualenv

 

활성화 중인 가상환경 경로로 이동

cdvirtualenv

 

기타 명령어 목록:    https://virtualenvwrapper.readthedocs.io/en/latest/command_ref.html

 

참고 자료

파이썬을 여행하는 히치하이커를 위한 안내서 - https://python-guide-kr.readthedocs.io/ko/latest/dev/virtualenvs.html 

virtualenvwrapper document - https://virtualenvwrapper.readthedocs.io/en/latest/install.html