mouseless · dncsvr · Jan 9, 2024 · Nov 24, 2023 · Nov 24, 2023 · Nov 24, 2023
diff --git a/.github/workflows/project-regular-checks.yml b/.github/workflows/project-regular-checks.yml
@@ -43,7 +43,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: 7
+          dotnet-version: 8
       - name: Build Solution
         run: dotnet build -c Release
   test:
@@ -58,7 +58,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: 7
+          dotnet-version: 8
       - name: Test
         if: ${{ matrix.os != 'ubuntu-latest' }}
         run: dotnet test -c Release

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -67,7 +67,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: 7
+          dotnet-version: 8
       - name: Pack
         run: |
           dotnet pack -o "packages" -c Release
@@ -76,6 +76,7 @@ jobs:
         with:
           name: packages
           path: packages/
+
   push-packages:
     name: Push Packages
     needs: pack-projects
@@ -118,6 +119,7 @@ jobs:
           name: docs
           path: docs/.theme/.output/public
           if-no-files-found: error
+
   publish-docs:
     needs: generate-docs
     name: Publish Docs

diff --git a/.github/workflows/samples-regular-checks.yml b/.github/workflows/samples-regular-checks.yml
@@ -32,7 +32,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: 7
+          dotnet-version: 8
       - name: samples/event-scheduler
         working-directory: samples/event-scheduler
         run: |

diff --git a/Directory.Build.props b/Directory.Build.props
@@ -1,8 +1,8 @@
 <Project>
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
-    <LangVersion>11.0</LangVersion>
+    <TargetFramework>net8.0</TargetFramework>
+    <LangVersion>12.0</LangVersion>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>

diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -8,20 +8,22 @@
     <PackageVersion Include="BenchmarkDotNet" Version="0.13.11" />
     <PackageVersion Include="coverlet.collector" Version="6.0.0" />
     <PackageVersion Include="FluentNHibernate" Version="3.3.0" />
-    <PackageVersion Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="7.0.13" />
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="8.0.0" />
     <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" />
     <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" />
-    <PackageVersion Include="Microsoft.Extensions.Configuration.Abstractions" Version="7.0.0" />
-    <PackageVersion Include="Microsoft.Extensions.Configuration.Binder" Version="7.0.4" />
-    <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="7.0.1" />
-    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.7.2" />
-    <PackageVersion Include="Moq" Version="4.20.69" />
+    <PackageVersion Include="Microsoft.Extensions.Caching.Abstractions" Version="8.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration.Abstractions" Version="8.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration.Binder" Version="8.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="8.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.TimeProvider.Testing" Version="8.0.0" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
+    <PackageVersion Include="Moq" Version="4.20.70" />
     <PackageVersion Include="MySql.Data" Version="8.2.0" />
-    <PackageVersion Include="NHibernate" Version="5.4.6" />
-    <PackageVersion Include="NUnit" Version="3.14.0" />
+    <PackageVersion Include="NHibernate" Version="5.5.0" />
+    <PackageVersion Include="NUnit" Version="4.0.1" />
     <PackageVersion Include="NUnit3TestAdapter" Version="4.5.0" />
     <PackageVersion Include="Shouldly" Version="4.2.1" />
-    <PackageVersion Include="StyleCop.Analyzers.Unstable" Version="1.2.0.507" />
+    <PackageVersion Include="StyleCop.Analyzers.Unstable" Version="1.2.0.556" />
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="6.5.0" />
     <PackageVersion Include="System.Data.SQLite" Version="1.0.118" />
   </ItemGroup>

diff --git a/Makefile b/Makefile
@@ -22,3 +22,6 @@ run:
 	fi
 test:
 	dotnet test
+
+# dotnet test -c Release --collect:"XPlat Code Coverage" --logger trx --results-directory .coverage --settings test/runsettings.xml
+# reportgenerator -reports:.coverage\0d84daea-0041-4f8d-a93c-51d3d348fa69\coverage.cobertura.xml;.coverage\d606db4f-8ea5-4e9f-a304-f37b22a1f34b\coverage.cobertura.xml -targetdir:.coverage/report
diff --git a/docs/.theme/package-lock.json b/docs/.theme/package-lock.json
diff --git a/docs/architecture/feature.md b/docs/architecture/feature.md
@@ -154,12 +154,9 @@ below;
 
 `WelcomePageGreetingFeature.cs`
 ```csharp
-public class WelcomePageGreetingFeature : IFeature<GreetingConfigurator>
+public class WelcomePageGreetingFeature(string _path)
+    : IFeature<GreetingConfigurator>
 {
-    readonly string _path;
-
-    public WelcomePageGreetingFeature(string path) => _path = path;
-
     public void Configure(LayerConfigurator configurator)
     {
         configurator.ConfigureApplicationBuilder(app =>

diff --git a/docs/architecture/layer.md b/docs/architecture/layer.md
@@ -160,10 +160,9 @@ is `PhaseOrder.Normal`. If you need to change the order, pass the desired order
 to this parameter as shown below;
 
 ```csharp
