Skip to content

Latest commit

 

History

History
1653 lines (1191 loc) · 91.2 KB

CHANGELOG.md

File metadata and controls

1653 lines (1191 loc) · 91.2 KB
Raw

Change Log

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.

0.47.0 - 2024-01-04

Fixed

  • Widget.move_child would break if before/after is set to the index of the widget in child Textualize#1743
  • Fixed auto width text not processing markup Textualize#3918
  • Fixed Tree.clear not retaining the root's expanded state Textualize#3557

Changed

Added

0.46.0 - 2023-12-17

Fixed

Changed

  • The tabs within a TabbedContent now prefix their IDs to stop any clash with their associated TabPane Textualize#3815
  • Breaking change: tab is no longer a @on decorator selector for TabbedContent.TabActivated -- use pane instead Textualize#3815

Added

0.45.1 - 2023-12-12

Fixed

  • Fixed issues where styles wouldn't update if changed in mount. Textualize#3860

0.45.0 - 2023-12-12

Fixed

Removed

  • Removed renderables/align.py which was no longer used.

Changed

  • Dropped ALLOW_CHILDREN flag introduced in 0.43.0 Textualize#3814
  • Widgets with an auto height in an auto height container will now expand if they have no siblings Textualize#3814
  • Breaking change: Removed limit_rules from Stylesheet.apply Textualize#3844

Added

  • Added get_loading_widget to Widget and App customize the loading widget. Textualize#3816
  • Added messages Collapsible.Expanded and Collapsible.Collapsed that inherit from Collapsible.Toggled. Textualize#3824

0.44.1 - 2023-12-4

Fixed

0.44.0 - 2023-12-1

Changed

  • Breaking change: Dropped 3.7 support Textualize#3766
  • Breaking changes Textualize#1530
  • link-hover-background renamed to link-background-hover
  • link-hover-color renamed to link-color-hover
  • link-hover-style renamed to link-style-hover
  • Tree now forces a scroll when scroll_to_node is called Textualize#3786
  • Brought rxvt's use of shift-numpad keys in line with most other terminals Textualize#3769

Added

  • Added support for Ctrl+Fn and Ctrl+Shift+Fn keys in urxvt Textualize#3737
  • Friendly error messages when trying to mount non-widgets Textualize#3780
  • Added Select.from_values class method that can be used to initialize a Select control with an iterator of values Textualize#3743

Fixed

0.43.2 - 2023-11-29

Fixed

0.43.1 - 2023-11-29

Fixed

0.43.0 - 2023-11-28

Fixed

Added

Changed

  • Method MarkdownTableOfContents.set_table_of_contents renamed to MarkdownTableOfContents.rebuild_table_of_contents Textualize#3730
  • Exception Tree.UnknownNodeID moved out of Tree, import from textual.widgets.tree Textualize#3730
  • Exception TreeNode.RemoveRootError moved out of TreeNode, import from textual.widgets.tree Textualize#3730
  • Optimized startup time Textualize#3753
  • App.COMMANDS or Screen.COMMANDS can now accept a callable which returns a command palette provider Textualize#3756

0.42.0 - 2023-11-22

Fixed

Added

  • Exceptions to textual.widgets.select Textualize#3614
    • InvalidSelectValueError for when setting a Select to an invalid value
    • EmptySelectError when creating/setting a Select to have no options when allow_blank is False
  • Select methods Textualize#3614
    • clear
    • is_blank
  • Constant Select.BLANK to flag an empty selection Textualize#3614
  • Added restrict, type, max_length, and valid_empty to Input Textualize#3657
  • Added Pilot.mouse_down to simulate MouseDown events Textualize#3495
  • Added Pilot.mouse_up to simulate MouseUp events Textualize#3495
  • Added Widget.is_mounted property Textualize#3709
  • Added TreeNode.refresh Textualize#3639

Changed

  • CSS error reporting will no longer provide links to the files in question Textualize#3582
  • inline CSS error reporting will report widget/class variable where the CSS was read from Textualize#3582
  • Breaking change: Tree.refresh_line has now become an internal Textualize#3639
  • Breaking change: Setting Select.value to None no longer clears the selection (See Select.BLANK and Select.clear) Textualize#3614
  • Breaking change: Button no longer inherits from Static, now it inherits directly from Widget Textualize#3603
  • Rich markup in markdown headings is now escaped when building the TOC Textualize#3689
  • Mechanics behind mouse clicks. See this for more details. Textualize#3495
  • Breaking change: max/min-width/height now includes padding and border. Textualize#3712

0.41.0 - 2023-10-31

Fixed

  • Fixed Input.cursor_blink reactive not changing blink state after Input was mounted Textualize#3498
  • Fixed Tabs.active attribute value not being re-assigned after removing a tab or clearing Textualize#3498
  • Fixed DirectoryTree race-condition crash when changing path Textualize#3498
  • Fixed issue with LRUCache.discard Textualize#3537
  • Fixed DataTable not scrolling to rows that were just added Textualize#3552
  • Fixed cache bug with DataTable.update_cell Textualize#3551
  • Fixed CSS errors being repeated Textualize#3566
  • Fix issue with chunky highlights on buttons Textualize#3571
  • Fixed OptionList event leakage from CommandPalette to App.
  • Fixed crash in LoadingIndicator Textualize#3498
  • Fixed crash when Tabs appeared as a descendant of TabbedContent in the DOM Textualize#3602
  • Fixed the command palette cancelling other workers Textualize#3615

Added

  • Add Document get_index_from_location / get_location_from_index Textualize#3410
  • Add setter for TextArea.text Textualize#3525
  • Added key argument to the DataTable.sort() method, allowing the table to be sorted using a custom function (or other callable) Textualize#3090
  • Added initial to all css rules, which restores default (i.e. value from DEFAULT_CSS) Textualize#3566
  • Added HorizontalPad to pad.py Textualize#3571
  • Added AwaitComplete class, to be used for optionally awaitable return values Textualize#3498

