مقدمة

PyFabricate هو تطبيق لنظام التشغيل Mac OS X يعمل على تبسيط إنشاء مشاريع Python. منذ أن قمت بتأليفه، فمن الواضح أنها نسخة معتقدة لما أعتقد أنه يجب أن يبدو عليه مشروع بايثون. بالإضافة إلى ذلك، لدي مجموعة أدوات معينة أستخدمها لتمكيني من كتابة تطبيقات Python Mac OS X. ومع ذلك، حاولت إنشاء القليل من التخصيص من خلال الكشف عن القوالب التي أقوم بإنشاء ملفات المشروع منها. المزيد عن هذا لاحقًا.

ملخص

يستخدم PyFabricate واجهة تشبه المعالج للاستعلام عن تفاصيل المشروع.

الافتراضات المبنية على الرأي

• يستخدم المطور HomeBrew لتثبيت التبعيات التي تم تحديدها.

  • تتم إدارة بايثون عبر pyenv (للاستخدام في البيئات الافتراضية التي تم إنشاؤها)
  • تم تثبيت direnv (اختياري)

• اسم المشروع هو نفس اسم حزمة الوحدة

تثبيت

احصل على الإصدار الحالي من هنا.

انسخ هذا الملف إلى مجلد تطبيقات Mac OS. التطبيق موقّع برمز Apple، لذا ستصلك رسالة بسيطة عليك الإقرار بها في المرة الأولى التي تقوم فيها بتنفيذه.

تفاصيل الهيكل العظمي للمشروع

ما يلي هو عينة من الهيكل الأولي الذي أنشأه PyFabricator. فهو يُظهر الآن البيئة الافتراضية التي يقوم بإنشائها. المزيد عن هذا لاحقًا.

بشكل أساسي، يقوم PyFabricate بإنشاء مجلدات src واختبارات. في الدليل الجذر للمشروع يقوم بإنشاء الملفات التالية:

• .إنفرك
• .gitignore
• .mypi.ini
• .python_version
• .رخصة
• README.md
• pyproject.toml
• المتطلبات.txt

بالإضافة إلى ذلك، يقوم PyFabricate بإنشاء جميع ملفات حزمة python (__init__.py) في جميع الأماكن المناسبة. وأخيرًا، فإنه يضع مجموعتين من ملفات تكوينات التسجيل، واحدة للتطبيق الخاص بك والأخرى لاختبارات الوحدة الخاصة بك.

في نهاية عملية التصنيع، تقوم PyFabricate بإنشاء بيئة بايثون الافتراضية. نظرًا للقيود التقنية، لا يمكن لـ PyFabricate استخدام إصدار pyenv من Python لإنشاء البيئة الافتراضية. وبالتالي، يعتمد الأمر على الإصدار المثبت محليًا.

واجهة مستخدم المعالج

واجهة مستخدم المعالج عبارة عن عملية مكونة من 4 خطوات حيث يقوم PyFabricate بجمع تفاصيل المشروع الكافية التي يستخدمها لملء قوالب الهيكل العظمي. تستخدم القوالب رموز الاستبدال الواضحة التالية.

ما يلي هو رسم توضيحي لقالب pyroject.toml.

معالج واجهة المستخدم الخطوة 1 - مقدمة

هذه الخطوة هي مقدمة لـ PyFabricate. بعد هذه الخطوة، يبذل PyFabricate قصارى جهده لضمان استيفاء تبعيات التنفيذ الخاصة به. إذا لم يكن الأمر كذلك، فلن يتمكن المطور من متابعة هذه الخطوة.

معالج واجهة المستخدم الخطوة 2 - تفاصيل المشروع

في هذه الخطوة، تقوم PyFabricate بجمع معلومات محددة عن المشروع. يعمل معظم هذا على ملء قالب pyproject.toml.

معالج واجهة المستخدم الخطوة 3 - الدليل الأساسي

يفترض PyFabricate أن المطور يحتفظ بجميع مشاريع Python الخاصة به في دليل فرعي واحد. هذه وجهة نظر عنيدة وهي ببساطة تفضيل تنظيمي.

معالج واجهة المستخدم الخطوة 4 - إصدار بايثون

يستعلم PyFabricate عن pyenv لإصدارات Python التي قام المطور بتثبيتها. هذه هي البيئات الوحيدة التي يمكن لـ PyFabricate من خلالها إنشاء بيئات بايثون الافتراضية.

سجل العمل

في نهاية المعالج، يقدم PyFabricate سجلاً أثناء إنشاء المشروع. وفيما يلي مثال على السجل.

التخصيص

كما ذكرنا سابقًا، يمكن للمطور تخصيص بعض جوانب إنشاء المشروع. يقوم PyFabricate بتخزين القوالب التي يستخدمها في $HOME/.config/pyfabricate/templates كما هو مذكور أدناه.

على سبيل المثال، قد يرغب أحد المطورين في استخدام ترخيص مختلف. ببساطة، استبدل ملف LICENSE.template

اختتم

PyFabricate حاليًا في الإصدار 0.5.0 فقط. أقوم حاليًا بالتحقيق في إضافة ميزات إضافية وإزالة القيود.