zc.monitor 0.3.1

监控服务器

监视器服务器是一个提供命令行接口的服务器 请求各种信息位。服务器是基于zc.ngi的，因此我们可以使用 ngi测试基础设施来演示它。

>>> import zc.ngi.testing
>>> import zc.monitor

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

服务器支持一组可扩展的命令。它向上看 命令名为zc.monitor.interfaces.imonitorplugin“utilities”，定义如下 通过zope.component包。

为此，我们将创建一个hello插件：

>>> def hello(connection, name='world'):
...     """Say hello
...
...     Provide a name if you're not the world.
...     """
...     connection.write("Hi %s, nice to meet ya!\n" % name)

并注册：

>>> zc.monitor.register(hello)

当我们注册一个命令时，我们可以提供一个名称。看到这个，我们会 再次注册hello：

>>> zc.monitor.register(hello, 'hi')

现在我们可以向服务器发出hello命令：

>>> connection.test_input('hi\n')
Hi world, nice to meet ya!
-> CLOSE

我们可以传递一个名称：

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)
>>> connection.test_input('hello Jim\n')
Hi Jim, nice to meet ya!
-> CLOSE

服务器附带一些基本命令。我们登记一下 所以我们可以看到他们在做什么。我们将使用简单的注册 接口：

>>> zc.monitor.register_basics()

第一个是帮助命令。提供帮助而无需输入， 可用命令列表：

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)
>>> connection.test_input('help\n')
Supported commands:
  hello -- Say hello
  help -- Get help about server commands
  hi -- Say hello
  interactive -- Turn on monitor's interactive mode
  quit -- Quit the monitor
-> CLOSE

我们可以通过指定命令名获得详细帮助：

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)
>>> connection.test_input('help help\n')
Help for help:
<BLANKLINE>
Get help about server commands
<BLANKLINE>
    By default, a list of commands and summaries is printed.  Provide
    a command name to get detailed documentation for a command.
<BLANKLINE>
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)
>>> connection.test_input('help hello\n')
Help for hello:
<BLANKLINE>
Say hello
<BLANKLINE>
    Provide a name if you're not the world.
<BLANKLINE>
-> CLOSE

interactive命令将监视器切换到交互模式。作为 如上所示，监视器通常响应一个命令，然后关闭 连接。在“交互模式”中，连接直到 使用quit命令。这在访问监视器时非常有用 通过Telnet进行诊断。

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)
>>> connection.test_input('interactive\n')
Interactive mode on.  Use "quit" To exit.
>>> connection.test_input('help interactive\n')
Help for interactive:
<BLANKLINE>
Turn on monitor's interactive mode
<BLANKLINE>
    Normally, the monitor releases the connection after a single command.
    By entering the interactive mode, the monitor will not end the connection
    until you enter the "quit" command.
<BLANKLINE>
    In interactive mode, an empty line repeats the last command.
<BLANKLINE>
>>> connection.test_input('help quit\n')
Help for quit:
<BLANKLINE>
Quit the monitor
<BLANKLINE>
    This is only really useful in interactive mode (see the "interactive"
    command).
<BLANKLINE>

注意，命令的结果没有以“->；close”结尾，这将 表示连接已关闭。

还要注意，交互模式允许您重复命令。

>>> connection.test_input('hello\n')
Hi world, nice to meet ya!
>>> connection.test_input('\n')
Hi world, nice to meet ya!
>>> connection.test_input('hello Jim\n')
Hi Jim, nice to meet ya!
>>> connection.test_input('\n')
Hi Jim, nice to meet ya!

现在我们将使用quit关闭连接。

>>> connection.test_input('quit\n')
Goodbye.
-> CLOSE

最后，值得注意的是，异常将生成 回溯连接。

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)
>>> connection.test_input('hello Jim 42\n') # doctest: +ELLIPSIS
Traceback (most recent call last):
...
TypeError: hello() takes at most 2 arguments (3 given)
<BLANKLINE>
-> CLOSE

更改历史记录