Test Beautifier #

A very simple package that transforms your intricate test cases into a clean, readable format, making your test-driven development process more efficient and maintainable.

🚀 Getting started #

Install it as a dev dependency:

flutter pub add dev:test_beautifier

Import it in your test files:

import 'package:test_beautifier/test_beautifier.dart';

🕹 Usage #

To avoid long, misleading or unintelligible test descriptions, we use the Given-When-Then method:

• Given: The setup or context of the test case
• When: The action or procedure under test
• Then: The expected result or outcome of the test

Now test descriptions read like a book:

Test Requirement: When Counter is incremented, then value increases by 1.

We can improve the formatting further by wrapping the body in a procedure function:

Test Procedure:

1. initialize Counter with value 0
2. increment Counter
3. expect value to be 1.

In practice it looks like this:

test(
  requirement(
    When: 'Counter is incremented',
    Then: 'value increases by 1',
  ),
  procedure(() {
    final counter = Counter(0);

    counter.increment();

    expect(counter.value, 1);
  }),
);

The same applies for widget tests:

testWidgets(
  requirement(
    Given: 'Text is 0',
    When: 'Button is pressed',
    Then: 'Text is 1',
  ),
  widgetsProcedure((tester) {
    // whatever
  }),
);

This may seem trivial but can make a huge difference in long and complicated test files.