Poetry ช่วยให้คุณประกาศ จัดการ และติดตั้งการขึ้นต่อกันของโปรเจ็กต์ Python เพื่อให้มั่นใจว่าคุณมีสแต็กที่ถูกต้องทุกที่
บทกวีแทนที่ setup.py
, requirements.txt
, setup.cfg
, MANIFEST.in
และ Pipfile
ด้วยรูปแบบโครงการที่ใช้ pyproject.toml
อย่างง่าย
[ tool . poetry ]
name = " my-package "
version = " 0.1.0 "
description = " The description of the package "
license = " MIT "
authors = [
" Sébastien Eustace <[email protected]> "
]
repository = " https://github.com/python-poetry/poetry "
homepage = " https://python-poetry.org "
# README file(s) are used as the package description
readme = [ " README.md " , " LICENSE " ]
# Keywords (translated to tags on the package index)
keywords = [ " packaging " , " poetry " ]
[ tool . poetry . dependencies ]
# Compatible Python versions
python = " >=3.8 "
# Standard dependency with semver constraints
aiohttp = " ^3.8.1 "
# Dependency with extras
requests = { version = " ^2.28 " , extras = [ " security " ] }
# Version-specific dependencies with prereleases allowed
tomli = { version = " ^2.0.1 " , python = " <3.11 " , allow-prereleases = true }
# Git dependencies
cleo = { git = " https://github.com/python-poetry/cleo.git " , branch = " main " }
# Optional dependencies (installed by extras)
pendulum = { version = " ^2.1.2 " , optional = true }
# Dependency groups are supported for organizing your dependencies
[ tool . poetry . group . dev . dependencies ]
pytest = " ^7.1.2 "
pytest-cov = " ^3.0 "
# ...and can be installed only when explicitly requested
[ tool . poetry . group . docs ]
optional = true
[ tool . poetry . group . docs . dependencies ]
Sphinx = " ^5.1.1 "
# Python-style entrypoints and scripts are easily expressed
[ tool . poetry . scripts ]
my-script = " my_package:main "
Poetry รองรับวิธีการติดตั้งหลายวิธี รวมถึงสคริปต์ง่ายๆ ที่พบใน install.python-poetry.org สำหรับคำแนะนำในการติดตั้งแบบเต็ม รวมถึงการใช้งานสคริปต์ขั้นสูง วิธีการติดตั้งแบบอื่น และแนวทางปฏิบัติที่ดีที่สุดของ CI โปรดดูเอกสารประกอบการติดตั้งฉบับเต็ม
เอกสารสำหรับเวอร์ชันปัจจุบันของ Poetry (รวมถึงสาขาการพัฒนาและเวอร์ชันที่ไม่รองรับล่าสุด) มีอยู่ในเว็บไซต์อย่างเป็นทางการ
กวีนิพนธ์เป็นโครงการขนาดใหญ่และซับซ้อนซึ่งต้องการผู้ร่วมให้ข้อมูลเสมอ สำหรับผู้ที่เพิ่งเริ่มโปรเจ็กต์นี้ มีรายการปัญหาที่แนะนำสำหรับการทำงานใน Poetry และ Poetry-core ไว้ให้บริการ เอกสารประกอบฉบับเต็มยังให้คำแนะนำที่เป็นประโยชน์อีกด้วย
ขอขอบคุณ JetBrains ที่สนับสนุนเราด้วยใบอนุญาตสำหรับเครื่องมือของพวกเขา