Add cancel after snippets (#1114)

* Add cancel after snippets

* Adjust some formatting for cancelafter attribute

Author: stevenaw

docs/articles/nunit/writing-tests/attributes/cancelafter.md

@@ -37,16 +37,15 @@ When used on test methods, NUnit automatically adds an extra argument to your me
 
 ## Example
 
-```csharp
-[Test, CancelAfter(2000)]
-public void RunningTestUntilCanceled(CancellationToken token)
-{
-    while (!token.IsCancellationRequested)
-    {
-        /* */
-    }
-}
+The `CancelAfterAttribute` supports cancellation across a variety of ways to write tests.
+
+A simple test, written using the `Test` attribute:
+
+[!code-csharp[TestWithCancellationToken](~/snippets/Snippets.NUnit/Attributes/CancelAfterAttributeExamples.cs#TestWithCancellationToken)]
 
+A parameterized test written using the `TestCase` attribute:
+
+```csharp
 [CancelAfter(2000)]
 [TestCase("http://server1")]
 [TestCase("http://server2")]
@@ -60,6 +59,10 @@ public async Task PotentiallyLongRunningTest(string uri, CancellationToken token
 }
 ```
 
+A parameterized test written using the `TestCaseSource` attribute:
+
+[!code-csharp[TestCaseSourceWithCancellationToken](~/snippets/Snippets.NUnit/Attributes/CancelAfterAttributeExamples.cs#TestCaseSourceWithCancellationToken)]
+
 > [!NOTE]
 > When debugging a unit test, i.e. when a debugger is attached to the process, the timeout is not enforced.
 

docs/snippets/Snippets.NUnit/Attributes/CancelAfterAttributeExamples.cs

@@ -0,0 +1,34 @@
+using NUnit.Framework;
+#pragma warning disable NUnit1029  // Pending https://github.com/nunit/nunit.analyzers/issues/957
+
+namespace Snippets.NUnit.Attributes
+{
+    public class CancelAfterAttributeExamples
+    {
+        #region TestWithCancellationToken
+        [Test, CancelAfter(2_000)]
+        public void RunningTestUntilCanceled(CancellationToken cancellationToken)
+        {
+            while (!cancellationToken.IsCancellationRequested)
+            {
+                /* */
+            }
+        }
+        #endregion
+
+        #region TestCaseSourceWithCancellationToken
+        private static int[] _simpleValues = { 2, 4, 6, 8 };
+
+        [TestCaseSource(nameof(_simpleValues)), CancelAfter(1_000)]
+        public void TestCaseSourceWithCancellationToken(int a, CancellationToken cancellationToken)
+        {
+            Assert.That(cancellationToken, Is.Not.Default);
+
+            while (!cancellationToken.IsCancellationRequested)
+            {
+                /* */
+            }
+        }
+        #endregion
+    }
+}

docs/snippets/Snippets.NUnit/Snippets.NUnit.csproj

@@ -10,7 +10,7 @@
 
     <ItemGroup>
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
-        <PackageReference Include="NUnit" Version="4.5.0-alpha.0.20" />
+        <PackageReference Include="NUnit" Version="4.5.0-alpha.0.25" />
         <PackageReference Include="NUnit3TestAdapter" Version="6.0.0" />
         <PackageReference Include="NUnit.Analyzers" Version="4.11.2">
             <PrivateAssets>all</PrivateAssets>