Changed

  • Breaking change: Button.ACTIVE_EFFECT_DURATION classvar converted to Button.active_effect_duration attribute Textualize#3498
  • Breaking change: Input.blink_timer made private (renamed to Input._blink_timer) Textualize#3498
  • Breaking change: Input.cursor_blink reactive updated to not run on mount (now init=False) Textualize#3498
  • Breaking change: AwaitTabbedContent class removed Textualize#3498
  • Breaking change: Tabs.remove_tab now returns an AwaitComplete instead of an AwaitRemove Textualize#3498
  • Breaking change: Tabs.clear now returns an AwaitComplete instead of an AwaitRemove Textualize#3498
  • TabbedContent.add_pane now returns an AwaitComplete instead of an AwaitTabbedContent Textualize#3498
  • TabbedContent.remove_pane now returns an AwaitComplete instead of an AwaitTabbedContent Textualize#3498
  • TabbedContent.clear_pane now returns an AwaitComplete instead of an AwaitTabbedContent Textualize#3498
  • Tabs.add_tab now returns an AwaitComplete instead of an AwaitMount Textualize#3498
  • DirectoryTree.reload now returns an AwaitComplete, which may be awaited to ensure the node has finished being processed by the internal queue Textualize#3498
  • Tabs.remove_tab now returns an AwaitComplete, which may be awaited to ensure the tab is unmounted and internal state is updated Textualize#3498
  • App.switch_mode now returns an AwaitMount, which may be awaited to ensure the screen is mounted Textualize#3498
  • Buttons will now display multiple lines, and have auto height Textualize#3539
  • DataTable now has a max-height of 100vh rather than 100%, which doesn't work with auto
  • Breaking change: empty rules now result in an error Textualize#3566
  • Improved startup time by caching CSS parsing Textualize#3575
  • Workers are now created/run in a thread-safe way Textualize#3586

0.40.0 - 2023-10-11

Added

0.39.0 - 2023-10-10

Fixed

  • Pilot.click/Pilot.hover can't use Screen as a selector Textualize#3395
  • App exception when a Tree is initialized/mounted with disabled=True Textualize#3407
  • Fixed print locations not being correctly reported in textual console Textualize#3237
  • Fix location of IME and emoji popups Textualize#3408
  • Fixed application freeze when pasting an emoji into an application on Windows Textualize#3178
  • Fixed duplicate option ID handling in the OptionList Textualize#3455
  • Fix crash when removing and updating DataTable cell at same time Textualize#3487
  • Fixed fractional styles to allow integer values Textualize#3414
  • Stop eating stdout/stderr in headless mode - print works again in tests Textualize#3486

Added

  • OutOfBounds exception to be raised by Pilot Textualize#3360
  • TextArea.cursor_screen_offset property for getting the screen-relative position of the cursor Textualize#3408
  • Input.cursor_screen_offset property for getting the screen-relative position of the cursor Textualize#3408
  • Reactive cell_padding (and respective parameter) to define horizontal cell padding in data table columns Textualize#3435
  • Added Input.clear method Textualize#3430
  • Added TextArea.SelectionChanged and TextArea.Changed messages Textualize#3442
  • Added wait_for_dismiss parameter to App.push_screen Textualize#3477
  • Allow scrollbar-size to be set to 0 to achieve scrollable containers with no visible scrollbars Textualize#3488

Changed

  • Breaking change: tree-sitter and tree-sitter-languages dependencies moved to syntax extra Textualize#3398
  • Pilot.click/Pilot.hover now raises OutOfBounds when clicking outside visible screen Textualize#3360
  • Pilot.click/Pilot.hover now return a Boolean indicating whether the click/hover landed on the widget that matches the selector Textualize#3360
  • Added a delay to when the No Matches message appears in the command palette, thus removing a flicker Textualize#3399
  • Timer callbacks are now typed more loosely Textualize#3434

0.38.1 - 2023-09-21

Fixed

  • Hotfix - added missing highlight files in build distribution Textualize#3370

0.38.0 - 2023-09-21

Added

Fixed

  • Fixed DataTable not updating component styles on hot-reloading Textualize#3312

Changed

  • Breaking change: CSS in DEFAULT_CSS is now automatically scoped to the widget (set SCOPED_CSS=False) to disable
  • Breaking change: Changed Markdown.goto_anchor to return a boolean (if the anchor was found) instead of None Textualize#3334

0.37.1 - 2023-09-16

Fixed

  • Fixed the command palette crashing with a TimeoutError in any Python before 3.11 Textualize#3320
  • Fixed Input event leakage from CommandPalette to App.

0.37.0 - 2023-09-15

Added

  • Added the command palette Textualize#3058
  • Input is now validated when focus moves out of it Textualize#3193
  • Attribute Input.validate_on (and __init__ parameter of the same name) to customise when validation occurs Textualize#3193
  • Screen-specific (sub-)title attributes Textualize#3199:
    • Screen.TITLE
    • Screen.SUB_TITLE
    • Screen.title
    • Screen.sub_title
  • Properties Header.screen_title and Header.screen_sub_title Textualize#3199
  • Added DirectoryTree.DirectorySelected message Textualize#3200
  • Added widgets.Collapsible contributed by Sunyoung Yoo Textualize#2989

Fixed

  • Fixed a crash when removing an option from an OptionList while the mouse is hovering over the last option Textualize#3270
  • Fixed a crash in MarkdownViewer when clicking on a link that contains an anchor Textualize#3094
  • Fixed wrong message pump in pop_screen Textualize#3315

Changed

  • Widget.notify and App.notify are now thread-safe Textualize#3275
  • Breaking change: Widget.notify and App.notify now return None Textualize#3275
  • App.unnotify is now private (renamed to App._unnotify) Textualize#3275
  • Markdown.load will now attempt to scroll to a related heading if an anchor is provided Textualize#3244
  • ProgressBar explicitly supports being set back to its indeterminate state Textualize#3286

0.36.0 - 2023-09-05

Added

Changed

  • Reactive callbacks are now scheduled on the message pump of the reactable that is watching instead of the owner of reactive attribute Textualize#3065
  • Callbacks scheduled with call_next will now have the same prevented messages as when the callback was scheduled Textualize#3065
  • Added cursor_type to the DataTable constructor.
  • Fixed push_screen not updating Screen.CSS styles Textualize#3217
  • DataTable.add_row accepts height=None to automatically compute optimal height for a row Textualize#3213

Fixed

0.35.1

