Docs

README.md

@@ -119,6 +119,24 @@ AsyncEx is similar to Async except in the following ways:
     }
     ```
 
+4. Use [IAsyncEnumerable](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.iasyncenumerable-1?view=net-8.0) with `for` keyword. This example uses [TaskSeq](https://github.com/fsprojects/FSharp.Control.TaskSeq) but you can use any `IAsyncEnumerable<T>`.
+
+
+    ```fsharp
+    open IcedTasks
+    open FSharp.Control
+    let myAsyncEx = asyncEx {
+        let items = taskSeq {  // IAsyncEnumerable<T>
+            yield 42
+            do! Task.Delay(100)
+            yield 1701
+        }
+        let mutable sum = 0
+        for i in items do
+            sum <- sum + i
+        return sum
+    }
+    ```
 
 ### For [ValueTasks](https://devblogs.microsoft.com/dotnet/understanding-the-whys-whats-and-whens-of-valuetask/)
 

docsSrc/index.md

@@ -90,6 +90,24 @@ AsyncEx is similar to Async except in the following ways:
     }
     ```
 
+4. Use [IAsyncEnumerable](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.iasyncenumerable-1?view=net-8.0) with `for` keyword. This example uses [TaskSeq](https://github.com/fsprojects/FSharp.Control.TaskSeq) but you can use any `IAsyncEnumerable<T>`.
+
+
+    ```fsharp
+    open IcedTasks
+    open FSharp.Control
+    let myAsyncEx = asyncEx {
+        let items = taskSeq {  // IAsyncEnumerable<T>
+            yield 42
+            do! Task.Delay(100)
+            yield 1701
+        }
+        let mutable sum = 0
+        for i in items do
+            sum <- sum + i
+        return sum
+    }
+    ```
 
 ### For [ValueTasks](https://devblogs.microsoft.com/dotnet/understanding-the-whys-whats-and-whens-of-valuetask/)
 
@@ -110,6 +128,7 @@ let myValueTask = task {
 - You want to be able to re-run these executable tasks
 - You don't want to pollute your methods/functions with extra CancellationToken parameters
 - You want the computation to handle checking cancellation before every bind.
+- You want to use the `for` keyword with `IAsyncEnumerable<T>`.
 
 
 ### ColdTask

src/IcedTasks/AsyncEx.fs

@@ -398,6 +398,7 @@ module AsyncExExtensionsLowPriority =
     /// <item><description>Allows <c>use</c> on <see cref="T:System.IAsyncDisposable">System.IAsyncDisposable</see></description></item>
     /// <item><description>Allows <c>let!</c> for Tasks, ValueTasks, and any Awaitable Type</description></item>
     /// <item><description>When Tasks throw exceptions they will use the behavior described in <see href="https://github.com/fsharp/fslang-suggestions/issues/840">Async.Await overload (esp. AwaitTask without throwing AggregateException)</see></description></item>
+    /// <item><description>Allow <c>for</c> on <see cref="T:System.Collections.Generic.IAsyncEnumerable`1">System.Collections.Generic.IAsyncDisposable</see></description></item>
     /// </list>
     ///
     /// </remarks>
@@ -441,6 +442,7 @@ module PolyfillBuilders =
     /// <item><description>Allows <c>use</c> on <see cref="T:System.IAsyncDisposable">System.IAsyncDisposable</see></description></item>
     /// <item><description>Allows <c>let!</c> for Tasks, ValueTasks, and any Awaitable Type</description></item>
     /// <item><description>When Tasks throw exceptions they will use the behavior described in <see href="https://github.com/fsharp/fslang-suggestions/issues/840">Async.Await overload (esp. AwaitTask without throwing AggregateException)</see></description></item>
+    /// <item><description>Allow <c>for</c> on <see cref="T:System.Collections.Generic.IAsyncEnumerable`1">System.Collections.Generic.IAsyncDisposable</see></description></item>
     /// </list>
     ///
     /// </remarks>

tests/IcedTasks.Tests/AsyncExTests.fs

@@ -9,6 +9,7 @@ open System.Collections.Generic
 
 
 module AsyncExTests =
+    open FSharp.Control
 
     let builderTests =
         testList "AsyncExBuilder" [
@@ -678,8 +679,16 @@ module AsyncExTests =
                             Expect.equal actual index "Should be ok"
                         }
                     )
-
-
+                let foo = asyncEx {
+                        let items = taskSeq {  // IAsyncEnumerable<T>
+                            yield 42
+                            do! Task.Yield()
+                            yield 1701
+                        }
+                        let mutable sum = 0
+                        for i in items do
+                            sum <- sum + i
+                    }
 #if TEST_NETSTANDARD2_1 || TEST_NET6_0_OR_GREATER
                 yield!
                     [