Struct Feature 

pub struct Feature { /* private fields */ }

Declare what a file’s scenarios are for, ahead of the examples.

Scenarios say what the system does. A declaration says why the feature exists and who it serves, so a reader meets the intent before the examples.

Reach for declare_feature! rather than calling this directly: Rust has no portable way to run code before a test binary’s tests, so the macro wraps the declaration in a #[test] of its own.

use executable_stories::Feature;

Feature::new("Anyone can do arithmetic without a calculator app")
    .ability()
    .narrative("Switching apps for a quick sum loses your place.")
    .term("operand", "One of the two numbers an operation is applied to.")
    .declare(file!());

Implementations

impl Feature

pub fn new(title: &str) -> Self

Start a declaration with the heading readers will see.

pub fn ability(self) -> Self

Frame the feature as something a person can now do.

pub fn business_need(self) -> Self

Frame the feature as a cross-cutting concern nobody asks for by name, such as security or performance.

pub fn narrative(self, narrative: &str) -> Self

Explain, in markdown, why the feature exists and who it serves.

pub fn tags(self, tags: &[&str]) -> Self

Apply tags to every scenario in the file.

pub fn term(self, term: &str, definition: &str) -> Self

Define a term the scenarios use.

pub fn declare(self, source_file: &str)

Record the declaration against a source file. Pass file!().