Fixed

  • Fixed flash of 80x24 interface in textual-web

0.35.0

Added

  • Ability to enable/disable tabs via the reactive disabled in tab panes Textualize#3152
  • Textual-web driver support for Windows

Fixed

  • Could not hide/show/disable/enable tabs in nested TabbedContent Textualize#3150

0.34.0 - 2023-08-22

Added

Changed

  • grid-columns and grid-rows now accept an auto token to detect the optimal size Textualize#3107
  • LoadingIndicator now has a minimum height of 1 line.

Fixed

  • Fixed auto height container with default grid-rows Textualize#1597
  • Fixed page_up and page_down bug in DataTable when show_header = False Textualize#3093
  • Fixed issue with visible children inside invisible container when moving focus Textualize#3053

0.33.0 - 2023-08-15

Fixed

Changed

  • Breaking change: DOMNode.visible now takes into account full DOM to report whether a node is visible or not.

Removed

Added

Changed

  • DescendantBlur and DescendantFocus can now be used with @on decorator

0.32.0 - 2023-08-03

Added

  • Added widgets.Log
  • Added Widget.is_vertical_scroll_end, Widget.is_horizontal_scroll_end, Widget.is_vertical_scrollbar_grabbed, Widget.is_horizontal_scrollbar_grabbed

Changed

  • Breaking change: Renamed TextLog to RichLog

0.31.0 - 2023-08-01

Added

Changed

  • Breaking change: Creating a thread worker now requires that a thread=True keyword argument is passed Textualize#2938
  • Breaking change: Markdown.load no longer captures all errors and returns a bool, errors now propagate Textualize#2956
  • Breaking change: the default style of a DataTable now has max-height: 100% Textualize#2959

Fixed

0.30.0 - 2023-07-17

Added

Fixed

0.29.0 - 2023-07-03

Changed

  • Factored dev tools (textual command) in to external lib (textual-dev).

Added

  • Updated DataTable.get_cell type hints to accept string keys Textualize#2586
  • Added DataTable.get_cell_coordinate method
  • Added DataTable.get_row_index method Textualize#2587
  • Added DataTable.get_column_index method
  • Added can-focus pseudo-class to target widgets that may receive focus
  • Make Markdown.update optionally awaitable Textualize#2838
  • Added default parameter to DataTable.add_column for populating existing rows Textualize#2836
  • Added can-focus pseudo-class to target widgets that may receive focus

Fixed

0.28.1 - 2023-06-20

Fixed

  • Fixed indented code blocks not showing up in Markdown Textualize#2781
  • Fixed inline code blocks in lists showing out of order in Markdown Textualize#2676
  • Fixed list items in a Markdown being added to the focus chain Textualize#2380
  • Fixed Tabs posting unnecessary messages when removing non-active tabs Textualize#2807
  • call_after_refresh will preserve the sender within the callback Textualize#2806

Added

  • Added a method of allowing third party code to handle unhandled tokens in Markdown Textualize#2803
  • Added MarkdownBlock as an exported symbol in textual.widgets.markdown Textualize#2803

Changed

  • Tooltips are now inherited, so will work with compound widgets

0.28.0 - 2023-06-19

Added

  • The devtools console now confirms when CSS files have been successfully loaded after a previous error Textualize#2716
  • Class variable CSS to screens Textualize#2137
  • Class variable CSS_PATH to screens Textualize#2137
  • Added cursor_foreground_priority and cursor_background_priority to DataTable Textualize#2736
  • Added Region.center
  • Added center parameter to Widget.scroll_to_region
  • Added origin_visible parameter to Widget.scroll_to_region
  • Added origin_visible parameter to Widget.scroll_to_center
  • Added TabbedContent.tab_count Textualize#2751
  • Added TabbedContent.add_pane Textualize#2751
  • Added TabbedContent.remove_pane Textualize#2751
  • Added TabbedContent.clear_panes Textualize#2751
  • Added TabbedContent.Cleared Textualize#2751

Fixed

  • Fixed setting TreeNode.label on an existing Tree node not immediately refreshing Textualize#2713
  • Correctly implement __eq__ protocol in DataTable Textualize#2705
  • Fixed exceptions in Pilot tests being silently ignored Textualize#2754
  • Fixed issue where internal data of OptionList could be invalid for short window after clear_options Textualize#2754
  • Fixed Tooltip causing a query_one on a lone Static to fail Textualize#2723
  • Nested widgets wouldn't lose focus when parent is disabled Textualize#2772
  • Fixed the Tabs Underline highlight getting "lost" in some extreme situations Textualize#2751

Changed

  • Breaking change: The @on decorator will now match a message class and any child classes Textualize#2746
  • Breaking change: Styles update to checkbox, radiobutton, OptionList, Select, SelectionList, Switch Textualize#2777
  • Tabs.add_tab is now optionally awaitable Textualize#2778
  • Tabs.add_tab now takes before and after arguments to position a new tab Textualize#2778
  • Tabs.remove_tab is now optionally awaitable Textualize#2778
  • Breaking change: Tabs.clear has been changed from returning self to being optionally awaitable Textualize#2778

0.27.0 - 2023-06-01

Fixed

Added

Changed

  • Placeholder now sets its color cycle per app Textualize#2590
  • Footer now clears key highlight regardless of whether it's in the active screen or not Textualize#2606
  • The default Widget repr no longer displays classes and pseudo-classes (to reduce noise in logs). Add them to your __rich_repr__ method if needed. Textualize#2623
  • Setting Screen.AUTO_FOCUS to None will inherit AUTO_FOCUS from the app instead of disabling it Textualize#2594
  • Setting Screen.AUTO_FOCUS to "" will disable it on the screen Textualize#2594
  • Messages now have a handler_name class var which contains the name of the default handler method.
  • Message.control is now a property instead of a class variable. Textualize#2528
  • Tree and DirectoryTree Messages no longer accept a tree parameter, using self.node.tree instead. Textualize#2529
  • Keybinding right in Input is also used to accept a suggestion if the cursor is at the end of the input Textualize#2604
  • Input.__init__ now accepts a suggester attribute for completion suggestions Textualize#2604
  • Using switch_screen to switch to the currently active screen is now a no-op Textualize#2692
  • Breaking change: removed reactive.py::Reactive.var in favor of reactive.py::var Textualize#2709