-public class DoThisEarlyOn : PhaseBase
-{
-    public DoThisEarlyOn() : base(PhaseOrder.Early) { }
-}
+public class DoThisEarlyOn()
+    : PhaseBase(PhaseOrder.Early)
+{ }
 ```
 
 ## Providing Configuration

diff --git a/docs/blueprints/service.md b/docs/blueprints/service.md
@@ -36,17 +36,18 @@ Layers in this blueprint are;
 
 Features with default options are;
 
-| Features           | Run         | Test            | Required |
-| ------------------ | ----------- | --------------- | -------- |
-| Business           | Default     | Default         | Yes      |
-| Core               | Dotnet      | Mock            |          |
-| Database           | Sqlite      | InMemory        | Yes      |
-| Documentation      | Default     |                 |          |
-| Exception Handling | Default     |                 |          |
-| Greeting           | Hello World |                 |          |
-| Logging            | Request     |                 |          |
-| Mocking Overrider  |             | First Interface |          |
-| Orm                | Default     | Default         |          |
+| Features           | Run           | Test            | Required |
+| ------------------ | ------------- | --------------- | -------- |
+| Business           | Default       | Default         | Yes      |
+| Caching            | Scoped Memory | Scoped Memory   |          |
+| Core               | Dotnet        | Mock            |          |
+| Database           | Sqlite        | InMemory        | Yes      |
+| Documentation      | Default       |                 |          |
+| Exception Handling | Default       |                 |          |
+| Greeting           | Hello World   |                 |          |
+| Logging            | Request       |                 |          |
+| Mocking Overrider  |               | First Interface |          |
+| Orm                | Default       | Default         |          |
 
 Phase execution order;
 

diff --git a/docs/features/caching.md b/docs/features/caching.md
@@ -0,0 +1,18 @@
+# Caching
+
+Implementations of this feature provides predefined caching behaviour.
+
+Add this feature using `AddCaching()` extension;
+
+```csharp
+app.Features.AddCaching(...);
+```
+
+## Scoped Memory
+
+This feature implementation registers `Func<IMemoryCache>` factory with scoped
+`MemoryCache` implementation to provide request in-memory caching.
+
+```csharp
+c => c.ScopedMemory()
+```
diff --git a/docs/features/core.md b/docs/features/core.md
@@ -1,6 +1,6 @@
 # Core
 
-This feature registers `ISystem` to services.
+This feature registers `TimeProvider.System` to services.
 
 Add this feature using `AddCore()` extension;
 
@@ -10,8 +10,8 @@ app.Features.AddCore(...);
 
 ## Dotnet
 
-Adds a local implementation of `ISystem` interface to services to be used
-throughout your application.
+Adds a local implementation of `TimeProvider` to services to be used throughout
+your application.
 
 ```csharp
 c => c.Dotnet()

diff --git a/docs/features/exception-handling.md b/docs/features/exception-handling.md
@@ -11,5 +11,5 @@ app.Features.AddExceptionHandling(...);
 Adds default exception handler.
 
 ```csharp
-c => c.Default()
+c => c.Default(typeUrlFormat: "https://my-service.com/errors/{0}")
 ```
diff --git a/docs/release-notes/v0-4.md b/docs/release-notes/v0-4.md
@@ -1,13 +1,20 @@
 # v0.4
 
+## v0.4.3
+
+### Improvements
+
+- `CommitAsync` now accepts nullable parameters
+- Added generic overload for `MockMe.ASetting()`
+
 ## v0.4.2
 
 ### Improvements
 
 - Improved exception message when there is no valid json in the database.
 - Added `GetRequiredValue<T>` extension to `IConfiguration` with default value
   option
-- Mock `IConfiguration` return values for not defined settings can now be 
+- Mock `IConfiguration` return values for not defined settings can now be
   configured by overriding `ServiceSpec.GetDefaultSettingsValue()`
 
 ### Bugfixes
@@ -93,4 +100,4 @@ Visit [Regular expressions][] for more details.
 | NUnit                                           | 3.13.3      | 3.14.0      |
 
 [Central Package Management]: https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-7#central-package-management
