miniirc 1.4.2

importminiirc@miniirc.Handler(*events,colon=True)defhandler(irc,hostmask,args):# irc:      An 'IRC' object.# hostmask: A 'hostmask' object.# args:     A list containing the arguments sent to the command. Everything#             following the first `:` in the command is put into one item#             (args[-1]). If "colon" is "False", the leading ":" (if any)#             is automatically removed. Setting this to False is probably#             a good idea to prevent unexpected side effects.pass

• 如果不需要对minirc<；1.4.0的支持，并且正在分析最后一个 参数，强烈建议将colon设置为false。如果 冒号参数被忽略，它默认为真，但是这可能会改变 如果/当minirc v2.0.0发布时。
• 尽管handler和cmdhandler当前接受任何可以 转换为字符串后，每个事件都会在内部转换为字符串。
• 当不需要时，不指定参数 防止创建冗余的dict。
• 要将处理程序添加到特定的irc对象，而不是现有的每个对象， 请改用irc.handler和irc.cmdhandler。如果要创建 bot或client类并自动向irc对象添加处理程序 内部创建，请参见 使现有函数处理程序变为" rel="nofollow">使现有函数处理程序变为

主机掩码对象

主机掩码是格式为（'user'，'ident'，'hostname'）的元组。如果ident 并且主机名不是从服务器发送的，它们将用 上一个值。如果在没有主机掩码的情况下接收到命令，则所有主机掩码 元素将设置为命令的名称。但这是不赞成的， 如果/当minirc v2.0.0被释放时，hostmask元素将被设置为 空字符串。

使现有函数处理程序

可以创建现有函数处理程序（例如类实例方法） 使用irc.handler（*events）（handler_function）。你可能不想用 minirc.handler对于类实例方法，因为这将创建一个处理程序 每个irc对象都会触发它。

您还可以轻松地添加同一类型的多个处理程序：

add_handler=irc.Handler('PRIVMSG')add_handler(handler_1)add_handler(self.instance_handler)

如果要创建bot（或client）类并添加 不创建全局进程范围处理程序或 为每个类实例创建包装函数。

IRCV3支持

IRCV3标签

如果希望处理程序支持ircv3消息标记，则需要添加 ircv3=true到处理程序或命令处理程序装饰程序。您需要添加 标记在主机掩码之后设置函数的参数。IRCV3标记被发送到 处理程序为dicts，值为字符串或true

minirc将自动取消转义ircv3标记值。

importminiirc@miniirc.Handler(*events,colon=False,ircv3=True)defhandler(irc,hostmask,tags,args):pass

IRCV3功能

在使用处理程序连接之前，可以处理ircv3功能。 在这里调用的任何irc.quote（）上都必须使用force=true 调用时，minirc可能尚未完全连接。不要使用冒号参数 当创建这些处理程序以避免意外的副作用时。

importminiirc@miniirc.Handler('IRCv3 my-cap-name')defhandler(irc,hostmask,args):# Process the capability here# IRCv3.2 capabilities:#   args = ['my-cap-name', 'IRCv3.2-parameters']# IRCv3.1 capabilities:#   args = ['my-cap-name']# Remove the capability from the processing list.irc.finish_negotiation(args[0])# This can also be 'my-cap-name'.

自定义消息分析器

如果要连接的irc服务器支持非标准消息语法，则可以 创建自定义消息分析器。使用原始消息调用（作为str）和 可以返回none忽略消息，也可以返回4元组（cmd，hostmask，tags，args） 然后发送给处理程序。这个4元组中的项应该相同 按处理程序所需的项键入（并且cmd应该是字符串）。

消息分析器示例

此消息解析器使普通解析器允许将~作为ircv3标记前缀字符。

importminiircdefmy_message_parser(msg):ifmsg.startswith('~'):msg='@'+msg[1:]returnminiirc.ircv3_message_parser(msg)

更改消息分析器

要更改消息分析器，请可以使用irc.change_parser（func=…）。如果func不是 指定时，它将默认为内置解析器。您只能更改消息分析器 动态（例如在ircv3 cap处理程序中）。如果需要更改消息分析器 在连接之前，您可以禁用自动连接，然后对其进行更改。

irc=miniirc.IRC(...,auto_connect=False)irc.change_parser(my_message_parser)irc.connect()

处理多个事件

1.3.0版的新功能。

如果要处理多个事件和/或能够获取 事件被触发时，可以使用irc.cmdhandler。这将通过一个额外的 命令handler函数的参数（介于irc和hostmask之间） 包含带有命令名的字符串（例如privmsg）。

捕获所有处理程序

请不要使用这些，除非没有其他选择。

如果要处理每个事件，可以使用catch all处理程序。创造 这样，您可以在不使用任何参数的情况下调用irc.cmdhandler（）。注意这个 连接时将多次调用处理程序（一旦连接）。

