Merge branch 'main' into app-query-change

Author: willmcgugan

CHANGELOG.md

@@ -7,10 +7,53 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## Unreleased
 
+
 ### Changed
 
 - Breaking change: `App.query` and friends will now always query the default (first) screen, not necessarily the active screen.
 - Content now has a default argument of an empty string, so `Content()` is equivalent to `Content("")`
+- Assigned names to Textual-specific threads: `textual-input`, `textual-output`. These should become visible in monitoring tools (ps, top, htop) as of Python 3.14. https://github.com/Textualize/textual/pull/5654
+- Tabs now accept Content or content markup https://github.com/Textualize/textual/pull/5657
+- Buttons will now use Textual markup rather than console markup
+- tree-sitter languages are now loaded lazily, improving cold-start time https://github.com/Textualize/textual/pull/563
+
+### Fixed
+
+- Static and Label now accept Content objects, satisfying type checkers https://github.com/Textualize/textual/pull/5618
+- Fixed click selection not being disabled when allow_select was set to false https://github.com/Textualize/textual/issues/5627
+- Fixed crash on clicking line API border https://github.com/Textualize/textual/pull/5641
+- Fixed additional spaces after text-wrapping https://github.com/Textualize/textual/pull/5657
+- Added missing `scroll_end` parameter to the `Log.write_line` method https://github.com/Textualize/textual/pull/5672
+- Restored support for blink https://github.com/Textualize/textual/pull/5675
+
+### Added
+
+- Added Widget.preflight_checks to perform some debug checks after a widget is instantiated, to catch common errors. https://github.com/Textualize/textual/pull/5588
+- Added text-padding style https://github.com/Textualize/textual/pull/5657
+- Added `Content.first_line` property https://github.com/Textualize/textual/pull/5657
+- Added `Content.from_text` constructor https://github.com/Textualize/textual/pull/5657
+- Added `Content.empty` constructor https://github.com/Textualize/textual/pull/5657
+- Added `Content.pad` method https://github.com/Textualize/textual/pull/5657
+- Added `Style.has_transparent_foreground` property https://github.com/Textualize/textual/pull/5657
+
+
+## [2.1.2] - 2025-02-26
+
+### Fixed
+
+- Fixed command palette fuzzy search bailing too early https://github.com/Textualize/textual/pull/5579
+
+## [2.1.1] - 2025-02-22
+
+### Fixed
+
+- Fixed `Link` binding to open the link https://github.com/Textualize/textual/issues/5564
+- Fixed IndexError in OptionList https://github.com/Textualize/textual/pull/5574
+- Fixed issue with clear_panes breaking tabbed content https://github.com/Textualize/textual/pull/5573
+
+## Changed
+
+- The user can now interrupt a scroll to end by grabbing the scrollbar or scrolling in any other way. Press ++end++ or scroll to the end to restore default behavior. This is more intuitive that it may sound.
 
 ## [2.1.0] - 2025-02-19
 
@@ -97,11 +140,11 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### Changed
 
 - Breaking change: OptionList no longer supports `Separator`, a separator may be specified with `None`
-- Implemented smooth (pixel perfect) scrolling on supported terminals. Set `TEXTUAL_SMOOTH_SCROLL=0` to disable. 
+- Implemented smooth (pixel perfect) scrolling on supported terminals. Set `TEXTUAL_SMOOTH_SCROLL=0` to disable.
 
 ### Removed
 
-- Breaking change: Removed `wrap` argument from OptionList (use CSS `text-wrap: nowrap; text-overflow: ellipses`)
+- Breaking change: Removed `wrap` argument from OptionList (use CSS `text-wrap: nowrap; text-overflow: ellipsis`)
 - Breaking change: Removed `tooltip` argument from OptionList. Use `tooltip` attribute or `with_tooltip(...)` method.
 
 ## [1.0.0] - 2024-12-12
@@ -2768,6 +2811,8 @@ https://textual.textualize.io/blog/2022/11/08/version-040/#version-040
 - New handler system for messages that doesn't require inheritance
 - Improved traceback handling
 
+[2.1.2]: https://github.com/Textualize/textual/compare/v2.1.1...v2.1.2
+[2.1.1]: https://github.com/Textualize/textual/compare/v2.1.0...v2.1.1
 [2.1.0]: https://github.com/Textualize/textual/compare/v2.0.4...v2.1.0
 [2.0.4]: https://github.com/Textualize/textual/compare/v2.0.3...v2.0.4
 [2.0.3]: https://github.com/Textualize/textual/compare/v2.0.2...v2.0.3

docs/examples/widgets/radio_button.py

@@ -1,3 +1,5 @@
+from rich.text import Text
+
 from textual.app import App, ComposeResult
 from textual.widgets import RadioButton, RadioSet
 
@@ -15,7 +17,9 @@ def compose(self) -> ComposeResult:
             yield RadioButton("Star Wars: A New Hope")
             yield RadioButton("The Last Starfighter")
             yield RadioButton(
-                "Total Recall :backhand_index_pointing_right: :red_circle:"
+                Text.from_markup(
+                    "Total Recall :backhand_index_pointing_right: :red_circle:"
+                )
             )
             yield RadioButton("Wing Commander")
 

docs/examples/widgets/radio_set.py

@@ -1,3 +1,5 @@
+from rich.text import Text
+
 from textual.app import App, ComposeResult
 from textual.containers import Horizontal
 from textual.widgets import RadioButton, RadioSet
