TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin.buildFeatures/AutoMerge

AutoMerge

fun BuildFeatures.merge(init: AutoMerge.() -> Unit): AutoMerge

Build feature enabling automatic merge in build configuration or template.

Example. Upon finishing of a build in a branch with name starting with 'feature-' prefix, performs merge of the branch into the default branch, but only if no new tests failed comparing to the latest build in the default branch. Also tries to perform fast-forward merge if possible.

buildType {
    // Other Build Type settings ...
    features {
        // Other Build Features ...
        merge {
          branchFilter = "+:feature-*"
          mergePolicy = AutoMerge.MergePolicy.FAST_FORWARD
          mergeCondition = "noNewTests"
        }
Content copied to clipboard
    }
}

Constructors

AutoMerge

fun AutoMerge(init: AutoMerge.() -> Unit)

AutoMerge

fun AutoMerge()

Types

MergeCondition

enum MergeCondition : Enum<AutoMerge.MergeCondition>

A condition which should be satisfied for merge to happen

MergePolicy

enum MergePolicy : Enum<AutoMerge.MergePolicy>

Settings for merge commit

RunPolicy

enum RunPolicy : Enum<AutoMerge.RunPolicy>

Policy for running merge feature

Functions

booleanParameter

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

clear

fun clear()

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): CompoundDelegateProvider<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

fun doubleParameter(customName: String? = null): SingleDelegateProvider<Double>

enumParameter

fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): SingleDelegateProvider<E>

findRawParam

fun findRawParam(paramName: String): Parameter?

hasParam

fun hasParam(paramName: String): Boolean

intParameter

fun intParameter(customName: String? = null): SingleDelegateProvider<Int>

param

fun param(name: String, value: String)

Adds parameter with specified name and value

removeRawParam

fun removeRawParam(paramName: String)

stringParameter

fun stringParameter(customName: String? = null): SingleDelegateProvider<String>

toString

open override fun toString(): String

validate

open override fun validate(consumer: ErrorConsumer)

Validates this object and reports found errors to the provided consumer

Properties

branchFilter

var branchFilter: String?

A filter for logical names of the branches whose build's sources will be merged.

commitMessage

var commitMessage: String?

A merge commit message

destinationBranch

var destinationBranch: String?

A logical name of the destination branch the sources will be merged to. The branch must be present in a repository and included into the branch specification.

enabled

var enabled: Boolean = true

Specifies whether the feature is enabled, true by default