Refactor: Replace pyright with ty for static type checking

Author: palewire

.github/workflows/continuous-deployment.yaml

@@ -21,15 +21,15 @@ jobs:
         name: Check with Ruff
         uses: astral-sh/ruff-action@v3
         with:
-          args: 'check --exit-zero --verbose'
+          args: "check --exit-zero --verbose"
 
       - id: format-ruff
         name: Format with Ruff
         uses: astral-sh/ruff-action@v3
         with:
-          args: 'format --check --verbose'
+          args: "format --check --verbose"
 
-  pyright:
+  type-check:
     name: Verify static typing
     runs-on: ubuntu-latest
     steps:
@@ -40,18 +40,18 @@ jobs:
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: 'latest'
+          version: "latest"
           enable-cache: true
-          cache-dependency-glob: '**/pyproject.toml'
+          cache-dependency-glob: "**/pyproject.toml"
 
       - id: install-python-dependencies
         name: Install Python dependencies
         run: uv sync --extra dev
 
-      - id: pyright
-        name: Run pyright
+      - id: type-check
+        name: Run ty
         timeout-minutes: 10
-        run: uv run pyright
+        run: uv run ty check
 
   vulture:
     name: Detect dead code
@@ -64,9 +64,9 @@ jobs:
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: 'latest'
+          version: "latest"
           enable-cache: true
-          cache-dependency-glob: '**/pyproject.toml'
+          cache-dependency-glob: "**/pyproject.toml"
 
       - id: install-python-dependencies
         name: Install Python dependencies
@@ -86,7 +86,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python: ['3.11', '3.12', '3.13', '3.14']
+        python: ["3.11", "3.12", "3.13", "3.14"]
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -97,7 +97,7 @@ jobs:
         with:
           version: "latest"
           enable-cache: true
-          cache-dependency-glob: '**/pyproject.toml'
+          cache-dependency-glob: "**/pyproject.toml"
 
       - id: install-python
         name: Install Python
@@ -125,7 +125,7 @@ jobs:
         with:
           version: "latest"
           enable-cache: true
-          cache-dependency-glob: '**/pyproject.toml'
+          cache-dependency-glob: "**/pyproject.toml"
 
       - id: build
         name: Build releases

.pre-commit-config.yaml

@@ -20,7 +20,7 @@ repos:
       - id: check-ast
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.10
+    rev: v0.14.13
     hooks:
       - id: ruff
         args: [--fix]
@@ -59,10 +59,10 @@ repos:
 
   - repo: local
     hooks:
-      - id: pyright
-        name: pyright
-        entry: uv run pyright
+      - id: ty
+        name: ty
+        entry: uv run ty check
         language: system
         types: [python]
-        exclude: tests/.*
         pass_filenames: false
+        require_serial: true

Makefile

@@ -93,9 +93,9 @@ fix: ## Auto-fix linting issues
 	$(call banner,  🔧 Auto-fixing issues 🔧)
 	@uv run ruff check --fix
 
-type-check: ## Verify static typing with pyright
+type-check: ## Verify static typing with ty
 	$(call banner,  🔍 Verifying static typing 🔍)
-	uv run pyright
+	uv run ty check
 
 build: ## Build distribution packages
 	$(call banner,  📦 Building distribution packages 📦)

pyproject.toml

@@ -24,7 +24,7 @@ classifiers = [
 ]
 
 [project.optional-dependencies]
-dev = ["pre-commit", "setuptools-scm", "pyright", "vulture"]
+dev = ["pre-commit", "setuptools-scm", "ty", "vulture"]
 test = [
     "pytest",
     "pytest-cov",
@@ -141,36 +141,27 @@ filterwarnings = [
 relative_files = true
 omit = ["*/__pycache__/*"]
 
-[tool.pyright]
-pythonVersion = "3.13"
-venvPath = "."
-venv = ".venv"
-# include = ["your_package_name"]
-exclude = ["tests", "build", ".venv", "_notebooks", "**/__pycache__"]
-
-# Type checking mode - "off", "basic", "standard", or "strict"
-typeCheckingMode = "standard"
-
-# Disabled for pandas-stubs type inference issues (DataFrame/Series/ndarray ambiguity)
-reportMissingTypeStubs = false
-reportUnknownMemberType = false
-reportUnknownArgumentType = false
-reportUnknownVariableType = false
-reportUnknownParameterType = false
-reportAttributeAccessIssue = false # ndarray missing .iloc, .dt, .str, .groupby
-reportArgumentType = false         # DataFrame vs Series parameter mismatches
-reportReturnType = false           # DataFrame vs Series return mismatches
-reportCallIssue = false            # No overloads for rename, concat, sort_values
-reportAssignmentType = false       # DataFrame vs Series assignment mismatches
+[tool.ty.environment]
+python-version = "3.13"
 
-# High-value type safety checks (kept enabled)
-reportMissingImports = true
-reportGeneralTypeIssues = true
-reportPossiblyUnboundVariable = true
-reportIncompatibleMethodOverride = true
-reportOptionalMemberAccess = true
-reportOptionalCall = true
-reportUnhashable = true
+[tool.ty.src]
+# include = ["your_package_name"]
+exclude = [
+    "tests/**",
+    "build/**",
+    ".venv/**",
+    ".github/**",
+    ".vscode/**",
+    "**/__pycache__",
+]
 
-# Disabled because .configure() class factory pattern requires subclasses to narrow types
-reportIncompatibleVariableOverride = false
+[tool.ty.rules]
+invalid-argument-type = "warn"
+invalid-return-type = "warn"
+invalid-key = "warn"
+invalid-assignment = "warn"
+invalid-method-override = "warn"
+unresolved-attribute = "warn"
+possibly-missing-attribute = "warn"
+no-matching-overload = "ignore"
+unused-ignore-comment = "ignore"