[Python] venv 가상환경 관리, Mac (1)

0. 배경

파이썬 버전 관리는 역시 기본!! venv

프로젝트마다 필요한 패키지가 다르고 버전 호환 문제 등 여러 이유로 인해 가상환경을 구축하는 것이 일반적이다. Python을 사용하는 사람이라면 보통 Anaconda를 이용하여 패키지 관리나 가상환경 관리를 해봤을 것이다. 처음에 데이터 분석 프로젝트를 할 때  Anaconda를 사용하여 개발환경을 구축했었다. 하지만, Anaconda에서 default로 설치되는 패키지들 중에는 내가 필요한 패키지 이외의 것들이 많이 포함되어 있어 무거운 느낌이 들었다. 좀 더 가벼운 가상환경에서 작업을 하고 싶었던 터라 Python에서 기본으로 제공하는 venv를 이용하여 가상환경 관리를 해보기로 했다.  

 

파이썬에서는 패키지를 설치할 때는 보통 pip라는 패키지 매니저를 사용하는데, 기본적으로 해당 컴퓨터 상에서 파이썬이 설치된 경로의 site-packages 디렉터리에 안에 설치됩니다. 노드의 npm이나 자바의 maven과 같은 패키지 매니저가 프로젝트 별로 패키지 설치를 지원하는 반면에, 아직까지 파이썬의 pip는 시스템 전역으로만 패키지를 설치할 수 있습니다.

 

 

---

1. 아래 사이트를 참고하여 진행

제일 먼저 참고한 곳 !!

여러 버전의 파이썬 관리하기 (pyenv)

 

pyenv를 사용하여 Python 버전 관리하기

 

설치

1) 3.9.6

2) 3.11.6

 

 

---

2. Mac으로 진행

 

1) pyenv으로 버전 관리 - python 여러 버전 설치

 

 % pyenv install 3.11.6

python-build: use openssl@3 from homebrew
python-build: use readline from homebrew
Downloading Python-3.11.6.tar.xz...
-> https://www.python.org/ftp/python/3.11.6/Python-3.11.6.tar.xz
Installing Python-3.11.6...
python-build: use readline from homebrew
python-build: use zlib from xcode sdk
Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "/Users/name/.pyenv/versions/3.11.6/lib/python3.11/lzma.py", line 27, in <module>
    from _lzma import *
ModuleNotFoundError: No module named '_lzma'
WARNING: The Python lzma extension was not compiled. Missing the lzma lib?
Installed Python-3.11.6 to /Users/name/.pyenv/versions/3.11.6

 

해결: 

ModuleNotFoundError: No module named '_lzma'

 

% brew install xz

% pyenv uninstall 3.11.6

% pyenv install 3.11.6

 

 

---

2) Python 가상 환경 생성

2024.05.21

- python --version 해도 안 됨

- 경로 설정이 잘 못 된 거 같음

 

- 근데 잠깐... 문제가 생긴다..

- 그래서 2024.02.28 아래 내용은 참고만 해보기ㅠ

- 2월에는 분명 잘 됐는데.. 왜그런거야

 

> 2024.02.28

pyenv init

에 해당하는 내용을 추가

https://velog.io/@limdongyoung0/pyenv-Failed-to-activate-virtualenv

 

 

 

잘 된 모습을 확인

 

 

 

---

 

> 2024.05.21

 

python --version 하면 안 됨

 

해결:

[python3.x] pyenv로 설정한 python버전으로 정상동작되지 않을때

 

환경설정 다시 해주니까 되는데..!!

 

 

code ~/.bash_profile

 

아래 내용 추가 후에

source ~/.bash_profile

export PATH="$HOME/.jenv/bin:$PATH"
eval "$(jenv init -)"
eval "$(pyenv init --path)"

 

 

 

그리고 전역변수 설정!!!

 

Pyenv global 3.9.6

 

참고:

How to Fix Zsh: Command Not Found: Python [with Video]

 

 

진짜 뭐지? 됨!!

 

---

근데..!! 또 문제

 

터미널에서 " pyenv activate 가상환경이름 " 안 된다..!!!

 

 

해결:

pyenv activate 실행시 “Failed to activate virtualenv.” 에러 메시지 해결법

 

 

 

code ./zshrc

 

아래 내용 추가 후

source ./zshrc

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"

if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init -)"
fi

eval "$(pyenv virtualenv-init -)"

 

 

