Feature/list chunk

.github/workflows/dotnet-devfast-extension.yml

@@ -8,8 +8,8 @@ jobs:
   buildAndTestFull:
     strategy:
       matrix:
-        dotnet-version: ['6.x.x','7.x.x','8.x.x']
-    runs-on: ubuntu-latest
+        dotnet-version: ['8.x.x']
+    runs-on: windows-latest
     steps:
     - name: Checkout
       uses: actions/checkout@v4

README.md

@@ -21,6 +21,6 @@ Similar ".TryTo" also exists on ReadOnlySpan<char> and ReadOnlySpan<byt
  - myByteArray.DoubleByteCapacity() returns new array with initial bytes but twice the capacity
  - myByteArray.CopyToSafe(...) copies bytes to targeted array
 
-#### IEnumerable & IAsyncEnumerable with CancellationToken All the Way
- - ForEach, ForEachAsync, ToBlockingEnumerable with CancellationToken
- - CancellationToken support for SelectAsync, SkipAsync, TakeAsync, WhereAsync, CountAsync, ToChunksAsync etc.
+#### IEnumerable & IAsyncEnumerable with Token All the Way
+ - ForEach, ForEachAsync, ToBlockingEnumerable with Token
+ - Token support for SelectAsync, SkipAsync, TakeAsync, WhereAsync, CountAsync, ToChunksAsync etc.

ReleaseNotes.txt

@@ -1,3 +1,8 @@
+DevFast.Net.Extensions 0.7.3
+
+ 1. New feature - Added following new extension methods in DevFast.Net.Extensions.SystemTypes.DataCollections:
+			- Chunk<T>(this IList<T>, int, CancellationToken, bool)
+
 DevFast.Net.Extensions 0.7.2
 
  1. New feature - With polyfill, increasing library scope for older .Net versions.

docs/net6.0/DevFast.Net.Extensions.SystemTypes.DataCollections.md

