WIP: Add programmatic constraint examples & surface in docs

.devcontainer/devcontainer.json

@@ -18,6 +18,7 @@
 				"ms-dotnettools.csharp",
 				"github.vscode-github-actions",
 				"ms-azuretools.vscode-docker",
+				"ms-dotnettools.csdevkit",
 				"stkb.rewrap"
 			]
 		}

docs/articles/nunit/writing-tests/constraints/AllItemsConstraint.md

@@ -11,18 +11,10 @@ AllItemsConstraint(Constraint itemConstraint)
 
 ## Syntax
 
-```csharp
-Is.All...
-Has.All...
-```
+You can use `Is.All` or `Has.All` to refer to all items in an `IEnumerable`.
 
 ## Examples of Use
 
-```csharp
-int[] iarray = new int[] { 1, 2, 3 };
-string[] sarray = new string[] { "a", "b", "c" };
-Assert.That(iarray, Is.All.Not.Null);
-Assert.That(sarray, Is.All.InstanceOf<string>());
-Assert.That(iarray, Is.All.GreaterThan(0));
-Assert.That(iarray, Has.All.GreaterThan(0));
-```
+[!code-csharp[IsBasedFormat](~/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs#AllItemsIsExample)]
+
+[!code-csharp[HasBasedFormat](~/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs#AllItemsHasExample)]

docs/articles/nunit/writing-tests/constraints/AndConstraint.md

@@ -16,9 +16,7 @@ AndConstraint(Constraint left, Constraint right)
 
 ## Examples of Use
 
-```csharp
-Assert.That(2.3, Is.GreaterThan(2.0).And.LessThan(3.0));
-```
+[!code-csharp[AndExample](~/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs#AndExample)]
 
 ## Evaluation Order and Precedence
 

docs/articles/nunit/writing-tests/constraints/AnyOfConstraint.md

@@ -31,9 +31,6 @@ Is.AnyOf(object[] expected)
 
 ## Examples of Use
 
-```csharp
-Assert.That(42, Is.AnyOf(0, -1, 42, 100));
+[!code-csharp[AnyOfExample](~/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs#AnyOfExample)]
 
-// You can use a custom comparer as well
-Assert.That(myOwnObject, Is.AnyOf(myArray).Using(myComparer));
-```
+[!code-csharp[AnyOfWithCustomComparison](~/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs#AnyOfWithCustomComparison)]

docs/articles/nunit/writing-tests/constraints/AssignableFromConstraint.md

@@ -17,7 +17,4 @@ Is.AssignableFrom<T>()
 
 ## Examples of Use
 
-```csharp
-Assert.That("Hello", Is.AssignableFrom(typeof(string)));
-Assert.That(5, Is.Not.AssignableFrom(typeof(string)));
-```
+[!code-csharp[AssignableFromExample](~/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs#AssignableFromExample)]

docs/snippets/Snippets.NUnit/Constraints/ConstraintExamples.cs

@@ -0,0 +1,71 @@
+using System.Collections;
+using NUnit.Framework;
+
+namespace Snippets.NUnit.Attributes
+{
+    public class ConstraintExamples
+    {
+        #region AllItemsIsExample
+        [Test]
+        public void CanUseIsToTalkAboutAllItems()
+        {
+            int[] arrayOfIntegers = new int[] { 1, 2, 3 };
+            string[] arrayOfStrings = new string[] { "a", "b", "c" };
+
+            Assert.That(arrayOfIntegers, Is.All.Not.Null);
+            Assert.That(arrayOfIntegers, Is.All.GreaterThan(0));
+
+            Assert.That(arrayOfStrings, Is.All.InstanceOf<string>());
+        }
+        #endregion
+
+        #region AllItemsHasExample
+        [Test]
+        public void CanUseHasToTalkAboutAllItems()
+        {
+            int[] arrayOfIntegers = new int[] { 1, 2, 3 };
+
+            Assert.That(arrayOfIntegers, Has.All.GreaterThan(0));
+        }
+        #endregion
+        #region AssignableFromExample
+        [Test]
+        public void AssignableFromExample()
+        {
+            var theString = "Hello";
+            Assert.That(theString, Is.AssignableFrom(typeof(string)));
+
+            var theInt = 5;
+            Assert.That(theInt, Is.Not.AssignableFrom<string>());
+        }
+        #endregion
+        #region AndExample
+        [Test]
+        public void UsingAndToCombineConstraints()
+        {
+            var testValue = 2.3;
+            Assert.That(testValue, Is.GreaterThan(2.0).And.LessThan(3.0));
+        }
+        #endregion
+        #region AnyOfExample
+        [Test]
+        public void AnyOfCanDetectIfAnItemMatchesAnArrayOfParams()
+        {
+            var testValue = 42;
+            Assert.That(testValue, Is.AnyOf(0, -1, 42, 100));
+        }
+        #endregion
+        #region AnyOfWithCustomComparison
+        [Test]
+        public void AnyOfCanUseCustomComparisons()
+        {
+            var testValue = "NUnit";
+
+            // NOTE: Here we cast our comparison to IComparer, because StringComparer implements
+            // multiple interfaces that NUnit custom comparisons supports.
+            Assert.That(testValue, Is.AnyOf("hello", "world", "nunit").Using((IComparer)StringComparer.InvariantCultureIgnoreCase));
+        }
+        #endregion
+    }
+
+}