python pyenv poetry

더 나은 파이썬 개발 환경 구축

파이썬 개발시 불편한 것들

파이썬으로 처음 개발을 해보면 쉽다! 라고 많이 이야기 합니다. 하지만 실제로 어느 정도 개발을 진행하다보면 언어가 쉽게 느껴지는거지, 개발 환경을 구축하는게 다른 언어에 비해 불편한점이 많습니다.

  1. 파이썬 버전 관리
  2. pip 사용시 패키지 관리
  3. 가상환경 세팅

Windows에서는 동작하지 않는 패키지도 있기에 반드시 Windows 자체에서 파이썬으로 개발하지 마시고, WSL을 사용하시길 바랍니다.

더 나은 파이썬 환경 구축 방법에 대해서 알아보겠습니다.

파이썬 버전 관리 문제점

파이썬을 사용하다보면 “성능이 다른 언어에 비해 떨어진다.” 라는 말을 많이 듣습니다. 그럼 그 때마다 이런말에 혹합니다.

note : 이번 새로운 버전 3.XX 에서는 몇 퍼센트 성능 향상이…
나 : “ㅇㅋ 당장 파이썬 버전 올리러 간다!”

하지만 실제로 그렇게 하면…

  1. 이전 버전에서는 동작하던 패키지가 동작하지 않음.
  2. 어떤 서버는 파이썬 버전 3.8 어떤 서버는 3.12 …
  3. 시스템 기본 설치 되어있는 파이썬 버전 올리는 것도 잘 안돼.

그림 1. 쳐 맞기전 까지는

> 파이썬 버전 관리는 생각보다 빡세다.

파이썬 버전 관리 : pyenv

파이썬을 직접 여러 버전을 설치하고 관리하는 것은 매우 불편하고 빡셉니다. 제가 추천하는 방법은 pyenv입니다. pyenv는 여러 버전의 파이썬 관리하고 설치할 수 있는 도구입니다. 다양한 프로젝트에서 필요한 버전을 손쉽게 전환할 수 있게 해줍니다.

설치 방법은 간단합니다. penv 깃허브 링크를 보시고 따라하시면 됩니다.

1. 설치

brew 또는 curl을 통해 설치가 가능합니다.

$ curl https://pyenv.run | bash

2. 쉘 설정

설치 후에는 쉘 설정 파일(~/.bashrc, ~/.zshrc 등)에 다음 줄을 입력해줍니다.

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

3. 설치 확인

설치가 끝나면 쉘을 재 시작하고 제대로 설치가 됐는지 확인합니다.

$ pyenv --version

4. 특정 버전 설치

설치가 됐으니 이제 설치가 가능한 파이썬 버전을 확인하고 특정 버전을 설치합니다.

$ pyenv install --list

$ pyenv install 3.8.10

5. 버전 지정하기

global 옵션으로 시스템 전체에서 사용할 기본 버전을 설정합니다. 반대로 local로 특정 디렉토리에서 사용할 버전을 설정할 수 있습니다.

$ pyenv global 3.8.10

$ cd my_project
$ pyenv local 3.7.9

6. 사용가능한 버전 확인

현재 설치된 파이썬 버전 목록을 확인 할 수 있습니다.

$ pyenv versions

pip 패키지 관리의 어려움

pip는 2008년에 처음 만들어졌습니다. “package installer for Python” 약자로, 파이썬 패키지 관리자로써 표준 라이브러리의 일부로 포함되어 있습니다.

처음에 pip를 이용해 필요한 패키지를 땡겨오면 굉장히 편리하다. 하지만 해당 패키지에 의존성이 있는 패키지까지 같이 딸려오면서 문제가 생기기 시작합니다.

  1. 이 패키지가 어디서 딸려온거지? 이거 지워도 되나?
  2. 이거는 다른 패키지에도 쓰는데 버전이 안 맞는데?
  3. 내가 설치한 패키지가 뭐였지?

