KubeOps.Testing 7.0.3

There is a newer version of this package available.
See the version list below for details.
dotnet add package KubeOps.Testing --version 7.0.3                
NuGet\Install-Package KubeOps.Testing -Version 7.0.3                
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="KubeOps.Testing" Version="7.0.3" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add KubeOps.Testing --version 7.0.3                
#r "nuget: KubeOps.Testing, 7.0.3"                
#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 KubeOps.Testing as a Cake Addin
#addin nuget:?package=KubeOps.Testing&version=7.0.3

// Install KubeOps.Testing as a Cake Tool
#tool nuget:?package=KubeOps.Testing&version=7.0.3                

KubeOps Testing Utilities

The KubeOps.Testing package provides tools to test the custom operator.

To have an example for integration testing a custom operator have a look at the test code in the repository: Integration Tests

The tools provided aid with Integration testing. For normal unit testing, you can just mock all the things.

The main entry point for testing your custom operator is the KubernetesOperatorFactory class. It is meant to be injected into your test.

The following documentation assumes you are using xUnit as a testing framework. The techniques used should be present with other testing frameworks as well.

The following steps are needed for integration testing the controller:

  • Create a TestStartup.cs file (or any other name you want)
  • Inject the KubernetesOperatorFactory
  • Use the mocked client and helper functions to test your operator

Test Startup

This file is very similar to a "normal" Startup.cs file of an asp.net application. Either you subclass it and replace your test mocked services, or you create a new one.

Mocked elements

The main part of this operator factory does mock the used Kubernetes client and helper functions to enqueue events and finalizer events.

Both mocked elements can be retrieved via the operator factory with:

  • "MockedKubernetesClient"
  • "KubernetesOperatorFactory.EnqueueEvent"
  • "KubernetesOperatorFactory.EnqueueFinalization"

Mocked events

With the mentioned factory functions one can fire events for entities. This can be used to test your controllers.

The controllers are normally instantiated via the scope of the DI system.

Mocked IKubernetesClient

The client is essentially an empty implementation of the interface. All methods do return null or the object that was passed into the mocked class. There are five different object references that can be set to return certain results upon calling the client.

The mocked client is injected as singleton, this means the used "result" references can vary. Be aware of that and don't run your tests in parallel if you rely on those results.

Writing a test

Now with all parts in place, we can write a test. You probably need to set the solution relative content root for asp.net testing. But then you can run the factory and create a test.

// Constructor
public TestControllerTest(KubernetesOperatorFactory<TestStartup> factory)
{
    _factory = factory.WithSolutionRelativeContentRoot("tests/KubeOps.TestOperator");

    _controller = _factory.Services
        .GetRequiredService<IControllerInstanceBuilder>()
        .BuildControllers<V1TestEntity>()
        .First();

    _managerMock = _factory.Services.GetRequiredService<Mock<IManager>>();
    _managerMock.Reset();
}

// snip

