#29 Added Slice methods to Children.

Author: MrKWatkins

.github/workflows/build.yml

@@ -29,7 +29,7 @@ jobs:
         uses: MrKWatkins/dotnet-build@main
         with:
           name: Examples
-          directory: ./examples
+          directory: examples
           coverage-run-settings: coverage.runsettings
 
       - name: Build Documentation

doc/MrKWatkins.Ast.tree

@@ -25,6 +25,7 @@
           <toc-element toc-title="Add" topic="MrKWatkins.Ast.Children-1.Add.md" />
           <toc-element toc-title="Clear" topic="MrKWatkins.Ast.Children-1.Clear.md" />
           <toc-element toc-title="Contains" topic="MrKWatkins.Ast.Children-1.Contains.md" />
+          <toc-element toc-title="EnumerateSlice" topic="MrKWatkins.Ast.Children-1.EnumerateSlice.md" />
           <toc-element toc-title="ExceptOfType" topic="MrKWatkins.Ast.Children-1.ExceptOfType.md" />
           <toc-element toc-title="FirstIfTypeOrDefault" topic="MrKWatkins.Ast.Children-1.FirstIfTypeOrDefault.md" />
           <toc-element toc-title="FirstOfType" topic="MrKWatkins.Ast.Children-1.FirstOfType.md" />
@@ -42,7 +43,9 @@
           <toc-element toc-title="Replace" topic="MrKWatkins.Ast.Children-1.Replace.md" />
           <toc-element toc-title="SingleOfType" topic="MrKWatkins.Ast.Children-1.SingleOfType.md" />
           <toc-element toc-title="SingleOfTypeOrDefault" topic="MrKWatkins.Ast.Children-1.SingleOfTypeOrDefault.md" />
+          <toc-element toc-title="Slice" topic="MrKWatkins.Ast.Children-1.Slice.md" />
           <toc-element toc-title="UnsafeGet" topic="MrKWatkins.Ast.Children-1.UnsafeGet.md" />
+          <toc-element toc-title="UnsafeSlice" topic="MrKWatkins.Ast.Children-1.UnsafeSlice.md" />
         </toc-element>
       </toc-element>
       <toc-element toc-title="DefaultNodeFactory&lt;TNode&gt;">

doc/topics/API/MrKWatkins.Ast.Children-1.EnumerateSlice.md

@@ -0,0 +1,47 @@
+# Children<TNode>.EnumerateSlice Method
+## Overloads
+
+| Name | Description |
+| ---- | ----------- |
+| [EnumerateSlice(Int32, Int32)](MrKWatkins.Ast.Children-1.EnumerateSlice.md#mrkwatkins-ast-children-1-enumerateslice(system-int32-system-int32)) | Returns a lazy enumeration of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md). |
+| [EnumerateSlice(Range)](MrKWatkins.Ast.Children-1.EnumerateSlice.md#mrkwatkins-ast-children-1-enumerateslice(system-range)) | Returns a lazy enumeration of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md). |
+
+## EnumerateSlice(Int32, Int32) {id="mrkwatkins-ast-children-1-enumerateslice(system-int32-system-int32)"}
+
+Returns a lazy enumeration of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md).
+
+```c#
+public IEnumerable<TNode> EnumerateSlice(int index, int count);
+```
+
+## Parameters {id="parameters-mrkwatkins-ast-children-1-enumerateslice(system-int32-system-int32)"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| index | [Int32](https://learn.microsoft.com/en-gb/dotnet/api/System.Int32) | The zero-based index at which the range starts. |
+| count | [Int32](https://learn.microsoft.com/en-gb/dotnet/api/System.Int32) | The number of nodes in the range. |
+
+## Returns {id="returns-mrkwatkins-ast-children-1-enumerateslice(system-int32-system-int32)"}
+
+[IEnumerable&lt;TNode&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.Collections.Generic.IEnumerable-1)
+
+A lazy enumeration of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md).
+## EnumerateSlice(Range) {id="mrkwatkins-ast-children-1-enumerateslice(system-range)"}
+
+Returns a lazy enumeration of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md).
+
+```c#
+public IEnumerable<TNode> EnumerateSlice(Range range);
+```
+
+## Parameters {id="parameters-mrkwatkins-ast-children-1-enumerateslice(system-range)"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| range | [Range](https://learn.microsoft.com/en-gb/dotnet/api/System.Range) | The [Range](https://learn.microsoft.com/en-gb/dotnet/api/System.Range). |
+
+## Returns {id="returns-mrkwatkins-ast-children-1-enumerateslice(system-range)"}
+
+[IEnumerable&lt;TNode&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.Collections.Generic.IEnumerable-1)
+
+A lazy enumeration of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md).

doc/topics/API/MrKWatkins.Ast.Children-1.Replace.md

@@ -1,7 +1,7 @@
 # Children<TNode>.Replace Method
 ## Definition
 