pip는 편리하지만 점점 설치하는 패키지가 많아질수록 실제로 관리가 전혀 안돼는 상태라고 생각하면 됩니다. 패키지를 설치하고 requirements로 관리가 안될때가 많습니다. 언제부터 무슨 패키지가 어디서 어떻게 빠져있는지도 모르는 경우가 많습니다.

패키지 관리 : Poetry

pip의 패키지 관리 문제를 해결하기 위해서 여러가지 방안이 있지만, 제가 써본것 중에서는 Poetry를 가장 추천합니다.

Poetry는 파이썬 패키지 및 프로젝트 관리를 위한 도구로, 종속성 관리를 쉽게 하고 프로젝트 환경을 더 효율적으로 설정할 수 있도록 도와줍니다. Poetry는 종속성 설치, 프로젝트 패키징, 배포 등을 포함한 여러 기능을 제공합니다.

설치 방법은 간단합니다. Poetry 설치 페이지를 보시고 따라하시면 됩니다.

1.pipx 설치

pipx는 파이썬 애플리케이션을 격리된 가상 환경에서 설치하고 실행할 수 있게 해주는 도구입니다. pipx 설치를 진행합니다.

$ sudo apt update
$ sudo apt install pipx
$ pipx ensurepath
$ sudo pipx ensurepath --global

2.pipx 로 Poetry 설치

아래의 명령으로 Poetry를 설치합니다.

$ pipx install poetry

3. Poetry 설치 확인

Poetry가 제대로 설치됐는지 확인합니다.

$ poetry --version

4. Poetry로 프로젝트 초기화

Poetry를 사용할 프로젝트 폴더로 이동해서 세팅해줍니다. init 명령을 사용해서 Poetry가 사용하는 pyproject.toml 파일이 생성을 할 수 있습니다. Poetry가 설치되어 있다면 해당 파일을 공유하여 동일한 환경을 손쉽게 구축 할 수 있습니다.

$ poetry init -n --python=^3.12

5. 패키지 추가, 삭제

add 명령을 통해 패키지를 추가 할 수 있습니다. 추가된 패키지는 pyproject.toml 파일에 기록됩니다. remove 명령으로 패키지를 삭제할 수 있습니다.

패키지를 설치할때 그룹을 지정 할수 있습니다. 지정한 그룹만 설치하거나 그룹만 제외하고 설치하는 등 유용하게 사용 할 수 있습니다.

$ poetry add fastapi

$ poetry remove fastapi

$ poetry add mypy -G dev

6. Poetry 패키지 설치

install 명령을 통해 pyproject.toml 파일에 기록된 모든 패키지를 설치합니다. 그룹에 상관이 전체가 설치됩니다. 특정 그룹만 또는 제외하고 설치 할 수도 있습니다.

$ poetry install

$ poetry install --with dev

$ poetry install --without test,docs

7. 가상환경(.venv) 생성 위치

기본 설정으로 패키지를 설치하게 되면 가상환경이 Poetry가 관리하는 기본 폴더에 각 가상환경(.venv)가 생성됩니다.

프로젝트 내에 가상환경을 생성하게 할 수도 있습니다. 아래의 옵션을 통해 pyproject.toml 파일이 존재하는 프로젝트 내에서 가상 환경(.venv)이 만들어지게 세팅하는 옵션을 활성화 시킬 수 있습니다.

$ poetry config virtualenvs.in-project true

정리

파이썬은 여러 버전을 각 프로젝트에 맞게 사용해야 경우가 많습니다. 그런 경우 pyenv를 사용하여 여러 파이썬 버전을 손쉽게 관리 할 수 있습니다.

pip는 프로젝트가 커질수록 패키지 관리가 어렵기 때문에 Poetry를 사용하여 패키지를 명확히 관리하고 가상환경까지 편리하게 구성할 수 있습니다.

여기까지 좀 더 나은 파이썬 개발 환경을 구축하는 방법에 대해 알아보았습니다! 이것보다 각 상황에 알맞은 관리 도구들이 많이 있으니, 자신에게 맞는 파이썬 개발 환경을 구축하는 방법을 찾아 보시길 바랍니다. 😊

python pyenv poetry