zc.monitor

zc.monitor是提供了一个命令行界面来请求信息＆NBSP各个位的服务器;服务器是基于zc.ngi，所以我们可以使用zc.ngi测试基础设施来证明它。
＆NBSP; >>>进口zc.ngi.testing
＆NBSP; >>>进口zc.monitor
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
该服务器支持可扩展的命令集。它查找命令，命名zc.monitor.interfaces.IMonitorPlugin“公用事业”，由zope.component包的定义。
看到这一点，我们将创建一个Hello插件：
＆NBSP; >>>高清你好（连接，名字=“世界”）：
＆NBSP; ......“”“打个招呼
＆NBSP; ...
＆NBSP; ...提供一个名称，如果你不是世界。
＆NBSP; ......“”“
＆NBSP; ... connection.write（“嗨％S，很高兴见到你 N”％名称）
并注册：
＆NBSP; >>> zc.monitor.register（你好）
当我们注册了一个命令，我们可以提供一个名称。看到这一点，我们将重新注册你好：
＆NBSP; >>> zc.monitor.register（你好，'喜'）
现在，我们可以给hello命令到服务器：
＆NBSP; >>> connection.test_input（“喜 N'）
＆NBSP;喜的世界，很高兴认识你！
＆NBSP; - >关闭
我们可以通过一个名字：
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（'你好吉姆 N'）
＆NBSP;嗨，吉姆，很高兴认识你！
＆NBSP; - >关闭
服务器还附带了一些基本的命令。让我们来注册它们，所以我们可以看到他们做什么。我们将使用simplfied注册界面：
＆NBSP; >>> zc.monitor.register_basics（）
首先是help命令。给予帮助，无需投入，给出可用命令的列表：
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（“帮助 N'）
＆NBSP;支持的命令：
＆NBSP;你好 - 问好
＆nbsp;说明 - 获取有关服务器命令的帮助
＆NBSP;喜 - 问好
＆NBSP;互动 - 打开显示器的交互模式
＆NBSP;退出 - 退出显示器
＆NBSP; - >关闭
我们可以通过指定命令名获得详细的帮助：
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（'帮帮忙 N'）
＆nbsp;说明寻求帮助：
＆NBSP;
＆NBSP;获取有关服务器命令的帮助
＆NBSP;
＆NBSP;默认情况下，命令和汇总清单打印出来。提供
＆NBSP;命令名称来获取一个命令的详细资料。
＆NBSP;
＆NBSP; - >关闭
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（“帮助你好 N'）
＆nbsp;说明了招呼：
＆NBSP;
＆NBSP;打个招呼
＆NBSP;
＆NBSP;提供一个名称，如果你不是世界。
＆NBSP;
＆NBSP; - >关闭
交互式命令切换到监控交互模式。如上述可见，显示器通常响应一个命令，然后关闭连接。在“互动模式”，该连接不会关闭，直到退出命令使用。通过telnet诊断访问显示器时，这会很有用。
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（“互动 N'）
＆NBSP;在交互模式。使用“退出”退出。
＆NBSP; >>> connection.test_input（“帮助交互式 N'）
＆nbsp;说明进行互动：
＆NBSP;
＆NBSP;打开显示器的交互模式
＆NBSP;
＆NBSP;通常情况下，在监视器释放一个命令后的连接。
＆NBSP;通过进入交互模式，这款显示器会无法结束连接
＆NBSP;直到进入“退出”命令。
＆NBSP;
＆NBSP;在交互模式下，一个空行重复上一个命令。
＆NBSP;
＆NBSP; >>> connection.test_input（“帮助戒烟 N'）
＆nbsp;说明了退出：
＆NBSP;
＆NBSP;退出显示器
＆NBSP;
＆NBSP;这是只有在交互模式真正有用的（参见“互动”
＆NBSP;指令）。
＆NBSP;
注意，该命令的结果没有结束“ - >关”，这将表示在关闭的连接。
还要注意，在交互模式可以让你重复的命令。
＆NBSP; >>> connection.test_input（'你好 N'）
＆NBSP;喜的世界，很高兴认识你！
＆NBSP; >>> connection.test_input（' N'）
＆NBSP;喜的世界，很高兴认识你！
＆NBSP; >>> connection.test_input（'你好吉姆 N'）
＆NBSP;嗨，吉姆，很高兴认识你！
＆NBSP; >>> connection.test_input（' N'）
＆NBSP;嗨，吉姆，很高兴认识你！
现在，我们将使用退出关闭连接。
＆NBSP; >>> connection.test_input（'退出 N'）
＆NBSP;再见。
＆NBSP; - >关闭
最后，值得注意的是，异常将会产生连接上的回溯。
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（'你好吉姆·42 N'）＃文档测试：+省略号
＆NBSP;回溯（最近通话最后一个）：
＆NBSP; ...
＆NBSP;类型错误：你好（）需要最多2个参数（3给出）
＆NBSP;
＆NBSP; - >关闭
命令循环
使用“MORE”模式，命令可以表明他们想要求今后所有的用户输入。我们将实现一个愚蠢的例子来说明它是如何工作的。
下面是实现了一个计算器的命令。
＆NBSP;'。“>>> PROMPT =
＆NBSP; >>>高清钙（连接，*参数）：
＆NBSP; ......如果的args和args [0] =='退出'：
＆NBSP; ...返回zc.monitor.QUIT_MARKER
＆NBSP; ...
＆NBSP; ......如果ARGS：
＆NBSP; ... connection.write（STR（的eval（''加入（参数））））
＆NBSP; ... connection.write（' N'）
＆NBSP; ...
＆NBSP; ... connection.write（提示）
＆NBSP; ...返回zc.monitor.MORE_MARKER
如果我们注册这个命令......
＆NBSP; >>> zc.monitor.register（计算值）
......我们可以调用它，我们得到一个提示。
＆NBSP; >>>连接= zc.ngi.testing.TextConnection（）
＆NBSP; >>>服务器= zc.monitor.Server（连接）
＆NBSP; >>> connection.test_input（'钙 N'）
＆NBSP ;.
如果我们再给予更多的投入，我们得到的结果加上另外的提示。
＆NBSP; >>> connection.test_input（“2 + 2 N'）
＆NBSP; 4
＆NBSP ;.
＆NBSP; >>> connection.test_input（“4 * 2 N'）
＆NBSP; 8
＆NBSP ;.
一旦我们完成了，我们可以告诉计算器，让我们一起去。
＆NBSP; >>> connection.test_input（'退出 N'）
＆NBSP; - >关闭
启动服务器
＆NBSP; >>>进口时间
＆NBSP; >>>进口zope.testing.loggingsupport，记录
＆NBSP; >>> loghandler = zope.testing.loggingsupport.InstalledHandler（
＆NBSP; ......无，水平= logging.INFO）
＆NBSP; >>> zc.monitor.start（9644）
＆NBSP;（''，9644）
＆NBSP; >>>打印loghandler
＆NBSP; zc.ngi.async.server INFO
＆NBSP;监听（''，9644）
＆NBSP; >>> zc.monitor.last_listener.close（）
＆NBSP; >>> zc.monitor.last_listener =无
＆NBSP; >>> time.sleep（0.1）
＆NBSP; >>> loghandler.clear（）
＆NBSP; >>> zc.monitor.start（（“127.0.0.1”，9644））
＆NBSP;（“127.0.0.1”，9644）
＆NBSP; >>>打印loghandler
＆NBSP; zc.ngi.async.server INFO
＆NBSP;监听（“127.0.0.1”，9644）
＆NBSP; >>> zc.monitor.last_listener.close（）
＆NBSP; >>> zc.monitor.last_listener =无
＆NBSP; >>> time.sleep（0.1）
绑定端口0：
＆NBSP; >>> ADDR = zc.monitor.start（0）
＆NBSP; >>>地址== zc.monitor.last_listener.address
＆NBSP;真
＆NBSP; >>> zc.monitor.last_listener.close（）
＆NBSP; >>> zc.monitor.last_listener =无
＆NBSP; >>> time.sleep（0.1）
试图重新绑定到正在使用的端口：
＆NBSP; >>> loghandler.clear（）
＆NBSP; >>> zc.monitor.start（（“127.0.0.1”，9644））
＆NBSP;（“127.0.0.1”，9644）
＆NBSP; >>> zc.monitor.start（（“127.0.0.1”，9644））
＆NBSP;假
＆NBSP; >>>打印loghandler
＆NBSP; zc.ngi.async.server INFO
＆NBSP;监听（“127.0.0.1”，9644）
＆NBSP; zc.ngi.async.server警告
＆NBSP;无法在听（“127.0.0.1”，9644）
＆NBSP;根警告
＆NBSP;无法启动zc.monitor服务器，因为该地址（“127.0.0.1”，9644）是在使用中。
＆NBSP; >>> zc.monitor.last_listener.close（）
＆NBSP; >>> zc.monitor.last_listener =无
＆NBSP; >>> time.sleep（0.1）
＆NBSP; >>> loghandler.uninstall（）

什么在此版本中是新的：

• 在当绑定显示器到Unix域套接字，删除现有的插座在同一路径，以便绑定成功。这可能会影响现有的使用相对于zopectl调试行为，但会更具可预测性。

什么在0.3.0版本新：

• 在增加了一个简化的注册界面
。

要求：

• 在Python中