EarwigBot

EarwigBot是一个Python机器人编辑维基百科和人民对IRC交互与NBSP;此文件提供了有关如何安装和设置机器人的基本概述;更详细的信息，位于docs /目录（可在网上的PyPI）。
历史
开发开始，立足于Pywikipedia框架，在2009年初批准其拳头任务，违反版权探测器，进行了五月，和机器人已运行一贯以来（除月/ 2011年2月）。目前，它处理一些日常任务，从统计数据代类清理，并按需任务，如最实用的中文模板标记。自从它开始运行，该机器人已取得超过50,000编辑。
一个项目从头重写它开始于2011年4月上旬，从而逐渐远离Pywikipedia框架，并允许更少的总体代码，机器人部件之间更好的融合，也更容易维护。
安装
这个软件包包含了核心earwigbot，抽象不够，它应该是可用的和可定制的任何人都运行在的MediaWiki站点一个机器人。因为它是基于组件的，如果需要在IRC组件可以被禁用。可从存储库earwigbot-插件IRC命令，并具体到EarwigBot，我不觉得普通用户需要的我的实例机器人的任务。
它建议在安装之前运行机器人的单元测试。从项目的根目录下运行python setup.py测试。请注意，某些测试需要一个互联网连接，和其他人可能需要一段时间才能运行。覆盖率是目前相当不完整的。
设置
僵尸其存储在一个“工作目录”的数据，包括它的配置文件和数据库。这也是在那里你将会把自定义的IRC命令和僵尸的任务，这将在后面解释的位置。这不要紧，这个目录是，只要机器人可以写入。
开始earwigbot路径机器人/到/工作/目录，或者只是earwigbot如果工作目录是当前目录。它会发现，没有config.yml文件是否存在，并引导您完成安装过程。
目前还没有办法从编辑已创建后机器人内config.yml文件，但YAML是一个非常简单的格式，所以你应该能够使自己的任何必要的修改。查看YAML的解释维基百科上的帮助。
设置完成后，机器人将开始。这意味着它会连接到已配置，调度机器人任务，在特定时间运行的IRC服务器，然后等待指令（如命令对IRC）。有关命令的列表，说！“帮助”（命令前面加上一个感叹号消息）。
你可以停止机器人在任何时候控制+ C，相同停止正常的Python程序，它会试图安全地退出。您还可以在IRC使用！“跳槽”的命令。
自定义
机器人的工作目录中包含的命令子目录和任务的子目录。定制IRC命令可以放置在前者，而定制维基机器人任务进入后者。开发自定义模块解释如下，并更详细地通过机器人的文档PyPI上（或文档/目录）。
需要注意的是自定义命令将覆盖内置命令和任务具有相同的名称。
博特和BotConfig
earwigbot.bot.Bot是EarwigBot的主类。你不必实例化这个自己，但它的好，熟悉它的属性和方法，因为它是与机器人的其他部位进行沟通的主要途径。僵尸对象访问的命令和任务（即self.bot）的属性。
earwigbot.config.BotConfig存储配置信息的机器人。其文档字符串解释了每个属性用于，但本质上每一个“节点”（config.components，维基，IRC，命令，任务之一，和元数据）映射到机器人的config.yml文件的一个部分。例如，如果config.yml包括类似：
IRC：
＆NBSP;前端：
＆NBSP;尼克：MyAwesomeBot
＆NBSP;渠道：
＆NBSP; - “## earwigbot”
＆NBSP; - “#channel”
＆NBSP; - “＃其它通道”
......那么config.irc [“前端”] [“尼克”]将“MyAwesomeBot”和config.irc [“前端”] [“通道”]将是[“## earwigbot”，“#channel” “＃其它通道”。
自IRC命令
自定义命令earwigbot.commands.Command的子类覆盖命令的过程中（）（和可选检查（）或设置（））的方法。
机器人有一个广泛的选择内置的命令和插件作为示例代码和/或放弃的想法。开始测试，然后检查chanops和afc_status了一些更复杂的脚本。
定制机器人任务
自定义任务earwigbot.tasks.Task的子类覆盖任务的run（）（以及可选的设置（））的方法。
见内置wikiproject_tagger任务对于相对简单的任务，或afc_statistics插件一个更复杂的。
的维基工具集
EarwigBot的答案Pywikipedia框架是维基工具集（earwigbot.wiki），您将主要通过bot.wiki访问。
bot.wiki提供了三种方法站点的管理 - get_site（），add_site（），和remove_site（）。网站是简单地代表的MediaWiki站点对象。 EarwigBot的单个实例（即一个工作目录），预计涉及到一个单一的网站或组使用相同的登录信息（像所有的WMF维基与CentralAuth）网站。
加载默认站点与站点= bot.wiki.get_site（即在安装过程中选择了一个）（）。
没有工具的各个方面都涵盖了文档。探讨其代码和文档字符串来学习如何使用它在一个更实际的方式。仅供参考，bot.wiki是earwigbot.wiki.SitesDB绑在机器人的工作目录中的文件sites.db实例

要求：

• 在Python中