From 6d52b103b09d2694ea71ee1f547780850a2c17e4 Mon Sep 17 00:00:00 2001
From: Jason Barden <jason.barden@outlook.com>
Date: Tue, 29 Apr 2025 15:42:18 +0100
Subject: [PATCH 1/6] Initial Code Migration

---
 .dockerignore                                 |  25 +++
 .github/dependabot.yml                        |   6 +
 .github/workflows/dotnet.yml                  |  67 ++++++++
 .idea/.gitignore                              |  13 ++
 .../.idea/.gitignore                          |  13 ++
 .../.idea/.name                               |   1 +
 .../.idea/indexLayout.xml                     |   8 +
 .../.idea/vcs.xml                             |   6 +
 .idea/indexLayout.xml                         |   8 +
 .idea/vcs.xml                                 |   6 +
 AStar.Dev.Functional.Extensions.sln           |  36 +++++
 AStar.ico                                     | Bin 0 -> 11562 bytes
 AStar.png                                     | Bin 0 -> 12513 bytes
 build-and-test.ps1                            |   3 +
 .../AStar.Dev.Functional.Extensions.csproj    |  51 ++++++
 .../AStar.Dev.Functional.Extensions.xml       | 148 ++++++++++++++++++
 src/AStar.Dev.Functional.Extensions/AStar.ico | Bin 0 -> 11562 bytes
 src/AStar.Dev.Functional.Extensions/AStar.png | Bin 0 -> 12513 bytes
 .../EnumerableExtensions.cs                   |  20 +++
 src/AStar.Dev.Functional.Extensions/LICENSE   |  21 +++
 src/AStar.Dev.Functional.Extensions/None.cs   |  22 +++
 .../None{T}.cs                                |  17 ++
 src/AStar.Dev.Functional.Extensions/Option.cs |  20 +++
 .../OptionExtensions.cs                       |  53 +++++++
 .../Option{T}.cs                              |  25 +++
 src/AStar.Dev.Functional.Extensions/Readme.md |   1 +
 src/AStar.Dev.Functional.Extensions/Some.cs   |  28 ++++
 ...ev.Functional.Extensions.Tests.Unit.csproj |  51 ++++++
 .../EnumerableExtensionsShould.cs             |  23 +++
 .../GenericNoneShould.cs                      |  13 ++
 .../MockClass.cs                              |  16 ++
 .../NoneShould.cs                             |  19 +++
 .../OptionExtensionsShould.cs                 |  87 ++++++++++
 .../OptionShould.cs                           |  19 +++
 .../SomeShould.cs                             |  39 +++++
 35 files changed, 865 insertions(+)
 create mode 100644 .dockerignore
 create mode 100644 .github/dependabot.yml
 create mode 100644 .github/workflows/dotnet.yml
 create mode 100644 .idea/.gitignore
 create mode 100644 .idea/.idea.AStar.Dev.Functional.Extensions/.idea/.gitignore
 create mode 100644 .idea/.idea.AStar.Dev.Functional.Extensions/.idea/.name
 create mode 100644 .idea/.idea.AStar.Dev.Functional.Extensions/.idea/indexLayout.xml
 create mode 100644 .idea/.idea.AStar.Dev.Functional.Extensions/.idea/vcs.xml
 create mode 100644 .idea/indexLayout.xml
 create mode 100644 .idea/vcs.xml
 create mode 100644 AStar.Dev.Functional.Extensions.sln
 create mode 100644 AStar.ico
 create mode 100644 AStar.png
 create mode 100644 build-and-test.ps1
 create mode 100644 src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.csproj
 create mode 100644 src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.xml
 create mode 100644 src/AStar.Dev.Functional.Extensions/AStar.ico
 create mode 100644 src/AStar.Dev.Functional.Extensions/AStar.png
 create mode 100644 src/AStar.Dev.Functional.Extensions/EnumerableExtensions.cs
 create mode 100644 src/AStar.Dev.Functional.Extensions/LICENSE
 create mode 100644 src/AStar.Dev.Functional.Extensions/None.cs
 create mode 100644 src/AStar.Dev.Functional.Extensions/None{T}.cs
 create mode 100644 src/AStar.Dev.Functional.Extensions/Option.cs
 create mode 100644 src/AStar.Dev.Functional.Extensions/OptionExtensions.cs
 create mode 100644 src/AStar.Dev.Functional.Extensions/Option{T}.cs
 create mode 100644 src/AStar.Dev.Functional.Extensions/Readme.md
 create mode 100644 src/AStar.Dev.Functional.Extensions/Some.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/AStar.Dev.Functional.Extensions.Tests.Unit.csproj
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/EnumerableExtensionsShould.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/GenericNoneShould.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/MockClass.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/NoneShould.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionExtensionsShould.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionShould.cs
 create mode 100644 test/AStar.Dev.Functional.Extensions.Tests.Unit/SomeShould.cs

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..cd967fc
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,25 @@
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/.idea
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/azds.yaml
+**/bin
+**/charts
+**/docker-compose*
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+LICENSE
+README.md
\ No newline at end of file
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..446b951
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "nuget"
+    directory: "/"
+    schedule:
+      interval: "weekly"
diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
new file mode 100644
index 0000000..c88980a
--- /dev/null
+++ b/.github/workflows/dotnet.yml
@@ -0,0 +1,67 @@
+name: .NET
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    name: Build and analyze
+    runs-on: windows-latest
+    steps:
+      - name: Set up JDK
+        uses: actions/setup-java@v4.4.0
+        with:
+          java-version: 17
+          distribution: 'zulu'
+
+      - name: Checkout
+        uses: actions/checkout@v4.2.1
+        with:
+          fetch-depth: 0
+
+      - name: Cache SonarCloud packages
+        uses: actions/cache@v4.2.3
+        with:
+          path: ~\sonar\cache
+          key: ${{ runner.os }}-sonar
+          restore-keys: ${{ runner.os }}-sonar
+
+      - name: Cache SonarCloud scanner
+        id: cache-sonar-scanner
+        uses: actions/cache@v4.2.3
+        with:
+          path: .\.sonar\scanner
+          key: ${{ runner.os }}-sonar-scanner
+          restore-keys: ${{ runner.os }}-sonar-scanner
+
+      - name: Install SonarCloud scanner
+        if: steps.cache-sonar-scanner.outputs.cache-hit != 'true'
+        shell: powershell
+        run: |
+          New-Item -Path .\.sonar\scanner -ItemType Directory
+          dotnet tool update dotnet-sonarscanner --tool-path .\.sonar\scanner
+
+      - name: Build and analyze
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+        shell: powershell
+        run: |
+          dotnet tool install --global dotnet-coverage
+          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_astar-dev-utilities" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host.url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml
+          dotnet build --configuration Release
+          dotnet-coverage collect 'dotnet test --filter "FullyQualifiedName!~Acceptance.Tests"' -f xml -o 'coverage.xml'
+          .\.sonar\scanner\dotnet-sonarscanner end /d:sonar.token="${{ secrets.SONAR_TOKEN }}"
+
+      - name: Pack NuGet package
+        if: github.ref == 'refs/heads/main'
+        run: dotnet pack .\src\AStar.Dev.Utilities\AStar.Dev.Utilities.csproj
+
+      - name: Push to NuGet
+        if: github.ref == 'refs/heads/main'
+        run: dotnet nuget push "**\AStar.Dev.Utilities.*.nupkg" --api-key ${{secrets.nuget_api_key}} --skip-duplicate --source https://api.nuget.org/v3/index.json
+
diff --git a/.idea/.gitignore b/.idea/.gitignore
new file mode 100644
index 0000000..2182218
--- /dev/null
+++ b/.idea/.gitignore
@@ -0,0 +1,13 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Rider ignored files
+/contentModel.xml
+/projectSettingsUpdater.xml
+/.idea.astar-dev-functional-extensions.iml
+/modules.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
diff --git a/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/.gitignore b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/.gitignore
new file mode 100644
index 0000000..de8bd97
--- /dev/null
+++ b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/.gitignore
@@ -0,0 +1,13 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Rider ignored files
+/contentModel.xml
+/.idea.AStar.Dev.Functional.Extensions.iml
+/projectSettingsUpdater.xml
+/modules.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
diff --git a/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/.name b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/.name
new file mode 100644
index 0000000..be440be
--- /dev/null
+++ b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/.name
@@ -0,0 +1 @@
+AStar.Dev.Functional.Extensions
\ No newline at end of file
diff --git a/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/indexLayout.xml b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/indexLayout.xml
new file mode 100644
index 0000000..7b08163
--- /dev/null
+++ b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/indexLayout.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="UserContentModel">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/vcs.xml b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/vcs.xml
new file mode 100644
index 0000000..35eb1dd
--- /dev/null
+++ b/.idea/.idea.AStar.Dev.Functional.Extensions/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/indexLayout.xml b/.idea/indexLayout.xml
new file mode 100644
index 0000000..7b08163
--- /dev/null
+++ b/.idea/indexLayout.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="UserContentModel">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
new file mode 100644
index 0000000..94a25f7
--- /dev/null
+++ b/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/AStar.Dev.Functional.Extensions.sln b/AStar.Dev.Functional.Extensions.sln
new file mode 100644
index 0000000..60a1881
--- /dev/null
+++ b/AStar.Dev.Functional.Extensions.sln
@@ -0,0 +1,36 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{8456212E-F453-483A-8E27-7494722AE10F}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{3C168EA0-2CFB-490A-8E3A-BE08F456DD3F}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AStar.Dev.Functional.Extensions", "src\AStar.Dev.Functional.Extensions\AStar.Dev.Functional.Extensions.csproj", "{3FC5E2DB-6C2C-4D72-8498-39A121722334}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AStar.Dev.Functional.Extensions.Tests.Unit", "test\AStar.Dev.Functional.Extensions.Tests.Unit\AStar.Dev.Functional.Extensions.Tests.Unit.csproj", "{F61660A7-160E-4654-94A5-F8D5D75FFBD6}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{3FC5E2DB-6C2C-4D72-8498-39A121722334} = {8456212E-F453-483A-8E27-7494722AE10F}
+		{F61660A7-160E-4654-94A5-F8D5D75FFBD6} = {3C168EA0-2CFB-490A-8E3A-BE08F456DD3F}
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{3FC5E2DB-6C2C-4D72-8498-39A121722334}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3FC5E2DB-6C2C-4D72-8498-39A121722334}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3FC5E2DB-6C2C-4D72-8498-39A121722334}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3FC5E2DB-6C2C-4D72-8498-39A121722334}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F61660A7-160E-4654-94A5-F8D5D75FFBD6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F61660A7-160E-4654-94A5-F8D5D75FFBD6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F61660A7-160E-4654-94A5-F8D5D75FFBD6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F61660A7-160E-4654-94A5-F8D5D75FFBD6}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+EndGlobal
diff --git a/AStar.ico b/AStar.ico
new file mode 100644
index 0000000000000000000000000000000000000000..0b9aea493d206b4ce2c3a43915458e568ca18ec4
GIT binary patch
literal 11562
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

