skillfed

vedro

Pragmatic Testing Framework

vedro v1.15.1 85.2K downloads/30d#13,944 on PyPI45
Permissive license Apache-2.0 Active released

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 on this page — 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

vedro on PyPI

pip

pip install vedro

uv

uv add vedro

poetry

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 the current Python release (>=3.8)
Install friction low — pure-Python wheel
Runtime dependencies 5 — cabina, filelock, niltype, pyparsing, rich
Maintenance actively maintained — 314 days since the last release
Last repo commit
First released
Downloads 85,201/month — #13,944 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: vedro-1.15.1-py3-none-any.whl

Intended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Topic :: Software DevelopmentTyping :: Typed

Tags

python testing frameworkscenario-based testingbdd testing pythonreadable test syntaxpluggable test frameworkpragmatic testing tooltest automation framework
testing-frameworkscenario-drivenbdd

More Software Development packages