[Fact]
public async Task Test_If_Manager_Created_Is_Called()
{
    _factory.Run();

    _managerMock.Setup(o => o.Reconciled(It.IsAny<V1TestEntity>()));
    _managerMock.Verify(o => o.Reconciled(It.IsAny<V1TestEntity>()), Times.Never);

    await _controller.StartAsync();
    await _factory.EnqueueEvent(ResourceEventType.Reconcile, new V1TestEntity());
    await _controller.StopAsync();

    _managerMock.Verify(o => o.Reconciled(It.IsAny<V1TestEntity>()), Times.Once);
}
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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
7.6.1 3,948 9/29/2023
7.6.0 565 9/19/2023
7.5.0 322 9/13/2023
7.4.5 135 9/13/2023
7.4.4 196 8/28/2023
7.4.3 154 8/28/2023
7.4.2 1,704 7/17/2023
7.4.1 159 7/17/2023
7.4.0 257 6/26/2023
7.3.0 671 6/1/2023
7.2.0 300 4/14/2023
7.1.2 223 4/14/2023
7.1.1 424 3/1/2023
7.1.0 255 3/1/2023
7.0.10 265 2/27/2023
7.0.9 243 2/23/2023
7.0.8 254 2/23/2023
7.0.7 305 2/14/2023
7.0.6 288 2/6/2023
7.0.5 285 2/3/2023
7.0.4 304 1/30/2023
7.0.3 300 1/30/2023
7.0.2 335 1/26/2023
7.0.1 299 1/23/2023
7.0.0 305 1/19/2023
7.0.0-prerelease.2 182 6/4/2022
7.0.0-prerelease.1 146 6/2/2022
6.6.2 865 1/17/2023
6.6.1 1,286 10/27/2022
6.6.0 509 8/10/2022
6.5.4 529 7/23/2022
6.5.3 551 6/4/2022
6.5.2 541 6/4/2022
6.5.1 559 6/2/2022
6.5.0 542 5/25/2022
6.4.0 571 5/16/2022
6.3.1 1,902 5/11/2022
6.3.0 596 4/28/2022
6.2.13 634 2/21/2022
6.2.12 600 2/18/2022
6.2.11 624 2/16/2022
6.2.10 620 2/13/2022
6.2.9 623 2/9/2022
6.2.8 620 2/8/2022
6.2.7 668 2/2/2022
6.2.6 666 2/1/2022
6.2.5 644 1/30/2022
6.2.4 655 1/27/2022
6.2.3 630 1/27/2022
6.2.2 665 1/24/2022
6.2.1 682 1/12/2022
6.2.0 522 1/7/2022
6.1.2 407 1/2/2022
6.1.0 410 12/26/2021
6.0.18 418 12/15/2021
6.0.17 408 12/14/2021
6.0.16 410 12/5/2021
6.0.15 394 12/4/2021
6.0.14 871 11/19/2021
6.0.13 426 11/16/2021
6.0.12 499 11/13/2021
6.0.11 491 11/8/2021
6.0.10 522 11/3/2021
6.0.9 450 11/2/2021
6.0.8 545 10/28/2021
6.0.7 494 10/27/2021
6.0.6 588 10/25/2021
6.0.5 537 10/25/2021
6.0.4 560 10/21/2021
6.0.3 515 10/15/2021
6.0.2 503 10/12/2021
6.0.1 534 10/12/2021
6.0.0 492 10/11/2021
6.0.0-prerelease.5 212 9/20/2021
6.0.0-prerelease.4 157 9/20/2021
6.0.0-prerelease.3 189 9/20/2021
6.0.0-prerelease.2 183 9/20/2021
6.0.0-prerelease.1 171 9/20/2021
5.4.9 509 9/30/2021
5.4.8 446 9/29/2021
5.4.7 568 9/25/2021
5.4.6 614 9/24/2021
5.4.5 536 9/22/2021
5.4.4 490 9/17/2021
5.4.3 448 9/14/2021
5.4.2 527 9/14/2021
5.4.1 543 9/8/2021
5.4.0 490 9/8/2021
5.3.6 536 8/27/2021
5.3.5 525 8/27/2021
5.3.4 534 8/27/2021
5.3.3 488 8/26/2021
5.3.2 470 8/26/2021
5.3.1 510 8/26/2021
5.3.0 518 8/26/2021
5.2.0 540 8/24/2021
5.1.4 534 8/24/2021
5.1.3 543 8/20/2021
5.1.2 595 8/19/2021
5.1.1 559 8/19/2021
5.1.0 530 8/19/2021
5.1.0-prerelease.2 195 8/19/2021
5.1.0-prerelease.1 185 8/19/2021
5.0.2-prerelease.1 182 8/19/2021
5.0.1 557 8/18/2021
5.0.0 490 8/18/2021
4.3.2 537 8/14/2021
4.3.1 436 8/13/2021
4.3.0 489 8/13/2021
4.2.0 479 8/13/2021
4.1.12 491 8/10/2021
4.1.11 525 8/9/2021
4.1.10 513 8/6/2021
4.1.9 559 8/5/2021
4.1.8 511 8/4/2021
4.1.7 542 8/4/2021
4.1.6 550 7/22/2021
4.1.5 537 7/13/2021
4.1.4 563 7/6/2021
4.1.3 620 6/29/2021
4.1.2 666 6/27/2021
4.1.1 515 6/21/2021
4.1.0 578 6/20/2021
4.0.23 564 6/13/2021
4.0.22 518 6/8/2021
4.0.21 564 6/2/2021
4.0.20 572 5/24/2021
4.0.19 479 5/19/2021
4.0.17 530 5/7/2021
4.0.16 485 5/5/2021
4.0.15 536 5/4/2021
4.0.14 500 4/26/2021
4.0.13 521 4/10/2021
4.0.12 511 4/9/2021
4.0.11 544 4/8/2021
4.0.10 503 4/6/2021
4.0.9 496 4/6/2021
4.0.8 557 4/3/2021
4.0.7 516 4/1/2021
4.0.6 535 3/31/2021
4.0.5 599 3/27/2021
4.0.4 468 3/25/2021
4.0.3 547 3/20/2021
4.0.2 532 3/19/2021
4.0.1 579 3/15/2021
4.0.0 532 3/5/2021
4.0.0-prerelease.2 231 3/5/2021
4.0.0-prerelease.1 232 3/4/2021
3.1.1-prerelease.2 228 2/24/2021
3.1.1-prerelease.1 184 2/23/2021
3.1.0 498 2/23/2021
3.1.0-prerelease.4 188 2/23/2021
3.1.0-prerelease.3 180 2/22/2021
3.1.0-prerelease.2 196 2/22/2021
3.1.0-prerelease.1 197 2/22/2021
3.0.1-prerelease.2 191 2/21/2021
3.0.1-prerelease.1 217 2/9/2021
3.0.0 520 2/8/2021
3.0.0-prerelease.4 192 2/4/2021
3.0.0-prerelease.3 188 1/29/2021
3.0.0-prerelease.2 194 1/29/2021
3.0.0-prerelease.1 211 1/24/2021
2.5.0 539 12/28/2020
2.4.0 517 12/11/2020
2.3.0 504 10/26/2020
2.2.0 516 9/18/2020
2.1.1 466 9/10/2020
2.1.0 493 9/10/2020
2.0.0 499 9/1/2020