Removed

  • Placeholder.reset_color_cycle
  • Removed Widget.reset_focus (now called Widget.blur) Textualize#2642

0.26.0 - 2023-05-20

Added

  • Added Widget.can_view

Changed

  • Textual will now scroll focused widgets to center if not in view

0.25.0 - 2023-05-17

Changed

  • App title and sub_title attributes can be set to any type Textualize#2521
  • DirectoryTree now loads directory contents in a worker Textualize#2456
  • Only a single error will be written by default, unless in dev mode ("debug" in App.features) Textualize#2480
  • Using Widget.move_child where the target and the child being moved are the same is now a no-op Textualize#1743
  • Calling dismiss on a screen that is not at the top of the stack now raises an exception Textualize#2575
  • MessagePump.call_after_refresh and MessagePump.call_later will now return False if the callback could not be scheduled. Textualize#2584

Fixed

  • Fixed ZeroDivisionError in resolve_fraction_unit Textualize#2502
  • Fixed TreeNode.expand and TreeNode.expand_all not posting a Tree.NodeExpanded message Textualize#2535
  • Fixed TreeNode.collapse and TreeNode.collapse_all not posting a Tree.NodeCollapsed message Textualize#2535
  • Fixed TreeNode.toggle and TreeNode.toggle_all not posting a Tree.NodeExpanded or Tree.NodeCollapsed message Textualize#2535
  • footer--description component class was being ignored Textualize#2544
  • Pasting empty selection in Input would raise an exception Textualize#2563
  • Screen.AUTO_FOCUS now focuses the first focusable widget that matches the selector Textualize#2578
  • Screen.AUTO_FOCUS now works on the default screen on startup Textualize#2581
  • Fix for setting dark in App __init__ Textualize#2583
  • Fix issue with scrolling and docks Textualize#2525
  • Fix not being able to use CSS classes with Tab Textualize#2589

Added

  • Class variable AUTO_FOCUS to screens Textualize#2457
  • Added NULL_SPACING and NULL_REGION to geometry.py

0.24.1 - 2023-05-08

Fixed

  • Fix TypeError in code browser

0.24.0 - 2023-05-08

Fixed

  • Fixed crash when creating a DirectoryTree starting anywhere other than .
  • Fixed line drawing in Tree when Tree.show_root is True Textualize#2397
  • Fixed line drawing in Tree not marking branches as selected when first getting focus Textualize#2397

Changed

  • The DataTable cursor is now scrolled into view when the cursor coordinate is changed programmatically Textualize#2459
  • run_worker exclusive parameter is now False by default Textualize#2470
  • Added always_update as an optional argument for reactive.var
  • Made Binding description default to empty string, which is equivalent to show=False Textualize#2501
  • Modified Message to allow it to be used as a dataclass Textualize#2501
  • Decorator @on accepts arbitrary **kwargs to apply selectors to attributes of the message Textualize#2498

Added

  • Property control as alias for attribute tabs in Tabs messages Textualize#2483
  • Experimental: Added "overlay" rule Textualize#2501
  • Experimental: Added "constrain" rule Textualize#2501
  • Added textual.widgets.Select Textualize#2501
  • Added Region.translate_inside Textualize#2501
  • TabbedContent now takes kwargs id, name, classes, and disabled, upon initialization, like other widgets Textualize#2497
  • Method DataTable.move_cursor Textualize#2472
  • Added OptionList.add_options Textualize#2508
  • Added TreeNode.is_root Textualize#2510
  • Added TreeNode.remove_children Textualize#2510
  • Added TreeNode.remove Textualize#2510
  • Added classvar Message.ALLOW_SELECTOR_MATCH Textualize#2498
  • Added ALLOW_SELECTOR_MATCH to all built-in messages associated with widgets Textualize#2498
  • Markdown document sub-widgets now reference the container document
  • Table of contents of a markdown document now references the document
  • Added the control property to messages
    • DirectoryTree.FileSelected
    • ListView
      • Highlighted
      • Selected
    • Markdown
      • TableOfContentsUpdated
      • TableOfContentsSelected
      • LinkClicked
    • OptionList
      • OptionHighlighted
      • OptionSelected
    • RadioSet.Changed
    • TabContent.TabActivated
    • Tree
      • NodeSelected
      • NodeHighlighted
      • NodeExpanded
      • NodeCollapsed

0.23.0 - 2023-05-03

Fixed

Changed

  • Setting attributes with a compute_ method will now raise an AttributeError Textualize#2383
  • Unknown psuedo-selectors will now raise a tokenizer error (previously they were silently ignored) Textualize#2445
  • Breaking change: DirectoryTree.FileSelected.path is now always a Path Textualize#2448
  • Breaking change: Directorytree.load_directory renamed to Directorytree._load_directory Textualize#2448
  • Unknown pseudo-selectors will now raise a tokenizer error (previously they were silently ignored) Textualize#2445

Added

0.22.3 - 2023-04-29

Fixed

  • Fixed textual run on Windows Textualize#2406
  • Fixed top border of button hover state

0.22.2 - 2023-04-29

Added

Fixed

  • Fixed superfluous style updates for focus-within pseudo-selector

0.22.1 - 2023-04-28

Fixed

0.22.0 - 2023-04-27

Fixed

  • Fixed broken fr units when there is a min or max dimension Textualize#2378
  • Fixed plain text in Markdown code blocks with no syntax being difficult to read Textualize#2400

Added

Changed

  • All textual.containers are now 1fr in relevant dimensions by default Textualize#2386

0.21.0 - 2023-04-26

Changed

  • textual run execs apps in a new context.
  • Textual console no longer parses console markup.
  • Breaking change: Container no longer shows required scrollbars by default Textualize#2361
  • Breaking change: VerticalScroll no longer shows a required horizontal scrollbar by default
  • Breaking change: HorizontalScroll no longer shows a required vertical scrollbar by default
  • Breaking change: Renamed App.action_add_class_ to App.action_add_class
  • Breaking change: Renamed App.action_remove_class_ to App.action_remove_class
  • Breaking change: RadioSet is now a single focusable widget Textualize#2372
  • Breaking change: Removed containers.Content (use containers.VerticalScroll now)

