إعداد بيئتك

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

تستخدم العديد من أجزاء BeeWare نفس الأدوات: إصدار محدد من Python, وعناصر تحكم البيئة الافتراضية.

بايثون

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

بالنسبة للإرشادات التالية، سنفترض أنك تعرف بالضبط أي إصدار من بايثون تحتاج إلى تثبيته. عادةً ما يكون هذا في ملف 'README.md' أو في معلومات البرنامج التعليمي. لدينا يجب إخبار أنظمة [CI] (/المساهمة/المرة الأولى/ما هو/يجب إخبار أنظمة بالضبط أي إصدار من Python مطلوب أيضًا. لذا إن كنت حقًا فحاول البحث في ملف ".github/workflows/ci.yml" عن الإصدار الإصدار المحدد الذي تحتاجه.

للمساهمة في BeeWare، يجب أن يكون لديك مترجم Python مثبتًا على جهازك. على نظامي ماك وويندوز، نوصي باستخدام نوصي باستخدام [مثبتات Python.org الرسمية الرسمية] (https://www.python.org/downloads/)؛ على لينكس، نوصي باستخدام باستخدام إصدار Python الذي يوفره مدير الحزم الخاص بتوزيعك الخاص بك.

البيئات الافتراضية

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

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

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

توفر بايثون الوحدة النمطية 'vv' لإنشاء بيئات افتراضية جديدة. تمتلك كل بيئة افتراضية اسمًا يمكن استخدامه لتعريف البيئة. لإنشاء بيئة افتراضية جديدة باسم "my-venv"، قم بتشغيل:

$ python -m venv MY-venv

إصدار Python الذي تستخدمه لإنشاء البيئة الافتراضية سيكون هو الإصدار المستخدم افتراضيًا داخل البيئة الافتراضية الافتراضي. إذا كان لديك إصدارات متعددة من Python مثبتة، أو كنت تستخدم أداة مثل أو كنت تستخدم أداة مثل "pyenv" لإدارة إصدارات Python، تأكد من أن إصدار إصدار بايثون النشط حاليًا (أو الإصدار الذي تشير إليه عند استدعاء الأمر 'm venv') هو الإصدار الذي تريده. بمجرد إنشاء تم إنشاء بيئة افتراضية، لا يمكنك تغيير إصدار Python التي تستخدمها. لتغيير إصدار Python، تحتاج إلى إنشاء بيئة افتراضية جديدة.

سيؤدي استدعاء 'm venv' إلى إنشاء البيئة الافتراضية، لكن البيئة البيئة ليست نشطة بعد. البيئة الافتراضية عبارة عن مجموعة من الملفات الموجودة على القرص، مخزنة في دليل يطابق اسم البيئة. لتفعيل البيئة الافتراضية، تقوم بتشغيل أحد ملفات الملفات التي تم إنشاؤها كجزء من البيئة:

$ المصدر my-venv/bin/ACTivate

سيؤدي ذلك إلى إضافة بادئة إلى موجه سطر الأوامر لديك لتعلم أنك في بيئة افتراضية:

(my-venv) $

عندما تكون البيئة الافتراضية نشطة، فإن أي أمر 'تثبيت IP' سوف سيؤثر فقط على البيئة الافتراضية. لا يهم إذا قمت بتغيير الدلائل - إذا كانت موجهتك تحتوي على بادئة، فإن تلك البيئة الافتراضية تكون نشطة.

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

لإلغاء تنشيط البيئة الافتراضية، قم بتشغيل:

(my-venv) $ إلغاء التفعيل

بمجرد إلغاء التنشيط، سيتم إسقاط البادئة من المطالبة.