-[Regular expressions]: https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-7#regular-expressions
+[Regular expressions]: https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-7#regular-expressions
diff --git a/docs/release-notes/v0-5.md b/docs/release-notes/v0-5.md
@@ -0,0 +1,20 @@
+# v0.5
+
+## v0.5.0
+
+### Features
+
+- Beta features are available in do-blueprints-service package;
+  - `Caching` feature is now added with `ScopedMemory` implementation
+
+### Improvements
+
+- Added `CustomMySQL57Dialect` for enabling `varchar` column type with _1023_
+  max capacity
+- Added `TransientWithFactory<TService, TImplementation>` and
+  `ScopedWithFactory<TService, TImplementation>` extensions for registering
+  services with implementations
+- Added new ServiceSpec extensions:
+  - `AnInteger` extension for `Stubber`
+  - `AMemoryCache` extension for `Stubber`
+  - `ShouldHaveCount` extension for `IMemoryCache`
diff --git a/docs/release-notes/v0-6.md b/docs/release-notes/v0-6.md
@@ -0,0 +1,87 @@
+# v0.6
+
+## v0.6.0
+
+### .NET Upgrade
+
+DO now supports .NET 8! Below you can find a task list to upgrade your projects.
+
+```markdown
+- [ ] Upgrade .NET and C# versions
+  - [ ] in projects
+  - [ ] in docker files
+  - [ ] in GitHub workflows
+- [ ] Upgrade DO version
+- [ ] Syntax improvements
+  - [ ] Use primary constructors
+  - [ ] Use collection expressions
+- [ ] Use `[FromKeyedServices]` and `[FromServices]` in controllers
+```
+
+#### Upgrade .NET and C# versions
+
+- Upgrade the project's `C#` language to `12`.
+- Framework version upgrade to `net8.0` in the projects.
+- Framework and sdk version upgrade to `8` in `Dockerfile`.
+- Upgrade dotnet version `8` in Github actions.
+
+#### Syntax improvements
+
+##### Primary constructors
+
+Use primary constructor, when there is a dependency that needs to be injected at
+the constructor without any logic or when the base class constructor is called.
+Parameter names start with underscore.
+
+```csharp
+public class Entity(IEntityContext<Entity> _context)
+{
+  ...
+}
+```
+
+##### Collection expressions
+
+Use new and simplified collection expressions, where possible.
+
+Visit [Collection expression][] for more details.
+
+#### `[FromServices]` in controllers
+
+Instead of using constructor injection, use `[FromServices]` attribute to inject
+dependencies in controllers.
+
+```csharp
+public Entity Get([FromServices] IQueryContext<Entity> entityQuery) { }
+```
+
+### Improvements
+
+- `ExceptionHandling` now uses
+  `Microsoft.AspNetCore.Diagnostics.IExceptionHandling`
+  - `ExceptionHandling` feature now adds `StatusCodePages` middleware.
+- Exceptions now return `ProblemDetails` as response
+- `ISystem` is replaced with `TimeProvider.System`
+  - `Mocker`, `TheSystem` extension is renamed to `TheTime`
+  - Use `FakeTimeProvider` for tests by mocking `TheTime`
+- Internal Server Error response included extra details in message, removed
+  - Extra details can be reached from the logs
+- `HandledException` is now abstract
+  - Added optional `ExtraDetails` collection property to `HandledException`
+
+### Library Upgrades
+
+| Package                                         | Old Version | New Version |
+| ----------------------------------------------- | ----------- | ----------- |
+| Microsoft.AspNetCore.Mvc.NewtonsoftJson         | 7.0.13      | 8.0.0       |
+| Microsoft.Extensions.Configuration.Abstractions | 7.0.0       | 8.0.0       |
+| Microsoft.Extensions.Configuration.Binder       | 7.0.0       | 8.0.0       |
+| Microsoft.Extensions.Logging.Abstractions       | 7.0.0       | 8.0.0       |
+| Microsoft.NET.Test.Sdk                          | 7.0.0       | 8.0.0       |
+| Microsoft.Extensions.TimeProvider.Testing       | new         | 8.0.0       |
+| Moq                                             | 4.20.69     | 4.20.70     |
+| NHibernate                                      | 5.4.6       | 5.5.0       |
+| NUnit                                           | 3.14.0      | 4.0.1       |
+| StyleCop.Analyzers.Unstable                     | 1.2.0.507   | 1.2.0.556   |
+
+[Collection expression]: https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/operators/collection-expressions
diff --git a/samples/Directory.Build.props b/samples/Directory.Build.props
@@ -1,8 +1,8 @@
 <Project>
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
-    <LangVersion>11.0</LangVersion>
+    <TargetFramework>net8.0</TargetFramework>
+    <LangVersion>12.0</LangVersion>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>