Akka.MultiNode.TestAdapter
1.5.28
Prefix Reserved
dotnet add package Akka.MultiNode.TestAdapter --version 1.5.28
NuGet\Install-Package Akka.MultiNode.TestAdapter -Version 1.5.28
<PackageReference Include="Akka.MultiNode.TestAdapter" Version="1.5.28" />
paket add Akka.MultiNode.TestAdapter --version 1.5.28
#r "nuget: Akka.MultiNode.TestAdapter, 1.5.28"
// Install Akka.MultiNode.TestAdapter as a Cake Addin #addin nuget:?package=Akka.MultiNode.TestAdapter&version=1.5.28 // Install Akka.MultiNode.TestAdapter as a Cake Tool #tool nuget:?package=Akka.MultiNode.TestAdapter&version=1.5.28
Akka.MultiNode.TestAdapter
Visual Studio 2019 Test Explorer, JetBrains Rider, and .NET CLI Test runner for the Akka.NET MultiNode tests
Documentation
Akka.MultiNode.TestAdapter
is a standalone test adapter for Akka.NET multi node testkit; it is based on the popular Xunit test framework to allow multinode tests to run directly inside popular C# IDE such as Microsoft Visual Studio and JetBrains Rider and run them using the dotnet test
.NET CLI command.
To use the test adapter in your multinode spec projects, You will need to add these nuget packages:
Documentation regarding the multinode specs themselves can be read in the Akka.NET documentation pages:
Json Settings
This test adapter follows the Xunit convention on loading test configuration via a json file. It will
check the directory where the test assembly is located for a [Assembly Name].xunit.multinode.runner.json
or a xunit.multinode.runner.json
file.
{
"outputDirectory": "TestResults",
"failedSpecsDirectory": "FAILED_SPECS_LOGS",
"listenAddress": "127.0.0.1",
"listenPort": 0,
"clearOutputDirectory": false
}
- outputDirectory: Determines output directory for all log output files.
- failedSpecsDirectory: Determines output directory for aggregated failed test logs.
- listenAddress: Determines the address that this multi-node test runner will use to listen for log messages from individual spec.
- listenPort: Determines the port number that this multi-node test runner will use to listen for log messages from individual spec.
- ClearOutputDirectory: Clear the output directory before running the test session. If set to false, all test logs are appended to the out file.
Building this solution
To run the build script associated with this solution, execute the following:
Windows
c:\> build.cmd all
Linux / OS X
c:\> build.sh all
If you need any information on the supported commands, please execute the build.[cmd|sh] help
command.
This build script is powered by FAKE; please see their API documentation should you need to make any changes to the build.fsx
file.
Conventions
The attached build script will automatically do the following based on the conventions of the project names added to this project:
- Any project name ending with
.Tests
will automatically be treated as a XUnit2 project and will be included during the test stages of this build script; - Any project name ending with
.Tests
will automatically be treated as a NBench project and will be included during the test stages of this build script; and - Any project meeting neither of these conventions will be treated as a NuGet packaging target and its
.nupkg
file will automatically be placed in thebin\nuget
folder upon running thebuild.[cmd|sh] all
command.
DocFx for Documentation
This solution also supports DocFx for generating both API documentation and articles to describe the behavior, output, and usages of your project.
All of the relevant articles you wish to write should be added to the /docs/articles/
folder and any API documentation you might need will also appear there.
All of the documentation will be statically generated and the output will be placed in the /docs/_site/
folder.
Previewing Documentation
To preview the documentation for this project, execute the following command at the root of this folder:
C:\> serve-docs.cmd
This will use the built-in docfx.console
binary that is installed as part of the NuGet restore process from executing any of the usual build.cmd
or build.sh
steps to preview the fully-rendered documentation. For best results, do this immediately after calling build.cmd buildRelease
.
Release Notes, Version Numbers, Etc
This project will automatically populate its release notes in all of its modules via the entries written inside RELEASE_NOTES.md
and will automatically update the versions of all assemblies and NuGet packages via the metadata included inside common.props
.
If you add any new projects to the solution created with this template, be sure to add the following line to each one of them in order to ensure that you can take advantage of common.props
for standardization purposes:
<Import Project="..\common.props" />
Code Signing via SignService
This project uses SignService to code-sign NuGet packages prior to publication. The build.cmd
and build.sh
scripts will automatically download the SignClient
needed to execute code signing locally on the build agent, but it's still your responsibility to set up the SignService server per the instructions at the linked repository.
Once you've gone through the ropes of setting up a code-signing server, you'll need to set a few configuration options in your project in order to use the SignClient
:
- Add your Active Directory settings to
appsettings.json
and - Pass in your signature information to the
signingName
,signingDescription
, andsigningUrl
values insidebuild.fsx
.
Whenever you're ready to run code-signing on the NuGet packages published by build.fsx
, execute the following command:
C:\> build.cmd nuget SignClientSecret={your secret} SignClientUser={your username}
This will invoke the SignClient
and actually execute code signing against your .nupkg
files prior to NuGet publication.
If one of these two values isn't provided, the code signing stage will skip itself and simply produce unsigned NuGet code packages.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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 was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Akka.Cluster.TestKit (>= 1.5.28)
- System.CodeDom (>= 8.0.0)
- System.Runtime.Loader (>= 4.3.0)
- TeamCity.ServiceMessages (>= 4.1.1)
- xunit.runner.utility (>= 2.8.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Akka.MultiNode.TestAdapter:
Repository | Stars |
---|---|
akkadotnet/akka.net
Canonical actor model implementation for .NET with local + distributed actors in C# and F#.
|
Version | Downloads | Last updated |
---|---|---|
1.5.28 | 204 | 9/5/2024 |
1.5.25 | 1,808 | 6/17/2024 |
1.5.24 | 111 | 6/7/2024 |
1.5.19 | 4,572 | 4/20/2024 |
1.5.18 | 261 | 4/12/2024 |
1.5.13 | 8,498 | 9/19/2023 |
1.5.8 | 2,471 | 6/16/2023 |
1.5.6 | 842 | 5/16/2023 |
1.5.0 | 6,304 | 3/2/2023 |
1.5.0-beta1 | 2,074 | 2/21/2023 |
1.1.1 | 17,103 | 4/21/2022 |
1.1.0 | 6,215 | 1/7/2022 |
1.1.0-beta2 | 332 | 12/23/2021 |
1.1.0-beta1 | 269 | 11/8/2021 |
1.0.0 | 6,157 | 10/20/2021 |
1.0.0-beta2 | 463 | 10/11/2021 |
1.0.0-beta1 | 339 | 9/29/2021 |
[Updated Akka.NET to 1.5.28](https://github.com/akkadotnet/akka.net/releases/tag/1.5.28)