Added

  • Added -c switch to textual run which runs commands in a Textual dev environment.
  • Breaking change: standard keyboard scrollable navigation bindings have been moved off Widget and onto a new base class for scrollable containers (see also below addition) Textualize#2332
  • ScrollView now inherits from ScrollableContainer rather than Widget Textualize#2332
  • Containers no longer inherit any bindings from Widget Textualize#2331
  • Added ScrollableContainer; a container class that binds the common navigation keys to scroll actions (see also above breaking change) Textualize#2332

Fixed

  • Fixed dark mode toggles in a "child" screen not updating a "parent" screen Textualize#1999
  • Fixed "panel" border not exposed via CSS
  • Fixed TabbedContent.active changes not changing the actual content Textualize#2352
  • Fixed broken color on macOS Terminal Textualize#2359

0.20.1 - 2023-04-18

Fix

0.20.0 - 2023-04-18

Changed

  • Changed signature of Driver. Technically a breaking change, but unlikely to affect anyone.
  • Breaking change: Timer.start is now private, and returns None. There was no reason to call this manually, so unlikely to affect anyone.
  • A clicked tab will now be scrolled to the center of its tab container Textualize#2276
  • Style updates are now done immediately rather than on_idle Textualize#2304
  • ButtonVariant is now exported from textual.widgets.button Textualize#2264
  • HorizontalScroll and VerticalScroll are now focusable by default Textualize#2317

Added

Fixed

  • Fixed order styles are applied in DataTable - allows combining of renderable styles and component classes Textualize#2272
  • Fixed key combos with up/down keys in some terminals Textualize#2280
  • Fix empty ListView preventing bindings from firing Textualize#2281
  • Fix get_component_styles returning incorrect values on first call when combined with pseudoclasses Textualize#2304
  • Fixed active_message_pump.get sometimes resulting in a LookupError Textualize#2301

0.19.1 - 2023-04-10

Fixed

0.19.0 - 2023-04-07

Added

Changed

  • Allowed border_title and border_subtitle to accept Text objects
  • Added additional line around titles
  • When a container is auto, relative dimensions in children stretch the container. Textualize#2221
  • DataTable page up / down now move cursor

Fixed

0.18.0 - 2023-04-04

Added

Changed

  • Breaking change: Markdown.update is no longer a coroutine Textualize#2182

Fixed

  • RadioSet is now far less likely to report pressed_button as None Textualize#2203

0.17.3 - 2023-04-02

[Fixed]

0.17.2 - 2023-04-02

[Fixed]

[Changed]

  • tab and shift+tab are now defined on Screen.

0.17.1 - 2023-03-30

Fixed

0.17.0 - 2023-03-29

Fixed

Changed

  • DataTable now has height: auto by default. Textualize#2117
  • Textual will now render strings within renderables (such as tables) as Console Markup by default. You can wrap your text with rich.Text() if you want the original behavior. Textualize#2120
  • Some widget methods now return self instead of None Textualize#2102:
    • Widget: refresh, focus, reset_focus
    • Button.press
    • DataTable: clear, refresh_coordinate, refresh_row, refresh_column, sort
    • Placehoder.cycle_variant
    • Switch.toggle
    • Tabs.clear
    • TextLog: write, clear
    • TreeNode: expand, expand_all, collapse, collapse_all, toggle, toggle_all
    • Tree: clear, reset
  • Screens with alpha in their background color will now blend with the background. Textualize#2139
  • Added "thick" border style. Textualize#2139
  • message_pump.app will now set the active app if it is not already set.
  • DataTable now has max height set to 100vh

Added

  • Added auto_scroll attribute to TextLog Textualize#2127
  • Added scroll_end switch to TextLog.write Textualize#2127
  • Added Widget.get_pseudo_class_state Textualize#2155
  • Added Screen.ModalScreen which prevents App from handling bindings. Textualize#2139
  • Added TEXTUAL_LOG env var which should be a path that Textual will write verbose logs to (textual devtools is generally preferred) Textualize#2148
  • Added textual.logging.TextualHandler logging handler
  • Added Query.set_classes, DOMNode.set_classes, and classes setter for Widget Textualize#1081
  • Added OptionList Textualize#2154

0.16.0 - 2023-03-22

Added

Changed

  • Dropped "loading-indicator--dot" component style from LoadingIndicator Textualize#2050
  • Tabs widget now sends Tabs.Cleared when there is no active tab.
  • Breaking change: changed default behaviour of Vertical (see VerticalScroll) Textualize#1957
  • The default overflow style for Horizontal was changed to hidden hidden Textualize#1957
  • DirectoryTree also accepts pathlib.Path objects as the path to list Textualize#1438

Removed

  • Removed sender attribute from messages. It's now just private (_sender). Textualize#2071

Fixed

0.15.1 - 2023-03-14

Fixed

  • Fixed how the namespace for messages is calculated to facilitate inheriting messages Textualize#1814
  • Tab is now correctly made available from textual.widgets. Textualize#2044

0.15.0 - 2023-03-13

Fixed

  • Fixed container not resizing when a widget is removed Textualize#2007
  • Fixes issue where the horizontal scrollbar would be incorrectly enabled Textualize#2024

0.15.0 - 2023-03-13

Changed

  • Fixed container not resizing when a widget is removed Textualize#2007
  • Fixed issue where the horizontal scrollbar would be incorrectly enabled Textualize#2024
  • Fixed Pilot.click not correctly creating the mouse events Textualize#2022
  • Fixes issue where the horizontal scrollbar would be incorrectly enabled Textualize#2024
  • Fixes for tracebacks not appearing on exit Textualize#2027

Added

Changed

  • Breaking change: Renamed Widget.action and App.action to Widget.run_action and App.run_action
  • Added shift, meta and control arguments to Pilot.click.

0.14.0 - 2023-03-09