@@ -18,7 +20,9 @@ def compose(self) -> ComposeResult:
                 yield RadioButton("Star Wars: A New Hope")
                 yield RadioButton("The Last Starfighter")
                 yield RadioButton(
-                    "Total Recall :backhand_index_pointing_right: :red_circle:"
+                    Text.from_markup(
+                        "Total Recall :backhand_index_pointing_right: :red_circle:"
+                    )
                 )
                 yield RadioButton("Wing Commander")
             # A RadioSet built up from a collection of strings.

docs/examples/widgets/radio_set_changed.py

@@ -1,3 +1,5 @@
+from rich.text import Text
+
 from textual.app import App, ComposeResult
 from textual.containers import Horizontal, VerticalScroll
 from textual.widgets import Label, RadioButton, RadioSet
@@ -18,7 +20,9 @@ def compose(self) -> ComposeResult:
                     yield RadioButton("Star Wars: A New Hope")
                     yield RadioButton("The Last Starfighter")
                     yield RadioButton(
-                        "Total Recall :backhand_index_pointing_right: :red_circle:"
+                        Text.from_markup(
+                            "Total Recall :backhand_index_pointing_right: :red_circle:"
+                        )
                     )
                     yield RadioButton("Wing Commander")
             with Horizontal():

docs/examples/widgets/text_area_custom_language.py

@@ -22,7 +22,7 @@ def compose(self) -> ComposeResult:
         text_area.cursor_blink = False
 
         # Register the Java language and highlight query
-        text_area.register_language(java_language, java_highlight_query)
+        text_area.register_language("java", java_language, java_highlight_query)
 
         # Switch to Java
         text_area.language = "java"

docs/getting_started.md

@@ -1,23 +1,25 @@
+
 All you need to get started building Textual apps.
 
 ## Requirements
 
 Textual requires Python 3.8 or later (if you have a choice, pick the most recent Python). Textual runs on Linux, macOS, Windows and probably any OS where Python also runs.
 
-!!! info inline end "Your platform"
+!!! info "Your platform"
 
     ### :fontawesome-brands-linux: Linux (all distros)
 
     All Linux distros come with a terminal emulator that can run Textual apps.
 
     ### :material-apple: macOS
 
-    The default terminal app is limited to 256 colors. We recommend installing a newer terminal such as [iterm2](https://iterm2.com/), [Kitty](https://sw.kovidgoyal.net/kitty/), or [WezTerm](https://wezfurlong.org/wezterm/).
+    The default terminal app is limited to 256 colors. We recommend installing a newer terminal such as [iterm2](https://iterm2.com/), [Ghostty](https://ghostty.org/), [Kitty](https://sw.kovidgoyal.net/kitty/), or [WezTerm](https://wezfurlong.org/wezterm/).
 
     ### :material-microsoft-windows: Windows
 
     The new [Windows Terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701?hl=en-gb&gl=GB) runs Textual apps beautifully.
 
+
 ## Installation
 
 Here's how to install Textual.
@@ -36,6 +38,12 @@ If you plan on developing Textual apps, you should also install textual develope
 pip install textual-dev
 ```
 
+If you would like to enable syntax highlighting in the [TextArea](./widgets/text_area.md) widget, you should specify the "syntax" extras when you install Textual:
+
+```
+pip install "textual[syntax]"
+```
+
 ### From conda-forge
 
 Textual is also available on [conda-forge](https://conda-forge.org/). The preferred package manager for conda-forge is currently [micromamba](https://mamba.readthedocs.io/en/latest/installation/micromamba-installation.html):

docs/guide/input.md

@@ -185,6 +185,15 @@ You can create priority key bindings by setting `priority=True` on the Binding o
 The [footer](../widgets/footer.md) widget can inspect bindings to display available keys. If you don't want a binding to display in the footer you can set `show=False`. The default bindings on App do this so that the standard ++ctrl+c++, ++tab++ and ++shift+tab++ bindings don't typically appear in the footer.
 
 
+### Dynamic bindings?
+
+You may find you have bindings which are not always applicable given the current state of your app.
+For instance a "Save file" binding when there are no changes to save.
+It wouldn't be a good user experience if the save key did nothing, or raised an error.
+
+Textual doesn't support modifying the bindings at runtime, but you can accomplish this with [dynamic actions](./actions.md#dynamic-actions) which offers greater flexibility.
+
+
 ## Mouse Input
 
 Textual will send events in response to mouse movement and mouse clicks. These events contain the coordinates of the mouse cursor relative to the terminal or widget.

docs/guide/screens.md

@@ -329,6 +329,8 @@ You can switch between these screens at any time by calling [`App.switch_mode`][
 When you switch to a new mode, the topmost screen in the new stack becomes visible.
 Any calls to [`App.push_screen`][textual.app.App.push_screen] or [`App.pop_screen`][textual.app.App.pop_screen] will affect only the active mode.
 
+You can set which mode will be active when the app starts by setting the [`DEFAULT_MODE`][textual.app.App.DEFAULT_MODE] class variable.
+
 Let's look at an example with modes:
 
 === "modes01.py"

docs/widgets/button.md

@@ -51,7 +51,7 @@ This widget has no component classes.
 
 ## Additional Notes
 
-- The spacing between the text and the edges of a button are _not_ due to padding. The default styling for a `Button` has the `height` set to 3 lines and a `min-width` of 16 columns. To create a button with zero visible padding, you will need to change these values and also remove the border with `border: none;`.
+- The spacing between the text and the edges of a button are _not_ due to padding. The default styling for a `Button` includes borders and a `min-width` of 16 columns. To remove the spacing, set `border: none;` in your CSS and adjust the minimum width as needed.
 
 ---
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "textual"
-version = "2.1.0"
+version = "2.1.2"
 homepage = "https://github.com/Textualize/textual"
 repository = "https://github.com/Textualize/textual"
 documentation = "https://textual.textualize.io/"