一款简单易用的.Net 断言测试框架 ： Shouldly

GitHub地址：https://github.com/shouldly/shouldly

Shouldly的官方文档：http://docs.shouldly-lib.net/

Nuget安装：

 

在测试类中引用：

using Shouldly;

 

用法 ：

//验证
            UsingDbContext(context =>
            {
                var bill = context.Bills.FirstOrDefault();
                bill.ShouldNotBeNull();
            });

我们看一下，ShouldNotBeNull是如何定义的， 其实就是在在原类型的基础上加的扩展方法。

namespace Shouldly
{
    [DebuggerStepThrough]
    [ShouldlyMethods]
    public static class ShouldBeNullExtensions
    {
        public static void ShouldBeNull<T>(this T actual);
        public static void ShouldBeNull<T>(this T actual, string customMessage);
        public static void ShouldBeNull<T>(this T actual, [InstantHandle] Func<string> customMessage);
        [ContractAnnotation("actual:null => halt")]
        public static void ShouldNotBeNull<T>(this T actual);
        [ContractAnnotation("actual:null => halt")]
        public static void ShouldNotBeNull<T>(this T actual, string customMessage);
        [ContractAnnotation("actual:null => halt")]
        public static void ShouldNotBeNull<T>(this T actual, [InstantHandle] Func<string> customMessage);
    }
}

 

