كيفية تحويل برنامج بايثون الخاص بك إلى ملف .egg باستخدام setuptools

إذا كنت مطور بايثون تبحث عن نشر تطبيقك، قد تكون قد واجهت الحاجة إلى حزم الشيفرة البرمجية الخاصة بك إلى تنسيق يمكن توزيعه وتثبيته بسهولة. أحد هذه التنسيقات هو ملف .egg. في هذه التدوينة، سنستكشف كيفية تحويل برنامج بايثون الخاص بك بكفاءة إلى ملف .egg باستخدام أداة تُدعى setuptools. هذه الطريقة تبسط عملية النشر الخاصة بك وتجعل الأمر أسهل على الآخرين لاستخدام شيفرتك.

فهم ملفات .egg

قبل أن نبدأ في العملية، من المهم فهم ما هو ملف .egg بالضبط. ملف .egg هو تنسيق توزيع لحزم بايثون. إنه في الأساس أرشيف ZIP يحتوي على الشيفرة المصدرية، والبيانات الوصفية، والموارد اللازمة لتثبيت تطبيق بايثون الخاص بك. استخدام ملفات .egg يساعد في إدارة التبعيات ويجعل عملية النشر سلسة.

دور setuptools

لإنشاء ملفات .egg، ستحتاج إلى حزمة برمجية تُدعى setuptools. هذه عبارة عن امتداد لحزمة distutils المدمجة، والتي تتوفر في مكتبة بايثون القياسية. يوفر setuptools ميزات إضافية ويجعل من السهل جدًا حزم مشاريع بايثون الخاصة بك في تنسيق قابل للتوزيع.

خطوات إنشاء ملف .egg

دعونا نفصل الخطوات المطلوبة لتحويل برنامج بايثون الخاص بك إلى ملف .egg:

الخطوة 1: تثبيت setuptools

تأكد من أن setuptools مثبتة في بيئة بايثون الخاصة بك. يمكنك عادةً تثبيتها عبر pip إذا لم تكن موجودة بالفعل. افتح الطرفية الخاصة بك وقم بتشغيل الأمر التالي:

pip install setuptools

الخطوة 2: إنشاء ملف setup.py

في الدليل الجذر لمشروع بايثون الخاص بك، ستحتاج إلى إنشاء ملف setup.py. يحتوي هذا الملف على جميع البيانات الوصفية المتعلقة حزمتك، مثل اسمها، وإصدارها، ومؤلفها، وأي تبعيات.

إليك مثال أساسي لما يمكن أن يبدو عليه setup.py الخاص بك:

from setuptools import setup

setup(
    name='your_package_name',
    version='0.1',
    packages=['your_module_name'],
    install_requires=[
        'dependency1',
        'dependency2',
    ],
)

• name: اسم حزمتك.
• version: الإصدار الحالي (التزم بإصدار دلالي).
• packages: قائمة بجميع الوحدات التي سيتم تضمينها في الحزمة.
• install_requires: قائمة بالتبعيات المطلوبة لتشغيل حزمتك.

الخطوة 3: بناء ملف .egg الخاص بك

بمجرد إعداد ملف setup.py، يمكنك إنشاء ملف .egg. يتم ذلك عن طريق تشغيل الأمر التالي في الطرفية الخاصة بك من الدليل الجذر لمشروعك:

python setup.py bdist_egg

سيولد هذا الأمر ملف .egg تحت دليل جديد يسمى dist في مجلد مشروعك. سترى ملفًا يحمل اسمًا مثل your_package_name-0.1-py3.8.egg، والذي هو الآن حزمتك القابلة للتوزيع وجاهزة للاستخدام.

الخاتمة

تحويل برنامج بايثون إلى ملف .egg هو عملية مباشرة عندما يكون لديك setuptools في أدواتك. مع بضع خطوات بسيطة - تثبيت setuptools، إنشاء ملف setup.py، وتشغيل أمر واحد - يمكنك حزم تطبيقات بايثون الخاصة بك بكفاءة. هذا التنسيق .egg لا يبسط عملية النشر فحسب، بل يساعد أيضًا في إدارة التبعيات، مما يجعل من السهل على المستخدمين تثبيت واستخدام برنامجك.

من خلال اتباع هذا الدليل، يجب أن تشعر الآن بالثقة في حزم برامج بايثون الخاصة بك إلى ملفات .egg، مما يسمح بتوزيعها وتثبيتها بسهولة عبر بيئات مختلفة. جرب ذلك في مشروعك القادم وحقق أقصى استفادة من عمليات النشر الخاصة بك اليوم!