تكرار السؤال: …
الإجابة المختصرة
تثبيت الحزمة بحيث تشير إلى ملفات المصدر مباشرة (pip install -e .)، فتظهر تعديلاتك فورًا دون إعادة التثبيت.
الشرح
يُستخدم أثناء التطوير مع src layout، ويعمل وفق معيار PEP 660 عبر نظام البناء المحدد في pyproject.toml. لكنه ليس أداة نشر: نجاح التثبيت المعدّل لا يضمن أن الـ wheel المبنية تحتوي كل الملفات. لذلك ابنِ الحزمة واختبرها كما سيستلمها المستخدم في CI. ولاحظ أن تغيير metadata مثل entry points أو الاعتماديات يحتاج إعادة التثبيت.
مثال بالكود
python -m pip install -e ".[dev]"
# في CI: اختبر الحزمة المبنية لا المصدر
python -m build
python -m pip install dist/*.whl
pytestأخطاء شائعة
- الاعتماد على editable install في CI فلا تُكتشف ملفات ناقصة في الحزمة.
- تعديل entry points دون إعادة التثبيت ثم الاستغراب من عدم ظهور الأمر.