io.github.cdklabs.projen.github

Class GitHubProjectOptions.Builder

java.lang.Object

io.github.cdklabs.projen.github.GitHubProjectOptions.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<GitHubProjectOptions>

Enclosing interface:

GitHubProjectOptions

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

A builder for GitHubProjectOptions

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
GitHubProjectOptions.Builder	autoApproveOptions(AutoApproveOptions autoApproveOptions) Sets the value of GitHubProjectOptions.getAutoApproveOptions()
GitHubProjectOptions.Builder	autoMergeOptions(AutoMergeOptions autoMergeOptions) Sets the value of GitHubProjectOptions.getAutoMergeOptions()
GitHubProjectOptions	build() Builds the configured instance.
GitHubProjectOptions.Builder	clobber(Boolean clobber) Sets the value of GitHubProjectOptions.getClobber()
GitHubProjectOptions.Builder	devContainer(Boolean devContainer) Sets the value of GitHubProjectOptions.getDevContainer()
GitHubProjectOptions.Builder	github(Boolean github) Sets the value of GitHubProjectOptions.getGithub()
GitHubProjectOptions.Builder	githubOptions(GitHubOptions githubOptions) Sets the value of GitHubProjectOptions.getGithubOptions()
GitHubProjectOptions.Builder	gitpod(Boolean gitpod) Sets the value of GitHubProjectOptions.getGitpod()
GitHubProjectOptions.Builder	logging(LoggerOptions logging) Sets the value of ProjectOptions.getLogging()
GitHubProjectOptions.Builder	mergify(Boolean mergify) Deprecated. use `githubOptions.mergify` instead
GitHubProjectOptions.Builder	mergifyOptions(MergifyOptions mergifyOptions) Deprecated. use `githubOptions.mergifyOptions` instead
GitHubProjectOptions.Builder	name(String name) Sets the value of ProjectOptions.getName()
GitHubProjectOptions.Builder	outdir(String outdir) Sets the value of ProjectOptions.getOutdir()
GitHubProjectOptions.Builder	parent(Project parent) Sets the value of ProjectOptions.getParent()
GitHubProjectOptions.Builder	projectType(ProjectType projectType) Deprecated. no longer supported at the base project level
GitHubProjectOptions.Builder	projenCommand(String projenCommand) Sets the value of ProjectOptions.getProjenCommand()
GitHubProjectOptions.Builder	projenrcJson(Boolean projenrcJson) Sets the value of ProjectOptions.getProjenrcJson()
GitHubProjectOptions.Builder	projenrcJsonOptions(ProjenrcOptions projenrcJsonOptions) Sets the value of ProjectOptions.getProjenrcJsonOptions()
GitHubProjectOptions.Builder	readme(SampleReadmeProps readme) Sets the value of GitHubProjectOptions.getReadme()
GitHubProjectOptions.Builder	stale(Boolean stale) Sets the value of GitHubProjectOptions.getStale()
GitHubProjectOptions.Builder	staleOptions(StaleOptions staleOptions) Sets the value of GitHubProjectOptions.getStaleOptions()
GitHubProjectOptions.Builder	vscode(Boolean vscode) Sets the value of GitHubProjectOptions.getVscode()

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

autoApproveOptions

@Stability(value=Experimental)
public GitHubProjectOptions.Builder autoApproveOptions(AutoApproveOptions autoApproveOptions)

Sets the value of GitHubProjectOptions.getAutoApproveOptions()

Parameters:

autoApproveOptions - Enable and configure the 'auto approve' workflow.

Returns:

this

autoMergeOptions

@Stability(value=Experimental)
public GitHubProjectOptions.Builder autoMergeOptions(AutoMergeOptions autoMergeOptions)

Sets the value of GitHubProjectOptions.getAutoMergeOptions()

Parameters:

autoMergeOptions - Configure options for automatic merging on GitHub. Has no effect if github.mergify is set to false.

Returns:

this

clobber

@Stability(value=Experimental)
public GitHubProjectOptions.Builder clobber(Boolean clobber)

Sets the value of GitHubProjectOptions.getClobber()

Parameters:

clobber - Add a `clobber` task which resets the repo to origin.

Returns:

this

devContainer

@Stability(value=Experimental)
public GitHubProjectOptions.Builder devContainer(Boolean devContainer)

Sets the value of GitHubProjectOptions.getDevContainer()

Parameters:

devContainer - Add a VSCode development environment (used for GitHub Codespaces).

Returns:

this

github

@Stability(value=Experimental)
public GitHubProjectOptions.Builder github(Boolean github)

Sets the value of GitHubProjectOptions.getGithub()

Parameters:

github - Enable GitHub integration. Enabled by default for root projects. Disabled for non-root projects.

Returns:

this

githubOptions

