유용한Python 개발 환경 설정(feat. outlore.dev)

https://outlore.dev/blog/python-dev-2024/

How I manage Python in 2024

 

본글은 outlore.dev의 글을 OpenAI로 번역한 글입니다.

 

더 이상 스트레스 받을 필요 없음

 지난 5년간 Python 개발은 눈부시게 발전해 왔습니다. 저는 주로 JavaScript 개발자이지만, 버전 및 의존성 관리, 코드 포맷팅, 린팅, 타입 안전성을 제공하는 도구들이 성장하는 것을 보며 기뻤습니다.

 

요약:

• Python 버전 관리는 mise
• 가상 환경 관리는 mise
• 의존성 관리는 poetry 또는 uv
• 포맷팅과 린팅은 ruff
• 런타임 스키마 관리는 pydantic

---

Python 버전 관리

 저는 mise를 사용합니다. Mise는 Python뿐만 아니라 Go, Node.js, 기타 언어 및 런타임에서도 사용할 수 있습니다.

Mise는 팀의 리포지토리에 이미 존재할 수 있는 .python-version 및 .tool-versions 파일을 지원하며, .mise.toml 파일을 통해 추가 기능을 제공합니다. 예를 들어, 디렉토리를 변경할 때 가상 환경을 자동으로 생성할 수 있습니다.

.mise.toml 예제:

[tools]
python = "3.11"

[env]
_.python.venv = { path = ".venv", create = true } # 가상 환경이 없으면 생성

Mise가 대체하는 도구:

• pyenv
• asdf (가장 유사한 도구)
• brew Python 등

---

가상 환경

 가상 환경을 사용하면 시스템 Python이 설치된 패키지로 오염되는 것을 방지할 수 있습니다. (JavaScript 개발자라면 이를 node_modules 디렉토리와 유사하다고 생각할 수 있습니다.) Mise는 가상 환경을 자동으로 생성해 주므로 프로젝트별로 별도의 환경을 유지하기가 편리합니다.

 

Mise를 사용하지 않고도 Python 명령어를 통해 수동으로 가상 환경을 생성할 수 있습니다:

python -m venv .venv

 

Mise가 대체하는 도구:

• virtualenvwrapper
• pipenv 등

---

의존성 관리

사용 사례에 따라 uv와 poetry 중 하나를 선택합니다.

• uv:
  uv는 pip을 대체하는 빠른 패키지 관리 도구입니다. 또한 uv venv 명령어를 사용하여 가상 환경을 생성할 수 있습니다. uv는 향후 API 표면이 변경될 가능성이 있으니 주의가 필요합니다.
• poetry:
  구조화된 프로젝트를 위해 사용합니다. JavaScript의 npm과 유사하게 작동하며, pyproject.toml 파일이 package.json과 유사합니다. poetry는 가상 환경을 자동으로 생성하거나 이미 생성된 환경을 사용합니다.

pyproject.toml 예제:

[tool.poetry]
name = "poetry-demo"
version = "0.1.0"
description = ""
authors = ["Sébastien Eustace <sebastien@eustace.io>"]
readme = "README.md"
packages = [{include = "poetry_demo"}]

[tool.poetry.dependencies]
python = "^3.7"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

Mise와 Poetry의 조합은 버전 관리와 의존성 관리를 모두 처리할 수 있는 강력한 방법입니다.

대체 도구:

• pip
• pip-tools 등

---

포맷팅과 린팅

• ruff:
  코드 포맷팅, 린팅, import 정리를 수행할 수 있는 도구입니다. VSCode 확장도 지원합니다.
• Pylance:
  타입 검사 및 분석을 위해 사용합니다. VSCode에서 타입 체크를 활성화하려면 .vscode/settings.json에 다음을 추가하세요:

  {
  "python.analysis.typeCheckingMode": "basic"
  }

Ruff가 대체하는 도구:

• black
• pylint
• isort
• autopep8 등

Tip. Visual Studio Code Formatter 단축키 Option + Shift + f

---

런타임 스키마

• pydantic:
  데이터 유효성을 검사하고 직렬화하는 데 사용되는 라이브러리입니다. Python에서 TypeScript의 zod와 유사한 역할을 합니다.

대체 도구:

• dataclasses 등