Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add Imply() to BooleanAssertions #2074

Merged
merged 20 commits into from Jan 3, 2023
Merged

Add Imply() to BooleanAssertions #2074

Show file tree
Hide file tree
Changes from 12 commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
7918ef1
Add `Imply()` to `BooleanAssertions`
IT-VBFK Dec 28, 2022
70dd569
Approve API
IT-VBFK Dec 28, 2022
4a2d67c
Add release notes
IT-VBFK Dec 28, 2022
c2a2344
Update the docs
IT-VBFK Dec 28, 2022
7c66a67
Fix possible `NullReferenceException`
IT-VBFK Dec 28, 2022
fa65a54
Test the because arguments
IT-VBFK Dec 28, 2022
694bd37
Add missing xml comments
IT-VBFK Dec 28, 2022
ade5b60
Fix test names and variable names
IT-VBFK Dec 28, 2022
0e82b92
Accept API changes
IT-VBFK Dec 28, 2022
7657c93
Using `CallerArgumentExpression`
IT-VBFK Dec 28, 2022
aa4ccbf
Accept API changes
IT-VBFK Dec 28, 2022
16f335f
Mention the `CallerArgumentExpression` in the docs
IT-VBFK Dec 28, 2022
1dbf235
Name the operands for the implication correctly
IT-VBFK Dec 29, 2022
97ccf12
Accept API changes
IT-VBFK Dec 29, 2022
3b134c9
Add documentation about necessity of the caller argument expression
IT-VBFK Dec 30, 2022
5c1a4f6
Remove `CallerArgumentExpression`
IT-VBFK Dec 30, 2022
c2ccbcc
Update Src/FluentAssertions/Primitives/BooleanAssertions.cs
IT-VBFK Jan 2, 2023
c2a49ef
Minor typo fixes
IT-VBFK Jan 2, 2023
6d09735
Switch from `MemberData` to `InlineData`
IT-VBFK Jan 3, 2023
3f340f5
Update Tests/FluentAssertions.Specs/Primitives/BooleanAssertionSpecs.cs
IT-VBFK Jan 3, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
31 changes: 31 additions & 0 deletions Src/FluentAssertions/Primitives/BooleanAssertions.cs
View file
Open in desktop
@@ -1,5 +1,6 @@
using System;
using System.Diagnostics;
using System.Runtime.CompilerServices;
IT-VBFK marked this conversation as resolved.
Show resolved Hide resolved
using FluentAssertions.Execution;

namespace FluentAssertions.Primitives;
Expand Down Expand Up @@ -118,6 +119,36 @@ public AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", pa
return new AndConstraint<TAssertions>((TAssertions)this);
}

/// <summary>
/// Asserts that the value implies the specified <paramref name="implicator"/> value.
/// </summary>
/// <param name="implicator">The second value for the implication</param>
/// <param name="because">
/// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion
/// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
/// </param>
/// <param name="becauseArgs">
/// Zero or more objects to format using the placeholders in <paramref name="because"/>.
/// </param>
public AndConstraint<TAssertions> Imply(bool implicator,
[CallerArgumentExpression("implicator")] string implicatorMessage = "",
string because = "",
params object[] becauseArgs)
{
Execute.Assertion
.ForCondition(Subject is not null)
.BecauseOf(because, becauseArgs)
.WithExpectation("Expected {context:boolean} ({0}) to imply {1} ({2}){reason}, ", Subject, implicatorMessage, implicator)
.FailWith("but found null.")
.Then
.ForCondition(!Subject.Value || implicator)
.FailWith("but it did not.")
.Then
.ClearExpectation();

return new AndConstraint<TAssertions>((TAssertions)this);
}