짜잔!!! 됨 ㅠㅠㅠㅠ 진짜ㅜ

---

 

인용문

https://hyun0k.tistory.com/entry/Python-venv%EB%A1%9C-%EA%B0%80%EC%83%81%ED%99%98%EA%B2%BD-%EA%B4%80%EB%A6%AC%ED%95%98%EA%B8%B0

[Python] venv로 가상환경 관리하기

 

 

https://www.daleseo.com/python-venv/

파이썬의 venv 모듈로 가상 환경 사용하기

 

 

 

---

가상환경 생성

 

$ pyenv virtualenv 3.9.9 venv_name

 

해당 프로젝트 디렉토리로 이동한 후 가상 환경 생성

$ cd <프로젝트 경로>

$ python3 -m venv <가상환경이름>

 

# 기본으로 python3이 설치되어 있기 때문에 python3으로 진행

 

 

project1라는 폴더에 가상환경을 만들 것이고 가상환경의 이름은 .venv 로 생성했다.

그러면 project1 폴더안에 .venv폴더가 생성된다.(나는 숨김 폴더로 만들었으므로 Finder에선 안보인다.) 

 

가상 환경을 구성할 프로젝트 디렉터리에 들어가서 아래와 같이 커맨드를 날리면 .venv라는 디렉터리가 생길 것입니다. 여기서 반드시 디렉터리 이름을 .venv로 할 필요는 없지만, 대부분의 파이썬 프로젝트들이 따르는 관행이므로 지켜주시는 게 좋습니다.

 

추가적으로 git을 이용하여 소스관리를 할 때 .venv 내용은 굳이 올릴 필요가 없으므로 .gitignore파일에 추가해준다.

$ echo '.venv' >> .gitignore

 

.venv 폴더안에는 가상환경에 필요한 기본 파일들이 생성되어 있다. bin폴더안에 가상환경을 활성화시키는 activate파일이 들어있다.

bin폴더에 들어있는 파일

가상환경이 생성되었으면 이제 활성화시켜야한다.

 

---

가상환경 활성화

가상환경 활성화를 위해서는 bin안에 activate파일을 실행시키면 된다.

$ pyenv activate venv1 

 

$. .venv/bin/activate

또는

$ source .venv/bin/activate

그러면 프롬프트앞에 (.venv) 가 나타나면서 가상환경이 활성화된 것을 확인할 수 있다.

가상환경이 활성화된 상태에서 pip install을 이용하여 프로젝트에 필요한 패키지를 설치하면 활성화된 가상환경에만 패키지가 설치된다.

---

가상환경 비활성화

가상환경 비활성화는 그냥 가상환경이 활성화된 상태에서 deactivate 하면 된다.

$ source deactivate

---

가상환경 삭제

가상환경을 삭제하는건 간단하다. 단순히 가상환경 디렉터리를 삭제해주면 된다.

나는 숨김폴더로 생성했으므로 Finder에서는 삭제할 수 없으므로 명령어를 통해 삭제해준다.

$ pyenv uninstall <가상환경 이름>

 

 

 

---

 

2024.05.22

 

근데 이제 왜 또!!! 안돼ㅠㅠㅠㅠㅠㅠㅠㅠㅠ

VSCode에서는 source deactivate 이게 자꾸 먹질 않는다,..

 

진짜 난리야..

The default interactive shell is now zsh. To update your account to use zsh, please run `chsh -s /bin/zsh`. For more details, please visit https://support.apple.com/kb/HT208050. (djangoFC) yMac:note_app name$ source deactivate grep: /bin/envVars.txt: No such file or directory grep: /bin/envVars.txt: No such file or directory grep: /bin/envVars.txt: No such file or directory The default interactive shell is now zsh. To update your account to use zsh, please run `chsh -s /bin/zsh`. For more details, please visit https://support.apple.com/kb/HT208050. (djangoFC) yMac:note_app name$

 

 

 

그래서 이젠 된다..

 

프로젝트할 때

1) 폴더 만들기

2) python -m venv 가상환경이름 만들기 - 그러면 폴더 안에 해당 가상환경이름으로 폴더가 만들어짐

3) 파이썬 인터프리터를 방금 만든 가상환경이름으로 설정하기 (파이썬 인터프리터 설정 - 맥: command+shift+P) 

 

4) 그리고 나갔다 들어오니까 가상환경 바뀐거 확인됨

5) 이제 여기에 패키지 등 설치하면 됨!!