【IT168 技术文档】

    封装 curses 应用程序

    curses 编程的基本元素是窗口对象。窗口是带有一个可寻址光标的实际物理屏幕的区域，光标的坐标与窗口相关。可以到处移动窗口，并且可以创建和删除窗口而不影响其它窗口。在窗口对象中，输入或输出操作发生在光标上，这通常由输入或输出方法明确设置，但也可以分别修改。

    在初始化 curses 之后，可以用各种方式修改或完全禁用面向流的控制台输入和输出。这基本上就是使用 curses 的全部重点。可是一旦更改了流式控制台交互，如果程序出错，将不会以正常方式显示 Python 追溯事件。Andrew Kuchling 使用一个很好的 curses 程序优异框架解决了这个问题（请参阅 参考资料中他的教程）。

以下模板（基本上与 Kuchling 的相同）保留在正常命令行 Python 的错误报告功能：

    清单1：Python [curses] 程序的顶层设置代码

          import
         curses, traceback
          if
         __name__==
        '__main__':
          try
        :
        # Initialize curses
    stdscr=curses.initscr()
        # Turn off echoing of keys, and enter cbreak mode,
         # where no buffering is performed on keyboard input
    curses.noecho()
    curses.cbreak()
        # In keypad mode, escape sequences for special keys
         # (like the cursor keys) will be interpreted and
         # a special value like curses.KEY_LEFT will be returned
    stdscr.keypad(1)
    main(stdscr)
        # Enter the main loop
         # Set everything back to normal
    stdscr.keypad(0)
    curses.echo()
    curses.nocbreak()
    curses.endwin()
        # Terminate curses

          except
        :
        # In event of error, restore terminal to sane state.
    stdscr.keypad(0)
    curses.echo()
    curses.nocbreak()
    curses.endwin()
    traceback.print_exc()
        # Print the exception

   try 代码块执行一些初始化，调用 main() 函数来执行实际工作，然后执行最后的清除。如果出错， except 代码块会将控制台恢复成缺省状态，然后报告遇到的异常。

    main() 事件循环

    现在，我们研究 main() 函数，看看 curses_txt2html 做些什么：

    清单2：curses_txt2html.py main() 函数和事件循环

    def

    main
        (stdscr):
        # Frame the interface area at fixed VT100 size

          global
         screen
    screen = stdscr.subwin(23, 79, 0, 0)
    screen.box()
    screen.hline(2, 1, curses.ACS_HLINE, 77)
    screen.refresh()
        # Define the topbar menus
    file_menu = (
        "File",
        "file_func()")
    proxy_menu = (
        "Proxy Mode",
        "proxy_func()")
    doit_menu = (
        "Do It!",
        "doit_func()")
    help_menu = (
        "Help",
        "help_func()")
    exit_menu = (
        "Exit",
        "EXIT")
        # Add the topbar menus to screen object
    topbar_menu((file_menu, proxy_menu, doit_menu,
                 help_menu, exit_menu))
        # Enter the topbar menu loop
          while
         topbar_key_handler():
        draw_dict()

    根据由空行隔开的三部分，很容易理解 main() 函数。

    第一部分执行应用程序外观的常规设置。为了建立应用程序元素之间的可预期间隔，交互式区域限制在 80 x 25 VT100/PC 屏幕大小（即使实际的终端窗口更大）。程序围绕这个子窗口绘制一个框，并使用水平线画出顶栏菜单的视觉偏移量。

    第二部分建立应用程序所使用的菜单。函数 topbar_menu() 使用一些技巧将热键绑定到应用程序操作并用期望的视觉属性来显示菜单。请获取源码档案（请参阅 参考资料 ）以查看所有代码。 topbar_menu() 应该是非常普通的。（欢迎将它合并到您自己的应用程序中。）非常重要的是一旦绑定了热键，它们就 eval() 与菜单相关的字节组第二个元素中包含的字符串。例如，激活以上设置中的 "File" 菜单将调用 "eval("file_func()")"。所以就要求应用程序定义叫做 file_func() 的函数，要求它返回一个布尔 (Boolean) 值以表示是否达到应用程序终止状态。

    第三部分只有两行，但这正是整个应用程序实际运行的部分。函数 topbar_key_handler() 就像它的名称所暗示的：它等待击键，然后处理它们。击键处理程序可以会返回 Boolean false 值。（如果是这样，则应用程序终止。）该应用程序中，键处理程序主要是检查第二段中绑定的键。但即使您的 curses 应用程序绑定键的方式与该应用程序不同，您仍要使用类似的事件循环。处理程序的关键部分很可能使用以下这行代码：

c = screen.getch()# read a keypress

    对 draw_dict() 的调用只是事件循环中唯一的代码。此函数绘制了 screen 窗口中几处位置中的值。但在应用程序中，您可能想要将以下这行代码：

screen.refresh()   # redraw the screen w/ any new output