الانتقال إلى المحتوى الرئيسي

كتابة الإعداد File.Py لبيثون: دليل مفصل

الإعداد file.py يلعب دورا رئيسيا في تركيب وتوزيع حزم بايثون. يحتوي على معلومات حول وحدة نمطية أو مكتبة يمكن استخدامها لإنشاء حزم التثبيت وإدارة التبعيات والإعدادات المهمة الأخرى.

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

كتابة إعداد فعال وتكوينه بشكل صحيح file.py يمكن أن يسهل إلى حد كبير عملية تثبيت واستخدام المكتبة أو الوحدة النمطية الخاصة بك. وسوف يساعد أيضا مطورين آخرين لنشر بسهولة والعمل مع المشروع الخاص بك. بغض النظر عما إذا كنت تقوم بتطوير برنامج مفتوح المصدر أو تريد فقط تبسيط عملية التكوين ، فهم كيفية الإعداد works.py هي مهارة مهمة لجميع مطوري بايثون.

  1. ما هو ملف? setup.py ?
  2. تعريف الملف setup.py
  3. دور الإعداد file.py في بايثون
  4. هيكل الملف setup.py
  5. تحديد المتغيرات في ملف الإعداد.الحمر
  6. سؤال وجواب
  7. ما هو ملف? setup.py ?
  8. كيفية إنشاء ملف setup.py ?
  9. ما هي الإعدادات الأساسية التي يمكن أن تكون في الملف setup.py ?
  10. كيفية إضافة التبعيات إلى ملف setup.py ?
  11. هل من الممكن تعيين إعدادات إضافية في الملف setup.py ?
  12. كيفية تثبيت حزمة باستخدام ملف setup.py ?

ما هو ملف? setup.py ?

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

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

الغرض الرئيسي من ملف الإعداد.الحمر-لتوفير عملية تثبيت حزمة بسيطة وتلقائية على أنظمة مختلفة. يمكن للمطورين تشغيل الأمر "بايثون setup.py تثبيت" لتثبيت الحزمة على نظامك ، ويمكن للمستخدمين الآخرين تثبيت الحزمة باستخدام الأمر "اسم حزمة تثبيت النقطة".

ملف الإعداد.قد تحتوي السنة التحضيرية أيضا على إعدادات إضافية ، مثل التعليمات الخاصة بنظام التشغيل أو أوامر المستخدم التي يتم تنفيذها أثناء التثبيت أو إنشاء الحزمة.

وثائق الإعداد file.py متاح على موقع بايثون الرسمي. يوفر معلومات مفصلة حول المعلمات المختلفة التي يمكن استخدامها في الإعداد file.py لتكوين عملية التثبيت.

تعريف الملف

setup.py الإعداد file.py هو ملف مطلوب للمشاريع في لغة برمجة بايثون. يحتوي على معلومات حول المشروع وتبعياته والحزم المثبتة. الإعداد file.py يستخدم لتثبيت وبناء وتوزيع المشروع.

الإعداد file.py هو برنامج نصي بيثون يحتوي على وظيفة الإعداد (). تحدد هذه الوظيفة خصائص وإعدادات المشروع ، مثل اسم المشروع والإصدار والمؤلف والوصف والتبعيات والمزيد.

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

الإعداد file.py غالبا ما يكون مصحوبا بملف README.md ، والذي يحتوي على وصف مفصل للمشروع وتعليمات للاستخدام ومعلومات مفيدة أخرى.

دور الإعداد file.py في بايثون

ملف الإعداد.الحمر هو جزء مهم من عملية تطوير حزمة الثعبان والتثبيت.

الدور الرئيسي لملف الإعداد.الحمر هو وصف الوحدة النمطية أو الحزمة التي تريد تثبيتها وتوفير جميع المعلومات اللازمة لتثبيت واستخدام تلك الحزمة.

في الإعداد file.py عادة ما يحتوي على المعلومات التالية:

  • اسم الحزمة: يشار إلى اسم الحزمة الخاصة بك.
  • الإصدار: يشار إلى الإصدار الحالي من الحزمة الخاصة بك.
  • المؤلف: يشار إلى اسم مؤلف الحزمة.
  • الوصف: يتم توفير وصف موجز للحزمة ووظائفها.
  • رابط: يتم توفير رابط إلى الصفحة الرئيسية للحزمة.
  • التبعيات المثبتة: يتم تحديد الحزم الأخرى التي تعتمد عليها الحزمة الخاصة بك.
  • الحزم المستخدمة: حدد الحزم اللازمة لتطوير الحزمة.
  • تحديد نقطة الدخول: تحديد نقطة الدخول إلى الحزمة الخاصة بك بحيث يمكن استخدامها.

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

الإعداد file.py يستخدم عادة مع ملفات أخرى مثل المتطلبات.النص أو MANIFEST.in لتحديد تبعيات أو ملفات إضافية يجب تضمينها في الحزمة.

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

بشكل عام ، ملف الإعداد.تلعب الحمر دورا مهما في تثبيت وإدارة حزم بايثون ، ويجب اعتبار إنشاء هذا الملف خطوة مهمة في عملية تطوير الحزمة.

هيكل الملف

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

