هذا هو قالب الحزمة الذي نستخدمه داخليًا عند إنشاء أدوات جديدة تستند إلى Python CLI. إنه يحتوي على جميع الوظائف الأساسية وسير العمل اللازمة لإنشاء حزمة جديدة وبناء ونشر PYPI.
توفر هذه الحزمة أداة سطر الأوامر لمعالجة ومعالجة المهام المختلفة باستخدام مجموعة من الوسائط والتكوينات المحددة مسبقًا. يهدف المشروع إلى العمل كخط أساس لتطوير تطبيقات خط الأوامر المماثلة.
ويشمل ميزات مثل تحليل الوسيطة ، وإدارة التكوين ، وهيكل معياري لتسهيل تطوير الكود القابل للتطوير والقابل للصيانة.
نحن نقدم أيضا 2 قوالب أخرى نستخدمها.
argparse .لتثبيت حزمة CLI ، استنساخ المستودع وانتقل إلى دليل المشروع:
git clone https://github.com/DevelopersToolbox/template-package-cli.git
cd template-package-cliيوصى باستخدام بيئة افتراضية لإدارة التبعيات. يمكنك إنشاء وتنشيط بيئة افتراضية باستخدام الأوامر التالية:
python -m venv venv
source venv/bin/activate # On Windows, use `venvScriptsactivate`تثبيت التبعيات المطلوبة:
pip install -r requirements.txt لتشغيل حزمة CLI ، قم بتنفيذ الوظيفة main من البرنامج النصي الرئيسي:
python -m wolfsoftware.template_package_cli.main --required < value >يدعم التطبيق عدة وسيطات سطر الأوامر:
-h, --help : عرض رسالة مساعدة والخروج.-d, --debug : تمكين وضع التصحيح للإخراج المطول.-v, --verbose : تمكين الإخراج المطوّل لإظهار نتائج المسح عند وصولها.-V, --version : عرض رقم إصدار البرنامج والخروج.-i, --optional-integer : وسيطة عدد صحيح اختياري (افتراضي: 2).-s, --optional-string : وسيطة سلسلة اختيارية (افتراضي: "أنا").-r, --required : وسيطة سلسلة مطلوبة.مثال الاستخدام:
python -m wolfsoftware.template_package_cli.main -r " required_value " -i 10 -s " optional_string " تم تنظيم المشروع على النحو التالي:
template-package-cli/
├── wolfsoftware/
│ └── template_package_cli/
│ ├── __init__.py
│ ├── cli.py
│ ├── config.py
│ ├── exceptions.py
│ ├── globals.py
│ └── main.py
├── README.md
├── setup.py
└── requirements.txtwolfsoftware/template_package_cli : يحتوي على الوحدات الأساسية للتطبيق.cli.py : يتعامل مع وسيطات سطر الأوامر وتدفق البرنامج الرئيسي.config.py : معالجة إنشاء التكوين من وسيطات سطر الأوامر.exceptions.py : معالجة الاستثناءات المخصصة.globals.py : يحدد الثوابت العالمية المستخدمة عبر التطبيق.main.py : البرنامج النصي الرئيسي الذي ينظم تحليل الحجة وتنفيذ البرنامج.requirements.txt : يسرد التبعيات المطلوبة للمشروع.README.md : الملف الذي تقرأه حاليًا.