pytest

The Python testing framework that makes writing small tests easy and scales to complex functional test suites.

Framework
PyPI
v9.2.0
14,670 stars
MIT License

Repository Health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum. How we score it →
96 /100 Excellent
Development Activity 100
Maintenance 96
Community 88
Maturity 60
Momentum 40

Technical Analysis

AI-assessed by reading the actual repository — architecture, code quality, innovation, and documentation. How we score it →
89 /100 Excellent
Architecture 90
Code Quality 92
Innovation 88
Learning Curve 85

pytest is the de facto standard testing framework for Python, built around plain assert statements, detailed assertion introspection, and automatic test discovery so developers never need to remember self.assert* method names. Its modular fixture system (dependency injection for setup/teardown, resource management, and parametrization) combined with a pluggy-based hook architecture has made it the foundation for a plugin ecosystem of over 1,300 third-party extensions covering everything from coverage reporting to async support.

Beyond unit tests, pytest can run existing unittest and trial suites without modification, making it a practical drop-in upgrade path for legacy codebases. It is maintained by the pytest-dev organization on GitHub with a large, active contributor base and is used across the Python ecosystem from small libraries to major frameworks and data-science stacks.

What You Get

  • Automatic test discovery across modules, classes, and functions using configurable naming conventions
  • A fixture system for dependency injection, resource setup/teardown, and test parametrization at function, class, module, or session scope
  • Assertion rewriting that gives detailed introspection on plain assert failures, no custom assertion API required
  • A pluggy-based hook architecture (hookspec.py) letting plugins add CLI options, collection behavior, and reporting
  • Built-in compatibility running existing unittest and trial test suites unmodified
  • A rich plugin ecosystem of 1,300+ third-party extensions (coverage, xdist parallelization, async, mocking, and more)

Common Use Cases

  • Unit and functional testing for Python libraries and applications, from small scripts to large monorepos
  • Migrating legacy unittest-based test suites incrementally without rewriting existing tests
  • Parametrized and property-style testing via fixtures combined with plugins like hypothesis
  • Parallel and distributed test execution in CI pipelines via the pytest-xdist plugin
  • Building custom testing tools and plugins on top of pytest’s hook and fixture APIs

Under The Hood

Architecture pytest’s execution flow starts in src/_pytest/config/__init__.py (2,333 lines), which parses CLI arguments and pytest.ini/pyproject.toml config, builds a Config object, and initializes the pluggy PluginManager. Collection and test running are driven from src/_pytest/main.py, which walks the filesystem to discover test modules/classes/functions, then hands each collected item to src/_pytest/runner.py for the setup/call/teardown protocol. The fixture system, implemented in src/_pytest/fixtures.py (2,598 lines), resolves fixture dependency graphs per test, honoring scope (function/class/module/session) and finalizers. Extensibility runs through src/_pytest/hookspec.py (1,298 lines), which declares the full set of hook specifications (pytest_collect_file, pytest_runtest_protocol, etc.) that both pytest’s own internal plugins (assertion rewriting, capture, logging, doctest, and 20+ others under src/_pytest/) and third-party plugins implement via the pluggy library. Tech Stack The project is pure Python (99.99% of the codebase per GitHub’s language breakdown), targeting Python 3.10+ and PyPy3, with a minimal runtime dependency set: pluggy (the hook/plugin engine), iniconfig and packaging for config parsing, pygments for terminal syntax highlighting, plus conditional colorama (Windows), exceptiongroup, and tomli backports for older Python versions. Packaging uses setuptools with setuptools-scm for git-tag-based versioning; dependency locking for development uses uv.lock. Code Quality The testing/ directory contains 155+ test files exercising pytest’s own internals (a large self-hosted test suite, since pytest tests itself using pytest), alongside changelog/ entries enforced per-PR via a towncrier-style process. The codebase is fully type-annotated (ships a py.typed marker for both the pytest and _pytest packages) and enforces style via pre-commit.ci. Its extremely long-lived, incremental development history (17,585+ commits since 2015, ~88 commits/month recently) with a stable core team suggests high day-to-day code review rigor. API Design pytest’s public API is intentionally minimal: pytest.fixture, pytest.mark, pytest.raises, and plain assert cover the overwhelming majority of test-writing needs, with almost zero required boilerplate to get a first test running (def test_x(): assert ... is a complete, valid test file). The fixture-injection model (declaring a fixture as a test function parameter) is widely regarded as one of the more ergonomic dependency-injection patterns in the Python ecosystem, and the CLI (pytest) auto-discovers tests with no configuration required for the common case.

