/usr/lib/python3/dist-packages/blessed-1.14.2.egg-info/PKG-INFO is in python3-blessed 1.14.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 | Metadata-Version: 1.1
Name: blessed
Version: 1.14.2
Summary: A thin, practical wrapper around terminal styling, screen positioning, and keyboard input.
Home-page: https://github.com/jquast/blessed
Author: Jeff Quast, Erik Rose
Author-email: contact@jeffquast.com
License: MIT
Description-Content-Type: UNKNOWN
Description: .. image:: https://img.shields.io/travis/jquast/blessed/master.svg
:alt: Travis Continuous Integration
:target: https://travis-ci.org/jquast/blessed/
.. image:: https://img.shields.io/teamcity/https/teamcity-master.pexpect.org/s/Blessed_BuildHead.svg
:alt: TeamCity Build status
:target: https://teamcity-master.pexpect.org/viewType.html?buildTypeId=Blessed_BuildHead&branch_Blessed=%3Cdefault%3E&tab=buildTypeStatusDiv
.. image:: https://coveralls.io/repos/jquast/blessed/badge.svg?branch=master&service=github
:alt: Coveralls Code Coverage
:target: https://coveralls.io/github/jquast/blessed?branch=master
.. image:: https://img.shields.io/pypi/v/blessed.svg
:alt: Latest Version
:target: https://pypi.python.org/pypi/blessed
.. image:: https://img.shields.io/pypi/dm/blessed.svg
:alt: Downloads
:target: https://pypi.python.org/pypi/blessed
.. image:: https://badges.gitter.im/Join%20Chat.svg
:alt: Join Chat
:target: https://gitter.im/jquast/blessed
Introduction
============
Blessed is a thin, practical wrapper around terminal capabilities in Python.
Coding with *Blessed* looks like this... ::
from blessed import Terminal
t = Terminal()
print(t.bold('Hi there!'))
print(t.bold_red_on_bright_green('It hurts my eyes!'))
with t.location(0, t.height - 1):
print(t.center(t.blink('press any key to continue.')))
with t.cbreak():
inp = t.inkey()
print('You pressed ' + repr(inp))
Brief Overview
--------------
*Blessed* is a more simplified wrapper around curses_, providing :
* Styles, color, and maybe a little positioning without necessarily
clearing the whole screen first.
* Works great with standard Python string formatting.
* Provides up-to-the-moment terminal height and width, so you can respond to
terminal size changes.
* Avoids making a mess if the output gets piped to a non-terminal:
outputs to any file-like object such as *StringIO*, files, or pipes.
* Uses the `terminfo(5)`_ database so it works with any terminal type
and supports any terminal capability: No more C-like calls to tigetstr_
and tparm_.
* Keeps a minimum of internal state, so you can feel free to mix and match with
calls to curses or whatever other terminal libraries you like.
* Provides plenty of context managers to safely express terminal modes,
automatically restoring the terminal to a safe state on exit.
* Act intelligently when somebody redirects your output to a file, omitting
all of the terminal sequences such as styling, colors, or positioning.
* Dead-simple keyboard handling: safely decoding unicode input in your
system's preferred locale and supports application/arrow keys.
* Allows the printable length of strings containing sequences to be
determined.
Blessed **does not** provide...
* Windows command prompt support. A PDCurses_ build of python for windows
provides only partial support at this time -- there are plans to merge with
the ansi_ module in concert with colorama_ to resolve this. `Patches
welcome <https://github.com/jquast/blessed/issues/18>`_!
Before And After
----------------
With the built-in curses_ module, this is how you would typically
print some underlined text at the bottom of the screen::
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 = ''
# Save cursor position.
print(sc)
if cup:
# tigetnum('lines') doesn't always update promptly, hence this:
height = struct.unpack('hhhh', ioctl(0, TIOCGWINSZ, '\000' * 8))[0]
# Move cursor to bottom.
print(tparm(cup, height - 1, 0))
print('This is {under}underlined{normal}!'
.format(under=underline, normal=normal))
# Restore cursor position.
print(rc)
The same program with *Blessed* is simply::
from blessed import Terminal
term = Terminal()
with term.location(0, term.height - 1):
print('This is' + term.underline('underlined') + '!')
Requirements
------------
*Blessed* is tested with Python 2.7, 3.4, and 3.5 on Debian Linux, Mac, and
FreeBSD.
Further Documentation
---------------------
More documentation can be found at http://blessed.readthedocs.org/en/latest/
Bugs, Contributing, Support
---------------------------
**Bugs** or suggestions? Visit the `issue tracker`_ and file an issue.
We welcome your bug reports and feature suggestions!
Would you like to **contribute**? That's awesome! We've written a
`guide <http://blessed.readthedocs.org/en/latest/contributing.html>`_
to help you.
Are you stuck and need **support**? Give `stackoverflow`_ a try. If
you're still having trouble, we'd like to hear about it! Open an issue
in the `issue tracker`_ with a well-formed question.
License
-------
*Blessed* is under the MIT License. See the LICENSE file.
Forked
------
*Blessed* is a fork of `blessings <https://github.com/erikrose/blessings>`_.
Changes since 1.7 have all been proposed but unaccepted upstream.
Furthermore, a project in the node.js language of the `same name
<https://github.com/chjj/blessed>`_ is **not** related, or a fork
of each other in any way.
.. _`issue tracker`: https://github.com/jquast/blessed/issues/
.. _curses: https://docs.python.org/3/library/curses.html
.. _tigetstr: http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man3/tigetstr.3
.. _tparm: http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man3/tparm.3
.. _ansi: https://github.com/tehmaze/ansi
.. _colorama: https://pypi.python.org/pypi/colorama
.. _PDCurses: http://www.lfd.uci.edu/~gohlke/pythonlibs/#curses
.. _`terminfo(5)`: http://invisible-island.net/ncurses/man/terminfo.5.html
.. _`stackoverflow`: http://stackoverflow.com/
Keywords: terminal,sequences,tty,curses,ncurses,formatting,style,color,console,keyboard,ansi,xterm
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Terminals
|