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

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

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

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

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

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

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

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

$ python pwb.py login -all -pass

سيسجل الدخول على كل المشروعات في user-config.py، باستخدام نفس كلمة المرور للجميع. حتى الآن، استخدام خيار -pass ليس مدعومًا. (T102477) ينبغي أن تستخدم بدلاً منه password file. قم بإنشاء ملف به نص مثل '("en", "wikipedia", "User", "password")' (يمكنك استخدام أكثر من سطر). ثم، قم بإدخال سطر 'password_file = "path_to_password_file"' في ملف user-config.py الخاص بك. بعد هذا ينبغي أن يستخدم باي ويكي بوت البيانات من هذا الملف حينما يحتاج إلى تسجيل الدخول. You should make user-config.py and password file unreadable for others (chmod 600 user-config.py) before adding secrets to it.

تسجيل الخروج

$ python pwb.py login -logout

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

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

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

1. Log into meta as your bot account. #قم بإنشاء تطبيق أوث في Special:OAuthConsumerRegistration/propose على ميتا إن لم تكن موجودة بعد، وقم بتسجيل مفتاح المستهلك والسر Until T323849 is resolved, only version 1.0a is supported
2. قم بتشغيل python pwb.py login -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:المسار	يقرأ بيانات الإعداد للبوت من المجلد المعطى من المسار، بدلاً من المجلد الافتراضي.
-config:file	The user config filename. Default is user-config.py.	user-config.py
-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	قد تستخدم كل متغيرات الإعداد العددية المعطاة على أنها خيارات وتعدلها بأمر سطري.