-Replaces a node in the collection with another node. The replacement will be removed from its parent and the node being replaced will have it's parent removed.
+Replaces a node in the collection with another node. The replacement will be removed from its parent and the node being replaced will have its parent removed.
 
 ```c#
 public void Replace(TNode child, TNode replacement);

doc/topics/API/MrKWatkins.Ast.Children-1.Slice.md

@@ -0,0 +1,21 @@
+# Children<TNode>.Slice Method
+## Definition
+
+Creates a shallow copy of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md).
+
+```c#
+public TNode[] Slice(int index, int count);
+```
+
+## Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| index | [Int32](https://learn.microsoft.com/en-gb/dotnet/api/System.Int32) | The zero-based index at which the range starts. |
+| count | [Int32](https://learn.microsoft.com/en-gb/dotnet/api/System.Int32) | The number of nodes in the range. |
+
+## Returns
+
+TNode\[\]
+
+A shallow copy of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md).

doc/topics/API/MrKWatkins.Ast.Children-1.UnsafeSlice.md

@@ -0,0 +1,47 @@
+# Children<TNode>.UnsafeSlice Method
+## Overloads
+
+| Name | Description |
+| ---- | ----------- |
+| [UnsafeSlice(Int32, Int32)](MrKWatkins.Ast.Children-1.UnsafeSlice.md#mrkwatkins-ast-children-1-unsafeslice(system-int32-system-int32)) | Returns a [ReadOnlySpan<T>](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md). Nodes should not be added or removed from the [Children<TNode>](MrKWatkins.Ast.Children-1.md) while the [ReadOnlySpan<T>](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) is in use. |
+| [UnsafeSlice(Range)](MrKWatkins.Ast.Children-1.UnsafeSlice.md#mrkwatkins-ast-children-1-unsafeslice(system-range)) | Returns a [ReadOnlySpan<T>](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md). Nodes should not be added or removed from the [Children<TNode>](MrKWatkins.Ast.Children-1.md) while the [ReadOnlySpan<T>](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) is in use. |
+
+## UnsafeSlice(Int32, Int32) {id="mrkwatkins-ast-children-1-unsafeslice(system-int32-system-int32)"}
+
+Returns a [ReadOnlySpan<T>](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children<TNode>](MrKWatkins.Ast.Children-1.md). Nodes should not be added or removed from the [Children<TNode>](MrKWatkins.Ast.Children-1.md) while the [ReadOnlySpan<T>](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) is in use.
+
+```c#
+public ReadOnlySpan<TNode> UnsafeSlice(int index, int count);
+```
+
+## Parameters {id="parameters-mrkwatkins-ast-children-1-unsafeslice(system-int32-system-int32)"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| index | [Int32](https://learn.microsoft.com/en-gb/dotnet/api/System.Int32) | The zero-based index at which the range starts. |
+| count | [Int32](https://learn.microsoft.com/en-gb/dotnet/api/System.Int32) | The number of nodes in the range. |
+
+## Returns {id="returns-mrkwatkins-ast-children-1-unsafeslice(system-int32-system-int32)"}
+
+[ReadOnlySpan&lt;TNode&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1)
+
+A [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md).
+## UnsafeSlice(Range) {id="mrkwatkins-ast-children-1-unsafeslice(system-range)"}
+
+Returns a [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md). Nodes should not be added or removed from the [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md) while the [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) is in use.
+
+```c#
+public ReadOnlySpan<TNode> UnsafeSlice(Range range);
+```
+
+## Parameters {id="parameters-mrkwatkins-ast-children-1-unsafeslice(system-range)"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| range | [Range](https://learn.microsoft.com/en-gb/dotnet/api/System.Range) | The [Range](https://learn.microsoft.com/en-gb/dotnet/api/System.Range). |
+
+## Returns {id="returns-mrkwatkins-ast-children-1-unsafeslice(system-range)"}
+
+[ReadOnlySpan&lt;TNode&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1)
+
+A [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md).

doc/topics/API/MrKWatkins.Ast.Children-1.md

@@ -38,6 +38,8 @@ public sealed class Children<TNode> : IList<TNode>, ICollection<TNode>, IEnumera
 | [Add(TNode\[\])](MrKWatkins.Ast.Children-1.Add.md#mrkwatkins-ast-children-1-add(-0())) | Adds nodes to the collection and assigns their [Parent](MrKWatkins.Ast.Node-1.Parent.md) properties. |
 | [Clear()](MrKWatkins.Ast.Children-1.Clear.md) | Removes all nodes from the collection and resets their [Parent](MrKWatkins.Ast.Node-1.Parent.md) properties to `null`. |
 | [Contains(TNode)](MrKWatkins.Ast.Children-1.Contains.md) | Determines if the specified node is in the collection or not. |
+| [EnumerateSlice(Int32, Int32)](MrKWatkins.Ast.Children-1.EnumerateSlice.md#mrkwatkins-ast-children-1-enumerateslice(system-int32-system-int32)) | Returns a lazy enumeration of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md). |
+| [EnumerateSlice(Range)](MrKWatkins.Ast.Children-1.EnumerateSlice.md#mrkwatkins-ast-children-1-enumerateslice(system-range)) | Returns a lazy enumeration of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md). |
 | [ExceptOfType&lt;TChild&gt;()](MrKWatkins.Ast.Children-1.ExceptOfType.md) | Lazily enumerates over all nodes in this collection not of the specified type. |
 | [FirstIfTypeOrDefault&lt;TChild&gt;(TChild)](MrKWatkins.Ast.Children-1.FirstIfTypeOrDefault.md) | Returns the first node in the collection if it is of the specified type or a specified default if the collection is empty or the first node is a different type. |
 | [FirstOfType&lt;TChild&gt;()](MrKWatkins.Ast.Children-1.FirstOfType.md) | Returns the first node in the collection of the specified type or throws otherwise. |
@@ -54,8 +56,11 @@ public sealed class Children<TNode> : IList<TNode>, ICollection<TNode>, IEnumera
 | [OfType&lt;TChild&gt;()](MrKWatkins.Ast.Children-1.OfType.md) | Lazily enumerates over all nodes in this collection of the specified type. |
 | [Remove(TNode)](MrKWatkins.Ast.Children-1.Remove.md) | Tries to remove a node from the collection and reset its [Parent](MrKWatkins.Ast.Node-1.Parent.md) property to `null`. |
 | [RemoveAt(Int32)](MrKWatkins.Ast.Children-1.RemoveAt.md) | Removes the node at the specified position from the collection and reset its [Parent](MrKWatkins.Ast.Node-1.Parent.md) property to `null`. |
-| [Replace(TNode, TNode)](MrKWatkins.Ast.Children-1.Replace.md) | Replaces a node in the collection with another node. The replacement will be removed from its parent and the node being replaced will have it&#39;s parent removed. |
+| [Replace(TNode, TNode)](MrKWatkins.Ast.Children-1.Replace.md) | Replaces a node in the collection with another node. The replacement will be removed from its parent and the node being replaced will have its parent removed. |
 | [SingleOfType&lt;TChild&gt;()](MrKWatkins.Ast.Children-1.SingleOfType.md) | Returns the only node in the collection of the specified type. Throws if there is not exactly one node in the collection of the specified type. |
 | [SingleOfTypeOrDefault&lt;TChild&gt;(TChild)](MrKWatkins.Ast.Children-1.SingleOfTypeOrDefault.md) | Returns the only node in the collection of the specified type. Returns the specified default if there are no nodes in the collection of the specified type. Throws if there are multiple nodes in the collection of the specified type. |
+| [Slice(Int32, Int32)](MrKWatkins.Ast.Children-1.Slice.md) | Creates a shallow copy of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md). |
 | [UnsafeGet(Int32)](MrKWatkins.Ast.Children-1.UnsafeGet.md) | Gets the child at the specified index in the collection without array bounds checks. For high performance scenarios. WARNING: Do not use unless you are certain of the number of children! |
+| [UnsafeSlice(Int32, Int32)](MrKWatkins.Ast.Children-1.UnsafeSlice.md#mrkwatkins-ast-children-1-unsafeslice(system-int32-system-int32)) | Returns a [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md). Nodes should not be added or removed from the [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md) while the [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) is in use. |
+| [UnsafeSlice(Range)](MrKWatkins.Ast.Children-1.UnsafeSlice.md#mrkwatkins-ast-children-1-unsafeslice(system-range)) | Returns a [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) of a range of nodes in the source [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md). Nodes should not be added or removed from the [Children&lt;TNode&gt;](MrKWatkins.Ast.Children-1.md) while the [ReadOnlySpan&lt;T&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.ReadOnlySpan-1) is in use. |
 

doc/topics/API/MrKWatkins.Ast.MessageFormatter.md

@@ -4,7 +4,7 @@
 Utility methods to format [Messages](MrKWatkins.Ast.Message.md) as strings. Formatting optionally includes the original source code.
 
 ```c#