Changed

  • Breaking change: There is now only post_message to post events, which is non-async, post_message_no_wait was dropped. Textualize#1940
  • Breaking change: The Timer class now has just one method to stop it, Timer.stop which is non sync Textualize#1940
  • Breaking change: Messages don't require a sender in their constructor Textualize#1940
  • Many messages have grown a control property which returns the control they relate to. Textualize#1940
  • Updated styling to make it clear DataTable grows horizontally Textualize#1946
  • Changed the Checkbox character due to issues with Windows Terminal and Windows 10 Textualize#1934
  • Changed the RadioButton character due to issues with Windows Terminal and Windows 10 and 11 Textualize#1934
  • Changed the Markdown initial bullet character due to issues with Windows Terminal and Windows 10 and 11 Textualize#1982
  • The underscore _ is no longer a special alias for the method pilot.press

Added

Fixed

0.13.0 - 2023-03-02

Added

Changed

  • Widget scrolling methods (such as Widget.scroll_home and Widget.scroll_end) now perform the scroll after the next refresh Textualize#1774
  • Buttons no longer accept arbitrary renderables Textualize#1870

Fixed

0.12.1 - 2023-02-25

Fixed

0.12.0 - 2023-02-24

Added

Changed

  • Scrolling by page now adds to current position.
  • Markdown lists have been polished: a selection of bullets, better alignment of numbers, style tweaks Textualize#1832
  • Added alternative method of composing Widgets Textualize#1847
  • Added label parameter to DataTable.add_row Textualize#1868
  • Breaking change: Some DataTable component classes were renamed - see PR for details Textualize#1868

Removed

  • Removed screen.visible_widgets and screen.widgets
  • Removed StylesUpdate message. Textualize#1861

Fixed

  • Numbers in a descendant-combined selector no longer cause an error Textualize#1836
  • Fixed superfluous scrolling when focusing a docked widget Textualize#1816
  • Fixes walk_children which was returning more than one screen Textualize#1846
  • Fixed issue with watchers fired for detached nodes Textualize#1846

0.11.1 - 2023-02-17

Fixed

0.11.0 - 2023-02-15

Added

  • Added TreeNode.expand_all Textualize#1430
  • Added TreeNode.collapse_all Textualize#1430
  • Added TreeNode.toggle_all Textualize#1430
  • Added the coroutines Animator.wait_until_complete and pilot.wait_for_scheduled_animations that allow waiting for all current and scheduled animations Textualize#1658
  • Added the method Animator.is_being_animated that checks if an attribute of an object is being animated or is scheduled for animation
  • Added more keyboard actions and related bindings to Input Textualize#1676
  • Added App.scroll_sensitivity_x and App.scroll_sensitivity_y to adjust how many lines the scroll wheel moves the scroll position Textualize#928
  • Added Shift+scroll wheel and ctrl+scroll wheel to scroll horizontally
  • Added Tree.action_toggle_node to toggle a node without selecting, and bound it to Space Textualize#1433
  • Added Tree.reset to fully reset a Tree Textualize#1437
  • Added DataTable.sort to sort rows Textualize#1638
  • Added DataTable.get_cell to retrieve a cell by column/row keys Textualize#1638
  • Added DataTable.get_cell_at to retrieve a cell by coordinate Textualize#1638
  • Added DataTable.update_cell to update a cell by column/row keys Textualize#1638
  • Added DataTable.update_cell_at to update a cell at a coordinate Textualize#1638
  • Added DataTable.ordered_rows property to retrieve Rows as they're currently ordered Textualize#1638
  • Added DataTable.ordered_columns property to retrieve Columns as they're currently ordered Textualize#1638
  • Added DataTable.coordinate_to_cell_key to find the key for the cell at a coordinate Textualize#1638
  • Added DataTable.is_valid_coordinate Textualize#1638
  • Added DataTable.is_valid_row_index Textualize#1638
  • Added DataTable.is_valid_column_index Textualize#1638
  • Added attributes to events emitted from DataTable indicating row/column/cell keys Textualize#1638
  • Added DataTable.get_row to retrieve the values from a row by key Textualize#1786
  • Added DataTable.get_row_at to retrieve the values from a row by index Textualize#1786
  • Added DataTable.get_column to retrieve the values from a column by key Textualize#1786
  • Added DataTable.get_column_at to retrieve the values from a column by index Textualize#1786
  • Added DataTable.HeaderSelected which is posted when header label clicked Textualize#1788
  • Added DOMNode.watch and DOMNode.is_attached methods Textualize#1750
  • Added DOMNode.css_tree which is a renderable that shows the DOM and CSS Textualize#1778
  • Added DOMNode.children_view which is a view on to a nodes children list, use for querying Textualize#1778
  • Added Markdown and MarkdownViewer widgets.
  • Added --screenshot option to textual run

