EarwigBot เป็นหุ่นยนต์งูหลามที่แก้ไขวิกิพีเดียและมีปฏิสัมพันธ์กับผู้คนกว่า IRC & nbsp;. ไฟล์นี้จะให้ภาพรวมพื้นฐานของวิธีการติดตั้งและการตั้งค่าบอ; รายละเอียดเพิ่มเติมจะอยู่ในเอกสาร / directory (ออนไลน์ที่ PyPI)
ประวัติศาสตร์
การพัฒนาเริ่มขึ้นอยู่กับกรอบ Pywikipedia ในช่วงต้นปี 2009 ได้รับการอนุมัติสำหรับงานของกำปั้นตรวจจับการละเมิดลิขสิทธิ์ได้รับการดำเนินการในเดือนพฤษภาคมและ ธ ปทได้รับการทำงานอย่างต่อเนื่องนับตั้งแต่ (ยกเว้น ม.ค. / กุมภาพันธ์ 2011) มันกำลังจัดการงานอย่างต่อเนื่องหลายตั้งแต่รุ่นสถิติล้างประเภทและงานตามความต้องการเช่นการติดแท็กวิกิแม่แบบ ตั้งแต่เริ่มต้นการทำงานของ ธ ปทได้ทำกว่า 50,000 แก้ไข
โครงการที่จะเขียนมันตั้งแต่เริ่มต้นเริ่มต้นขึ้นในช่วงต้นเดือนเมษายน 2011, จึงย้ายออกไปจากกรอบ Pywikipedia และช่วยให้สำหรับรหัสโดยรวมน้อยกว่าบูรณาการที่ดีระหว่างส่วนบอทและการบำรุงรักษาง่าย
การติดตั้ง
แพคเกจนี้มี earwigbot แกน, ใจลอยพอที่มันควรจะใช้งานและปรับแต่งโดยทุกคนที่ทำงานในเว็บไซต์ของ ธ ปทมีเดียวิกิ เนื่องจากเป็นส่วนประกอบที่ใช้ส่วนประกอบ IRC สามารถใช้งานได้ตามต้องการ คำสั่ง IRC และงานบอเฉพาะอินสแตนซ์ของฉัน EarwigBot ว่าฉันไม่รู้สึกผู้ใช้โดยเฉลี่ยจะต้องมีอยู่จากที่เก็บ earwigbot ปลั๊กอิน
ก็แนะนำให้เรียกใช้การทดสอบหน่วยบอก่อนที่จะติดตั้ง เรียกหลามทดสอบ setup.py จากไดเรกทอรีรากของโครงการ โปรดทราบว่าการทดสอบบางอย่างต้องใช้การเชื่อมต่ออินเทอร์เน็ตและอื่น ๆ อาจใช้เวลาสักครู่เพื่อให้ทำงานได้ ครอบคลุมอยู่ในขณะนี้ค่อนข้างไม่สมบูรณ์
การตั้งค่า
ธ ปทเก็บข้อมูลใน directory "ทำงาน" รวมทั้งไฟล์ config และฐานข้อมูลของ นี้ยังเป็นสถานที่ที่คุณจะวางคำสั่ง IRC ที่กำหนดเองและงานที่ ธ ปทซึ่งจะอธิบายในภายหลัง มันไม่สำคัญที่ไดเรกทอรีนี้คือตราบใดที่ ธ ปทสามารถเขียนไป
เริ่มบอด้วยเส้นทาง earwigbot / เพื่อ / ทำงาน / ผบหรือ earwigbot เพียงถ้าไดเรกทอรีทำงานเป็นไดเรกทอรีปัจจุบัน มันจะสังเกตได้ว่าไฟล์ config.yml ไม่มีอยู่และนำคุณผ่านขั้นตอนการติดตั้ง
ขณะนี้เป็นวิธีที่จะแก้ไขไฟล์ config.yml จากภายใน ธ ปทหลังจากที่มันได้รับการสร้างขึ้น แต่ YAML เป็นรูปแบบที่ตรงไปตรงมามากดังนั้นคุณควรจะสามารถที่จะทำให้การเปลี่ยนแปลงใด ๆ ที่จำเป็นด้วยตัวคุณเอง ตรวจสอบคำอธิบายของ YAML วิกิพีเดียเพื่อขอความช่วยเหลือ
หลังจากที่ติดตั้งบอทจะเริ่มต้น ซึ่งหมายความว่ามันจะเชื่อมต่อกับเซิร์ฟเวอร์ IRC จะได้รับการกำหนดค่าสำหรับงานบอตารางการทำงานในเวลาที่เฉพาะเจาะจงและแล้วรอให้คำแนะนำ (ตามคำสั่งใน IRC) สำหรับรายชื่อของคำสั่งที่บอกว่า "ช่วย!" (คำสั่งที่เป็นข้อความนำหน้าด้วยเครื่องหมายอัศเจรีย์)
คุณสามารถหยุดการ ธ ปทได้ตลอดเวลาที่มีการควบคุม + C เช่นเดียวกับคุณหยุดโปรแกรมหลามปกติและก็จะพยายามที่จะออกได้อย่างปลอดภัย นอกจากนี้คุณยังสามารถใช้ "! เลิก" คำสั่งใน IRC
การปรับแต่ง
ไดเรกทอรีการทำงานของธนาคารแห่งประเทศไทยมีคำสั่งและไดเรกทอรีย่อยไดเรกทอรีย่อยงาน คำสั่ง IRC ที่กำหนดเองสามารถวางไว้ในอดีตในขณะที่งานบอวิกิพีเดียที่กำหนดเองไปเป็นหลัง การพัฒนาโมดูลที่กำหนดเองได้อธิบายไว้ด้านล่างและในรายละเอียดมากขึ้นผ่านเอกสารบอบน PyPI (หรือในเอกสาร / ผบ)
หมายเหตุ: คำสั่งที่กำหนดเองที่จะแทนที่คำสั่งในตัวและงานที่มีชื่อเดียวกัน
Bot และ BotConfig
earwigbot.bot.Bot เป็นชั้นหลัก EarwigBot ของ คุณจะได้ไม่ต้องยกตัวอย่างนี้ด้วยตัวเอง แต่มันเป็นเรื่องที่ดีที่จะมีความคุ้นเคยกับคุณลักษณะและวิธีการของมันเพราะมันเป็นวิธีหลักในการสื่อสารกับส่วนอื่น ๆ ของ ธ ปท วัตถุ Bot สามารถเข้าถึงได้เป็นแอตทริบิวต์ของคำสั่งและงาน (เช่น self.bot)
earwigbot.config.BotConfig ข้อมูลการกำหนดค่าสำหรับร้านค้าบอท docstring มันอธิบายถึงสิ่งที่แต่ละแอตทริบิวต์ที่ใช้สำหรับการ แต่เป็นหลักแต่ละ "โหนด" (หนึ่งใน config.components, วิกิพีเดีย, IRC, คำสั่งงานและข้อมูล metadata) แผนที่ไปยังส่วนของไฟล์ config.yml ธ ปท ตัวอย่างเช่นถ้า config.yml รวมถึงสิ่งที่ต้องการ:
IRC:
& nbsp; ส่วนหน้า:
& nbsp; กรงขัง: MyAwesomeBot
& nbsp; ช่อง:
& nbsp; - "## earwigbot"
& nbsp; - "#channel"
& nbsp; - "# ช่องทางอื่น ๆ "
... แล้ว config.irc ["ส่วนหน้า"] ["กรงขัง"] จะเป็น "MyAwesomeBot" และ config.irc ["ส่วนหน้า"] ["ช่อง"] จะเป็น ["## earwigbot", "#channel" "# ช่องทางอื่น ๆ "]
คำสั่ง IRC กำหนดเอง
คำสั่งที่กำหนดเองจะ subclasses ของ earwigbot.commands.Command ว่าแทนที่กระบวนการสั่งของ () (และการตรวจสอบทางเลือก () หรือการตั้งค่า ()) วิธีการ
ธ ปทมีให้เลือกมากมายในตัวคำสั่งและปลั๊กอินจะทำหน้าที่เป็นตัวอย่างรหัสและ / หรือการให้ความคิด เริ่มต้นด้วยการทดสอบและตรวจสอบออก chanops และ afc_status สำหรับบางสคริปต์ที่ซับซ้อนมากขึ้น
งาน ธ ปทกำหนดเอง
งานที่กำหนดเองจะ subclasses ของ earwigbot.tasks.Task ว่าแทนที่การทำงานของงาน () (และการตั้งค่าตัวเลือก ()) วิธีการ
ดูงาน wikiproject_tagger ในตัวสำหรับงานที่ค่อนข้างตรงไปตรงมาหรือ afc_statistics ปลั๊กอินสำหรับหนึ่งที่ซับซ้อนมากขึ้น
วิกิพีเดีย Toolset
คำตอบ EarwigBot เพื่อเป็นกรอบ Pywikipedia วิกิพีเดีย Toolset (earwigbot.wiki) ซึ่งส่วนใหญ่คุณจะเข้าถึงผ่าน bot.wiki
bot.wiki ให้สามวิธีการสำหรับการจัดการของไซต์ - get_site () add_site () และ remove_site () ไซต์ที่เป็นวัตถุที่เพียงเป็นตัวแทนของเว็บไซต์มีเดียวิกิ เช่นเดียวของ EarwigBot (เช่นไดเรกทอรีทำงานเดี่ยว) ที่คาดว่าจะเกี่ยวข้องกับเว็บไซต์เดียวหรือกลุ่มของเว็บไซต์โดยใช้ข้อมูลเข้าสู่ระบบเดียวกัน (เช่นเดียวกับวิกิ WMF กับ CentralAuth)
โหลดเว็บไซต์เริ่มต้นของคุณ (คนที่คุณเลือกระหว่างการติดตั้ง) กับเว็บไซต์ = bot.wiki.get_site ()
ไม่ทุกด้านของชุดเครื่องมือที่ได้รับความคุ้มครองในเอกสาร สำรวจรหัสและ docstrings ในการเรียนรู้วิธีการที่จะใช้ในมือมากขึ้นในแฟชั่น สำหรับการอ้างอิง bot.wiki เป็นตัวอย่างของ earwigbot.wiki.SitesDB เชื่อมโยงไปยังแฟ้ม sites.db ในไดเรกทอรีการทำงานของ ธ ปท
ต้องการ .
- หลาม
ความคิดเห็นที่ไม่พบ