testpick 0.2.0__tar.gz

testpick-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,85 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+    tags:
+      - 'v*'
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag to release (e.g., v0.3.0)'
+        required: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev,tree-sitter]"
+      - run: ruff check .
+      - run: mypy
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        include:
+          - os: windows-latest
+            python-version: "3.12"
+          - os: macos-latest
+            python-version: "3.12"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev,tree-sitter]"
+      - run: pytest tests/ --cov=testpick --cov-report=term-missing
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+
+      - name: Upload Build Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  release:
+    needs: [lint, test, build]
+    if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && github.event.inputs.tag)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Download Build Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.inputs.tag || github.ref_name }}
+          files: dist/*
+          generate_release_notes: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

testpick-0.2.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.eggs/
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test
+.pytest_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Local tool state
+.freebuff/
+
+# Misc
+*.log
+*.tgz

testpick-0.2.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## 0.2.0
+
+### Fixed
+
+- TypeScript and JavaScript imports now produce real graph edges. Previously only
+  Python files were ever linked, so chains came back empty on JS/TS projects.
+- Relative specifiers starting with `./` or `../` no longer resolve against the
+  filesystem root.
+- `--commit` analyzes the commit you pass; `--base <branch>` compares against the
+  branch point instead of the working tree.
+- The `tree-sitter` extra installs the grammars the parsers actually import, so AST
+  parsing activates instead of silently falling back to regex.
+- Dependency chains in terminal, JSON and GitHub output are real paths through the
+  graph rather than a copy of the changed-file list.
+- Renamed files no longer report a mangled `old<TAB>new` path, and deleted tests are
+  never selected.
+- JSON and GitHub Actions output use forward slashes, so paths work on Windows
+  runners.
+- Everything resolves from the repository root, so the command works from any
+  subdirectory.
+
+### Added
+
+- CI: ruff, mypy and pytest on Python 3.10-3.13 across Linux, macOS and Windows,
+  plus a package build check.
+- End-to-end tests for the selection pipeline (77 tests, 82% coverage).
+
+### Removed
+
+- Unused `--dry-run` option and the unwired `SymbolTracker`.

testpick-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 krauzX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

testpick-0.2.0/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.5
+Name: testpick
+Version: 0.2.0
+Summary: Pick the tests affected by your git diff before you run them
+Project-URL: Homepage, https://github.com/krauzX/testpick
+Project-URL: Repository, https://github.com/krauzX/testpick
+Project-URL: Issues, https://github.com/krauzX/testpick/issues
+License: MIT
+License-File: LICENSE
+Keywords: ci,git,pytest,static-analysis,testing
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: gitpython>=3.1
+Requires-Dist: readchar>=4.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: tree-sitter
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'tree-sitter'
+Requires-Dist: tree-sitter-python>=0.23; extra == 'tree-sitter'
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'tree-sitter'
+Requires-Dist: tree-sitter>=0.25; extra == 'tree-sitter'
+Description-Content-Type: text/markdown
+
+# testpick
+
+[![CI](https://github.com/krauzX/testpick/actions/workflows/ci.yml/badge.svg)](https://github.com/krauzX/testpick/actions/workflows/ci.yml)
+
+A Python CLI that looks at your git diff and tells you which tests are going to break. Before you run them.
+
+## Why this exists
+
+You change a function in `utils.py`. Now what? You could run the full test suite and wait, or you could guess
+which tests matter and hope you're right. `pytest --lf` reruns failures only after they've already failed.
+Jest's `--changedSince` follows direct file changes.
+
+testpick parses your git diff, builds an import graph of your source files, and walks it backwards from what
+you changed to find every test that depends on it — transitively. Each selected test comes with the chain that
+explains why, so you can sanity-check the answer instead of trusting it.
+
+## Getting started
+
+```bash
+git clone https://github.com/krauzX/testpick.git
+cd testpick
+pip install -e .
+
+# optional but recommended: real AST parsing instead of the regex fallback
+pip install -e ".[tree-sitter]"
+
+# for development (tests, linter, type checker)
+pip install -e ".[dev]"
+```
+
+Python 3.10+, runs on Linux, macOS and Windows.
+
+## Usage
+
+```bash
+# what changed since your last commit, including uncommitted work?
+testpick
+
+# committed changes on your branch since it diverged from main
+testpick --base main
+
+# a single commit
+testpick --commit abc123
+
+# output for scripts and CI
+testpick --format json
+testpick --format github      # GitHub Actions annotations
+
+# only analyze Python and TypeScript files
+testpick --languages python,typescript
+```
+
+Everything resolves from the repository root, so it works from any directory inside the repo.
+
+### Example output
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ testpick - Test Selection Results                                           │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+                     Changed Files
+┌────────────┬────────────────────────────────────────┐
+│ Status     │ File                                   │
+├────────────┼────────────────────────────────────────┤
+│ Modified   │ src/testpick/graph/builder.py          │
+│ Modified   │ src/testpick/reporter/github.py        │
+│ Modified   │ src/testpick/reporter/json_reporter.py │
+│ Added      │ tests/test_selection_pipeline.py       │
+└────────────┴────────────────────────────────────────┘
+
+                                Selected Tests
+┌───────┬──────────────────────────────────┬──────────────────────────────────┐
+│ #     │ Test File                        │ Dependency Path                  │
+├───────┼──────────────────────────────────┼──────────────────────────────────┤
+│ 1     │ tests/test_cli.py                │ tests/test_cli.py ->             │
+│       │                                  │ src/testpick/cli.py ->           │
+│       │                                  │ src/testpick/graph/__init__.py   │
+│       │                                  │ -> src/testpick/graph/builder.py │
+│ 2     │ tests/test_graph/test_builder.py │ tests/test_graph/test_builder.py │
+│       │                                  │ ->                               │
+│       │                                  │ src/testpick/graph/__init__.py   │
+│       │                                  │ -> src/testpick/graph/builder.py │
+│ 3     │ tests/test_selection_pipeline.py │ direct                           │
+│ 4     │ tests/test_selector/test_matche… │ tests/test_selector/test_matche… │
+│       │                                  │ ->                               │
+│       │                                  │ src/testpick/graph/__init__.py   │
+│       │                                  │ -> src/testpick/graph/builder.py │
+└───────┴──────────────────────────────────┴──────────────────────────────────┘
+
+       Statistics
+┌────────────────┬─────┐
+│ Files Changed  │ 4   │
+│ Tests Selected │ 4   │
+│ Insertions     │ 258 │
+│ Deletions      │ 25  │
+└────────────────┴─────┘
+```
+
+`direct` means the test file itself changed. The JSON format carries the same
+information, with chains as arrays:
+
+```json
+{
+  "changed_files": [
+    { "status": "M", "path": "src/utils.ts" }
+  ],
+  "test_files": [
+    {
+      "path": "tests/test_page.ts",
+      "dependency_chain": ["tests/test_page.ts", "src/page.ts", "src/utils.ts"]
+    }
+  ],
+  "stats": {
+    "files_changed": 1,
+    "insertions": 6,
+    "deletions": 2,
+    "tests_selected": 1
+  }
+}
+```
+
+## How it works
+
+1. Read the diff with `git diff --name-status` and resolve every path against the repository root.
+2. Parse each source file for imports. tree-sitter grammars are used when installed, otherwise a regex pass
+   handles Python, TypeScript and JavaScript.
+3. Resolve each import to a file: relative specifiers against the importing file's directory, absolute ones
+   against `src/`, the project root, then the file's own directory — preferring the importing file's language
+   when both a `.py` and a `.ts` file would match.
+4. Walk reverse edges from the changed files with a breadth-first search, recording the parent of every hit so
+   the chain can be explained afterwards.
+5. Report the files that are test files, direct changes first.
+
+## How it compares
+
+Other tools pick tests from a diff too; they differ in how far they can see:
+
+- **pytest-testmon** records which code each test actually executed, so it catches runtime coupling a static
+  graph misses — but it needs a baseline run and is pytest-only.
+- **Jest `--changedSince`** maps changed files to tests, but inside a Jest project and mostly direct
+  relationships.
+- **Nx and Turborepo affected tasks** pick packages to rebuild, which is coarser than picking individual tests.
+- **snob, pytest-impacted, pytest-git-selector** do static graph selection like this one, but for Python only.
+
+testpick's corner: one CLI covering Python and TypeScript/JavaScript, no baseline run required, and every
+selection arrives with the chain that produced it.
+
+## Limitations
+
+Static analysis only sees imports it can read:
+
+- Dynamic imports, dependency injection, plugin registries and other runtime wiring are invisible to it.
+- A file deleted from the working tree is gone from the parse tree, so testpick reports the deletion but
+  cannot trace what used to import it.
+- `--languages` scopes which files are analyzed for dependencies; changed files are always reported.
+
+Treat the output as a starting point. A full suite run still belongs in CI before a release.
+
+## Running tests
+
+```bash
+pytest tests/ -v
+pytest tests/ --cov=testpick
+```
+
+77 tests covering diff parsing, import resolution, graph building, the selection pipeline and all three
+reporters, with 82% branch coverage. CI runs ruff, mypy and the suite on Python 3.10-3.13 across Linux, macOS
+and Windows.
+
+## License
+
+MIT

testpick-0.2.0/README.md

@@ -0,0 +1,173 @@
+# testpick
+
+[![CI](https://github.com/krauzX/testpick/actions/workflows/ci.yml/badge.svg)](https://github.com/krauzX/testpick/actions/workflows/ci.yml)
+
+A Python CLI that looks at your git diff and tells you which tests are going to break. Before you run them.
+
+## Why this exists
+
+You change a function in `utils.py`. Now what? You could run the full test suite and wait, or you could guess
+which tests matter and hope you're right. `pytest --lf` reruns failures only after they've already failed.
+Jest's `--changedSince` follows direct file changes.
+
+testpick parses your git diff, builds an import graph of your source files, and walks it backwards from what
+you changed to find every test that depends on it — transitively. Each selected test comes with the chain that
+explains why, so you can sanity-check the answer instead of trusting it.
+
+## Getting started
+
+```bash
+git clone https://github.com/krauzX/testpick.git
+cd testpick
+pip install -e .
+
+# optional but recommended: real AST parsing instead of the regex fallback
+pip install -e ".[tree-sitter]"
+
+# for development (tests, linter, type checker)
+pip install -e ".[dev]"
+```
+
+Python 3.10+, runs on Linux, macOS and Windows.
+
+## Usage
+
+```bash
+# what changed since your last commit, including uncommitted work?
+testpick
+
+# committed changes on your branch since it diverged from main
+testpick --base main
+
+# a single commit
+testpick --commit abc123
+
+# output for scripts and CI
+testpick --format json
+testpick --format github      # GitHub Actions annotations
+
+# only analyze Python and TypeScript files
+testpick --languages python,typescript
+```
+
+Everything resolves from the repository root, so it works from any directory inside the repo.
+
+### Example output
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ testpick - Test Selection Results                                           │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+                     Changed Files
+┌────────────┬────────────────────────────────────────┐
+│ Status     │ File                                   │
+├────────────┼────────────────────────────────────────┤
+│ Modified   │ src/testpick/graph/builder.py          │
+│ Modified   │ src/testpick/reporter/github.py        │
+│ Modified   │ src/testpick/reporter/json_reporter.py │
+│ Added      │ tests/test_selection_pipeline.py       │
+└────────────┴────────────────────────────────────────┘
+
+                                Selected Tests
+┌───────┬──────────────────────────────────┬──────────────────────────────────┐
+│ #     │ Test File                        │ Dependency Path                  │
+├───────┼──────────────────────────────────┼──────────────────────────────────┤
+│ 1     │ tests/test_cli.py                │ tests/test_cli.py ->             │
+│       │                                  │ src/testpick/cli.py ->           │
+│       │                                  │ src/testpick/graph/__init__.py   │
+│       │                                  │ -> src/testpick/graph/builder.py │
+│ 2     │ tests/test_graph/test_builder.py │ tests/test_graph/test_builder.py │
+│       │                                  │ ->                               │
+│       │                                  │ src/testpick/graph/__init__.py   │
+│       │                                  │ -> src/testpick/graph/builder.py │
+│ 3     │ tests/test_selection_pipeline.py │ direct                           │
+│ 4     │ tests/test_selector/test_matche… │ tests/test_selector/test_matche… │
+│       │                                  │ ->                               │
+│       │                                  │ src/testpick/graph/__init__.py   │
+│       │                                  │ -> src/testpick/graph/builder.py │
+└───────┴──────────────────────────────────┴──────────────────────────────────┘
+
+       Statistics
+┌────────────────┬─────┐
+│ Files Changed  │ 4   │
+│ Tests Selected │ 4   │
+│ Insertions     │ 258 │
+│ Deletions      │ 25  │
+└────────────────┴─────┘
+```
+
+`direct` means the test file itself changed. The JSON format carries the same
+information, with chains as arrays:
+
+```json
+{
+  "changed_files": [
+    { "status": "M", "path": "src/utils.ts" }
+  ],
+  "test_files": [
+    {
+      "path": "tests/test_page.ts",
+      "dependency_chain": ["tests/test_page.ts", "src/page.ts", "src/utils.ts"]
+    }
+  ],
+  "stats": {
+    "files_changed": 1,
+    "insertions": 6,
+    "deletions": 2,
+    "tests_selected": 1
+  }
+}
+```
+
+## How it works
+
+1. Read the diff with `git diff --name-status` and resolve every path against the repository root.
+2. Parse each source file for imports. tree-sitter grammars are used when installed, otherwise a regex pass
+   handles Python, TypeScript and JavaScript.
+3. Resolve each import to a file: relative specifiers against the importing file's directory, absolute ones
+   against `src/`, the project root, then the file's own directory — preferring the importing file's language
+   when both a `.py` and a `.ts` file would match.
+4. Walk reverse edges from the changed files with a breadth-first search, recording the parent of every hit so
+   the chain can be explained afterwards.
+5. Report the files that are test files, direct changes first.
+
+## How it compares
+
+Other tools pick tests from a diff too; they differ in how far they can see:
+
+- **pytest-testmon** records which code each test actually executed, so it catches runtime coupling a static
+  graph misses — but it needs a baseline run and is pytest-only.
+- **Jest `--changedSince`** maps changed files to tests, but inside a Jest project and mostly direct
+  relationships.
+- **Nx and Turborepo affected tasks** pick packages to rebuild, which is coarser than picking individual tests.
+- **snob, pytest-impacted, pytest-git-selector** do static graph selection like this one, but for Python only.
+
+testpick's corner: one CLI covering Python and TypeScript/JavaScript, no baseline run required, and every
+selection arrives with the chain that produced it.
+
+## Limitations
+
+Static analysis only sees imports it can read:
+
+- Dynamic imports, dependency injection, plugin registries and other runtime wiring are invisible to it.
+- A file deleted from the working tree is gone from the parse tree, so testpick reports the deletion but
+  cannot trace what used to import it.
+- `--languages` scopes which files are analyzed for dependencies; changed files are always reported.
+
+Treat the output as a starting point. A full suite run still belongs in CI before a release.
+
+## Running tests
+
+```bash
+pytest tests/ -v
+pytest tests/ --cov=testpick
+```
+
+77 tests covering diff parsing, import resolution, graph building, the selection pipeline and all three
+reporters, with 82% branch coverage. CI runs ruff, mypy and the suite on Python 3.10-3.13 across Linux, macOS
+and Windows.
+
+## License
+
+MIT

testpick-0.2.0/pyproject.toml

@@ -0,0 +1,86 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "testpick"
+version = "0.2.0"
+description = "Pick the tests affected by your git diff before you run them"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+keywords = ["testing", "pytest", "git", "static-analysis", "ci"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+]
+dependencies = [
+    "click>=8.0",
+    "gitpython>=3.1",
+    "rich>=13.0",
+    "readchar>=4.0",
+]
+
+[project.optional-dependencies]
+tree-sitter = [
+    "tree-sitter>=0.25",
+    "tree-sitter-python>=0.23",
+    "tree-sitter-typescript>=0.23",
+    "tree-sitter-javascript>=0.23",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.5",
+    "mypy>=1.10",
+]
+
+[project.urls]
+Homepage = "https://github.com/krauzX/testpick"
+Repository = "https://github.com/krauzX/testpick"
+Issues = "https://github.com/krauzX/testpick/issues"
+
+[project.scripts]
+testpick = "testpick.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/testpick"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "B"]
+
+[tool.mypy]
+python_version = "3.10"
+files = ["src/testpick"]
+check_untyped_defs = true
+no_implicit_optional = true
+warn_unused_ignores = true
+
+# rich imports IPython, whose numpy stubs use syntax newer than our target
+[[tool.mypy.overrides]]
+module = ["IPython", "IPython.*", "numpy", "numpy.*"]
+follow_imports = "skip"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["testpick"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

testpick-0.2.0/src/testpick/__init__.py

@@ -0,0 +1,10 @@
+"""testpick - Select which tests to run based on code changes."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("testpick")
+except PackageNotFoundError:
+    __version__ = "0.0.0"
+
+__all__ = ["__version__"]

testpick-0.2.0/src/testpick/__main__.py

@@ -0,0 +1,3 @@
+from testpick.cli import main
+
+main()