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中