Overview
Last updated
Last updated
Shouldly is an assertion framework which focuses on giving great error messages when the assertion fails while being simple and terse.
This is the old Assert way:
For your troubles, you get this message, when it fails:
How it Should be:
Which is just syntax, so far, but check out the message when it fails:
It might be easy to underestimate how useful this is. Another example, side by side:
Shouldly uses the code before the ShouldBe statement to report on errors, which makes diagnosing easier.
Alternatively if you're using .NET Core then you can install Shouldly via the command line interface with the following command:
Shouldly uses the source code to make its error messages better. Hence, on the build server you will need to have the "full" pdb files available where the tests are being run.
What is meant by "full" is that when you set up your "release" configuration in Visual Studio and you go to Project Properties > Build > Advanced > Debug, you should set it to "full" rather than "pdb-only".
Dave Newman
Xerxes Battiwalla
Anthony Egerton
Peter van der Woude
Jake Ginnivan
Shouldly can be and can be installed by copying and pasting the following command into your .
Contributions to Shouldly are very welcome. For guidance, please see
If you are interested in helping out, jump on and have a chat.