没有参数就不能调用irc.handler（）。

示例

importminiirc# Not required, however this makes sure miniirc isn't insanely outdated.assertminiirc.ver>=(1,4,1)@miniirc.Handler('PRIVMSG','NOTICE',colon=True)defhandler(irc,hostmask,args):print(hostmask[0],'sent a message to',args[0],'with content',args[1])# nickname sent a message to #channel with content :Hello, world!@miniirc.CmdHandler('PRIVMSG','NOTICE',colon=False)defcmdhandler(irc,command,hostmask,args):print(hostmask[0],'sent a',command,'to',args[0],'with content',args[1])# nickname sent a PRIVMSG to #channel with content Hello, world!

每当机器人收到privmsg或通知时，这将打印一行。

其他功能

minirc提供以下帮助程序功能：

<表><广告>名称说明 < /广告><正文>minirc.get_ca_certs（）如果安装了certifi，则运行certifi.where（），否则返回noneminirc.ircv3_消息分析器（msg）默认ircv2/ircv3消息解析器，返回cmd、hostmask、tags、argsminirc.ver包含版本信息的元组。迷你版可以更改CTCP版本回复。

版本编号系统应类似于 但是，在可能的情况下，当主要版本 改变。补丁版本号可以而且将迅速增加，因为minirc是 写这篇文章的时间）正在积极开发中。

python版本支持

• python 2不工作，而且（可能）永远不会与minirc一起工作。如果你 必须使用python 2，您可以尝试手动移植minirc。
• Python3.3及以下版本可能无法工作，除非 它们很琐碎。
• Python3.4虽然不推荐使用，但是应该可以工作，但是它没有经过测试 尽可能彻底。
• Python3.5及更高版本应与MiniIRC的最新稳定版本一起使用。

如果Python3.4或更新版本中存在错误，请打开问题或拉取 请求访问github gitlab

如果您使用的是Python3.4或更早版本的Python，我强烈建议 建议更新。

迷你餐厅

如果您想要更高级的功能，例如用户跟踪，可以使用 minirc_extras （github， gitlab）。注意minirc_extras 目前仍处于测试阶段，未来将有突破性的API更改。

折旧

minirc v2.0.0可能永远不会发布，但是如果它是以下中断 将进行更改：

• 仅内部属性irc.handlers，irc.sock和irc.sendq （请不要使用这些）将被重命名。同样，请不要使用这些。
• irc.ns_identity可以存储为元组而不是字符串，例如 （'username'，'password with spaces'）而不是 "带空格的用户名密码"。这两种格式目前都被接受，并且 将在ns_identity关键字参数中接受。
• python 3.4支持可能会被删除。如果您使用的是Python3.4，那么 建议更新到最新版本的python。
• handler和cmdhandler的冒号关键字参数将默认为 false而不是true
• 未指定的主机掩码将是空字符串，而不是命令。不要 如果可能的话，可以依赖这个"特性"，如果可以的话，可以忽略hostmask 不需要。

工作示例/实现

下面是一些使用minirc的（开源）机器人程序的列表，按字母顺序排列：

• irc rss feed bot-将rss条目标题和缩短的url发布到irc 渠道。蟒蛇3.7+
• irc url title bot-从irc频道中发布的url获取网页标题。 蟒蛇3.7+
• 潜伏者-一个通用的可配置IRC机器人。 github链接。
• stdinbot-一个非常简单的bot，它将stdin转储到irc频道。 github链接。

要将您自己的bot/client添加到此列表中吗？在上打开问题 github或 gitlab

标签：

• 框架
• 消息
• 处理程序
• 参数
• irc
• args
• handler
• minirc
• miniirc

欢迎加入QQ群-->： 979659372

推荐PyPI第三方库

• StatePerception

  未提供项目说明

• mee6-py-api

  Unofficial Python Api for the Me6 Discord Bot

• craigapts

  Python包，用于从Craigslist获取公寓数据。

• olist-loafer

  用于并发任务处理的异步消息调度程序

• pyqywe-token

  Python的wechat access token module

• sgk-package

  这是sgk\ U套餐

• mkdocs-gitsnippet-plugin

  Mkdocs插件，允许从给定的远程git存储库注入代码段或所有降价内容。

• riot

  一个简单的Python测试运行器。

• SimPel

  PELDOR时间轨迹的模拟

• yfp

  用于Yahoo Fantasy Sports公共API的Python API包装器。

• proto-man

  替换协议

• ario

  用于Web开发的PYTHON微框架。API文档现已提供。

• jx-bigquer

  BigQuery的jxbigquery JSON表达式

• topo2geo

  用于将TopoJSON文件转换为GeoJSON的CLI

• inte-lists

  列出Meta试验的模型。