---
id: snob-lib
version: "0.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# snob-lib — A tool that only selects meaningful python tests to run.

License: permissive · Maintenance: active · Downloads: 94.3K/mo

## What it is and what it does

Snob is a test selection tool that analyzes your Python project's static import dependencies to determine which tests are affected by code changes. Rather than running your entire test suite on every change, it builds a dependency graph and outputs only the tests impacted by modified files, dramatically reducing feedback time during development.

The tool works as both a standalone CLI (piped with git diff and pytest) and as a pytest plugin. It's designed for local development workflows in large codebases where full regression testing would be prohibitively slow. Snob does not predict test failures—it selects tests based on static dependency analysis—and is explicitly not intended to replace CI or full test suite runs, but to accelerate the inner development loop by often skipping 99% of irrelevant tests.

Use it for:

- Speed up local development by running only tests affected by your current code changes instead of the full suite.
- Reduce CI feedback time by using Snob to filter test runs to changed modules in pull request pipelines.
- Identify test coverage gaps by visualizing the dependency graph between code and tests using Graphviz output.
- Exclude slow integration tests or external API tests from automatic runs while keeping them available for manual execution.
- Ensure critical tests always run by marking files like conftest.py or requirements.txt to trigger full test suite on change.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Snob analyzes your Python project's dependency graph to intelligently select which tests to run based on code changes, reducing test suite execution time by skipping unaffected tests.

Yes, if you work in a large Python codebase where full test suite runs are slow and you want faster local feedback during development. The tool is actively maintained, has no runtime dependencies, and carries permissive licensing. The caveat: wheel availability only for Python 3.10+ may limit adoption on older projects despite the >=3.8 requirement claim, and static analysis cannot catch dynamic imports or runtime side-effects, so it should complement rather than replace CI regression testing.

## Install

pip install snob-lib
uv add snob-lib
poetry add snob-lib

## Installing snob-lib

Before you install: Medium install friction due to compiled wheels across multiple platforms and Python versions (3.10, 3.11). Package is actively maintained with recent activity, though only a single release so far. No runtime dependencies simplifies deployment.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install snob-lib

# As CLI: list affected tests based on git changes
snob $(git diff --name-only) | xargs pytest

# Or as pytest plugin: test changes since a commit
pytest --commit-range main..HEAD

Requires Python >=3.8 and Git for change detection; pytest plugin mode requires pytest to be installed separately.

Verify before relying:

- Whether the package works with Python versions below 3.10 despite claiming >=3.8 support (wheels only provided for 3.10 and 3.11).
- Performance characteristics on codebases smaller than the 'million line' example mentioned in the description.
- Accuracy of test selection when projects use dynamic imports or runtime side-effects beyond static analysis.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 94.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

selective test runner, test impact analysis, dependency graph testing, skip irrelevant tests, pytest test selection, code change test mapping, intelligent test filtering, test-selection, rust-compiled, pytest-plugin

[View on SkillFed](https://skillfed.io/packages/snob-lib) · [View on PyPI](https://pypi.org/project/snob-lib/)