تنسيق ملف WHL

مراجعة

ملف WHL (العجلة) هو حزمة توزيع في تنسيق العجلات، مصممة لتسريع تركيب حزم Python. فإنه يعمل كحزمة ثنائية مبنية مسبقا لتوزيع بايثون، وتحتوي على جميع الملفات اللازمة والبيانات المعدلة المطلوبة لسهولة التثبيت دون الحاجة إلى تجميع من رمز المصدر. على غرار ملفات إعداد MSI، وWHL هي مستعدة لتثبت الأرشيفات التي تحدد ما هي إصدارات بيثون ومنصات أنها تدعم.

الخصائص الرئيسية

حزم ثنائية مبنية مسبقا: يسهل التثبيت من خلال توفير الحزم الثنائي المسبقة.
العلامات المحددة للمنصة: يضمن التوافق مع تطبيقات Python محددة، و ABIs، وأنظمة التشغيل.
Metadata Included: يحتوي على بيانات شاملة حول نسخة الحزمة والاعتماد عليها.
ZIP Archive Format: يستخدم ضغط ZIP للحد من حجم الملفات مع الحفاظ على سهولة الاستخراج.
معاهدة الاسم القياسية: تتبع مخطط أسماء متسق يتضمن اسم الحزمة والنسخة والعلامة Python و ABI و Platform Tag.

المواصفات التقنية

تشكيل الهيكل

ملفات WHL هي أساسا أرشيفات ZIP. إنها تغطي جميع الملفات اللازمة للتثبيت جنبا إلى جنب مع البيانات الميتا في تنسيق مضغوط لضمان توزيع فعال وسهولة الاستخراج باستخدام أدوات الاضطراب القياسية مثل WinRAR أو 7-Zip.

المكونات الأساسية

ميتادات التعبئة والتغليف: يحتوي على معلومات مثل اسم الحزمة ورقم النسخة والاعتمادات والنسخ المدعومة من Python.
الملفات الثنائية: ملفات ثنائي مخصصة للمنصة المحددة و ABI.
الرمز المصدر (اختياري): في بعض الحالات، قد يتم تضمين رمز مصدر لمنصات حيث التوزيع الثنائي غير ممكن.

المعايير والتوافق

تتوافق ملفات WHL مع معايير PEP 427 ، مما يضمن التوافر بين إصدارات Python المختلفة وأنظمة التشغيل.يتم دعمها على نطاق واسع من قبل مديري الحزمة الشعبية مثل pip و conda، مما يجعلها خيارًا متعدد الاستخدامات لتوزيع حزمة python.

التاريخ والتطور

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

العمل مع ملفات WHL

فتح ملفات WHL

لفتح أو عرض ملف WHL، يمكنك استخدام أي برامج تشويه ZIP القياسية مثل WinRAR، 7-Zip، أو حتى أدوات الاستخراج المدمجة المقدمة من قبل نظام التشغيل الخاص بك.

تحويل ملفات WHL

تحويل ملفات WHL ليست متطلبات شائعة لأنها مصممة للتثبيت المباشر باستخدام أنابيب أو مشغلي حزمة مماثلة.ومع ذلك، إذا كان التحويل ضروري (على سبيل المثال، إلى تنسيق آخر مثل tar.gz)، أدوات مثل: wheel يمكن استخدامها لإنتاج أنواع مختلفة من حزم التوزيع.

إنشاء ملفات WHL

يتم إنشاء ملفات WHL عادة باستخدام wheel هذه الأداة تسمح لك لبناء توزيعات العجلات من ملف setup.py من حزمة Python الخاصة بك، وضمان أن جميع البيانات المعدلة والبيانات الثنائية اللازمة يتم تضمينها في الأرشيف النهائي.

حالات الاستخدام المشترك

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

المزايا والقيود

المزايا:

توزيع فعال: البنود المبنية مسبقًا تقلل من الحاجة إلى تجميع المصدر.
** سهولة التثبيت**: يسهل عملية تركيب حزم معقدة.
المتوافقة على منصة محددة: يضمن التوافق مع تطبيقات Python المحددة و ABI.
Metadata Inclusion: يوفر بيانات متفوقة شاملة حول إدمانات الحزمة والنسخ.

الحد الأدنى:

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

الموارد التنموية

يتم دعم البرمجة مع ملفات WHL من خلال مختلف APIs والمكتبات.سيتم إضافة أمثلة على الرمز ودليل التنفيذ قريبا.

الأسئلة المتكررة

** كيف يمكنني فتح ملف WHL؟**يمكنك استخدام أي برامج تشويه ZIP القياسية مثل WinRAR، 7-Zip، أو أدوات الاستخراج المدمجة المقدمة من قبل نظام التشغيل الخاص بك لفتح ملف WHL.
**هل يمكنني تحويل ملف WHL إلى تنسيق آخر؟**في حين أن التحويل المباشر ليس شائعًا ، يمكنك استخدام wheel أداة لإنتاج أنواع مختلفة من حزم التوزيع من ملف setup.py الخاص بك.
**ما هي الاتفاقيات الاسمية لملفات WHL؟**ويشمل اسم ملف WHL النموذجي اسم الحزمة ورقم النسخة والعلامة Python (على سبيل المثال، cp35)، علامة ABI (مثل، abi3)، وعلامة المنصة (مثلا، macosx_10_9_x86_64).