literal 0
HcmV?d00001

diff --git a/AStar.png b/AStar.png
new file mode 100644
index 0000000000000000000000000000000000000000..8cac0a1d8136c82d5b582bdea30f24bf2e085e0f
GIT binary patch
literal 12513
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
MOs&qBpL2=*KT7L~lmGw#

literal 0
HcmV?d00001

diff --git a/build-and-test.ps1 b/build-and-test.ps1
new file mode 100644
index 0000000..aad68a7
--- /dev/null
+++ b/build-and-test.ps1
@@ -0,0 +1,3 @@
+dotnet build
+dotnet test
+dotnet stryker --open-report --break-at 99
\ No newline at end of file
diff --git a/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.csproj b/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.csproj
new file mode 100644
index 0000000..1ea161b
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.csproj
@@ -0,0 +1,51 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <AnalysisLevel>latest-recommended</AnalysisLevel>
+        <Authors>AStar Developement, Jason Barden</Authors>
+        <Company>AStar Development</Company>
+        <Copyright>AStar Developement, 2025</Copyright>
+        <Description>AStar.Dev.Functional.Extensions package contains some basic implementations of Option, Some and None. This list may expand over time.</Description>
+        <DocumentationFile>$(AssemblyName).xml</DocumentationFile>
+        <EnforceCodeStyleInBuild>True</EnforceCodeStyleInBuild>
+        <GenerateDocumentationFile>True</GenerateDocumentationFile>
+        <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <IncludeSymbols>True</IncludeSymbols>
+        <IsPackable>true</IsPackable>
+        <Nullable>enable</Nullable>
+        <PackageIcon>AStar.png</PackageIcon>
+        <PackageLicenseFile>LICENSE</PackageLicenseFile>
+        <PackageProjectUrl>https://github.com/astar-development/astar-dev-functional-extensions/</PackageProjectUrl>
+        <PackageReadmeFile>Readme.md</PackageReadmeFile>
+        <PackageReleaseNotes>Update.</PackageReleaseNotes>
+        <PackageRequireLicenseAcceptance>True</PackageRequireLicenseAcceptance>
+        <RepositoryType>git</RepositoryType>
+        <RepositoryUrl>https://github.com/astar-development/astar-dev-functional-extensions.git</RepositoryUrl>
+        <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+        <TargetFramework>net9.0</TargetFramework>
+        <Title>AStar.Dev.Functional.Extensions</Title>
+        <Version>0.1.0</Version>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="AStar.Dev.Technical.Debt.Reporting" Version="0.1.0"/>
+    </ItemGroup>
+
+    <ItemGroup>
+        <None Include="LICENSE" Pack="true" PackagePath=""/>
+        <None Include="Readme.md" Pack="true" PackagePath=""/>
+        <None Include="AStar.png" Pack="true" PackagePath=""/>
+    </ItemGroup>
+
+    <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
+        <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
+        <NoWarn>1701;1702;</NoWarn>
+    </PropertyGroup>
+
+    <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
+        <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
+        <NoWarn>1701;1702;</NoWarn>
+    </PropertyGroup>
+
+</Project>
diff --git a/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.xml b/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.xml
new file mode 100644
index 0000000..034a31a
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.xml
@@ -0,0 +1,148 @@
+<?xml version="1.0"?>
+<doc>
+    <assembly>
+        <name>AStar.Dev.Functional.Extensions</name>
+    </assembly>
+    <members>
+        <member name="T:AStar.Dev.Functional.Extensions.EnumerableExtensions">
+            <summary>
+            </summary>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.EnumerableExtensions.FirstOrNone``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})">
+            <summary>
+            </summary>
+            <typeparam name="T"></typeparam>
+            <param name="sequence"></param>
+            <param name="predicate"></param>
+            <returns></returns>
+        </member>
+        <member name="T:AStar.Dev.Functional.Extensions.None">
+            <summary>
+                The <see cref="T:AStar.Dev.Functional.Extensions.None" /> class that exists for when we have no object
+            </summary>
+        </member>
+        <member name="P:AStar.Dev.Functional.Extensions.None.Value">
+            <summary>
+                The Value will always return an instance of <see cref="T:AStar.Dev.Functional.Extensions.None" />, it can never return an actual value
+            </summary>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.None.Of``1">
+            <summary>
+                The Of{T} method can be used to return an instance of the generic <see cref="T:AStar.Dev.Functional.Extensions.None`1" /> when there is no actual value to return
+            </summary>
+            <typeparam name="T">The type of the original object that this instance of <see cref="T:AStar.Dev.Functional.Extensions.None" /> is replacing</typeparam>
+            <returns>The appropriate type of <see cref="T:AStar.Dev.Functional.Extensions.None`1" /></returns>
+        </member>
+        <member name="T:AStar.Dev.Functional.Extensions.None`1">
+            <summary>
+                The <see cref="T:AStar.Dev.Functional.Extensions.None`1" /> class replaces the object when there is no object available
+            </summary>
+            <typeparam name="T">The type of the original object</typeparam>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.None`1.ToString">
+            <summary>
+                The ToString method is overridden to always return "None"
+            </summary>
+            <returns>"None" no matter what the original type was</returns>
+        </member>
+        <member name="T:AStar.Dev.Functional.Extensions.Option">
+            <summary>
+                The <see cref="T:AStar.Dev.Functional.Extensions.Option" /> class that contains the original object
+            </summary>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.Option.Optional``1(``0)">
+            <summary>
+                The Optional method will convert the 'raw' object to an <see cref="T:AStar.Dev.Functional.Extensions.Option`1" />
+            </summary>
+            <typeparam name="T">The type of the original object</typeparam>
+            <param name="obj">The object to return as an option</param>
+            <returns>The original object as an option (and implemented as an instance of <see cref="T:AStar.Dev.Functional.Extensions.Some`1" /></returns>
+        </member>
+        <member name="T:AStar.Dev.Functional.Extensions.OptionExtensions">
+            <summary>
+                The <see cref="T:AStar.Dev.Functional.Extensions.OptionExtensions" /> class contains a basic set of extension methods to help map, filter, etc. the original object
+            </summary>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.OptionExtensions.Map``2(AStar.Dev.Functional.Extensions.Option{``0},System.Func{``0,``1})">
+            <summary>
+                The Map{T,TResult} method will either map the Some{T} to a new Some or return a new None of the specified result type
+            </summary>
+            <typeparam name="T">The type of the source object</typeparam>
+            <typeparam name="TResult">The type of object expected from the map</typeparam>
+            <param name="obj">The object to map</param>
+            <param name="map">The Map function</param>
+            <returns>Either a new Some or a new None of the specified type</returns>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.OptionExtensions.Filter``1(AStar.Dev.Functional.Extensions.Option{``0},System.Func{``0,System.Boolean})">
+            <summary>
+            </summary>
+            <typeparam name="T"></typeparam>
+            <param name="obj"></param>
+            <param name="predicate"></param>
+            <returns></returns>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.OptionExtensions.Reduce``1(AStar.Dev.Functional.Extensions.Option{``0},``0)">
+            <summary>
+            </summary>
+            <typeparam name="T"></typeparam>
+            <param name="obj"></param>
+            <param name="substitute"></param>
+            <returns></returns>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.OptionExtensions.Reduce``1(AStar.Dev.Functional.Extensions.Option{``0},System.Func{``0})">
+            <summary>
+            </summary>
+            <typeparam name="T"></typeparam>
+            <param name="obj"></param>
+            <param name="substitute"></param>
+            <returns></returns>
+        </member>
+        <member name="T:AStar.Dev.Functional.Extensions.Option`1">
+            <summary>
+            </summary>
+            <typeparam name="T"></typeparam>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.Option`1.op_Implicit(AStar.Dev.Functional.Extensions.None)~AStar.Dev.Functional.Extensions.Option{`0}">
+            <summary>
+            </summary>
+            <param name="_"></param>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.Option`1.op_Implicit(`0)~AStar.Dev.Functional.Extensions.Option{`0}">
+            <summary>
+            </summary>
+            <param name="value"></param>
+        </member>
+        <member name="T:AStar.Dev.Functional.Extensions.Some`1">
+            <summary>
+                The generic <see cref="T:AStar.Dev.Functional.Extensions.Some`1" /> class contains the result for a successful method
+            </summary>
+            <typeparam name="T">The type of the return object</typeparam>
+            <remarks>
+            </remarks>
+            <param name="content">The content (actual result) object</param>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.Some`1.#ctor(`0)">
+            <summary>
+                The generic <see cref="T:AStar.Dev.Functional.Extensions.Some`1" /> class contains the result for a successful method
+            </summary>
+            <typeparam name="T">The type of the return object</typeparam>
+            <remarks>
+            </remarks>
+            <param name="content">The content (actual result) object</param>
+        </member>
+        <member name="P:AStar.Dev.Functional.Extensions.Some`1.Content">
+            <summary>
+                The content (actual result) object
+            </summary>
+        </member>
+        <member name="M:AStar.Dev.Functional.Extensions.Some`1.ToString">
+            <summary>
+                Overrides the default ToString to return the object type or &lt;null&gt;
+            </summary>
+            <remarks>
+                Once the ToJson method (in AStar.Dev.Utilities) respects the 'Mask', 'Ignore' etc. attributes, we can reconsider whether this method returns the actual object
+            </remarks>
+            <returns>The object type name or null.</returns>
+        </member>
+    </members>
+</doc>
diff --git a/src/AStar.Dev.Functional.Extensions/AStar.ico b/src/AStar.Dev.Functional.Extensions/AStar.ico
new file mode 100644
index 0000000000000000000000000000000000000000..0b9aea493d206b4ce2c3a43915458e568ca18ec4
GIT binary patch
literal 11562
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

