blessings 1.7

前后对比

没有祝福，这就是如何在屏幕底部打印带下划线的文本的方法

from curses import tigetstr, setupterm, tparm
from fcntl import ioctl
from os import isatty
import struct
import sys
from termios import TIOCGWINSZ

# If we want to tolerate having our output piped to other commands or
# files without crashing, we need to do all this branching:
if hasattr(sys.stdout, 'fileno') and isatty(sys.stdout.fileno()):
    setupterm()
    sc = tigetstr('sc')
    cup = tigetstr('cup')
    rc = tigetstr('rc')
    underline = tigetstr('smul')
    normal = tigetstr('sgr0')
else:
    sc = cup = rc = underline = normal = ''
print sc  # Save cursor position.
if cup:
    # tigetnum('lines') doesn't always update promptly, hence this:
    height = struct.unpack('hhhh', ioctl(0, TIOCGWINSZ, '\000' * 8))[0]
    print tparm(cup, height - 1, 0)  # Move cursor to bottom.
print 'This is {under}underlined{normal}!'.format(under=underline,
                                                  normal=normal)
print rc  # Restore cursor position.

这太长了，充满了难以理解的东西！让我们再试一次，这次加上祝福

from blessings import Terminal

term = Terminal()
with term.location(0, term.height - 1):
    print 'This is', term.underline('pretty!')

好多了。

简单的格式化

许多方便的格式化代码（在底层术语中称为“功能”）可以作为Terminal上的属性使用。例如

from blessings import Terminal

term = Terminal()
print 'I am ' + term.bold + 'bold' + term.normal + '!'

虽然它们本质上都是字符串，但你也可以将它们用作可调用的包装器，这样你就不必在后面说normal了

print 'I am', term.bold('bold') + '!'

或者，如果你想保持简短的同时又想有细粒度的控制，你可以将它与Python的字符串格式化结合使用，这使得属性很容易访问

print 'All your {t.red}base {t.underline}are belong to us{t.normal}'.format(t=term)

一些简单的有用功能包括...

• 粗体

• 反白

• 下划线

• no_underline（用于关闭下划线）

• 闪烁

• normal（用于关闭一切，包括颜色）

以下是一些不太可能在所有终端上工作的功能

• 暗淡

• italic和no_italic

• shadow和no_shadow

• standout和no_standout

• subscript和no_subscript

• superscript和no_superscript

• flash（屏幕闪烁一次）

请注意，虽然下划线的反义词是no_underline，但关闭bold或reverse的唯一方法是normal，这也会取消任何自定义颜色。这是因为没有通用的方法告诉终端撤销某些格式化，即使在最低级别也是如此。

你可能还会注意到，上面列出的并不是典型的难以理解的terminfo功能名称；我们对一些难以记住的名称进行了别名设置，以增强可读性。然而，你并不局限于这些：你可以通过“Cap-name”列下的名称引用terminfo手册页上列出的任何返回字符串的功能：例如，term.rum。

颜色

前缀和背景色均可作为易于记忆的属性使用16种颜色

from blessings import Terminal

term = Terminal()
print term.red + term.on_green + 'Red on green? Ick!' + term.normal
print term.bright_red + term.on_bright_blue + 'This is even worse!' + term.normal

你也可以将它们用作包装器，这将在结束时将一切恢复到正常状态

print term.red_on_green('Red on green? Ick!')
print term.yellow('I can barely see it.')

可用的颜色是...

• 黑色

• 红色

• 绿色

• 黄色

• 蓝色

• 品红色

• 青色

• 白色

您可以通过在前面加上on_来设置背景色而不是前景色，例如on_blue。还有每种颜色的bright版本：例如，on_bright_blue。

还有对颜色的数值接口，它接受0-15之间的整数

term.color(5) + 'Hello' + term.normal
term.on_color(3) + 'Hello' + term.normal

term.color(5)('Hello')
term.on_color(3)('Hello')

如果某些颜色不受支持（例如，如果只有正常颜色，没有明亮颜色），那么尝试使用它将在大多数终端上没有任何效果：前景色和背景色将保持不变。您可以通过检查number_of_colors来确定支持的颜色的数量。

复合格式化

如果您想一次进行大量的疯狂格式化，只需将它们全部组合在一起即可

from blessings import Terminal

term = Terminal()
print term.bold_underline_green_on_yellow + 'Woo' + term.normal

或者，您可以使用新创建的属性作为包装器，这会在之后隐式地将一切恢复到正常状态

print term.bold_underline_green_on_yellow('Woo')

这种复合表示法在您想允许用户自定义应用程序的格式时非常有用：只需让他们在命令行上传递一个格式说明符，例如“bold_green”，然后在您进行格式化时快速执行 getattr(term, that_option)('您的文本')。

如果不提一下couleur，我将犯了一个错误，我可能就是从这里得到了所有这些组合的想法。

移动光标

当您想将光标移动到特定位置输出文本时，您有几个选择。

from blessings import Terminal

term = Terminal()
with term.location(0, term.height - 1):
    print 'Here is the bottom.'
print 'This is back where I came from.'

with term.location(y=10):
    print 'We changed just the row.'

with term.location():
    print term.move(1, 1) + 'Hi'
    print term.move(9, 9) + 'Mom'

from blessings import Terminal

term = Terminal()
print term.move(10, 1) + 'Hi, mom!'

print term.move_up + 'Howdy!'

高度和宽度

简单地获取终端的高度和宽度（以字符为单位）是很容易的

from blessings import Terminal

term = Terminal()
height = term.height
width = term.width

每次您请求它们时，它们都会被更新，因此它们可以从 SIGWINCH 处理程序中安全使用。

清除屏幕

Blessings 在一些屏幕清除功能上提供了语法糖

clear

清除整个屏幕。

clear_eol

清除到行尾。

clear_bol

向后清除到行首。

clear_eos

清除到屏幕末尾。

全屏模式

可能您已经看到过全屏程序，如编辑器，在退出时恢复终端的精确先前状态，包括启动时所在的命令行提示符。Curses基本上会强制您这样做，但Blessings使这成为可选的。如果您想进行状态恢复操作，请使用以下功能

enter_fullscreen

切换到允许全屏输出的终端模式。在输出任何内容之前打印此命令。

exit_fullscreen

切换回正常模式，恢复使用enter_fullscreen之前的精确状态。

使用exit_fullscreen将清除程序输出的任何痕迹，因此请将其保留在滚动回溯中不留下任何内容的情况。

还有一个您可以使用的上下文管理器作为快捷方式

from blessings import Terminal

term = Terminal()
with term.fullscreen():
    # Print some stuff.

除了简洁之外，另一个优点是，即使在with块中引发异常，它也会切换回正常模式。

管道达人

如果您的程序未连接到终端，例如它被管道传输到另一个命令或重定向到文件，所有在Terminal上的能力属性都将返回空字符串。您将得到一个没有格式化代码干扰的漂亮文件。

如果您想覆盖此行为（例如，如果您预计程序将通过less -r管道传输，该工具可以很好地处理终端转义）请将force_styling=True传递给Terminal构造函数。

无论如何，Terminal上有一个does_styling属性，您可以通过它查看您的功能是否会返回实际的、可工作的格式化代码。如果它是假的，您应该避免绘制进度条和其他装饰，只需坚持内容即可，因为您显然要进入管道。

from blessings import Terminal

term = Terminal()
if term.does_styling:
    with term.location(0, term.height - 1):
        print 'Progress: [=======>   ]'
print term.bold('Important stuff')