---
id: pytest-tinybird
version: "0.5.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# pytest-tinybird — A pytest plugin to report test results to tinybird

License: permissive · Maintenance: aging · Downloads: 111.7K/mo

## What it is and what it does

pytest-tinybird is a pytest plugin that integrates test execution with Tinybird, a data analytics platform. After each test run, it sends structured test results—including test name, outcome, duration, and CI metadata—to Tinybird via the Events API. The plugin automatically creates a data source on first use and populates it with report objects containing commit, branch, job ID, and test execution details.

The plugin is designed for CI/CD pipelines and supports environment variables from GitLab, GitHub Actions, and other CI systems. It requires a Tinybird account and a token with append permissions, and configuration is done entirely through environment variables and a pytest command-line flag. The plugin depends on pytest and requests, making it lightweight to install.

Use it for:

- Track test execution metrics and trends over time in a Tinybird data warehouse for analytics and reporting.
- Correlate test outcomes with git commits and branches to identify which changes introduce test failures.
- Monitor CI job performance and test duration trends across different branches and workflows.
- Build dashboards and alerts on top of test data to surface flaky tests or performance regressions.
- Aggregate test results from multiple CI systems and repositories into a centralized Tinybird data source.

## Worth the install?

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

A pytest plugin that automatically posts test results to Tinybird's Events API at the end of each test run, capturing test outcomes, durations, and CI metadata.

Yes, if you use Tinybird and want to stream test results into it for analytics. The plugin is straightforward to set up and has low install friction. However, maintenance is aging (last release 464 days ago), so verify compatibility with your current pytest version before adopting. No known security vulnerabilities.

## Install

pip install pytest-tinybird
uv add pytest-tinybird
poetry add pytest-tinybird

## Installing pytest-tinybird

Before you install: Low install friction with a pure-Python wheel. Maintenance is aging—last release was 464 days ago, though the repository remains active with a recent commit in June 2025. Depends on pytest and requests, both stable and widely available.

License in practice: MIT license is permissive, allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install pytest-tinybird

export TINYBIRD_URL=https://api.tinybird.co
export TINYBIRD_DATASOURCE=my_datasource
export TINYBIRD_TOKEN=<token_with_append_permissions>

pytest tests --report-to-tinybird

Requires a Tinybird account, a token with append permissions, and environment variables (TINYBIRD_URL, TINYBIRD_DATASOURCE, TINYBIRD_TOKEN) to be set before running pytest.

Verify before relying:

- Whether pytest 3.8 or newer requirement is still accurate given classifiers list Python 3.8–3.11 support
- Current compatibility with modern pytest versions beyond what the description states
- Whether the plugin works with pytest-xdist or other parallel test runners

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 111.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest plugin tinybird reporting, test results analytics tinybird, ci test data collection, pytest event streaming, test metrics to tinybird, ci-cd-integration, test-analytics, data-pipeline

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