简单的Python的curses库使用教程


Posted in Python onApril 11, 2015

curses 库 ( ncurses ) 提供了控制字符屏幕的独立于终端的方法。curses 是大多数类似于 UNIX 的系统(包括 Linux)的标准部分,而且它已经移植到 Windows 和其它系统。curses 程序将在纯文本系统上、xterm 和其它窗口化控制台会话中运行,这使这些应用程序具有良好的可移植性。
介绍 curses

Python 的标准 curses 提供了“玻璃电传”(glass teletype)(在 20 世纪 70 年代,原始 curses 库刚创建时,它叫做 CRT)的公共特性的基本接口。有许多方法可以让用 Python 编写的交互式文本模式程序变得更巧妙。这些方法分成两类。

一方面,有些Python 模块支持 ncurses (curses 的超集)或 slang (相似却独立的控制台库)的全部功能集合。最值得注意的是,这当中有一个增强库(由适当的 Python 模块封装)可以让您将颜色添加到界面上。

另一方面,许多构建在curses(或 ncurses / slang )上的高级窗口小部件库添加了诸如按钮、菜单、滚动栏和各种公共界面设备之类的特性。如果您看到过用诸如 Borland's TurboWindows(DOS 版)之类的库开发的应用程序,您就知道在文本模式控制台中,这些特性是多么吸引人。窗口小部件库中的功能单单使用 curses 都可以达到,但是还可以利用其它程序员在高级界面上取得的成果。请参阅 参考资料,以寻找所提到的模块的链接。

本文只涉及 curses 自身的特性。由于 curses 模块是标准发行版的一部分,您不必下载支持库或其它 Python 模块就可以找到并使用它(至少在 Linux 或 UNIX 系统中是这样)。理解 curses 提供的基本支持很有用,即使只是作为理解高级模块的基础。即使不使用其它模块,单独使用 curses 构建漂亮且实用的 Python 文本模式应用程序也很简单。预先发行的说明提到 Python 2.0 将包括 curses 的增强版本,但不管怎样,它应该兼容此处说明的版本。

应用程序

我将讨论为 Txt2Html(在 “可爱的 Python:我的第一个基于 Web 的过滤代理” 中介绍的文本到 HTML 转换程序)编写的封装器,作为本文的测试应用程序。Txt2Html 有几种运行方式。但为了与本文的目的保持一致,我们将研究从命令行运行的 Txt2Html。操作 Txt2Html 的一种方式是向它提供一组命令行变量(它们说明要执行的转换的各方面),然后将应用程序当作批处理运行。对于偶尔使用的用户,一个更友好的用户界面提供了一个交互式选择屏幕,它可以在执行实际转换之前,引导用户遍历转换选项(提供选中选项的视觉反馈)。

curses_txt2html 的界面基于常见的顶栏菜单,它带有下拉和嵌套子菜单。所有菜单相关的功能都在 curses 上“从头”开始设计。虽然这些菜单缺少更复杂的 curses 封装器的一些特性,但它们的基本功能是由几行只使用 curses 的代码实现的。这个界面还带有一个简单的卷动帮助框和几个用户输入字段。以下是显示常规布局和样式的应用程序的屏幕快照。
X终端上的应用程序

简单的Python的curses库使用教程

Linux终端上的应用程序

简单的Python的curses库使用教程

封装 curses 应用程序

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

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

以下模板(基本上与 Kuchling 的相同)保留在正常命令行 Python 的错误报告功能:
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 做些什么:
curses_txt2html.py main() 函数和事件循环