@Stability(value=Experimental)
public GitHubProjectOptions.Builder githubOptions(GitHubOptions githubOptions)

Sets the value of GitHubProjectOptions.getGithubOptions()

Parameters:

githubOptions - Options for GitHub integration.

Returns:

this

gitpod

@Stability(value=Experimental)
public GitHubProjectOptions.Builder gitpod(Boolean gitpod)

Sets the value of GitHubProjectOptions.getGitpod()

Parameters:

gitpod - Add a Gitpod development environment.

Returns:

this

mergify

@Stability(value=Deprecated)
 @Deprecated
public GitHubProjectOptions.Builder mergify(Boolean mergify)

Deprecated. use `githubOptions.mergify` instead

Sets the value of GitHubProjectOptions.getMergify()

Parameters:

mergify - Whether mergify should be enabled on this repository or not.

Returns:

this

mergifyOptions

@Stability(value=Deprecated)
 @Deprecated
public GitHubProjectOptions.Builder mergifyOptions(MergifyOptions mergifyOptions)

Deprecated. use `githubOptions.mergifyOptions` instead

Sets the value of GitHubProjectOptions.getMergifyOptions()

Parameters:

mergifyOptions - Options for mergify.

Returns:

this

projectType

@Stability(value=Deprecated)
 @Deprecated
public GitHubProjectOptions.Builder projectType(ProjectType projectType)

Deprecated. no longer supported at the base project level

Sets the value of GitHubProjectOptions.getProjectType()

Parameters:

projectType - Which type of project this is (library/app).

Returns:

this

readme

@Stability(value=Experimental)
public GitHubProjectOptions.Builder readme(SampleReadmeProps readme)

Sets the value of GitHubProjectOptions.getReadme()

Parameters:

readme - The README setup.

Returns:

this

stale

@Stability(value=Experimental)
public GitHubProjectOptions.Builder stale(Boolean stale)

Sets the value of GitHubProjectOptions.getStale()

Parameters:

stale - Auto-close of stale issues and pull request. See staleOptions for options.

Returns:

this

staleOptions

@Stability(value=Experimental)
public GitHubProjectOptions.Builder staleOptions(StaleOptions staleOptions)

Sets the value of GitHubProjectOptions.getStaleOptions()

Parameters:

staleOptions - Auto-close stale issues and pull requests. To disable set stale to false.

Returns:

this

vscode

@Stability(value=Experimental)
public GitHubProjectOptions.Builder vscode(Boolean vscode)

Sets the value of GitHubProjectOptions.getVscode()

Parameters:

vscode - Enable VSCode integration. Enabled by default for root projects. Disabled for non-root projects.

Returns:

this

name

@Stability(value=Experimental)
public GitHubProjectOptions.Builder name(String name)

Sets the value of ProjectOptions.getName()

Parameters:

name - This is the name of your project. This parameter is required.

Returns:

this

logging

@Stability(value=Experimental)
public GitHubProjectOptions.Builder logging(LoggerOptions logging)

Sets the value of ProjectOptions.getLogging()

Parameters:

logging - Configure logging options such as verbosity.

Returns:

this

outdir

@Stability(value=Experimental)
public GitHubProjectOptions.Builder outdir(String outdir)

Sets the value of ProjectOptions.getOutdir()

Parameters:

outdir - The root directory of the project. Relative to this directory, all files are synthesized.

If this project has a parent, this directory is relative to the parent directory and it cannot be the same as the parent or any of it's other sub-projects.

Returns:

this

parent

@Stability(value=Experimental)
public GitHubProjectOptions.Builder parent(Project parent)

Sets the value of ProjectOptions.getParent()

Parameters:

parent - The parent project, if this project is part of a bigger project.

Returns:

this

projenCommand

@Stability(value=Experimental)
public GitHubProjectOptions.Builder projenCommand(String projenCommand)

Sets the value of ProjectOptions.getProjenCommand()

Parameters:

projenCommand - The shell command to use in order to run the projen CLI. Can be used to customize in special environments.

Returns:

this

projenrcJson

@Stability(value=Experimental)
public GitHubProjectOptions.Builder projenrcJson(Boolean projenrcJson)

Sets the value of ProjectOptions.getProjenrcJson()

Parameters:

projenrcJson - Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation.

Returns:

this

projenrcJsonOptions

@Stability(value=Experimental)
public GitHubProjectOptions.Builder projenrcJsonOptions(ProjenrcOptions projenrcJsonOptions)

Sets the value of ProjectOptions.getProjenrcJsonOptions()

Parameters:

projenrcJsonOptions - Options for .projenrc.json.

Returns:

this

build

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

Builds the configured instance.

Specified by:

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

Returns:

a new instance of GitHubProjectOptions

Throws:

NullPointerException - if any required attribute was not provided