Ralf Ulrich commented on incident #10 at quality-tools / gherkin-behave-vsc

Ralf Ulrich
2026-04-15T08:09:46Z

And README suggetion:

# Gherkin Behave (Python BDD for VS Code)

Full **Python Behave (BDD)** support for Visual Studio Code.

✔ Step autocomplete
✔ Go to definition & references
✔ Missing step detection
✔ Test Explorer + debugging
✔ Parallel execution & stages

---

## 🚀 Features

### 🔍 Go to Step Definition

Jump instantly from a Gherkin step to its Python implementation.

➡️ Press **F12** on any step in a `.feature` file.

---

### 🔎 Find Step References

Find all usages of a step across your project.

➡️ Use **Alt+F12** or right-click → *Find Step References*

---

### ✨ Step Autocomplete

Get intelligent autocomplete suggestions while typing steps.

* Supports multiple step matchers
* Works across your workspace

---

### ⚠️ Missing Step Detection

Unimplemented steps are highlighted directly in your feature files.

* Quickly spot gaps in test coverage
* Improves development speed

---

### 🧪 Test Explorer Integration

Run and debug Behave tests directly inside VS Code.

* Run individual features or scenarios
* Debug with breakpoints
* Works with the Python extension

---

### 🧵 Parallel Execution

Run features in parallel for faster test execution.

> Requires isolated tests (no shared state)

---

### 🎭 Behave Stage Support

Switch between Behave stages easily.

* Auto-detects available stages
* Command: **Select Behave Stage**

---

### 📂 Multi-root Workspace Support

Works seamlessly across multiple workspace folders.

---

## ⚡ Quick Start

1. Install the extension
2. Open a `.feature` file
3. Press **F12** on a step → jump to implementation

---

## ⚙️ Configuration

### `gherkin-behave.featuresPath`

Path to your Behave `features` folder (default: `features`)

---

### `gherkin-behave.stage`

Active Behave stage (`--stage`)

---

### `gherkin-behave.runParallel`

Run features in parallel (faster execution)

---

### `gherkin-behave.justMyCode`

Debug only your code (disable to step into libraries)

---

### `gherkin-behave.stepMatcher`

Override step matcher (`parse`, `re`, `cfparse`, `cucumber_expression`)

---

## 💡 Why this extension?

Most Gherkin extensions only provide syntax highlighting.

**Gherkin Behave goes further:**

* Deep integration with Python Behave
* Navigation between feature files and step definitions
* Built-in debugging and test execution
* Support for real-world workflows (stages, parallel runs)

---

## 🧑‍💻 Who is this for?

* Python developers using **Behave**
* Teams working with **BDD / Gherkin**
* Projects with `.feature` files and step definitions

---

## 📦 Requirements

* Python extension for VS Code
* A project using **Behave**

---

## 🐞 Issues & Feedback

Found a bug or have a feature request?

👉 https://gitlab.com/quality-tools/gherkin-behave-vsc/-/issues

---

## 📄 License

MIT

---