From b9ca272179abc0bc017c9f7ff318ec5198124fe9 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Tue, 25 Nov 2025 18:24:21 +0100 Subject: [PATCH 1/3] Removed collectioncontains documentation as it's not there --- .../classic-assertions/Assert.Contains.md | 2 - .../CollectionContainsConstraint.md | 41 ------------------- .../writing-tests/constraints/Constraints.md | 1 - .../constraints/SomeItemsConstraint.md | 13 ++++++ .../nunit/writing-tests/constraints/toc.yml | 2 - 5 files changed, 13 insertions(+), 46 deletions(-) delete mode 100644 docs/articles/nunit/writing-tests/constraints/CollectionContainsConstraint.md diff --git a/docs/articles/nunit/writing-tests/assertions/classic-assertions/Assert.Contains.md b/docs/articles/nunit/writing-tests/assertions/classic-assertions/Assert.Contains.md index fe753f5b0..9d4e5b952 100644 --- a/docs/articles/nunit/writing-tests/assertions/classic-assertions/Assert.Contains.md +++ b/docs/articles/nunit/writing-tests/assertions/classic-assertions/Assert.Contains.md @@ -10,5 +10,3 @@ ClassicAssert.Contains(object anObject, ICollection collection, ``` ## See Also - -* [CollectionContainsConstraint](xref:collectioncontainsconstraint) diff --git a/docs/articles/nunit/writing-tests/constraints/CollectionContainsConstraint.md b/docs/articles/nunit/writing-tests/constraints/CollectionContainsConstraint.md deleted file mode 100644 index c94518ac7..000000000 --- a/docs/articles/nunit/writing-tests/constraints/CollectionContainsConstraint.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -uid: collectioncontainsconstraint ---- - -# CollectionContains Constraint - -`CollectionContainsConstraint` tests that an `IEnumerable` contains an object. If the actual value passed does not -implement `IEnumerable`, an exception is thrown. - -## Constructor - -```csharp -CollectionContainsConstraint(object) -``` - -## Syntax - -```csharp -Has.Member(object) -Contains.Item(object) -Does.Contain(object) -``` - -## Modifiers - -```csharp -...Using(IComparer comparer) -...Using(IComparer comparer) -...Using(Comparison comparer) -``` - -## Examples of Use - -[!code-csharp[CollectionContainsExamples](~/snippets/Snippets.NUnit/ConstraintExamples.cs#CollectionContainsExamples)] - -## Note - -`Has.Member()`, `Contains.Item()` and `Does.Contain()` work the same as `Has.Some.EqualTo()`. The last statement -generates a [SomeItemsConstraint](SomeItemsConstraint.md) based on an [EqualConstraint](EqualConstraint.md) and offers -additional options such as ignoring case or specifying a tolerance. The syntax on this page may be viewed as a shortcut -for specifying simpler cases. diff --git a/docs/articles/nunit/writing-tests/constraints/Constraints.md b/docs/articles/nunit/writing-tests/constraints/Constraints.md index 4006d06e0..3c6516c98 100644 --- a/docs/articles/nunit/writing-tests/constraints/Constraints.md +++ b/docs/articles/nunit/writing-tests/constraints/Constraints.md @@ -21,7 +21,6 @@ Constraint Name | [AttributeExistsConstraint](AttributeExistsConstraint.md) | [AnyOfConstraint](AnyOfConstraint.md) | [BinarySerializableConstraint](BinarySerializableConstraint.md) | -[CollectionContainsConstraint](CollectionContainsConstraint.md) | [CollectionEquivalentConstraint](CollectionEquivalentConstraint.md) | [CollectionOrderedConstraint](CollectionOrderedConstraint.md) | [CollectionSubsetConstraint](CollectionSubsetConstraint.md) | diff --git a/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md b/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md index 6c952f5aa..c8533180b 100644 --- a/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md +++ b/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md @@ -3,6 +3,8 @@ `SomeItemsConstraint` applies a constraint to each item in an `IEnumerable`, succeeding if at least one of them succeeds. An exception is thrown if the actual value passed does not implement `IEnumerable`. +This constraint will also cover `Contains` functionality. See examples below. + ## Constructor ```csharp @@ -13,6 +15,9 @@ SomeItemsConstraint(Constraint itemConstraint) ```csharp Has.Some... +Has.Member(object) +Contains.Item(object) +Does.Contain(object) ``` ## Modifiers @@ -40,3 +45,11 @@ string[] sarray = new string[] { "a", "b", "c" }; Assert.That(iarray, Has.Some.GreaterThan(2)); Assert.That(sarray, Has.Some.Length.EqualTo(1)); ``` + +### Contains examples + +[!code-csharp[Collection Contains Examples](~/snippets/Snippets.NUnit/ConstraintExamples.cs#CollectionContainsExamples)] + +## Note + +`Has.Member()`, `Contains.Item()` and `Does.Contain()` work the same as `Has.Some.EqualTo()`. diff --git a/docs/articles/nunit/writing-tests/constraints/toc.yml b/docs/articles/nunit/writing-tests/constraints/toc.yml index 4461c6a1c..c6d90e253 100644 --- a/docs/articles/nunit/writing-tests/constraints/toc.yml +++ b/docs/articles/nunit/writing-tests/constraints/toc.yml @@ -16,8 +16,6 @@ href: AttributeExistsConstraint.md - name: BinarySerializableConstraint href: BinarySerializableConstraint.md -- name: CollectionContainsConstraint - href: CollectionContainsConstraint.md - name: CollectionEquivalentConstraint href: CollectionEquivalentConstraint.md - name: CollectionOrderedConstraint From 79193f89e7fc574f5cf171a807eed94431f46ecb Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Tue, 25 Nov 2025 18:27:59 +0100 Subject: [PATCH 2/3] Removed collectioncontains documentation as it's not there --- docs/articles/nunit/writing-tests/constraints/Constraints.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/articles/nunit/writing-tests/constraints/Constraints.md b/docs/articles/nunit/writing-tests/constraints/Constraints.md index 3c6516c98..985298a88 100644 --- a/docs/articles/nunit/writing-tests/constraints/Constraints.md +++ b/docs/articles/nunit/writing-tests/constraints/Constraints.md @@ -76,7 +76,6 @@ Constraint Name | -------------------------------------| [AllItemsConstraint](AllItemsConstraint.md) | [AnyOfConstraint](AnyOfConstraint.md) | -[CollectionContainsConstraint](CollectionContainsConstraint.md) | [CollectionEquivalentConstraint](CollectionEquivalentConstraint.md) | [CollectionOrderedConstraint](CollectionOrderedConstraint.md) | [CollectionSubsetConstraint](CollectionSubsetConstraint.md) | From 6a9320552808e9c55e8905293b5b273b3f5a2ea4 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Tue, 25 Nov 2025 19:38:39 +0100 Subject: [PATCH 3/3] Removed collectioncontains documentation as it's not there --- .../nunit/writing-tests/constraints/AnyOfConstraint.md | 2 +- .../nunit/writing-tests/constraints/SomeItemsConstraint.md | 3 +++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/articles/nunit/writing-tests/constraints/AnyOfConstraint.md b/docs/articles/nunit/writing-tests/constraints/AnyOfConstraint.md index c1bb55c0f..e19fe7560 100644 --- a/docs/articles/nunit/writing-tests/constraints/AnyOfConstraint.md +++ b/docs/articles/nunit/writing-tests/constraints/AnyOfConstraint.md @@ -4,7 +4,7 @@ > [!NOTE] > Values provided must be as parameters to the method, not as e.g. a separate array. If you are instead looking -> to see if a collection contains a value, see the [CollectionContains Constraint](xref:collectioncontainsconstraint). +> to see if a collection contains a value, see the [SomeItems Constraint](xref:someitemsconstraint). ## Constructor diff --git a/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md b/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md index c8533180b..10216d538 100644 --- a/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md +++ b/docs/articles/nunit/writing-tests/constraints/SomeItemsConstraint.md @@ -1,3 +1,6 @@ +--- +uid: someitemsconstraint +--- # SomeItems Constraint `SomeItemsConstraint` applies a constraint to each item in an `IEnumerable`, succeeding if at least one of them