파이썬 패키지를 개발할 때, 사용자 지정 명령어나 스크립트를 쉽게 추가하고 관리하기 위해 Poetry를 사용할 수 있습니다. Poetry는 의존성 관리와 패키지 빌드를 단순화해주는 도구로, PyPI에 배포하기 전에 패키지를 준비하는 과정에서 특히 유용합니다.

Poetry 설치하기

Poetry를 사용하기 위해서는 먼저 Poetry를 설치해야 합니다. Poetry는 파이썬 패키지 관리자인 pip를 사용하여 설치할 수 있습니다. 터미널 또는 명령 프롬프트에서 다음 명령을 실행하여 Poetry를 설치합니다.

pip install poetry

사용자 지정 명령어와 스크립트 추가하기

Poetry 프로젝트의 pyproject.toml 파일은 패키지의 메타데이터와 의존성을 정의하는 파일입니다. 이 파일을 사용하여 사용자 지정 명령어와 스크립트를 추가할 수 있습니다.

예를 들어, hello라는 명령어를 추가하고 해당 명령어를 실행할 때 “Hello, World!”를 출력하는 스크립트를 추가해보겠습니다. 다음과 같이 pyproject.toml 파일을 수정합니다.

[tool.poetry.scripts]
hello = "module_name:script_function"

module_name은 스크립트가 있는 모듈의 이름을 나타내고, script_function은 실행할 함수를 나타냅니다. 예를 들어, my_package.scripts 모듈 안에 hello()라는 함수가 있다면, module_name은 my_package.scripts가 되고, script_function은 hello가 됩니다.

스크립트 실행하기

스크립트를 실행하려면 터미널 또는 명령 프롬프트에서 다음 명령을 실행합니다.

poetry run hello

위 명령을 실행하면 “Hello, World!”가 출력됩니다.

마무리

Poetry를 사용하면 파이썬 패키지의 사용자 지정 명령어와 스크립트를 간편하게 추가하고 실행할 수 있습니다. pyproject.toml 파일을 수정하여 원하는 명령어와 스크립트를 추가하고, Poetry를 통해 손쉽게 실행해보세요. Poetry의 강력한 기능을 활용하여 개발 프로세스를 더욱 효율적이고 원활하게 만들 수 있습니다.

참고 자료

• Poetry 공식 문서: https://python-poetry.org/docs/
• Poetry GitHub 저장소: https://github.com/python-poetry/poetry