Slice your Gherkin .feature files into one file per Scenario – perfect for parallel execution, test distribution, and fine-grained test control.
✨ Handles Backgrounds, Scenario Outlines, custom tagging, wild-card exclusions, dry-run previews, and summary reporting out of the box.
- 📂 Recursively scan folders for
*.featurefiles - 🔄 Expand Scenario Outlines into individual Scenarios
- 🏷️ Preserve Feature & Scenario-level tags
- 📝 Preserve Feature descriptions and Background steps
- ➕ Inject a custom CLI tag into every generated Scenario
- 🪓 Generate unique
Feature: OriginalName – ScenarioNameheaders - 🚫 Skip files with
--exclude "<pattern>"(wildcards supported) - 🚫 Skip scenarios with
--exclude-tag <tag> - 📋 Supports
.featureignorefile for bulk exclusions - 🧪 Dry-run mode (
--dry-run) to preview changes - 📊 Summary reporting (files processed & scenarios generated)
- ⚡ Optional grouping by tag to balance scenarios for parallel execution
- 📦 Distributed as a cross-platform
dotnet tool
- .NET 8.0 SDK+
- Windows / macOS / Linux (cross-platform)
- Gherkin parser v32.0.0+
- McMaster.Extensions.CommandLineUtils v4.1.1+
- Valid UTF-8 encoded
.featurefiles
If using a .featureignore file, place it in the same root folder passed to --input.
dotnet run --project . --% slice
--input <gherkin folder>
--output <destination folder>
--tag <custom tag>
--exclude <file pattern>
--exclude-tag <tag to skip>
--groups <number of groups>dotnet run --project . slice
--input <gherkin folder>
--output <destination folder>
--tag <custom tag>
--exclude <file pattern>
--exclude-tag <tag to skip>
--groups <number of groups>dotnet pack -c Release -o ./nupkg
dotnet tool install --global --add-source ./nupkg scenarioslicer --version 1.0.0
scenarioslicer slice
--input <gherkin folder>
--output <destination folder>
--tag <custom tag>
--exclude <file pattern>
--exclude-tag <tag to skip>
--groups <number of groups>MIT © 2025 Bruno Maio