Merge pull request #6121 from TomJGooding/build-update-supported-python-versions

build!: update supported Python versions

Author: willmcgugan

.github/workflows/pythonpackage.yml

@@ -20,7 +20,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
     defaults:
       run:
         shell: bash
@@ -35,18 +35,18 @@ jobs:
           cache: "poetry"
       - name: Install dependencies
         run: poetry install --no-interaction --extras syntax
-        if: ${{ matrix.python-version != '3.8' && matrix.python-version != '3.9' }}
-      - name: Install dependencies for 3.8 and 3.9
+        if: ${{ matrix.python-version != '3.9' }}
+      - name: Install dependencies for 3.9
         run: poetry install --no-interaction
-        if: ${{ matrix.python-version == '3.8' || matrix.python-version == '3.9' }}
+        if: ${{ matrix.python-version == '3.9' }}
       - name: Test with pytest (Py310+ - with syntax highlighting)
         run: |
           poetry run pytest tests -v --cov=./src/textual --cov-report=xml:./coverage.xml --cov-report term-missing
-        if: ${{ matrix.python-version != '3.8' && matrix.python-version != '3.9' }}
+        if: ${{ matrix.python-version != '3.9' }}
       - name: Test with pytest (Py39 - without syntax highlighting)
         run: |
           poetry run pytest tests -v --cov=./src/textual --cov-report=xml:./coverage.xml --cov-report term-missing -m 'not syntax'
-        if: ${{ matrix.python-version == '3.8' || matrix.python-version == '3.9' }}
+        if: ${{ matrix.python-version == '3.9' }}
       - name: Upload snapshot report
         if: always()
         uses: actions/upload-artifact@v4

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## Unreleased
+## [6.3.0] - 2025-10-11
 
 ### Added
 
@@ -15,6 +15,11 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 - Fixed highlight not auto-detecting lexer https://github.com/Textualize/textual/pull/6167
 
+### Changed
+
+- Dropped support for Python3.8 https://github.com/Textualize/textual/pull/6121/
+- Added support for Python3.14 https://github.com/Textualize/textual/pull/6121/
+
 ## [6.2.1] - 2025-10-01
 
 - Fix inability to copy text outside of an input/textarea when it was focused https://github.com/Textualize/textual/pull/6148
@@ -3144,6 +3149,7 @@ 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
 
+[6.3.0]: https://github.com/Textualize/textual/compare/v6.2.1...v6.3.0
 [6.2.1]: https://github.com/Textualize/textual/compare/v6.2.0...v6.2.1
 [6.2.0]: https://github.com/Textualize/textual/compare/v6.1.0...v6.2.0
 [6.1.0]: https://github.com/Textualize/textual/compare/v6.0.0...v6.1.0

README.md

