fluent-asserts 0.5.3

Writing unit tests is easy with Dlang. The unittest block allows you to start writing tests and to be productive with no special setup.

Unfortunately the assert expresion does not help you to write expressive asserts, and in case of a failure it's hard to find why an assert failed. The fluent-asserts library allows you to more naturally specify the expected outcome of a TDD or BDD-style test.

To begin

1. Add the DUB dependency: https://code.dlang.org/packages/fluent-asserts
2. Import it:

import fluent.asserts;

1. Use it:

    unittest {
        true.should.equal(false);
    }

1. Run the tests:

➜  dub test --compiler=ldc2

API Docs

The library uses the should template in combination with Uniform Function Call Syntax (UFCS)

auto should(T)(lazy const T testData);

So the following statements are equivalent

exepectedValue.should.equal(42);
should(expectedValue).equal(42);

In addition, the library provides the not and because modifiers that allow to improve your asserts.

not negates the assert condition:

exepectedValue.should.not.equal(42);

because allows you to add a custom message:

    true.should.equal(false).because("of test reasons");
    ///will output this message: Because of test reasons, true should equal `false`.

You can use fluent asserts with:

• Basic Data Types
• Objects
• Strings
• Ranges and Arrays
• Exceptions
• Vibe.d Json
• Vibe.d requests

License

MIT. See LICENSE for details.