io.github.cdklabs.projen.github

Interface GitHubProjectOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, ProjectOptions

All Known Subinterfaces:

AwsCdkConstructLibraryOptions, AwsCdkJavaAppOptions, AwsCdkTypeScriptAppOptions, Cdk8sTypeScriptAppOptions, ConstructLibraryAwsOptions, ConstructLibraryCdk8sOptions, ConstructLibraryCdktfOptions, ConstructLibraryOptions, JavaProjectCommonOptions, JavaProjectOptions, JsiiProjectOptions, NextJsProjectOptions, NextJsTypeScriptProjectOptions, NodeProjectOptions, PythonProjectOptions, ReactProjectOptions, ReactTypeScriptProjectOptions, TypeScriptLibraryProjectOptions, TypeScriptProjectOptions

All Known Implementing Classes:

AwsCdkConstructLibraryOptions.Jsii$Proxy, AwsCdkJavaAppOptions.Jsii$Proxy, AwsCdkTypeScriptAppOptions.Jsii$Proxy, Cdk8sTypeScriptAppOptions.Jsii$Proxy, ConstructLibraryAwsOptions.Jsii$Proxy, ConstructLibraryCdk8sOptions.Jsii$Proxy, ConstructLibraryCdktfOptions.Jsii$Proxy, ConstructLibraryOptions.Jsii$Proxy, GitHubProjectOptions.Jsii$Proxy, JavaProjectCommonOptions.Jsii$Proxy, JavaProjectOptions.Jsii$Proxy, JsiiProjectOptions.Jsii$Proxy, NextJsProjectOptions.Jsii$Proxy, NextJsTypeScriptProjectOptions.Jsii$Proxy, NodeProjectOptions.Jsii$Proxy, PythonProjectOptions.Jsii$Proxy, ReactProjectOptions.Jsii$Proxy, ReactTypeScriptProjectOptions.Jsii$Proxy, TypeScriptLibraryProjectOptions.Jsii$Proxy, TypeScriptProjectOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.47.0 (build 86d2c33)",
           date="2021-12-20T00:39:28.764Z")
 @Stability(value=Experimental)
public interface GitHubProjectOptions
extends software.amazon.jsii.JsiiSerializable, ProjectOptions

(experimental) Options for `GitHubProject`.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	GitHubProjectOptions.Builder A builder for GitHubProjectOptions
static class	GitHubProjectOptions.Jsii$Proxy An implementation for GitHubProjectOptions

Method Summary

Modifier and Type	Method and Description
static GitHubProjectOptions.Builder	builder()
default AutoApproveOptions	getAutoApproveOptions() (experimental) Enable and configure the 'auto approve' workflow.
default AutoMergeOptions	getAutoMergeOptions() (experimental) Configure options for automatic merging on GitHub.
default Boolean	getClobber() (experimental) Add a `clobber` task which resets the repo to origin.
default Boolean	getDevContainer() (experimental) Add a VSCode development environment (used for GitHub Codespaces).
default Boolean	getGithub() (experimental) Enable GitHub integration.
default GitHubOptions	getGithubOptions() (experimental) Options for GitHub integration.
default Boolean	getGitpod() (experimental) Add a Gitpod development environment.
default Boolean	getMergify() Deprecated. use `githubOptions.mergify` instead
default MergifyOptions	getMergifyOptions() Deprecated. use `githubOptions.mergifyOptions` instead
default ProjectType	getProjectType() Deprecated. no longer supported at the base project level
default SampleReadmeProps	getReadme() (experimental) The README setup.
default Boolean	getStale() (experimental) Auto-close of stale issues and pull request.
default StaleOptions	getStaleOptions() (experimental) Auto-close stale issues and pull requests.
default Boolean	getVscode() (experimental) Enable VSCode integration.

Methods inherited from interface io.github.cdklabs.projen.ProjectOptions

getLogging, getName, getOutdir, getParent, getProjenCommand, getProjenrcJson, getProjenrcJsonOptions

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAutoApproveOptions

@Stability(value=Experimental)
 @Nullable
default AutoApproveOptions getAutoApproveOptions()

(experimental) Enable and configure the 'auto approve' workflow.

Default: - auto approve is disabled

getAutoMergeOptions

@Stability(value=Experimental)
 @Nullable
default AutoMergeOptions getAutoMergeOptions()

(experimental) Configure options for automatic merging on GitHub.

Has no effect if github.mergify is set to false.

Default: - see defaults in `AutoMergeOptions`

getClobber

@Stability(value=Experimental)
 @Nullable
default Boolean getClobber()

(experimental) Add a `clobber` task which resets the repo to origin.

Default: true

getDevContainer

@Stability(value=Experimental)
 @Nullable
default Boolean getDevContainer()

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

Default: false

getGithub

@Stability(value=Experimental)
 @Nullable
default Boolean getGithub()

(experimental) Enable GitHub integration.

Enabled by default for root projects. Disabled for non-root projects.

Default: true

getGithubOptions

@Stability(value=Experimental)
 @Nullable
default GitHubOptions getGithubOptions()

(experimental) Options for GitHub integration.

Default: - see GitHubOptions

getGitpod

@Stability(value=Experimental)
 @Nullable
default Boolean getGitpod()

(experimental) Add a Gitpod development environment.

Default: false

getMergify

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default Boolean getMergify()

Deprecated. use `githubOptions.mergify` instead

(deprecated) Whether mergify should be enabled on this repository or not.

Default: true

getMergifyOptions

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default MergifyOptions getMergifyOptions()

Deprecated. use `githubOptions.mergifyOptions` instead

(deprecated) Options for mergify.

Default: - default options

getProjectType

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default ProjectType getProjectType()

Deprecated. no longer supported at the base project level

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

Default: ProjectType.UNKNOWN

getReadme

@Stability(value=Experimental)
 @Nullable
default SampleReadmeProps getReadme()

(experimental) The README setup.

Default: - { filename: 'README.md', contents: '# replace this' }

Example:

 // Example automatically generated from non-compiling source. May contain errors.
 "{ filename: 'readme.md', contents: '# title' }"
 

getStale

@Stability(value=Experimental)
 @Nullable
default Boolean getStale()

(experimental) Auto-close of stale issues and pull request.

See staleOptions for options.

Default: true

getStaleOptions

@Stability(value=Experimental)
 @Nullable
default StaleOptions getStaleOptions()

(experimental) Auto-close stale issues and pull requests.

To disable set stale to false.

Default: - see defaults in `StaleOptions`

getVscode

@Stability(value=Experimental)
 @Nullable
default Boolean getVscode()

(experimental) Enable VSCode integration.

Enabled by default for root projects. Disabled for non-root projects.

Default: true

builder

@Stability(value=Experimental)
static GitHubProjectOptions.Builder builder()

Specified by:

builder in interface ProjectOptions

Returns:

a GitHubProjectOptions.Builder of GitHubProjectOptions