/// <inheritdoc/>
public override bool Equals(object obj) =>
throw new NotSupportedException("Equals is not part of Fluent Assertions. Did you mean Be() instead?");
Expand Down
1 change: 1 addition & 0 deletions Tests/Approval.Tests/ApprovedApi/FluentAssertions/net47.verified.txt
View file
Open in desktop
Expand Up @@ -1816,6 +1816,7 @@ namespace FluentAssertions.Primitives
public FluentAssertions.AndConstraint<TAssertions> BeFalse(string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> BeTrue(string because = "", params object[] becauseArgs) { }
public override bool Equals(object obj) { }
public FluentAssertions.AndConstraint<TAssertions> Imply(bool implicator, [System.Runtime.CompilerServices.CallerArgumentExpression("implicator")] string implicatorMessage = "", string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", params object[] becauseArgs) { }
}
public class DateTimeAssertions : FluentAssertions.Primitives.DateTimeAssertions<FluentAssertions.Primitives.DateTimeAssertions>
Expand Down
1 change: 1 addition & 0 deletions Tests/Approval.Tests/ApprovedApi/FluentAssertions/net6.0.verified.txt
View file
Open in desktop
Expand Up @@ -1841,6 +1841,7 @@ namespace FluentAssertions.Primitives
public FluentAssertions.AndConstraint<TAssertions> BeFalse(string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> BeTrue(string because = "", params object[] becauseArgs) { }
public override bool Equals(object obj) { }
public FluentAssertions.AndConstraint<TAssertions> Imply(bool implicator, [System.Runtime.CompilerServices.CallerArgumentExpression("implicator")] string implicatorMessage = "", string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", params object[] becauseArgs) { }
}
public class DateOnlyAssertions : FluentAssertions.Primitives.DateOnlyAssertions<FluentAssertions.Primitives.DateOnlyAssertions>
Expand Down
1 change: 1 addition & 0 deletions Tests/Approval.Tests/ApprovedApi/FluentAssertions/netcoreapp2.1.verified.txt
View file
Open in desktop
Expand Up @@ -1816,6 +1816,7 @@ namespace FluentAssertions.Primitives
public FluentAssertions.AndConstraint<TAssertions> BeFalse(string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> BeTrue(string because = "", params object[] becauseArgs) { }
public override bool Equals(object obj) { }
public FluentAssertions.AndConstraint<TAssertions> Imply(bool implicator, [System.Runtime.CompilerServices.CallerArgumentExpression("implicator")] string implicatorMessage = "", string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", params object[] becauseArgs) { }
}
public class DateTimeAssertions : FluentAssertions.Primitives.DateTimeAssertions<FluentAssertions.Primitives.DateTimeAssertions>
Expand Down
1 change: 1 addition & 0 deletions Tests/Approval.Tests/ApprovedApi/FluentAssertions/netcoreapp3.0.verified.txt
View file
Open in desktop
Expand Up @@ -1816,6 +1816,7 @@ namespace FluentAssertions.Primitives
public FluentAssertions.AndConstraint<TAssertions> BeFalse(string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> BeTrue(string because = "", params object[] becauseArgs) { }
public override bool Equals(object obj) { }
public FluentAssertions.AndConstraint<TAssertions> Imply(bool implicator, [System.Runtime.CompilerServices.CallerArgumentExpression("implicator")] string implicatorMessage = "", string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", params object[] becauseArgs) { }
}
public class DateTimeAssertions : FluentAssertions.Primitives.DateTimeAssertions<FluentAssertions.Primitives.DateTimeAssertions>
Expand Down
1 change: 1 addition & 0 deletions Tests/Approval.Tests/ApprovedApi/FluentAssertions/netstandard2.0.verified.txt
View file
Open in desktop
Expand Up @@ -1767,6 +1767,7 @@ namespace FluentAssertions.Primitives
public FluentAssertions.AndConstraint<TAssertions> BeFalse(string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> BeTrue(string because = "", params object[] becauseArgs) { }
public override bool Equals(object obj) { }
public FluentAssertions.AndConstraint<TAssertions> Imply(bool implicator, [System.Runtime.CompilerServices.CallerArgumentExpression("implicator")] string implicatorMessage = "", string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", params object[] becauseArgs) { }
}
public class DateTimeAssertions : FluentAssertions.Primitives.DateTimeAssertions<FluentAssertions.Primitives.DateTimeAssertions>
Expand Down
1 change: 1 addition & 0 deletions Tests/Approval.Tests/ApprovedApi/FluentAssertions/netstandard2.1.verified.txt
View file
Open in desktop
Expand Up @@ -1816,6 +1816,7 @@ namespace FluentAssertions.Primitives
public FluentAssertions.AndConstraint<TAssertions> BeFalse(string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> BeTrue(string because = "", params object[] becauseArgs) { }
public override bool Equals(object obj) { }
public FluentAssertions.AndConstraint<TAssertions> Imply(bool implicator, [System.Runtime.CompilerServices.CallerArgumentExpression("implicator")] string implicatorMessage = "", string because = "", params object[] becauseArgs) { }
public FluentAssertions.AndConstraint<TAssertions> NotBe(bool unexpected, string because = "", params object[] becauseArgs) { }
}
public class DateTimeAssertions : FluentAssertions.Primitives.DateTimeAssertions<FluentAssertions.Primitives.DateTimeAssertions>
Expand Down