Add ty

.devcontainer/devcontainer.json

@@ -12,6 +12,7 @@
     "customizations": {
         "vscode": {
             "extensions": [
+                "astral-sh.ty",
                 "charliermarsh.ruff",
                 "dorzey.vscode-sqlfluff",
                 "exiasr.hadolint",

.dockerignore

@@ -186,7 +186,7 @@ pytest-coverage.txt
 assets
 LICENSE
 noxfile.py
-pyrightconfig.json
 README.md
 ruff.toml
 tests
+ty.toml

.github/labeler.yml

@@ -1,6 +1,6 @@
 documentation:
   - changed-files:
-      - any-glob-to-any-file: "docs/**"
+      - any-glob-to-any-file: "**/*.md"
 
 feature:
   - head-branch: ["^feature/"]

.github/workflows/devcontainer.yml

@@ -1,16 +1,7 @@
 name: Devcontainer
 
 on:
-  push:
-    branches: [main]
-    paths:
-      - ".devcontainer/docker-compose.yml"
-      - ".devcontainer/Dockerfile"
-      - ".github/workflows/devcontainer.yml"
-      - ".python-version"
-
   pull_request:
-    branches: [main]
     paths:
       - ".devcontainer/docker-compose.yml"
       - ".devcontainer/Dockerfile"

.github/workflows/docker.yml

@@ -1,18 +1,7 @@
 name: Docker
 
 on:
-  push:
-    branches: [main]
-    paths:
-      - ".github/workflows/docker.yml"
-      - "**.py"
-      - ".dockerignore"
-      - ".python-version"
-      - "pyproject.toml"
-      - "uv.lock"
-
   pull_request:
-    branches: [main]
     paths:
       - ".github/workflows/docker.yml"
       - "**.py"

.github/workflows/format.yml

@@ -1,21 +1,7 @@
 name: Format
 
 on:
-  push:
-    branches: [main]
-    paths:
-      - ".github/actions/setup-python-with-uv/action.yml"
-      - ".github/workflows/format.yml"
-      - "**.py"
-      - "**.sql"
-      - ".python-version"
-      - ".sqlfluff"
-      - "pyproject.toml"
-      - "ruff.toml"
-      - "uv.lock"
-
   pull_request:
-    branches: [main]
     paths:
       - ".github/actions/setup-python-with-uv/action.yml"
       - ".github/workflows/format.yml"

.github/workflows/gh-deploy.yml

@@ -14,7 +14,6 @@ on:
       - "uv.lock"
 
   pull_request:
-    branches: [main]
     paths:
       - ".github/actions/setup-git-config/action.yml"
       - ".github/actions/setup-python-with-uv/action.yml"

.github/workflows/lint.yml

@@ -1,22 +1,7 @@
 name: Lint
 
 on:
-  push:
-    branches: [main]
-    paths:
-      - ".github/actions/setup-python-with-uv/action.yml"
-      - ".github/workflows/lint.yml"
-      - "**.py"
-      - "**.sql"
-      - ".python-version"
-      - ".sqlfluff"
-      - "pyproject.toml"
-      - "pyrightconfig.json"
-      - "ruff.toml"
-      - "uv.lock"
-
   pull_request:
-    branches: [main]
     paths:
       - ".github/actions/setup-python-with-uv/action.yml"
       - ".github/workflows/lint.yml"
@@ -25,12 +10,12 @@ on:
       - ".python-version"
       - ".sqlfluff"
       - "pyproject.toml"
-      - "pyrightconfig.json"
       - "ruff.toml"
+      - "ty.toml"
       - "uv.lock"
 
 jobs:
-  pyright:
+  ruff:
     runs-on: ubuntu-latest
 
     steps:
@@ -40,10 +25,10 @@ jobs:
       - name: Setup Python with uv
         uses: ./.github/actions/setup-python-with-uv
 
-      - name: Lint by Pyright
-        run: uv run nox -s lint -- --pyright
+      - name: Lint by Ruff
+        run: uv run nox -s lint -- --ruff
 
-  ruff:
+  sqlfluff:
     runs-on: ubuntu-latest
 
     steps:
@@ -53,10 +38,10 @@ jobs:
       - name: Setup Python with uv
         uses: ./.github/actions/setup-python-with-uv
 
-      - name: Lint by Ruff
-        run: uv run nox -s lint -- --ruff
+      - name: Lint by SQLFluff
+        run: uv run nox -s lint -- --sqlfluff
 
-  sqlfluff:
+  ty:
     runs-on: ubuntu-latest
 
     steps:
@@ -66,5 +51,5 @@ jobs:
       - name: Setup Python with uv
         uses: ./.github/actions/setup-python-with-uv
 
-      - name: Lint by SQLFluff
-        run: uv run nox -s lint -- --sqlfluff
+      - name: Lint by ty
+        run: uv run nox -s lint -- --ty

.github/workflows/test.yml

@@ -16,7 +16,6 @@ on:
       - "uv.lock"
 
   pull_request:
-    branches: [main]
     paths:
       - ".github/actions/setup-python-with-uv/action.yml"
       - ".github/workflows/test.yml"

.pre-commit-config.yaml

@@ -44,6 +44,14 @@ repos:
         name: Ruff format
         description: "Run 'ruff format' for extremely fast Python formatting"
 
+  - repo: local
+    hooks:
+      - id: ty
+        name: ty check
+        entry: uv run ty check
+        language: python
+        types: [python]
+
   - repo: https://github.com/hadolint/hadolint
     rev: v2.12.0
     hooks:

.vscode/cspell.json

@@ -30,6 +30,7 @@
         "dmypy",
         "dockerfiles",
         "donotpresent",
+        "dorzey",
         "exiasr",
         "fastapi",
         "fontawesome",
@@ -79,7 +80,6 @@
         "pypa",
         "pypackages",
         "pyproject",
-        "pyrightconfig",
         "pytest",
         "pythondontwritebytecode",
         "pythonpath",

.vscode/extensions.json

@@ -1,5 +1,6 @@
 {
     "recommendations": [
+        "astral-sh.ty",
         "charliermarsh.ruff",
         "codezombiech.gitignore",
         "dorzey.vscode-sqlfluff",
@@ -9,7 +10,6 @@
         "mosapride.zenkaku",
         "ms-azuretools.vscode-docker",
         "ms-python.python",
-        "ms-python.vscode-pylance",
         "ms-toolsai.jupyter",
         "ms-vscode-remote.remote-containers",
         "njpwerner.autodocstring",

.vscode/settings.json

@@ -7,6 +7,7 @@
     },
     "notebook.formatOnSave.enabled": true,
     "python.defaultInterpreterPath": "/home/vscode/.venv/bin/python",
+    "python.languageServer": "None",
     "python.testing.autoTestDiscoverOnSaveEnabled": false,
     "python.testing.pytestEnabled": true,
     "python.testing.pytestArgs": [

CLAUDE.md

@@ -51,31 +51,28 @@ uv run nox -s fmt -- --sqlfluff
 # Format both Python and SQL
 uv run nox -s fmt -- --ruff --sqlfluff
 
-# Lint with both Pyright and Ruff
-uv run nox -s lint -- --pyright --ruff
-
-# Lint with all tools (Pyright, Ruff, SQLFluff)
-uv run nox -s lint -- --pyright --ruff --sqlfluff
-
-# Lint with Pyright only
-uv run nox -s lint -- --pyright
+# Lint with all tools (Ruff, SQLFluff, ty)
+uv run nox -s lint -- --ruff --sqlfluff --ty
 
 # Lint with Ruff only
 uv run nox -s lint -- --ruff
 
 # Lint SQL files only
 uv run nox -s lint -- --sqlfluff
 
+# Lint with ty only
+uv run nox -s lint -- --ty
+
 # Run Ruff directly
 uv run ruff check . --fix
 uv run ruff format .
 
-# Run Pyright directly
-uv run pyright
-
 # Run SQLFluff directly
 uv run sqlfluff lint .
 uv run sqlfluff fix .
+
+# Run ty directly
+uv run ty check
 ```
 
 ### Pre-commit Hooks
@@ -170,10 +167,9 @@ Tests in `tests/tools/` mirror the package structure:
 - Target Python: 3.14
 - Per-file ignores for test files
 
-**Pyright (pyrightconfig.json)**:
-- Type checking mode: standard
-- Only includes `tools/` package (not tests)
-- venv: `.venv`
+**ty (ty.toml)**:
+- Includes `tools/`, `tests/` packages, and `noxfile.py`
+- Excludes cache directories (`__pycache__`, `.pytest_cache`, `.ruff_cache`, `.venv`)
 
 **pytest (pytest.ini)**:
 - Coverage: 75% minimum with branch coverage
@@ -199,8 +195,8 @@ Example of the argument parsing pattern:
 @nox.session(python=False)
 def lint(session: nox.Session) -> None:
     args = CLIArgs.parse(session.posargs)
-    if args.pyright:
-        session.run("uv", "run", "pyright")
+    if args.ty:
+        session.run("uv", "run", "ty", "check")
     if args.ruff:
         session.run("uv", "run", "ruff", "check", ".", "--fix")
     if args.sqlfluff:
@@ -247,7 +243,7 @@ When testing the utilities themselves:
 The `docs/` directory is organized for MkDocs:
 - **docs/index.md**: Main landing page
 - **docs/getting-started/**: Setup guides (Docker, VSCode, Dev Container)
-- **docs/guides/**: Tool usage guides (uv, Ruff, Pyright, pre-commit, tools package)
+- **docs/guides/**: Tool usage guides (uv, Ruff, ty, pre-commit, tools package)
 - **docs/configurations/**: Detailed configuration references
 - **docs/usecases/**: Real-world examples (Jupyter, FastAPI, OpenCV)
 
@@ -260,7 +256,7 @@ GitHub Actions workflows in `.github/workflows/`:
 - **devcontainer.yml**: Validate Dev Container configuration
 - **format.yml**: Check Ruff formatting
 - **labeler.yml**: Add label in GitHub
-- **lint.yml**: Run Pyright + Ruff linting
+- **lint.yml**: Run Ruff + ty linting
 - **test.yml**: Run pytest with coverage
 - **gh-deploy.yml**: Deploy documentation to GitHub Pages
 
@@ -285,7 +281,7 @@ Critical environment variables (set in `.env.local`):
 - **Ruff replaces multiple tools**: No need for Black, isort, Flake8, etc.
 - **nox is the task runner**: Prefer `uv run nox -s <session>` over direct tool calls
 - **Test naming**: Use `test__*.py` pattern (double underscore)
-- **Type checking targets tools/ only**: Pyright only checks the `tools/` package, not tests
+- **Type checking**: ty checks both the `tools/` and `tests/` packages
 
 ## Template Usage Pattern
 

CONTRIBUTING.md

@@ -27,7 +27,7 @@ Thank you for your interest in contributing to python-uv! This document provides
 
 ### Prerequisites
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - [uv](https://github.com/astral-sh/uv) package manager
 - Git
 - (Optional) Docker and VSCode with Dev Containers extension
@@ -71,7 +71,7 @@ uv run pre-commit install
 uv run nox -s test
 
 # Run linters
-uv run nox -s lint -- --pyright --ruff
+uv run nox -s lint -- --ruff --ty
 
 # Format code
 uv run nox -s fmt
@@ -132,7 +132,7 @@ git commit -m "changes"
 uv run nox -s fmt
 
 # 2. Run linters
-uv run nox -s lint -- --pyright --ruff
+uv run nox -s lint -- --ruff --ty
 
 # 3. Run tests with coverage
 uv run nox -s test
@@ -182,7 +182,7 @@ All checks must pass. PRs with failing checks will not be reviewed.
 ### General Guidelines
 
 - **Line length**: Maximum 88 characters (Black-compatible)
-- **Python version**: Target Python 3.10+ (or a specific stable version)
+- **Python version**: Target Python 3.11+ (or a specific stable version)
 - **Import order**: Automatically handled by Ruff
 - **Naming conventions**:
   - Classes: `PascalCase`
@@ -360,7 +360,7 @@ uv run ruff check . --fix
 uv run ruff format .
 
 # Check type errors
-uv run pyright
+uv run ty check
 
 # If type errors persist, add type hints or use type: ignore with justification
 ```
@@ -458,9 +458,9 @@ uv sync
 
 Before submitting your PR, verify:
 
-- [ ] Code follows project standards (Ruff, Pyright, type hints, docstring)
+- [ ] Code follows project standards (Ruff, ty, type hints, docstring)
 - [ ] All tests pass: `uv run nox -s test` (coverage ≥ 75%)
-- [ ] Linting passes: `uv run nox -s lint -- --pyright --ruff`
+- [ ] Linting passes: `uv run nox -s lint -- --ruff --ty`
 - [ ] Code is formatted: `uv run nox -s fmt`
 - [ ] Pre-commit hooks pass: `uv run pre-commit run --all-files`
 - [ ] Documentation updated (README, CLAUDE.md, or docs/)