blessed

Major Changes

• Performance improved in Terminal.Length and Sequence.padd by @grayjk and @avylove, #286, #287, #289, and #291

Minor Changes

• Fixes for failing tests by @avylove in #284
• Use a separate job to upload coverage for older python versions by @avylove in #288
• Use tool "codespell" in tox 'lint' step by @yarikoptic and @jquast in #293
• Unpin docformatter by @avylove in #292

Full Changelog: https://github.com/jquast/blessed/compare/1.21.0...1.22.0

• bugfix infinite loop in method Terminal.wrap() when "Wide" characters of width 2 (East-Asian or Emoji) are used with a wrap width of 1, and a small performance enhancement, #273 and #274 by @grayjk, merged as #275

• introduced Terminal.get_fgcolor() and Terminal.get_bgcolor() to query the terminal for the currently set colors. #237 by @stefanholek
  • bugfix: Copy globals dict before iterating to avoid RuntimeError in multithreaded applications, #248 by @adamnovak

• enhancement: Terminal.rjust(), Terminal.ljust(), and Terminal.center() now accept SupportsIndextypes, #234
  • enhancement: When 88 colors is detected, it is now interpreted as 16 colors rather than raising an AssertionError, #235
  • bugfix: Fix global variable declarations in type annotations, #230 by @mwchase

• introduced: Terminal.truncate(), #212 by @fishermans-friend
• enhancement: Add small sleep in Terminal.kbhit() on Windows to reduce CPU load, #209 by @Numerlor

• bugfix: Terminal.split_seqs() for some sequences like term.move_left(3), #197
• bugfix: Use jinxed.win32.get_console_input_encoding() for input encoding on Windows #202
• Drop support for Python 2.6
• Update metadata to show package is typed

• introduced: type annotations, #192 by @dlax.
• bugfix: do not fail when sys.stdin is unset, #195 by @Olen.
• docfix: correct "Bottom of the screen" example to use end='', and document about it in location.rst, #188 by @pyfisch

enhancement: Instantiate SequenceTextWrapper only once in method Terminal.wrap(), #184

From @stanislavlevin Make the actual version consistent with the pypi/tag one #181 by bumping to 1.17.11 and re-releasing, commit 5a8219087b51c183cf34952cdbcf1794d0c7ce59

• bugfix: Fix detection of shift+arrow keys when using tmux. :ghissue:178.

• bugfix: Now imports on 3.10+

• remove _build and __pycache__ and other such folders/files from sdist, #173, a regression from #161

• Introduced: formatter() which returns callable formatters for valid text formatters such as ‘red’ or ‘bold_on_red’, returning a NullCallableString if passed an invalid text formatter.

bugfix: Use UTF-8 for keyboard if input encoding cannot be determined.

• add pixel_height and pixel_width, for libsixel support or general curiosity, it actually works on most of the terminals I tested! This wasn't the case several years ago, closes #155
• bugfix "pickleability" of FormatOtherString, by implementing __getnewargs__, with tests.
• docfix some confusion about (y, x), (row, column), etc. There were some backwards things, and it's pretty annoying that get_location() doesn't match location(), we document why -- to retain API compatibility with blessings!
• rewrite the messages of our TypeError's, hopefully these are easier to understand.

• Documentation overhaul, to include plenty of examples and animated screenshots.
• Includes small fix to #126, #138, otherwise a lot of test harness and coverage changes.

• introduced: 24-bit color support, detected by term.number_of_colors == 1 << 24, and 24-bit

  color foreground method color_rgb and background method on_color_rgb, as well as 676 common X11 color attribute names are now possible, such as term.aquamarine_on_wheat, #60.

• introduced: term.move_xy, recommended over built-in move capability, as the return

  positional arguments, (x, y) match the return value of get_location, and all other common graphics library calls, #65. values over the b``term.move``.

• introduced: move_up`, ``move_down, move_left,

  move_right which are strings that move the cursor one cell in the respective direction, are now also callables for moving n cells to the given direction, such as term.move_right(9), .

• bugfix: prevent error condition, ValueError: underlying buffer has been detached in rare

  conditions where sys.__stdout__ has been detached in test frameworks, #126.

• bugfix: off-by-one error in :meth:get_location, now accounts for %i in

  cursor_report, #94.

• bugfix split_seqs and related functions failed to match when the color index

  was greater than 15, #101.

• bugfix: Context Managers, fullscreen, hidden_cursor, and

  keypad now flush the stream after writing their sequences.

• bugfix: chr(127), \x7f has changed from keycode term.DELETE to the more common

  match, term.BACKSPACE, #115 by @jwezel.

• deprecated: the direct curses move() capability is no longer recommended, suggest to use

  move_xy(), which matches the return value of .get_location.

• deprecated: superscript, subscript, shadow, and dim are no longer "compoundable"

  with colors, such as in phrase Terminal.blue_subscript('a'). These attributes are not typically supported, anyway. Use Unicode text or 256 or 24-bit color codes instead.

• deprecated: additional key names, such as KEY_TAB, are no longer "injected" into the curses

  module namespace.

• deprecated: curses.setupterm is now called with os.devnull as the file descriptor, let us know if this causes any issues! 59.

• deprecated: inkey no longer raises RuntimeError when stream

  is not a terminal, programs using Terminal.inkey may block indefinitely if a keyboard is not attached, #69.

• deprecated: using argument _intr_continue to method kbhit, behavior is as

  though such value is always True since 1.9.

• merge #112 to resolve locale issues on windows with python2

• bugfix: TypeError when using PYTHONOPTIMIZE=2 environment variable, issue #84.
  • bugfix: define blessed.__version__ value, issue #92.
  • bugfix: detect sequences \x1b[0K and \x1b2K, issue #95.

• bugfix: TypeError when using PYTHONOPTIMIZE=2 environment variable, issue #84.

• bugfix: term.wrap misbehaved for text containing newlines, #74

• enhancement: method Terminal.split_seqs introduced, and 4x cost reduction in related sequence-aware functions, #29.
• deprecated: function blessed.sequences.measure_length superseded by blessed.sequences.iter_parse if necessary.
• deprecated: warnings about "binary-packed capabilities" are no longer emitted on strange terminal types, making best effort.

• enhancement: method Terminal.get_locationreturns the(row, col)`` position of the cursor at the time of call for attached terminal.
• enhancement: a keyboard now detected as stdin when stream is sys.stderr.

• enhancement: Terminal.inkey method can return more quickly for combinations such as Alt + Z when MetaSendsEscape is enabled, #30

• enhancement: ~.FormattingString may now be nested, such as t.red('red', t.underline('rum')), #61

• workaround: provide sc and rc for Terminals of kind='ansi', repairing Terminal class method location, #44
• bugfix: length of simple SGR reset sequence \x1b[m was not correctly determined on all terminal types, #45
• deprecated: _intr_continue arguments introduced in 1.8 are now marked deprecated in 1.10: beginning with python 3.5, the default behavior is as though this argument is always True, blessed does the same.

• enhancement: allow move_x() and like to work with 'screen-256color'.
• enhancement: new public attribute: kind.