Puisi membantu Anda mendeklarasikan, mengelola, dan menginstal dependensi proyek Python, memastikan Anda memiliki tumpukan yang tepat di mana saja.
Puisi menggantikan setup.py
, requirements.txt
, setup.cfg
, MANIFEST.in
dan Pipfile
dengan format proyek sederhana berbasis 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 "
Puisi mendukung berbagai metode instalasi, termasuk skrip sederhana yang ditemukan di install.python-poetry.org. Untuk petunjuk penginstalan lengkap, termasuk penggunaan skrip tingkat lanjut, metode penginstalan alternatif, dan praktik terbaik CI, lihat dokumentasi penginstalan lengkap.
Dokumentasi untuk versi Puisi saat ini (serta cabang pengembangan dan versi yang baru-baru ini tidak lagi didukung) tersedia dari situs web resmi.
Puisi adalah proyek besar dan kompleks yang selalu membutuhkan kontributor. Bagi mereka yang baru mengenal proyek ini, tersedia daftar masalah yang disarankan untuk dikerjakan dalam Puisi dan inti puisi. Dokumentasi kontribusi lengkap juga memberikan panduan yang bermanfaat.
Terima kasih kepada JetBrains yang telah mendukung kami dengan lisensi untuk alat mereka.