6.4 · صندوق الأدوات

المستوى 6 · في الممارسة

6.4صندوق الأدوات

الهدف: امتلاك قوائم تحقق عملية وأوامر Python الأساسية.
الوقت المقدّر: 10 دقيقة · إذا كان لديك 5 دقائق فقط: اقرأ «الأساسي في 30 ثانية» + المخطط.

الأساسي في 30 ثانية

  • التسليم : سبعة نعم — ‏black ‏+ ruff، وpytest، ومتطلبات مثبتة، وتلميحات + ‏README، وسجلات نظيفة، وDocker نحيف، وCI ‏+ تراجع.
  • اليومي : ‏venv، وpytest، وruff، وتثبيت ووضع تطوير صارم دون تخبط.
  • القاعدة : قائمة تحقق مؤشرة في كل مرة خير من طريقة محفوظة — في الضغط، ننفذ.

خيط نبيل — البطاقتان قرب تتبع النفقات

بعد سنة، البطاقتان أدناه تبقيان قرب المشروع الخيط الأحمر لنبيل : بطاقة التسليم معروضة بجانب الشاشة، وبطاقة الأوامر اليومية في دفتره. « ما أنقذني، يقول بمعناه، ليس معرفة النقاط، بل تأشيرها في كل مرة — خصوصاً أيام اثنين التقارير. »

كيّف الصياغات مع سياقك، واحتفظ بالهيكلة : هي التي تتجنب النسيان والحوادث.

معالم جاهزة للاستعمال

قائمة تحقق جيدة تجعل التسليم هادئاً ودون نسيان ؛ والأوامر الجيدة تتجنب التخبط. للتكييف مع سياقك.

التسليم (سبعة نعم)

  • ‏black ‏+ ruff خضراوان، وpytest أخضر (اسمي + حدود).
  • متطلبات مثبتة، وvenv معاد بناؤه للإثبات.
  • تلميحات عند الحدود، وREADME مع تثبيت + استعمال.
  • سجلات مهيكلة، وأخطاء نظيفة، ولا except عارية.
  • ‏Dockerfile نحيف + ‏USER ‏+ .dockerignore ‏(إن كانت حاوية).
  • ‏CI خضراء، وأسرار خارج الشيفرة، ونسخة موسومة.
  • تراجع معروف ومختبر.

الأوامر اليومية

  • ‏python -m venv .venv ‏/ تفعيل / ‏pip install -r requirements.txt.
  • ‏pytest -q ‏/ ruff check . ‏/ black .
  • ‏pip freeze > requirements.txt.
  • ‏python -m pip list --outdated.
  • ‏python -X dev script.py ‏(وضع تطوير صارم).
خطأ شائع في الفهم: « جمع قوائم التحقق ». خطأ. قائمة التحقق لا تنفع إلا مؤشرة ومستعملة : خذ قائمة تسليمك التالي، والأخريات ستنتظر.
نص المخطط (SEO / قارئات الشاشة / الترجمة): لحظتان، وبطاقتان : 1) التسليم — سبعة نعم (فحص + اختبارات، وvenv معاد بناؤه، وتلميحات + ‏README، وسجلات، وDocker نحيف، وCI ‏+ نسخة، وتراجع). 2) اليومي — إنشاء/تفعيل venv، وتثبيت، واختبار، وتثبيت، ومراقبة في وضع تطوير صارم. الدرس : لا نفكر تحت الضغط، ننفذ البطاقة قرب المشروع الخيط الأحمر.

نص جاهز للقول — المصادقة على تسليم (30 ثانية)

« ‏black ‏+ ruff خضراوان، وpytest أخضر ؟ ‏venv معاد بناؤه من المتطلبات المثبتة ؟ ‏README محدث، وسجلات نظيفة، وDockerfile نحيف ؟ ‏CI خضراء، وأسرار خارج الشيفرة، ونسخة موسومة، وتراجع مختبر ؟ إن كان جواب لا، لا نسلّم. »

نموذج نسخ ولصق — متابعة التسليم (سطر واحد لكل نقطة)

suivi = {
    "lint (black + ruff)": "OK / a reprendre",
    "tests (pytest nominal + limites)": "OK / a reprendre",
    "venv reconstruit (requirements fige)": "OK / a reprendre",
    "hints + README": "OK / a reprendre",
    "logs + pas de except nu": "OK / a reprendre",
    "docker slim + CI verte": "OK / a reprendre",
    "version + rollback": "OK / a reprendre",
}

شركة صغيرة جداً / ميزانية صغيرة

بطاقات على صفحة معروضة على الجدار : الأساسي (venv، واختبارات، وتثبيت) يكفي.

شركة صغيرة ومتوسطة في الجزائر

توقع الواقع المحلي في البطاقة : مراجع معروفون، وذروات الاثنين، ونسخ احتياطية متحقق منها.

عن بعد / هجين

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

بين الثقافات

توضيح العناوين كتابة : ما يبدو بديهياً (من يصادق، وأي venv) ليس كذلك للجميع.

حذر: تذكير عام : الأسرار والنسخ والتراجعات تُحمّل منظمتك المسؤولية — أسرار خارج الشيفرة، ووصول محدود ومصادقة من المرجع المعين ؛ هذا الدليل لا يقدم رأياً قانونياً.

تحدي 48 ساعة — طبّق غداً

خذ مشروعاً حقيقياً واحداً، ومرر قائمة « التسليم (سبعة نعم) » وأشّر أين وصل. اختبر إعادة بناء venv.

قائمة الخروج من القسم
  • أشّرت قائمة تحقق على مشروع حقيقي.
  • أعرف إشهار التسليم والأوامر اليومية في الوقت المناسب.
  • أنجزت تحدي 48 ساعة أو برمجت تاريخه.
تقييم ذاتي 1-5 : تجهيز مشاريعي ؟استعمال القوائم مؤرخ ؟
تحقّق من فهمك

نبيل يستعد لتسليم تقريره المؤتمت. ماذا يجب أن يؤشر أولاً ؟