[DebuggerStepThrough]
    [ShouldlyMethods]
    public static class ShouldBeTestExtensions
    {
        public static void ShouldBe(this decimal actual, decimal expected, decimal tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this DateTime actual, DateTime expected, TimeSpan tolerance);
        public static void ShouldBe(this DateTime actual, DateTime expected, TimeSpan tolerance, string customMessage);
        public static void ShouldBe(this DateTime actual, DateTime expected, TimeSpan tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this DateTimeOffset actual, DateTimeOffset expected, TimeSpan tolerance);
        public static void ShouldBe(this DateTimeOffset actual, DateTimeOffset expected, TimeSpan tolerance, string customMessage);
        public static void ShouldBe(this DateTimeOffset actual, DateTimeOffset expected, TimeSpan tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this TimeSpan actual, TimeSpan expected, TimeSpan tolerance);
        public static void ShouldBe(this TimeSpan actual, TimeSpan expected, TimeSpan tolerance, string customMessage);
        public static void ShouldBe(this TimeSpan actual, TimeSpan expected, TimeSpan tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe<T>(this T actual, T expected);
        public static void ShouldBe<T>(this T actual, T expected, string customMessage);
        public static void ShouldBe<T>(this T actual, T expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe<T>(this IEnumerable<T> actual, IEnumerable<T> expected, bool ignoreOrder = false);
        public static void ShouldBe(this decimal actual, decimal expected, decimal tolerance, string customMessage);
        public static void ShouldBe<T>(this IEnumerable<T> actual, IEnumerable<T> expected, bool ignoreOrder, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe<T>(this IEnumerable<T> actual, IEnumerable<T> expected, bool ignoreOrder, string customMessage);
        public static void ShouldBe(this IEnumerable<decimal> actual, IEnumerable<decimal> expected, decimal tolerance, string customMessage);
        public static void ShouldBe(this decimal actual, decimal expected, decimal tolerance);
        public static void ShouldBe(this double actual, double expected, double tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this double actual, double expected, double tolerance, string customMessage);
        public static void ShouldBe(this double actual, double expected, double tolerance);
        public static void ShouldBe(this IEnumerable<decimal> actual, IEnumerable<decimal> expected, decimal tolerance);
        public static void ShouldBe(this IEnumerable<float> actual, IEnumerable<float> expected, double tolerance, string customMessage);
        public static void ShouldBe(this IEnumerable<float> actual, IEnumerable<float> expected, double tolerance);
        public static void ShouldBe(this IEnumerable<float> actual, IEnumerable<float> expected, double tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this IEnumerable<double> actual, IEnumerable<double> expected, double tolerance, string customMessage);
        public static void ShouldBe(this IEnumerable<double> actual, IEnumerable<double> expected, double tolerance);
        public static void ShouldBe(this float actual, float expected, double tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this float actual, float expected, double tolerance, string customMessage);
        public static void ShouldBe(this float actual, float expected, double tolerance);
        public static void ShouldBe(this IEnumerable<decimal> actual, IEnumerable<decimal> expected, decimal tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBe(this IEnumerable<double> actual, IEnumerable<double> expected, double tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeAssignableTo(this object actual, Type expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeAssignableTo(this object actual, Type expected, string customMessage);
        public static void ShouldBeAssignableTo(this object actual, Type expected);
        public static T ShouldBeAssignableTo<T>(this object actual, [InstantHandle] Func<string> customMessage);
        public static T ShouldBeAssignableTo<T>(this object actual);
        public static T ShouldBeAssignableTo<T>(this object actual, string customMessage);
        public static void ShouldBeGreaterThan<T>(this T actual, T expected) where T : IComparable<T>;
        public static void ShouldBeGreaterThan<T>(this T actual, T expected, IComparer<T> comparer);
        public static void ShouldBeGreaterThan<T>(this T actual, T expected, IComparer<T> comparer, string customMessage);
        public static void ShouldBeGreaterThan<T>(this T actual, T expected, IComparer<T> comparer, Func<string> customMessage);
        public static void ShouldBeGreaterThan<T>(this T actual, T expected, string customMessage) where T : IComparable<T>;
        public static void ShouldBeGreaterThan<T>(this T actual, T expected, [InstantHandle] Func<string> customMessage) where T : IComparable<T>;
        public static void ShouldBeGreaterThanOrEqualTo<T>(this T actual, T expected, [InstantHandle] Func<string> customMessage) where T : IComparable<T>;
        public static void ShouldBeGreaterThanOrEqualTo<T>(this T actual, T expected, IComparer<T> comparer, string customMessage);
        public static void ShouldBeGreaterThanOrEqualTo<T>(this T actual, T expected, IComparer<T> comparer);
        public static void ShouldBeGreaterThanOrEqualTo<T>(this T actual, T expected, string customMessage) where T : IComparable<T>;
        public static void ShouldBeGreaterThanOrEqualTo<T>(this T actual, T expected) where T : IComparable<T>;
        public static void ShouldBeGreaterThanOrEqualTo<T>(this T actual, T expected, IComparer<T> comparer, Func<string> customMessage);
        public static void ShouldBeInRange<T>(this T actual, T from, T to, [InstantHandle] Func<string> customMessage) where T : IComparable<T>;
        public static void ShouldBeInRange<T>(this T actual, T from, T to, string customMessage) where T : IComparable<T>;
        public static void ShouldBeInRange<T>(this T actual, T from, T to) where T : IComparable<T>;
        public static void ShouldBeLessThan<T>(this T actual, T expected, IComparer<T> comparer, Func<string> customMessage);
        public static void ShouldBeLessThan<T>(this T actual, T expected, IComparer<T> comparer, string customMessage);
        public static void ShouldBeLessThan<T>(this T actual, T expected, IComparer<T> comparer);
        public static void ShouldBeLessThan<T>(this T actual, T expected, string customMessage) where T : IComparable<T>;
        public static void ShouldBeLessThan<T>(this T actual, T expected) where T : IComparable<T>;
        public static void ShouldBeLessThan<T>(this T actual, T expected, [InstantHandle] Func<string> customMessage) where T : IComparable<T>;
        public static void ShouldBeLessThanOrEqualTo<T>(this T actual, T expected, [InstantHandle] Func<string> customMessage) where T : IComparable<T>;
        public static void ShouldBeLessThanOrEqualTo<T>(this T actual, T expected, IComparer<T> comparer, Func<string> customMessage);
        public static void ShouldBeLessThanOrEqualTo<T>(this T actual, T expected, IComparer<T> comparer);
        public static void ShouldBeLessThanOrEqualTo<T>(this T actual, T expected, string customMessage) where T : IComparable<T>;
        public static void ShouldBeLessThanOrEqualTo<T>(this T actual, T expected) where T : IComparable<T>;
        public static void ShouldBeLessThanOrEqualTo<T>(this T actual, T expected, IComparer<T> comparer, string customMessage);
        public static void ShouldBeNegative(this decimal actual);
        public static void ShouldBeNegative(this decimal actual, string customMessage);
        public static void ShouldBeNegative(this decimal actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeNegative(this double actual, string customMessage);
        public static void ShouldBeNegative(this double actual);
        public static void ShouldBeNegative(this double actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeNegative(this float actual);
        public static void ShouldBeNegative(this long actual, string customMessage);
        public static void ShouldBeNegative(this short actual, string customMessage);
        public static void ShouldBeNegative(this short actual);
        public static void ShouldBeNegative(this long actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeNegative(this long actual);
        public static void ShouldBeNegative(this int actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeNegative(this int actual, string customMessage);
        public static void ShouldBeNegative(this int actual);
        public static void ShouldBeNegative(this short actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeNegative(this float actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeNegative(this float actual, string customMessage);
        public static T ShouldBeOfType<T>(this object actual);
        public static T ShouldBeOfType<T>(this object actual, string customMessage);
        public static void ShouldBeOfType(this object actual, Type expected, string customMessage);
        public static void ShouldBeOfType(this object actual, Type expected, [InstantHandle] Func<string> customMessage);
        public static T ShouldBeOfType<T>(this object actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeOfType(this object actual, Type expected);
        public static void ShouldBeOneOf<T>(this T actual, T[] expected, string customMessage);
        public static void ShouldBeOneOf<T>(this T actual, params T[] expected);
        public static void ShouldBeOneOf<T>(this T actual, T[] expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this float actual, string customMessage);
        public static void ShouldBePositive(this decimal actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this short actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this short actual, string customMessage);
        public static void ShouldBePositive(this short actual);
        public static void ShouldBePositive(this decimal actual);
        public static void ShouldBePositive(this decimal actual, string customMessage);
        public static void ShouldBePositive(this float actual);
        public static void ShouldBePositive(this double actual);
        public static void ShouldBePositive(this double actual, string customMessage);
        public static void ShouldBePositive(this double actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this float actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this long actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this long actual, string customMessage);
        public static void ShouldBePositive(this long actual);
        public static void ShouldBePositive(this int actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldBePositive(this int actual, string customMessage);
        public static void ShouldBePositive(this int actual);
        public static void ShouldBeSameAs(this object actual, object expected, string customMessage);
        public static void ShouldBeSameAs(this object actual, object expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldBeSameAs(this object actual, object expected);
        [ContractAnnotation("actual:null,expected:null => halt")]
        public static void ShouldNotBe<T>(this T actual, T expected, [InstantHandle] Func<string> customMessage);
        [ContractAnnotation("actual:null,expected:null => halt")]
        public static void ShouldNotBe<T>(this T actual, T expected, string customMessage);
        [ContractAnnotation("actual:null,expected:null => halt")]
        public static void ShouldNotBe<T>(this T actual, T expected);
        public static void ShouldNotBe(this DateTimeOffset actual, DateTimeOffset expected, TimeSpan tolerance, string customMessage);
        public static void ShouldNotBe(this TimeSpan actual, TimeSpan expected, TimeSpan tolerance, string customMessage);
        public static void ShouldNotBe(this TimeSpan actual, TimeSpan expected, TimeSpan tolerance);
        public static void ShouldNotBe(this DateTimeOffset actual, DateTimeOffset expected, TimeSpan tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBe(this DateTimeOffset actual, DateTimeOffset expected, TimeSpan tolerance);
        public static void ShouldNotBe(this DateTime actual, DateTime expected, TimeSpan tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBe(this DateTime actual, DateTime expected, TimeSpan tolerance, string customMessage);
        public static void ShouldNotBe(this DateTime actual, DateTime expected, TimeSpan tolerance);
        public static void ShouldNotBe(this TimeSpan actual, TimeSpan expected, TimeSpan tolerance, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeAssignableTo(this object actual, Type expected);
        public static void ShouldNotBeAssignableTo<T>(this object actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeAssignableTo<T>(this object actual, string customMessage);
        public static void ShouldNotBeAssignableTo(this object actual, Type expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeAssignableTo(this object actual, Type expected, string customMessage);
        public static void ShouldNotBeAssignableTo<T>(this object actual);
        public static void ShouldNotBeInRange<T>(this T actual, T from, T to) where T : IComparable<T>;
        public static void ShouldNotBeInRange<T>(this T actual, T from, T to, [InstantHandle] Func<string> customMessage) where T : IComparable<T>;
        public static void ShouldNotBeInRange<T>(this T actual, T from, T to, string customMessage) where T : IComparable<T>;
        public static void ShouldNotBeOfType(this object actual, Type expected, string customMessage);
        public static void ShouldNotBeOfType<T>(this object actual, string customMessage);
        public static void ShouldNotBeOfType(this object actual, Type expected);
        public static void ShouldNotBeOfType(this object actual, Type expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeOfType<T>(this object actual);
        public static void ShouldNotBeOfType<T>(this object actual, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeOneOf<T>(this T actual, T[] expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeOneOf<T>(this T actual, T[] expected, string customMessage);
        public static void ShouldNotBeOneOf<T>(this T actual, params T[] expected);
        public static void ShouldNotBeSameAs(this object actual, object expected, [InstantHandle] Func<string> customMessage);
        public static void ShouldNotBeSameAs(this object actual, object expected, string customMessage);
        public static void ShouldNotBeSameAs(this object actual, object expected);
    }

 

当测试失败时，

 

异常测试：

                var bill = context.Bills.FirstOrDefault();
                Should.Throw<DivideByZeroException>(() =>
                {
                    bill.SetBmiNoPay();
                });

测试结果：