io.github.cdklabs.projen.release

Class ReleaseProjectOptions.Builder

java.lang.Object

io.github.cdklabs.projen.release.ReleaseProjectOptions.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<ReleaseProjectOptions>

Enclosing interface:

ReleaseProjectOptions

@Stability(value=Experimental)
public static final class ReleaseProjectOptions.Builder
extends Object
implements software.amazon.jsii.Builder<ReleaseProjectOptions>

A builder for ReleaseProjectOptions

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
ReleaseProjectOptions.Builder	antitamper(Boolean antitamper) Sets the value of ReleaseProjectOptions.getAntitamper()
ReleaseProjectOptions.Builder	artifactsDirectory(String artifactsDirectory) Sets the value of ReleaseProjectOptions.getArtifactsDirectory()
ReleaseProjectOptions	build() Builds the configured instance.
ReleaseProjectOptions.Builder	jsiiReleaseVersion(String jsiiReleaseVersion) Sets the value of ReleaseProjectOptions.getJsiiReleaseVersion()
ReleaseProjectOptions.Builder	majorVersion(Number majorVersion) Sets the value of ReleaseProjectOptions.getMajorVersion()
ReleaseProjectOptions.Builder	npmDistTag(String npmDistTag) Sets the value of ReleaseProjectOptions.getNpmDistTag()
ReleaseProjectOptions.Builder	postBuildSteps(List<? extends JobStep> postBuildSteps) Sets the value of ReleaseProjectOptions.getPostBuildSteps()
ReleaseProjectOptions.Builder	prerelease(String prerelease) Sets the value of ReleaseProjectOptions.getPrerelease()
ReleaseProjectOptions.Builder	publishTasks(Boolean publishTasks) Sets the value of ReleaseProjectOptions.getPublishTasks()
ReleaseProjectOptions.Builder	releaseBranches(Map<String,? extends BranchOptions> releaseBranches) Sets the value of ReleaseProjectOptions.getReleaseBranches()
ReleaseProjectOptions.Builder	releaseEveryCommit(Boolean releaseEveryCommit) Deprecated. Use `releaseTrigger: ReleaseTrigger.continuous()` instead
ReleaseProjectOptions.Builder	releaseFailureIssue(Boolean releaseFailureIssue) Sets the value of ReleaseProjectOptions.getReleaseFailureIssue()
ReleaseProjectOptions.Builder	releaseFailureIssueLabel(String releaseFailureIssueLabel) Sets the value of ReleaseProjectOptions.getReleaseFailureIssueLabel()
ReleaseProjectOptions.Builder	releaseSchedule(String releaseSchedule) Deprecated. Use `releaseTrigger: ReleaseTrigger.scheduled()` instead
ReleaseProjectOptions.Builder	releaseTagPrefix(String releaseTagPrefix) Sets the value of ReleaseProjectOptions.getReleaseTagPrefix()
ReleaseProjectOptions.Builder	releaseTrigger(ReleaseTrigger releaseTrigger) Sets the value of ReleaseProjectOptions.getReleaseTrigger()
ReleaseProjectOptions.Builder	releaseWorkflowName(String releaseWorkflowName) Sets the value of ReleaseProjectOptions.getReleaseWorkflowName()
ReleaseProjectOptions.Builder	releaseWorkflowSetupSteps(List<? extends JobStep> releaseWorkflowSetupSteps) Sets the value of ReleaseProjectOptions.getReleaseWorkflowSetupSteps()
ReleaseProjectOptions.Builder	versionrcOptions(Map<String,? extends Object> versionrcOptions) Sets the value of ReleaseProjectOptions.getVersionrcOptions()
ReleaseProjectOptions.Builder	workflowContainerImage(String workflowContainerImage) Sets the value of ReleaseProjectOptions.getWorkflowContainerImage()
ReleaseProjectOptions.Builder	workflowRunsOn(List<String> workflowRunsOn) Sets the value of ReleaseProjectOptions.getWorkflowRunsOn()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

antitamper

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder antitamper(Boolean antitamper)

Sets the value of ReleaseProjectOptions.getAntitamper()

Parameters:

antitamper - Checks that after build there are no modified files on git.

Returns:

this

artifactsDirectory

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder artifactsDirectory(String artifactsDirectory)

Sets the value of ReleaseProjectOptions.getArtifactsDirectory()

Parameters:

artifactsDirectory - A directory which will contain artifacts to be published to npm.

Returns:

this

jsiiReleaseVersion

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder jsiiReleaseVersion(String jsiiReleaseVersion)

Sets the value of ReleaseProjectOptions.getJsiiReleaseVersion()

Parameters:

jsiiReleaseVersion - Version requirement of `jsii-release` which is used to publish modules to npm.

Returns:

this

majorVersion

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder majorVersion(Number majorVersion)

Sets the value of ReleaseProjectOptions.getMajorVersion()

Parameters:

majorVersion - Major version to release from the default branch. If this is specified, we bump the latest version of this major version line. If not specified, we bump the global latest version.

Returns:

this

npmDistTag

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder npmDistTag(String npmDistTag)

Sets the value of ReleaseProjectOptions.getNpmDistTag()

Parameters:

npmDistTag - The npmDistTag to use when publishing from the default branch. To set the npm dist-tag for release branches, set the npmDistTag property for each branch.

Returns:

this

postBuildSteps

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder postBuildSteps(List<? extends JobStep> postBuildSteps)

Sets the value of ReleaseProjectOptions.getPostBuildSteps()

Parameters:

postBuildSteps - Steps to execute after build as part of the release workflow.

Returns:

this

prerelease

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder prerelease(String prerelease)

Sets the value of ReleaseProjectOptions.getPrerelease()

Parameters:

prerelease - Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre").

Returns:

this

publishTasks

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder publishTasks(Boolean publishTasks)

Sets the value of ReleaseProjectOptions.getPublishTasks()

Parameters:

publishTasks - Define publishing tasks that can be executed manually as well as workflows. Normally, publishing only happens within automated workflows. Enable this in order to create a publishing task for each publishing activity.

Returns:

this

releaseBranches

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseBranches(Map<String,? extends BranchOptions> releaseBranches)

Sets the value of ReleaseProjectOptions.getReleaseBranches()

Parameters:

releaseBranches - Defines additional release branches. A workflow will be created for each release branch which will publish releases from commits in this branch. Each release branch must be assigned a major version number which is used to enforce that versions published from that branch always use that major version. If multiple branches are used, the majorVersion field must also be provided for the default branch.

Returns:

this

releaseEveryCommit

@Stability(value=Deprecated)
 @Deprecated
public ReleaseProjectOptions.Builder releaseEveryCommit(Boolean releaseEveryCommit)

Deprecated. Use `releaseTrigger: ReleaseTrigger.continuous()` instead

Sets the value of ReleaseProjectOptions.getReleaseEveryCommit()

Parameters:

releaseEveryCommit - Automatically release new versions every commit to one of branches in `releaseBranches`.

Returns:

this

releaseFailureIssue

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseFailureIssue(Boolean releaseFailureIssue)

Sets the value of ReleaseProjectOptions.getReleaseFailureIssue()

Parameters:

releaseFailureIssue - Create a github issue on every failed publishing task.

Returns:

this

releaseFailureIssueLabel

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseFailureIssueLabel(String releaseFailureIssueLabel)

Sets the value of ReleaseProjectOptions.getReleaseFailureIssueLabel()

Parameters:

releaseFailureIssueLabel - The label to apply to issues indicating publish failures. Only applies if releaseFailureIssue is true.

Returns:

this

releaseSchedule

@Stability(value=Deprecated)
 @Deprecated
public ReleaseProjectOptions.Builder releaseSchedule(String releaseSchedule)

Deprecated. Use `releaseTrigger: ReleaseTrigger.scheduled()` instead

Sets the value of ReleaseProjectOptions.getReleaseSchedule()

Parameters:

releaseSchedule - CRON schedule to trigger new releases.

Returns:

this

releaseTagPrefix

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseTagPrefix(String releaseTagPrefix)

Sets the value of ReleaseProjectOptions.getReleaseTagPrefix()

Parameters:

releaseTagPrefix - Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Note: this prefix is used to detect the latest tagged version when bumping, so if you change this on a project with an existing version history, you may need to manually tag your latest release with the new prefix.

Returns:

this

releaseTrigger

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseTrigger(ReleaseTrigger releaseTrigger)

Sets the value of ReleaseProjectOptions.getReleaseTrigger()

Parameters:

releaseTrigger - The release trigger to use.

Returns:

this

releaseWorkflowName

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseWorkflowName(String releaseWorkflowName)

Sets the value of ReleaseProjectOptions.getReleaseWorkflowName()

Parameters:

releaseWorkflowName - The name of the default release workflow.

Returns:

this

releaseWorkflowSetupSteps

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder releaseWorkflowSetupSteps(List<? extends JobStep> releaseWorkflowSetupSteps)

Sets the value of ReleaseProjectOptions.getReleaseWorkflowSetupSteps()

Parameters:

releaseWorkflowSetupSteps - A set of workflow steps to execute in order to setup the workflow container.

Returns:

this

versionrcOptions

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder versionrcOptions(Map<String,? extends Object> versionrcOptions)

Sets the value of ReleaseProjectOptions.getVersionrcOptions()

Parameters:

versionrcOptions - Custom configuration used when creating changelog with standard-version package. Given values either append to default configuration or overwrite values in it.

Returns:

this

workflowContainerImage

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder workflowContainerImage(String workflowContainerImage)

Sets the value of ReleaseProjectOptions.getWorkflowContainerImage()

Parameters:

workflowContainerImage - Container image to use for GitHub workflows.

Returns:

this

workflowRunsOn

@Stability(value=Experimental)
public ReleaseProjectOptions.Builder workflowRunsOn(List<String> workflowRunsOn)

Sets the value of ReleaseProjectOptions.getWorkflowRunsOn()

Parameters:

workflowRunsOn - Github Runner selection labels.

Returns:

this

build

@Stability(value=Experimental)
public ReleaseProjectOptions build()

Builds the configured instance.

Specified by:

build in interface software.amazon.jsii.Builder<ReleaseProjectOptions>

Returns:

a new instance of ReleaseProjectOptions

Throws:

NullPointerException - if any required attribute was not provided