Add Python 3.14 support (#508)

nfelt14 · web-flow · commit 5bab6a697044 · 2026-01-30T13:36:04.000-08:00
* feat: add support for Python 3.14 in workflows and dependencies

* test: add pragma directive to exclude specific code from coverage in functions.py

* fix: update docformatter language version to python3.13 with a TODO for future removal

* chore: remove outdated Python dependencies for version compatibility

* chore(python-deps): export new requirements

* chore(python-deps): update libusb-package version constraints for Python 3.14 compatibility

* chore(pre-commit): comment out docformatter hook pending issue resolution
diff --git a/.github/workflows/package-build.yml b/.github/workflows/package-build.yml
@@ -15,7 +15,7 @@ jobs:
     uses: tektronix/python-package-ci-cd/.github/workflows/_reusable-package-build.yml@v1.8.5
     with:
       package-name: tm_devices
-      python-versions-array: '["3.10", "3.11", "3.12", "3.13"]'  # when updating this, make sure to update all workflows that use this strategy  # PYTHON VERSION MARKER
+      python-versions-array: '["3.10", "3.11", "3.12", "3.13", "3.14"]'  # when updating this, make sure to update all workflows that use this strategy  # PYTHON VERSION MARKER
       operating-systems-array: '["ubuntu", "windows", "macos"]'
     permissions:
       contents: read
diff --git a/.github/workflows/package-release.yml b/.github/workflows/package-release.yml
@@ -24,7 +24,7 @@ jobs:
       commit-user-email: ${{ vars.TEK_OPENSOURCE_EMAIL }}
       release-level: ${{ inputs.release-level }}
       build-and-publish-python-package: true
-      python-versions-array: '["3.10", "3.11", "3.12", "3.13"]'  # when updating this, make sure to update all workflows that use this strategy  # PYTHON VERSION MARKER
+      python-versions-array: '["3.10", "3.11", "3.12", "3.13", "3.14"]'  # when updating this, make sure to update all workflows that use this strategy  # PYTHON VERSION MARKER
       operating-systems-array: '["ubuntu", "windows", "macos"]'
       previous-changelog-filepath: python_semantic_release_templates/.previous_changelog_for_template.md
       previous-release-notes-filepath: python_semantic_release_templates/.previous_release_notes_for_template.md
diff --git a/.github/workflows/test-code.yml b/.github/workflows/test-code.yml
@@ -14,7 +14,7 @@ jobs:
     with:
       repo-name: tektronix/tm_devices
       operating-systems-array: '["ubuntu", "windows", "macos"]'
-      python-versions-array: '["3.10", "3.11", "3.12", "3.13"]'  # when updating this, make sure to update all workflows that use this strategy  # PYTHON VERSION MARKER
+      python-versions-array: '["3.10", "3.11", "3.12", "3.13", "3.14"]'  # when updating this, make sure to update all workflows that use this strategy  # PYTHON VERSION MARKER
       upload-to-codecov: true
       enable-retry-os-array: '["macos"]'
     secrets:
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -156,8 +156,9 @@ repos:
       - id: ruff-check
         args: [--fix, --exit-non-zero-on-fix]
       - id: ruff-format
-  - repo: https://github.com/PyCQA/docformatter
-    rev: e73b8ba0c1316be565983236c72e653ad44e6b66  # frozen: v1.7.7
-    hooks:
-      - id: docformatter
-        additional_dependencies: [tomli]
+# TODO: uncomment when https://github.com/PyCQA/docformatter/issues/327 is resolved
+#  - repo: https://github.com/PyCQA/docformatter
+#    rev: e73b8ba0c1316be565983236c72e653ad44e6b66  # frozen: v1.7.7
+#    hooks:
+#      - id: docformatter
+#        additional_dependencies: [tomli]
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -21,6 +21,7 @@ Things to be included in the next release go here.
 ### Added
 
 - Enable programmatic connection to devices that use a different LAN device endpoint via the `DeviceManager`.
+- Added support for Python 3.14.
 
 ### Changed
 
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -1,58 +1,58 @@
-beautifulsoup4==4.14.3 ; python_version >= "3.10" and python_version < "3.14"
-black==26.1.0 ; python_version >= "3.10" and python_version < "3.14"
-bracex==2.6 ; python_version >= "3.10" and python_version < "3.14"
-certifi==2026.1.4 ; python_version >= "3.10" and python_version < "3.14"
-charset-normalizer==3.4.4 ; python_version >= "3.10" and python_version < "3.14"
-click==8.3.1 ; python_version >= "3.10" and python_version < "3.14"
-codespell==2.4.1 ; python_version >= "3.10" and python_version < "3.14"
-colorama==0.4.6 ; python_version >= "3.10" and python_version < "3.14"
-editdistpy==0.1.6 ; python_version >= "3.10" and python_version < "3.14"
-editorconfig==0.17.1 ; python_version >= "3.10" and python_version < "3.14"
-ghp-import==2.1.0 ; python_version >= "3.10" and python_version < "3.14"
-griffe==1.15.0 ; python_version >= "3.10" and python_version < "3.14"
-hjson==3.1.0 ; python_version >= "3.10" and python_version < "3.14"
-idna==3.11 ; python_version >= "3.10" and python_version < "3.14"
-inflect==7.5.0 ; python_version >= "3.10" and python_version < "3.14"
-jinja2==3.1.6 ; python_version >= "3.10" and python_version < "3.14"
-jsbeautifier==1.15.4 ; python_version >= "3.10" and python_version < "3.14"
-markdown==3.10.1 ; python_version >= "3.10" and python_version < "3.14"
-markupsafe==3.0.3 ; python_version >= "3.10" and python_version < "3.14"
-mergedeep==1.3.4 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs==1.6.1 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-autorefs==1.4.3 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-ezglossary-plugin==2.1.0 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-gen-files==0.6.0 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-get-deps==0.2.0 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-include-markdown-plugin==7.2.1 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-literate-nav==0.6.2 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-macros-plugin==1.5.0 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-mermaid2-plugin==1.2.3 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-section-index==0.3.10 ; python_version >= "3.10" and python_version < "3.14"
-mkdocs-spellcheck==1.2.0 ; python_version >= "3.10" and python_version < "3.14"
-mkdocstrings==0.30.1 ; python_version >= "3.10" and python_version < "3.14"
-mkdocstrings-python==1.19.0 ; python_version >= "3.10" and python_version < "3.14"
-more-itertools==10.8.0 ; python_version >= "3.10" and python_version < "3.14"
-mypy-extensions==1.1.0 ; python_version >= "3.10" and python_version < "3.14"
-nodeenv==1.10.0 ; python_version >= "3.10" and python_version < "3.14"
-packaging==26.0 ; python_version >= "3.10" and python_version < "3.14"
-pathspec==1.0.4 ; python_version >= "3.10" and python_version < "3.14"
-platformdirs==4.5.1 ; python_version >= "3.10" and python_version < "3.14"
-pygments==2.19.2 ; python_version >= "3.10" and python_version < "3.14"
-pymdown-extensions==10.20.1 ; python_version >= "3.10" and python_version < "3.14"
-python-dateutil==2.9.0.post0 ; python_version >= "3.10" and python_version < "3.14"
-pytokens==0.4.0 ; python_version >= "3.10" and python_version < "3.14"
-pyyaml==6.0.3 ; python_version >= "3.10" and python_version < "3.14"
-pyyaml-env-tag==1.1 ; python_version >= "3.10" and python_version < "3.14"
-requests==2.32.5 ; python_version >= "3.10" and python_version < "3.14"
-setuptools==80.10.2 ; python_version >= "3.10" and python_version < "3.14"
-six==1.17.0 ; python_version >= "3.10" and python_version < "3.14"
-soupsieve==2.8.3 ; python_version >= "3.10" and python_version < "3.14"
-super-collections==0.6.2 ; python_version >= "3.10" and python_version < "3.14"
-symspellpy==6.9.0 ; python_version >= "3.10" and python_version < "3.14"
-termcolor==3.3.0 ; python_version >= "3.10" and python_version < "3.14"
-tomli==2.4.0 ; python_version >= "3.10" and python_version < "3.14"
-typeguard==4.4.4 ; python_version >= "3.10" and python_version < "3.14"
-typing-extensions==4.15.0 ; python_version >= "3.10" and python_version < "3.14"
-urllib3==2.6.3 ; python_version >= "3.10" and python_version < "3.14"
-watchdog==6.0.0 ; python_version >= "3.10" and python_version < "3.14"
-wcmatch==10.1 ; python_version >= "3.10" and python_version < "3.14"
+beautifulsoup4==4.14.3 ; python_version >= "3.10" and python_version < "3.15"
+black==26.1.0 ; python_version >= "3.10" and python_version < "3.15"
+bracex==2.6 ; python_version >= "3.10" and python_version < "3.15"
+certifi==2026.1.4 ; python_version >= "3.10" and python_version < "3.15"
+charset-normalizer==3.4.4 ; python_version >= "3.10" and python_version < "3.15"
+click==8.3.1 ; python_version >= "3.10" and python_version < "3.15"
+codespell==2.4.1 ; python_version >= "3.10" and python_version < "3.15"
+colorama==0.4.6 ; python_version >= "3.10" and python_version < "3.15"
+editdistpy==0.1.6 ; python_version >= "3.10" and python_version < "3.15"
+editorconfig==0.17.1 ; python_version >= "3.10" and python_version < "3.15"
+ghp-import==2.1.0 ; python_version >= "3.10" and python_version < "3.15"
+griffe==1.15.0 ; python_version >= "3.10" and python_version < "3.15"
+hjson==3.1.0 ; python_version >= "3.10" and python_version < "3.15"
+idna==3.11 ; python_version >= "3.10" and python_version < "3.15"
+inflect==7.5.0 ; python_version >= "3.10" and python_version < "3.15"
+jinja2==3.1.6 ; python_version >= "3.10" and python_version < "3.15"
+jsbeautifier==1.15.4 ; python_version >= "3.10" and python_version < "3.15"
+markdown==3.10.1 ; python_version >= "3.10" and python_version < "3.15"
+markupsafe==3.0.3 ; python_version >= "3.10" and python_version < "3.15"
+mergedeep==1.3.4 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs==1.6.1 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-autorefs==1.4.3 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-ezglossary-plugin==2.1.0 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-gen-files==0.6.0 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-get-deps==0.2.0 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-include-markdown-plugin==7.2.1 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-literate-nav==0.6.2 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-macros-plugin==1.5.0 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-mermaid2-plugin==1.2.3 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-section-index==0.3.10 ; python_version >= "3.10" and python_version < "3.15"
+mkdocs-spellcheck==1.2.0 ; python_version >= "3.10" and python_version < "3.15"
+mkdocstrings==0.30.1 ; python_version >= "3.10" and python_version < "3.15"
+mkdocstrings-python==1.19.0 ; python_version >= "3.10" and python_version < "3.15"
+more-itertools==10.8.0 ; python_version >= "3.10" and python_version < "3.15"
+mypy-extensions==1.1.0 ; python_version >= "3.10" and python_version < "3.15"
+nodeenv==1.10.0 ; python_version >= "3.10" and python_version < "3.15"
+packaging==26.0 ; python_version >= "3.10" and python_version < "3.15"
+pathspec==1.0.4 ; python_version >= "3.10" and python_version < "3.15"
+platformdirs==4.5.1 ; python_version >= "3.10" and python_version < "3.15"
+pygments==2.19.2 ; python_version >= "3.10" and python_version < "3.15"
+pymdown-extensions==10.20.1 ; python_version >= "3.10" and python_version < "3.15"
+python-dateutil==2.9.0.post0 ; python_version >= "3.10" and python_version < "3.15"
+pytokens==0.4.1 ; python_version >= "3.10" and python_version < "3.15"
+pyyaml==6.0.3 ; python_version >= "3.10" and python_version < "3.15"
+pyyaml-env-tag==1.1 ; python_version >= "3.10" and python_version < "3.15"
+requests==2.32.5 ; python_version >= "3.10" and python_version < "3.15"
+setuptools==80.10.2 ; python_version >= "3.10" and python_version < "3.15"
+six==1.17.0 ; python_version >= "3.10" and python_version < "3.15"
+soupsieve==2.8.3 ; python_version >= "3.10" and python_version < "3.15"
+super-collections==0.6.2 ; python_version >= "3.10" and python_version < "3.15"
+symspellpy==6.9.0 ; python_version >= "3.10" and python_version < "3.15"
+termcolor==3.3.0 ; python_version >= "3.10" and python_version < "3.15"
+tomli==2.4.0 ; python_version >= "3.10" and python_version < "3.15"
+typeguard==4.4.4 ; python_version >= "3.10" and python_version < "3.15"
+typing-extensions==4.15.0 ; python_version >= "3.10" and python_version < "3.15"
+urllib3==2.6.3 ; python_version >= "3.10" and python_version < "3.15"
+watchdog==6.0.0 ; python_version >= "3.10" and python_version < "3.15"
+wcmatch==10.1 ; python_version >= "3.10" and python_version < "3.15"
diff --git a/pyproject.toml b/pyproject.toml
@@ -12,7 +12,7 @@ dependencies = [
   "dc-schema~=0.0.8",
   "gpib-ctypes~=0.3",
   "jsonschema[format-nongpl]~=4.23",
-  "libusb-package~=1.0,!=1.0.26.2",  # 1.0.26.2 doesn't work with Python 3.12
+  "libusb-package~=1.0,!=1.0.26.2,!=1.0.26.3",  # 1.0.26.2 doesn't work with Python 3.12; 1.0.26.3 doesn't work with Python 3.14
   "packaging>=24.0",
   "psutil>=6.0.0",
   "pyserial~=3.5",
@@ -48,7 +48,7 @@ maintainers = [
 ]
 name = "tm_devices"
 readme = "README.md"
-requires-python = ">=3.10,<3.14"  # PYTHON VERSION MARKER
+requires-python = ">=3.10,<3.15"  # PYTHON VERSION MARKER
 
 [project.scripts]
 list-visa-resources = "tm_devices:print_available_visa_devices"
@@ -422,10 +422,10 @@ legacy_tox_ini = """
 [tox]
 requires = tox>4
 isolated_build = True
-envlist = py310,py311,py312,py313,tests,docs,doctests  # PYTHON VERSION MARKER
+envlist = py310,py311,py312,py313,py314,tests,docs,doctests  # PYTHON VERSION MARKER
 skip_missing_interpreters = True
 labels =
-  basic = py310,py311,py312,py313,tests  # PYTHON VERSION MARKER
+  basic = py310,py311,py312,py313,py314,tests  # PYTHON VERSION MARKER
   documentation = docs,doctests
 
 [gh-actions]
@@ -434,6 +434,7 @@ python =  # PYTHON VERSION MARKER
     3.11: py311
     3.12: py312
     3.13: py313
+    3.14: py314
 
 [testenv]
 package = wheel
diff --git a/src/tm_devices/helpers/functions.py b/src/tm_devices/helpers/functions.py
@@ -617,7 +617,7 @@ def get_visa_backend(visa_lib_path: str) -> str:
             for (
                 visa_implementation_name,
                 visa_implementation_details,
-            ) in visa_implementation_dict.items():
+            ) in visa_implementation_dict.items():  # pragma: no cover
                 if visa_lib_path in visa_implementation_name:
                     vendor = visa_implementation_details["Vendor"]
                     visa_name = "NI-VISA" if "National Instruments" in vendor else f"{vendor} VISA"
diff --git a/tests/requirements.txt b/tests/requirements.txt
