pre-commit: Add ty for Python type hints

Author: cclauss

.github/workflows/ruff.yml .github/workflows/ruff_and_ty.yml.github/workflows/ruff.yml renamed to .github/workflows/ruff_and_ty.yml

@@ -1,5 +1,5 @@
 # https://beta.ruff.rs
-name: ruff
+name: ruff_and_ty
 on:
   push:
     branches:
@@ -8,9 +8,11 @@ on:
     branches:
       - master
 jobs:
-  ruff:
+  ruff_and_ty:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
       - uses: astral-sh/setup-uv@v7
-      - run: uvx ruff check --output-format=github .
+      - run: uvx ruff check --output-format=github
+      - run: uv sync --group=test
+      - run: uv run --with=ty ty check --output-format=github

.pre-commit-config.yaml

@@ -2,7 +2,7 @@ ci:
   autoupdate_schedule: monthly
   # uv-lock resolves dependencies from PyPI, but pre-commit.ci runs hooks with no
   # network access, so it fails there. Skip it on pre-commit.ci; it still runs locally.
-  skip: [uv-lock]
+  skip: [ty, uv-lock]
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -28,16 +28,27 @@ repos:
         additional_dependencies:
           - tomli
 
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.29.3
+    hooks:
+      - id: pyproject-fmt
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.16.5
     hooks:
       - id: ruff-check
       - id: ruff-format
 
-  - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.28.1
+  - repo: https://github.com/astral-sh/ty-pre-commit
+    rev: v0.0.78
     hooks:
-      - id: pyproject-fmt
+      - id: ty
+        args: [--python, python3]
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.12.9
+    hooks:
+      - id: uv-lock
 
   - repo: local
     hooks:
@@ -47,26 +58,11 @@ repos:
         language: script
         pass_filenames: false
 
-  - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.12.7
-    hooks:
-      - id: uv-lock
-
   - repo: https://github.com/abravalheri/validate-pyproject
     rev: "0.26"
     hooks:
       - id: validate-pyproject
 
-  # - repo: https://github.com/pre-commit/mirrors-mypy
-  #  rev: v1.20.0
-  #  hooks:
-  #    - id: mypy
-  #      args:
-  #        - --explicit-package-bases
-  #        - --ignore-missing-imports
-  #        - --install-types
-  #        - --non-interactive
-
   - repo: https://github.com/pre-commit/mirrors-prettier
     rev: v4.0.0-alpha.8
     hooks:

CONTRIBUTING.md

@@ -77,7 +77,7 @@ pre-commit run --all-files --show-diff-on-failure
 
 We want your work to be readable by others; therefore, we encourage you to note the following:
 
-- Please write in Python 3.13+. For instance: `print()` is a function in Python 3 so `print "Hello"` will *not* work but `print("Hello")` will.
+- Please write in free-threaded Python 3.14t+. For instance: `print()` is a function in Python 3 so `print "Hello"` will *not* work but `print("Hello")` will.
 - Please focus hard on the naming of functions, classes, and variables.  Help your reader by using __descriptive names__ that can help you to remove redundant comments.
   - Single letter variable names are *old school* so please avoid them unless their life only spans a few lines.
   - Expand acronyms because `gcd()` is hard to understand but `greatest_common_divisor()` is not.

audio_filters/equal_loudness_filter.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from json import loads
 from pathlib import Path
 

audio_filters/iir_filter.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 
 class IIRFilter:
     r"""

audio_filters/show_response.py

@@ -4,8 +4,6 @@
 https://en.wikipedia.org/wiki/Frequency_response
 """
 
-from __future__ import annotations
-
 from abc import abstractmethod
 from math import pi
 from typing import Protocol

backtracking/all_combinations.py

@@ -5,8 +5,6 @@
 Time complexity: O(C(n,k)) which is O(n choose k) = O((n!/(k! * (n - k)!))),
 """
 
-from __future__ import annotations
-
 from itertools import combinations
 
 

backtracking/all_permutations.py

@@ -6,8 +6,6 @@
 where n denotes the length of the given sequence.
 """
 
-from __future__ import annotations
-
 
 def generate_all_permutations(sequence: list[int | str]) -> None:
     create_state_space_tree(sequence, [], 0, [0 for i in range(len(sequence))])

backtracking/all_subsequences.py

@@ -6,8 +6,6 @@
 where n denotes the length of the given sequence.
 """
 
-from __future__ import annotations
-
 from typing import Any
 
 

backtracking/knight_tour.py

@@ -1,7 +1,5 @@
 # Knight Tour Intro: https://www.youtube.com/watch?v=ab_dY3dZFHM
 
-from __future__ import annotations
-
 
 def get_valid_pos(position: tuple[int, int], n: int) -> list[tuple[int, int]]:
     """