Skip to content
ApprovalTest verification library for .Net
C# Other
  1. C# 99.9%
  2. Other 0.1%
Branch: master
Clone or download
Latest commit ee38ebb Feb 15, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Nov 14, 2019
docs d Update docs Feb 15, 2020
src d Created core concepts picture Feb 15, 2020
.gitattributes pdf should be binary Aug 2, 2019
.gitignore exclude sample_temp.pdf Aug 14, 2019
LICENSE.md Starting Documentation Jan 24, 2013
TODO.md d todo Jan 31, 2020
readme.md d links Jan 31, 2020
readme.source.md d links Jan 31, 2020

readme.md

ApprovalTests

Build status License NuGet Status Backers on Open Collective Sponsors on Open Collective

Capturing Human Intelligence - ApprovalTests is an open source assertion/verification library to aid unit testing.

It is compatible with most .Net unit testing frameworks (Nunit, MsTest, xUnit, MBUnit)

Contents

What can it be used for?

Approval Tests can be used for verifying objects that require more than a simple assert. They also come prepackaged with utilities for some common .Net scenarios including:

Video Tutorials

You can watch a bunch of short videos on getting started and using ApprovalTests in .Net at YouTube

Podcasts

If you prefer auditory learning, you might enjoy the following podcast

Docs

Available on NuGet

Install-Package ApprovalTests

Examples

Verifing a List

[UseReporter(typeof(VisualStudioReporter))]
    [TestFixture]
    public class SampleTest
    {
        [Test]
        public void TestList()
        {
            var names = new[] { "Llewellyn", "James", "Dan", "Jason", "Katrina" };
            Array.Sort(names);
            Approvals.VerifyAll(names, label:"");
        }
    }

snippet source | anchor

Will Produce a File

`SampleTest.TestList.received.txt`

[0] = Dan
[1] = James
[2] = Jason
[3] = Katrina
[4] = Llewellyn

snippet source | anchor

It will also open these 2 files (.received. & .approved. ) in a diff editor.

You can approve these results by copying everything (ctrl+a, ctrl+c) and pasting it in the right hand side (ctrl+a, ctrl+v)

In most situations, you will use one of the supported DiffTools to examine and approve the result.

Alternatively, you can rename the .received. file to SampleTest.TestList.approved.txt and the test will now pass.

note: The diff tools are NOT opened when the tests pass, only on failure.

Approved File Artifacts

The *.approved.* files must be checked into source your source control. ApprovalTests now ignores line endings by default (so you can remove *.approved.* binary from your .gitattributes file if you added previously).

If you would like to verify line endings, simply add [assembly: IgnoreLineEndingsAttribute(false)] to your AssemblyInfo.cs

Do not add *.received.* files to your source control (they are transitory, and some SCMs like TFS will lock them or mark them read-only, which will break every dependent test).

More Info

Questions?

ask on twitter: @LlewellynFalco or #ApprovalTests

Credits

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

You can’t perform that action at this time.