دليل:باي ويكي بوت/login.py

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/login.py and the translation is 100% complete.

Other languages:
English • ‎català • ‎español • ‎français • ‎italiano • ‎suomi • ‎čeština • ‎русский • ‎العربية • ‎日本語 • ‎한국어
Git logo
مستودع جت لويكيميديا به هذا الملف: scripts/login.py

login.py هو برنامج بايثون يقوم بتسجيل المستخدم الذي يعمل على باي ويكي بوت على النظام الذي يستخدم البيانات والذي يمكن إيجاده في user-config.py .

الدخول بصفة البوت

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

إن كنت تريد تسجيل الدخول أيضًا بحسابك مدير النظام (حذف التصنيفات المنقولة...) لا بد أن تضيف

sysopnames['wikiproject']['languagecode'] = 'YourSysopUsername'

إلى user-config.py وتبدأ login.py بوسيط -sysop

كيف يعلم أين يسجل الدخول

في ملف user-config.py يوجد ثلاثة مكونات:

  1. اللغة: mylang
  2. العائلة: family - هذا يشير إلى اسم الويكي، متضمنًا ويكيبيديا أو ويكاموس
  3. اسم المستخدم: username - يمكن لهذا أن يكون أي مستخدم ولكن ينبغي أن يكون المستخدم المسجل ليعمل بصفته بوت.

حتى تتمكن من تسجيل الدخول إلى جميع المشروعات أو اللغات المذكورة في user-config.py، خيار -all يمكن استخدامه، وإن كانت نفس كلمة المرور مستخدمة عبر تلك المشروعات، يمكن دمجها باستخدام -pass حتى لا يطلب البرنامج لكلمة المرور لكل موقع.

python login.py -all -pass

سيسجل الدخول على كل المشروعات في user-config.py، باستخدام نفس كلمة المرور للجميع. حتى الآن، استخدام خيار -pass ليس مدعومًا. (T102477) ينبغي أن تستخدم بدلاً منه password file. قم بإنشاء ملف به نص مثل '("en", "wikipedia", "User", "password")' (يمكنك استخدام أكثر من سطر). ثم، قم بإدخال سطر 'password_file = "path_to_password_file"' في ملف user-config.py الخاص بك. بعد هذا ينبغي أن يستخدم باي ويكي بوت البيانات من هذا الملف حينما يحتاج إلى تسجيل الدخول.

تسجيل الخروج

python pwb.py login -logout

تسجيل الدخول باستخدام أوث

يدعم باي ويكي بوت تسجيل الدخول باستخدام تصديق أوث (OAuth) بدلاً من كلمة المرور. ميزة أوث تحتاج أن يكون Extension:OAuth مثبتًا على الموقع ومُعدًا بشكل صحيح. أوث أكثر أمانًا (كلمات المرور لا تُرسَل عبر الإنترنت، ويمكن إبطالها في أي وقت، وصلاحيات مستخدم البوت يمكن حظرها) وينبغي عامةً أن يكون مُفضلاً على تسجيل الدخول العادي. انظر Manual:Pywikibot/OAuth لكيفية استخدامه (لا يتضمن login.py).

إن كنت تريد لأي سبب من الأسباب تسجيل الدخول بالتوب في تطبيق أوث متعدد المستخدمين (ليس مستحسنًا، ولكن مثلاً ميدياويكي القديمة قد لا تدعم التطبيقات ذات المالك فقط)، يمكن استخدام login.py لذلك، باستخدام خيار -oauth. تتضمن العملية الخطوات التالية:

  1. قم بإنشاء تطبيق أوث في Special:OAuthConsumerRegistration/propose على ميتا إن لم تكن موجودة بعد، وقم بتسجيل مفتاح المستهلك والسر
  2. قم بتشغيل python login.py -oauth
  3. قم بإدخال مفتاح المستهلك لأوث
  4. قم بإدخال سر المستهلك لأوث
  5. قم بتوثيق المستخدم عبر متصفح الويب. قد تحتاج إلى نسخ المسار يدويًا من الطرفية إن كان المتصفح لا يفتح تلقائيًا.
  6. قم بإدخال نص استعلام استجابة إلى الطرفية عند نجاح التوثيق. مثلاً: oauth_verifier=xxx&oauth_token=yyy
  7. قم بنسخ ولصق مدخل التوثيق المُولَّد في user-config.py .
-logout و-pass و-force و-pass:XXXX و-sysop ليست متوافقة مع -oauth

الخيارات العامة متاحة

هذه الخيارات ستتجاوز ملف الإعداد في إعدادات user-config.py .

خيارات عامة
المتغيرالوصفمتغير الإعداد
-dir:المسار يقرأ بيانات الإعداد للبوت من المجلد المعطى من المسار، بدلاً من المجلد الافتراضي.  
-lang:xx يضبط لغة الويكي التي تريد العمل عليها، متجاوزًا الإعداد في user-config.py. ينبغي أن تكون xx هي رمز اللغة. mylang
-family:xyz يضبط عائلة الويكي التي تريد العمل عليها، مثل ويكيبيديا أو ويكاموس ويكي الرحلات... هذا سيتجاوز الإعدادات في user-config.py. family
-user:xyz سجل دخولك بمستخدم xyz بدلاً من المستخدم الافتراضي. usernames
-daemonize:xyz يُعيد السيطرة فورًا إلى الطرفية ويعيد تحويل stdout وstderr إلى الملف xyz. (تستخدم فقط للبوتات التي لا تتطلب دخلاً من stdin).  
-help إظهار نص المساعدة.  
-log تفعيل ملف السجل، باستخدام سجلات اسم الملف الافتراضي 'script_name-bot.log' وستُخزن في مجلد السجلات الفرعي. log
-log:xyz تفعيل ملف السجل، مع تسمية الملف باسم 'xyz'. logfilename
-nolog تعطيل ملف السجل (إن كان مُفعَّلاً افتراضيًا).  
-maxlag يضبط متغير تأخير أقصى جديد بعدد من الثواني. تأجيل تعديلات البوت أثناء فترات التأخير لخادم قاعدة البيانات. القيمة الافتراضية مضبوطة بملف config.py maxlag
-putthrottle:n
-pt:n
-put_throttle:n
يضبط أقل وقت (بالثواني) سينتظره البوت بين حفظ صفحتين. put_throttle
-debug:item
-debug
تفعيل ملف السجل وتضمين بيانات معالجة شاملة للمكون "item" (لجميع المكونات إن كان الشكل الثاني مستخدمًا). debug_log
-verbose
-v
جعل البوت يوفر خرج إضافي من وحدة التحكم قد يكون مفيدًا في المعالجة. verbose_output
-cosmeticchanges
-cc
ترجيح إعداد cosmetic_changes المحرر في config.py أو user-config.py إلى معكوسه وإلغائه. جميع الإعدادات الأخرى والقيود تبقى كما هي. cosmetic_changes
-simulate تعطيل الكتابة إلى الخادم. مفيد للاختبار والمعالجة للنص البرمجي الجديد (إن كان معطى، فإنه لا يقوم بأي تغيير حقيقي، ولكنه يعرض ما كان سيتغير). simulate
-<متغير إعداد>:n قد تستخدم كل متغيرات الإعداد العددية المعطاة على أنها خيارات وتعدلها بأمر سطري.  


انظر أيضا