PyBookLib عبارة عن مكتبة مكونة من جزأين مصممة لاستضافة مشاريع رموز القوالب والحصول عليها. إنه مكتوب لبرامج Python بشكل أساسي، ولكن من الممكن استضافة لغات أخرى أيضًا. يحتوي PyBookLib على وحدتين فرعيتين، كل منهما مستقلة عن الأخرى: PyBook وPyLib. ليس لدى PyBookLib أي ارتباطات بمشاريع PyPI الحالية PyBook وPyLib. إنه مشروع منفصل تمامًا، وقد صادف أنه كان موضوعه المكتبة. ؟
يمكنك تثبيت الحزمة من خلال ما يلي:
pip install -U PyBookLib
إذا كنت تريد أحدث إصدار للتطوير، والذي يحتوي بالتأكيد على أخطاء، فقم بتشغيل ما يلي:
pip install git+https://github.com/BD103/PyBookLib
لسحب ملف تخفيض السعر هذا إلى وحدة التحكم، يمكنك تشغيل PyBookLib
في سطر الأوامر. يؤدي تشغيل pybook
أو pylib
إلى توفير قائمة بالأوامر المحتملة مع كل منهما.
لا تحتوي وحدة PyBookLib الرئيسية على وظيفة حالية تتجاوز جسر التعليمات البرمجية وتعرض ملف تخفيض السعر هذا في سطر الأوامر.
PyBookLib
الوظيفة الرئيسية لـ PyBook هي الاتصال بمكتبة مستضافة واستقبال الكتب (ملفات .zip
). يتم تعريف المكتبة التي يتم الوصول إليها بواسطة متغير بيئي. حاول تشغيل شيء مثل هذا:
from PyBookLib import pybook
import os
# Set environmental variable for library. Unecessary but helpful all the same
pybook . set_url ( "https://library.bd103.repl.co/api" )
# Gets a book "sample-library" from the user "BD103" with the version "1.2" and extracts contents to the directory "pylib-library"
pybook . get ( user = "BD103" , book = "sample-library" , version = "1.2" , direc = "pylib-library" )
باستخدام هذا البرنامج النصي البسيط، يتصل بـ Library.bd103.repl.co ويطلب عينة من المكتبة. هذا الكتاب عبارة عن نموذج نصي لاستضافة مكتبتك الخاصة. (تم إنشاؤه من أجل Replit، ولهذا السبب يوجد pyproject.toml.)
يمكنك أيضًا تشغيل بعض أوامر bash:
# Get a list of commands
pybook --help
pybook get-book BD103 sample-library --version 1.2 --direc pylib-library
pybook get-user BD103
# This should automatically be set to library.bd103.repl.co/api
pybook set-url https://link.to.site/api
# Umbrella get function to specify exact details
pybook get --user BD103 --direc folder
ليس عليك تحديد كل هذه المعلمات. حاول إزالة واستبدال بعضها وانظر ماذا سيحدث!
PyLib مخصص لاستضافة مكتبتك الخاصة. انها بسيطة للغاية. قم بتثبيت PyBookLib واختر المسار الخاص بك:
ملاحظة: ستقوم هذه المسارات تلقائيًا بتعيين عنوان IP والمنفذ على
0.0.0.0:8000
. إذا كنت تستخدم جهازًا محليًا، فيمكنك الاتصال من خلال المضيف المحلي:8000. إذا كنت تستخدم خدمة استضافة خادم، فيجب أن تقوم تلقائيًا بتعيين المضيف على نطاقك. إذا كنت تواجه تعارضات مع المنفذ، أو تريد عنوان IP مختلفًا، فيمكنك تحديده عن طريق اتباع مسار Python main.py واستبدالpylib.run()
بـpylib.run(host="1.2.3.4", port=8080)
.
قم بإنشاء ملف يسمى main.py. في الداخل، الصق ما يلي:
from PyBookLib import pylib
pylib . run ()
قم بتشغيل البرنامج النصي لبدء استضافة مكتبتك.
في سطر الأوامر، قم بتشغيل ما يلي:
pylib run
شاهد بينما يتم استضافة الخادم الخاص بك.
إذا كنت تريد المساهمة في هذا المشروع، فانتقل إلى github.com/BD103/ PyBookLib ، وأنشئ شوكة وطلب سحب. يجب تشغيل كافة التعليمات البرمجية من خلال الأوامر التالية:
black PyBookLib
isort PyBookLib --profile black
flake8 PyBookLib
لم يتم تنفيذ PyTest بعد. ابقوا متابعين! ؟