@@ -0,0 +1,67 @@
+#### [DevFast.Net.Extensions](index.md 'index')
+### [DevFast.Net.Extensions.SystemTypes](DevFast.Net.Extensions.SystemTypes.md 'DevFast.Net.Extensions.SystemTypes')
+
+## DataCollections Class
+
+Extension methods on various data-collection e.g. [System.Collections.Generic.IList<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1').
+
+```csharp
+public static class DataCollections
+```
+- *Methods*
+  - **[Chunk&lt;T&gt;(this IList&lt;T&gt;, int, CancellationToken, bool)](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool) 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool)')**
+
+## DataCollections Class
+
+Extension methods on various data-collection e.g. [System.Collections.Generic.IList&lt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1').
+
+```csharp
+public static class DataCollections
+```
+
+Inheritance [System.Object](https://docs.microsoft.com/en-us/dotnet/api/System.Object 'System.Object') &#129106; DataCollections
+### Methods
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool)'></a>
+
+## DataCollections.Chunk<T>(this IList<T>, int, CancellationToken, bool) Method
+
+Splits the elements of given [list](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).list 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).list') into chunks of [maxSize](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).maxSize 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).maxSize')
+WITHOUT re-allocating the memory while observing the provided [token](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).token 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).token').
+
+```csharp
+public static System.Collections.Generic.IEnumerable<System.Collections.Generic.IEnumerable<T>> Chunk<T>(this System.Collections.Generic.IList<T> list, int maxSize, System.Threading.CancellationToken token, bool observeTokenInChunkEnumeration=false);
+```
+#### Type parameters
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).T'></a>
+
+`T`
+#### Parameters
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).list'></a>
+
+`list` [System.Collections.Generic.IList&lt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1')[T](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).T 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).T')[&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1')
+
+Collection on which chunks will be created.
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).maxSize'></a>
+
+`maxSize` [System.Int32](https://docs.microsoft.com/en-us/dotnet/api/System.Int32 'System.Int32')
+
+Maximum size of a given chunk
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).token'></a>
+
+`token` [System.Threading.CancellationToken](https://docs.microsoft.com/en-us/dotnet/api/System.Threading.CancellationToken 'System.Threading.CancellationToken')
+
+Cancellation token to observe.
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).observeTokenInChunkEnumeration'></a>
+
+`observeTokenInChunkEnumeration` [System.Boolean](https://docs.microsoft.com/en-us/dotnet/api/System.Boolean 'System.Boolean')
+
+When [true](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/bool 'https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/bool') token cancellation is observed during chunk enumeration (may slow-down enumeration)
+
+#### Returns
+[System.Collections.Generic.IEnumerable&lt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')[System.Collections.Generic.IEnumerable&lt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')[T](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).T 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).T')[&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')[&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')

docs/net6.0/DevFast.Net.Extensions.SystemTypes.md

@@ -7,6 +7,7 @@ Under this [namespace](https://docs.microsoft.com/en-us/dotnet/csharp/language-r
 | Classes | |
 | :--- | :--- |
 | [ByteArrays](DevFast.Net.Extensions.SystemTypes.ByteArrays.md 'DevFast.Net.Extensions.SystemTypes.ByteArrays') | Extension methods on Array of type [System.Byte](https://docs.microsoft.com/en-us/dotnet/api/System.Byte 'System.Byte'). |
+| [DataCollections](DevFast.Net.Extensions.SystemTypes.DataCollections.md 'DevFast.Net.Extensions.SystemTypes.DataCollections') | Extension methods on various data-collection e.g. [System.Collections.Generic.IList<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1'). |
 | [Enumerables](DevFast.Net.Extensions.SystemTypes.Enumerables.md 'DevFast.Net.Extensions.SystemTypes.Enumerables') | Extension methods on [System.Collections.Generic.IEnumerable<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1') and [System.Collections.Generic.IAsyncEnumerable<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IAsyncEnumerable-1 'System.Collections.Generic.IAsyncEnumerable`1'). |
 | [ReadableSpan](DevFast.Net.Extensions.SystemTypes.ReadableSpan.md 'DevFast.Net.Extensions.SystemTypes.ReadableSpan') | Extension methods on [System.ReadOnlySpan<>](https://docs.microsoft.com/en-us/dotnet/api/System.ReadOnlySpan-1 'System.ReadOnlySpan`1'). |
 | [Strings](DevFast.Net.Extensions.SystemTypes.Strings.md 'DevFast.Net.Extensions.SystemTypes.Strings') | Extension methods on [System.String](https://docs.microsoft.com/en-us/dotnet/api/System.String 'System.String'). |

docs/net8.0/DevFast.Net.Extensions.SystemTypes.DataCollections.md

@@ -0,0 +1,67 @@
+#### [DevFast.Net.Extensions](index.md 'index')
+### [DevFast.Net.Extensions.SystemTypes](DevFast.Net.Extensions.SystemTypes.md 'DevFast.Net.Extensions.SystemTypes')
+
+## DataCollections Class
+
+Extension methods on various data-collection e.g. [System.Collections.Generic.IList<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1').
+
+```csharp
+public static class DataCollections
+```
+- *Methods*
+  - **[Chunk&lt;T&gt;(this IList&lt;T&gt;, int, CancellationToken, bool)](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool) 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool)')**
+
+## DataCollections Class
+
+Extension methods on various data-collection e.g. [System.Collections.Generic.IList&lt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1').
+
+```csharp
+public static class DataCollections
+```
+
+Inheritance [System.Object](https://docs.microsoft.com/en-us/dotnet/api/System.Object 'System.Object') &#129106; DataCollections
+### Methods
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool)'></a>
+
+## DataCollections.Chunk<T>(this IList<T>, int, CancellationToken, bool) Method
+
+Splits the elements of given [list](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).list 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).list') into chunks of [maxSize](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).maxSize 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).maxSize')
+WITHOUT re-allocating the memory while observing the provided [token](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).token 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).token').
+
+```csharp
+public static System.Collections.Generic.IEnumerable<System.Collections.Generic.IEnumerable<T>> Chunk<T>(this System.Collections.Generic.IList<T> list, int maxSize, System.Threading.CancellationToken token, bool observeTokenInChunkEnumeration=false);
+```
+#### Type parameters
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).T'></a>
+
+`T`
+#### Parameters
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).list'></a>
+
+`list` [System.Collections.Generic.IList&lt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1')[T](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).T 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).T')[&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1')
+
+Collection on which chunks will be created.
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).maxSize'></a>
+
+`maxSize` [System.Int32](https://docs.microsoft.com/en-us/dotnet/api/System.Int32 'System.Int32')
+
+Maximum size of a given chunk
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).token'></a>
+
+`token` [System.Threading.CancellationToken](https://docs.microsoft.com/en-us/dotnet/api/System.Threading.CancellationToken 'System.Threading.CancellationToken')
+
+Cancellation token to observe.
+
+<a name='DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).observeTokenInChunkEnumeration'></a>
+
+`observeTokenInChunkEnumeration` [System.Boolean](https://docs.microsoft.com/en-us/dotnet/api/System.Boolean 'System.Boolean')
+
+When [true](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/bool 'https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/bool') token cancellation is observed during chunk enumeration (may slow-down enumeration)
+
+#### Returns
+[System.Collections.Generic.IEnumerable&lt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')[System.Collections.Generic.IEnumerable&lt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')[T](DevFast.Net.Extensions.SystemTypes.DataCollections.md#DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk_T_(thisSystem.Collections.Generic.IList_T_,int,System.Threading.CancellationToken,bool).T 'DevFast.Net.Extensions.SystemTypes.DataCollections.Chunk<T>(this System.Collections.Generic.IList<T>, int, System.Threading.CancellationToken, bool).T')[&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')[&gt;](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1')

docs/net8.0/DevFast.Net.Extensions.SystemTypes.md

@@ -7,6 +7,7 @@ Under this [namespace](https://docs.microsoft.com/en-us/dotnet/csharp/language-r
 | Classes | |
 | :--- | :--- |
 | [ByteArrays](DevFast.Net.Extensions.SystemTypes.ByteArrays.md 'DevFast.Net.Extensions.SystemTypes.ByteArrays') | Extension methods on Array of type [System.Byte](https://docs.microsoft.com/en-us/dotnet/api/System.Byte 'System.Byte'). |
+| [DataCollections](DevFast.Net.Extensions.SystemTypes.DataCollections.md 'DevFast.Net.Extensions.SystemTypes.DataCollections') | Extension methods on various data-collection e.g. [System.Collections.Generic.IList<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IList-1 'System.Collections.Generic.IList`1'). |
 | [Enumerables](DevFast.Net.Extensions.SystemTypes.Enumerables.md 'DevFast.Net.Extensions.SystemTypes.Enumerables') | Extension methods on [System.Collections.Generic.IEnumerable<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1 'System.Collections.Generic.IEnumerable`1') and [System.Collections.Generic.IAsyncEnumerable<>](https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IAsyncEnumerable-1 'System.Collections.Generic.IAsyncEnumerable`1'). |
 | [ReadableSpan](DevFast.Net.Extensions.SystemTypes.ReadableSpan.md 'DevFast.Net.Extensions.SystemTypes.ReadableSpan') | Extension methods on [System.ReadOnlySpan<>](https://docs.microsoft.com/en-us/dotnet/api/System.ReadOnlySpan-1 'System.ReadOnlySpan`1'). |
 | [Strings](DevFast.Net.Extensions.SystemTypes.Strings.md 'DevFast.Net.Extensions.SystemTypes.Strings') | Extension methods on [System.String](https://docs.microsoft.com/en-us/dotnet/api/System.String 'System.String'). |

docs/netstandard2.0/DevFast.Net.Extensions.Etc.Asynchro.md

@@ -32,7 +32,7 @@ Inheritance [System.Object](https://docs.microsoft.com/en-us/dotnet/api/System.O
 Gets a task that has already completed successfully.
 
 ```csharp
-public static ValueTask CompletedTask { get; }
+public static System.Threading.Tasks.ValueTask CompletedTask { get; }
 ```
 
 #### Property Value