literal 0
HcmV?d00001

diff --git a/src/AStar.Dev.Functional.Extensions/AStar.png b/src/AStar.Dev.Functional.Extensions/AStar.png
new file mode 100644
index 0000000000000000000000000000000000000000..8cac0a1d8136c82d5b582bdea30f24bf2e085e0f
GIT binary patch
literal 12513
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
MOs&qBpL2=*KT7L~lmGw#

literal 0
HcmV?d00001

diff --git a/src/AStar.Dev.Functional.Extensions/EnumerableExtensions.cs b/src/AStar.Dev.Functional.Extensions/EnumerableExtensions.cs
new file mode 100644
index 0000000..9c97003
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/EnumerableExtensions.cs
@@ -0,0 +1,20 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+/// </summary>
+public static class EnumerableExtensions
+{
+    /// <summary>
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    /// <param name="sequence"></param>
+    /// <param name="predicate"></param>
+    /// <returns></returns>
+    public static Option<T> FirstOrNone<T>(this IEnumerable<T> sequence, Func<T, bool> predicate)
+    {
+        return sequence.Where(predicate)
+                       .Select<T, Option<T>>(x => x)
+                       .DefaultIfEmpty(None.Value)
+                       .First();
+    }
+}
diff --git a/src/AStar.Dev.Functional.Extensions/LICENSE b/src/AStar.Dev.Functional.Extensions/LICENSE
new file mode 100644
index 0000000..0b1b024
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AStar Development, Jason Barden
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/src/AStar.Dev.Functional.Extensions/None.cs b/src/AStar.Dev.Functional.Extensions/None.cs
new file mode 100644
index 0000000..ae933a4
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/None.cs
@@ -0,0 +1,22 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+///     The <see cref="None" /> class that exists for when we have no object
+/// </summary>
+public sealed class None
+{
+    /// <summary>
+    ///     The Value will always return an instance of <see cref="None" />, it can never return an actual value
+    /// </summary>
+    public static None Value { get; } = new();
+
+    /// <summary>
+    ///     The Of{T} method can be used to return an instance of the generic <see cref="None{T}" /> when there is no actual value to return
+    /// </summary>
+    /// <typeparam name="T">The type of the original object that this instance of <see cref="None" /> is replacing</typeparam>
+    /// <returns>The appropriate type of <see cref="None{T}" /></returns>
+    public static None<T> Of<T>()
+    {
+        return new();
+    }
+}
diff --git a/src/AStar.Dev.Functional.Extensions/None{T}.cs b/src/AStar.Dev.Functional.Extensions/None{T}.cs
new file mode 100644
index 0000000..120e54d
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/None{T}.cs
@@ -0,0 +1,17 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+///     The <see cref="None{T}" /> class replaces the object when there is no object available
+/// </summary>
+/// <typeparam name="T">The type of the original object</typeparam>
+public sealed class None<T> : Option<T>
+{
+    /// <summary>
+    ///     The ToString method is overridden to always return "None"
+    /// </summary>
+    /// <returns>"None" no matter what the original type was</returns>
+    public override string ToString()
+    {
+        return "None";
+    }
+}
diff --git a/src/AStar.Dev.Functional.Extensions/Option.cs b/src/AStar.Dev.Functional.Extensions/Option.cs
new file mode 100644
index 0000000..b3cbb4b
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/Option.cs
@@ -0,0 +1,20 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+///     The <see cref="Option" /> class that contains the original object
+/// </summary>
+#pragma warning disable CA1716 // Rename type Option so that it no longer conflicts with the reserved language keyword 'Option'
+public static class Option
+#pragma warning restore CA1716
+{
+    /// <summary>
+    ///     The Optional method will convert the 'raw' object to an <see cref="Option{T}" />
+    /// </summary>
+    /// <typeparam name="T">The type of the original object</typeparam>
+    /// <param name="obj">The object to return as an option</param>
+    /// <returns>The original object as an option (and implemented as an instance of <see cref="Some{T}" /></returns>
+    public static Option<T> Optional<T>(this T obj)
+    {
+        return new Some<T>(obj);
+    }
+}
diff --git a/src/AStar.Dev.Functional.Extensions/OptionExtensions.cs b/src/AStar.Dev.Functional.Extensions/OptionExtensions.cs
new file mode 100644
index 0000000..5c3b401
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/OptionExtensions.cs
@@ -0,0 +1,53 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+///     The <see cref="OptionExtensions" /> class contains a basic set of extension methods to help map, filter, etc. the original object
+/// </summary>
+public static class OptionExtensions
+{
+    /// <summary>
+    ///     The Map{T,TResult} method will either map the Some{T} to a new Some or return a new None of the specified result type
+    /// </summary>
+    /// <typeparam name="T">The type of the source object</typeparam>
+    /// <typeparam name="TResult">The type of object expected from the map</typeparam>
+    /// <param name="obj">The object to map</param>
+    /// <param name="map">The Map function</param>
+    /// <returns>Either a new Some or a new None of the specified type</returns>
+    public static Option<TResult> Map<T, TResult>(this Option<T> obj, Func<T, TResult> map)
+    {
+        return obj is Some<T> some ? new Some<TResult>(map(some.Content)) : new None<TResult>();
+    }
+
+    /// <summary>
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    /// <param name="obj"></param>
+    /// <param name="predicate"></param>
+    /// <returns></returns>
+    public static Option<T> Filter<T>(this Option<T> obj, Func<T, bool> predicate)
+    {
+        return obj is Some<T> some && !predicate(some.Content) ? new None<T>() : obj;
+    }
+
+    /// <summary>
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    /// <param name="obj"></param>
+    /// <param name="substitute"></param>
+    /// <returns></returns>
+    public static T Reduce<T>(this Option<T> obj, T substitute)
+    {
+        return obj is Some<T> some ? some.Content : substitute;
+    }
+
+    /// <summary>
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    /// <param name="obj"></param>
+    /// <param name="substitute"></param>
+    /// <returns></returns>
+    public static T Reduce<T>(this Option<T> obj, Func<T> substitute)
+    {
+        return obj is Some<T> some ? some.Content : substitute();
+    }
+}
diff --git a/src/AStar.Dev.Functional.Extensions/Option{T}.cs b/src/AStar.Dev.Functional.Extensions/Option{T}.cs
new file mode 100644
index 0000000..794828d
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/Option{T}.cs
@@ -0,0 +1,25 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+/// </summary>
+/// <typeparam name="T"></typeparam>
+#pragma warning disable CA1716 // Rename type Option so that it no longer conflicts with the reserved language keyword 'Option'
+public abstract class Option<T>
+#pragma warning restore CA1716
+{
+    /// <summary>
+    /// </summary>
+    /// <param name="_"></param>
+    public static implicit operator Option<T>(None _)
+    {
+        return new None<T>();
+    }
+
+    /// <summary>
+    /// </summary>
+    /// <param name="value"></param>
+    public static implicit operator Option<T>(T value)
+    {
+        return new Some<T>(value);
+    }
+}
diff --git a/src/AStar.Dev.Functional.Extensions/Readme.md b/src/AStar.Dev.Functional.Extensions/Readme.md
new file mode 100644
index 0000000..16dacd1
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/Readme.md
@@ -0,0 +1 @@
+Update
\ No newline at end of file
diff --git a/src/AStar.Dev.Functional.Extensions/Some.cs b/src/AStar.Dev.Functional.Extensions/Some.cs
new file mode 100644
index 0000000..53540f6
--- /dev/null
+++ b/src/AStar.Dev.Functional.Extensions/Some.cs
@@ -0,0 +1,28 @@
+namespace AStar.Dev.Functional.Extensions;
+
+/// <summary>
+///     The generic <see cref="Some{T}" /> class contains the result for a successful method
+/// </summary>
+/// <typeparam name="T">The type of the return object</typeparam>
+/// <remarks>
+/// </remarks>
+/// <param name="content">The content (actual result) object</param>
+public sealed class Some<T>(T content) : Option<T>
+{
+    /// <summary>
+    ///     The content (actual result) object
+    /// </summary>
+    public T Content { get; } = content;
+
+    /// <summary>
+    ///     Overrides the default ToString to return the object type or &lt;null&gt;
+    /// </summary>
+    /// <remarks>
+    ///     Once the ToJson method (in AStar.Dev.Utilities) respects the 'Mask', 'Ignore' etc. attributes, we can reconsider whether this method returns the actual object
+    /// </remarks>
+    /// <returns>The object type name or null.</returns>
+    public override string ToString()
+    {
+        return Content?.ToString() ?? "<null>";
+    }
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/AStar.Dev.Functional.Extensions.Tests.Unit.csproj b/test/AStar.Dev.Functional.Extensions.Tests.Unit/AStar.Dev.Functional.Extensions.Tests.Unit.csproj
new file mode 100644
index 0000000..5556a7d
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/AStar.Dev.Functional.Extensions.Tests.Unit.csproj
@@ -0,0 +1,51 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <TargetFramework>net9.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <IsPackable>false</IsPackable>
+        <RootNamespace>AStar.Dev.Functional.Extensions</RootNamespace>
+        <EnforceCodeStyleInBuild>True</EnforceCodeStyleInBuild>
+        <AnalysisLevel>latest-recommended</AnalysisLevel>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <AssemblyAttribute Include="System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverage"/>
+    </ItemGroup>
+
+    <ItemGroup>
+        <PackageReference Include="coverlet.collector" Version="6.0.4">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="JetBrains.Annotations" Version="2025.1.0-eap1"/>
+        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.13.0"/>
+        <PackageReference Include="Shouldly" Version="4.3.0"/>
+        <PackageReference Include="xunit" Version="2.9.3"/>
+        <PackageReference Include="xunit.runner.visualstudio" Version="3.0.2">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+    </ItemGroup>
+
+    <ItemGroup>
+        <Using Include="Xunit"/>
+        <Using Include="Shouldly"/>
+    </ItemGroup>
+
+    <ItemGroup>
+        <ProjectReference Include="..\..\src\AStar.Dev.Functional.Extensions\AStar.Dev.Functional.Extensions.csproj"/>
+    </ItemGroup>
+
+    <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
+        <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
+        <NoWarn>1701;1702;IDE0058;</NoWarn>
+    </PropertyGroup>
+
+    <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
+        <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
+        <NoWarn>1701;1702;IDE0058;</NoWarn>
+    </PropertyGroup>
+
+</Project>
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/EnumerableExtensionsShould.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/EnumerableExtensionsShould.cs
new file mode 100644
index 0000000..162c82b
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/EnumerableExtensionsShould.cs
@@ -0,0 +1,23 @@
+using JetBrains.Annotations;
+
+namespace AStar.Dev.Functional.Extensions;
+
+[TestSubject(typeof(EnumerableExtensions))]
+public class EnumerableExtensionsShould
+{
+    [Fact]
+    public void ReturnTheExpectedFirstObject()
+    {
+        var list = new List<int> { 1, 2, 3 };
+
+        list.FirstOrNone(i => i == 2).ShouldBeAssignableTo<Some<int>>();
+    }
+
+    [Fact]
+    public void ReturnTheExpectedNoneObject()
+    {
+        var list = new List<int> { 1, 2, 3 };
+
+        list.FirstOrNone(i => i > 3).ShouldBeAssignableTo<None<int>>();
+    }
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/GenericNoneShould.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/GenericNoneShould.cs
new file mode 100644
index 0000000..484b63c
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/GenericNoneShould.cs
@@ -0,0 +1,13 @@
+using JetBrains.Annotations;
+
+namespace AStar.Dev.Functional.Extensions;
+
+[TestSubject(typeof(None<>))]
+public class GenericNoneShould
+{
+    [Fact]
+    public void OverrideToStringAsExpected()
+    {
+        None.Of<int>().ToString().ShouldBe("None");
+    }
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/MockClass.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/MockClass.cs
new file mode 100644
index 0000000..0ed5353
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/MockClass.cs
@@ -0,0 +1,16 @@
+namespace AStar.Dev.Functional.Extensions;
+
+internal sealed class MockClass
+{
+    public string SomeText { get; set; } = "SomeText";
+
+    public static MockClass Create()
+    {
+        return new()  { SomeText = "MockClassCreate" };
+    }
+}
+
+internal sealed class MockClass2
+{
+    public string SomeText { get; set; } = "SomeText";
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/NoneShould.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/NoneShould.cs
new file mode 100644
index 0000000..0e97bd1
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/NoneShould.cs
@@ -0,0 +1,19 @@
+using JetBrains.Annotations;
+
+namespace AStar.Dev.Functional.Extensions;
+
+[TestSubject(typeof(None))]
+public class NoneShould
+{
+    [Fact]
+    public void ReturnNone()
+    {
+        None.Value.ShouldBeAssignableTo<None>();
+    }
+
+    [Fact]
+    public void ReturnNoneOf()
+    {
+        None.Of<int>().ShouldBeAssignableTo<None<int>>();
+    }
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionExtensionsShould.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionExtensionsShould.cs
new file mode 100644
index 0000000..fd0a3a9
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionExtensionsShould.cs
@@ -0,0 +1,87 @@
+using JetBrains.Annotations;
+
+namespace AStar.Dev.Functional.Extensions;
+
+[TestSubject(typeof(OptionExtensions))]
+public class OptionExtensionsShould
+{
+    [Fact]
+    public void MapTheSomeObjectToTheNewSomeObject()
+    {
+        var obj = new Some<MockClass>(new  ());
+
+        var result = obj.Map(mockClass => new MockClass2 { SomeText = mockClass.SomeText });
+
+        result.ShouldBeAssignableTo<Some<MockClass2>>();
+    }
+
+    [Fact]
+    public void MapTheNoneObjectToTheNewNone()
+    {
+        var obj = new None<MockClass>();
+
+        var result = obj.Map(mockClass => new MockClass2 { SomeText = mockClass.SomeText });
+
+        result.ShouldBeAssignableTo<None<MockClass2>>();
+    }
+
+    [Fact]
+    public void FilterTheSomeOptionBasedOnThePredicate()
+    {
+        var list = new List<int> { 1, 2, 3, 4, 5 }.Optional();
+
+        var result = list.Filter(item => item.Contains(1));
+
+        result.ShouldBeAssignableTo<Some<List<int>>>();
+    }
+
+    [Fact]
+    public void FilterTheSomeOptionBasedOnThePredicateToNone()
+    {
+        var list = new List<int> { 1, 2, 3, 4, 5 }.Optional();
+
+        var result = list.Filter(item => item.Contains(1234));
+
+        result.ShouldBeAssignableTo<None<List<int>>>();
+    }
+
+    [Fact]
+    public void ReduceTheSomeContentToContainingType()
+    {
+        var obj = new Some<MockClass>(new  () { SomeText = "SomeText" });
+
+        var result = obj.Reduce(new MockClass { SomeText = "SubstituteSomeText" });
+
+        result.SomeText.ShouldBe("SomeText");
+    }
+
+    [Fact]
+    public void ReduceTheSomeContentToContainingTypeUsingTheSubstituteObject()
+    {
+        var obj = new None<MockClass>();
+
+        var result = obj.Reduce(new MockClass { SomeText = "SubstituteSomeText" });
+
+        result.SomeText.ShouldBe("SubstituteSomeText");
+    }
+
+    [Fact]
+    public void ReduceTheSomeContentToTheContainingType()
+    {
+        var obj = new Some<MockClass>(new  () { SomeText = "SomeText" });
+
+        var result = obj.Reduce(MockClass.Create);
+
+        result.SomeText.ShouldBe("SomeText");
+    }
+
+    [Fact]
+    public void ReduceTheSomeContentToContainingTypeUsingTheSubstituteFunction()
+    {
+        var obj = new None<MockClass>();
+
+        var result = obj.Reduce(MockClass.Create);
+
+        result.SomeText.ShouldBe("MockClassCreate");
+    }
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionShould.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionShould.cs
new file mode 100644
index 0000000..5d79499
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/OptionShould.cs
@@ -0,0 +1,19 @@
+using JetBrains.Annotations;
+
+namespace AStar.Dev.Functional.Extensions;
+
+[TestSubject(typeof(Option))]
+public class OptionShould
+{
+    [Fact]
+    public void ReturnTheSpecifiedObjectAsAnOptionalObject()
+    {
+        new MockClass().Optional().ShouldBeAssignableTo<Option<MockClass>>();
+    }
+
+    [Fact]
+    public void ReturnTheSpecifiedObjectAsAnInstanceOfTheSomeClass()
+    {
+        new MockClass().Optional().ShouldBeAssignableTo<Some<MockClass>>();
+    }
+}
diff --git a/test/AStar.Dev.Functional.Extensions.Tests.Unit/SomeShould.cs b/test/AStar.Dev.Functional.Extensions.Tests.Unit/SomeShould.cs
new file mode 100644
index 0000000..435edb8
--- /dev/null
+++ b/test/AStar.Dev.Functional.Extensions.Tests.Unit/SomeShould.cs
@@ -0,0 +1,39 @@
+using JetBrains.Annotations;
+
+namespace AStar.Dev.Functional.Extensions;
+
+[TestSubject(typeof(Some<>))]
+public class SomeShould
+{
+    [Fact]
+    public void ReturnTheExpectedStringContent()
+    {
+        var sut = new Some<string>("Test");
+
+        sut.Content.ShouldBe("Test");
+    }
+
+    [Fact]
+    public void ReturnTheExpectedMockClassContent()
+    {
+        var sut = new Some<MockClass>(new ());
+
+        sut.Content.ShouldBeEquivalentTo(new MockClass());
+    }
+
+    [Fact]
+    public void ReturnTheExpectedToStringForTheObjectType()
+    {
+        var sut = new Some<MockClass>(new ());
+
+        sut.ToString().ShouldBe("AStar.Dev.Functional.Extensions.MockClass");
+    }
+
+    [Fact]
+    public void ReturnTheExpectedToStringForTheNull()
+    {
+        var sut = new Some<MockClass>(null!);
+
+        sut.ToString().ShouldBe("<null>");
+    }
+}

From cc68930008d95d45995a9cbc9220b65b6e29ee25 Mon Sep 17 00:00:00 2001
From: Jason Barden <jason.barden@outlook.com>
Date: Tue, 29 Apr 2025 15:49:37 +0100
Subject: [PATCH 2/6] Add /d:sonar.scanner.scanAll=false

The above is from the GitHub log
---
 .github/workflows/dotnet.yml        | 10 +++++++---
 AStar.Dev.Functional.Extensions.sln | 11 +++++++++++
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index c88980a..da27bfa 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -11,6 +11,9 @@ jobs:
   build:
     name: Build and analyze
     runs-on: windows-latest
+    env:
+      ProjectName: 'AStar.Dev.Functional.Extensions'
+      RepositoryName: 'astar-dev-functional-extensions'
     steps:
       - name: Set up JDK
         uses: actions/setup-java@v4.4.0
@@ -52,16 +55,17 @@ jobs:
         shell: powershell
         run: |
           dotnet tool install --global dotnet-coverage
-          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_astar-dev-utilities" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host.url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml
+          .\.sonar\scanner\dotnet-sonarscanner begin /d:sonar.scanner.scanAll=false /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host
+          .url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml
           dotnet build --configuration Release
           dotnet-coverage collect 'dotnet test --filter "FullyQualifiedName!~Acceptance.Tests"' -f xml -o 'coverage.xml'
           .\.sonar\scanner\dotnet-sonarscanner end /d:sonar.token="${{ secrets.SONAR_TOKEN }}"
 
       - name: Pack NuGet package
         if: github.ref == 'refs/heads/main'
-        run: dotnet pack .\src\AStar.Dev.Utilities\AStar.Dev.Utilities.csproj
+        run: dotnet pack .\src\${{ env.ProjectName }}\${{ env.ProjectName }}.csproj
 
       - name: Push to NuGet
         if: github.ref == 'refs/heads/main'
-        run: dotnet nuget push "**\AStar.Dev.Utilities.*.nupkg" --api-key ${{secrets.nuget_api_key}} --skip-duplicate --source https://api.nuget.org/v3/index.json
+        run: dotnet nuget push "**\${{ env.ProjectName }}.*.nupkg" --api-key ${{secrets.nuget_api_key}} --skip-duplicate --source https://api.nuget.org/v3/index.json
 
diff --git a/AStar.Dev.Functional.Extensions.sln b/AStar.Dev.Functional.Extensions.sln
index 60a1881..2d11f8b 100644
--- a/AStar.Dev.Functional.Extensions.sln
+++ b/AStar.Dev.Functional.Extensions.sln
@@ -11,6 +11,16 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AStar.Dev.Functional.Extens
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AStar.Dev.Functional.Extensions.Tests.Unit", "test\AStar.Dev.Functional.Extensions.Tests.Unit\AStar.Dev.Functional.Extensions.Tests.Unit.csproj", "{F61660A7-160E-4654-94A5-F8D5D75FFBD6}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".github", ".github", "{419B9C55-6F41-4ED8-B87C-855B23E01C41}"
+	ProjectSection(SolutionItems) = preProject
+		.github\dependabot.yml = .github\dependabot.yml
+	EndProjectSection
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "workflows", "workflows", "{2BB3AD42-1BED-4792-8E37-E87783AE949C}"
+	ProjectSection(SolutionItems) = preProject
+		.github\workflows\dotnet.yml = .github\workflows\dotnet.yml
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -22,6 +32,7 @@ Global
 	GlobalSection(NestedProjects) = preSolution
 		{3FC5E2DB-6C2C-4D72-8498-39A121722334} = {8456212E-F453-483A-8E27-7494722AE10F}
 		{F61660A7-160E-4654-94A5-F8D5D75FFBD6} = {3C168EA0-2CFB-490A-8E3A-BE08F456DD3F}
+		{2BB3AD42-1BED-4792-8E37-E87783AE949C} = {419B9C55-6F41-4ED8-B87C-855B23E01C41}
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
 		{3FC5E2DB-6C2C-4D72-8498-39A121722334}.Debug|Any CPU.ActiveCfg = Debug|Any CPU

From 2514f5e00de93afed1ea8bd2d34d21b6c3707434 Mon Sep 17 00:00:00 2001
From: Jason Barden <jason.barden@outlook.com>
Date: Tue, 29 Apr 2025 15:56:09 +0100
Subject: [PATCH 3/6] Change the way the scallAll is turned off

https://david.gardiner.net.au/2024/12/sonarcloud says

the log message was incorrect so trying the version in the link
---
 .github/workflows/dotnet.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index da27bfa..f6baf6a 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -55,7 +55,8 @@ jobs:
         shell: powershell
         run: |
           dotnet tool install --global dotnet-coverage
-          .\.sonar\scanner\dotnet-sonarscanner begin /d:sonar.scanner.scanAll=false /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host
+          sonar.scanner.scanAll=false
+          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host
           .url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml
           dotnet build --configuration Release
           dotnet-coverage collect 'dotnet test --filter "FullyQualifiedName!~Acceptance.Tests"' -f xml -o 'coverage.xml'

From dd094c062e75b90afbeba5fdb56b8ba6cc2abd6c Mon Sep 17 00:00:00 2001
From: Jason Barden <jason.barden@outlook.com>
Date: Tue, 29 Apr 2025 15:58:18 +0100
Subject: [PATCH 4/6] Removing the scanAll suppression until another time

---
 .github/workflows/dotnet.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index f6baf6a..ae0b3ce 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -55,7 +55,6 @@ jobs:
         shell: powershell
         run: |
           dotnet tool install --global dotnet-coverage
-          sonar.scanner.scanAll=false
           .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host
           .url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml
           dotnet build --configuration Release

From 232ef1e03ed16aa4774adca73555d29c40140ee4 Mon Sep 17 00:00:00 2001
From: Jason Barden <jason.barden@outlook.com>
Date: Tue, 29 Apr 2025 16:02:28 +0100
Subject: [PATCH 5/6] OK, as it failed again, build error spotted so

have returned the original d:sonar.scanner.scanAll=false
---
 .github/workflows/dotnet.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index ae0b3ce..3f90170 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -55,8 +55,7 @@ jobs:
         shell: powershell
         run: |
           dotnet tool install --global dotnet-coverage
-          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host
-          .url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml
+          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host           .url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml /d:sonar.scanner.scanAll=false
           dotnet build --configuration Release
           dotnet-coverage collect 'dotnet test --filter "FullyQualifiedName!~Acceptance.Tests"' -f xml -o 'coverage.xml'
           .\.sonar\scanner\dotnet-sonarscanner end /d:sonar.token="${{ secrets.SONAR_TOKEN }}"

From 7a5774f72ebc11e38663fb50a61d46f652c12354 Mon Sep 17 00:00:00 2001
From: Jason Barden <jason.barden@outlook.com>
Date: Tue, 29 Apr 2025 16:02:59 +0100
Subject: [PATCH 6/6] Fix the weird spacing

---
 .github/workflows/dotnet.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index 3f90170..74f048e 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -55,7 +55,7 @@ jobs:
         shell: powershell
         run: |
           dotnet tool install --global dotnet-coverage
-          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host           .url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml /d:sonar.scanner.scanAll=false
+          .\.sonar\scanner\dotnet-sonarscanner begin /k:"astar-development_${{ env.RepositoryName }}" /o:"astar-development" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host.url="https://sonarcloud.io" /d:sonar.cs.vscoveragexml.reportsPaths=coverage.xml /d:sonar.scanner.scanAll=false
           dotnet build --configuration Release
           dotnet-coverage collect 'dotnet test --filter "FullyQualifiedName!~Acceptance.Tests"' -f xml -o 'coverage.xml'
           .\.sonar\scanner\dotnet-sonarscanner end /d:sonar.token="${{ secrets.SONAR_TOKEN }}"