عن المشروع
Copier-python هو قالب Copier لإنشاء مشاريع Python جديدة مع سلسلة أدوات حديثة ومحددة مسبقاً. يتم استخدامه من سطر الأوامر لإنشاء مشروع في مسار مختار بدلاً من كونه مكتبة وقت تشغيل.
البداية السريعة
- تثبيت المتطلبات الأساسية: mise-en-place لإدارة سلسلة الأدوات، وCopier نفسه (على سبيل المثال عبر `mise use -g copier` أو `uv tool install copier`).
- إنشاء مشروع باستخدام الأمر `copier copy "gh:smkent/copier-python" /new/project/path`.
- يغطي موقع التوثيق المتطلبات وتفاصيل الاستخدام الإضافية.
الأدوات المضمنة
- mise-en-place ("mise") لإدارة سلسلة أدوات التطوير.
- مجموعة أدوات Astral: uv وruff وty.
- prek، التي توفر خطافات git متوافقة مع pre-commit.
- pytest كإطار عمل للاختبار، مع دعم codecov.io.
- Zensical لتوثيق المشروع، مع النشر التلقائي على GitHub Pages.
أتمتة التحديث والإصدار
- يتم دعم تحديثات المشروع من خلال Renovate جنباً إلى جنب مع `copier update` بحيث يمكن للمشاريع المنشأة سحب التغييرات من القالب.
- تغطي أتمتة الإصدارات نشر حزمة PyPI وبناء صورة حاوية (container image)، مدفوعة بواسطة GitHub Actions.
الاعتمادات
يذكر القالب أنه مستوحى من pawamoy/copier-uv و ritwiktiwari/copier-astral. يتم توزيعه بموجب ترخيص مدرج في المستودع، وهو منشور أيضاً على PyPI باسم copier-python.
الفئة المستهدفة
المطورون الذين يرغبون في نقطة بداية قابلة للتكرار لحزم وتطبيقات Python، مع تكوين إدارة التبعيات، والتدقيق/التنسيق (linting/formatting)، وخطافات git، والاختبار، والتوثيق، والإصدارات المدفوعة بـ CI منذ البداية، والذين يرغبون في إبقاء تلك المشاريع المنشأة قابلة للتحديث عند تغيير القالب.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.