برای انتشار یک پروژه Python که با استفاده از Poetry مدیریت میشود، باید مراحل زیر را انجام دهید:
1. ایجاد یک مخزن در GitHub:
- وارد صفحه اصلی GitHub شوید.
- روی دکمه "New" یا "Create" کلیک کنید تا یک مخزن جدید ایجاد کنید.
- نام مخزن و سایر تنظیمات را تعیین کرده و مخزن را ایجاد کنید.
2. اتصال مخزن GitHub به محلی:
- ابتدا Poetry را برای ایجاد یک بسته سازگار با PEP 517 بسازید:
bash
poetry build
- سپس از
git
برای مدیریت نسخههای پروژه استفاده کنید:bashgit init git add . git commit -m "Initial commit"
- اتصال مخزن محلی به مخزن GitHub ایجاد شده:
bash
git remote add origin <URL_GitHub_Repository> git push -u origin master
3. ایجاد یک فایل .gitignore
:
- ایجاد یک فایل
.gitignore
که وابستگیها و فایلهای غیر ضروری را برایgit
نادیده میگیرد. - یک الگوی معمول برای یک فایل
.gitignore
ممکن است شامل مواردی مانند__pycache__/
,*.pyc
,*.env
و غیره باشد.
4. انتشار نسخههای جدید:
- هر بار که تغییرات جدیدی به پروژه اضافه میکنید و آمادهاید که آن را منتشر کنید، فایل
pyproject.toml
را بهروز کنید. - سپس از دستورات زیر برای ساخت و توزیع بسته استفاده کنید:
bash
poetry build
5. انتشار بسته بر روی GitHub:
- برای انتشار بسته بر روی GitHub، از دستورات زیر استفاده کنید:
bash
git add . git commit -m "Update project" git push origin master
6. انتشار بسته بر روی PyPI (اختیاری):
- اگر میخواهید بستهتان را بر روی Python Package Index (PyPI) منتشر کنید، از دستور زیر استفاده کنید:
bash
poetry publish --build
با انجام این مراحل، پروژه شما با استفاده از Poetry روی GitHub منتشر خواهد شد و کاربران دیگر قادر خواهند بود تا از آن استفاده کنند یا به آن مشارکت کنند.