TeamCity Kotlin DSL 2025.11/jetbrains.buildServer.configs.kotlin.buildFeatures/ParallelTestsFeature

ParallelTestsFeature

open class ParallelTestsFeature : BuildFeature

fun BuildFeatures.parallelTests(init: ParallelTestsFeature.() -> Unit): ParallelTestsFeature

Parallel Tests Feature can automatically split tests of a build into several batches, by test classes. It will run them in parallel on suitable build agents and gather results in a composite build overview.

Example. Enables tests parallelization. Uses 3 parallel batches to run tests. Groups artifacts in folders.

buildType {
    // Other Build Type settings ...
    features {
        // Other Build Features ...
        parallelTests {
            numberOfBatches = 3
            groupArtifactsByBuild = true
        }
Content copied to clipboard
    }
}

Constructors

ParallelTestsFeature

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

constructor()

Properties

enabled

var enabled: Boolean

Specifies whether the feature is enabled, true by default

groupArtifactsByBuild

var groupArtifactsByBuild: Boolean?

If true, TeamCity will place artifacts from parallel builds in separate directories within the main build.

var id: String?

Build feature id, if not specified will be generated

numberOfBatches

var numberOfBatches: Int?

Number of batches

params

val params: List<Parameter>

type

var type: String

Build feature type

yamlParams

val yamlParams: List<Parameter>

Functions

booleanParameter

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

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

clear

fun clear()

compoundParameter

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

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

copyParamsTo

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

Copies parameters of this object to the specified target

create

open fun create(): BuildFeature

Creates an instance of this build feature 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.

doubleParameter