Used by 100 apps in this directory

C
73%
AGPL 3.0

TDengine

Databases

25,187

A high-performance, open-source time-series database built in C for IoT, connected vehicles, and industrial monitoring workloads, with built-in stream processing, caching, and data subscription.

View details
98
Repo Health
71
Technical
65
Dependency
Built with
C 73%
C++ 20%
Updated 1 weeks ago
C++
75%
Apache 2.0

Timeplus Proton

Analytics · Data Engineering

2,281

Single C++ binary SQL engine for real-time stream processing, ETL, and analytics on Kafka, Redpanda, and ClickHouse with sub-millisecond latency.

View details
86
Repo Health
82
Technical
67
Dependency
Built with
C++ 75%
Python 11%
Updated 2 weeks ago
Python
73%
Apache 2.0

timesfm

AI Development · Analytics

35,277

A pretrained decoder-only foundation model by Google Research that delivers zero-shot time series forecasting with calibrated quantile prediction intervals — no training required.

View details
75
Repo Health
81
Technical
71
Dependency
Built with
Python 73%
HTML 14%
Jupyter Notebook 12%
Updated 1 months ago
Python
69%
AGPL 3.0

Tracecat

AI Agents · Automation · Security

3,894

Open-source agentic security automation platform that runs AI agents and durable workflows at scale with sandboxed execution.

View details
89
Repo Health
88
Technical
66
Dependency
Built with
Python 69%
TypeScript 30%
Updated 1 weeks ago
Rust
71%
MIT

Trieve

AI Development · Developer Tools · Search

2,723

All-in-one self-hostable platform for hybrid search, RAG, recommendations, and analytics built on Rust and Qdrant.

View details
42
Repo Health
74
Technical
65
Dependency
Built with
Rust 71%
Updated 9 months ago
TypeScript
90%
AGPL 3.0

useSend

Developer Tools · Marketing

4,783

Self-hostable open source email platform built on Amazon SES with a full dashboard, SMTP relay, REST API, and multi-language SDKs.

View details
82
Repo Health
72
Technical
68
Dependency
Built with
TypeScript 90%
Updated 1 weeks ago
Python
72%
Apache 2.0

Unsloth

AI Assistants · AI Development

79,133

Run and fine-tune LLMs, diffusion, audio and embedding models on your own hardware, from a native desktop app, a browser UI, or a Python library.

View details
89
Repo Health
83
Technical
70
Dependency
Built with
Python 72%
TypeScript 24%
Updated 1 weeks ago
Go
97%
BSD 3

Weaviate

Databases · Search

16,940

Open-source vector database combining semantic search, hybrid queries, RAG, and image search in a single cloud-native system built for production scale.

View details
91
Repo Health
85
Technical
68
Dependency
Built with
Go 97%
Updated 1 weeks ago
Rust
33%
Other

Windmill

Automation · Developer Tools

18,443

Turn scripts into webhooks, workflows, and auto-generated UIs — the fastest self-hostable workflow engine, 13x faster than Airflow.

View details
91
Repo Health
82
Technical
64
Dependency
Built with
Rust 33%
TypeScript 23%
Svelte 22%
Updated 1 weeks ago

Join founders buildingwith open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on Substack
Join 750+ subscribers