All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
13.9.4 - 2024-11-01
- Optimizations to cell_len which may speed up Rich / Textual output Textualize#3546
13.9.3 - 2024-10-22
- Fixed broken regex that may have resulted in poor performance. Textualize#3535
13.9.2 - 2024-10-04
- Fixed
Table
columns not highlighting when added byadd_row
Textualize#3517 - Fixed an issue with Segment.split_cells reported in Textual Textualize/textual#5090
13.9.1 - 2024-10-01
- Fixed typing_extensions dependency
13.9.0 - 2024-10-01
- Dropped support for Python3.7 Textualize#3509
- Rich will display tracebacks with finely grained error locations on python 3.11+ Textualize#3486
- Fixed issue with Segment._split_cells Textualize#3506
- Fix auto detection of terminal size on Windows Textualize#2916
Text.style
now respected in Panel title/subtitle Textualize#3509
13.8.1 - 2024-09-10
- Added support for Python 3.13 Textualize#3481
- Fixed infinite loop when appending Text to same instance Textualize#3480
13.8.0 - 2024-08-26
- Fixed
Table
rendering of box elements so "footer" elements truly appear at bottom of table, "mid" elements in main table body. - Fixed styles in Panel when Text objects are used for title Textualize#3401
- Fix pretty repr for
collections.deque
Textualize#2864 - Thread used in progress.track will exit if an exception occurs in a generator Textualize#3402
- Progress track thread is now a daemon thread Textualize#3402
- Fixed cached hash preservation upon clearing meta and links Textualize#2942
- Fixed overriding the
background_color
ofSyntax
not including padding Textualize#3295 - Fixed pretty printing of dataclasses with a default repr in Python 3.13 Textualize#3455
- Fixed selective enabling of highlighting when disabled in the
Console
Textualize#3419 - Fixed BrokenPipeError writing an error message Textualize#3468
- Fixed superfluous space above Markdown tables Textualize#3469
- Fixed issue with record and capture interaction Textualize#3470
- Fixed control codes breaking in
append_tokens
Textualize#3471 - Fixed exception pretty printing a dataclass with missing fields Textualize#3472
RichHandler
errors and warnings will now use different colors (red and yellow) Textualize#2825- Removed the empty line printed in jupyter while using
Progress
Textualize#2616 - Running tests in environment with
FORCE_COLOR
orNO_COLOR
environment variables - ansi decoder will now strip problematic private escape sequences (like
\x1b7
) Textualize#3278 - Tree's ASCII_GUIDES and TREE_GUIDES constants promoted to class attributes
rich.Text.highlight_regex
now accepts a regular expression object Textualize#3347
- Adds a
case_sensitive
parameter toprompt.Prompt
. This determines if the response is treated as case-sensitive. Defaults toTrue
. - Added
Console.on_broken_pipe
Textualize#3468
13.7.1 - 2024-02-28
- Updated the widths of some characters Textualize#3289
- Included a
name
attribute to theSpinner
class Textualize#3359
13.7.0 - 2023-11-15
- Adds missing parameters to Panel.fit Textualize#3142
- Some text goes missing during wrapping when it contains double width characters Textualize#3176
- Ensure font is correctly inherited in exported HTML Textualize#3104
- Fixed typing for
FloatPrompt
.
13.6.0 - 2023-09-30
- Added Python 3.12 to classifiers.
13.5.3 - 2023-09-17
- Markdown table rendering issue with inline styles and links Textualize#3115
- Fix Markdown code blocks on a light background Textualize#3123
13.5.2 - 2023-08-01
- Fixed Text.expand_tabs assertion error
13.5.1 - 2023-07-31
- Fix tilde character (
~
) not included in link regex when printing to console Textualize#3057
13.5.0 - 2023-07-29
- Fixed Text.expand_tabs not expanding spans.
- Fixed TimeElapsedColumn from showing negative.
- Fix for escaping strings with a trailing backslash Textualize#2987
- Fixed exception in Markdown with partial table Textualize#3053
- Fixed the HTML export template so that the
<html>
tag comes before the<head>
tag Textualize#3021 - Fixed issue with custom classes overwriting
__eq__
Textualize#2875 - Fix rich.pretty.install breakage in iPython Textualize#3013
- Added Text.extend_style method.
- Added Span.extend method.
- Text.tab_size now defaults to
None
to indicate that Console.tab_size should be used.
13.4.2 - 2023-06-12
- Relaxed markdown-it-py dependency
13.4.1 - 2023-05-31
- Fixed typing extensions import in markdown Textualize#2979
13.4.0 - 2023-05-31
- Added support for tables in
Markdown
Textualize#2977
13.3.5 - 2023-04-27
- Fixed italic indent guides in SVG output
13.3.4 - 2023-04-12
- Fixed for
is_terminal
ignoring FORCE_COLOR Textualize#2923
13.3.3 - 2023-02-27
- Added Style.clear_meta_and_links
13.3.2 - 2023-02-04
- Reversed
pre
andcode
tags in base HTML format Textualize#2642 - Fix syntax error when building with nuitka Textualize#2635
- Fixed pretty printing of empty dataclass Textualize#2819
- Use
Console(stderr=True)
inrich.traceback.install
to support io redirection. - Fixes superfluous spaces in html output Textualize#2832
- Fixed duplicate output in Jupyter https://github.com/Textualize/rich/pulls/2804
- Filter ANSI character-encoding-change codes in
Text.from_ansi
parser - Fixes traceback failing when a frame filename is unreadable Textualize#2821
- Fix for live update rendering console markup Textualize#2726
- Added Polish README
rich.progress.track()
will now show the elapsed time after finishing the task Textualize#2659
13.3.1 - 2023-01-28
- Fixed truecolor to eight bit color conversion Textualize#2785
13.3.0 - 2023-01-27
- Fixed failing tests due to Pygments dependency Textualize#2757
- Relaxed ipywidgets Textualize#2767
- Added
encoding
parameter inTheme.read
13.2.0 - 2023-01-19
- Switch Markdown parsing from commonmark to markdown-it-py Textualize#2439
13.1.0 - 2023-01-14
- Fixed wrong filenames in Jupyter tracebacks Textualize#2271
- Added locals_hide_dunder and locals_hide_sunder to Tracebacks, to hide double underscore and single underscore locals. Textualize#2754
- Tracebacks will now hide double underscore names from locals by default. Set
locals_hide_dunder=False
to restore previous behaviour.
13.0.1 - 2023-01-06
- Fixed issue with Segment.split_cells for mixed single and double cell widths
13.0.0 - 2022-12-30
- Reversed
pre
andcode
tags in base HTML format Textualize#2642 - Improved detection of
attrs
library, that isn't confused by the presence of theattr
library. - Fixed issue with
locals_max_length
parameter not being respected in Traceback Textualize#2649 - Handling of broken
fileno
made more robust. Fixes Textualize#2645 - Fixed missing
fileno
on FileProxy
- Fix type of
spinner_style
argument inConsole.status
Textualize#2613.
- Bumped minimum Python version to 3.7 Textualize#2567
- Pretty-printing of "tagged"
__repr__
results is now greedy when matching tags Textualize#2565 progress.track
now supports deriving total from__length_hint__
- Add type annotation for key_separator of pretty.Node Textualize#2625
12.6.0 - 2022-10-02
- Parse ANSI escape sequences in pretty repr Textualize#2470
- Add support for
FORCE_COLOR
env var Textualize#2449 - Allow a
max_depth
argument to be passed to theinstall()
hook Textualize#2486 - Document using
None
as name in__rich_repr__
for tuple positional args Textualize#2379 - Add
font_aspect_ratio
parameter in SVG export https://github.com/Textualize/rich/pull/2539/files - Added
Table.add_section
method. Textualize#2544
- Handle stdout/stderr being null Textualize#2513
- Fix NO_COLOR support on legacy Windows Textualize#2458
- Fix pretty printer handling of cyclic references Textualize#2524
- Fix missing
mode
property on file wrapper breaking uploads viarequests
Textualize#2495 - Fix mismatching default value of parameter
ensure_ascii
Textualize#2538 - Remove unused height parameter in
Layout
class Textualize#2540 - Fixed exception in Syntax.rich_measure for empty files
- Removed border from code blocks in Markdown
12.5.2 - 2022-07-18
- Add Turkish Readme.
12.5.1 - 2022-07-11
- Fixed missing typing extensions dependency on 3.9 Textualize#2386
- Fixed Databricks Notebook is not detected as Jupyter environment. Textualize#2422
12.5.0 - 2022-07-11
- Environment variables
JUPYTER_COLUMNS
andJUPYTER_LINES
to control width and height of console in Jupyter - Markdown friendly
Box
style,MARKDOWN
, for rendering tables ready to copy into markdown files inspect
will prefix coroutine functions withasync def
Style.__add__
will no longer returnNotImplemented
- Remove rich._lru_cache
- Default width of Jupyter console size is increased to 115
- Optimized Segment.divide
- Fix Rich clobbering cursor style on Windows Textualize#2339
- Fix text wrapping edge case Textualize#2296
- Allow exceptions that are raised while a Live is rendered to be displayed and/or processed Textualize#2305
- Fix crashes that can happen with
inspect
when docstrings contain some special control codes Textualize#2294 - Fix edges used in first row of tables when
show_header=False
Textualize#2330 - Fix interaction between
Capture
contexts andConsole(record=True)
Textualize#2343 - Fixed hash issue in Styles class Textualize#2346
- Fixed bug in
Segment.split_and_crop_lines
12.4.4 - 2022-05-24
- Added clipping per line to SVG output to avoid box characters overlapping
- Optimized SVG output
12.4.3 - 2022-05-23
- Further tweaks to SVG character matrix
- Added clip rect to SVG to prevent box characters overlapping bottom of terminal
12.4.2 - 2022-05-23
- Fix for SVG on Firefox
- Removed excess margin from SVG, tweaked cell sizes to better render block characters
12.4.1 - 2022-05-08
- Fix for default background color in SVG export Textualize#2260
- Added a keyline around SVG terminals which is visible on dark backgrounds
- Added a keyline around SVG terminals which is visible on dark backgrounds
12.4.0 - 2022-05-07
- Rebuilt SVG export to create a simpler SVG that is more portable
- Fix render_lines crash when render height was negative Textualize#2246
- Make objects from
rich.progress.open
forward the name of the internal handle Textualize#2254
- Add
padding
to Syntax constructor Textualize#2247
12.3.0 - 2022-04-26
- Ability to change terminal window title Textualize#2200
- Added show_speed parameter to progress.track which will show the speed when the total is not known
- Python blocks can now opt out from being rendered in tracebacks's frames, by setting a
_rich_traceback_omit = True
in their local scope Textualize#2207
- Fall back to
sys.__stderr__
on POSIX systems when trying to get the terminal size (fix issues when Rich is piped to another process) - Fixed markup escaping issue Textualize#2187
- Safari - Box appearing around SVG export Textualize#2201
- Fixed recursion error in Jupyter progress bars Textualize#2047
- Complex numbers are now identified by the highlighter Textualize#2214
- Fix crash on IDLE and forced is_terminal detection to False because IDLE can't do escape codes Textualize#2222
- Fixed missing blank line in traceback rendering Textualize#2206
- Fixed running Rich with the current working dir was deleted Textualize#2197
- Setting
total=None
on progress is now possible, and will display pulsing animation - Micro-optimization for Segment.divide
12.2.0 - 2022-04-05
- Bumped typing-extensions minimum to 4.0.0
- Bumped minimum Python version to 3.6.3
12.1.0 - 2022-04-03
- Progress.open and Progress.wrap_file method to track the progress while reading from a file or file-like object Textualize#1759
- SVG export functionality Textualize#2101
- Adding Indonesian translation
- Add missing
end
keyword argument toText.from_markup
Textualize#2095 - Fallback to text lexer when no lexer guessed Textualize#2133
- Fixed issue with decoding ANSI reset Textualize#2112
12.0.1 - 2022-03-22
- Improve performance of cell_length Textualize#2061
- Improve performance of chop_cells Textualize#2077
- Fix capturing stdout on legacy Windows Textualize#2066
12.0.0 - 2022-03-10
- Added options to TimeRemainingColumn to render a compact time format and render elapsed time when a task is finished. Textualize#1992
- Added ProgressColumn
MofNCompleteColumn
to display rawcompleted/total
column (similar to DownloadColumn, but displays values as ints, does not convert to floats or add bit/bytes units). Textualize#1941 - Replace Colorama with win32 renderer Textualize#1993
- Add support for namedtuples to
Pretty
Textualize#2031
- In Jupyter mode make the link target be set to "_blank"
- Fix some issues with markup handling around "[" characters Textualize#1950
- Fix syntax lexer guessing.
- Fixed Pretty measure not respecting expand_all Textualize#1998
- Collapsed definitions for single-character spinners, to save memory and reduce import time.
- Fix print_json indent type in
__init__.py
- Fix error when inspecting object defined in REPL Textualize#2037
- Fix incorrect highlighting of non-indented JSON Textualize#2038
- Fixed height reset in complex renderables Textualize#2042
- Improved support for enum.Flag in ReprHighlighter Textualize#1920
- Tree now respects justify=None, i.e. won't pad to right Textualize#1690
- Removed rich.tabulate which was marked for deprecation
- Deprecated rich.align.AlignValues in favor of AlignMethod
11.2.0 - 2022-02-08
- Add support for US spelling of "gray" in ANSI color names Textualize#1890
- Added
rich.diagnose.report
to expose environment debugging logic as function Textualize#1917 - Added classmethod
Progress.get_default_columns()
to get the default list of progress bar columns Textualize#1894
- Fixed performance issue in measuring text
- Fixed test failures on PyPy3 Textualize#1904
11.1.0 - 2022-01-28
- Workaround for edge case of object from Faiss with no
__class__
Textualize#1838 - Add Traditional Chinese readme
- Add
Syntax.guess_lexer
, add support for more lexers (e.g. Django templates etc.) Textualize#1869 - Add
lexer
parameter toSyntax.from_path
to allow for overrides Textualize#1873
- Workaround for edge case of object from Faiss with no
__class__
Textualize#1838 - Ensure
Syntax
always justifies left Textualize#1872 - Handle classes in inspect when methods=True Textualize#1874
11.0.0 - 2022-01-09
- Added max_depth arg to pretty printing Textualize#1585
- Added
vertical_align
to Table.add_row Textualize#1590
- Fixed issue with pretty repr in jupyter notebook Textualize#1717
- Fix Traceback theme defaults override user supplied styles Textualize#1786
- breaking Deprecated rich.console.RenderGroup, now named rich.console.Group
- breaking
Syntax.__init__
parameterlexer_name
renamed tolexer
- Syntax constructor accepts both str and now a pygments lexer Textualize#1748
10.16.2 - 2021-01-02
- Fixed @ not being escaped in markup
10.16.1 - 2021-12-15
- Fixed issues with overlapping tags Textualize#1755
10.16.0 - 2021-12-12
- Double print of progress bar in Jupyter Textualize#1737
- Added Text.markup property Textualize#1751
10.15.2 - 2021-12-02
- Deadlock issue Textualize#1734
10.15.1 - 2021-11-29
- Reverted thread-safety fix for Live that introduced deadlock potential
10.15.0 - 2021-11-28
- Added dynamic_progress.py to examples
- Added ConsoleOptions.update_height
- Fixed Padding not respecting height
- Some optimizations for simple strings (with only single cell widths)
- Fixed issue with progress bar not rendering markup Textualize#1721
- Fixed race condition when exiting Live Textualize#1530
10.14.0 - 2021-11-16
- Fixed progress speed not updating when total doesn't change
- Fixed superfluous new line in Status Textualize#1662
- Fixed Windows legacy width again
- Fixed infinite loop in set_cell_size Textualize#1682
- Added file protocol to URL highlighter Textualize#1681
- Added rich.protocol.rich_cast
- Allowed
__rich__
to work recursively - Allowed Text classes to work with sep in print Textualize#1689
- Added a
rich.text.Text.from_ansi
helper method for handling pre-formatted input strings Textualize#1670
10.13.0 - 2021-11-07
- Added json.dumps parameters to print_json Textualize#1638
- Fixed an edge case bug when console module try to detect if they are in a tty at the end of a pytest run
- Fixed a bug where logging handler raises an exception when running with pythonw (related to https://bugs.python.org/issue13807)
- Fixed issue with TERM env vars that have more than one hyphen Textualize#1640
- Fixed missing new line after progress bar when terminal is not interactive Textualize#1606
- Fixed exception in IPython when disabling pprint with %pprint Textualize#1646
- Fixed issue where values longer than the console width produced invalid JSON Textualize#1653
- Fixes trailing comma when pretty printing dataclass with last field repr=False Textualize#1599
- Markdown codeblocks now word-wrap Textualize#1515
10.12.0 - 2021-10-06
- Official Py3.10 release
- Fixed detection of custom repr when pretty printing dataclasses
10.11.0 - 2021-09-24
- Added
suppress
parameter to tracebacks - Added
max_frames
parameter to tracebacks
10.10.0 - 2021-09-18
- Added stdin support to
rich.json
- Fixed pretty printing of objects with fo magic with getattr Textualize#1492
10.9.0 - 2021-08-29
- Added data parameter to print_json method / function
- Added an --indent parameter to python -m rich.json
- Changed default indent of JSON to 2 (down from 4)
- Changed highlighting of JSON keys to new style (bold blue)
10.8.0 - 2021-08-28
- Added Panel.subtitle
- Added Panel.subtitle_align
- Added rich.json.JSON
- Added rich.print_json and Console.print_json
- Fixed a bug where calling
rich.reconfigure
within apytest_configure
hook would lead to a crash - Fixed highlight not being passed through options Textualize#1404
10.7.0 - 2021-08-05
- Added Text.apply_meta
- Added meta argument to Text.assemble
- Added Style.from_meta
- Added Style.on
- Added Text.on
- Changed
RenderGroup
toGroup
andrender_group
togroup
(old names remain for compatibility but will be deprecated in the future) - Changed
rich.repr.RichReprResult
torich.repr.Result
(old names remain for compatibility but will be deprecated in the future) - Changed meta serialization to use pickle rather than marshal to permit callables
10.6.0 - 2021-07-12
- Added deprecation warning for tabulate_mapping which will be removed in v11.0.0
- Added precision argument to filesize.decimal
- Added separator argument to filesize.decimal
- Added _rich_traceback_guard to Traceback
- Added emoji_variant to Console
- Added -emoji and -text variant selectors to emoji code
- Fixed issue with adjoining color tags Textualize#1334
- Changed Console.size to use unproxied stdin and stdout
10.5.0 - 2021-07-05
- Fixed Pandas objects not pretty printing Textualize#1305
- Fixed Textualize#1256
- Fixed typing with rich.repr.auto decorator
- Fixed repr error formatting Textualize#1326
- Added new_line_start argument to Console.print
- Added Segment.divide method
- Added Segment.split_cells method
- Added segment.SegmentLines class
10.4.0 - 2021-06-18
- Added Style.meta
- Added rich.repr.auto decorator
- Fixed error pretty printing classes with special rich_repr method
10.3.0 - 2021-06-09
- Added Console.size setter
- Added Console.width setter
- Added Console.height setter
- Added angular style Rich reprs
- Added an IPython extension. Load via
%load_ext rich
- Changed the logic for retrieving the calling frame in console logs to a faster one for the Python implementations that support it.
10.2.2 - 2021-05-19
- Fixed status not rendering console markup Textualize#1244
10.2.1 - 2021-05-17
- Fixed panel in Markdown exploding Textualize#1234
10.2.0 - 2021-05-12
- Added syntax for call, i.e. "Foo(bar)"
- Added Console.measure as a convenient alias for Measurement.get
- Added support for pretty printing attrs objects
- Added mappingproxy to pretty print
- Added UserDict and UserList support to pretty printer
- Changed colorama init to set strip=False
- Changed highlighter for False, True, None to not match in the middle of a word. i.e. NoneType is no longer highlighted as None
- Fixed initial blank lines removed from Syntax Textualize#1214
10.1.0 - 2021-04-03
- Fixed support for jupyter qtconsole and similar Jupyter environments
10.0.1 - 2021-03-30
- Fixed race condition that duplicated lines in progress Textualize#1144
10.0.0 - 2021-03-27
- Made pydoc import lazy as at least one use found it slow to import Textualize#1104
- Modified string highlighting to not match in the middle of a word, so that apostrophes are not considered strings
- New way of encoding control codes in Segment
- New signature for Control class
- Changed Layout.split to use new Splitter class
- Improved layout.tree
- Changed default theme color for repr.number to cyan
__rich_measure__
signature changed to accept ConsoleOptions rather than max_widthtext
parameter to rich.spinner.Spinner changed to RenderableType
- Added
__rich_repr__
protocol method to Pretty - Added rich.region.Region
- Added ConsoleOptions.update_dimensions
- Added rich.console.ScreenUpdate
- Added Console.is_alt_screen
- Added Control.segment, Control.bell, Control.home, Control.move_to, Control.clear, Control.show_cursor, Control.alt_screen
- Added Console.update_screen and Console.update_screen_lines
- Added Layout.add_split, Layout.split_column, Layout.split_row, layout.refresh
- Added new Rich repr protocol
__rich_repr__
- Fixed table style taking precedence over row style Textualize#1129
- Fixed incorrect measurement of Text with new lines and whitespace Textualize#1133
- Made type annotations consistent for various
total
keyword arguments inrich.progress
and rich.progress_bar
- Disabled Progress no longer displays itself when starting Textualize#1125
- Animations no longer reset when updating rich.status.Status
9.13.0 - 2021-03-06
- Pretty printer now supports dataclasses
- Fixed Syntax background Textualize#1088
- Fix for double tracebacks when no formatter Textualize#1079
- Added ws and wss to url highlighter
9.12.4 - 2021-03-01
- Fixed custom formatters with rich tracebacks in RichHandler Textualize#1079
- Allow highly compressed table cells to go to 0 width
- Optimization to remove empty styles in various places
9.12.3 - 2021-02-28
- Optimized Padding
9.12.2 - 2021-02-27
- Added ConsoleOptions.copy
- Optimized ConsoleOptions.update
9.12.1 - 2021-02-27
- Fixed deadlock in Progress Textualize#1061
- Added Task.finished_speed
- Froze TransferSpeedColumn speed when task is finished
- Added SIGINT handler to downloader.py example
- Optimization for large tables
9.12.0 - 2021-02-24
- Fixed issue with Syntax and missing lines in Layout Textualize#1050
- Fixed issue with nested markdown elements Textualize#1036
- Fixed new lines not invoking render hooks Textualize#1052
- Fixed Align setting height to child Textualize#1057
- Printing a table with no columns now result in a blank line Textualize#1044
- Added height to Panel
9.11.1 - 2021-02-20
- Fixed table with expand=False not expanding when justify="center"
- Fixed single renderable in Layout not respecting height
- Fixed COLUMNS and LINES env var Textualize#1019
- Layout now respects minimum_size when fixes sizes are greater than available space
- HTML export now changes link underline score to match terminal Textualize#1009
- python -m rich.markdown and rich.syntax show usage with no file
- Added height parameter to Layout
- Added python -m rich.segment
9.11.0 - 2021-02-15
- Fixed error message for tracebacks with broken
__str__
Textualize#980 - Fixed markup edge case Textualize#987
- Added cheeky sponsorship request to test card
- Added
quiet
argument to Console constructor - Added support for a callback function to format timestamps (allows presentation of milliseconds)
- Added Console.set_alt_screen and Console.screen
- Added height to ConsoleOptions
- Added
vertical
parameter to Align - Added Layout class
- Pretty.overflow now defaults to None
- Panel now respects options.height
- Traceback lexer defaults to Python if no extension on source
- Added ConsoleDimensions size attribute to ConsoleOptions so that size can't change mid-render
9.10.0 - 2021-01-27
- Some optimizations for Text
- Further optimized Tracebacks by not tokenizing code more that necessary
- Table Column.header_style and Column.footer_style are now added to Table header/footer style
9.9.0 - 2021-01-23
- Extended Windows palette to 16 colors
- Modified windows palette to Windows 10 colors
- Change regex for attrib_name to be more performant
- Optimized traceback generation
- Fix double line tree guides on Windows
- Fixed Tracebacks ignoring initial blank lines
- Partial fix for tracebacks not finding source after chdir
- Fixed error message when code in tracebacks doesn't have an extension Textualize#996
- Added post_style argument to Segment.apply_style
9.8.2 - 2021-01-15
- Fixed deadlock in live Textualize#927
9.8.1 - 2021-01-13
- Fixed rich.inspect failing with attributes that claim to be callable but aren't Textualize#916
9.8.0 - 2021-01-11
- Added rich_measure for tree
- Added rich.align.VerticalCenter
- The
style
argument on Align now applies to background only - Changed display of progress bars in no_color mode for clarity
- Console property
size
will fall back to getting the terminal size of stdout it stdin fails, this allows size to be correctly determined when piping
- Fixed panel cropping when shrunk too bar
- Allow passing markdown over STDIN when using
python -m rich.markdown
- Fix printing MagicMock.mock_calls Textualize#903
9.7.0 - 2021-01-09
- Added rich.tree
- Added no_color argument to Console
9.6.2 - 2021-01-07
- Fixed markup escaping edge case Textualize#878
- Double tag escape, i.e.
"\\[foo]"
results in a backslash plus[foo]
tag - Fixed header_style not applying to headers in positional args Textualize#953
9.6.1 - 2020-12-31
- Fixed encoding error on Windows when loading code for Tracebacks
9.6.0 - 2020-12-30
- MarkupError exception raise from None to omit internal exception
- Factored out RichHandler.render and RichHandler.render_message for easier extending
- Display pretty printed value in rich.inspect
- Added Progress.TimeElapsedColumn
- Added IPython support to pretty.install
- Fixed display of locals in Traceback for stdin
9.5.1 - 2020-12-19
- Fixed terminal size detection on Windows Textualize#836
- Fixed hex number highlighting
9.5.0 - 2020-12-18
- If file is not specified on Console then the Console.file will return the current sys.stdout. Prior to 9.5.0 sys.stdout was cached on the Console, which could break code that wrapped sys.stdout after the Console was constructed.
- Changed
Color.__str__
to not include ansi codes - Changed Console.size to get the terminal dimensions via sys.stdin. This means that if you set file to be an io.StringIO file then the width will be set to the current terminal dimensions and not a default of 80.
- Added stderr parameter to Console
- Added rich.reconfigure
- Added
Color.__rich__
- Added Console.soft_wrap
- Added Console.style parameter
- Added Table.highlight parameter to enable highlighting of cells
- Added Panel.highlight parameter to enable highlighting of panel title
- Added highlight to ConsoleOptions
- Fixed double output in rich.live Textualize#485
- Fixed Console.out highlighting not reflecting defaults Textualize#827
- FileProxy now raises TypeError for empty non-str arguments Textualize#828
9.4.0 - 2020-12-12
- Added rich.live Textualize#382
- Added align parameter to Rule and Console.rule
- Added rich.Status class and Console.status
- Added getitem to Text
- Added style parameter to Console.log
- Added rich.diagnose command
- Table.add_row style argument now applies to entire line and not just cells
- Added end_section parameter to Table.add_row to force a line underneath row
- Fixed suppressed traceback context Textualize#468
9.3.0 - 2020-12-1
- Added get_datetime parameter to Console, to allow for repeatable tests
- Added get_time parameter to Console
- Added rich.abc.RichRenderable
- Added expand_all to rich.pretty.install()
- Added locals_max_length, and locals_max_string to Traceback and logging.RichHandler
- Set defaults of max_length and max_string for Traceback to 10 and 80
- Added disable argument to Progress
- Reformatted test card (python -m rich)
- Fixed redirecting of stderr in Progress
- Fixed broken expanded tuple of one Textualize#445
- Fixed traceback message with
from
exceptions - Fixed justify argument not working in console.log Textualize#460
9.2.0 - 2020-11-08
- Added tracebacks_show_locals parameter to RichHandler
- Added max_string to Pretty
- Added rich.ansi.AnsiDecoder
- Added decoding of ansi codes to captured stdout in Progress
- Added expand_all to rich.pretty.pprint
- Applied dim=True to indent guide styles
- Factored out RichHandler.get_style_and_level to allow for overriding in subclasses
- Hid progress bars from html export
- rich.pretty.pprint now soft wraps
9.1.0 - 2020-10-23
- Added Text.with_indentation_guide
- Added Text.detect_indentation
- Added Pretty.indent_guides
- Added Syntax.indent_guides
- Added indent_guides parameter on pretty.install
- Added rich.pretty.pprint
- Added max_length to Pretty
- Enabled indent guides on Tracebacks
- Fixed negative time remaining in Progress bars Textualize#378
9.0.1 - 2020-10-19
- Fixed broken ANSI codes in input on windows legacy Textualize#393
9.0.0 - 2020-10-18
- Progress download column now displays decimal units
- Support for Python 3.9
- Added legacy_windows to ConsoleOptions
- Added ascii_only to ConsoleOptions
- Added box.SQUARE_DOUBLE_HEAD
- Added highlighting of EUI-48 and EUI-64 (MAC addresses)
- Added Console.pager
- Added Console.out
- Added binary_units in progress download column
- Added Progress.reset
- Added Style.background_style property
- Added Bar renderable Textualize#361
- Added Table.min_width
- Added table.Column.min_width and table.Column.max_width, and same to Table.add_column
- Dropped box.get_safe_box function in favor of Box.substitute
- Changed default padding in Panel from 0 to (0, 1) Textualize#385
- Table with row_styles will extend background color between cells if the box has no vertical dividerhttps://github.com/Textualize/issues/383
- Changed default of fit kwarg in render_group() from False to True
- Renamed rich.bar to rich.progress_bar, and Bar class to ProgressBar, rich.bar is now the new solid bar class
- Fixed typo in
Style.transparent_background
method name.
8.0.0 - 2020-10-03
- Added Console.bell method
- Added Set to types that Console.print will automatically pretty print
- Added show_locals to Traceback
- Added theme stack mechanism, see Console.push_theme and Console.pop_theme
- Changed Style.empty to Style.null to better reflect what it does
- Optimized combining styles involving a null style
- Change error messages in Style.parse to read better
- Fixed Table.__rich_measure__
- Fixed incorrect calculation of fixed width columns
7.1.0 - 2020-09-26
- Added Console.begin_capture, Console.end_capture and Console.capture
- Added Table.title_justify and Table.caption_justify Textualize#301
- Improved formatting of exceptions
- Enabled Rich exceptions in logging https://github.com/taliraj
- UTF-8 encoding is now mentioned in HTML head section
- Removed line_numbers argument from traceback.install, which was undocumented and did nothing
7.0.0 - 2020-09-18
- New ansi_dark and ansi_light themes
- Added Text.append_tokens for fast appending of string + Style pairs
- Added Text.remove_suffix
- Added Text.append_tokens
- Text.tabs_to_spaces was renamed to Text.expand_tabs, which works in place rather than returning a new instance
- Renamed Column.index to Column._index
- Optimized Style.combine and Style.chain
- Optimized text rendering by fixing internal cache mechanism
- Optimized hash generation for Styles
6.2.0 - 2020-09-13
- Added inline code highlighting to Markdown
6.1.2 - 2020-09-11
- Added ipv4 and ipv6 to ReprHighlighter
- The
#
sign is included in url highlighting
- Fixed force-color switch in rich.syntax and rich.markdown commands
6.1.1 - 2020-09-07
- Restored "def" in inspect signature
6.1.0 - 2020-09-07
- New inspect module
- Added os._Environ to pretty print
- Prevented recursive renderables from getting stuck
- force_terminal and force_jupyter can now be used to force the disabled state, or left as None to auto-detect.
- Panel now expands to fit title if supplied
6.0.0 - 2020-08-25
- Fixed use of
__rich__
cast
- New algorithm to pretty print which fits more on a line if possible
- Deprecated
character
parameter in Rule and Console.rule, in favor ofcharacters
- Optimized Syntax.from_path to avoid searching all lexers, which also speeds up tracebacks
- Added soft_wrap flag to Console.print
5.2.1 - 2020-08-19
- Fixed underscore with display hook Textualize#235
5.2.0 - 2020-08-14
- Added crop argument to Console.print
- Added "ignore" overflow method
- Added multiple characters per rule @hedythedev Textualize#207
5.1.2 - 2020-08-10
- Further optimized pretty printing ~5X.
5.1.1 - 2020-08-09
- Optimized pretty printing ~3X faster
5.1.0 - 2020-08-08
- Added Text.cell_len
- Added helpful message regarding unicode decoding errors Textualize#212
- Added display hook with pretty.install()
- Fixed deprecation warnings re backslash Textualize#210
- Fixed repr highlighting of scientific notation, e.g. 1e100
- Implemented pretty printing, and removed pprintpp from dependencies
- Optimized Text.join
5.0.0 - 2020-08-02
- Change to console markup syntax to not parse Python structures as markup, i.e.
[1,2,3]
is treated as a literal, not a tag. - Standard color numbers syntax has changed to
"color(<number>)"
so that[5]
(for example) is considered a literal. - Markup escape method has changed from double brackets to preceding with a backslash, so
foo[[]]
would befoo\[bar]
4.2.2 - 2020-07-30
- Added thread to automatically call update() in progress.track(). Replacing previous adaptive algorithm.
- Second attempt at working around https://bugs.python.org/issue37871
4.2.1 - 2020-07-29
- Added show_time and show_level parameters to RichHandler Textualize#182
- Fixed progress.track iterator exiting early Textualize#189
- Added workaround for Python bug https://bugs.python.org/issue37871, fixing Textualize#186
- Set overflow=fold for log messages Textualize#190
4.2.0 - 2020-07-27
- Fixed missing new lines Textualize#178
- Fixed Progress.track Textualize#184
- Remove control codes from exported text Textualize#181
- Implemented auto-detection and color rendition of 16-color mode
4.1.0 - 2020-07-26
- Optimized progress.track for very quick iterations
- Force default size of 80x25 if get_terminal_size reports size of 0,0
4.0.0 - 2020-07-23
Major version bump for a breaking change to Text.stylize signature
, which corrects a minor but irritating API wart. The style now comes first and the start
and end
offsets default to the entire text. This allows for text.stylize_all(style)
to be replaced with text.stylize(style)
. The start
and end
offsets now support negative indexing, so text.stylize("bold", -1)
makes the last character bold.
- Added markup switch to RichHandler Textualize#171
- Change signature of Text.stylize to accept style first
- Remove Text.stylize_all which is no longer necessary
- Fixed rendering of Confirm prompt Textualize#170
3.4.1 - 2020-07-22
- Fixed incorrect default of expand in Table.grid
3.4.0 - 2020-07-22
- Added stream parameter to Console.input
- Added password parameter to Console.input
- Added description parameter to Progress.update
- Added rich.prompt
- Added detecting 'dumb' terminals
- Added Text.styled alternative constructor
- Fixed progress bars so that they are readable when color is disabled
3.3.2 - 2020-07-14
- Optimized Text.pad
- Added rich.scope
- Change log_locals to use scope.render_scope
- Added title parameter to Columns
3.3.1 - 2020-07-13
- box.ASCII_DOUBLE_HEAD
- Removed replace of -- --- ... from Markdown, as it made it impossible to include CLI info
3.3.0 - 2020-07-12
- Added title and title_align options to Panel
- Added pad and width parameters to Align
- Added end parameter to Rule
- Added Text.pad and Text.align methods
- Added leading parameter to Table
3.2.0 - 2020-07-10
- Added Align.left Align.center Align.right shortcuts
- Added Panel.fit shortcut
- Added align parameter to Columns
- Align class now pads to the right, like Text
- ipywidgets added as an optional dependency
- Issue with Panel and background color
- Fixed missing
__bool__
on Segment
- Added
border_style
argument to Panel (note,style
now applies to interior of the panel)
3.1.0 - 2020-07-09
- Progress bars now work in Jupyter
- Added refresh_per_second to progress.track
- Added styles to BarColumn and progress.track
3.0.5 - 2020-07-07
- Fixed Windows version number require for truecolor
3.0.4 - 2020-07-07
- More precise detection of Windows console Textualize#140
3.0.3 - 2020-07-03
- Fixed edge case with wrapped and overflowed text
- New algorithm for compressing table that priorities smaller columns
- Added safe_box parameter to Console constructor
3.0.2 - 2020-07-02
- Added rich.styled.Styled class to apply styles to renderable
- Table.add_row now has an optional style parameter
- Added table_movie.py to examples
- Modified box options to use half line characters at edges
- Non no_wrap columns will now shrink below minimum width if table is compressed
3.0.1 - 2020-06-30
- Added box.ASCII2
- Added markup argument to logging extra
- Setting a non-None width now implies expand=True
3.0.0 - 2020-06-28
- Enabled supported box chars for legacy Windows, and introduce
safe_box
flag - Disable hyperlinks on legacy Windows
- Constructors for Rule and Panel now have keyword only arguments (reason for major version bump)
- Table.add_colum added keyword only arguments
- Fixed Table measure
2.3.1 - 2020-06-26
- Disabled legacy_windows if jupyter is detected Textualize#125
2.3.0 - 2020-06-26
- Fixed highlighting of paths / filenames
- Corrected docs for RichHandler which erroneously said default console writes to stderr
- Allowed
style
parameter forhighlight_regex
to be a callable that returns a style
- Added optional highlighter parameter to RichHandler
2.2.6 - 2020-06-24
- Store a "link id" on Style instance, so links containing different styles are highlighted together. (Textualize#123)
2.2.5 - 2020-06-23
- Fixed justify of tables (Textualize#117)
2.2.4 - 2020-06-21
- Added enable_link_path to RichHandler
- Added legacy_windows switch to Console constructor
2.2.3 - 2020-06-15
- Fixed console.log hyperlink not containing full path
- Used random number for hyperlink id
2.2.2 - 2020-06-14
- Exposed RichHandler highlighter as a class var
2.2.1 - 2020-06-14
- Linked path in log render to file
2.2.0 - 2020-06-14
- Added redirect_stdout and redirect_stderr to Progress
- printing to console with an active Progress doesn't break visuals
2.1.0 - 2020-06-11
- Added 'transient' option to Progress
- Truncated overly long text in Rule with ellipsis overflow
2.0.1 - 2020-06-10
- Added expand option to Padding
- Some minor optimizations in Text
- Fixed broken rule with CJK text
2.0.0 - 2020-06-06
- Added overflow methods
- Added no_wrap option to print()
- Added width option to print
- Improved handling of compressed tables
- Fixed erroneous space at end of log
- Fixed erroneous space at end of progress bar
- Renamed _ratio.ratio_divide to _ratio.ratio_distribute
- Renamed JustifyValues to JustifyMethod (backwards incompatible)
- Optimized _trim_spans
- Enforced keyword args in Console / Text interfaces (backwards incompatible)
- Return self from text.append
1.3.1 - 2020-06-01
- Changed defaults of Table.grid
- Polished listdir.py example
- Added width argument to Columns
- Fixed for
columns_first
argument in Columns - Fixed incorrect padding in columns with fixed width
1.3.0 - 2020-05-31
- Added rich.get_console() function to get global console instance.
- Added Columns class
- Updated
markdown.Heading.create()
to work with subclassing. - Console now transparently works with Jupyter
- Fixed issue with broken table with show_edge=False and a non-None box arg
1.2.3 - 2020-05-24
- Added
padding
parameter to Panel - Added 'indeterminate' state when progress bars aren't started
- Fixed Progress deadlock Textualize#90
- Auto-detect "truecolor" color system when in Windows Terminal
1.2.2 - 2020-05-22
- Issue with right aligned wrapped text adding extra spaces
1.2.1 - 2020-05-22
- Issue with sum and Style
1.2.0 - 2020-05-22
- Support for double underline, framed, encircled, and overlined attributes
- Optimized Style
- Changed methods
__console__
to__rich_console__
, and__measure__
to__rich_measure__
1.1.9 - 2020-05-20
- Exception when BarColumn.bar_width == None
1.1.8 - 2020-05-20
- Optimizations for Segment, Console and Table
- Added Console.clear method
- Added exporting of links to HTML
1.1.7 - 2020-05-19
- Added collapse_padding option to Table.
- Some style attributes may be abbreviated (b for bold, i for italic etc). Previously abbreviations worked in console markup but only one at a time, i.e. "[b]Hello[/]" but not "[b i]Hello[/]" -- now they work everywhere.
- Renamed 'text' property on Text to 'plain'. i.e. text.plain returns a string version of the Text instance.
- Fixed zero division if total is 0 in progress bar
1.1.6 - 2020-05-17
- Added rich.align.Align class
- Added justify argument to Console.print and console.log
1.1.5 - 2020-05-15
- Changed progress bars to write to stdout on terminal and hide on non-terminal
1.1.4 - 2020-05-15
- Fixed incorrect file and link in progress.log
- Fixes for legacy windows: Bar, Panel, and Rule now use ASCII characters
- show_cursor is now a no-op on legacy windows
- Added Console.input
- Disable progress bars when not writing to a terminal
1.1.3 - 2020-05-14
- Issue with progress of one line`
1.1.2 - 2020-05-14
- Added -p switch to python -m rich.markdown to page output
- Added Console.control to output control codes
- Changed Console log_time_format to no longer require a space at the end
- Added print and log to Progress to render terminal output when progress is active
1.1.1 - 2020-05-12
- Stripped cursor moving control codes from text
1.1.0 - 2020-05-10
- Added hyperlinks to Style and markup
- Added justify and code theme switches to markdown command
1.0.3 - 2020-05-08
- Added
python -m rich.syntax
command
1.0.2 - 2020-05-08
- Issue with Windows legacy support Textualize#59
1.0.1 - 2020-05-08
- Applied console markup after highlighting
- Documented highlighting
- Changed Markup parser to handle overlapping styles
- Relaxed dependency on colorama
- Allowed Theme to accept values as style definitions (str) as well as Style instances
- Added a panel to emphasize code in Markdown
- Added markup.escape
- Added
python -m rich.theme
command - Added
python -m rich.markdown
command - Added rendering of images in Readme (links only)
- Fixed Text.assemble not working with strings Textualize#57
- Fixed table when column widths must be compressed to fit
1.0.0 - 2020-05-03
- Improvements to repr highlighter to highlight URLs
0.8.13 - 2020-04-28
- Fixed incorrect markdown rendering for quotes and changed style
0.8.12 - 2020-04-21
- Removed debug print from rich.progress
0.8.11 - 2020-04-14
- Added Table.show_lines to render lines between rows
- Added markup escape with double square brackets
0.8.10 - 2020-04-12
- Fix row_styles applying to header
0.8.9 - 2020-04-12
- Added force_terminal option to
Console.__init__
- Added Table.row_styles to enable zebra striping.
0.8.8 - 2020-03-31
- Fixed background in Syntax
0.8.7 - 2020-03-31
- Broken wrapping of long lines
- Fixed wrapping in Syntax
- Added word_wrap option to Syntax, which defaults to False.
- Added word_wrap option to Traceback.
0.8.6 - 2020-03-29
- Experimental Jupyter notebook support: from rich.jupyter import print
0.8.5 - 2020-03-29
- Smarter number parsing regex for repr highlighter
- uuid highlighter for repr
0.8.4 - 2020-03-28
- Added 'test card', run python -m rich
- Detected windows terminal, defaulting to colorama support
- Fixed table scaling issue
0.8.3 - 2020-03-27
- CJK right align
0.8.2 - 2020-03-27
- Fixed issue with 0 speed resulting in zero division error
- Changed signature of Progress.update
- Made calling start() a second time a no-op
0.8.1 - 2020-03-22
- Added progress.DownloadColumn
0.8.0 - 2020-03-17
- CJK support
- Console level highlight flag
- Added encoding argument to Syntax.from_path
- Dropped support for Windows command prompt (try https://www.microsoft.com/en-gb/p/windows-terminal-preview/)
- Added task_id to Progress.track
0.7.2 - 2020-03-15
- KeyError for missing pygments style
0.7.1 - 2020-03-13
- Issue with control codes being used in length calculation
- Remove current_style concept, which wasn't really used and was problematic for concurrency
0.7.0 - 2020-03-12
- Added width option to Panel
- Change special method
__render_width__
to__measure__
- Dropped the "markdown style" syntax in console markup
- Optimized style rendering
- Added Console.show_cursor method
- Added Progress bars
- Fixed wrapping when a single word was too large to fit in a line
0.6.0 - 2020-03-03
- Added tab_size to Console and Text
- Added protocol.is_renderable for runtime check
- Added emoji switch to Console
- Added inherit boolean to Theme
- Made Console thread safe, with a thread local buffer
- Console.markup attribute now effects Table
- SeparatedConsoleRenderable and RichCast types
- Fixed tabs breaking rendering by converting to spaces
0.5.0 - 2020-02-23
- Replaced
__console_str__
with__rich__
0.4.1 - 2020-02-22
- Readme links in PyPI
0.4.0 - 2020-02-22
- Added Traceback rendering and handler
- Added rich.constrain
- Added rich.rule
- Fixed unnecessary padding
0.3.3 - 2020-02-04
- Fixed Windows color support
- Fixed line width on windows issue (Textualize#7)
- Fixed Pretty print on Windows
0.3.2 - 2020-01-26
- Added rich.logging
0.3.1 - 2020-01-22
- Added colorama for Windows support
0.3.0 - 2020-01-19
- First official release, API still to be stabilized