@@ -1,7 +1,7 @@
 
 
 [![Discord](https://img.shields.io/discord/1026214085173461072)](https://discord.gg/Enf6Z3qhVr)
-[![Supported Python Versions](https://img.shields.io/pypi/pyversions/textual/1.0.0)](https://pypi.org/project/textual/)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/textual)](https://pypi.org/project/textual/)
 [![PyPI version](https://badge.fury.io/py/textual.svg?)](https://badge.fury.io/py/textual)
 ![OS support](https://img.shields.io/badge/OS-macOS%20Linux%20Windows-red)
 

docs/getting_started.md

@@ -3,7 +3,7 @@ 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.
+Textual requires Python 3.9 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 "Your platform"
 

poetry.lock

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "textual"
-version = "6.2.1"
+version = "6.3.0"
 homepage = "https://github.com/Textualize/textual"
 repository = "https://github.com/Textualize/textual"
 documentation = "https://textual.textualize.io/"
@@ -17,12 +17,12 @@ classifiers = [
     "Operating System :: Microsoft :: Windows :: Windows 11",
     "Operating System :: MacOS",
     "Operating System :: POSIX :: Linux",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Typing :: Typed",
 ]
 include = [
@@ -41,12 +41,12 @@ include = [
 "Bug Tracker" = "https://github.com/Textualize/textual/issues"
 
 [tool.ruff]
-target-version = "py38"
+target-version = "py39"
 
 [tool.poetry.dependencies]
-python = "^3.8.1"
+python = "^3.9"
 markdown-it-py = { extras = ["plugins", "linkify"], version = ">=2.1.0" }
-rich = ">=13.3.3"
+rich = ">=14.2.0"
 #rich = {path="../rich", develop=true}
 typing-extensions = "^4.4.0"
 platformdirs = ">=3.6.0,<5"

pyproject.toml

@@ -7,15 +7,15 @@
 from textual.widget import Widget
 
 
-def test_arrange_empty():
+async def test_arrange_empty():
     container = Widget(id="container")
 
     result = arrange(container, [], Size(80, 24), Size(80, 24))
     assert result.placements == []
     assert result.widgets == set()
 
 
-def test_arrange_dock_top():
+async def test_arrange_dock_top():
     container = Widget(id="container")
     container._parent = App()
     child = Widget(id="child")
@@ -36,7 +36,7 @@ def test_arrange_dock_top():
     assert result.widgets == {child, header}
 
 
-def test_arrange_dock_left():
+async def test_arrange_dock_left():
     container = Widget(id="container")
     container._parent = App()
     child = Widget(id="child")
@@ -61,7 +61,7 @@ def test_arrange_dock_left():
     assert result.widgets == {child, header}
 
 
-def test_arrange_dock_right():
+async def test_arrange_dock_right():
     container = Widget(id="container")
     container._parent = App()
     child = Widget(id="child")
@@ -86,7 +86,7 @@ def test_arrange_dock_right():
     assert result.widgets == {child, header}
 
 
-def test_arrange_dock_bottom():
+async def test_arrange_dock_bottom():
     container = Widget(id="container")
     container._parent = App()
     child = Widget(id="child")
@@ -111,7 +111,7 @@ def test_arrange_dock_bottom():
     assert result.widgets == {child, header}
 
 
-def test_arrange_dock_badly():
+async def test_arrange_dock_badly():
     child = Widget(id="child")
     child.styles.dock = "nowhere"
     with pytest.raises(AssertionError):

tests/snapshot_tests/__snapshots__/test_snapshots/test_textual_dev_keys_preview.svg

@@ -31,7 +31,7 @@ def test_border_render_row():
     ]
 
 
-def test_border_title_single_line():
+async def test_border_title_single_line():
     """The border_title gets set to a single line even when multiple lines are provided."""
     widget = Widget()
 
@@ -59,7 +59,7 @@ def test_border_title_single_line():
     assert widget.border_title == "[bold]Hello World[/bold]"
 
 
-def test_border_subtitle_single_line():
+async def test_border_subtitle_single_line():
     """The border_subtitle gets set to a single line even when multiple lines are provided."""
     widget = Widget()
 

tests/test_arrange.py

@@ -7,7 +7,7 @@
 from textual.widget import Widget
 
 
-def test_content_box():
+async def test_content_box():
     one = Fraction(1)
 
     class TestWidget(Widget):
@@ -44,7 +44,7 @@ def get_content_height(self, container: Size, parent: Size) -> int:
     assert box_model == BoxModel(Fraction(14), Fraction(12), Spacing(0, 0, 0, 0))
 
 
-def test_width():
+async def test_width():
     """Test width settings."""
 
     one = Fraction(1)
@@ -93,7 +93,7 @@ def get_content_height(self, container: Size, parent: Size, width: int) -> int:
     assert box_model == BoxModel(Fraction(27), Fraction(16), Spacing(1, 2, 3, 4))
 
 
-def test_height():
+async def test_height():
     """Test height settings."""
 
     one = Fraction(1)
@@ -143,7 +143,7 @@ def get_content_height(self, container: Size, parent: Size, width: int) -> int:
     assert box_model == BoxModel(Fraction(54), Fraction(8), Spacing(1, 2, 3, 4))
 
 
-def test_max():
+async def test_max():
     """Check that max_width and max_height are respected."""
     one = Fraction(1)
 
@@ -166,7 +166,7 @@ def get_content_height(self, container: Size, parent: Size, width: int) -> int:
     assert box_model == BoxModel(Fraction(40), Fraction(30), Spacing(0, 0, 0, 0))
 
 
-def test_min():
+async def test_min():
     """Check that min_width and min_height are respected."""
 
     one = Fraction(1)