-public abstract sealed class MessageFormatter
+public static class MessageFormatter
 ```
 
 ## Methods

examples/Directory.Build.props

@@ -22,10 +22,6 @@
     </ItemGroup>
 
     <ItemGroup Condition="$(MSBuildProjectName.EndsWith('Tests'))">
-        <PackageReference Include="coverlet.collector">
-            <PrivateAssets>all</PrivateAssets>
-            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-        </PackageReference>
         <PackageReference Include="FluentAssertions"/>
         <PackageReference Include="Microsoft.NET.Test.Sdk"/>
         <PackageReference Include="NUnit"/>

examples/Directory.Packages.props

@@ -5,11 +5,10 @@
         <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
     </PropertyGroup>
     <ItemGroup>
-        <PackageVersion Include="coverlet.collector" Version="6.0.2"/>
         <PackageVersion Include="FluentAssertions" Version="7.0.0"/>
         <PackageVersion Include="JetBrains.Annotations" Version="2024.3.0"/>
         <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.12.0"/>
-        <PackageVersion Include="NUnit" Version="4.3.0"/>
+        <PackageVersion Include="NUnit" Version="4.3.1"/>
         <PackageVersion Include="NUnit3TestAdapter" Version="4.6.0"/>
     </ItemGroup>
 </Project>