---
id: vedro
version: "1.15.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# vedro — Pragmatic Testing Framework

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

## What it is and what it does

Vedro is a testing framework designed to make test code readable and maintainable through a scenario-style syntax. It targets developers who want clear, expressive test definitions without sacrificing flexibility. The framework depends on cabina, filelock, niltype, pyparsing, and rich to provide its core functionality, including file locking, parsing, and terminal output formatting.

The framework is built around the idea that tests should read like specifications. It supports modern Python versions and has been actively developed since 2020-07-25. With a permissive Apache-2.0 license and low installation friction, it's positioned as a pragmatic alternative for teams prioritizing test readability and customization.

Use it for:

- Writing acceptance tests in a scenario format that reads like business requirements
- Building test suites where readability and maintainability are priorities over feature density
- Extending test behavior through plugins and customization without forking the framework
- Teams seeking a lighter, more expressive testing syntax for Python projects

## Worth the install?

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

Vedro is a scenario-style testing framework for Python that emphasizes readability and developer experience, with a pluggable core for customization.

Yes, if you prioritize readable, scenario-style test code and want a lightweight framework with active maintenance. The low install friction, permissive license, and pluggable architecture make it a solid choice for projects where test clarity matters. No strong reason to install if you're already satisfied with an existing framework.

## Install

pip install vedro
uv add vedro
poetry add vedro

## Installing vedro

Before you install: Low install friction with a pure-Python wheel distribution. The project is actively maintained with a recent commit on 2026-07-24 and has been in development since 2020-07-25, indicating a stable codebase.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install vedro

from vedro import Scenario

class MyTest(Scenario):
    pass

Requires Python 3.8 or later (supports 3.9 through 3.13)

Verify before relying:

- Whether the pluggable core and customization capabilities are sufficient for complex testing workflows beyond standard scenarios
- Performance characteristics compared to other testing frameworks when running large test suites

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python testing framework, scenario-based testing, bdd testing python, readable test syntax, pluggable test framework, pragmatic testing tool, test automation framework, testing-framework, scenario-driven, bdd

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