يساعدك 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 (بالإضافة إلى فرع التطوير والإصدارات التي انتهت دعمها مؤخرًا) على الموقع الرسمي.
الشعر مشروع كبير ومعقد يحتاج دائمًا إلى مساهمين. بالنسبة لأولئك الجدد في المشروع، تتوفر قائمة بالقضايا المقترحة للعمل عليها في الشعر وجوهر الشعر. توفر الوثائق المساهمة الكاملة أيضًا إرشادات مفيدة.
شكرًا لـ JetBrains لدعمنا بتراخيص أدواتهم.