StoicDreams.TestFramework.Blazor 1.6.7

dotnet add package StoicDreams.TestFramework.Blazor --version 1.6.7                
NuGet\Install-Package StoicDreams.TestFramework.Blazor -Version 1.6.7                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="StoicDreams.TestFramework.Blazor" Version="1.6.7" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add StoicDreams.TestFramework.Blazor --version 1.6.7                
#r "nuget: StoicDreams.TestFramework.Blazor, 1.6.7"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install StoicDreams.TestFramework.Blazor as a Cake Addin
#addin nuget:?package=StoicDreams.TestFramework.Blazor&version=1.6.7

// Install StoicDreams.TestFramework.Blazor as a Cake Tool
#tool nuget:?package=StoicDreams.TestFramework.Blazor&version=1.6.7                

Stoic Dreams Test Framework

Nuget: www.nuget.org/packages/StoicDreams.TestFramework

GitHub: github.com/StoicDreams/TestFramework

This library includes an abstract class called TestFramework that developers can inherit from their test classes to access helper methods for unit and integration tests.

Functionality includes extending and simplifying functionality from the NSubstitute mocking framework (We moved away from Moq over security concerns that came up with their 4.20 release.)

Project Goals

The goal of this library is to provide a framework to use in unit tests and integration tests that grealy simplify organizing tests using the Arrange / Act / Assert testing pattern.

Framework Features

  • Inclusion of NSubstitute mocking framework to use for mocking components.
  • Inclusion of FluentAssertions framework to use for human readable assertions.
  • Automatic default mocking (using NSubstitute's Mock framework) of a class's constructor dependencies when running unit tests.
  • Test framework agnostic: While we use XUnit, we have no restrictions against using other frameworks such as NUnit, MSTest, etc.

Noted Restrictions

This framework assumes use of IServiceCollection and IServiceProvider to handle dependency injection. And so, also uses ServiceCollection to manage components and build IServiceProvider which is used to handle dependency injection.

Because of this usage:

  • Classes being tested with TestFramework.ArrangeUnitTest should have a single public constructor. If a class has multiple public constructors it will use the first one.

Setting up your Test Project

Add the StoicDreams.TestFramework Nuget package to your test project.

<ItemGroup>
 <PackageReference Include="StoicDreams.TestFramework" Version="1.6.7" />
</ItemGroup>

Add assembly settings that will allow testing to access internal classes for the projects you are testing.

This update needs to be added to any project that utilizes internal classes.

Usings.cs

// Your existing global using statements
global using System;
...

// Add these 2 lines to allow testing to access internal classes
using System.Runtime.CompilerServices;
// Needed by the testing framework to access internals during reflection for automated mocking
[assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")]
// Reference your test project so it can see your main projects internals
[assembly: InternalsVisibleTo("MyCompany.MyApp.Tests")]

Inherit the StoicDreams.TestFramework class in all test files.

ExampleTests.cs (See a full example on GitHub)

namespace MyCompany.MyApp;

public class SampleChildATests : StoicDreams.TestFramework
{
 [Theory]
 [InlineData("Test One")]
 [InlineData("Test Two")]
 public void Verify_DoSomething_ReturnsExpectedData(string input)
 {
  ArrangeUnitTest<SampleParent>(options =>
  {
   options.GetService<ISampleChildA>().DoSomething(input).Returns($"Mock A: {input}");
   options.GetService<ISampleChildB>().DoSomething(input).Returns($"Mock B: {input}");
  })
  .Act(arrangment => arrangment.Service.DoSomething(input))
  .Assert(arrangement =>
  {
   string? result = arrangement.GetResult<string>();
   result.Should().NotBeNullOrWhiteSpace();
   result.Should().BeEquivalentTo($"Parent: Mock A: {input} - Mock B: {input}");
  });
 }
}

Author

Erik Gassler - Stoic Dreams - Forging solutions for tomorrow's software development.

Support - Visit Stoic Dreams' GitHub Sponsor page if you would like to provide support.

Software Development Standards - Check out my Simple-Holistic-Agile Software Engineering Standards website to see my standards for developing software.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.6.7 404 5/25/2024
1.6.6 102 5/25/2024
1.6.5 104 5/24/2024
1.6.4 105 5/24/2024
1.6.3 726 1/4/2024
1.6.2 593 12/7/2023
1.6.1 483 11/16/2023
1.6.0 411 11/15/2023
1.5.16 412 11/15/2023
1.5.15 591 10/17/2023
1.5.14 686 8/29/2023
1.5.13 633 8/17/2023
1.5.12 574 8/11/2023
1.5.11 539 8/11/2023
1.5.10 542 8/11/2023
1.5.9 514 8/11/2023
1.5.8 547 8/11/2023
1.5.7 549 8/11/2023
1.5.6 529 8/11/2023
1.5.5 549 8/11/2023
1.5.4 548 8/11/2023
1.5.3 544 8/11/2023
1.4.52 520 7/30/2023
1.4.51 926 4/4/2023
1.4.50 546 4/4/2023
1.4.49 630 3/1/2023
1.4.48 663 2/3/2023
1.4.40 717 1/24/2023
1.4.37 614 1/24/2023
1.4.36 665 1/5/2023
1.4.32 664 1/5/2023
1.4.31 651 1/5/2023
1.4.30 670 1/5/2023
1.4.21 692 1/3/2023
1.4.20 683 12/12/2022
1.4.9 1,000 9/20/2022
1.4.7 783 8/28/2022
1.4.2 1,172 8/11/2022
1.4.1 1,401 7/17/2022
1.3.1 788 7/17/2022
1.2.12 752 7/17/2022
1.2.11 759 7/11/2022
1.2.10 741 7/9/2022
1.2.8 756 7/9/2022
1.2.7 771 7/9/2022
1.2.6 781 7/9/2022
1.2.4 799 7/9/2022
1.2.3 730 7/8/2022
1.1.14 749 7/8/2022
1.1.13 736 7/8/2022
1.1.6 764 7/8/2022

Development Release