Configuration

No config needed for built-in plugins

If you only use the built-in plugins (playwright-python, python-requests), no configuration file is needed. Vanya loads built-in plugins automatically.

vanya.config.toml

Create a vanya.config.toml file in your project root to configure custom plugins.

[project]
plugins = [
    "plugins/my-plugin.toml",
    "plugins/another-plugin.toml",
]

Schema

Field	Type	Description
project.plugins	string[]	List of paths to plugin TOML files (relative to config file)

Usage

Reference the config file with --config:

vanya check --config vanya.config.toml tests/*.vanya
vanya build --config vanya.config.toml tests/*.vanya -o out/

Alternative: —plugin-dir

For simpler setups, use --plugin-dir to load all plugins from a directory:

vanya check --plugin-dir ./plugins tests/*.vanya

All .toml files in the directory (except vanya.config.toml) will be loaded as plugins.

Example project structure

my-project/
├── vanya.config.toml
├── plugins/
│   ├── my-api.toml
│   └── my-browser.toml
└── tests/
    ├── login.vanya
    └── checkout.vanya

With vanya.config.toml:

[project]
plugins = [
    "plugins/my-api.toml",
    "plugins/my-browser.toml",
]