فيما يلي الأقسام الرئيسية الموجودة عادة في الملف setup.py :

  • الواردات: عادة ما يتم تحديد جميع الواردات الضرورية في بداية الملف ، مثل أدوات الإعداد والإعداد والوحدات النمطية الأخرى.
  • معلمات المشروع: بعد ذلك يأتي تعريف معلمات المشروع ، مثل الاسم والإصدار والمؤلف والوصف والخصائص الأخرى للتطبيق. سيتم استخدام هذه المعلمات لإنشاء الحزمة والبيانات الوصفية الخاصة بها.
  • التبعيات: هنا يمكنك تحديد التبعيات على الحزم الأخرى المطلوبة حتى يعمل مشروعك. على سبيل المثال ، يمكنك تحديد أن التطبيق الخاص بك يتطلب حزمة نومبي أو قارورة.
  • التكوين: في هذا القسم ، يمكنك تحديد إعدادات مختلفة للتثبيت ، بما في ذلك مسارات الملفات والبرامج النصية وأدلة البيانات وما إلى ذلك. يمكنك أيضا إضافة الإعدادات الخاصة بك.
  • سيناريوهات التثبيت وبدء التشغيل: يحتوي هذا القسم على إرشادات لتثبيت مشروعك وتشغيله. يمكنك تحديد الملفات التي يجب نسخها ، والبرامج النصية التي يجب تثبيتها ، وما إلى ذلك.
  • خيارات أخرى: الإعداد file.py قد تحتوي على خيارات أخرى حسب مشروعك. على سبيل المثال ، يمكنك تحديد أن مشروعك هو وحدة تمديد أو استخدام وظائف محددة أخرى.

بشكل عام ، هيكل الإعداد file.py يعتمد على المشروع المحدد ومتطلباته. يمكن أن تستكمل وتخصيصها لتناسب احتياجاتك قدر الإمكان.

تحديد المتغيرات في ملف

setup.py الإعداد file.py يستخدم في مشاريع بايثون لتحديد المعلمات والإعدادات المختلفة المتعلقة بتغليف العبوات وتوزيعها وتركيبها. يحدد هذا الملف المتغيرات التي تم تعيينها وفقا لمعلمات المشروع المطلوبة.

تستخدم الأسطر التالية عادة لتحديد المتغيرات:

  • من إعداد استيراد سيتوبتولس
  • استيراد نظام التشغيل
  • ... (واردات أخرى)

المتغيرات القياسية التي سيتم تعريفها هي:

  1. الاسم-اسم الحزمة / المشروع.
  2. الإصدار-إصدار الحزمة / المشروع.
  3. الوصف-وصف موجز للحزمة / المشروع.
  4. المؤلف-مؤلف الحزمة / المشروع.
  5. البريد الإلكتروني للمؤلف هو عنوان البريد الإلكتروني لمؤلف الحزمة / المشروع.
  6. عنوان ورل-عنوان ورل للمشروع.

بالإضافة إلى ذلك ، يمكن تعريف متغيرات إضافية، مثل:

  1. الحزم-قائمة الحزم التي يجب تضمينها في الحزمة.
  2. البرامج النصية-قائمة الملفات التي سيتم تثبيتها على أنها قابلة للتنفيذ.
  3. متطلبات التثبيت هي قائمة التبعيات التي يجب تثبيتها قبل تثبيت الحزمة.
  4. المصنفات-قائمة التصنيفات (الفئات) التي تنتمي إليها الحزمة.
  5. الترخيص-الترخيص الذي يتم بموجبه توزيع الحزمة.
  6. الكلمات الرئيسية-قائمة بالكلمات الرئيسية المرتبطة بالحزمة.
  7. ... (متغيرات أخرى)

يتم تعريف المتغيرات باستخدام مهمة بسيطة. على سبيل المثال:

الاسم='حزمة'
الإصدار=‘1.0’
الوصف='حزمة بلدي'
المؤلف='اسم المؤلف'
المؤلف_البريد الإلكتروني='[email protected] '
…

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

سؤال وجواب

ما هو ملف? setup.py ?

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

كيفية إنشاء ملف setup.py ?

لإنشاء ملف setup.py يجب عليك إنشاء ملف جديد في محرر نصوص وحفظه بالاسم "setup.py ". في هذا الملف ، ستحدد الإعدادات والبيانات الوصفية لحزمتك.

ما هي الإعدادات الأساسية التي يمكن أن تكون في الملف? setup.py ?

في الإعداد file.py يمكنك تعيين الإعدادات التالية: اسم الحزمة ، إصدار الحزمة ، مؤلف الحزمة ، البريد الإلكتروني للمؤلف ، وصف الحزمة ، التبعيات على الحزم الأخرى وأكثر من ذلك بكثير.

كيفية إضافة التبعيات إلى ملف الإعداد.الحمر?

لإضافة تبعيات إلى ملف setup.py يمكنك استخدام معلمة "تثبيت" المتطلبات " وتحديد أسماء الحزم التي تعتمد عليها الحزمة الخاصة بك. على سبيل المثال ، تثبيت يتطلب=['طلبات' ، 'نومبي'].

هل من الممكن تعيين إعدادات إضافية في الملف setup.py ?

نعم ، يمكنك تعيين إعدادات إضافية في ملف الإعداد.الحمر ، مثل إعدادات تجميع الامتداد وإعدادات تغليف ملفات البيانات والمزيد. للقيام بذلك ، يمكنك استخدام الخيارات المختلفة التي يتم توفيرها في وثائق ديستوتيلز.

كيفية تثبيت حزمة باستخدام ملف setup.py ?

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