دفاتر Jupyter: اختبارات من طرف إلى طرف والتوثيق في واحد
2024-12-18
خلال تطوير مكتبة حوسبة الكم، استخدم الكاتب دفاتر Jupyter كدلائل مستخدم واختبارات من طرف إلى طرف. من خلال قراءة متغيرات البيئة (مثل SERVER_URL) داخل الدفاتر، تم تحقيق المعلمات، مما يسمح بتنفيذها من قبل المستخدمين وأنابيب CI/CD الآلية. تم استكشاف طريقتين لتنفيذ الدفاتر: nbclient للبساطة، و nbconvert/jq لمزيد من التحكم ولكن بزيادة التعقيد. اختار الكاتب سهولة استخدام nbclient، مدمجًا بشكل فعال صيانة الوثائق واختبارات الكود، مما يضمن سلامة كليهما مع كل طلب دمج.
التطوير
اختبارات من طرف إلى طرف