توجد الصفحة الرئيسية لـ joblib مع وثائق المستخدم على:
https://joblib.readthedocs.io
للحصول على أحدث التعليمات البرمجية باستخدام git، اكتب ببساطة:
استنساخ بوابة https://github.com/joblib/joblib.git
إذا لم يكن لديك git مثبتًا، فيمكنك تنزيل ملف مضغوط لأحدث كود: https://github.com/joblib/joblib/archive/refs/heads/main.zip
يمكنك استخدام النقطة لتثبيت joblib:
نقطة تثبيت joblib
من أي دليل أو:
تثبيت بيثون setup.py
من الدليل المصدر.
للمساهمة في joblib، قم أولاً بإنشاء حساب على github. بمجرد الانتهاء من ذلك، قم بتقسيم مستودع joblib ليصبح لديك مستودعك الخاص، وقم باستنساخه باستخدام "git clone" على أجهزة الكمبيوتر التي تريد العمل فيها. قم بإجراء تغييراتك في نسختك، وادفعها إلى حساب جيثب الخاص بك، واختبرها على عدة أجهزة كمبيوتر، وعندما تكون راضيًا عنها، أرسل طلب سحب إلى المستودع الرئيسي.
لتشغيل مجموعة الاختبار، تحتاج إلى pytest (الإصدار >= 3) ووحدات التغطية. قم بتشغيل مجموعة الاختبار باستخدام:
pytest joblib
من جذر المشروع.
لإنشاء المستندات، يجب أن يكون لديك أبو الهول (>=1.4) وتثبيت بعض التبعيات:
تثبيت النقطة -U -r .readthedocs-requirements.txt
يمكن بعد ذلك إنشاء المستندات باستخدام الأمر التالي:
جعل وثيقة
توجد مستندات html في الدليل doc/_build/html
.
لإنشاء كرة قطران مصدر، على سبيل المثال للتغليف أو التوزيع، قم بتشغيل الأمر التالي:
بايثون setup.py sdist
سيتم إنشاء كرة القطران في دليل dist. سيقوم هذا الأمر بتجميع المستندات، ويمكن تثبيت كرة القطران الناتجة دون أي تبعيات إضافية غير مكتبة بايثون القياسية. سوف تحتاج إلى أداة الإعداد وأبو الهول.
يتم تشغيل هذا الأمر فقط بواسطة مدير المشروع، لإصداره وتحميله إلى PyPI:
بايثون setup.py sdist bdist_wheel توزيعة التحميل البرمة/*
لاحظ أنه يجب تحديث الوثائق تلقائيًا عند كل عملية دفع للبوابة. إذا لم يكن الأمر كذلك، فحاول إنشاء المستند محليًا وحل أي خطأ في إنشاء المستند (خاصة عند تشغيل الأمثلة).
يتم سرد التغييرات في الملف CHANGES.rst. ويجب تحديثها يدويًا، ولكن يمكن استخدام أمر git التالي لإنشاء الأسطر:
سجل git --abbrev-commit --date=short --no-merges --sparse