دليل تغليف Python والنشر على PyPI

هل سبق لك أن كتبت نصًا برمجيًا مفيدًا بلغة Python وتساءلت عن كيفية مشاركته مع العالم كمكتبة سهلة التثبيت؟ يكافح العديد من المطورين للانتقال من النصوص البرمجية المتفرقة إلى تعليمات برمجية نظيفة وقابلة للصيانة والتوزيع. يرشدك هذا المساق خطوة بخطوة خلال عملية تحويل مشروع Python صغير إلى حزمة احترافية جاهزة لـ Python Package Index (PyPI). ستتعلم كيفية هيكلة أدلة المشروع (directories)، وتكوين البيانات الوصفية (metadata)، وإعداد التعليمات البرمجية الخاصة بك للتوزيع. نبدأ بمصطلحات ومفاهيم التغليف الأساسية، مما يضمن فهمك لآلية تعامل Python مع عمليات الاستيراد والتبعيات (imports and dependencies) قبل كتابة أي ملفات تكوين. ما ستتعلمه: - فهم مفاهيم التغليف الأساسية، وحزم مساحات الأسماء (namespace packages)، وإدارة التبعيات (dependency management) - تكوين البيانات الوصفية الحديثة للتغليف باستخدام pyproject.toml وأدوات مثل Hatch أو Flit - بناء توزيعات المصدر (source distributions) وعجلات (wheels) لتغليف التعليمات البرمجية الخاصة بك بأمان - اختبار الحزمة الخاصة بك محليًا في بيئات افتراضية نظيفة باستخدام pytest - نشر مكتبتك المكتملة على TestPyPI وسجل PyPI الرسمي - تطبيق سير عمل التكامل المستمر (continuous integration workflows) الأساسي للتغليف الآلي تم تصميم هذا المساق النصي لمطوري Python المبتدئين والمتوسطين الذين يرغبون في مشاركة تعليماتهم البرمجية مع المجتمع أو فريقهم. لا تتطلب خبرة سابقة في التغليف، على الرغم من أنه يوصى بفهم أساسي لبنية Python واستخدام الطرفية (terminal usage). ابدأ في تنظيم تعليمات Python البرمجية الخاصة بك في حزم احترافية وقابلة لإعادة الاستخدام اليوم.