Release v3.1

.github/workflows/execute-tests.yml → .github/workflows/_common.yml

@@ -1,4 +1,5 @@
-name: Execute tests
+name: Common
+
 on:
   workflow_call:
     inputs:
@@ -19,8 +20,10 @@ jobs:
   test:
     runs-on: ${{ inputs.os }}
     strategy:
+      fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        # Python 3.10 is excluded because macOS is missing gettext
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
     name: Python ${{ matrix.python-version }}
 
     defaults:
@@ -63,7 +66,7 @@ jobs:
 
       - name: Upload coverage
         uses: codecov/codecov-action@v4
-        if: ${{ inputs.os == 'ubuntu-latest' && matrix.python-version == '3.9' && (github.event_name == 'push' && !startsWith(github.ref, 'refs/heads/dependabot/') || (github.event_name == 'pull_request' && !github.event.pull_request.head.repo.fork)) }}
+        if: ${{ inputs.os == 'ubuntu-latest' && matrix.python-version == '3.9' && (github.event_name == 'push' || (github.event_name == 'pull_request' && !github.event.pull_request.head.repo.fork)) }}
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true

.github/workflows/test-linux.yml

@@ -6,15 +6,8 @@ on:
     branches: [ develop ]
 
 jobs:
-  Coverage:
-    uses: ./.github/workflows/change-coverage.yml
-    with:
-      os: "ubuntu-latest"
-      workpath: "/home/runner/work/doorstop/doorstop"
-    if: github.event_name == 'pull_request'
-
   Test:
-    uses: ./.github/workflows/execute-tests.yml
+    uses: ./.github/workflows/_common.yml
     with:
       os: "ubuntu-latest"
       workpath: "/home/runner/work/doorstop/doorstop"

.github/workflows/test-osx.yml

@@ -7,9 +7,9 @@ on:
 
 jobs:
   Test:
-    uses: ./.github/workflows/execute-tests.yml
+    uses: ./.github/workflows/_common.yml
     with:
-      os: "macos-13"
+      os: "macos-14"
       workpath: "/Users/runner/work/doorstop/doorstop"
     secrets:
       CODECOV_TOKEN: ${{secrets.CODECOV_TOKEN}}

.github/workflows/test-windows.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   Test:
-    uses: ./.github/workflows/execute-tests.yml
+    uses: ./.github/workflows/_common.yml
     with:
       basepath: 'D:\'
       os: "windows-latest"

.readthedocs.yaml

@@ -3,7 +3,7 @@ version: 2
 build:
   os: "ubuntu-22.04"
   tools:
-    python: "3.9"
+    python: "3.10"
   jobs:
     post_create_environment:
       # Install poetry

.tool-versions

@@ -1,2 +1,2 @@
-python 3.13.3
-poetry 2.1.1
+python 3.14.2
+poetry 2.3.0

.verchew.ini

@@ -6,7 +6,7 @@ version = GNU Make
 [Python]
 
 cli = python
-version = 3.9 || 3.10 || 3.11 || 3.12 || 3.13
+version = 3
 
 [Poetry]
 
@@ -17,6 +17,6 @@ version = 2
 
 cli = dot
 cli_version_arg = -V
-version = 9 || 10 || 11 || 12
+version = 14
 optional = true
 message = This is only needed to generate UML diagrams for documentation.

.vscode/settings.json

@@ -71,10 +71,12 @@
     "pydocstyle",
     "pyficache",
     "pygments",
+    "pyinotify",
     "pyinstaller",
     "pylint",
     "pync",
     "pytest",
+    "pywin",
     "pyyaml",
     "quickstart",
     "sargs",

CHANGELOG.md

@@ -1,3 +1,7 @@
+# 3.1 (2026-01-31)
+
+- Dropped support for Python 3.9 and added support for Python 3.14.
+
 # 3.0.2 (2025-06-16)
 
 - Upgraded `bottle` to fix import errors.

Makefile

@@ -34,9 +34,15 @@ demo: install
 
 # SYSTEM DEPENDENCIES #########################################################
 
+.PHONY: bootstrap
+bootstrap: ## Attempt to install system dependencies
+	asdf plugin add python
+	asdf plugin add poetry
+	asdf install
+
 .PHONY: doctor
 doctor:  ## Confirm system dependencies are available
-	bin/verchew
+	bin/verchew --exit-code
 
 # PROJECT DEPENDENCIES ########################################################
 

README.md

@@ -31,7 +31,7 @@ Additional references:
 
 ## Requirements
 
-- Python 3.9+
+- Python 3.10+
 - A version control system for requirements storage
 
 ## Installation

docs/examples.md

@@ -8,6 +8,8 @@ Running `doorstop` in Docker: [tlwt/doorstop-docker](https://github.com/tlwt/doo
 
 - **[ros-safety/requirements-playground](https://github.com/ros-safety/requirements-playground)**: This is a small repo for demonstrating how Doorstop can be used to manage requirements in a C++ project.
 - **[urbasus/literate-programming-in-doorstop](https://github.com/urbasus/literate-programming-in-doorstop)**: Proof-of-concept for combining Doorstop and Literate Programming.
+- **[sarnold/doorstop-to-mermaid](https://github.com/sarnold/doorstop-to-mermaid)**: Proof-of-concept for generating Doorstop diagrams in Mermaid.
+- **[sarnold/pyserv](https://github.com/sarnold/pyserv)**: Python project using Doorstop and Mermaid with Sphinx to smush Markdown and reStructuredText.
 
 # 3rd-Party Clients
 

doorstop/core/builder.py

@@ -39,7 +39,7 @@ def build(cwd=None, root=None, request_next_number=None) -> Tree:
     skip_file_name = ".doorstop.skip-all"
     if not os.path.isfile(os.path.join(root, skip_file_name)):
         _document_from_path(root, root, documents)
-    exclude_dirnames = {".git", ".venv", "venv"}
+    exclude_dirnames = {".git", ".tox", ".venv", "venv"}
     if not os.path.isfile(os.path.join(root, skip_file_name)):
         for dirpath, dirnames, _ in os.walk(root, topdown=True):
             whilelist_dirnames = []