A story BDD tool for Elixir that parses Gherkin feature files and executes them as acceptance tests.
WhiteBread is a behavior-driven development (BDD) tool for Elixir that parses Gherkin-formatted feature files and executes them as acceptance tests. It serves as a collaboration tool to bridge communication between technical and non-technical stakeholders by treating BDD as a development tool rather than just a testing framework.
Elixir developers and teams practicing behavior-driven development who need a tool to write and execute acceptance tests using Gherkin syntax, particularly those integrating with ExUnit or Espec.
Developers choose WhiteBread for its seamless integration with Elixir's ecosystem, flexible suite configuration with async execution, and support for multiple output formats like HTML and JSON reports, distinguishing it as a comprehensive BDD tool beyond basic testing.
🍞 Story BDD tool for elixir using gherkin
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Parses standard Gherkin syntax feature files, enabling clear, human-readable scenarios that bridge communication between technical and non-technical stakeholders, as emphasized in the project philosophy.
Supports multiple test suites with different contexts, tags, and async execution, allowing organized test runs and performance optimization on multicore machines, as shown in the config.exs examples.
Generates console, HTML, and JSON reports via configurable outputers, facilitating detailed test analysis and sharing, with output configuration demonstrated in the README.
Allows step definitions to be imported from child contexts into parent contexts using subcontext composition, promoting code reuse and maintainability in complex test suites.
The project is actively looking for maintainers, risking stagnation and lack of updates, which could lead to compatibility issues with newer Elixir versions or dependencies.
Requires manual creation and management of config.exs and context files, adding overhead compared to simpler alternatives like Cabbage that generate ExUnit tests directly.
Only integrates with ExUnit and Espec out of the box, restricting use with other Elixir testing libraries and potentially forcing workarounds for custom frameworks.
By default, suites run sequentially even with async options per suite, which can limit performance gains in large test suites compared to fully parallelized tools.
white_bread is an open-source alternative to the following products: