فصل ششم: تست حرفه‌ای با pytest و بسته‌بندی پروژه

ساخت و انتشار بسته در PyPI

از کد محلی تا نصب با pip

پس از آماده‌سازی ساختار پروژه، مرحله‌ی بعدی ساخت (build) و انتشار (publish) بسته است. ابزار استاندارد برای ساخت بسته، پکیج build است:

pip install build twine
python3 -m build

این دستور دو فایل در پوشه‌ی dist/ می‌سازد: یک فایل .tar.gz (توزیع منبع) و یک فایل .whl (توزیع wheel که برای نصب سریع‌تر بهینه شده است). پیش از انتشار عمومی، توصیه می‌شود ابتدا بسته را روی TestPyPI (نسخه‌ی آزمایشی مخزن PyPI) منتشر کنید تا از صحت آن مطمئن شوید:

twine upload --repository testpypi dist/*
pip install --index-url https://test.pypi.org/simple/ my-package

پس از اطمینان از درستی بسته، انتشار نهایی روی مخزن اصلی PyPI با دستور زیر انجام می‌شود:

twine upload dist/*

برای این کار نیاز به ثبت‌نام در سایت PyPI و ساخت یک توکن API دارید که به‌جای رمز عبور در فرایند آپلود استفاده می‌شود. پس از انتشار، هر کاربری در دنیا می‌تواند با دستور pip install my-package بسته‌ی شما را نصب کند. رعایت نسخه‌بندی معنایی (Semantic Versioning) در فیلد version نیز به کاربران کمک می‌کند بفهمند هر بروزرسانی چه نوع تغییری (اصلاح جزئی، قابلیت جدید یا تغییر شکننده) به همراه دارد.

برای ذخیره‌ی پیشرفت و شرکت در آزمون، وارد شوید — رایگان است.