/// <summary>
/// Asserts the specified test method throws an exception of the specified type.
/// </summary>
/// <typeparam name="TException">The <see cref="Type"/> of <see cref="ArgumentException"/> that should be thrown.</typeparam>
/// <param name="assert">The extended <see cref="Asserter"/>.</param>
/// <param name="testMethod">The <see cref="Action"/> representing the test method.</param>
/// <param name="message">A message to display if the assertion fails. This message can be seen in the unit test results.</param>
/// <param name="parameters">An array of parameters to use when formatting <paramref name="message" />.</param>
/// <returns>The <see cref="ExceptionAsserter{T}">asserted exception</see>.</returns>
/// <include file="examples.xml" path="Types/Type[@name='ExceptionExtensions']/Member[@name='Throws`1']/example[2]" />
public static ExceptionAsserter <TException> Throws <TException>(this Asserter assert, Action testMethod, string message, params object[] parameters) where TException : Exception
{
Arg.NotNull(assert, nameof(assert));
Contract.Ensures(Contract.Result <ExceptionAsserter <TException> >() != null);
assert.AssertParameterIsNotNull(testMethod, nameof(testMethod));
var exceptionType = typeof(TException);
try
{
testMethod();
}
catch (TException ex)
{
assert.AreEqual(exceptionType, ex.GetType(), WrongException, exceptionType, ex.GetType());
return(new ExceptionAsserter <TException>(ex));
}
catch (Exception ex)
{
assert.AreEqual(exceptionType, ex.GetType(), WrongException, exceptionType, ex.GetType());
}
assert.Fail(message, parameters);
return(null);
}
/// <summary>
/// Asserts that the specified object raises the <see cref="INotifyPropertyChanged.PropertyChanged"/> event for the specified property.
/// </summary>
/// <typeparam name="TObject">The <see cref="Type">type</see> of <see cref="INotifyPropertyChanged">object</see> to test.</typeparam>
/// <typeparam name="TValue">The <see cref="Type">type</see> of value to assign to the property.</typeparam>
/// <param name="assert">The extended <see cref="Asserter"/>.</param>
/// <param name="subject">The <see cref="INotifyPropertyChanged">object</see> to test.</param>
/// <param name="testProperty">The <see cref="Expression{T}"/> representing the test property.</param>
/// <param name="value">The value to to assign to the tested property.</param>
/// <param name="otherProperties">A sequence of other property <see cref="Expression{T}">expressions</see> representing the additional properties
/// that are expected to change and raise the <see cref="INotifyPropertyChanged.PropertyChanged"/> event as a result of changing the
/// <paramref name="testProperty">tested property</paramref>.</param>
/// <include file="examples.xml" path="Types/Type[@name='INotifyPropertyChangedExtensions']/Member[@name='PropertyChanged`2']/example" />
public static void PropertyChanged <TObject, TValue>(
this Asserter assert,
TObject subject,
Expression <Func <TObject, TValue> > testProperty,
TValue value,
params Expression <Func <TObject, object> >[] otherProperties) where TObject : INotifyPropertyChanged
{
Arg.NotNull(assert, nameof(assert));
assert.AssertParameterIsNotNull(subject, nameof(subject));
assert.AssertParameterIsNotNull(testProperty, nameof(testProperty));
assert.AssertParameterIsNotNull(otherProperties, nameof(otherProperties));
var test = subject.GetTestForProperty(assert, testProperty, out var propertyName);
var unexpected = new HashSet <string>();
var properties = otherProperties.ToDictionary(assert);
properties.Add(propertyName, false);
void OnPropertyChanged(object sender, PropertyChangedEventArgs e)
{
if (properties.ContainsKey(e.PropertyName))
{
properties[e.PropertyName] = true;
}
else
{
unexpected.Add(e.PropertyName);
}
}
subject.PropertyChanged += OnPropertyChanged;
try
{
test(subject, value);
}
finally
{
subject.PropertyChanged -= OnPropertyChanged;
}
assert.AllPropertiesWereChanged(properties);
assert.UnexpectedPropertiesWereNotChanged(unexpected);
}
/// <summary>
/// Asserts the specified test method throws an <see cref="ArgumentException">argument exception</see>.
/// </summary>
/// <typeparam name="TException">The <see cref="Type">type</see> of <see cref="ArgumentException"/> to expect.</typeparam>
/// <param name="assert">The extended <see cref="Asserter"/>.</param>
/// <param name="testMethod">The <see cref="Action"/> representing the test method.</param>
/// <param name="paramName">The name of the parameter expected to throw an exception.</param>
/// <param name="message">A message to display if the assertion fails. This message can be seen in the unit test results.</param>
/// <param name="parameters">An array of parameters to use when formatting <paramref name="message" />.</param>
/// <returns>The <see cref="ExceptionAsserter{T}">asserted exception</see>.</returns>
/// <include file="examples.xml" path="Types/Type[@name='ExceptionExtensions']/Member[@name='ThrowsForArgument`1']/example[2]" />
public static ExceptionAsserter <TException> ThrowsForArgument <TException>(this Asserter assert, Action testMethod, string paramName, string message, params object[] parameters) where TException : ArgumentException
{
Arg.NotNull(assert, nameof(assert));
Contract.Ensures(Contract.Result <ExceptionAsserter <TException> >() != null);
assert.AssertParameterIsNotNull(testMethod, nameof(testMethod));
var assertion = assert.Throws <TException>(testMethod, message, parameters);
var actualParam = assertion.Exception.ParamName;
assert.AreEqual(paramName, actualParam, WrongParameterName, paramName, actualParam);
return(assertion);
}
/// <summary>
/// Asserts that the specified object does not raise the <see cref="INotifyPropertyChanged.PropertyChanged"/> event.
/// </summary>
/// <typeparam name="TObject">The <see cref="Type">type</see> of <see cref="INotifyPropertyChanged">object</see> to test.</typeparam>
/// <typeparam name="TValue">The <see cref="Type">type</see> of value to assign to the property.</typeparam>
/// <param name="assert">The extended <see cref="Asserter"/>.</param>
/// <param name="subject">The <see cref="INotifyPropertyChanged">object</see> to test.</param>
/// <param name="testProperty">The <see cref="Expression{T}">expression</see> representing the test property.</param>
/// <param name="value">The value to to assign to the tested property.</param>
/// <include file="examples.xml" path="Types/Type[@name='INotifyPropertyChangedExtensions']/Member[@name='PropertyNotChanged`2']/example" />
public static void PropertyNotChanged <TObject, TValue>(this Asserter assert, TObject subject, Expression <Func <TObject, TValue> > testProperty, TValue value) where TObject : INotifyPropertyChanged
{
Arg.NotNull(assert, nameof(assert));
assert.AssertParameterIsNotNull(subject, nameof(subject));
assert.AssertParameterIsNotNull(testProperty, nameof(testProperty));
var changed = false;
var test = subject.GetTestForProperty(assert, testProperty, out var propertyName);
void OnPropertyChanged(object sender, PropertyChangedEventArgs e)
{
changed = true;
propertyName = e.PropertyName;
}
subject.PropertyChanged += OnPropertyChanged;
try
{
test(subject, value);
}
finally
{
subject.PropertyChanged -= OnPropertyChanged;
}
if (string.IsNullOrEmpty(propertyName))
{
assert.IsFalse(changed, AllPropertiesChangedRaised);
}
else
{
assert.IsFalse(changed, PropertyChangedRaised, propertyName);
}
}
static ExceptionAsserter <TException> ThrowsIfArgumentIs <TArg, TException>(this Asserter assert, Expression <Action <TArg> > testMethod, TArg value, string message, params object[] parameters) where TException : ArgumentException
{
Arg.NotNull(assert, nameof(assert));
Arg.NotNull(assert, nameof(testMethod));
Contract.Ensures(Contract.Result <ExceptionAsserter <TException> >() != null);
assert.AssertParameterIsNotNull(testMethod, nameof(testMethod));
var test = testMethod.Compile();
var assertion = assert.Throws <TException>(() => test(value), message, parameters);
var expectedParam = testMethod.Parameters.First().Name;
var actualParam = assertion.Exception.ParamName;
assert.AreEqual(expectedParam, actualParam, WrongParameterName, expectedParam, actualParam);
return(assertion);
}
/// <summary>
/// Asserts the specified test method throws an exception of any type.
/// </summary>
/// <param name="assert">The extended <see cref="Asserter"/>.</param>
/// <param name="testMethod">The <see cref="Action"/> representing the test method.</param>
/// <param name="message">A message to display if the assertion fails. This message can be seen in the unit test results.</param>
/// <param name="parameters">An array of parameters to use when formatting <paramref name="message" />.</param>
/// <returns>The <see cref="ExceptionAsserter{T}">asserted exception</see>.</returns>
/// <include file="examples.xml" path="Types/Type[@name='ExceptionExtensions']/Member[@name='Throws']/example[2]" />
public static ExceptionAsserter <Exception> Throws(this Asserter assert, Action testMethod, string message, params object[] parameters)
{
Arg.NotNull(assert, nameof(assert));
Contract.Ensures(Contract.Result <ExceptionAsserter <Exception> >() != null);
assert.AssertParameterIsNotNull(testMethod, nameof(testMethod));
try
{
testMethod();
}
catch (Exception ex)
{
return(new ExceptionAsserter <Exception>(ex));
}
assert.Fail(message, parameters);
return(default(ExceptionAsserter <Exception>));
}
