TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin.buildSteps/DotnetTestStep

DotnetTestStep

fun BuildSteps.dotnetTest(init: DotnetTestStep.() -> Unit): DotnetTestStep

A dotnet test step to run .NET CLI command

Example. Runs dotnet test command for all the solution files in the checkout directory. Does not try to build the project, assumes this is already done by some previous step.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        dotnetTest {
            projects = "*.sln"
            skipBuild = true
        }
Content copied to clipboard
    }
}

Example. Runs dotnet test for the MyProject.sln solution file. Collects code coverage with help of JetBrains DotCover for the specified assemblies.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        dotnetTest {
            projects = "MyProject.sln"
            skipBuild = true
            coverage = dotcover {
                toolPath = "%teamcity.tool.JetBrains.dotCover.CommandLineTools.DEFAULT%"
                assemblyFilters = "build/*.dll"
            }
        }
Content copied to clipboard
    }
}

*/

Example. Runs dotnet test for the specified test assemblies.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        dotnetTest {
            projects = "tests/*.dll"
            excludedProjects = "tests/ExcludedTests.dll"
            skipBuild = true
        }
Content copied to clipboard
    }
}

*/

Constructors

DotnetTestStep

constructor(init: DotnetTestStep.() -> Unit)

constructor()

Types

Coverage

sealed class Coverage : CompoundParam<DotnetTestStep.Coverage>

ImagePlatform

enum ImagePlatform : Enum<DotnetTestStep.ImagePlatform>

Docker image platforms

Verbosity

enum Verbosity : Enum<DotnetTestStep.Verbosity>

Logging verbosity

Properties

args

var args: String?

Enter additional command line parameters for dotnet test.

conditions

var conditions: BuildStepConditions

Optional collection of build step execution conditions

configuration

var configuration: String?

Target configuration to test for.

coverage

var coverage: DotnetTestStep.Coverage?

Specifies coverage tool to use

dockerImage

var dockerImage: String?

Specifies which Docker image to use for running this build step. I.e. the build step will be run inside specified docker image, using 'docker run' wrapper.

dockerImagePlatform

var dockerImagePlatform: DotnetTestStep.ImagePlatform?

Specifies which Docker image platform will be used to run this build step.

dockerPull

var dockerPull: Boolean?

If enabled, "pull image" command will be run before docker run.

dockerRunParameters

var dockerRunParameters: String?

Additional docker run command arguments

enabled

var enabled: Boolean

Specifies whether the step is enabled, true by default

excludedProjects

var excludedProjects: String?

Specify paths to excluded projects. Wildcards are supported.

executionMode

var executionMode: BuildStep.ExecutionMode

Build step execution mode

filter

var filter: String?

Specify the test case filter.

framework

var framework: String?

Target framework to test for.

var id: String?

Optional id of the step. Usually the id is not required, however if a build configuration inherits from a template and wants to override a build step defined there, then both steps should have the same id.

logging

var logging: DotnetTestStep.Verbosity?

Specify logging verbosity

maxRetries

var maxRetries: String?

Rerun failed tests until they pass or until the maximum number of attempts is reached.

name

var name: String

Build step name

outputDir

var outputDir: String?

The directory where to find the binaries to be run.

params

val params: List<Parameter>

projects

var projects: String?

Specify paths to projects and solutions. Wildcards are supported.

sdk

var sdk: String?

.NET SDK versions separated by semicolon to be required on agents.

settingsFile

var settingsFile: String?

Run tests that match the given expression.

singleSession

var singleSession: Boolean?

Whether TeamCity should run tests in a single session

skipBuild

var skipBuild: Boolean?

Do not build the project before testing

type

var type: String

Build step type

workingDir

var workingDir: String?

Build working directory for script, specify it if it is different from the checkout * directory.

Functions

booleanParameter

fun booleanParameter(customName: String? = null, trueValue: String? = "true", falseValue: String? = "false"): DelegateProvider<Boolean?>

clear

fun clear()

clearConditions

fun clearConditions()

Deletes all configured build step conditions

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): DelegateProvider<T>

conditions

fun conditions(init: BuildStepConditions.() -> Unit = {})

Configures build step conditions

copyParamsTo

fun <T : Parametrized> copyParamsTo(target: T): T

Copies parameters of this object to the specified target

create

open fun create(): BuildStep

Creates an instance of this build step via reflection using a no argument constructor, used during copying. Throws an error if this class doesn't have a default constructor. Subclasses can override it to create an instance without using a default constructor.

dotcover