Changed

  • Breaking change: TreeNode can no longer be imported from textual.widgets; it is now available via from textual.widgets.tree import TreeNode. Textualize#1637
  • Tree now shows a (subdued) cursor for a highlighted node when focus has moved elsewhere Textualize#1471
  • DataTable.add_row now accepts key argument to uniquely identify the row Textualize#1638
  • DataTable.add_column now accepts key argument to uniquely identify the column Textualize#1638
  • DataTable.add_row and DataTable.add_column now return lists of keys identifying the added rows/columns Textualize#1638
  • Breaking change: DataTable.get_cell_value renamed to DataTable.get_value_at Textualize#1638
  • DataTable.row_count is now a property Textualize#1638
  • Breaking change: DataTable.cursor_cell renamed to DataTable.cursor_coordinate Textualize#1638
    • The method validate_cursor_cell was renamed to validate_cursor_coordinate.
    • The method watch_cursor_cell was renamed to watch_cursor_coordinate.
  • Breaking change: DataTable.hover_cell renamed to DataTable.hover_coordinate Textualize#1638
    • The method validate_hover_cell was renamed to validate_hover_coordinate.
  • Breaking change: DataTable.data structure changed, and will be made private in upcoming release Textualize#1638
  • Breaking change: DataTable.refresh_cell was renamed to DataTable.refresh_coordinate Textualize#1638
  • Breaking change: DataTable.get_row_height now takes a RowKey argument instead of a row index Textualize#1638
  • Breaking change: DataTable.data renamed to DataTable._data (it's now private) Textualize#1786
  • The _filter module was made public (now called filter) Textualize#1638
  • Breaking change: renamed Checkbox to Switch Textualize#1746
  • App.install_screen name is no longer optional Textualize#1778
  • App.query now only includes the current screen Textualize#1778
  • DOMNode.tree now displays simple DOM structure only Textualize#1778
  • App.install_screen now returns None rather than AwaitMount Textualize#1778
  • DOMNode.children is now a simple sequence, the NodesList is exposed as DOMNode._nodes Textualize#1778
  • DataTable cursor can now enter fixed columns Textualize#1799

Fixed

  • Fixed stuck screen Textualize#1632
  • Fixed programmatic style changes not refreshing children layouts when parent widget did not change size Textualize#1607
  • Fixed relative units in grid-rows and grid-columns being computed with respect to the wrong dimension Textualize#1406
  • Fixed bug with animations that were triggered back to back, where the second one wouldn't start Textualize#1372
  • Fixed bug with animations that were scheduled where all but the first would be skipped Textualize#1372
  • Programmatically setting overflow_x/overflow_y refreshes the layout correctly Textualize#1616
  • Fixed double-paste into Input Textualize#1657
  • Added a workaround for an apparent Windows Terminal paste issue Textualize#1661
  • Fixed issue with renderable width calculation Textualize#1685
  • Fixed issue with app not processing Paste event Textualize#1666
  • Fixed glitch with view position with auto width inputs Textualize#1693
  • Fixed DataTable "selected" events containing wrong coordinates when mouse was used Textualize#1723

Removed

  • Methods MessagePump.emit and MessagePump.emit_no_wait Textualize#1738
  • Removed reactive.watch in favor of DOMNode.watch.

0.10.1 - 2023-01-20

Added

Fixed

  • Fixed textual diagnose crash on older supported Python versions. Textualize#1622

Changed

  • The default filename for screenshots uses a datetime format similar to ISO8601, but with reserved characters replaced by underscores Textualize#1518

0.10.0 - 2023-01-19

Added

  • Added TreeNode.parent -- a read-only property for accessing a node's parent Textualize#1397
  • Added public TreeNode label access via TreeNode.label Textualize#1396
  • Added read-only public access to the children of a TreeNode via TreeNode.children Textualize#1398
  • Added Tree.get_node_by_id to allow getting a node by its ID Textualize#1535
  • Added a Tree.NodeHighlighted message, giving a on_tree_node_highlighted event handler Textualize#1400
  • Added a inherit_component_classes subclassing parameter to control whether component classes are inherited from base classes Textualize#1399
  • Added diagnose as a textual command Textualize#1542
  • Added row and column cursors to DataTable Textualize#1547
  • Added an optional parameter selector to the methods Screen.focus_next and Screen.focus_previous that enable using a CSS selector to narrow down which widgets can get focus Textualize#1196

Changed

  • MouseScrollUp and MouseScrollDown now inherit from MouseEvent and have attached modifier keys. Textualize#1458
  • Fail-fast and print pretty tracebacks for Widget compose errors Textualize#1505
  • Added Widget._refresh_scroll to avoid expensive layout when scrolling Textualize#1524
  • events.Paste now bubbles Textualize#1434
  • Improved error message when style flag none is mixed with other flags (e.g., when setting text-style) Textualize#1420
  • Clock color in the Header widget now matches the header color Textualize#1459
  • Programmatic calls to scroll now optionally scroll even if overflow styling says otherwise (introduces a new force parameter to all the scroll_* methods) Textualize#1201
  • COMPONENT_CLASSES are now inherited from base classes Textualize#1399
  • Watch methods may now take no parameters
  • Added compute parameter to reactive
  • A TypeError raised during compose now carries the full traceback
  • Removed base class NodeMessage from which all node-related Tree events inherited

Fixed

0.9.1 - 2022-12-30

Added

0.9.0 - 2022-12-30

Added

  • Added textual.strip.Strip primitive
  • Added textual._cache.FIFOCache
  • Added an option to clear columns in DataTable.clear() Textualize#1427

Changed

  • Widget.render_line now returns a Strip
  • Fix for slow updates on Windows
  • Bumped Rich dependency

0.8.2 - 2022-12-28

Fixed

0.8.1 - 2022-12-25

Fixed

0.8.0 - 2022-12-22

Fixed

  • Fixed issues with nested auto dimensions Textualize#1402
  • Fixed watch method incorrectly running on first set when value hasn't changed and init=False Textualize#1367
  • App.dark can now be set from App.on_load without an error being raised Textualize#1369
  • Fixed setting visibility changes needing a refresh Textualize#1355

Added

  • Added textual.actions.SkipAction exception which can be raised from an action to allow parents to process bindings.
  • Added textual keys preview.
  • Added ability to bind to a character in addition to key name. i.e. you can bind to "." or "full_stop".
  • Added TextLog.shrink attribute to allow renderable to reduce in size to fit width.

Changed

  • Deprecated PRIORITY_BINDINGS class variable.
  • Renamed char to character on Key event.
  • Renamed key_name to name on Key event.
  • Queries/walk_children no longer includes self in results by default Textualize#1416

0.7.0 - 2022-12-17

Added

  • Added PRIORITY_BINDINGS class variable, which can be used to control if a widget's bindings have priority by default. Textualize#1343

Changed

  • Renamed the Binding argument universal to priority. Textualize#1343
  • When looking for bindings that have priority, they are now looked from App downwards. Textualize#1343
  • BINDINGS on an App-derived class have priority by default. Textualize#1343
  • BINDINGS on a Screen-derived class have priority by default. Textualize#1343
  • Added a message parameter to Widget.exit

Fixed

0.6.0 - 2022-12-11

https://textual.textualize.io/blog/2022/12/11/version-060

Added

  • Added "inherited bindings" -- BINDINGS classvar will be merged with base classes, unless inherit_bindings is set to False
  • Added Tree widget which replaces TreeControl.
  • Added widget Placeholder Textualize#1200.
  • Added ListView and ListItem widgets Textualize#1143

Changed

  • Rebuilt DirectoryTree with new Tree control.
  • Empty containers with a dimension set to "auto" will now collapse instead of filling up the available space.
  • Container widgets now have default height of 1fr.
  • The default width of a Label is now auto.

Fixed

  • Type selectors can now contain numbers Textualize#1253
  • Fixed visibility not affecting children Textualize#1313
  • Fixed issue with auto width/height and relative children Textualize#1319
  • Fixed issue with offset applied to containers Textualize#1256
  • Fixed default CSS retrieval for widgets with no DEFAULT_CSS that inherited from widgets with DEFAULT_CSS Textualize#1335
  • Fixed merging of BINDINGS when binding inheritance is set to None Textualize#1351

0.5.0 - 2022-11-20

Added

  • Add get_child_by_id and get_widget_by_id, remove get_child Textualize#1146
  • Add easing parameter to Widget.scroll_* methods Textualize#1144
  • Added Widget.call_later which invokes a callback on idle.
  • DOMNode.ancestors no longer includes self.
  • Added DOMNode.ancestors_with_self, which retains the old behaviour of DOMNode.ancestors.
  • Improved the speed of DOMQuery.remove.
  • Added DataTable.clear
  • Added low-level textual.walk methods.
  • It is now possible to await a Widget.remove. Textualize#1094
  • It is now possible to await a DOMQuery.remove. Note that this changes the return value of DOMQuery.remove, which used to return self. Textualize#1094
  • Added Pilot.wait_for_animation
  • Added Widget.move_child Textualize#1121
  • Added a Label widget Textualize#1190
  • Support lazy-instantiated Screens (callables in App.SCREENS) Textualize#1185
  • Display of keys in footer has more sensible defaults Textualize#1213
  • Add App.get_key_display, allowing custom key_display App-wide Textualize#1213

Changed

  • Watchers are now called immediately when setting the attribute if they are synchronous. Textualize#1145
  • Widget.call_later has been renamed to Widget.call_after_refresh.
  • Button variant values are now checked at runtime. Textualize#1189
  • Added caching of some properties in Styles object

Fixed

  • Fixed DataTable row not updating after add Textualize#1026
  • Fixed issues with animation. Now objects of different types may be animated.
  • Fixed containers with transparent background not showing borders Textualize#1175
  • Fixed auto-width in horizontal containers Textualize#1155
  • Fixed Input cursor invisible when placeholder empty Textualize#1202
  • Fixed deadlock when removing widgets from the App Textualize#1219

0.4.0 - 2022-11-08

https://textual.textualize.io/blog/2022/11/08/version-040/#version-040

Changed

  • Dropped support for mounting "named" and "anonymous" widgets via App.mount and Widget.mount. Both methods now simply take one or more widgets as positional arguments.
  • DOMNode.query_one now raises a TooManyMatches exception if there is more than one matching node. Textualize#1096
  • App.mount and Widget.mount have new before and after parameters Textualize#778

Added

0.3.0 - 2022-10-31

Fixed

  • Fixed issue where scrollbars weren't being unmounted
  • Fixed fr units for horizontal and vertical layouts Textualize#1067
  • Fixed textual run breaking sys.argv Textualize#1064
  • Fixed footer not updating styles when toggling dark mode
  • Fixed how the app title in a Header is centred Textualize#1060
  • Fixed the swapping of button variants Textualize#1048
  • Fixed reserved characters in screenshots Textualize#993
  • Fixed issue with TextLog max_lines Textualize#1058

Changed

  • DOMQuery now raises InvalidQueryFormat in response to invalid query strings, rather than cryptic CSS error
  • Dropped quit_after, screenshot, and screenshot_title from App.run, which can all be done via auto_pilot
  • Widgets are now closed in reversed DOM order
  • Input widget justify hardcoded to left to prevent text-align interference
  • Changed textual run so that it patches argv in more situations
  • DOM classes and IDs are now always treated fully case-sensitive Textualize#1047

Added

  • Added Unmount event
  • Added App.run_async method
  • Added App.run_test context manager
  • Added auto_pilot to App.run and App.run_async
  • Added Widget._get_virtual_dom to get scrollbars
  • Added size parameter to run and run_async
  • Added always_update to reactive
  • Returned an awaitable from push_screen, switch_screen, and install_screen Textualize#1061

0.2.1 - 2022-10-23

Changed

  • Updated meta data for PyPI

0.2.0 - 2022-10-23

Added

  • CSS support
  • Too numerous to mention

0.1.18 - 2022-04-30

Changed

  • Bump typing extensions

0.1.17 - 2022-03-10

Changed

  • Bumped Rich dependency

0.1.16 - 2022-03-10

Fixed

  • Fixed escape key hanging on Windows

0.1.15 - 2022-01-31

Added

  • Added Windows Driver

0.1.14 - 2022-01-09

Changed

  • Updated Rich dependency to 11.X

0.1.13 - 2022-01-01

Fixed

  • Fixed spurious characters when exiting app
  • Fixed increasing delay when exiting

0.1.12 - 2021-09-20

Added

  • Added geometry.Spacing

Fixed

  • Fixed calculation of virtual size in scroll views

0.1.11 - 2021-09-12

Changed

  • Changed message handlers to use prefix handle_
  • Renamed messages to drop the Message suffix
  • Events now bubble by default
  • Refactor of layout

Added

  • Added App.measure
  • Added auto_width to Vertical Layout, WindowView, an ScrollView
  • Added big_table.py example
  • Added easing.py example

0.1.10 - 2021-08-25

Added

  • Added keyboard control of tree control
  • Added Widget.gutter to calculate space between renderable and outside edge
  • Added margin, padding, and border attributes to Widget

Changed

  • Callbacks may be async or non-async.
  • Event handler event argument is optional.
  • Fixed exception in clock example Textualize#52
  • Added Message.wait() which waits for a message to be processed
  • Key events are now sent to widgets first, before processing bindings

0.1.9 - 2021-08-06

Added

  • Added hover over and mouse click to activate keys in footer
  • Added verbosity argument to Widget.log

Changed

  • Simplified events. Remove Startup event (use Mount)
  • Changed geometry.Point to geometry.Offset and geometry.Dimensions to geometry.Size

0.1.8 - 2021-07-17

Fixed

  • Fixed exiting mouse mode
  • Fixed slow animation

Added

  • New log system

0.1.7 - 2021-07-14

Changed

  • Added functionality to calculator example.
  • Scrollview now shows scrollbars automatically
  • New handler system for messages that doesn't require inheritance
  • Improved traceback handling