python-packaging
إنشاء حزم Python لـ PyPI
متاح أيضًا من: ActiveInferenceInstitute
غالبًا ما يتسبب تجهيز مشروع Python في حدوث أخطاء في الهيكل والبيانات الوصفية. توفر هذه المهارة تخطيطات واضحة وأمثلة تكوين ونشر خطوات لإنشاء حزم قابلة للتوزيع.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "python-packaging". أحتاج إلى pyproject.toml بسيط وتخطيط مجلد لمكتبة.
النتيجة المتوقعة:
- استخدم تخطيط src مع مجلد حزمة والاختبارات.
- حدد نظام البناء والبيانات الوصفية للمشروع في pyproject.toml.
- أضف التبعيات وأدوات التطوير الاختيارية.
- أضف README وLICENSE للتعبئة.
استخدام "python-packaging". كيف أقوم بإعداد أوامر CLI لحزمني؟
النتيجة المتوقعة:
- ثبّت Click كتبع.
- إنشئ وحدة cli.py مع أوامر click.
- حدد نقاط الدخول في قسم pyproject.toml.
- ثبّت في الوضع القابل للتحرير لاختبار الأوامر.
استخدام "python-packaging". ما هي خطوات النشر إلى PyPI؟
النتيجة المتوقعة:
- ابنِ الحزمة باستخدام python -m build.
- تحقق باستخدام twine check dist/*.
- ارفع إلى TestPyPI أولاً للاختبار.
- ارفع إلى PyPI باستخدام twine upload dist/*.
التدقيق الأمني
آمنPure documentation skill containing educational content about Python packaging. No executable scripts, network calls, file access, or code execution paths present. All static findings are false positives: the scanner misidentified repository names as cryptographic algorithms, bash documentation examples as shell execution, and legitimate config file references as credential access attempts.
عوامل الخطر
🌐 الوصول إلى الشبكة (25)
⚙️ الأوامر الخارجية (77)
📁 الوصول إلى نظام الملفات (2)
درجة الجودة
ماذا يمكنك بناءه
تعبئة وحدة قابلة لإعادة الاستخدام
تصميم هيكل نظيف وبيانات وصفية لمكتبة Python مشتركة.
شحن أداة سطر الأوامر
تعريف نقاط دخول وإصدار حزمة CLI إلى PyPI.
أتمتة النشر
إعداد سير عمل للإصدار مع خطوات البناء والرفع.
جرّب هذه الموجهات
Provide a minimal src layout and pyproject.toml for a small Python library named acme-tools.
Show how to add a click based CLI entry point called acme to an existing package.
List the steps to build wheels and publish to TestPyPI and PyPI using twine.
Draft a GitHub Actions workflow that builds and uploads on release creation.
أفضل الممارسات
- استخدم تخطيط src لاستيراد آمن
- اختبار التثبيت في بيئة نظيفة
- انشر إلى TestPyPI قبل PyPI
تجنب
- النشر دون التحقق من البيانات الوصفية
- الاعتماد على إعدادات setup.py الضمنية
- تخطي بناء wheels للإصدار
الأسئلة المتكررة
هل هذا متوافق مع التعبئة الحديثة لـ Python؟
ماذا لا تستطيع هذه المهارة فعله؟
هل يمكن أن تساعد مع CI أو GitHub Actions؟
هل تجمع أو ترسل بياناتي؟
ماذا لو فشل بنائي؟
كيف يقارن مع Poetry أو Flit؟
تفاصيل المطور
المؤلف
wshobsonالترخيص
MIT
المستودع
https://github.com/wshobson/agents/tree/main/plugins/python-development/skills/python-packagingمرجع
main
بنية الملفات
📄 SKILL.md