defmain
  (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

加到绘制/刷新函数中(或只加到事件循环本身中)。

获取用户输入

curses 应用程序以击键事件的形式获取所有用户输入。我们已经看过了 .getch() 方法,现在让我们看一下将 .getch() 与其它输入方法组合在一起的例子 .getstr() 。以下就是我们以前提到的 file_func() 函数的缩写版本(它由 "File" 菜单激活)。
curses_txt2html.py file_func() 函数

deffile_func
  ():
 s = curses.newwin(5,10,2,1)
 s.box()
 s.addstr(1,2,
  "I", hotkey_attr)
 s.addstr(1,3,
  "nput", menu_attr)
 s.addstr(2,2,
  "O", hotkey_attr)
 s.addstr(2,3,
  "utput", menu_attr)
 s.addstr(3,2,
  "T", hotkey_attr)
 s.addstr(3,3,
  "ype", menu_attr)
 s.addstr(1,2,
  "", hotkey_attr)
 s.refresh()
 c = s.getch()
 
  if
   c
  in
   (ord(
  'I'), ord(
  'i'), curses.KEY_ENTER, 10):
  curses.echo()
  s.erase()
  screen.addstr(5,33,
  " "*43, curses.A_UNDERLINE)
  cfg_dict[
  'source'] = screen.getstr(5,33)
  curses.noecho()
 
  else
  :
  curses.beep()
  s.erase()
 
  return
   CONTINUE

此函数组合了几个 curses 特性。它做的第一件事就是创建另一个窗口对象。由于这个新窗口对象是 "File" 选择项的实际下拉菜单,所以程序使用 .box() 方法围着它绘制了一个框架。在窗口 s 中,程序绘制了几个下拉菜单选项。使用了一种稍微费力的方法突出显示了每个选项的热键,这样就与选项描述的其余部分形成了对比。(请查看完整源码(请参阅 参考资料 )中的 topbar_menu() 以学习一种能稍微自动处理突出显示的方法。)最后的 .addstr() 调用将光标移到缺省菜单选项。如同主屏幕一样, s.refresh() 实际上显示了画到窗口对象上的元素。

绘制了下拉菜单后,程序使用简单的 s.getch() 调用来获取用户的选择项。在演示应用程序中,菜单只响应热键,但不响应箭头键或可移动突出显示栏。可以通过捕捉附加键操作并在下拉菜单中设置事件循环来构建这些更复杂的菜单功能。但这个例子已经足够说明这种概念了。

接着,程序将刚读取的击键与各种热键值做比较。在本例中,热键的大小写都可以激活下拉菜单选项,并且可以使用 ENTER 键激活缺省选项。(curses 特殊键常量看上去并不完全可靠,我发现必须添加实际的 ASCII 值 "10" 来捕捉 ENTER 键。)请注意,如果要执行字符值比较,那么要将字符串封装到 ord() 内置 Python 函数中。

当选中 "Input" 选项时,程序会使用 .getstr() 方法,该方法提供带有原始编辑能力的字段输入(可以使用退格键)。由 ENTER 键终止输入,然后方法返回输入的值。通常会像上例中一样,将这个值分配给一个变量。

为了在视觉上区别输入字段,我使用了一点小技巧,预先向将要发生数据输入的区域添加了下划线。无论如何,这都是必要的,但它添加了一种视觉效果。由以下这行代码画出下划线:

screen.addstr(5,33, " "*43, curses.A_UNDERLINE)

当然,程序还必须除去下划线,这项工作在 draw_dict() 刷新函数中由以下这行代码执行:

screen.addstr(5,33, " "*43, curses.A_NORMAL)

结束语

这里概述的技术以及在完整应用程序源代码(请参阅 参考资料 )中使用的那些技术应该可以让您初步了解 curses 编程。请使用它来编写您的应用程序。它并不难使用。告诉您一个好消息,除了 Python 以外,有许多语言可以访问 curses 库,因此您学到的使用 Python curses 模块的知识同样适用于其它语言。

如果经检验,基本 curses 模块不能满足您的要求,“参考资料”节中提供了许多模块的链接,他们增添了 curses 的功能并提供了非常好的发展方向。

Python 相关文章推荐
python实现在控制台输入密码不显示的方法
Jul 02 Python
Python基于回溯法子集树模板解决野人与传教士问题示例
Sep 11 Python
Python列表生成式与生成器操作示例
Aug 01 Python
python实现机器学习之元线性回归
Sep 06 Python
python实现文本界面网络聊天室
Dec 12 Python
Scrapy-Redis结合POST请求获取数据的方法示例
May 07 Python
Python 通过打码平台实现验证码的实现
May 13 Python
python对文件目录的操作方法实例总结
Jun 24 Python
Python进度条的制作代码实例
Aug 31 Python
解决pycharm中opencv-python导入cv2后无法自动补全的问题(不用作任何文件上的修改)
Mar 05 Python
python3.7.2 tkinter entry框限定输入数字的操作
May 22 Python
opencv-python图像配准(匹配和叠加)的实现
Jun 23 Python
详解Python中的文本处理
Apr 11 #Python
状态机的概念和在Python下使用状态机的教程
Apr 11 #Python
在Python下使用Txt2Html实现网页过滤代理的教程
Apr 11 #Python
详解Python中DOM方法的动态性
Apr 11 #Python
将Python中的数据存储到系统本地的简单方法
Apr 11 #Python
Python中的进程分支fork和exec详解
Apr 11 #Python
Python json模块使用实例
Apr 11 #Python
You might like
使用PHP生成二维码的两种方法(带logo图像)
2014/03/14 PHP
php json转换成数组形式代码分享
2014/11/10 PHP
PHP性能测试工具xhprof安装与使用方法详解
2018/04/29 PHP
jquery实现的网页自动播放声音
2014/04/30 Javascript
JQuery性能优化的几点建议
2014/05/14 Javascript
jQuery中each()方法用法实例
2014/12/27 Javascript
jQuery 回调函数(callback)的使用和基础
2015/02/26 Javascript
简单实现jQuery弹窗效果
2017/10/30 jQuery
Koa项目搭建过程详细记录
2018/04/12 Javascript
在vue中使用vue-echarts-v3的实例代码
2018/09/13 Javascript
微信开发之微信jssdk录音功能开发示例
2018/10/22 Javascript
vue实现动态显示与隐藏底部导航的方法分析
2019/02/11 Javascript
如何在vue 中引入使用jquery
2020/11/10 jQuery
Python3使用PyQt5制作简单的画板/手写板实例
2017/10/19 Python
利用scrapy将爬到的数据保存到mysql(防止重复)
2018/03/31 Python
解决Pandas的DataFrame输出截断和省略的问题
2019/02/08 Python
python使用wxpy实现微信消息防撤回脚本
2019/04/29 Python
python多进程并行代码实例
2019/09/30 Python
Python+Django+MySQL实现基于Web版的增删改查的示例代码
2020/05/13 Python
Python字符串格式化常用手段及注意事项
2020/06/17 Python
在Tensorflow中实现leakyRelu操作详解(高效)
2020/06/30 Python
python 统计list中各个元素出现的次数的几种方法
2021/02/20 Python
CSS3 完美实现圆角效果
2009/07/13 HTML / CSS
Sofmap官网:日本著名的数码电器专卖店
2017/05/19 全球购物
房地产销售大学生自我评价分享
2013/11/11 职场文书
教师简历自我评价
2014/02/03 职场文书
人事文员岗位职责
2014/02/16 职场文书
《学棋》教后反思
2014/04/14 职场文书
建筑投标担保书
2014/05/20 职场文书
大学生求职信
2014/06/17 职场文书
园林技术专业求职信
2014/07/28 职场文书
迎新春趣味活动方案
2014/08/24 职场文书
实习介绍信范文
2015/05/05 职场文书
Java并发编程之Executor接口的使用
2021/06/21 Java/Android
Python echarts实现数据可视化实例详解
2022/03/03 Python
2022年显卡天梯图(6月更新)
2022/06/17 数码科技