تخطيط المستودع
لقد بنيت شيئا حقيقيا في المشاريع النهائية السابقة: مساعد دعم، ومستخرج وثائق، وبوابة تقييم. في الوقت الحالي، ربما يوجد هذا العمل كمجموعة من الخلايا أو كسكربت طويل واحد. مدير توظيف يفتح هذا العمل يجب عليه أن guess مكان الأشياء، ومسؤول توظيف يقوم بنسخه ولا يرى طريقة واضحة لتشغيله فيقوم بإغلاق التبويب فقط. الشيء الوحيد الأكثر تأثيرا مما يمكنك فعله لمشروع في ملفك الشخصي هو إعطاؤه boring, conventional layout حتى يتمكن أي شخص من إيجاد طريقه في غضون 30 ثانية.
ملاحظة صادقة مسبقة:هذه الوحدة تتعلق بـ repo، وليس بنشر سحابي مباشر. لا يمكننا تشغيل server أو push إلى host من داخل متصفحك، ولن نتظاهر بذلك. ما can تتعلمه وتثبته هنا هو الهيكل، والاختبارات، وأمر التشغيل الواحد الذي يجعل النشر سهلا لاحقا. ملاحظات النشر في النهاية هي بالضبط ذلك -> ملاحظات، مصنفة كغير مقيمة.
التخطيط الذي يتقارب عليه كل مشروع Python تقريبًا:
my_project/
README.md # what it is + how to run it
pyproject.toml # name, version, dependencies
.env.example # the shape of the secrets (NEVER the real ones)
src/
my_project/ # the importable package
__init__.py
__main__.py # runs on `python -m my_project`
core.py # your actual code
tests/
test_my_project.py # pytest finds these by the test_ prefix
أمران يجب ملاحظتهما. أولاً، تعيش الحزمة تحت src/ في مجلد يحمل اسم المشروع -> هذا هو "src layout"، وهو يمنع اختباراتك من استيراد المجلد المحلي بالخطأ بدلاً من الحزمة المثبّتة. ثانياً، اسم مجلد الحزمة يتبع اسم المشروع: مشروع اسمه triage يحصل على src/triage/، ومشروع اسمه copilot يحصل على src/copilot/. لا توجد إجابة ثابتة واحدة -> الشجرة دالة في الاسم.
مهمتك هي كتابة تلك الدالة. build_manifest(name)تأخذ اسم مشروع وتعيد قائمة الملفات التي يجب أن يحتوي عليها المستودع، كقائمة مرتبة من سلاسل مسارات. يجب أن تتضمن README.md، وpyproject.toml، ودليل حزمة تحت src/<name>/ يحتوي على __init__.py وملف وحدة، وملف tests/test_*.py. قم بتطبيع الاسم إلى دليل حزمة صالح (أحرف صغيرة، وتحويل المسافات والشرطات إلى شرطات سفلية، لأن doc-extractor ليس اسم وحدة قابلة للاستيراد ولكن doc_extractor هو كذلك).
هذا هو الملف الذي سينشئه نص برمجي للهيكل على القرص. نحن لا نكتب ملفات في المصحح -> نحن نتحقق من قدرتك على وصف الشجرة الصحيحة لأي اسم مشروع. اضغط Run لطباعة التخطيط لمشروع يسمى triage.
اكتب build_manifest(name) الذي يعيد شجرة ملفات المستودع لمشروع كقائمة sorted من سلاسل مسارات. يجب أن تتضمن README.md، pyproject.toml، دليل الحزمة تحت src/<pkg>/ مع __init__.py، و __main__.py (ذلك الملف هو ما يجعل python -m <pkg>، أمر التشغيل في الدرس 3، يعمل) وملف وحدة .py آخر واحد على الأقل، وملف اختبار باسم tests/test_<pkg>.py. قم بتطبيع name في دليل الحزمة (أحرف صغيرة، المسافات والشرطات تتحول إلى شرطات سفلية) بحيث ينتج اسم مشروع مختلف شجرة مختلفة.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.