Notifications

open class Notifications : BuildFeature
fun BuildFeatures.notifications(init: Notifications.() -> Unit): Notifications

Build feature for notification rule

Example. Adds notifications build feature that sends email notifications when build is started

buildType {
    // Other Build Type settings ...
    features {
        // Other Build Features ...
        notifications {
            notifierSettings = emailNotifier {
                email = "me@mail.com"
            }

            buildStarted = true
        }
} }

Example. Adds notifications build feature that sends email notifications when build is finished successfully

buildType {
    // Other Build Type settings ...
    features {
        // Other Build Features ...
        notifications {
            notifierSettings = emailNotifier {
                email = "me@mail.com"
            }

            buildFinishedSuccessfully = true
        }
} }

Example. Adds notifications build feature that sends email notifications when build failed, but only in "main" branch

buildType {
    // Other Build Type settings ...
    features {
        // Other Build Features ...
        notifications {
            notifierSettings = emailNotifier {
                email = "me@mail.com"
            }

            branchFilter = "+:main"
            buildFailed = true
        }
} }

See also

Constructors

Link copied to clipboard
fun Notifications(init: Notifications.() -> Unit)
Link copied to clipboard
fun Notifications()

Types

Link copied to clipboard
sealed class NotifierSettings : CompoundParam<Notifications.NotifierSettings>

Functions

Link copied to clipboard
fun booleanParameter(    customName: String? = null,     trueValue: String? = "true",     falseValue: String? = "false"): SingleDelegateProvider<Boolean>
Link copied to clipboard
fun clear()
Link copied to clipboard
fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): CompoundDelegateProvider<T>
Link copied to clipboard
fun <T : Parametrized> copyParamsTo(target: T): T

Copies parameters of this object to the specified target

Link copied to clipboard
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.

Link copied to clipboard
fun doubleParameter(customName: String? = null): SingleDelegateProvider<Double>
Link copied to clipboard

Send notifications via email

Link copied to clipboard
fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): SingleDelegateProvider<E>
Link copied to clipboard
fun findRawParam(paramName: String): Parameter?
Link copied to clipboard
fun hasParam(paramName: String): Boolean
Link copied to clipboard
fun intParameter(customName: String? = null): SingleDelegateProvider<Int>
Link copied to clipboard
fun param(name: String, value: String)

Adds parameter with specified name and value

Link copied to clipboard
fun removeRawParam(paramName: String)
Link copied to clipboard

Send notifications to Slack

Link copied to clipboard
fun stringParameter(customName: String? = null): SingleDelegateProvider<String>
Link copied to clipboard
open override fun toString(): String
Link copied to clipboard
open override fun validate(consumer: ErrorConsumer)

Validates this object and reports found errors to the provided consumer

Properties

Link copied to clipboard
var branchFilter: String?

Branch filter

Link copied to clipboard
var buildFailed: Boolean?

Send notification if build failed

Link copied to clipboard
var buildFailedToStart: Boolean?

Send notification if build fails to start

Link copied to clipboard
var buildFinishedSuccessfully: Boolean?

Send notification if build finished successfully

Link copied to clipboard
var buildProbablyHanging: Boolean?

Build is probably hanging

Link copied to clipboard
var buildStarted: Boolean?

Send notification when build started

Link copied to clipboard
var enabled: Boolean = true

Specifies whether the feature is enabled, true by default

Link copied to clipboard
var firstBuildErrorOccurs: Boolean?

Notify when the first build error occurs

Link copied to clipboard
var firstFailureAfterSuccess: Boolean?

Send notification if build failed for the first time after success

Link copied to clipboard
var firstSuccessAfterFailure: Boolean?

Send notification if build is successfull for the first time after failure

Link copied to clipboard
var id: String? = null

Build feature id, if not specified will be generated

Link copied to clipboard
var newBuildProblemOccured: Boolean?

Only notify on new build problem or new failed test

Link copied to clipboard
var newBuildProblemOccurred: Boolean?

Only notify on new build problem or new failed test

Link copied to clipboard
var notifier: String?

Notifier that will send notifications

Link copied to clipboard
var notifierSettings: Notifications.NotifierSettings?

Notifier that will send notifications

Link copied to clipboard
var notifyUntilBuildIsComplete: Boolean?

Keep notifying until build is complete (even without my changes)

Link copied to clipboard
val params: List<Parameter>
Link copied to clipboard
var queuedBuildRequiresApproval: Boolean?

Queued build requires approval

Link copied to clipboard
var type: String

Build feature type