API Reference
Constructs
InfrastructureJavaProject
Synthesizes a Infrastructure Java Project.
Initializers
import software.aws.pdk.infrastructure.InfrastructureJavaProject;
InfrastructureJavaProject.Builder.create()
.name(java.lang.String)
// .artifactId(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .buildCommand(java.lang.String)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .clobber(java.lang.Boolean)
// .commitGenerated(java.lang.Boolean)
// .compileOptions(MavenCompileOptions)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .deps(java.util.List<java.lang.String>)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .distdir(java.lang.String)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .groupId(java.lang.String)
// .junit(java.lang.Boolean)
// .junitOptions(JunitOptions)
// .logging(LoggerOptions)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .outdir(java.lang.String)
// .packaging(java.lang.String)
// .packagingOptions(MavenPackagingOptions)
// .parent(Project)
// .parentPom(ParentPom)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenrcJava(java.lang.Boolean)
// .projenrcJavaOptions(ProjenrcOptions)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenTokenSecret(java.lang.String)
// .readme(SampleReadmeProps)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .requireApproval(ApprovalLevel)
// .sample(java.lang.Boolean)
// .sampleJavaPackage(java.lang.String)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testDeps(java.util.List<java.lang.String>)
// .url(java.lang.String)
// .version(java.lang.String)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .allowSignup(java.lang.Boolean)
// .cloudscapeReactTsWebsite(CloudscapeReactTsWebsiteProject)
// .cloudscapeReactTsWebsites(java.util.List<CloudscapeReactTsWebsiteProject>)
// .stackName(java.lang.String)
// .stages(java.util.List<DeploymentStage>)
// .typeSafeApi(TypeSafeApiProject)
// .typeSafeApis(java.util.List<TypeSafeApiProject>)
.build();
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
artifactId |
java.lang.String |
The artifactId is generally the name that the project is known by. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
compileOptions |
io.github.cdklabs.projen.java.MavenCompileOptions |
Compile options. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
deps |
java.util.List |
List of runtime dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver> . |
description |
java.lang.String |
Description of a project is always good. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
distdir |
java.lang.String |
Final artifact output directory. |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
groupId |
java.lang.String |
This is generally unique amongst an organization or a project. |
junit |
java.lang.Boolean |
Include junit tests. |
junitOptions |
io.github.cdklabs.projen.java.JunitOptions |
junit options. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
packaging |
java.lang.String |
Project packaging format. |
packagingOptions |
io.github.cdklabs.projen.java.MavenPackagingOptions |
Packaging options. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
parentPom |
io.github.cdklabs.projen.java.ParentPom |
A Parent Pom can be used to have a child project inherit properties/plugins/ect in order to reduce duplication and keep standards across a large amount of repos. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenrcJava |
java.lang.Boolean |
Use projenrc in java. |
projenrcJavaOptions |
io.github.cdklabs.projen.java.ProjenrcOptions |
Options related to projenrc in java. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sample |
java.lang.Boolean |
Include sample code and test if the relevant directories don't exist. |
sampleJavaPackage |
java.lang.String |
The java package to use for the code sample. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testDeps |
java.util.List |
List of test dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver> . |
url |
java.lang.String |
The URL, like the name, is not required. |
version |
java.lang.String |
This is the last piece of the naming puzzle. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
allowSignup |
java.lang.Boolean |
Allow self sign up for the UserIdentity construct. |
cloudscapeReactTsWebsite |
software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject |
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code. |
cloudscapeReactTsWebsites |
java.util.List |
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code. |
stackName |
java.lang.String |
Stack name. |
stages |
java.util.List<DeploymentStage> |
List of deployment stages. |
typeSafeApi |
software.aws.pdk.infrastructure.TypeSafeApiProject |
TypeSafeApi instance to use when setting up the initial project sample code. |
typeSafeApis |
java.util.List |
TypeSafeApi instances to use when setting up the initial project sample code. |
name
Required
- Type: java.lang.String
- Default: $BASEDIR
artifactId
Optional
- Type: java.lang.String
- Default: "my-app"
The artifactId is generally the name that the project is known by.
Although the groupId is important, people within the group will rarely mention the groupId in discussion (they are often all be the same ID, such as the MojoHaus project groupId: org.codehaus.mojo). It, along with the groupId, creates a key that separates this project from every other project in the world (at least, it should :) ). Along with the groupId, the artifactId fully defines the artifact's living quarters within the repository. In the case of the above project, my-project lives in $M2_REPO/org/codehaus/mojo/my-project.
autoApproveOptions
Optional
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoMerge
Optional
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
buildCommand
Optional
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
~~cdkAssert
~~Optional
-
Deprecated: The
-
Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
-
Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
-
Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
-
Deprecated: Not supported in CDK v2.
-
Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
-
Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
-
Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
clobber
Optional
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
commitGenerated
Optional
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
compileOptions
Optional
- Type: io.github.cdklabs.projen.java.MavenCompileOptions
- Default: defaults
Compile options.
constructsVersion
Optional
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
deps
Optional
- Type: java.util.List
- Default: []
List of runtime dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver>
.
Additional dependencies can be added via project.addDependency()
.
description
Optional
- Type: java.lang.String
- Default: undefined
Description of a project is always good.
Although this should not replace formal documentation, a quick comment to any readers of the POM is always helpful.
devContainer
Optional
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
distdir
Optional
- Type: java.lang.String
- Default: "dist/java"
Final artifact output directory.
featureFlags
Optional
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitIgnoreOptions
Optional
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
groupId
Optional
- Type: java.lang.String
- Default: "org.acme"
This is generally unique amongst an organization or a project.
For example, all core Maven artifacts do (well, should) live under the groupId org.apache.maven. Group ID's do not necessarily use the dot notation, for example, the junit project. Note that the dot-notated groupId does not have to correspond to the package structure that the project contains. It is, however, a good practice to follow. When stored within a repository, the group acts much like the Java packaging structure does in an operating system. The dots are replaced by OS specific directory separators (such as '/' in Unix) which becomes a relative directory structure from the base repository. In the example given, the org.codehaus.mojo group lives within the directory $M2_REPO/org/codehaus/mojo.
junit
Optional
- Type: java.lang.Boolean
- Default: true
Include junit tests.
junitOptions
Optional
- Type: io.github.cdklabs.projen.java.JunitOptions
- Default: defaults
junit options.
logging
Optional
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
~~mergify
~~Optional
-
Deprecated: use
githubOptions.mergify
instead -
Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
-
Deprecated: use
githubOptions.mergifyOptions
instead -
Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
outdir
Optional
- Type: java.lang.String
- Default: "."
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 subprojects.
packaging
Optional
- Type: java.lang.String
- Default: "jar"
Project packaging format.
packagingOptions
Optional
- Type: io.github.cdklabs.projen.java.MavenPackagingOptions
- Default: defaults
Packaging options.
parent
Optional
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
parentPom
Optional
- Type: io.github.cdklabs.projen.java.ParentPom
- Default: undefined
A Parent Pom can be used to have a child project inherit properties/plugins/ect in order to reduce duplication and keep standards across a large amount of repos.
~~projectType
~~Optional
-
Deprecated: no longer supported at the base project level
-
Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenrcJava
Optional
- Type: java.lang.Boolean
- Default: true
Use projenrc in java.
This will install projen
as a java dependency and will add a synth
task which
will compile & execute main()
from src/main/java/projenrc.java
.
projenrcJavaOptions
Optional
- Type: io.github.cdklabs.projen.java.ProjenrcOptions
- Default: default options
Options related to projenrc in java.
projenrcJson
Optional
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
~~projenTokenSecret
~~Optional
-
Deprecated: use
projenCredentials
-
Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
readme
Optional
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
renovatebot
Optional
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
requireApproval
Optional
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sample
Optional
- Type: java.lang.Boolean
- Default: true
Include sample code and test if the relevant directories don't exist.
sampleJavaPackage
Optional
- Type: java.lang.String
- Default: "org.acme"
The java package to use for the code sample.
stale
Optional
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testDeps
Optional
- Type: java.util.List
- Default: []
List of test dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver>
.
Additional dependencies can be added via project.addTestDependency()
.
url
Optional
- Type: java.lang.String
- Default: undefined
The URL, like the name, is not required.
This is a nice gesture for projects users, however, so that they know where the project lives.
version
Optional
- Type: java.lang.String
- Default: "0.1.0"
This is the last piece of the naming puzzle.
groupId:artifactId denotes a single project but they cannot delineate which incarnation of that project we are talking about. Do we want the junit:junit of 2018 (version 4.12), or of 2007 (version 3.8.2)? In short: code changes, those changes should be versioned, and this element keeps those versions in line. It is also used within an artifact's repository to separate versions from each other. my-project version 1.0 files live in the directory structure $M2_REPO/org/codehaus/mojo/my-project/1.0.
vscode
Optional
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
allowSignup
Optional
- Type: java.lang.Boolean
- Default: false
Allow self sign up for the UserIdentity construct.
~~cloudscapeReactTsWebsite
~~Optional
-
Deprecated: use cloudscapeReactTsWebsites
-
Type: software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code.
cloudscapeReactTsWebsites
Optional
- Type: java.util.List
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code.
stackName
Optional
- Type: java.lang.String
- Default: infra-dev
Stack name.
stages
Optional
- Type: java.util.List<DeploymentStage>
List of deployment stages.
~~typeSafeApi
~~Optional
-
Deprecated: use typeSafeApis
-
Type: software.aws.pdk.infrastructure.TypeSafeApiProject
TypeSafeApi instance to use when setting up the initial project sample code.
typeSafeApis
Optional
- Type: java.util.List
TypeSafeApi instances to use when setting up the initial project sample code.
Methods
Name | Description |
---|---|
toString |
Returns a string representation of this construct. |
addExcludeFromCleanup |
Exclude the matching files from pre-synth cleanup. |
addGitIgnore |
Adds a .gitignore pattern. |
addPackageIgnore |
Exclude these files from the bundled package. |
addTask |
Adds a new task to this project. |
addTip |
Prints a "tip" message during synthesis. |
annotateGenerated |
Marks the provided file(s) as being generated. |
postSynthesize |
Called after all components are synthesized. |
preSynthesize |
Called before all components are synthesized. |
removeTask |
Removes a task from a project. |
runTaskCommand |
Returns the shell command to execute in order to run a task. |
synth |
Synthesize all project files into outdir . |
tryFindFile |
Finds a file at the specified relative path within this project and all its subprojects. |
tryFindJsonFile |
Finds a json file by name. |
tryFindObjectFile |
Finds an object file (like JsonFile, YamlFile, etc.) by name. |
tryRemoveFile |
Finds a file at the specified relative path within this project and removes it. |
addDependency |
Adds a runtime dependency. |
addPlugin |
Adds a build plugin to the pom. |
addTestDependency |
Adds a test dependency. |
addCdkDependency |
Adds an AWS CDK module dependencies. |
toString
public java.lang.String toString()
Returns a string representation of this construct.
addExcludeFromCleanup
public void addExcludeFromCleanup(java.lang.String globs)
Exclude the matching files from pre-synth cleanup.
Can be used when, for example, some source files include the projen marker and we don't want them to be erased during synth.
globs
Required
- Type: java.lang.String
The glob patterns to match.
addGitIgnore
public void addGitIgnore(java.lang.String pattern)
Adds a .gitignore pattern.
pattern
Required
- Type: java.lang.String
The glob pattern to ignore.
addPackageIgnore
public void addPackageIgnore(java.lang.String _pattern)
Exclude these files from the bundled package.
Implemented by project types based on the
packaging mechanism. For example, NodeProject
delegates this to .npmignore
.
_pattern
Required
- Type: java.lang.String
The glob pattern to exclude.
addTask
public Task addTask(java.lang.String name)
public Task addTask(java.lang.String name, TaskOptions props)
Adds a new task to this project.
This will fail if the project already has a task with this name.
name
Required
- Type: java.lang.String
The task name to add.
props
Optional
- Type: io.github.cdklabs.projen.TaskOptions
Task properties.
~~addTip
~~
public void addTip(java.lang.String message)
Prints a "tip" message during synthesis.
message
Required
- Type: java.lang.String
The message.
annotateGenerated
public void annotateGenerated(java.lang.String glob)
Marks the provided file(s) as being generated.
This is achieved using the github-linguist attributes. Generated files do not count against the repository statistics and language breakdown.
https://github.com/github/linguist/blob/master/docs/overrides.md
glob
Required
- Type: java.lang.String
the glob pattern to match (could be a file path).
postSynthesize
public void postSynthesize()
Called after all components are synthesized.
Order is not guaranteed.
preSynthesize
public void preSynthesize()
Called before all components are synthesized.
removeTask
public Task removeTask(java.lang.String name)
Removes a task from a project.
name
Required
- Type: java.lang.String
The name of the task to remove.
runTaskCommand
public java.lang.String runTaskCommand(Task task)
Returns the shell command to execute in order to run a task.
By default, this is npx projen@<version> <task>
task
Required
- Type: io.github.cdklabs.projen.Task
The task for which the command is required.
synth
public void synth()
Synthesize all project files into outdir
.
- Call "this.preSynthesize()"
- Delete all generated files
- Synthesize all subprojects
- Synthesize all components of this project
- Call "postSynthesize()" for all components of this project
- Call "this.postSynthesize()"
tryFindFile
public FileBase tryFindFile(java.lang.String filePath)
Finds a file at the specified relative path within this project and all its subprojects.
filePath
Required
- Type: java.lang.String
The file path.
If this path is relative, it will be resolved from the root of this project.
~~tryFindJsonFile
~~
public JsonFile tryFindJsonFile(java.lang.String filePath)
Finds a json file by name.
filePath
Required
- Type: java.lang.String
The file path.
tryFindObjectFile
public ObjectFile tryFindObjectFile(java.lang.String filePath)
Finds an object file (like JsonFile, YamlFile, etc.) by name.
filePath
Required
- Type: java.lang.String
The file path.
tryRemoveFile
public FileBase tryRemoveFile(java.lang.String filePath)
Finds a file at the specified relative path within this project and removes it.
filePath
Required
- Type: java.lang.String
The file path.
If this path is relative, it will be resolved from the root of this project.
addDependency
public void addDependency(java.lang.String spec)
Adds a runtime dependency.
spec
Required
- Type: java.lang.String
Format <groupId>/<artifactId>@<semver>
.
addPlugin
public Dependency addPlugin(java.lang.String spec)
public Dependency addPlugin(java.lang.String spec, PluginOptions options)
Adds a build plugin to the pom.
The plug in is also added as a BUILD dep to the project.
spec
Required
- Type: java.lang.String
dependency spec (group/artifact@version
).
options
Optional
- Type: io.github.cdklabs.projen.java.PluginOptions
plugin options.
addTestDependency
public void addTestDependency(java.lang.String spec)
Adds a test dependency.
spec
Required
- Type: java.lang.String
Format <groupId>/<artifactId>@<semver>
.
~~addCdkDependency
~~
public void addCdkDependency(java.lang.String modules)
Adds an AWS CDK module dependencies.
modules
Required
- Type: java.lang.String
The list of modules to depend on (e.g. "software.amazon.awscdk/aws-lambda", "software.amazon.awscdk/aws-iam", etc).
Static Functions
Name | Description |
---|---|
isConstruct |
Checks if x is a construct. |
isProject |
Test whether the given construct is a project. |
of |
Find the closest ancestor project for given construct. |
isConstruct
import software.aws.pdk.infrastructure.InfrastructureJavaProject;
InfrastructureJavaProject.isConstruct(java.lang.Object x)
Checks if x
is a construct.
Use this method instead of instanceof
to properly detect Construct
instances, even when the construct library is symlinked.
Explanation: in JavaScript, multiple copies of the constructs
library on
disk are seen as independent, completely different libraries. As a
consequence, the class Construct
in each copy of the constructs
library
is seen as a different class, and an instance of one class will not test as
instanceof
the other class. npm install
will not create installations
like this, but users may manually symlink construct libraries together or
use a monorepo tool: in those cases, multiple copies of the constructs
library can be accidentally installed, and instanceof
will behave
unpredictably. It is safest to avoid using instanceof
, and using
this type-testing method instead.
x
Required
- Type: java.lang.Object
Any object.
isProject
import software.aws.pdk.infrastructure.InfrastructureJavaProject;
InfrastructureJavaProject.isProject(java.lang.Object x)
Test whether the given construct is a project.
x
Required
- Type: java.lang.Object
of
import software.aws.pdk.infrastructure.InfrastructureJavaProject;
InfrastructureJavaProject.of(IConstruct construct)
Find the closest ancestor project for given construct.
When given a project, this it the project itself.
construct
Required
- Type: software.constructs.IConstruct
Properties
Name | Type | Description |
---|---|---|
node |
software.constructs.Node |
The tree node. |
buildTask |
io.github.cdklabs.projen.Task |
No description. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
compileTask |
io.github.cdklabs.projen.Task |
No description. |
components |
java.util.List |
Returns all the components within this project. |
deps |
io.github.cdklabs.projen.Dependencies |
Project dependencies. |
ejected |
java.lang.Boolean |
Whether or not the project is being ejected. |
files |
java.util.List |
All files in this project. |
gitattributes |
io.github.cdklabs.projen.GitAttributesFile |
The .gitattributes file for this repository. |
gitignore |
io.github.cdklabs.projen.IgnoreFile |
.gitignore. |
logger |
io.github.cdklabs.projen.Logger |
Logging utilities. |
name |
java.lang.String |
Project name. |
outdir |
java.lang.String |
Absolute output directory of this project. |
packageTask |
io.github.cdklabs.projen.Task |
No description. |
postCompileTask |
io.github.cdklabs.projen.Task |
No description. |
preCompileTask |
io.github.cdklabs.projen.Task |
No description. |
projectBuild |
io.github.cdklabs.projen.ProjectBuild |
Manages the build process of the project. |
projenCommand |
java.lang.String |
The command to use in order to run the projen CLI. |
root |
io.github.cdklabs.projen.Project |
The root project. |
subprojects |
java.util.List |
Returns all the subprojects within this project. |
tasks |
io.github.cdklabs.projen.Tasks |
Project tasks. |
testTask |
io.github.cdklabs.projen.Task |
No description. |
defaultTask |
io.github.cdklabs.projen.Task |
This is the "default" task, the one that executes "projen". |
initProject |
io.github.cdklabs.projen.InitProject |
The options used when this project is bootstrapped via projen new . |
parent |
io.github.cdklabs.projen.Project |
A parent project. |
projectType |
io.github.cdklabs.projen.ProjectType |
No description. |
autoApprove |
io.github.cdklabs.projen.github.AutoApprove |
Auto approve set up for this project. |
devContainer |
io.github.cdklabs.projen.vscode.DevContainer |
Access for .devcontainer.json (used for GitHub Codespaces). |
github |
io.github.cdklabs.projen.github.GitHub |
Access all github components. |
gitpod |
io.github.cdklabs.projen.Gitpod |
Access for Gitpod. |
vscode |
io.github.cdklabs.projen.vscode.VsCode |
Access all VSCode components. |
compile |
io.github.cdklabs.projen.java.MavenCompile |
Compile component. |
distdir |
java.lang.String |
Maven artifact output directory. |
packaging |
io.github.cdklabs.projen.java.MavenPackaging |
Packaging component. |
pom |
io.github.cdklabs.projen.java.Pom |
API for managing pom.xml . |
junit |
io.github.cdklabs.projen.java.Junit |
JUnit component. |
projenrc |
io.github.cdklabs.projen.java.Projenrc |
Projenrc component. |
cdkConfig |
io.github.cdklabs.projen.awscdk.CdkConfig |
The cdk.json file. |
cdkDeps |
io.github.cdklabs.projen.awscdk.AwsCdkDeps |
CDK dependency management helper class. |
cdkTasks |
io.github.cdklabs.projen.awscdk.CdkTasks |
CDK tasks. |
mainClass |
java.lang.String |
The full name of the main class of the java app (package.Class). |
mainClassName |
java.lang.String |
The name of the Java class with the static main() method. |
mainPackage |
java.lang.String |
The name of the Java package that includes the main class. |
node
Required
public Node getNode();
- Type: software.constructs.Node
The tree node.
buildTask
Required
public Task getBuildTask();
- Type: io.github.cdklabs.projen.Task
commitGenerated
Required
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
Whether to commit the managed files by default.
compileTask
Required
public Task getCompileTask();
- Type: io.github.cdklabs.projen.Task
components
Required
public java.util.List<Component> getComponents();
- Type: java.util.List
Returns all the components within this project.
deps
Required
public Dependencies getDeps();
- Type: io.github.cdklabs.projen.Dependencies
Project dependencies.
ejected
Required
public java.lang.Boolean getEjected();
- Type: java.lang.Boolean
Whether or not the project is being ejected.
files
Required
public java.util.List<FileBase> getFiles();
- Type: java.util.List
All files in this project.
gitattributes
Required
public GitAttributesFile getGitattributes();
- Type: io.github.cdklabs.projen.GitAttributesFile
The .gitattributes file for this repository.
gitignore
Required
public IgnoreFile getGitignore();
- Type: io.github.cdklabs.projen.IgnoreFile
.gitignore.
logger
Required
public Logger getLogger();
- Type: io.github.cdklabs.projen.Logger
Logging utilities.
name
Required
public java.lang.String getName();
- Type: java.lang.String
Project name.
outdir
Required
public java.lang.String getOutdir();
- Type: java.lang.String
Absolute output directory of this project.
packageTask
Required
public Task getPackageTask();
- Type: io.github.cdklabs.projen.Task
postCompileTask
Required
public Task getPostCompileTask();
- Type: io.github.cdklabs.projen.Task
preCompileTask
Required
public Task getPreCompileTask();
- Type: io.github.cdklabs.projen.Task
projectBuild
Required
public ProjectBuild getProjectBuild();
- Type: io.github.cdklabs.projen.ProjectBuild
Manages the build process of the project.
projenCommand
Required
public java.lang.String getProjenCommand();
- Type: java.lang.String
The command to use in order to run the projen CLI.
root
Required
public Project getRoot();
- Type: io.github.cdklabs.projen.Project
The root project.
subprojects
Required
public java.util.List<Project> getSubprojects();
- Type: java.util.List
Returns all the subprojects within this project.
tasks
Required
public Tasks getTasks();
- Type: io.github.cdklabs.projen.Tasks
Project tasks.
testTask
Required
public Task getTestTask();
- Type: io.github.cdklabs.projen.Task
defaultTask
Optional
public Task getDefaultTask();
- Type: io.github.cdklabs.projen.Task
This is the "default" task, the one that executes "projen".
Undefined if the project is being ejected.
initProject
Optional
public InitProject getInitProject();
- Type: io.github.cdklabs.projen.InitProject
The options used when this project is bootstrapped via projen new
.
It includes the original set of options passed to the CLI and also the JSII FQN of the project type.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
A parent project.
If undefined, this is the root project.
projectType
Required
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
autoApprove
Optional
public AutoApprove getAutoApprove();
- Type: io.github.cdklabs.projen.github.AutoApprove
Auto approve set up for this project.
devContainer
Optional
public DevContainer getDevContainer();
- Type: io.github.cdklabs.projen.vscode.DevContainer
Access for .devcontainer.json (used for GitHub Codespaces).
This will be undefined
if devContainer boolean is false
github
Optional
public GitHub getGithub();
- Type: io.github.cdklabs.projen.github.GitHub
Access all github components.
This will be undefined
for subprojects.
gitpod
Optional
public Gitpod getGitpod();
- Type: io.github.cdklabs.projen.Gitpod
Access for Gitpod.
This will be undefined
if gitpod boolean is false
vscode
Optional
public VsCode getVscode();
- Type: io.github.cdklabs.projen.vscode.VsCode
Access all VSCode components.
This will be undefined
for subprojects.
compile
Required
public MavenCompile getCompile();
- Type: io.github.cdklabs.projen.java.MavenCompile
Compile component.
distdir
Required
public java.lang.String getDistdir();
- Type: java.lang.String
Maven artifact output directory.
packaging
Required
public MavenPackaging getPackaging();
- Type: io.github.cdklabs.projen.java.MavenPackaging
Packaging component.
pom
Required
public Pom getPom();
- Type: io.github.cdklabs.projen.java.Pom
API for managing pom.xml
.
junit
Optional
public Junit getJunit();
- Type: io.github.cdklabs.projen.java.Junit
JUnit component.
projenrc
Optional
public Projenrc getProjenrc();
- Type: io.github.cdklabs.projen.java.Projenrc
Projenrc component.
cdkConfig
Required
public CdkConfig getCdkConfig();
- Type: io.github.cdklabs.projen.awscdk.CdkConfig
The cdk.json
file.
cdkDeps
Required
public AwsCdkDeps getCdkDeps();
- Type: io.github.cdklabs.projen.awscdk.AwsCdkDeps
CDK dependency management helper class.
cdkTasks
Required
public CdkTasks getCdkTasks();
- Type: io.github.cdklabs.projen.awscdk.CdkTasks
CDK tasks.
mainClass
Required
public java.lang.String getMainClass();
- Type: java.lang.String
The full name of the main class of the java app (package.Class).
mainClassName
Required
public java.lang.String getMainClassName();
- Type: java.lang.String
The name of the Java class with the static main()
method.
mainPackage
Required
public java.lang.String getMainPackage();
- Type: java.lang.String
The name of the Java package that includes the main class.
Constants
Name | Type | Description |
---|---|---|
DEFAULT_TASK |
java.lang.String |
The name of the default task (the task executed when projen is run without arguments). |
DEFAULT_TASK
Required
public java.lang.String getDefaultTask();
- Type: java.lang.String
The name of the default task (the task executed when projen
is run without arguments).
Normally this task should synthesize the project files.
InfrastructurePyProject
Synthesizes a Infrastructure Python Project.
Initializers
import software.aws.pdk.infrastructure.InfrastructurePyProject;
InfrastructurePyProject.Builder.create()
.name(java.lang.String)
// .authorEmail(java.lang.String)
// .authorName(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .buildCommand(java.lang.String)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .classifiers(java.util.List<java.lang.String>)
// .clobber(java.lang.Boolean)
// .commitGenerated(java.lang.Boolean)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .deps(java.util.List<java.lang.String>)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .devDeps(java.util.List<java.lang.String>)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .homepage(java.lang.String)
// .license(java.lang.String)
// .logging(LoggerOptions)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .moduleName(java.lang.String)
// .outdir(java.lang.String)
// .packageName(java.lang.String)
// .parent(Project)
// .poetryOptions(PoetryPyprojectOptionsWithoutDeps)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenrcPythonOptions(ProjenrcOptions)
// .projenTokenSecret(java.lang.String)
// .pytest(java.lang.Boolean)
// .pytestOptions(PytestOptions)
// .pythonExec(java.lang.String)
// .readme(SampleReadmeProps)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .requireApproval(ApprovalLevel)
// .sample(java.lang.Boolean)
// .setupConfig(java.util.Map<java.lang.String, java.lang.Object>)
// .setuptools(java.lang.Boolean)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testdir(java.lang.String)
// .version(java.lang.String)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .allowSignup(java.lang.Boolean)
// .cloudscapeReactTsWebsite(CloudscapeReactTsWebsiteProject)
// .cloudscapeReactTsWebsites(java.util.List<CloudscapeReactTsWebsiteProject>)
// .stackName(java.lang.String)
// .stages(java.util.List<DeploymentStage>)
// .typeSafeApi(TypeSafeApiProject)
// .typeSafeApis(java.util.List<TypeSafeApiProject>)
.build();
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
authorEmail |
java.lang.String |
Author's e-mail. |
authorName |
java.lang.String |
Author's name. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
classifiers |
java.util.List |
A list of PyPI trove classifiers that describe the project. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
deps |
java.util.List |
List of runtime dependencies for this project. Dependencies use the format: <module>@<semver> . |
description |
java.lang.String |
A short description of the package. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
devDeps |
java.util.List |
List of dev dependencies for this project. Dependencies use the format: <module>@<semver> . |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
homepage |
java.lang.String |
A URL to the website of the project. |
license |
java.lang.String |
License of this package as an SPDX identifier. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
moduleName |
java.lang.String |
Name of the python package as used in imports and filenames. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
packageName |
java.lang.String |
Package name. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
poetryOptions |
io.github.cdklabs.projen.python.PoetryPyprojectOptionsWithoutDeps |
Additional options to set for poetry if using poetry. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenrcPythonOptions |
io.github.cdklabs.projen.python.ProjenrcOptions |
Options related to projenrc in python. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
pytest |
java.lang.Boolean |
Include pytest tests. |
pytestOptions |
io.github.cdklabs.projen.python.PytestOptions |
pytest options. |
pythonExec |
java.lang.String |
Path to the python executable to use. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sample |
java.lang.Boolean |
Include sample code and test if the relevant directories don't exist. |
setupConfig |
java.util.Map |
Additional fields to pass in the setup() function if using setuptools. |
setuptools |
java.lang.Boolean |
Use setuptools with a setup.py script for packaging and publishing. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testdir |
java.lang.String |
Python sources directory. |
version |
java.lang.String |
Version of the package. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
allowSignup |
java.lang.Boolean |
Allow self sign up for the UserIdentity construct. |
cloudscapeReactTsWebsite |
software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject |
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code. |
cloudscapeReactTsWebsites |
java.util.List |
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code. |
stackName |
java.lang.String |
Stack name. |
stages |
java.util.List<DeploymentStage> |
List of deployment stages. |
typeSafeApi |
software.aws.pdk.infrastructure.TypeSafeApiProject |
TypeSafeApi instance to use when setting up the initial project sample code. |
typeSafeApis |
java.util.List |
TypeSafeApi instances to use when setting up the initial project sample code. |
name
Required
- Type: java.lang.String
- Default: $BASEDIR
authorEmail
Optional
- Type: java.lang.String
- Default: $GIT_USER_EMAIL
Author's e-mail.
authorName
Optional
- Type: java.lang.String
- Default: $GIT_USER_NAME
Author's name.
autoApproveOptions
Optional
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoMerge
Optional
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
buildCommand
Optional
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
~~cdkAssert
~~Optional
-
Deprecated: The
-
Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
-
Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
-
Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
-
Deprecated: Not supported in CDK v2.
-
Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
-
Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
-
Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
classifiers
Optional
- Type: java.util.List
A list of PyPI trove classifiers that describe the project.
clobber
Optional
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
commitGenerated
Optional
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
constructsVersion
Optional
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
deps
Optional
- Type: java.util.List
- Default: []
List of runtime dependencies for this project. Dependencies use the format: <module>@<semver>
.
Additional dependencies can be added via project.addDependency()
.
description
Optional
- Type: java.lang.String
A short description of the package.
devContainer
Optional
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
devDeps
Optional
- Type: java.util.List
- Default: []
List of dev dependencies for this project. Dependencies use the format: <module>@<semver>
.
Additional dependencies can be added via project.addDevDependency()
.
featureFlags
Optional
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitIgnoreOptions
Optional
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
homepage
Optional
- Type: java.lang.String
A URL to the website of the project.
license
Optional
- Type: java.lang.String
License of this package as an SPDX identifier.
logging
Optional
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
~~mergify
~~Optional
-
Deprecated: use
githubOptions.mergify
instead -
Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
-
Deprecated: use
githubOptions.mergifyOptions
instead -
Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
moduleName
Optional
- Type: java.lang.String
- Default: $PYTHON_MODULE_NAME
Name of the python package as used in imports and filenames.
Must only consist of alphanumeric characters and underscores.
outdir
Optional
- Type: java.lang.String
- Default: "."
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 subprojects.
packageName
Optional
- Type: java.lang.String
Package name.
parent
Optional
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
poetryOptions
Optional
- Type: io.github.cdklabs.projen.python.PoetryPyprojectOptionsWithoutDeps
Additional options to set for poetry if using poetry.
~~projectType
~~Optional
-
Deprecated: no longer supported at the base project level
-
Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenrcJson
Optional
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
projenrcPythonOptions
Optional
- Type: io.github.cdklabs.projen.python.ProjenrcOptions
- Default: default options
Options related to projenrc in python.
~~projenTokenSecret
~~Optional
-
Deprecated: use
projenCredentials
-
Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
pytest
Optional
- Type: java.lang.Boolean
- Default: true
Include pytest tests.
pytestOptions
Optional
- Type: io.github.cdklabs.projen.python.PytestOptions
- Default: defaults
pytest options.
pythonExec
Optional
- Type: java.lang.String
- Default: "python"
Path to the python executable to use.
readme
Optional
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
renovatebot
Optional
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
requireApproval
Optional
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sample
Optional
- Type: java.lang.Boolean
- Default: true
Include sample code and test if the relevant directories don't exist.
setupConfig
Optional
- Type: java.util.Map
Additional fields to pass in the setup() function if using setuptools.
setuptools
Optional
- Type: java.lang.Boolean
- Default: true, unless poetry is true, then false
Use setuptools with a setup.py script for packaging and publishing.
stale
Optional
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testdir
Optional
- Type: java.lang.String
- Default: "tests"
Python sources directory.
version
Optional
- Type: java.lang.String
- Default: "0.1.0"
Version of the package.
vscode
Optional
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
allowSignup
Optional
- Type: java.lang.Boolean
- Default: false
Allow self sign up for the UserIdentity construct.
~~cloudscapeReactTsWebsite
~~Optional
-
Deprecated: use cloudscapeReactTsWebsites
-
Type: software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code.
cloudscapeReactTsWebsites
Optional
- Type: java.util.List
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code.
stackName
Optional
- Type: java.lang.String
- Default: infra-dev
Stack name.
stages
Optional
- Type: java.util.List<DeploymentStage>
List of deployment stages.
~~typeSafeApi
~~Optional
-
Deprecated: use typeSafeApis
-
Type: software.aws.pdk.infrastructure.TypeSafeApiProject
TypeSafeApi instance to use when setting up the initial project sample code.
typeSafeApis
Optional
- Type: java.util.List
TypeSafeApi instances to use when setting up the initial project sample code.
Methods
Name | Description |
---|---|
toString |
Returns a string representation of this construct. |
addExcludeFromCleanup |
Exclude the matching files from pre-synth cleanup. |
addGitIgnore |
Adds a .gitignore pattern. |
addPackageIgnore |
Exclude these files from the bundled package. |
addTask |
Adds a new task to this project. |
addTip |
Prints a "tip" message during synthesis. |
annotateGenerated |
Marks the provided file(s) as being generated. |
postSynthesize |
Called after all components are synthesized. |
preSynthesize |
Called before all components are synthesized. |
removeTask |
Removes a task from a project. |
runTaskCommand |
Returns the shell command to execute in order to run a task. |
synth |
Synthesize all project files into outdir . |
tryFindFile |
Finds a file at the specified relative path within this project and all its subprojects. |
tryFindJsonFile |
Finds a json file by name. |
tryFindObjectFile |
Finds an object file (like JsonFile, YamlFile, etc.) by name. |
tryRemoveFile |
Finds a file at the specified relative path within this project and removes it. |
addDependency |
Adds a runtime dependency. |
addDevDependency |
Adds a dev dependency. |
toString
public java.lang.String toString()
Returns a string representation of this construct.
addExcludeFromCleanup
public void addExcludeFromCleanup(java.lang.String globs)
Exclude the matching files from pre-synth cleanup.
Can be used when, for example, some source files include the projen marker and we don't want them to be erased during synth.
globs
Required
- Type: java.lang.String
The glob patterns to match.
addGitIgnore
public void addGitIgnore(java.lang.String pattern)
Adds a .gitignore pattern.
pattern
Required
- Type: java.lang.String
The glob pattern to ignore.
addPackageIgnore
public void addPackageIgnore(java.lang.String _pattern)
Exclude these files from the bundled package.
Implemented by project types based on the
packaging mechanism. For example, NodeProject
delegates this to .npmignore
.
_pattern
Required
- Type: java.lang.String
The glob pattern to exclude.
addTask
public Task addTask(java.lang.String name)
public Task addTask(java.lang.String name, TaskOptions props)
Adds a new task to this project.
This will fail if the project already has a task with this name.
name
Required
- Type: java.lang.String
The task name to add.
props
Optional
- Type: io.github.cdklabs.projen.TaskOptions
Task properties.
~~addTip
~~
public void addTip(java.lang.String message)
Prints a "tip" message during synthesis.
message
Required
- Type: java.lang.String
The message.
annotateGenerated
public void annotateGenerated(java.lang.String glob)
Marks the provided file(s) as being generated.
This is achieved using the github-linguist attributes. Generated files do not count against the repository statistics and language breakdown.
https://github.com/github/linguist/blob/master/docs/overrides.md
glob
Required
- Type: java.lang.String
the glob pattern to match (could be a file path).
postSynthesize
public void postSynthesize()
Called after all components are synthesized.
Order is not guaranteed.
preSynthesize
public void preSynthesize()
Called before all components are synthesized.
removeTask
public Task removeTask(java.lang.String name)
Removes a task from a project.
name
Required
- Type: java.lang.String
The name of the task to remove.
runTaskCommand
public java.lang.String runTaskCommand(Task task)
Returns the shell command to execute in order to run a task.
By default, this is npx projen@<version> <task>
task
Required
- Type: io.github.cdklabs.projen.Task
The task for which the command is required.
synth
public void synth()
Synthesize all project files into outdir
.
- Call "this.preSynthesize()"
- Delete all generated files
- Synthesize all subprojects
- Synthesize all components of this project
- Call "postSynthesize()" for all components of this project
- Call "this.postSynthesize()"
tryFindFile
public FileBase tryFindFile(java.lang.String filePath)
Finds a file at the specified relative path within this project and all its subprojects.
filePath
Required
- Type: java.lang.String
The file path.
If this path is relative, it will be resolved from the root of this project.
~~tryFindJsonFile
~~
public JsonFile tryFindJsonFile(java.lang.String filePath)
Finds a json file by name.
filePath
Required
- Type: java.lang.String
The file path.
tryFindObjectFile
public ObjectFile tryFindObjectFile(java.lang.String filePath)
Finds an object file (like JsonFile, YamlFile, etc.) by name.
filePath
Required
- Type: java.lang.String
The file path.
tryRemoveFile
public FileBase tryRemoveFile(java.lang.String filePath)
Finds a file at the specified relative path within this project and removes it.
filePath
Required
- Type: java.lang.String
The file path.
If this path is relative, it will be resolved from the root of this project.
addDependency
public void addDependency(java.lang.String spec)
Adds a runtime dependency.
spec
Required
- Type: java.lang.String
Format <module>@<semver>
.
addDevDependency
public void addDevDependency(java.lang.String spec)
Adds a dev dependency.
spec
Required
- Type: java.lang.String
Format <module>@<semver>
.
Static Functions
Name | Description |
---|---|
isConstruct |
Checks if x is a construct. |
isProject |
Test whether the given construct is a project. |
of |
Find the closest ancestor project for given construct. |
isConstruct
import software.aws.pdk.infrastructure.InfrastructurePyProject;
InfrastructurePyProject.isConstruct(java.lang.Object x)
Checks if x
is a construct.
Use this method instead of instanceof
to properly detect Construct
instances, even when the construct library is symlinked.
Explanation: in JavaScript, multiple copies of the constructs
library on
disk are seen as independent, completely different libraries. As a
consequence, the class Construct
in each copy of the constructs
library
is seen as a different class, and an instance of one class will not test as
instanceof
the other class. npm install
will not create installations
like this, but users may manually symlink construct libraries together or
use a monorepo tool: in those cases, multiple copies of the constructs
library can be accidentally installed, and instanceof
will behave
unpredictably. It is safest to avoid using instanceof
, and using
this type-testing method instead.
x
Required
- Type: java.lang.Object
Any object.
isProject
import software.aws.pdk.infrastructure.InfrastructurePyProject;
InfrastructurePyProject.isProject(java.lang.Object x)
Test whether the given construct is a project.
x
Required
- Type: java.lang.Object
of
import software.aws.pdk.infrastructure.InfrastructurePyProject;
InfrastructurePyProject.of(IConstruct construct)
Find the closest ancestor project for given construct.
When given a project, this it the project itself.
construct
Required
- Type: software.constructs.IConstruct
Properties
Name | Type | Description |
---|---|---|
node |
software.constructs.Node |
The tree node. |
buildTask |
io.github.cdklabs.projen.Task |
No description. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
compileTask |
io.github.cdklabs.projen.Task |
No description. |
components |
java.util.List |
Returns all the components within this project. |
deps |
io.github.cdklabs.projen.Dependencies |
Project dependencies. |
ejected |
java.lang.Boolean |
Whether or not the project is being ejected. |
files |
java.util.List |
All files in this project. |
gitattributes |
io.github.cdklabs.projen.GitAttributesFile |
The .gitattributes file for this repository. |
gitignore |
io.github.cdklabs.projen.IgnoreFile |
.gitignore. |
logger |
io.github.cdklabs.projen.Logger |
Logging utilities. |
name |
java.lang.String |
Project name. |
outdir |
java.lang.String |
Absolute output directory of this project. |
packageTask |
io.github.cdklabs.projen.Task |
No description. |
postCompileTask |
io.github.cdklabs.projen.Task |
No description. |
preCompileTask |
io.github.cdklabs.projen.Task |
No description. |
projectBuild |
io.github.cdklabs.projen.ProjectBuild |
Manages the build process of the project. |
projenCommand |
java.lang.String |
The command to use in order to run the projen CLI. |
root |
io.github.cdklabs.projen.Project |
The root project. |
subprojects |
java.util.List |
Returns all the subprojects within this project. |
tasks |
io.github.cdklabs.projen.Tasks |
Project tasks. |
testTask |
io.github.cdklabs.projen.Task |
No description. |
defaultTask |
io.github.cdklabs.projen.Task |
This is the "default" task, the one that executes "projen". |
initProject |
io.github.cdklabs.projen.InitProject |
The options used when this project is bootstrapped via projen new . |
parent |
io.github.cdklabs.projen.Project |
A parent project. |
projectType |
io.github.cdklabs.projen.ProjectType |
No description. |
autoApprove |
io.github.cdklabs.projen.github.AutoApprove |
Auto approve set up for this project. |
devContainer |
io.github.cdklabs.projen.vscode.DevContainer |
Access for .devcontainer.json (used for GitHub Codespaces). |
github |
io.github.cdklabs.projen.github.GitHub |
Access all github components. |
gitpod |
io.github.cdklabs.projen.Gitpod |
Access for Gitpod. |
vscode |
io.github.cdklabs.projen.vscode.VsCode |
Access all VSCode components. |
depsManager |
io.github.cdklabs.projen.python.IPythonDeps |
API for managing dependencies. |
envManager |
io.github.cdklabs.projen.python.IPythonEnv |
API for mangaging the Python runtime environment. |
moduleName |
java.lang.String |
Python module name (the project name, with any hyphens or periods replaced with underscores). |
version |
java.lang.String |
Version of the package for distribution (should follow semver). |
packagingManager |
io.github.cdklabs.projen.python.IPythonPackaging |
API for managing packaging the project as a library. |
pytest |
io.github.cdklabs.projen.python.Pytest |
Pytest component. |
appEntrypoint |
java.lang.String |
The CDK app entrypoint. |
cdkConfig |
io.github.cdklabs.projen.awscdk.CdkConfig |
cdk.json configuration. |
cdkDeps |
io.github.cdklabs.projen.awscdk.AwsCdkDeps |
No description. |
cdkTasks |
io.github.cdklabs.projen.awscdk.CdkTasks |
Common CDK tasks. |
cdkVersion |
java.lang.String |
The CDK version this app is using. |
testdir |
java.lang.String |
The directory in which the python tests reside. |
node
Required
public Node getNode();
- Type: software.constructs.Node
The tree node.
buildTask
Required
public Task getBuildTask();
- Type: io.github.cdklabs.projen.Task
commitGenerated
Required
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
Whether to commit the managed files by default.
compileTask
Required
public Task getCompileTask();
- Type: io.github.cdklabs.projen.Task
components
Required
public java.util.List<Component> getComponents();
- Type: java.util.List
Returns all the components within this project.
deps
Required
public Dependencies getDeps();
- Type: io.github.cdklabs.projen.Dependencies
Project dependencies.
ejected
Required
public java.lang.Boolean getEjected();
- Type: java.lang.Boolean
Whether or not the project is being ejected.
files
Required
public java.util.List<FileBase> getFiles();
- Type: java.util.List
All files in this project.
gitattributes
Required
public GitAttributesFile getGitattributes();
- Type: io.github.cdklabs.projen.GitAttributesFile
The .gitattributes file for this repository.
gitignore
Required
public IgnoreFile getGitignore();
- Type: io.github.cdklabs.projen.IgnoreFile
.gitignore.
logger
Required
public Logger getLogger();
- Type: io.github.cdklabs.projen.Logger
Logging utilities.
name
Required
public java.lang.String getName();
- Type: java.lang.String
Project name.
outdir
Required
public java.lang.String getOutdir();
- Type: java.lang.String
Absolute output directory of this project.
packageTask
Required
public Task getPackageTask();
- Type: io.github.cdklabs.projen.Task
postCompileTask
Required
public Task getPostCompileTask();
- Type: io.github.cdklabs.projen.Task
preCompileTask
Required
public Task getPreCompileTask();
- Type: io.github.cdklabs.projen.Task
projectBuild
Required
public ProjectBuild getProjectBuild();
- Type: io.github.cdklabs.projen.ProjectBuild
Manages the build process of the project.
projenCommand
Required
public java.lang.String getProjenCommand();
- Type: java.lang.String
The command to use in order to run the projen CLI.
root
Required
public Project getRoot();
- Type: io.github.cdklabs.projen.Project
The root project.
subprojects
Required
public java.util.List<Project> getSubprojects();
- Type: java.util.List
Returns all the subprojects within this project.
tasks
Required
public Tasks getTasks();
- Type: io.github.cdklabs.projen.Tasks
Project tasks.
testTask
Required
public Task getTestTask();
- Type: io.github.cdklabs.projen.Task
defaultTask
Optional
public Task getDefaultTask();
- Type: io.github.cdklabs.projen.Task
This is the "default" task, the one that executes "projen".
Undefined if the project is being ejected.
initProject
Optional
public InitProject getInitProject();
- Type: io.github.cdklabs.projen.InitProject
The options used when this project is bootstrapped via projen new
.
It includes the original set of options passed to the CLI and also the JSII FQN of the project type.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
A parent project.
If undefined, this is the root project.
projectType
Required
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
autoApprove
Optional
public AutoApprove getAutoApprove();
- Type: io.github.cdklabs.projen.github.AutoApprove
Auto approve set up for this project.
devContainer
Optional
public DevContainer getDevContainer();
- Type: io.github.cdklabs.projen.vscode.DevContainer
Access for .devcontainer.json (used for GitHub Codespaces).
This will be undefined
if devContainer boolean is false
github
Optional
public GitHub getGithub();
- Type: io.github.cdklabs.projen.github.GitHub
Access all github components.
This will be undefined
for subprojects.
gitpod
Optional
public Gitpod getGitpod();
- Type: io.github.cdklabs.projen.Gitpod
Access for Gitpod.
This will be undefined
if gitpod boolean is false
vscode
Optional
public VsCode getVscode();
- Type: io.github.cdklabs.projen.vscode.VsCode
Access all VSCode components.
This will be undefined
for subprojects.
depsManager
Required
public IPythonDeps getDepsManager();
- Type: io.github.cdklabs.projen.python.IPythonDeps
API for managing dependencies.
envManager
Required
public IPythonEnv getEnvManager();
- Type: io.github.cdklabs.projen.python.IPythonEnv
API for mangaging the Python runtime environment.
moduleName
Required
public java.lang.String getModuleName();
- Type: java.lang.String
Python module name (the project name, with any hyphens or periods replaced with underscores).
version
Required
public java.lang.String getVersion();
- Type: java.lang.String
Version of the package for distribution (should follow semver).
packagingManager
Optional
public IPythonPackaging getPackagingManager();
- Type: io.github.cdklabs.projen.python.IPythonPackaging
API for managing packaging the project as a library.
Only applies when the projectType
is LIB.
pytest
Optional
public Pytest getPytest();
- Type: io.github.cdklabs.projen.python.Pytest
Pytest component.
appEntrypoint
Required
public java.lang.String getAppEntrypoint();
- Type: java.lang.String
The CDK app entrypoint.
cdkConfig
Required
public CdkConfig getCdkConfig();
- Type: io.github.cdklabs.projen.awscdk.CdkConfig
cdk.json configuration.
cdkDeps
Required
public AwsCdkDeps getCdkDeps();
- Type: io.github.cdklabs.projen.awscdk.AwsCdkDeps
cdkTasks
Required
public CdkTasks getCdkTasks();
- Type: io.github.cdklabs.projen.awscdk.CdkTasks
Common CDK tasks.
cdkVersion
Required
public java.lang.String getCdkVersion();
- Type: java.lang.String
The CDK version this app is using.
testdir
Required
public java.lang.String getTestdir();
- Type: java.lang.String
The directory in which the python tests reside.
Constants
Name | Type | Description |
---|---|---|
DEFAULT_TASK |
java.lang.String |
The name of the default task (the task executed when projen is run without arguments). |
DEFAULT_TASK
Required
public java.lang.String getDefaultTask();
- Type: java.lang.String
The name of the default task (the task executed when projen
is run without arguments).
Normally this task should synthesize the project files.
InfrastructureTsProject
Synthesizes a Infrastructure Typescript Project.
Initializers
import software.aws.pdk.infrastructure.InfrastructureTsProject;
InfrastructureTsProject.Builder.create()
.name(java.lang.String)
// .allowLibraryDependencies(java.lang.Boolean)
// .appEntrypoint(java.lang.String)
// .artifactsDirectory(java.lang.String)
// .authorEmail(java.lang.String)
// .authorName(java.lang.String)
// .authorOrganization(java.lang.Boolean)
// .authorUrl(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoApproveUpgrades(java.lang.Boolean)
// .autoDetectBin(java.lang.Boolean)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .bin(java.util.Map<java.lang.String, java.lang.String>)
// .bugsEmail(java.lang.String)
// .bugsUrl(java.lang.String)
// .buildCommand(java.lang.String)
// .buildWorkflow(java.lang.Boolean)
// .buildWorkflowOptions(BuildWorkflowOptions)
// .buildWorkflowTriggers(Triggers)
// .bundledDeps(java.util.List<java.lang.String>)
// .bundlerOptions(BundlerOptions)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .checkLicenses(LicenseCheckerOptions)
// .clobber(java.lang.Boolean)
// .codeArtifactOptions(CodeArtifactOptions)
// .codeCov(java.lang.Boolean)
// .codeCovTokenSecret(java.lang.String)
// .commitGenerated(java.lang.Boolean)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .copyrightOwner(java.lang.String)
// .copyrightPeriod(java.lang.String)
// .defaultReleaseBranch(java.lang.String)
// .dependabot(java.lang.Boolean)
// .dependabotOptions(DependabotOptions)
// .deps(java.util.List<java.lang.String>)
// .depsUpgrade(java.lang.Boolean)
// .depsUpgradeOptions(UpgradeDependenciesOptions)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .devDeps(java.util.List<java.lang.String>)
// .disableTsconfig(java.lang.Boolean)
// .disableTsconfigDev(java.lang.Boolean)
// .docgen(java.lang.Boolean)
// .docsDirectory(java.lang.String)
// .edgeLambdaAutoDiscover(java.lang.Boolean)
// .entrypoint(java.lang.String)
// .entrypointTypes(java.lang.String)
// .eslint(java.lang.Boolean)
// .eslintOptions(EslintOptions)
// .experimentalIntegRunner(java.lang.Boolean)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitignore(java.util.List<java.lang.String>)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .homepage(java.lang.String)
// .integrationTestAutoDiscover(java.lang.Boolean)
// .jest(java.lang.Boolean)
// .jestOptions(JestOptions)
// .jsiiReleaseVersion(java.lang.String)
// .keywords(java.util.List<java.lang.String>)
// .lambdaAutoDiscover(java.lang.Boolean)
// .lambdaExtensionAutoDiscover(java.lang.Boolean)
// .lambdaOptions(LambdaFunctionCommonOptions)
// .libdir(java.lang.String)
// .license(java.lang.String)
// .licensed(java.lang.Boolean)
// .logging(LoggerOptions)
// .majorVersion(java.lang.Number)
// .maxNodeVersion(java.lang.String)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .minMajorVersion(java.lang.Number)
// .minNodeVersion(java.lang.String)
// .mutableBuild(java.lang.Boolean)
// .npmAccess(NpmAccess)
// .npmDistTag(java.lang.String)
// .npmignore(java.util.List<java.lang.String>)
// .npmignoreEnabled(java.lang.Boolean)
// .npmIgnoreOptions(IgnoreFileOptions)
// .npmProvenance(java.lang.Boolean)
// .npmRegistry(java.lang.String)
// .npmRegistryUrl(java.lang.String)
// .npmTokenSecret(java.lang.String)
// .outdir(java.lang.String)
// .package(java.lang.Boolean)
// .packageManager(NodePackageManager)
// .packageName(java.lang.String)
// .parent(Project)
// .peerDependencyOptions(PeerDependencyOptions)
// .peerDeps(java.util.List<java.lang.String>)
// .pnpmVersion(java.lang.String)
// .postBuildSteps(java.util.List<JobStep>)
// .prerelease(java.lang.String)
// .prettier(java.lang.Boolean)
// .prettierOptions(PrettierOptions)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenDevDependency(java.lang.Boolean)
// .projenrcJs(java.lang.Boolean)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenrcJsOptions(ProjenrcOptions)
// .projenrcTs(java.lang.Boolean)
// .projenrcTsOptions(ProjenrcOptions)
// .projenTokenSecret(java.lang.String)
// .projenVersion(java.lang.String)
// .publishDryRun(java.lang.Boolean)
// .publishTasks(java.lang.Boolean)
// .pullRequestTemplate(java.lang.Boolean)
// .pullRequestTemplateContents(java.util.List<java.lang.String>)
// .readme(SampleReadmeProps)
// .releasableCommits(ReleasableCommits)
// .release(java.lang.Boolean)
// .releaseBranches(java.util.Map<java.lang.String, BranchOptions>)
// .releaseEveryCommit(java.lang.Boolean)
// .releaseFailureIssue(java.lang.Boolean)
// .releaseFailureIssueLabel(java.lang.String)
// .releaseSchedule(java.lang.String)
// .releaseTagPrefix(java.lang.String)
// .releaseToNpm(java.lang.Boolean)
// .releaseTrigger(ReleaseTrigger)
// .releaseWorkflow(java.lang.Boolean)
// .releaseWorkflowName(java.lang.String)
// .releaseWorkflowSetupSteps(java.util.List<JobStep>)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .repository(java.lang.String)
// .repositoryDirectory(java.lang.String)
// .requireApproval(ApprovalLevel)
// .sampleCode(java.lang.Boolean)
// .scopedPackagesOptions(java.util.List<ScopedPackagesOptions>)
// .scripts(java.util.Map<java.lang.String, java.lang.String>)
// .srcdir(java.lang.String)
// .stability(java.lang.String)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testdir(java.lang.String)
// .tsconfig(TypescriptConfigOptions)
// .tsconfigDev(TypescriptConfigOptions)
// .tsconfigDevFile(java.lang.String)
// .tsJestOptions(TsJestOptions)
// .typescriptVersion(java.lang.String)
// .versionrcOptions(java.util.Map<java.lang.String, java.lang.Object>)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .workflowBootstrapSteps(java.util.List<JobStep>)
// .workflowContainerImage(java.lang.String)
// .workflowGitIdentity(GitIdentity)
// .workflowNodeVersion(java.lang.String)
// .workflowPackageCache(java.lang.Boolean)
// .workflowRunsOn(java.util.List<java.lang.String>)
// .workflowRunsOnGroup(GroupRunnerOptions)
// .yarnBerryOptions(YarnBerryOptions)
// .allowSignup(java.lang.Boolean)
// .cloudscapeReactTsWebsite(CloudscapeReactTsWebsiteProject)
// .cloudscapeReactTsWebsites(java.util.List<CloudscapeReactTsWebsiteProject>)
// .stackName(java.lang.String)
// .stages(java.util.List<DeploymentStage>)
// .typeSafeApi(TypeSafeApiProject)
// .typeSafeApis(java.util.List<TypeSafeApiProject>)
// .typeSafeWebSocketApis(java.util.List<TypeSafeWebSocketApiProject>)
.build();
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
allowLibraryDependencies |
java.lang.Boolean |
Allow the project to include peerDependencies and bundledDependencies . |
appEntrypoint |
java.lang.String |
The CDK app's entrypoint (relative to the source directory, which is "src" by default). |
artifactsDirectory |
java.lang.String |
A directory which will contain build artifacts. |
authorEmail |
java.lang.String |
Author's e-mail. |
authorName |
java.lang.String |
Author's name. |
authorOrganization |
java.lang.Boolean |
Is the author an organization. |
authorUrl |
java.lang.String |
Author's URL / Website. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoApproveUpgrades |
java.lang.Boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). |
autoDetectBin |
java.lang.Boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
bin |
java.util.Map |
Binary programs vended with your module. |
bugsEmail |
java.lang.String |
The email address to which issues should be reported. |
bugsUrl |
java.lang.String |
The url to your project's issue tracker. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
buildWorkflow |
java.lang.Boolean |
Define a GitHub workflow for building PRs. |
buildWorkflowOptions |
io.github.cdklabs.projen.javascript.BuildWorkflowOptions |
Options for PR build workflow. |
buildWorkflowTriggers |
io.github.cdklabs.projen.github.workflows.Triggers |
Build workflow triggers. |
bundledDeps |
java.util.List |
List of dependencies to bundle into this module. |
bundlerOptions |
io.github.cdklabs.projen.javascript.BundlerOptions |
Options for Bundler . |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
checkLicenses |
io.github.cdklabs.projen.javascript.LicenseCheckerOptions |
Configure which licenses should be deemed acceptable for use by dependencies. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
codeArtifactOptions |
io.github.cdklabs.projen.javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. |
codeCov |
java.lang.Boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v4 A secret is required for private repos. Configured with @codeCovTokenSecret . |
codeCovTokenSecret |
java.lang.String |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
copyrightOwner |
java.lang.String |
License copyright owner. |
copyrightPeriod |
java.lang.String |
The copyright years to put in the LICENSE file. |
defaultReleaseBranch |
java.lang.String |
The name of the main release branch. |
dependabot |
java.lang.Boolean |
Use dependabot to handle dependency upgrades. |
dependabotOptions |
io.github.cdklabs.projen.github.DependabotOptions |
Options for dependabot. |
deps |
java.util.List |
Runtime dependencies of this module. |
depsUpgrade |
java.lang.Boolean |
Use tasks and github workflows to handle dependency upgrades. |
depsUpgradeOptions |
io.github.cdklabs.projen.javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies . |
description |
java.lang.String |
The description is just a string that helps people understand the purpose of the package. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
devDeps |
java.util.List |
Build dependencies for this module. |
disableTsconfig |
java.lang.Boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler). |
disableTsconfigDev |
java.lang.Boolean |
Do not generate a tsconfig.dev.json file. |
docgen |
java.lang.Boolean |
Docgen by Typedoc. |
docsDirectory |
java.lang.String |
Docs directory. |
edgeLambdaAutoDiscover |
java.lang.Boolean |
Automatically adds an cloudfront.experimental.EdgeFunction for each .edge-lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
entrypoint |
java.lang.String |
Module entrypoint (main in package.json ). Set to an empty string to not include main in your package.json. |
entrypointTypes |
java.lang.String |
The .d.ts file that includes the type declarations for this module. |
eslint |
java.lang.Boolean |
Setup eslint. |
eslintOptions |
io.github.cdklabs.projen.javascript.EslintOptions |
Eslint options. |
experimentalIntegRunner |
java.lang.Boolean |
Enable experimental support for the AWS CDK integ-runner. |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitignore |
java.util.List |
Additional entries to .gitignore. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
homepage |
java.lang.String |
Package's Homepage / Website. |
integrationTestAutoDiscover |
java.lang.Boolean |
Automatically discovers and creates integration tests for each .integ.ts file in under your test directory. |
jest |
java.lang.Boolean |
Setup jest unit tests. |
jestOptions |
io.github.cdklabs.projen.javascript.JestOptions |
Jest options. |
jsiiReleaseVersion |
java.lang.String |
Version requirement of publib which is used to publish modules to npm. |
keywords |
java.util.List |
Keywords to include in package.json . |
lambdaAutoDiscover |
java.lang.Boolean |
Automatically adds an awscdk.LambdaFunction for each .lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
lambdaExtensionAutoDiscover |
java.lang.Boolean |
Automatically adds an awscdk.LambdaExtension for each .lambda-extension.ts entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
lambdaOptions |
io.github.cdklabs.projen.awscdk.LambdaFunctionCommonOptions |
Common options for all AWS Lambda functions. |
libdir |
java.lang.String |
Typescript artifacts output directory. |
license |
java.lang.String |
License's SPDX identifier. |
licensed |
java.lang.Boolean |
Indicates if a license should be added. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
majorVersion |
java.lang.Number |
Major version to release from the default branch. |
maxNodeVersion |
java.lang.String |
Minimum node.js version to require via engines (inclusive). |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
minMajorVersion |
java.lang.Number |
Minimal Major version to release. |
minNodeVersion |
java.lang.String |
Minimum Node.js version to require via package.json engines (inclusive). |
mutableBuild |
java.lang.Boolean |
Automatically update files modified during builds to pull-request branches. |
npmAccess |
io.github.cdklabs.projen.javascript.NpmAccess |
Access level of the npm package. |
npmDistTag |
java.lang.String |
The npmDistTag to use when publishing from the default branch. |
npmignore |
java.util.List |
Additional entries to .npmignore. |
npmignoreEnabled |
java.lang.Boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. |
npmIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .npmignore file. |
npmProvenance |
java.lang.Boolean |
Should provenance statements be generated when the package is published. |
npmRegistry |
java.lang.String |
The host name of the npm registry to publish to. |
npmRegistryUrl |
java.lang.String |
The base URL of the npm package registry. |
npmTokenSecret |
java.lang.String |
GitHub secret which contains the NPM token to use when publishing packages. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
package |
java.lang.Boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist ). |
packageManager |
io.github.cdklabs.projen.javascript.NodePackageManager |
The Node Package Manager used to execute scripts. |
packageName |
java.lang.String |
The "name" in package.json. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
peerDependencyOptions |
io.github.cdklabs.projen.javascript.PeerDependencyOptions |
Options for peerDeps . |
peerDeps |
java.util.List |
Peer dependencies for this module. |
pnpmVersion |
java.lang.String |
The version of PNPM to use if using PNPM as a package manager. |
postBuildSteps |
java.util.List |
Steps to execute after build as part of the release workflow. |
prerelease |
java.lang.String |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). |
prettier |
java.lang.Boolean |
Setup prettier. |
prettierOptions |
io.github.cdklabs.projen.javascript.PrettierOptions |
Prettier options. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenDevDependency |
java.lang.Boolean |
Indicates of "projen" should be installed as a devDependency. |
projenrcJs |
java.lang.Boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenrcJsOptions |
io.github.cdklabs.projen.javascript.ProjenrcOptions |
Options for .projenrc.js. |
projenrcTs |
java.lang.Boolean |
Use TypeScript for your projenrc file (.projenrc.ts ). |
projenrcTsOptions |
io.github.cdklabs.projen.typescript.ProjenrcOptions |
Options for .projenrc.ts. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
projenVersion |
java.lang.String |
Version of projen to install. |
publishDryRun |
java.lang.Boolean |
Instead of actually publishing to package managers, just print the publishing command. |
publishTasks |
java.lang.Boolean |
Define publishing tasks that can be executed manually as well as workflows. |
pullRequestTemplate |
java.lang.Boolean |
Include a GitHub pull request template. |
pullRequestTemplateContents |
java.util.List |
The contents of the pull request template. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
releasableCommits |
io.github.cdklabs.projen.ReleasableCommits |
Find commits that should be considered releasable Used to decide if a release is required. |
release |
java.lang.Boolean |
Add release management to this project. |
releaseBranches |
java.util.Map |
Defines additional release branches. |
releaseEveryCommit |
java.lang.Boolean |
Automatically release new versions every commit to one of branches in releaseBranches . |
releaseFailureIssue |
java.lang.Boolean |
Create a github issue on every failed publishing task. |
releaseFailureIssueLabel |
java.lang.String |
The label to apply to issues indicating publish failures. |
releaseSchedule |
java.lang.String |
CRON schedule to trigger new releases. |
releaseTagPrefix |
java.lang.String |
Automatically add the given prefix to release tags. |
releaseToNpm |
java.lang.Boolean |
Automatically release to npm when new versions are introduced. |
releaseTrigger |
io.github.cdklabs.projen.release.ReleaseTrigger |
The release trigger to use. |
releaseWorkflow |
java.lang.Boolean |
DEPRECATED: renamed to release . |
releaseWorkflowName |
java.lang.String |
The name of the default release workflow. |
releaseWorkflowSetupSteps |
java.util.List |
A set of workflow steps to execute in order to setup the workflow container. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
repository |
java.lang.String |
The repository is the location where the actual code for your package lives. |
repositoryDirectory |
java.lang.String |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sampleCode |
java.lang.Boolean |
Generate one-time sample in src/ and test/ if there are no files there. |
scopedPackagesOptions |
java.util.List |
Options for privately hosted scoped packages. |
scripts |
java.util.Map |
npm scripts to include. |
srcdir |
java.lang.String |
Typescript sources directory. |
stability |
java.lang.String |
Package's Stability. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testdir |
java.lang.String |
Jest tests directory. |
tsconfig |
io.github.cdklabs.projen.javascript.TypescriptConfigOptions |
Custom TSConfig. |
tsconfigDev |
io.github.cdklabs.projen.javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). |
tsconfigDevFile |
java.lang.String |
The name of the development tsconfig.json file. |
tsJestOptions |
io.github.cdklabs.projen.typescript.TsJestOptions |
Options for ts-jest. |
typescriptVersion |
java.lang.String |
TypeScript version to use. |
versionrcOptions |
java.util.Map |
Custom configuration used when creating changelog with standard-version package. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
workflowBootstrapSteps |
java.util.List |
Workflow steps to use in order to bootstrap this repo. |
workflowContainerImage |
java.lang.String |
Container image to use for GitHub workflows. |
workflowGitIdentity |
io.github.cdklabs.projen.github.GitIdentity |
The git identity to use in workflows. |
workflowNodeVersion |
java.lang.String |
The node version to use in GitHub workflows. |
workflowPackageCache |
java.lang.Boolean |
Enable Node.js package cache in GitHub workflows. |
workflowRunsOn |
java.util.List |
Github Runner selection labels. |
workflowRunsOnGroup |
io.github.cdklabs.projen.GroupRunnerOptions |
Github Runner Group selection options. |
yarnBerryOptions |
io.github.cdklabs.projen.javascript.YarnBerryOptions |
Options for Yarn Berry. |
allowSignup |
java.lang.Boolean |
Allow self sign up for the UserIdentity construct. |
cloudscapeReactTsWebsite |
software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject |
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code. |
cloudscapeReactTsWebsites |
java.util.List |
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code. |
stackName |
java.lang.String |
Stack name. |
stages |
java.util.List<DeploymentStage> |
List of deployment stages. |
typeSafeApi |
software.aws.pdk.infrastructure.TypeSafeApiProject |
TypeSafeApi instance to use when setting up the initial project sample code. |
typeSafeApis |
java.util.List |
TypeSafeApi instances to use when setting up the initial project sample code. |
typeSafeWebSocketApis |
java.util.List |
TypeSafeWebSocketApi instances to use when setting up the initial project sample code. |
name
Required
- Type: java.lang.String
- Default: $BASEDIR
allowLibraryDependencies
Optional
- Type: java.lang.Boolean
- Default: true
Allow the project to include peerDependencies
and bundledDependencies
.
This is normally only allowed for libraries. For apps, there's no meaning for specifying these.
appEntrypoint
Optional
- Type: java.lang.String
- Default: "main.ts"
The CDK app's entrypoint (relative to the source directory, which is "src" by default).
artifactsDirectory
Optional
- Type: java.lang.String
- Default: "dist"
A directory which will contain build artifacts.
authorEmail
Optional
- Type: java.lang.String
Author's e-mail.
authorName
Optional
- Type: java.lang.String
Author's name.
authorOrganization
Optional
- Type: java.lang.Boolean
Is the author an organization.
authorUrl
Optional
- Type: java.lang.String
Author's URL / Website.
autoApproveOptions
Optional
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoApproveUpgrades
Optional
- Type: java.lang.Boolean
- Default: true
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued).
Throw if set to true but autoApproveOptions
are not defined.
autoDetectBin
Optional
- Type: java.lang.Boolean
- Default: true
Automatically add all executables under the bin
directory to your package.json
file under the bin
section.
autoMerge
Optional
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
bin
Optional
- Type: java.util.Map
Binary programs vended with your module.
You can use this option to add/customize how binaries are represented in
your package.json
, but unless autoDetectBin
is false
, every
executable file under bin
will automatically be added to this section.
bugsEmail
Optional
- Type: java.lang.String
The email address to which issues should be reported.
bugsUrl
Optional
- Type: java.lang.String
The url to your project's issue tracker.
buildCommand
Optional
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
buildWorkflow
Optional
- Type: java.lang.Boolean
- Default: true if not a subproject
Define a GitHub workflow for building PRs.
buildWorkflowOptions
Optional
- Type: io.github.cdklabs.projen.javascript.BuildWorkflowOptions
Options for PR build workflow.
~~buildWorkflowTriggers
~~Optional
-
Deprecated: - Use
buildWorkflowOptions.workflowTriggers
-
Type: io.github.cdklabs.projen.github.workflows.Triggers
- Default: "{ pullRequest: {}, workflowDispatch: {} }"
Build workflow triggers.
bundledDeps
Optional
- Type: java.util.List
List of dependencies to bundle into this module.
These modules will be
added both to the dependencies
section and bundledDependencies
section of
your package.json
.
The recommendation is to only specify the module name here (e.g.
express
). This will behave similar to yarn add
or npm install
in the
sense that it will add the module as a dependency to your package.json
file with the latest version (^
). You can specify semver requirements in
the same syntax passed to npm i
or yarn add
(e.g. express@^2
) and
this will be what you package.json
will eventually include.
bundlerOptions
Optional
- Type: io.github.cdklabs.projen.javascript.BundlerOptions
Options for Bundler
.
~~cdkAssert
~~Optional
-
Deprecated: The
-
Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
-
Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
-
Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
-
Deprecated: Not supported in CDK v2.
-
Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
-
Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
-
Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
checkLicenses
Optional
- Type: io.github.cdklabs.projen.javascript.LicenseCheckerOptions
- Default: no license checks are run during the build and all licenses will be accepted
Configure which licenses should be deemed acceptable for use by dependencies.
This setting will cause the build to fail, if any prohibited or not allowed licenses ares encountered.
clobber
Optional
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
codeArtifactOptions
Optional
- Type: io.github.cdklabs.projen.javascript.CodeArtifactOptions
- Default: undefined
Options for npm packages using AWS CodeArtifact.
This is required if publishing packages to, or installing scoped packages from AWS CodeArtifact
codeCov
Optional
- Type: java.lang.Boolean
- Default: false
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v4 A secret is required for private repos. Configured with @codeCovTokenSecret
.
codeCovTokenSecret
Optional
- Type: java.lang.String
- Default: if this option is not specified, only public repositories are supported
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories.
commitGenerated
Optional
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
constructsVersion
Optional
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
copyrightOwner
Optional
- Type: java.lang.String
- Default: defaults to the value of authorName or "" if
authorName
is undefined.
License copyright owner.
copyrightPeriod
Optional
- Type: java.lang.String
- Default: current year
The copyright years to put in the LICENSE file.
defaultReleaseBranch
Optional
- Type: java.lang.String
- Default: "main"
The name of the main release branch.
dependabot
Optional
- Type: java.lang.Boolean
- Default: false
Use dependabot to handle dependency upgrades.
Cannot be used in conjunction with depsUpgrade
.
dependabotOptions
Optional
- Type: io.github.cdklabs.projen.github.DependabotOptions
- Default: default options
Options for dependabot.
deps
Optional
- Type: java.util.List
- Default: []
Runtime dependencies of this module.
The recommendation is to only specify the module name here (e.g.
express
). This will behave similar to yarn add
or npm install
in the
sense that it will add the module as a dependency to your package.json
file with the latest version (^
). You can specify semver requirements in
the same syntax passed to npm i
or yarn add
(e.g. express@^2
) and
this will be what you package.json
will eventually include.
depsUpgrade
Optional
- Type: java.lang.Boolean
- Default: true
Use tasks and github workflows to handle dependency upgrades.
Cannot be used in conjunction with dependabot
.
depsUpgradeOptions
Optional
- Type: io.github.cdklabs.projen.javascript.UpgradeDependenciesOptions
- Default: default options
Options for UpgradeDependencies
.
description
Optional
- Type: java.lang.String
The description is just a string that helps people understand the purpose of the package.
It can be used when searching for packages in a package manager as well. See https://classic.yarnpkg.com/en/docs/package-json/#toc-description
devContainer
Optional
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
devDeps
Optional
- Type: java.util.List
- Default: []
Build dependencies for this module.
These dependencies will only be available in your build environment but will not be fetched when this module is consumed.
The recommendation is to only specify the module name here (e.g.
express
). This will behave similar to yarn add
or npm install
in the
sense that it will add the module as a dependency to your package.json
file with the latest version (^
). You can specify semver requirements in
the same syntax passed to npm i
or yarn add
(e.g. express@^2
) and
this will be what you package.json
will eventually include.
disableTsconfig
Optional
- Type: java.lang.Boolean
- Default: false
Do not generate a tsconfig.json
file (used by jsii projects since tsconfig.json is generated by the jsii compiler).
disableTsconfigDev
Optional
- Type: java.lang.Boolean
- Default: false
Do not generate a tsconfig.dev.json
file.
docgen
Optional
- Type: java.lang.Boolean
- Default: false
Docgen by Typedoc.
docsDirectory
Optional
- Type: java.lang.String
- Default: "docs"
Docs directory.
edgeLambdaAutoDiscover
Optional
- Type: java.lang.Boolean
- Default: true
Automatically adds an cloudfront.experimental.EdgeFunction
for each .edge-lambda.ts
handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover
component to your project.
entrypoint
Optional
- Type: java.lang.String
- Default: "lib/index.js"
Module entrypoint (main
in package.json
). Set to an empty string to not include main
in your package.json.
entrypointTypes
Optional
- Type: java.lang.String
- Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts)
The .d.ts file that includes the type declarations for this module.
eslint
Optional
- Type: java.lang.Boolean
- Default: true
Setup eslint.
eslintOptions
Optional
- Type: io.github.cdklabs.projen.javascript.EslintOptions
- Default: opinionated default options
Eslint options.
experimentalIntegRunner
Optional
- Type: java.lang.Boolean
- Default: false
Enable experimental support for the AWS CDK integ-runner.
featureFlags
Optional
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitignore
Optional
- Type: java.util.List
Additional entries to .gitignore.
gitIgnoreOptions
Optional
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
homepage
Optional
- Type: java.lang.String
Package's Homepage / Website.
integrationTestAutoDiscover
Optional
- Type: java.lang.Boolean
- Default: true
Automatically discovers and creates integration tests for each .integ.ts
file in under your test directory.
jest
Optional
- Type: java.lang.Boolean
- Default: true
Setup jest unit tests.
jestOptions
Optional
- Type: io.github.cdklabs.projen.javascript.JestOptions
- Default: default options
Jest options.
jsiiReleaseVersion
Optional
- Type: java.lang.String
- Default: "latest"
Version requirement of publib
which is used to publish modules to npm.
keywords
Optional
- Type: java.util.List
Keywords to include in package.json
.
lambdaAutoDiscover
Optional
- Type: java.lang.Boolean
- Default: true
Automatically adds an awscdk.LambdaFunction
for each .lambda.ts
handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover
component to your project.
lambdaExtensionAutoDiscover
Optional
- Type: java.lang.Boolean
- Default: true
Automatically adds an awscdk.LambdaExtension
for each .lambda-extension.ts
entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover
component to your project.
lambdaOptions
Optional
- Type: io.github.cdklabs.projen.awscdk.LambdaFunctionCommonOptions
- Default: default options
Common options for all AWS Lambda functions.
libdir
Optional
- Type: java.lang.String
- Default: "lib"
Typescript artifacts output directory.
license
Optional
- Type: java.lang.String
- Default: "Apache-2.0"
License's SPDX identifier.
See https://github.com/projen/projen/tree/main/license-text for a list of supported licenses.
Use the licensed
option if you want to no license to be specified.
licensed
Optional
- Type: java.lang.Boolean
- Default: true
Indicates if a license should be added.
logging
Optional
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
majorVersion
Optional
- Type: java.lang.Number
- Default: Major version is not enforced.
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.
maxNodeVersion
Optional
- Type: java.lang.String
- Default: no max
Minimum node.js version to require via engines
(inclusive).
~~mergify
~~Optional
-
Deprecated: use
githubOptions.mergify
instead -
Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
-
Deprecated: use
githubOptions.mergifyOptions
instead -
Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
minMajorVersion
Optional
- Type: java.lang.Number
- Default: No minimum version is being enforced
Minimal Major version to release.
This can be useful to set to 1, as breaking changes before the 1.x major release are not incrementing the major version number.
Can not be set together with majorVersion
.
minNodeVersion
Optional
- Type: java.lang.String
- Default: no "engines" specified
Minimum Node.js version to require via package.json engines
(inclusive).
~~mutableBuild
~~Optional
-
Deprecated: - Use
buildWorkflowOptions.mutableBuild
-
Type: java.lang.Boolean
- Default: true
Automatically update files modified during builds to pull-request branches.
This means that any files synthesized by projen or e.g. test snapshots will always be up-to-date before a PR is merged.
Implies that PR builds do not have anti-tamper checks.
npmAccess
Optional
- Type: io.github.cdklabs.projen.javascript.NpmAccess
- Default: for scoped packages (e.g.
foo@bar
), the default isNpmAccess.RESTRICTED
, for non-scoped packages, the default isNpmAccess.PUBLIC
.
Access level of the npm package.
npmDistTag
Optional
- Type: java.lang.String
- Default: "latest"
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.
~~npmignore
~~Optional
-
Deprecated: - use
project.addPackageIgnore
-
Type: java.util.List
Additional entries to .npmignore.
npmignoreEnabled
Optional
- Type: java.lang.Boolean
- Default: true
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs.
npmIgnoreOptions
Optional
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .npmignore file.
npmProvenance
Optional
- Type: java.lang.Boolean
- Default: true for public packages, false otherwise
Should provenance statements be generated when the package is published.
A supported package manager is required to publish a package with npm provenance statements and you will need to use a supported CI/CD provider.
Note that the projen Release
and Publisher
components are using publib
to publish packages,
which is using npm internally and supports provenance statements independently of the package manager used.
~~npmRegistry
~~Optional
-
Deprecated: use
npmRegistryUrl
instead -
Type: java.lang.String
The host name of the npm registry to publish to.
Cannot be set together with npmRegistryUrl
.
npmRegistryUrl
Optional
- Type: java.lang.String
- Default: "https://registry.npmjs.org"
The base URL of the npm package registry.
Must be a URL (e.g. start with "https://" or "http://")
npmTokenSecret
Optional
- Type: java.lang.String
- Default: "NPM_TOKEN"
GitHub secret which contains the NPM token to use when publishing packages.
outdir
Optional
- Type: java.lang.String
- Default: "."
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 subprojects.
package
Optional
- Type: java.lang.Boolean
- Default: true
Defines a package
task that will produce an npm tarball under the artifacts directory (e.g. dist
).
packageManager
Optional
- Type: io.github.cdklabs.projen.javascript.NodePackageManager
- Default: NodePackageManager.YARN_CLASSIC
The Node Package Manager used to execute scripts.
packageName
Optional
- Type: java.lang.String
- Default: defaults to project name
The "name" in package.json.
parent
Optional
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
peerDependencyOptions
Optional
- Type: io.github.cdklabs.projen.javascript.PeerDependencyOptions
Options for peerDeps
.
peerDeps
Optional
- Type: java.util.List
- Default: []
Peer dependencies for this module.
Dependencies listed here are required to
be installed (and satisfied) by the consumer of this library. Using peer
dependencies allows you to ensure that only a single module of a certain
library exists in the node_modules
tree of your consumers.
Note that prior to npm@7, peer dependencies are not automatically installed, which means that adding peer dependencies to a library will be a breaking change for your customers.
Unless peerDependencyOptions.pinnedDevDependency
is disabled (it is
enabled by default), projen will automatically add a dev dependency with a
pinned version for each peer dependency. This will ensure that you build &
test your module against the lowest peer version required.
pnpmVersion
Optional
- Type: java.lang.String
- Default: "7"
The version of PNPM to use if using PNPM as a package manager.
postBuildSteps
Optional
- Type: java.util.List
- Default: []
Steps to execute after build as part of the release workflow.
prerelease
Optional
- Type: java.lang.String
- Default: normal semantic versions
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre").
prettier
Optional
- Type: java.lang.Boolean
- Default: false
Setup prettier.
prettierOptions
Optional
- Type: io.github.cdklabs.projen.javascript.PrettierOptions
- Default: default options
Prettier options.
~~projectType
~~Optional
-
Deprecated: no longer supported at the base project level
-
Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenDevDependency
Optional
- Type: java.lang.Boolean
- Default: true if not a subproject
Indicates of "projen" should be installed as a devDependency.
projenrcJs
Optional
- Type: java.lang.Boolean
- Default: true if projenrcJson is false
Generate (once) .projenrc.js (in JavaScript). Set to false
in order to disable .projenrc.js generation.
projenrcJson
Optional
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
projenrcJsOptions
Optional
- Type: io.github.cdklabs.projen.javascript.ProjenrcOptions
- Default: default options
Options for .projenrc.js.
projenrcTs
Optional
- Type: java.lang.Boolean
- Default: false
Use TypeScript for your projenrc file (.projenrc.ts
).
projenrcTsOptions
Optional
- Type: io.github.cdklabs.projen.typescript.ProjenrcOptions
Options for .projenrc.ts.
~~projenTokenSecret
~~Optional
-
Deprecated: use
projenCredentials
-
Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
projenVersion
Optional
- Type: java.lang.String
- Default: Defaults to the latest version.
Version of projen to install.
publishDryRun
Optional
- Type: java.lang.Boolean
- Default: false
Instead of actually publishing to package managers, just print the publishing command.
publishTasks
Optional
- Type: java.lang.Boolean
- Default: false
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.
pullRequestTemplate
Optional
- Type: java.lang.Boolean
- Default: true
Include a GitHub pull request template.
pullRequestTemplateContents
Optional
- Type: java.util.List
- Default: default content
The contents of the pull request template.
readme
Optional
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
releasableCommits
Optional
- Type: io.github.cdklabs.projen.ReleasableCommits
- Default: ReleasableCommits.everyCommit()
Find commits that should be considered releasable Used to decide if a release is required.
release
Optional
- Type: java.lang.Boolean
- Default: true (false for subprojects)
Add release management to this project.
releaseBranches
Optional
- Type: java.util.Map
- Default: no additional branches are used for release. you can use
addBranch()
to add additional branches.
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.
~~releaseEveryCommit
~~Optional
-
Deprecated: Use
releaseTrigger: ReleaseTrigger.continuous()
instead -
Type: java.lang.Boolean
- Default: true
Automatically release new versions every commit to one of branches in releaseBranches
.
releaseFailureIssue
Optional
- Type: java.lang.Boolean
- Default: false
Create a github issue on every failed publishing task.
releaseFailureIssueLabel
Optional
- Type: java.lang.String
- Default: "failed-release"
The label to apply to issues indicating publish failures.
Only applies if releaseFailureIssue
is true.
~~releaseSchedule
~~Optional
-
Deprecated: Use
releaseTrigger: ReleaseTrigger.scheduled()
instead -
Type: java.lang.String
- Default: no scheduled releases
CRON schedule to trigger new releases.
releaseTagPrefix
Optional
- Type: java.lang.String
- Default: "v"
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.
releaseToNpm
Optional
- Type: java.lang.Boolean
- Default: false
Automatically release to npm when new versions are introduced.
releaseTrigger
Optional
- Type: io.github.cdklabs.projen.release.ReleaseTrigger
- Default: Continuous releases (
ReleaseTrigger.continuous()
)
The release trigger to use.
~~releaseWorkflow
~~Optional
-
Deprecated: see
release
. -
Type: java.lang.Boolean
- Default: true if not a subproject
DEPRECATED: renamed to release
.
releaseWorkflowName
Optional
- Type: java.lang.String
- Default: "release"
The name of the default release workflow.
releaseWorkflowSetupSteps
Optional
- Type: java.util.List
A set of workflow steps to execute in order to setup the workflow container.
renovatebot
Optional
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
repository
Optional
- Type: java.lang.String
The repository is the location where the actual code for your package lives.
See https://classic.yarnpkg.com/en/docs/package-json/#toc-repository
repositoryDirectory
Optional
- Type: java.lang.String
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives.
requireApproval
Optional
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sampleCode
Optional
- Type: java.lang.Boolean
- Default: true
Generate one-time sample in src/
and test/
if there are no files there.
scopedPackagesOptions
Optional
- Type: java.util.List
- Default: fetch all scoped packages from the public npm registry
Options for privately hosted scoped packages.
~~scripts
~~Optional
-
Deprecated: use
project.addTask()
orpackage.setScript()
-
Type: java.util.Map
- Default: {}
npm scripts to include.
If a script has the same name as a standard script, the standard script will be overwritten. Also adds the script as a task.
srcdir
Optional
- Type: java.lang.String
- Default: "src"
Typescript sources directory.
stability
Optional
- Type: java.lang.String
Package's Stability.
stale
Optional
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testdir
Optional
- Type: java.lang.String
- Default: "test"
Jest tests directory.
Tests files should be named xxx.test.ts
.
If this directory is under srcdir
(e.g. src/test
, src/__tests__
),
then tests are going to be compiled into lib/
and executed as javascript.
If the test directory is outside of src
, then we configure jest to
compile the code in-memory.
tsconfig
Optional
- Type: io.github.cdklabs.projen.javascript.TypescriptConfigOptions
- Default: default options
Custom TSConfig.
tsconfigDev
Optional
- Type: io.github.cdklabs.projen.javascript.TypescriptConfigOptions
- Default: use the production tsconfig options
Custom tsconfig options for the development tsconfig.json file (used for testing).
tsconfigDevFile
Optional
- Type: java.lang.String
- Default: "tsconfig.dev.json"
The name of the development tsconfig.json file.
tsJestOptions
Optional
- Type: io.github.cdklabs.projen.typescript.TsJestOptions
Options for ts-jest.
typescriptVersion
Optional
- Type: java.lang.String
- Default: "latest"
TypeScript version to use.
NOTE: Typescript is not semantically versioned and should remain on the
same minor, so we recommend using a ~
dependency (e.g. ~1.2.3
).
versionrcOptions
Optional
- Type: java.util.Map
- Default: standard configuration applicable for GitHub repositories
Custom configuration used when creating changelog with standard-version package.
Given values either append to default configuration or overwrite values in it.
vscode
Optional
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
workflowBootstrapSteps
Optional
- Type: java.util.List
- Default: "yarn install --frozen-lockfile && yarn projen"
Workflow steps to use in order to bootstrap this repo.
workflowContainerImage
Optional
- Type: java.lang.String
- Default: default image
Container image to use for GitHub workflows.
workflowGitIdentity
Optional
- Type: io.github.cdklabs.projen.github.GitIdentity
- Default: GitHub Actions
The git identity to use in workflows.
workflowNodeVersion
Optional
- Type: java.lang.String
- Default: same as
minNodeVersion
The node version to use in GitHub workflows.
workflowPackageCache
Optional
- Type: java.lang.Boolean
- Default: false
Enable Node.js package cache in GitHub workflows.
workflowRunsOn
Optional
- Type: java.util.List
- Default: ["ubuntu-latest"]
Github Runner selection labels.
workflowRunsOnGroup
Optional
- Type: io.github.cdklabs.projen.GroupRunnerOptions
Github Runner Group selection options.
yarnBerryOptions
Optional
- Type: io.github.cdklabs.projen.javascript.YarnBerryOptions
- Default: Yarn Berry v4 with all default options
Options for Yarn Berry.
allowSignup
Optional
- Type: java.lang.Boolean
- Default: false
Allow self sign up for the UserIdentity construct.
~~cloudscapeReactTsWebsite
~~Optional
-
Deprecated: use cloudscapeReactTsWebsites
-
Type: software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code.
cloudscapeReactTsWebsites
Optional
- Type: java.util.List
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code.
stackName
Optional
- Type: java.lang.String
- Default: infra-dev
Stack name.
stages
Optional
- Type: java.util.List<DeploymentStage>
List of deployment stages.
~~typeSafeApi
~~Optional
-
Deprecated: use typeSafeApis
-
Type: software.aws.pdk.infrastructure.TypeSafeApiProject
TypeSafeApi instance to use when setting up the initial project sample code.
typeSafeApis
Optional
- Type: java.util.List
TypeSafeApi instances to use when setting up the initial project sample code.
typeSafeWebSocketApis
Optional
- Type: java.util.List
TypeSafeWebSocketApi instances to use when setting up the initial project sample code.
Methods
Name | Description |
---|---|
toString |
Returns a string representation of this construct. |
addExcludeFromCleanup |
Exclude the matching files from pre-synth cleanup. |
addGitIgnore |
Adds a .gitignore pattern. |
addPackageIgnore |
Adds patterns to be ignored by npm. |
addTask |
Adds a new task to this project. |
addTip |
Prints a "tip" message during synthesis. |
annotateGenerated |
Marks the provided file(s) as being generated. |
postSynthesize |
Called after all components are synthesized. |
preSynthesize |
Called before all components are synthesized. |
removeTask |
Removes a task from a project. |
runTaskCommand |
Returns the shell command to execute in order to run a task. |
synth |
Synthesize all project files into outdir . |
tryFindFile |
Finds a file at the specified relative path within this project and all its subprojects. |
tryFindJsonFile |
Finds a json file by name. |
tryFindObjectFile |
Finds an object file (like JsonFile, YamlFile, etc.) by name. |
tryRemoveFile |
Finds a file at the specified relative path within this project and removes it. |
addBins |
No description. |
addBundledDeps |
Defines bundled dependencies. |
addCompileCommand |
DEPRECATED. |
addDeps |
Defines normal dependencies. |
addDevDeps |
Defines development/test dependencies. |
addFields |
Directly set fields in package.json . |
addKeywords |
Adds keywords to package.json (deduplicated). |
addPeerDeps |
Defines peer dependencies. |
addScripts |
Replaces the contents of multiple npm package.json scripts. |
addTestCommand |
DEPRECATED. |
hasScript |
Indicates if a script by the name name is defined. |
removeScript |
Removes the npm script (always successful). |
renderWorkflowSetup |
Returns the set of workflow steps which should be executed to bootstrap a workflow. |
setScript |
Replaces the contents of an npm package.json script. |
addCdkDependency |
Adds an AWS CDK module dependencies. |
toString
public java.lang.String toString()
Returns a string representation of this construct.
addExcludeFromCleanup
public void addExcludeFromCleanup(java.lang.String globs)
Exclude the matching files from pre-synth cleanup.
Can be used when, for example, some source files include the projen marker and we don't want them to be erased during synth.
globs
Required
- Type: java.lang.String
The glob patterns to match.
addGitIgnore
public void addGitIgnore(java.lang.String pattern)
Adds a .gitignore pattern.
pattern
Required
- Type: java.lang.String
The glob pattern to ignore.
addPackageIgnore
public void addPackageIgnore(java.lang.String pattern)
Adds patterns to be ignored by npm.
pattern
Required
- Type: java.lang.String
The pattern to ignore.
addTask
public Task addTask(java.lang.String name)
public Task addTask(java.lang.String name, TaskOptions props)
Adds a new task to this project.
This will fail if the project already has a task with this name.
name
Required
- Type: java.lang.String
The task name to add.
props
Optional
- Type: io.github.cdklabs.projen.TaskOptions
Task properties.
~~addTip
~~
public void addTip(java.lang.String message)
Prints a "tip" message during synthesis.
message
Required
- Type: java.lang.String
The message.
annotateGenerated
public void annotateGenerated(java.lang.String glob)
Marks the provided file(s) as being generated.
This is achieved using the github-linguist attributes. Generated files do not count against the repository statistics and language breakdown.
https://github.com/github/linguist/blob/master/docs/overrides.md
glob
Required
- Type: java.lang.String
the glob pattern to match (could be a file path).
postSynthesize
public void postSynthesize()
Called after all components are synthesized.
Order is not guaranteed.
preSynthesize
public void preSynthesize()
Called before all components are synthesized.
removeTask
public Task removeTask(java.lang.String name)
Removes a task from a project.
name
Required
- Type: java.lang.String
The name of the task to remove.
runTaskCommand
public java.lang.String runTaskCommand(Task task)
Returns the shell command to execute in order to run a task.
This will
typically be npx projen TASK
.
task
Required
- Type: io.github.cdklabs.projen.Task
The task for which the command is required.
synth
public void synth()
Synthesize all project files into outdir
.
- Call "this.preSynthesize()"
- Delete all generated files
- Synthesize all subprojects
- Synthesize all components of this project
- Call "postSynthesize()" for all components of this project
- Call "this.postSynthesize()"
tryFindFile
public FileBase tryFindFile(java.lang.String filePath)
Finds a file at the specified relative path within this project and all its subprojects.
filePath
Required
- Type: java.lang.String
The file path.
If this path is relative, it will be resolved from the root of this project.
~~tryFindJsonFile
~~
public JsonFile tryFindJsonFile(java.lang.String filePath)
Finds a json file by name.
filePath
Required
- Type: java.lang.String
The file path.
tryFindObjectFile
public ObjectFile tryFindObjectFile(java.lang.String filePath)
Finds an object file (like JsonFile, YamlFile, etc.) by name.
filePath
Required
- Type: java.lang.String
The file path.
tryRemoveFile
public FileBase tryRemoveFile(java.lang.String filePath)
Finds a file at the specified relative path within this project and removes it.
filePath
Required
- Type: java.lang.String
The file path.
If this path is relative, it will be resolved from the root of this project.
addBins
public void addBins(java.util.Map<java.lang.String, java.lang.String> bins)
bins
Required
- Type: java.util.Map
addBundledDeps
public void addBundledDeps(java.lang.String deps)
Defines bundled dependencies.
Bundled dependencies will be added as normal dependencies as well as to the
bundledDependencies
section of your package.json
.
deps
Required
- Type: java.lang.String
Names modules to install.
By default, the the dependency will
be installed in the next npx projen
run and the version will be recorded
in your package.json
file. You can upgrade manually or using yarn
add/upgrade
. If you wish to specify a version range use this syntax:
module@^7
.
~~addCompileCommand
~~
public void addCompileCommand(java.lang.String commands)
DEPRECATED.
commands
Required
- Type: java.lang.String
addDeps
public void addDeps(java.lang.String deps)
Defines normal dependencies.
deps
Required
- Type: java.lang.String
Names modules to install.
By default, the the dependency will
be installed in the next npx projen
run and the version will be recorded
in your package.json
file. You can upgrade manually or using yarn
add/upgrade
. If you wish to specify a version range use this syntax:
module@^7
.
addDevDeps
public void addDevDeps(java.lang.String deps)
Defines development/test dependencies.
deps
Required
- Type: java.lang.String
Names modules to install.
By default, the the dependency will
be installed in the next npx projen
run and the version will be recorded
in your package.json
file. You can upgrade manually or using yarn
add/upgrade
. If you wish to specify a version range use this syntax:
module@^7
.
addFields
public void addFields(java.util.Map<java.lang.String, java.lang.Object> fields)
Directly set fields in package.json
.
fields
Required
- Type: java.util.Map
The fields to set.
addKeywords
public void addKeywords(java.lang.String keywords)
Adds keywords to package.json (deduplicated).
keywords
Required
- Type: java.lang.String
The keywords to add.
addPeerDeps
public void addPeerDeps(java.lang.String deps)
Defines peer dependencies.
When adding peer dependencies, a devDependency will also be added on the pinned version of the declared peer. This will ensure that you are testing your code against the minimum version required from your consumers.
deps
Required
- Type: java.lang.String
Names modules to install.
By default, the the dependency will
be installed in the next npx projen
run and the version will be recorded
in your package.json
file. You can upgrade manually or using yarn
add/upgrade
. If you wish to specify a version range use this syntax:
module@^7
.
addScripts
public void addScripts(java.util.Map<java.lang.String, java.lang.String> scripts)
Replaces the contents of multiple npm package.json scripts.
scripts
Required
- Type: java.util.Map
The scripts to set.
~~addTestCommand
~~
public void addTestCommand(java.lang.String commands)
DEPRECATED.
commands
Required
- Type: java.lang.String
~~hasScript
~~
public java.lang.Boolean hasScript(java.lang.String name)
Indicates if a script by the name name is defined.
name
Required
- Type: java.lang.String
The name of the script.
removeScript
public void removeScript(java.lang.String name)
Removes the npm script (always successful).
name
Required
- Type: java.lang.String
The name of the script.
renderWorkflowSetup
public java.util.List<JobStep> renderWorkflowSetup()
public java.util.List<JobStep> renderWorkflowSetup(RenderWorkflowSetupOptions options)
Returns the set of workflow steps which should be executed to bootstrap a workflow.
options
Optional
- Type: io.github.cdklabs.projen.javascript.RenderWorkflowSetupOptions
Options.
setScript
public void setScript(java.lang.String name, java.lang.String command)
Replaces the contents of an npm package.json script.
name
Required
- Type: java.lang.String
The script name.
command
Required
- Type: java.lang.String
The command to execute.
addCdkDependency
public void addCdkDependency(java.lang.String modules)
Adds an AWS CDK module dependencies.
modules
Required
- Type: java.lang.String
The list of modules to depend on.
Static Functions
Name | Description |
---|---|
isConstruct |
Checks if x is a construct. |
isProject |
Test whether the given construct is a project. |
of |
Find the closest ancestor project for given construct. |
isConstruct
import software.aws.pdk.infrastructure.InfrastructureTsProject;
InfrastructureTsProject.isConstruct(java.lang.Object x)
Checks if x
is a construct.
Use this method instead of instanceof
to properly detect Construct
instances, even when the construct library is symlinked.
Explanation: in JavaScript, multiple copies of the constructs
library on
disk are seen as independent, completely different libraries. As a
consequence, the class Construct
in each copy of the constructs
library
is seen as a different class, and an instance of one class will not test as
instanceof
the other class. npm install
will not create installations
like this, but users may manually symlink construct libraries together or
use a monorepo tool: in those cases, multiple copies of the constructs
library can be accidentally installed, and instanceof
will behave
unpredictably. It is safest to avoid using instanceof
, and using
this type-testing method instead.
x
Required
- Type: java.lang.Object
Any object.
isProject
import software.aws.pdk.infrastructure.InfrastructureTsProject;
InfrastructureTsProject.isProject(java.lang.Object x)
Test whether the given construct is a project.
x
Required
- Type: java.lang.Object
of
import software.aws.pdk.infrastructure.InfrastructureTsProject;
InfrastructureTsProject.of(IConstruct construct)
Find the closest ancestor project for given construct.
When given a project, this it the project itself.
construct
Required
- Type: software.constructs.IConstruct
Properties
Name | Type | Description |
---|---|---|
node |
software.constructs.Node |
The tree node. |
buildTask |
io.github.cdklabs.projen.Task |
No description. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
compileTask |
io.github.cdklabs.projen.Task |
No description. |
components |
java.util.List |
Returns all the components within this project. |
deps |
io.github.cdklabs.projen.Dependencies |
Project dependencies. |
ejected |
java.lang.Boolean |
Whether or not the project is being ejected. |
files |
java.util.List |
All files in this project. |
gitattributes |
io.github.cdklabs.projen.GitAttributesFile |
The .gitattributes file for this repository. |
gitignore |
io.github.cdklabs.projen.IgnoreFile |
.gitignore. |
logger |
io.github.cdklabs.projen.Logger |
Logging utilities. |
name |
java.lang.String |
Project name. |
outdir |
java.lang.String |
Absolute output directory of this project. |
packageTask |
io.github.cdklabs.projen.Task |
No description. |
postCompileTask |
io.github.cdklabs.projen.Task |
No description. |
preCompileTask |
io.github.cdklabs.projen.Task |
No description. |
projectBuild |
io.github.cdklabs.projen.ProjectBuild |
Manages the build process of the project. |
projenCommand |
java.lang.String |
The command to use in order to run the projen CLI. |
root |
io.github.cdklabs.projen.Project |
The root project. |
subprojects |
java.util.List |
Returns all the subprojects within this project. |
tasks |
io.github.cdklabs.projen.Tasks |
Project tasks. |
testTask |
io.github.cdklabs.projen.Task |
No description. |
defaultTask |
io.github.cdklabs.projen.Task |
This is the "default" task, the one that executes "projen". |
initProject |
io.github.cdklabs.projen.InitProject |
The options used when this project is bootstrapped via projen new . |
parent |
io.github.cdklabs.projen.Project |
A parent project. |
projectType |
io.github.cdklabs.projen.ProjectType |
No description. |
autoApprove |
io.github.cdklabs.projen.github.AutoApprove |
Auto approve set up for this project. |
devContainer |
io.github.cdklabs.projen.vscode.DevContainer |
Access for .devcontainer.json (used for GitHub Codespaces). |
github |
io.github.cdklabs.projen.github.GitHub |
Access all github components. |
gitpod |
io.github.cdklabs.projen.Gitpod |
Access for Gitpod. |
vscode |
io.github.cdklabs.projen.vscode.VsCode |
Access all VSCode components. |
allowLibraryDependencies |
java.lang.Boolean |
No description. |
artifactsDirectory |
java.lang.String |
The build output directory. |
artifactsJavascriptDirectory |
java.lang.String |
The location of the npm tarball after build (${artifactsDirectory}/js ). |
bundler |
io.github.cdklabs.projen.javascript.Bundler |
No description. |
entrypoint |
java.lang.String |
No description. |
manifest |
java.lang.Object |
No description. |
npmrc |
io.github.cdklabs.projen.javascript.NpmConfig |
The .npmrc file. |
package |
io.github.cdklabs.projen.javascript.NodePackage |
API for managing the node package. |
packageManager |
io.github.cdklabs.projen.javascript.NodePackageManager |
The package manager to use. |
runScriptCommand |
java.lang.String |
The command to use to run scripts (e.g. yarn run or npm run depends on the package manager). |
autoMerge |
io.github.cdklabs.projen.github.AutoMerge |
Component that sets up mergify for merging approved pull requests. |
buildWorkflow |
io.github.cdklabs.projen.build.BuildWorkflow |
The PR build GitHub workflow. |
buildWorkflowJobId |
java.lang.String |
The job ID of the build workflow. |
jest |
io.github.cdklabs.projen.javascript.Jest |
The Jest configuration (if enabled). |
maxNodeVersion |
java.lang.String |
Maximum node version required by this package. |
minNodeVersion |
java.lang.String |
Minimum node.js version required by this package. |
npmignore |
io.github.cdklabs.projen.IgnoreFile |
The .npmignore file. |
prettier |
io.github.cdklabs.projen.javascript.Prettier |
No description. |
publisher |
io.github.cdklabs.projen.release.Publisher |
Package publisher. |
release |
io.github.cdklabs.projen.release.Release |
Release management. |
upgradeWorkflow |
io.github.cdklabs.projen.javascript.UpgradeDependencies |
The upgrade workflow. |
docsDirectory |
java.lang.String |
No description. |
libdir |
java.lang.String |
The directory in which compiled .js files reside. |
srcdir |
java.lang.String |
The directory in which the .ts sources reside. |
testdir |
java.lang.String |
The directory in which tests reside. |
tsconfigDev |
io.github.cdklabs.projen.javascript.TypescriptConfig |
A typescript configuration file which covers all files (sources, tests, projen). |
watchTask |
io.github.cdklabs.projen.Task |
The "watch" task. |
docgen |
java.lang.Boolean |
No description. |
eslint |
io.github.cdklabs.projen.javascript.Eslint |
No description. |
tsconfig |
io.github.cdklabs.projen.javascript.TypescriptConfig |
No description. |
tsconfigEslint |
io.github.cdklabs.projen.javascript.TypescriptConfig |
No description. |
appEntrypoint |
java.lang.String |
The CDK app entrypoint. |
cdkConfig |
io.github.cdklabs.projen.awscdk.CdkConfig |
cdk.json configuration. |
cdkDeps |
io.github.cdklabs.projen.awscdk.AwsCdkDeps |
No description. |
cdkTasks |
io.github.cdklabs.projen.awscdk.CdkTasks |
Common CDK tasks. |
cdkVersion |
java.lang.String |
The CDK version this app is using. |
node
Required
public Node getNode();
- Type: software.constructs.Node
The tree node.
buildTask
Required
public Task getBuildTask();
- Type: io.github.cdklabs.projen.Task
commitGenerated
Required
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
Whether to commit the managed files by default.
compileTask
Required
public Task getCompileTask();
- Type: io.github.cdklabs.projen.Task
components
Required
public java.util.List<Component> getComponents();
- Type: java.util.List
Returns all the components within this project.
deps
Required
public Dependencies getDeps();
- Type: io.github.cdklabs.projen.Dependencies
Project dependencies.
ejected
Required
public java.lang.Boolean getEjected();
- Type: java.lang.Boolean
Whether or not the project is being ejected.
files
Required
public java.util.List<FileBase> getFiles();
- Type: java.util.List
All files in this project.
gitattributes
Required
public GitAttributesFile getGitattributes();
- Type: io.github.cdklabs.projen.GitAttributesFile
The .gitattributes file for this repository.
gitignore
Required
public IgnoreFile getGitignore();
- Type: io.github.cdklabs.projen.IgnoreFile
.gitignore.
logger
Required
public Logger getLogger();
- Type: io.github.cdklabs.projen.Logger
Logging utilities.
name
Required
public java.lang.String getName();
- Type: java.lang.String
Project name.
outdir
Required
public java.lang.String getOutdir();
- Type: java.lang.String
Absolute output directory of this project.
packageTask
Required
public Task getPackageTask();
- Type: io.github.cdklabs.projen.Task
postCompileTask
Required
public Task getPostCompileTask();
- Type: io.github.cdklabs.projen.Task
preCompileTask
Required
public Task getPreCompileTask();
- Type: io.github.cdklabs.projen.Task
projectBuild
Required
public ProjectBuild getProjectBuild();
- Type: io.github.cdklabs.projen.ProjectBuild
Manages the build process of the project.
projenCommand
Required
public java.lang.String getProjenCommand();
- Type: java.lang.String
The command to use in order to run the projen CLI.
root
Required
public Project getRoot();
- Type: io.github.cdklabs.projen.Project
The root project.
subprojects
Required
public java.util.List<Project> getSubprojects();
- Type: java.util.List
Returns all the subprojects within this project.
tasks
Required
public Tasks getTasks();
- Type: io.github.cdklabs.projen.Tasks
Project tasks.
testTask
Required
public Task getTestTask();
- Type: io.github.cdklabs.projen.Task
defaultTask
Optional
public Task getDefaultTask();
- Type: io.github.cdklabs.projen.Task
This is the "default" task, the one that executes "projen".
Undefined if the project is being ejected.
initProject
Optional
public InitProject getInitProject();
- Type: io.github.cdklabs.projen.InitProject
The options used when this project is bootstrapped via projen new
.
It includes the original set of options passed to the CLI and also the JSII FQN of the project type.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
A parent project.
If undefined, this is the root project.
projectType
Required
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
autoApprove
Optional
public AutoApprove getAutoApprove();
- Type: io.github.cdklabs.projen.github.AutoApprove
Auto approve set up for this project.
devContainer
Optional
public DevContainer getDevContainer();
- Type: io.github.cdklabs.projen.vscode.DevContainer
Access for .devcontainer.json (used for GitHub Codespaces).
This will be undefined
if devContainer boolean is false
github
Optional
public GitHub getGithub();
- Type: io.github.cdklabs.projen.github.GitHub
Access all github components.
This will be undefined
for subprojects.
gitpod
Optional
public Gitpod getGitpod();
- Type: io.github.cdklabs.projen.Gitpod
Access for Gitpod.
This will be undefined
if gitpod boolean is false
vscode
Optional
public VsCode getVscode();
- Type: io.github.cdklabs.projen.vscode.VsCode
Access all VSCode components.
This will be undefined
for subprojects.
~~allowLibraryDependencies
~~Required
- Deprecated: use
package.allowLibraryDependencies
public java.lang.Boolean getAllowLibraryDependencies();
- Type: java.lang.Boolean
artifactsDirectory
Required
public java.lang.String getArtifactsDirectory();
- Type: java.lang.String
The build output directory.
An npm tarball will be created under the js
subdirectory. For example, if this is set to dist
(the default), the npm
tarball will be placed under dist/js/boom-boom-1.2.3.tg
.
artifactsJavascriptDirectory
Required
public java.lang.String getArtifactsJavascriptDirectory();
- Type: java.lang.String
The location of the npm tarball after build (${artifactsDirectory}/js
).
bundler
Required
public Bundler getBundler();
- Type: io.github.cdklabs.projen.javascript.Bundler
~~entrypoint
~~Required
- Deprecated: use
package.entrypoint
public java.lang.String getEntrypoint();
- Type: java.lang.String
~~manifest
~~Required
- Deprecated: use
package.addField(x, y)
public java.lang.Object getManifest();
- Type: java.lang.Object
npmrc
Required
public NpmConfig getNpmrc();
- Type: io.github.cdklabs.projen.javascript.NpmConfig
The .npmrc file.
package
Required
public NodePackage getPackage();
- Type: io.github.cdklabs.projen.javascript.NodePackage
API for managing the node package.
~~packageManager
~~Required
- Deprecated: use
package.packageManager
public NodePackageManager getPackageManager();
- Type: io.github.cdklabs.projen.javascript.NodePackageManager
The package manager to use.
runScriptCommand
Required
public java.lang.String getRunScriptCommand();
- Type: java.lang.String
The command to use to run scripts (e.g. yarn run
or npm run
depends on the package manager).
autoMerge
Optional
public AutoMerge getAutoMerge();
- Type: io.github.cdklabs.projen.github.AutoMerge
Component that sets up mergify for merging approved pull requests.
buildWorkflow
Optional
public BuildWorkflow getBuildWorkflow();
- Type: io.github.cdklabs.projen.build.BuildWorkflow
The PR build GitHub workflow.
undefined
if buildWorkflow
is disabled.
buildWorkflowJobId
Optional
public java.lang.String getBuildWorkflowJobId();
- Type: java.lang.String
The job ID of the build workflow.
jest
Optional
public Jest getJest();
- Type: io.github.cdklabs.projen.javascript.Jest
The Jest configuration (if enabled).
maxNodeVersion
Optional
public java.lang.String getMaxNodeVersion();
- Type: java.lang.String
Maximum node version required by this package.
minNodeVersion
Optional
public java.lang.String getMinNodeVersion();
- Type: java.lang.String
Minimum node.js version required by this package.
npmignore
Optional
public IgnoreFile getNpmignore();
- Type: io.github.cdklabs.projen.IgnoreFile
The .npmignore file.
prettier
Optional
public Prettier getPrettier();
- Type: io.github.cdklabs.projen.javascript.Prettier
~~publisher
~~Optional
- Deprecated: use
release.publisher
.
public Publisher getPublisher();
- Type: io.github.cdklabs.projen.release.Publisher
Package publisher.
This will be undefined
if the project does not have a
release workflow.
release
Optional
public Release getRelease();
- Type: io.github.cdklabs.projen.release.Release
Release management.
upgradeWorkflow
Optional
public UpgradeDependencies getUpgradeWorkflow();
- Type: io.github.cdklabs.projen.javascript.UpgradeDependencies
The upgrade workflow.
docsDirectory
Required
public java.lang.String getDocsDirectory();
- Type: java.lang.String
libdir
Required
public java.lang.String getLibdir();
- Type: java.lang.String
The directory in which compiled .js files reside.
srcdir
Required
public java.lang.String getSrcdir();
- Type: java.lang.String
The directory in which the .ts sources reside.
testdir
Required
public java.lang.String getTestdir();
- Type: java.lang.String
The directory in which tests reside.
tsconfigDev
Required
public TypescriptConfig getTsconfigDev();
- Type: io.github.cdklabs.projen.javascript.TypescriptConfig
A typescript configuration file which covers all files (sources, tests, projen).
watchTask
Required
public Task getWatchTask();
- Type: io.github.cdklabs.projen.Task
The "watch" task.
docgen
Optional
public java.lang.Boolean getDocgen();
- Type: java.lang.Boolean
eslint
Optional
public Eslint getEslint();
- Type: io.github.cdklabs.projen.javascript.Eslint
tsconfig
Optional
public TypescriptConfig getTsconfig();
- Type: io.github.cdklabs.projen.javascript.TypescriptConfig
tsconfigEslint
Optional
public TypescriptConfig getTsconfigEslint();
- Type: io.github.cdklabs.projen.javascript.TypescriptConfig
appEntrypoint
Required
public java.lang.String getAppEntrypoint();
- Type: java.lang.String
The CDK app entrypoint.
cdkConfig
Required
public CdkConfig getCdkConfig();
- Type: io.github.cdklabs.projen.awscdk.CdkConfig
cdk.json configuration.
cdkDeps
Required
public AwsCdkDeps getCdkDeps();
- Type: io.github.cdklabs.projen.awscdk.AwsCdkDeps
cdkTasks
Required
public CdkTasks getCdkTasks();
- Type: io.github.cdklabs.projen.awscdk.CdkTasks
Common CDK tasks.
cdkVersion
Required
public java.lang.String getCdkVersion();
- Type: java.lang.String
The CDK version this app is using.
Constants
Name | Type | Description |
---|---|---|
DEFAULT_TASK |
java.lang.String |
The name of the default task (the task executed when projen is run without arguments). |
DEFAULT_TS_JEST_TRANFORM_PATTERN |
java.lang.String |
No description. |
DEFAULT_TASK
Required
public java.lang.String getDefaultTask();
- Type: java.lang.String
The name of the default task (the task executed when projen
is run without arguments).
Normally this task should synthesize the project files.
DEFAULT_TS_JEST_TRANFORM_PATTERN
Required
public java.lang.String getDefaultTsJestTranformPattern();
- Type: java.lang.String
Structs
AwsCdkJavaAppOptions
AwsCdkJavaAppOptions.
Initializer
import software.aws.pdk.infrastructure.AwsCdkJavaAppOptions;
AwsCdkJavaAppOptions.builder()
.name(java.lang.String)
// .artifactId(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .buildCommand(java.lang.String)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .clobber(java.lang.Boolean)
// .commitGenerated(java.lang.Boolean)
// .compileOptions(MavenCompileOptions)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .deps(java.util.List<java.lang.String>)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .distdir(java.lang.String)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .groupId(java.lang.String)
// .junit(java.lang.Boolean)
// .junitOptions(JunitOptions)
// .logging(LoggerOptions)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .outdir(java.lang.String)
// .packaging(java.lang.String)
// .packagingOptions(MavenPackagingOptions)
// .parent(Project)
// .parentPom(ParentPom)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenrcJava(java.lang.Boolean)
// .projenrcJavaOptions(ProjenrcOptions)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenTokenSecret(java.lang.String)
// .readme(SampleReadmeProps)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .requireApproval(ApprovalLevel)
// .sample(java.lang.Boolean)
// .sampleJavaPackage(java.lang.String)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testDeps(java.util.List<java.lang.String>)
// .url(java.lang.String)
// .version(java.lang.String)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
.build();
Properties
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
artifactId |
java.lang.String |
The artifactId is generally the name that the project is known by. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
compileOptions |
io.github.cdklabs.projen.java.MavenCompileOptions |
Compile options. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
deps |
java.util.List |
List of runtime dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver> . |
description |
java.lang.String |
Description of a project is always good. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
distdir |
java.lang.String |
Final artifact output directory. |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
groupId |
java.lang.String |
This is generally unique amongst an organization or a project. |
junit |
java.lang.Boolean |
Include junit tests. |
junitOptions |
io.github.cdklabs.projen.java.JunitOptions |
junit options. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
packaging |
java.lang.String |
Project packaging format. |
packagingOptions |
io.github.cdklabs.projen.java.MavenPackagingOptions |
Packaging options. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
parentPom |
io.github.cdklabs.projen.java.ParentPom |
A Parent Pom can be used to have a child project inherit properties/plugins/ect in order to reduce duplication and keep standards across a large amount of repos. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenrcJava |
java.lang.Boolean |
Use projenrc in java. |
projenrcJavaOptions |
io.github.cdklabs.projen.java.ProjenrcOptions |
Options related to projenrc in java. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sample |
java.lang.Boolean |
Include sample code and test if the relevant directories don't exist. |
sampleJavaPackage |
java.lang.String |
The java package to use for the code sample. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testDeps |
java.util.List |
List of test dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver> . |
url |
java.lang.String |
The URL, like the name, is not required. |
version |
java.lang.String |
This is the last piece of the naming puzzle. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
name
Required
public java.lang.String getName();
- Type: java.lang.String
- Default: $BASEDIR
artifactId
Optional
public java.lang.String getArtifactId();
- Type: java.lang.String
- Default: "my-app"
The artifactId is generally the name that the project is known by.
Although the groupId is important, people within the group will rarely mention the groupId in discussion (they are often all be the same ID, such as the MojoHaus project groupId: org.codehaus.mojo). It, along with the groupId, creates a key that separates this project from every other project in the world (at least, it should :) ). Along with the groupId, the artifactId fully defines the artifact's living quarters within the repository. In the case of the above project, my-project lives in $M2_REPO/org/codehaus/mojo/my-project.
autoApproveOptions
Optional
public AutoApproveOptions getAutoApproveOptions();
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoMerge
Optional
public java.lang.Boolean getAutoMerge();
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
public AutoMergeOptions getAutoMergeOptions();
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
buildCommand
Optional
public java.lang.String getBuildCommand();
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
~~cdkAssert
~~Optional
- Deprecated: The
public java.lang.Boolean getCdkAssert();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
public java.lang.Boolean getCdkAssertions();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
- Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
public java.util.List<java.lang.String> getCdkDependencies();
- Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
- Deprecated: Not supported in CDK v2.
public java.lang.Boolean getCdkDependenciesAsDeps();
- Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
public java.lang.String getCdkout();
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
- Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
public java.util.List<java.lang.String> getCdkTestDependencies();
- Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
public java.lang.String getCdkVersion();
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
public java.lang.Boolean getCdkVersionPinning();
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
clobber
Optional
public java.lang.Boolean getClobber();
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
commitGenerated
Optional
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
compileOptions
Optional
public MavenCompileOptions getCompileOptions();
- Type: io.github.cdklabs.projen.java.MavenCompileOptions
- Default: defaults
Compile options.
constructsVersion
Optional
public java.lang.String getConstructsVersion();
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
public java.util.Map<java.lang.String, java.lang.Object> getContext();
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
deps
Optional
public java.util.List<java.lang.String> getDeps();
- Type: java.util.List
- Default: []
List of runtime dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver>
.
Additional dependencies can be added via project.addDependency()
.
description
Optional
public java.lang.String getDescription();
- Type: java.lang.String
- Default: undefined
Description of a project is always good.
Although this should not replace formal documentation, a quick comment to any readers of the POM is always helpful.
devContainer
Optional
public java.lang.Boolean getDevContainer();
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
distdir
Optional
public java.lang.String getDistdir();
- Type: java.lang.String
- Default: "dist/java"
Final artifact output directory.
featureFlags
Optional
public java.lang.Boolean getFeatureFlags();
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
public java.lang.Boolean getGithub();
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
public GitHubOptions getGithubOptions();
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitIgnoreOptions
Optional
public IgnoreFileOptions getGitIgnoreOptions();
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
public GitOptions getGitOptions();
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
public java.lang.Boolean getGitpod();
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
groupId
Optional
public java.lang.String getGroupId();
- Type: java.lang.String
- Default: "org.acme"
This is generally unique amongst an organization or a project.
For example, all core Maven artifacts do (well, should) live under the groupId org.apache.maven. Group ID's do not necessarily use the dot notation, for example, the junit project. Note that the dot-notated groupId does not have to correspond to the package structure that the project contains. It is, however, a good practice to follow. When stored within a repository, the group acts much like the Java packaging structure does in an operating system. The dots are replaced by OS specific directory separators (such as '/' in Unix) which becomes a relative directory structure from the base repository. In the example given, the org.codehaus.mojo group lives within the directory $M2_REPO/org/codehaus/mojo.
junit
Optional
public java.lang.Boolean getJunit();
- Type: java.lang.Boolean
- Default: true
Include junit tests.
junitOptions
Optional
public JunitOptions getJunitOptions();
- Type: io.github.cdklabs.projen.java.JunitOptions
- Default: defaults
junit options.
logging
Optional
public LoggerOptions getLogging();
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
~~mergify
~~Optional
- Deprecated: use
githubOptions.mergify
instead
public java.lang.Boolean getMergify();
- Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
- Deprecated: use
githubOptions.mergifyOptions
instead
public MergifyOptions getMergifyOptions();
- Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
outdir
Optional
public java.lang.String getOutdir();
- Type: java.lang.String
- Default: "."
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 subprojects.
packaging
Optional
public java.lang.String getPackaging();
- Type: java.lang.String
- Default: "jar"
Project packaging format.
packagingOptions
Optional
public MavenPackagingOptions getPackagingOptions();
- Type: io.github.cdklabs.projen.java.MavenPackagingOptions
- Default: defaults
Packaging options.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
parentPom
Optional
public ParentPom getParentPom();
- Type: io.github.cdklabs.projen.java.ParentPom
- Default: undefined
A Parent Pom can be used to have a child project inherit properties/plugins/ect in order to reduce duplication and keep standards across a large amount of repos.
~~projectType
~~Optional
- Deprecated: no longer supported at the base project level
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
public java.lang.String getProjenCommand();
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
public GithubCredentials getProjenCredentials();
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenrcJava
Optional
public java.lang.Boolean getProjenrcJava();
- Type: java.lang.Boolean
- Default: true
Use projenrc in java.
This will install projen
as a java dependency and will add a synth
task which
will compile & execute main()
from src/main/java/projenrc.java
.
projenrcJavaOptions
Optional
public ProjenrcOptions getProjenrcJavaOptions();
- Type: io.github.cdklabs.projen.java.ProjenrcOptions
- Default: default options
Options related to projenrc in java.
projenrcJson
Optional
public java.lang.Boolean getProjenrcJson();
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
public ProjenrcJsonOptions getProjenrcJsonOptions();
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
~~projenTokenSecret
~~Optional
- Deprecated: use
projenCredentials
public java.lang.String getProjenTokenSecret();
- Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
readme
Optional
public SampleReadmeProps getReadme();
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
renovatebot
Optional
public java.lang.Boolean getRenovatebot();
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
public RenovatebotOptions getRenovatebotOptions();
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
requireApproval
Optional
public ApprovalLevel getRequireApproval();
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sample
Optional
public java.lang.Boolean getSample();
- Type: java.lang.Boolean
- Default: true
Include sample code and test if the relevant directories don't exist.
sampleJavaPackage
Optional
public java.lang.String getSampleJavaPackage();
- Type: java.lang.String
- Default: "org.acme"
The java package to use for the code sample.
stale
Optional
public java.lang.Boolean getStale();
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
public StaleOptions getStaleOptions();
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testDeps
Optional
public java.util.List<java.lang.String> getTestDeps();
- Type: java.util.List
- Default: []
List of test dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver>
.
Additional dependencies can be added via project.addTestDependency()
.
url
Optional
public java.lang.String getUrl();
- Type: java.lang.String
- Default: undefined
The URL, like the name, is not required.
This is a nice gesture for projects users, however, so that they know where the project lives.
version
Optional
public java.lang.String getVersion();
- Type: java.lang.String
- Default: "0.1.0"
This is the last piece of the naming puzzle.
groupId:artifactId denotes a single project but they cannot delineate which incarnation of that project we are talking about. Do we want the junit:junit of 2018 (version 4.12), or of 2007 (version 3.8.2)? In short: code changes, those changes should be versioned, and this element keeps those versions in line. It is also used within an artifact's repository to separate versions from each other. my-project version 1.0 files live in the directory structure $M2_REPO/org/codehaus/mojo/my-project/1.0.
vscode
Optional
public java.lang.Boolean getVscode();
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
public java.util.List<java.lang.String> getWatchExcludes();
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
public java.util.List<java.lang.String> getWatchIncludes();
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
AwsCdkPythonAppOptions
AwsCdkPythonAppOptions.
Initializer
import software.aws.pdk.infrastructure.AwsCdkPythonAppOptions;
AwsCdkPythonAppOptions.builder()
.name(java.lang.String)
// .authorEmail(java.lang.String)
// .authorName(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .buildCommand(java.lang.String)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .classifiers(java.util.List<java.lang.String>)
// .clobber(java.lang.Boolean)
// .commitGenerated(java.lang.Boolean)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .deps(java.util.List<java.lang.String>)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .devDeps(java.util.List<java.lang.String>)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .homepage(java.lang.String)
// .license(java.lang.String)
// .logging(LoggerOptions)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .moduleName(java.lang.String)
// .outdir(java.lang.String)
// .packageName(java.lang.String)
// .parent(Project)
// .poetryOptions(PoetryPyprojectOptionsWithoutDeps)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenrcPythonOptions(ProjenrcOptions)
// .projenTokenSecret(java.lang.String)
// .pytest(java.lang.Boolean)
// .pytestOptions(PytestOptions)
// .pythonExec(java.lang.String)
// .readme(SampleReadmeProps)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .requireApproval(ApprovalLevel)
// .sample(java.lang.Boolean)
// .setupConfig(java.util.Map<java.lang.String, java.lang.Object>)
// .setuptools(java.lang.Boolean)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testdir(java.lang.String)
// .version(java.lang.String)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
.build();
Properties
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
authorEmail |
java.lang.String |
Author's e-mail. |
authorName |
java.lang.String |
Author's name. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
classifiers |
java.util.List |
A list of PyPI trove classifiers that describe the project. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
deps |
java.util.List |
List of runtime dependencies for this project. Dependencies use the format: <module>@<semver> . |
description |
java.lang.String |
A short description of the package. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
devDeps |
java.util.List |
List of dev dependencies for this project. Dependencies use the format: <module>@<semver> . |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
homepage |
java.lang.String |
A URL to the website of the project. |
license |
java.lang.String |
License of this package as an SPDX identifier. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
moduleName |
java.lang.String |
Name of the python package as used in imports and filenames. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
packageName |
java.lang.String |
Package name. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
poetryOptions |
io.github.cdklabs.projen.python.PoetryPyprojectOptionsWithoutDeps |
Additional options to set for poetry if using poetry. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenrcPythonOptions |
io.github.cdklabs.projen.python.ProjenrcOptions |
Options related to projenrc in python. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
pytest |
java.lang.Boolean |
Include pytest tests. |
pytestOptions |
io.github.cdklabs.projen.python.PytestOptions |
pytest options. |
pythonExec |
java.lang.String |
Path to the python executable to use. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sample |
java.lang.Boolean |
Include sample code and test if the relevant directories don't exist. |
setupConfig |
java.util.Map |
Additional fields to pass in the setup() function if using setuptools. |
setuptools |
java.lang.Boolean |
Use setuptools with a setup.py script for packaging and publishing. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testdir |
java.lang.String |
Python sources directory. |
version |
java.lang.String |
Version of the package. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
name
Required
public java.lang.String getName();
- Type: java.lang.String
- Default: $BASEDIR
authorEmail
Optional
public java.lang.String getAuthorEmail();
- Type: java.lang.String
- Default: $GIT_USER_EMAIL
Author's e-mail.
authorName
Optional
public java.lang.String getAuthorName();
- Type: java.lang.String
- Default: $GIT_USER_NAME
Author's name.
autoApproveOptions
Optional
public AutoApproveOptions getAutoApproveOptions();
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoMerge
Optional
public java.lang.Boolean getAutoMerge();
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
public AutoMergeOptions getAutoMergeOptions();
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
buildCommand
Optional
public java.lang.String getBuildCommand();
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
~~cdkAssert
~~Optional
- Deprecated: The
public java.lang.Boolean getCdkAssert();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
public java.lang.Boolean getCdkAssertions();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
- Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
public java.util.List<java.lang.String> getCdkDependencies();
- Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
- Deprecated: Not supported in CDK v2.
public java.lang.Boolean getCdkDependenciesAsDeps();
- Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
public java.lang.String getCdkout();
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
- Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
public java.util.List<java.lang.String> getCdkTestDependencies();
- Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
public java.lang.String getCdkVersion();
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
public java.lang.Boolean getCdkVersionPinning();
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
classifiers
Optional
public java.util.List<java.lang.String> getClassifiers();
- Type: java.util.List
A list of PyPI trove classifiers that describe the project.
clobber
Optional
public java.lang.Boolean getClobber();
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
commitGenerated
Optional
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
constructsVersion
Optional
public java.lang.String getConstructsVersion();
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
public java.util.Map<java.lang.String, java.lang.Object> getContext();
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
deps
Optional
public java.util.List<java.lang.String> getDeps();
- Type: java.util.List
- Default: []
List of runtime dependencies for this project. Dependencies use the format: <module>@<semver>
.
Additional dependencies can be added via project.addDependency()
.
description
Optional
public java.lang.String getDescription();
- Type: java.lang.String
A short description of the package.
devContainer
Optional
public java.lang.Boolean getDevContainer();
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
devDeps
Optional
public java.util.List<java.lang.String> getDevDeps();
- Type: java.util.List
- Default: []
List of dev dependencies for this project. Dependencies use the format: <module>@<semver>
.
Additional dependencies can be added via project.addDevDependency()
.
featureFlags
Optional
public java.lang.Boolean getFeatureFlags();
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
public java.lang.Boolean getGithub();
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
public GitHubOptions getGithubOptions();
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitIgnoreOptions
Optional
public IgnoreFileOptions getGitIgnoreOptions();
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
public GitOptions getGitOptions();
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
public java.lang.Boolean getGitpod();
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
homepage
Optional
public java.lang.String getHomepage();
- Type: java.lang.String
A URL to the website of the project.
license
Optional
public java.lang.String getLicense();
- Type: java.lang.String
License of this package as an SPDX identifier.
logging
Optional
public LoggerOptions getLogging();
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
~~mergify
~~Optional
- Deprecated: use
githubOptions.mergify
instead
public java.lang.Boolean getMergify();
- Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
- Deprecated: use
githubOptions.mergifyOptions
instead
public MergifyOptions getMergifyOptions();
- Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
moduleName
Optional
public java.lang.String getModuleName();
- Type: java.lang.String
- Default: $PYTHON_MODULE_NAME
Name of the python package as used in imports and filenames.
Must only consist of alphanumeric characters and underscores.
outdir
Optional
public java.lang.String getOutdir();
- Type: java.lang.String
- Default: "."
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 subprojects.
packageName
Optional
public java.lang.String getPackageName();
- Type: java.lang.String
Package name.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
poetryOptions
Optional
public PoetryPyprojectOptionsWithoutDeps getPoetryOptions();
- Type: io.github.cdklabs.projen.python.PoetryPyprojectOptionsWithoutDeps
Additional options to set for poetry if using poetry.
~~projectType
~~Optional
- Deprecated: no longer supported at the base project level
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
public java.lang.String getProjenCommand();
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
public GithubCredentials getProjenCredentials();
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenrcJson
Optional
public java.lang.Boolean getProjenrcJson();
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
public ProjenrcJsonOptions getProjenrcJsonOptions();
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
projenrcPythonOptions
Optional
public ProjenrcOptions getProjenrcPythonOptions();
- Type: io.github.cdklabs.projen.python.ProjenrcOptions
- Default: default options
Options related to projenrc in python.
~~projenTokenSecret
~~Optional
- Deprecated: use
projenCredentials
public java.lang.String getProjenTokenSecret();
- Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
pytest
Optional
public java.lang.Boolean getPytest();
- Type: java.lang.Boolean
- Default: true
Include pytest tests.
pytestOptions
Optional
public PytestOptions getPytestOptions();
- Type: io.github.cdklabs.projen.python.PytestOptions
- Default: defaults
pytest options.
pythonExec
Optional
public java.lang.String getPythonExec();
- Type: java.lang.String
- Default: "python"
Path to the python executable to use.
readme
Optional
public SampleReadmeProps getReadme();
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
renovatebot
Optional
public java.lang.Boolean getRenovatebot();
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
public RenovatebotOptions getRenovatebotOptions();
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
requireApproval
Optional
public ApprovalLevel getRequireApproval();
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sample
Optional
public java.lang.Boolean getSample();
- Type: java.lang.Boolean
- Default: true
Include sample code and test if the relevant directories don't exist.
setupConfig
Optional
public java.util.Map<java.lang.String, java.lang.Object> getSetupConfig();
- Type: java.util.Map
Additional fields to pass in the setup() function if using setuptools.
setuptools
Optional
public java.lang.Boolean getSetuptools();
- Type: java.lang.Boolean
- Default: true, unless poetry is true, then false
Use setuptools with a setup.py script for packaging and publishing.
stale
Optional
public java.lang.Boolean getStale();
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
public StaleOptions getStaleOptions();
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testdir
Optional
public java.lang.String getTestdir();
- Type: java.lang.String
- Default: "tests"
Python sources directory.
version
Optional
public java.lang.String getVersion();
- Type: java.lang.String
- Default: "0.1.0"
Version of the package.
vscode
Optional
public java.lang.Boolean getVscode();
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
public java.util.List<java.lang.String> getWatchExcludes();
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
public java.util.List<java.lang.String> getWatchIncludes();
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
AwsCdkTypeScriptAppOptions
AwsCdkTypeScriptAppOptions.
Initializer
import software.aws.pdk.infrastructure.AwsCdkTypeScriptAppOptions;
AwsCdkTypeScriptAppOptions.builder()
.name(java.lang.String)
// .allowLibraryDependencies(java.lang.Boolean)
// .appEntrypoint(java.lang.String)
// .artifactsDirectory(java.lang.String)
// .authorEmail(java.lang.String)
// .authorName(java.lang.String)
// .authorOrganization(java.lang.Boolean)
// .authorUrl(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoApproveUpgrades(java.lang.Boolean)
// .autoDetectBin(java.lang.Boolean)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .bin(java.util.Map<java.lang.String, java.lang.String>)
// .bugsEmail(java.lang.String)
// .bugsUrl(java.lang.String)
// .buildCommand(java.lang.String)
// .buildWorkflow(java.lang.Boolean)
// .buildWorkflowOptions(BuildWorkflowOptions)
// .buildWorkflowTriggers(Triggers)
// .bundledDeps(java.util.List<java.lang.String>)
// .bundlerOptions(BundlerOptions)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .checkLicenses(LicenseCheckerOptions)
// .clobber(java.lang.Boolean)
// .codeArtifactOptions(CodeArtifactOptions)
// .codeCov(java.lang.Boolean)
// .codeCovTokenSecret(java.lang.String)
// .commitGenerated(java.lang.Boolean)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .copyrightOwner(java.lang.String)
// .copyrightPeriod(java.lang.String)
// .defaultReleaseBranch(java.lang.String)
// .dependabot(java.lang.Boolean)
// .dependabotOptions(DependabotOptions)
// .deps(java.util.List<java.lang.String>)
// .depsUpgrade(java.lang.Boolean)
// .depsUpgradeOptions(UpgradeDependenciesOptions)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .devDeps(java.util.List<java.lang.String>)
// .disableTsconfig(java.lang.Boolean)
// .disableTsconfigDev(java.lang.Boolean)
// .docgen(java.lang.Boolean)
// .docsDirectory(java.lang.String)
// .edgeLambdaAutoDiscover(java.lang.Boolean)
// .entrypoint(java.lang.String)
// .entrypointTypes(java.lang.String)
// .eslint(java.lang.Boolean)
// .eslintOptions(EslintOptions)
// .experimentalIntegRunner(java.lang.Boolean)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitignore(java.util.List<java.lang.String>)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .homepage(java.lang.String)
// .integrationTestAutoDiscover(java.lang.Boolean)
// .jest(java.lang.Boolean)
// .jestOptions(JestOptions)
// .jsiiReleaseVersion(java.lang.String)
// .keywords(java.util.List<java.lang.String>)
// .lambdaAutoDiscover(java.lang.Boolean)
// .lambdaExtensionAutoDiscover(java.lang.Boolean)
// .lambdaOptions(LambdaFunctionCommonOptions)
// .libdir(java.lang.String)
// .license(java.lang.String)
// .licensed(java.lang.Boolean)
// .logging(LoggerOptions)
// .majorVersion(java.lang.Number)
// .maxNodeVersion(java.lang.String)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .minMajorVersion(java.lang.Number)
// .minNodeVersion(java.lang.String)
// .mutableBuild(java.lang.Boolean)
// .npmAccess(NpmAccess)
// .npmDistTag(java.lang.String)
// .npmignore(java.util.List<java.lang.String>)
// .npmignoreEnabled(java.lang.Boolean)
// .npmIgnoreOptions(IgnoreFileOptions)
// .npmProvenance(java.lang.Boolean)
// .npmRegistry(java.lang.String)
// .npmRegistryUrl(java.lang.String)
// .npmTokenSecret(java.lang.String)
// .outdir(java.lang.String)
// .package(java.lang.Boolean)
// .packageManager(NodePackageManager)
// .packageName(java.lang.String)
// .parent(Project)
// .peerDependencyOptions(PeerDependencyOptions)
// .peerDeps(java.util.List<java.lang.String>)
// .pnpmVersion(java.lang.String)
// .postBuildSteps(java.util.List<JobStep>)
// .prerelease(java.lang.String)
// .prettier(java.lang.Boolean)
// .prettierOptions(PrettierOptions)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenDevDependency(java.lang.Boolean)
// .projenrcJs(java.lang.Boolean)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenrcJsOptions(ProjenrcOptions)
// .projenrcTs(java.lang.Boolean)
// .projenrcTsOptions(ProjenrcOptions)
// .projenTokenSecret(java.lang.String)
// .projenVersion(java.lang.String)
// .publishDryRun(java.lang.Boolean)
// .publishTasks(java.lang.Boolean)
// .pullRequestTemplate(java.lang.Boolean)
// .pullRequestTemplateContents(java.util.List<java.lang.String>)
// .readme(SampleReadmeProps)
// .releasableCommits(ReleasableCommits)
// .release(java.lang.Boolean)
// .releaseBranches(java.util.Map<java.lang.String, BranchOptions>)
// .releaseEveryCommit(java.lang.Boolean)
// .releaseFailureIssue(java.lang.Boolean)
// .releaseFailureIssueLabel(java.lang.String)
// .releaseSchedule(java.lang.String)
// .releaseTagPrefix(java.lang.String)
// .releaseToNpm(java.lang.Boolean)
// .releaseTrigger(ReleaseTrigger)
// .releaseWorkflow(java.lang.Boolean)
// .releaseWorkflowName(java.lang.String)
// .releaseWorkflowSetupSteps(java.util.List<JobStep>)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .repository(java.lang.String)
// .repositoryDirectory(java.lang.String)
// .requireApproval(ApprovalLevel)
// .sampleCode(java.lang.Boolean)
// .scopedPackagesOptions(java.util.List<ScopedPackagesOptions>)
// .scripts(java.util.Map<java.lang.String, java.lang.String>)
// .srcdir(java.lang.String)
// .stability(java.lang.String)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testdir(java.lang.String)
// .tsconfig(TypescriptConfigOptions)
// .tsconfigDev(TypescriptConfigOptions)
// .tsconfigDevFile(java.lang.String)
// .tsJestOptions(TsJestOptions)
// .typescriptVersion(java.lang.String)
// .versionrcOptions(java.util.Map<java.lang.String, java.lang.Object>)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .workflowBootstrapSteps(java.util.List<JobStep>)
// .workflowContainerImage(java.lang.String)
// .workflowGitIdentity(GitIdentity)
// .workflowNodeVersion(java.lang.String)
// .workflowPackageCache(java.lang.Boolean)
// .workflowRunsOn(java.util.List<java.lang.String>)
// .workflowRunsOnGroup(GroupRunnerOptions)
// .yarnBerryOptions(YarnBerryOptions)
.build();
Properties
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
allowLibraryDependencies |
java.lang.Boolean |
Allow the project to include peerDependencies and bundledDependencies . |
appEntrypoint |
java.lang.String |
The CDK app's entrypoint (relative to the source directory, which is "src" by default). |
artifactsDirectory |
java.lang.String |
A directory which will contain build artifacts. |
authorEmail |
java.lang.String |
Author's e-mail. |
authorName |
java.lang.String |
Author's name. |
authorOrganization |
java.lang.Boolean |
Is the author an organization. |
authorUrl |
java.lang.String |
Author's URL / Website. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoApproveUpgrades |
java.lang.Boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). |
autoDetectBin |
java.lang.Boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
bin |
java.util.Map |
Binary programs vended with your module. |
bugsEmail |
java.lang.String |
The email address to which issues should be reported. |
bugsUrl |
java.lang.String |
The url to your project's issue tracker. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
buildWorkflow |
java.lang.Boolean |
Define a GitHub workflow for building PRs. |
buildWorkflowOptions |
io.github.cdklabs.projen.javascript.BuildWorkflowOptions |
Options for PR build workflow. |
buildWorkflowTriggers |
io.github.cdklabs.projen.github.workflows.Triggers |
Build workflow triggers. |
bundledDeps |
java.util.List |
List of dependencies to bundle into this module. |
bundlerOptions |
io.github.cdklabs.projen.javascript.BundlerOptions |
Options for Bundler . |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
checkLicenses |
io.github.cdklabs.projen.javascript.LicenseCheckerOptions |
Configure which licenses should be deemed acceptable for use by dependencies. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
codeArtifactOptions |
io.github.cdklabs.projen.javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. |
codeCov |
java.lang.Boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v4 A secret is required for private repos. Configured with @codeCovTokenSecret . |
codeCovTokenSecret |
java.lang.String |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
copyrightOwner |
java.lang.String |
License copyright owner. |
copyrightPeriod |
java.lang.String |
The copyright years to put in the LICENSE file. |
defaultReleaseBranch |
java.lang.String |
The name of the main release branch. |
dependabot |
java.lang.Boolean |
Use dependabot to handle dependency upgrades. |
dependabotOptions |
io.github.cdklabs.projen.github.DependabotOptions |
Options for dependabot. |
deps |
java.util.List |
Runtime dependencies of this module. |
depsUpgrade |
java.lang.Boolean |
Use tasks and github workflows to handle dependency upgrades. |
depsUpgradeOptions |
io.github.cdklabs.projen.javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies . |
description |
java.lang.String |
The description is just a string that helps people understand the purpose of the package. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
devDeps |
java.util.List |
Build dependencies for this module. |
disableTsconfig |
java.lang.Boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler). |
disableTsconfigDev |
java.lang.Boolean |
Do not generate a tsconfig.dev.json file. |
docgen |
java.lang.Boolean |
Docgen by Typedoc. |
docsDirectory |
java.lang.String |
Docs directory. |
edgeLambdaAutoDiscover |
java.lang.Boolean |
Automatically adds an cloudfront.experimental.EdgeFunction for each .edge-lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
entrypoint |
java.lang.String |
Module entrypoint (main in package.json ). Set to an empty string to not include main in your package.json. |
entrypointTypes |
java.lang.String |
The .d.ts file that includes the type declarations for this module. |
eslint |
java.lang.Boolean |
Setup eslint. |
eslintOptions |
io.github.cdklabs.projen.javascript.EslintOptions |
Eslint options. |
experimentalIntegRunner |
java.lang.Boolean |
Enable experimental support for the AWS CDK integ-runner. |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitignore |
java.util.List |
Additional entries to .gitignore. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
homepage |
java.lang.String |
Package's Homepage / Website. |
integrationTestAutoDiscover |
java.lang.Boolean |
Automatically discovers and creates integration tests for each .integ.ts file in under your test directory. |
jest |
java.lang.Boolean |
Setup jest unit tests. |
jestOptions |
io.github.cdklabs.projen.javascript.JestOptions |
Jest options. |
jsiiReleaseVersion |
java.lang.String |
Version requirement of publib which is used to publish modules to npm. |
keywords |
java.util.List |
Keywords to include in package.json . |
lambdaAutoDiscover |
java.lang.Boolean |
Automatically adds an awscdk.LambdaFunction for each .lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
lambdaExtensionAutoDiscover |
java.lang.Boolean |
Automatically adds an awscdk.LambdaExtension for each .lambda-extension.ts entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
lambdaOptions |
io.github.cdklabs.projen.awscdk.LambdaFunctionCommonOptions |
Common options for all AWS Lambda functions. |
libdir |
java.lang.String |
Typescript artifacts output directory. |
license |
java.lang.String |
License's SPDX identifier. |
licensed |
java.lang.Boolean |
Indicates if a license should be added. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
majorVersion |
java.lang.Number |
Major version to release from the default branch. |
maxNodeVersion |
java.lang.String |
Minimum node.js version to require via engines (inclusive). |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
minMajorVersion |
java.lang.Number |
Minimal Major version to release. |
minNodeVersion |
java.lang.String |
Minimum Node.js version to require via package.json engines (inclusive). |
mutableBuild |
java.lang.Boolean |
Automatically update files modified during builds to pull-request branches. |
npmAccess |
io.github.cdklabs.projen.javascript.NpmAccess |
Access level of the npm package. |
npmDistTag |
java.lang.String |
The npmDistTag to use when publishing from the default branch. |
npmignore |
java.util.List |
Additional entries to .npmignore. |
npmignoreEnabled |
java.lang.Boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. |
npmIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .npmignore file. |
npmProvenance |
java.lang.Boolean |
Should provenance statements be generated when the package is published. |
npmRegistry |
java.lang.String |
The host name of the npm registry to publish to. |
npmRegistryUrl |
java.lang.String |
The base URL of the npm package registry. |
npmTokenSecret |
java.lang.String |
GitHub secret which contains the NPM token to use when publishing packages. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
package |
java.lang.Boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist ). |
packageManager |
io.github.cdklabs.projen.javascript.NodePackageManager |
The Node Package Manager used to execute scripts. |
packageName |
java.lang.String |
The "name" in package.json. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
peerDependencyOptions |
io.github.cdklabs.projen.javascript.PeerDependencyOptions |
Options for peerDeps . |
peerDeps |
java.util.List |
Peer dependencies for this module. |
pnpmVersion |
java.lang.String |
The version of PNPM to use if using PNPM as a package manager. |
postBuildSteps |
java.util.List |
Steps to execute after build as part of the release workflow. |
prerelease |
java.lang.String |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). |
prettier |
java.lang.Boolean |
Setup prettier. |
prettierOptions |
io.github.cdklabs.projen.javascript.PrettierOptions |
Prettier options. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenDevDependency |
java.lang.Boolean |
Indicates of "projen" should be installed as a devDependency. |
projenrcJs |
java.lang.Boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenrcJsOptions |
io.github.cdklabs.projen.javascript.ProjenrcOptions |
Options for .projenrc.js. |
projenrcTs |
java.lang.Boolean |
Use TypeScript for your projenrc file (.projenrc.ts ). |
projenrcTsOptions |
io.github.cdklabs.projen.typescript.ProjenrcOptions |
Options for .projenrc.ts. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
projenVersion |
java.lang.String |
Version of projen to install. |
publishDryRun |
java.lang.Boolean |
Instead of actually publishing to package managers, just print the publishing command. |
publishTasks |
java.lang.Boolean |
Define publishing tasks that can be executed manually as well as workflows. |
pullRequestTemplate |
java.lang.Boolean |
Include a GitHub pull request template. |
pullRequestTemplateContents |
java.util.List |
The contents of the pull request template. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
releasableCommits |
io.github.cdklabs.projen.ReleasableCommits |
Find commits that should be considered releasable Used to decide if a release is required. |
release |
java.lang.Boolean |
Add release management to this project. |
releaseBranches |
java.util.Map |
Defines additional release branches. |
releaseEveryCommit |
java.lang.Boolean |
Automatically release new versions every commit to one of branches in releaseBranches . |
releaseFailureIssue |
java.lang.Boolean |
Create a github issue on every failed publishing task. |
releaseFailureIssueLabel |
java.lang.String |
The label to apply to issues indicating publish failures. |
releaseSchedule |
java.lang.String |
CRON schedule to trigger new releases. |
releaseTagPrefix |
java.lang.String |
Automatically add the given prefix to release tags. |
releaseToNpm |
java.lang.Boolean |
Automatically release to npm when new versions are introduced. |
releaseTrigger |
io.github.cdklabs.projen.release.ReleaseTrigger |
The release trigger to use. |
releaseWorkflow |
java.lang.Boolean |
DEPRECATED: renamed to release . |
releaseWorkflowName |
java.lang.String |
The name of the default release workflow. |
releaseWorkflowSetupSteps |
java.util.List |
A set of workflow steps to execute in order to setup the workflow container. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
repository |
java.lang.String |
The repository is the location where the actual code for your package lives. |
repositoryDirectory |
java.lang.String |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sampleCode |
java.lang.Boolean |
Generate one-time sample in src/ and test/ if there are no files there. |
scopedPackagesOptions |
java.util.List |
Options for privately hosted scoped packages. |
scripts |
java.util.Map |
npm scripts to include. |
srcdir |
java.lang.String |
Typescript sources directory. |
stability |
java.lang.String |
Package's Stability. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testdir |
java.lang.String |
Jest tests directory. |
tsconfig |
io.github.cdklabs.projen.javascript.TypescriptConfigOptions |
Custom TSConfig. |
tsconfigDev |
io.github.cdklabs.projen.javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). |
tsconfigDevFile |
java.lang.String |
The name of the development tsconfig.json file. |
tsJestOptions |
io.github.cdklabs.projen.typescript.TsJestOptions |
Options for ts-jest. |
typescriptVersion |
java.lang.String |
TypeScript version to use. |
versionrcOptions |
java.util.Map |
Custom configuration used when creating changelog with standard-version package. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
workflowBootstrapSteps |
java.util.List |
Workflow steps to use in order to bootstrap this repo. |
workflowContainerImage |
java.lang.String |
Container image to use for GitHub workflows. |
workflowGitIdentity |
io.github.cdklabs.projen.github.GitIdentity |
The git identity to use in workflows. |
workflowNodeVersion |
java.lang.String |
The node version to use in GitHub workflows. |
workflowPackageCache |
java.lang.Boolean |
Enable Node.js package cache in GitHub workflows. |
workflowRunsOn |
java.util.List |
Github Runner selection labels. |
workflowRunsOnGroup |
io.github.cdklabs.projen.GroupRunnerOptions |
Github Runner Group selection options. |
yarnBerryOptions |
io.github.cdklabs.projen.javascript.YarnBerryOptions |
Options for Yarn Berry. |
name
Required
public java.lang.String getName();
- Type: java.lang.String
- Default: $BASEDIR
allowLibraryDependencies
Optional
public java.lang.Boolean getAllowLibraryDependencies();
- Type: java.lang.Boolean
- Default: true
Allow the project to include peerDependencies
and bundledDependencies
.
This is normally only allowed for libraries. For apps, there's no meaning for specifying these.
appEntrypoint
Optional
public java.lang.String getAppEntrypoint();
- Type: java.lang.String
- Default: "main.ts"
The CDK app's entrypoint (relative to the source directory, which is "src" by default).
artifactsDirectory
Optional
public java.lang.String getArtifactsDirectory();
- Type: java.lang.String
- Default: "dist"
A directory which will contain build artifacts.
authorEmail
Optional
public java.lang.String getAuthorEmail();
- Type: java.lang.String
Author's e-mail.
authorName
Optional
public java.lang.String getAuthorName();
- Type: java.lang.String
Author's name.
authorOrganization
Optional
public java.lang.Boolean getAuthorOrganization();
- Type: java.lang.Boolean
Is the author an organization.
authorUrl
Optional
public java.lang.String getAuthorUrl();
- Type: java.lang.String
Author's URL / Website.
autoApproveOptions
Optional
public AutoApproveOptions getAutoApproveOptions();
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoApproveUpgrades
Optional
public java.lang.Boolean getAutoApproveUpgrades();
- Type: java.lang.Boolean
- Default: true
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued).
Throw if set to true but autoApproveOptions
are not defined.
autoDetectBin
Optional
public java.lang.Boolean getAutoDetectBin();
- Type: java.lang.Boolean
- Default: true
Automatically add all executables under the bin
directory to your package.json
file under the bin
section.
autoMerge
Optional
public java.lang.Boolean getAutoMerge();
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
public AutoMergeOptions getAutoMergeOptions();
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
bin
Optional
public java.util.Map<java.lang.String, java.lang.String> getBin();
- Type: java.util.Map
Binary programs vended with your module.
You can use this option to add/customize how binaries are represented in
your package.json
, but unless autoDetectBin
is false
, every
executable file under bin
will automatically be added to this section.
bugsEmail
Optional
public java.lang.String getBugsEmail();
- Type: java.lang.String
The email address to which issues should be reported.
bugsUrl
Optional
public java.lang.String getBugsUrl();
- Type: java.lang.String
The url to your project's issue tracker.
buildCommand
Optional
public java.lang.String getBuildCommand();
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
buildWorkflow
Optional
public java.lang.Boolean getBuildWorkflow();
- Type: java.lang.Boolean
- Default: true if not a subproject
Define a GitHub workflow for building PRs.
buildWorkflowOptions
Optional
public BuildWorkflowOptions getBuildWorkflowOptions();
- Type: io.github.cdklabs.projen.javascript.BuildWorkflowOptions
Options for PR build workflow.
~~buildWorkflowTriggers
~~Optional
- Deprecated: - Use
buildWorkflowOptions.workflowTriggers
public Triggers getBuildWorkflowTriggers();
- Type: io.github.cdklabs.projen.github.workflows.Triggers
- Default: "{ pullRequest: {}, workflowDispatch: {} }"
Build workflow triggers.
bundledDeps
Optional
public java.util.List<java.lang.String> getBundledDeps();
- Type: java.util.List
List of dependencies to bundle into this module.
These modules will be
added both to the dependencies
section and bundledDependencies
section of
your package.json
.
The recommendation is to only specify the module name here (e.g.
express
). This will behave similar to yarn add
or npm install
in the
sense that it will add the module as a dependency to your package.json
file with the latest version (^
). You can specify semver requirements in
the same syntax passed to npm i
or yarn add
(e.g. express@^2
) and
this will be what you package.json
will eventually include.
bundlerOptions
Optional
public BundlerOptions getBundlerOptions();
- Type: io.github.cdklabs.projen.javascript.BundlerOptions
Options for Bundler
.
~~cdkAssert
~~Optional
- Deprecated: The
public java.lang.Boolean getCdkAssert();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
public java.lang.Boolean getCdkAssertions();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
- Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
public java.util.List<java.lang.String> getCdkDependencies();
- Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
- Deprecated: Not supported in CDK v2.
public java.lang.Boolean getCdkDependenciesAsDeps();
- Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
public java.lang.String getCdkout();
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
- Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
public java.util.List<java.lang.String> getCdkTestDependencies();
- Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
public java.lang.String getCdkVersion();
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
public java.lang.Boolean getCdkVersionPinning();
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
checkLicenses
Optional
public LicenseCheckerOptions getCheckLicenses();
- Type: io.github.cdklabs.projen.javascript.LicenseCheckerOptions
- Default: no license checks are run during the build and all licenses will be accepted
Configure which licenses should be deemed acceptable for use by dependencies.
This setting will cause the build to fail, if any prohibited or not allowed licenses ares encountered.
clobber
Optional
public java.lang.Boolean getClobber();
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
codeArtifactOptions
Optional
public CodeArtifactOptions getCodeArtifactOptions();
- Type: io.github.cdklabs.projen.javascript.CodeArtifactOptions
- Default: undefined
Options for npm packages using AWS CodeArtifact.
This is required if publishing packages to, or installing scoped packages from AWS CodeArtifact
codeCov
Optional
public java.lang.Boolean getCodeCov();
- Type: java.lang.Boolean
- Default: false
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v4 A secret is required for private repos. Configured with @codeCovTokenSecret
.
codeCovTokenSecret
Optional
public java.lang.String getCodeCovTokenSecret();
- Type: java.lang.String
- Default: if this option is not specified, only public repositories are supported
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories.
commitGenerated
Optional
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
constructsVersion
Optional
public java.lang.String getConstructsVersion();
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
public java.util.Map<java.lang.String, java.lang.Object> getContext();
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
copyrightOwner
Optional
public java.lang.String getCopyrightOwner();
- Type: java.lang.String
- Default: defaults to the value of authorName or "" if
authorName
is undefined.
License copyright owner.
copyrightPeriod
Optional
public java.lang.String getCopyrightPeriod();
- Type: java.lang.String
- Default: current year
The copyright years to put in the LICENSE file.
defaultReleaseBranch
Optional
public java.lang.String getDefaultReleaseBranch();
- Type: java.lang.String
- Default: "main"
The name of the main release branch.
dependabot
Optional
public java.lang.Boolean getDependabot();
- Type: java.lang.Boolean
- Default: false
Use dependabot to handle dependency upgrades.
Cannot be used in conjunction with depsUpgrade
.
dependabotOptions
Optional
public DependabotOptions getDependabotOptions();
- Type: io.github.cdklabs.projen.github.DependabotOptions
- Default: default options
Options for dependabot.
deps
Optional
public java.util.List<java.lang.String> getDeps();
- Type: java.util.List
- Default: []
Runtime dependencies of this module.
The recommendation is to only specify the module name here (e.g.
express
). This will behave similar to yarn add
or npm install
in the
sense that it will add the module as a dependency to your package.json
file with the latest version (^
). You can specify semver requirements in
the same syntax passed to npm i
or yarn add
(e.g. express@^2
) and
this will be what you package.json
will eventually include.
depsUpgrade
Optional
public java.lang.Boolean getDepsUpgrade();
- Type: java.lang.Boolean
- Default: true
Use tasks and github workflows to handle dependency upgrades.
Cannot be used in conjunction with dependabot
.
depsUpgradeOptions
Optional
public UpgradeDependenciesOptions getDepsUpgradeOptions();
- Type: io.github.cdklabs.projen.javascript.UpgradeDependenciesOptions
- Default: default options
Options for UpgradeDependencies
.
description
Optional
public java.lang.String getDescription();
- Type: java.lang.String
The description is just a string that helps people understand the purpose of the package.
It can be used when searching for packages in a package manager as well. See https://classic.yarnpkg.com/en/docs/package-json/#toc-description
devContainer
Optional
public java.lang.Boolean getDevContainer();
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
devDeps
Optional
public java.util.List<java.lang.String> getDevDeps();
- Type: java.util.List
- Default: []
Build dependencies for this module.
These dependencies will only be available in your build environment but will not be fetched when this module is consumed.
The recommendation is to only specify the module name here (e.g.
express
). This will behave similar to yarn add
or npm install
in the
sense that it will add the module as a dependency to your package.json
file with the latest version (^
). You can specify semver requirements in
the same syntax passed to npm i
or yarn add
(e.g. express@^2
) and
this will be what you package.json
will eventually include.
disableTsconfig
Optional
public java.lang.Boolean getDisableTsconfig();
- Type: java.lang.Boolean
- Default: false
Do not generate a tsconfig.json
file (used by jsii projects since tsconfig.json is generated by the jsii compiler).
disableTsconfigDev
Optional
public java.lang.Boolean getDisableTsconfigDev();
- Type: java.lang.Boolean
- Default: false
Do not generate a tsconfig.dev.json
file.
docgen
Optional
public java.lang.Boolean getDocgen();
- Type: java.lang.Boolean
- Default: false
Docgen by Typedoc.
docsDirectory
Optional
public java.lang.String getDocsDirectory();
- Type: java.lang.String
- Default: "docs"
Docs directory.
edgeLambdaAutoDiscover
Optional
public java.lang.Boolean getEdgeLambdaAutoDiscover();
- Type: java.lang.Boolean
- Default: true
Automatically adds an cloudfront.experimental.EdgeFunction
for each .edge-lambda.ts
handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover
component to your project.
entrypoint
Optional
public java.lang.String getEntrypoint();
- Type: java.lang.String
- Default: "lib/index.js"
Module entrypoint (main
in package.json
). Set to an empty string to not include main
in your package.json.
entrypointTypes
Optional
public java.lang.String getEntrypointTypes();
- Type: java.lang.String
- Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts)
The .d.ts file that includes the type declarations for this module.
eslint
Optional
public java.lang.Boolean getEslint();
- Type: java.lang.Boolean
- Default: true
Setup eslint.
eslintOptions
Optional
public EslintOptions getEslintOptions();
- Type: io.github.cdklabs.projen.javascript.EslintOptions
- Default: opinionated default options
Eslint options.
experimentalIntegRunner
Optional
public java.lang.Boolean getExperimentalIntegRunner();
- Type: java.lang.Boolean
- Default: false
Enable experimental support for the AWS CDK integ-runner.
featureFlags
Optional
public java.lang.Boolean getFeatureFlags();
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
public java.lang.Boolean getGithub();
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
public GitHubOptions getGithubOptions();
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitignore
Optional
public java.util.List<java.lang.String> getGitignore();
- Type: java.util.List
Additional entries to .gitignore.
gitIgnoreOptions
Optional
public IgnoreFileOptions getGitIgnoreOptions();
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
public GitOptions getGitOptions();
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
public java.lang.Boolean getGitpod();
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
homepage
Optional
public java.lang.String getHomepage();
- Type: java.lang.String
Package's Homepage / Website.
integrationTestAutoDiscover
Optional
public java.lang.Boolean getIntegrationTestAutoDiscover();
- Type: java.lang.Boolean
- Default: true
Automatically discovers and creates integration tests for each .integ.ts
file in under your test directory.
jest
Optional
public java.lang.Boolean getJest();
- Type: java.lang.Boolean
- Default: true
Setup jest unit tests.
jestOptions
Optional
public JestOptions getJestOptions();
- Type: io.github.cdklabs.projen.javascript.JestOptions
- Default: default options
Jest options.
jsiiReleaseVersion
Optional
public java.lang.String getJsiiReleaseVersion();
- Type: java.lang.String
- Default: "latest"
Version requirement of publib
which is used to publish modules to npm.
keywords
Optional
public java.util.List<java.lang.String> getKeywords();
- Type: java.util.List
Keywords to include in package.json
.
lambdaAutoDiscover
Optional
public java.lang.Boolean getLambdaAutoDiscover();
- Type: java.lang.Boolean
- Default: true
Automatically adds an awscdk.LambdaFunction
for each .lambda.ts
handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover
component to your project.
lambdaExtensionAutoDiscover
Optional
public java.lang.Boolean getLambdaExtensionAutoDiscover();
- Type: java.lang.Boolean
- Default: true
Automatically adds an awscdk.LambdaExtension
for each .lambda-extension.ts
entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover
component to your project.
lambdaOptions
Optional
public LambdaFunctionCommonOptions getLambdaOptions();
- Type: io.github.cdklabs.projen.awscdk.LambdaFunctionCommonOptions
- Default: default options
Common options for all AWS Lambda functions.
libdir
Optional
public java.lang.String getLibdir();
- Type: java.lang.String
- Default: "lib"
Typescript artifacts output directory.
license
Optional
public java.lang.String getLicense();
- Type: java.lang.String
- Default: "Apache-2.0"
License's SPDX identifier.
See https://github.com/projen/projen/tree/main/license-text for a list of supported licenses.
Use the licensed
option if you want to no license to be specified.
licensed
Optional
public java.lang.Boolean getLicensed();
- Type: java.lang.Boolean
- Default: true
Indicates if a license should be added.
logging
Optional
public LoggerOptions getLogging();
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
majorVersion
Optional
public java.lang.Number getMajorVersion();
- Type: java.lang.Number
- Default: Major version is not enforced.
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.
maxNodeVersion
Optional
public java.lang.String getMaxNodeVersion();
- Type: java.lang.String
- Default: no max
Minimum node.js version to require via engines
(inclusive).
~~mergify
~~Optional
- Deprecated: use
githubOptions.mergify
instead
public java.lang.Boolean getMergify();
- Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
- Deprecated: use
githubOptions.mergifyOptions
instead
public MergifyOptions getMergifyOptions();
- Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
minMajorVersion
Optional
public java.lang.Number getMinMajorVersion();
- Type: java.lang.Number
- Default: No minimum version is being enforced
Minimal Major version to release.
This can be useful to set to 1, as breaking changes before the 1.x major release are not incrementing the major version number.
Can not be set together with majorVersion
.
minNodeVersion
Optional
public java.lang.String getMinNodeVersion();
- Type: java.lang.String
- Default: no "engines" specified
Minimum Node.js version to require via package.json engines
(inclusive).
~~mutableBuild
~~Optional
- Deprecated: - Use
buildWorkflowOptions.mutableBuild
public java.lang.Boolean getMutableBuild();
- Type: java.lang.Boolean
- Default: true
Automatically update files modified during builds to pull-request branches.
This means that any files synthesized by projen or e.g. test snapshots will always be up-to-date before a PR is merged.
Implies that PR builds do not have anti-tamper checks.
npmAccess
Optional
public NpmAccess getNpmAccess();
- Type: io.github.cdklabs.projen.javascript.NpmAccess
- Default: for scoped packages (e.g.
foo@bar
), the default isNpmAccess.RESTRICTED
, for non-scoped packages, the default isNpmAccess.PUBLIC
.
Access level of the npm package.
npmDistTag
Optional
public java.lang.String getNpmDistTag();
- Type: java.lang.String
- Default: "latest"
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.
~~npmignore
~~Optional
- Deprecated: - use
project.addPackageIgnore
public java.util.List<java.lang.String> getNpmignore();
- Type: java.util.List
Additional entries to .npmignore.
npmignoreEnabled
Optional
public java.lang.Boolean getNpmignoreEnabled();
- Type: java.lang.Boolean
- Default: true
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs.
npmIgnoreOptions
Optional
public IgnoreFileOptions getNpmIgnoreOptions();
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .npmignore file.
npmProvenance
Optional
public java.lang.Boolean getNpmProvenance();
- Type: java.lang.Boolean
- Default: true for public packages, false otherwise
Should provenance statements be generated when the package is published.
A supported package manager is required to publish a package with npm provenance statements and you will need to use a supported CI/CD provider.
Note that the projen Release
and Publisher
components are using publib
to publish packages,
which is using npm internally and supports provenance statements independently of the package manager used.
~~npmRegistry
~~Optional
- Deprecated: use
npmRegistryUrl
instead
public java.lang.String getNpmRegistry();
- Type: java.lang.String
The host name of the npm registry to publish to.
Cannot be set together with npmRegistryUrl
.
npmRegistryUrl
Optional
public java.lang.String getNpmRegistryUrl();
- Type: java.lang.String
- Default: "https://registry.npmjs.org"
The base URL of the npm package registry.
Must be a URL (e.g. start with "https://" or "http://")
npmTokenSecret
Optional
public java.lang.String getNpmTokenSecret();
- Type: java.lang.String
- Default: "NPM_TOKEN"
GitHub secret which contains the NPM token to use when publishing packages.
outdir
Optional
public java.lang.String getOutdir();
- Type: java.lang.String
- Default: "."
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 subprojects.
package
Optional
public java.lang.Boolean getPackage();
- Type: java.lang.Boolean
- Default: true
Defines a package
task that will produce an npm tarball under the artifacts directory (e.g. dist
).
packageManager
Optional
public NodePackageManager getPackageManager();
- Type: io.github.cdklabs.projen.javascript.NodePackageManager
- Default: NodePackageManager.YARN_CLASSIC
The Node Package Manager used to execute scripts.
packageName
Optional
public java.lang.String getPackageName();
- Type: java.lang.String
- Default: defaults to project name
The "name" in package.json.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
peerDependencyOptions
Optional
public PeerDependencyOptions getPeerDependencyOptions();
- Type: io.github.cdklabs.projen.javascript.PeerDependencyOptions
Options for peerDeps
.
peerDeps
Optional
public java.util.List<java.lang.String> getPeerDeps();
- Type: java.util.List
- Default: []
Peer dependencies for this module.
Dependencies listed here are required to
be installed (and satisfied) by the consumer of this library. Using peer
dependencies allows you to ensure that only a single module of a certain
library exists in the node_modules
tree of your consumers.
Note that prior to npm@7, peer dependencies are not automatically installed, which means that adding peer dependencies to a library will be a breaking change for your customers.
Unless peerDependencyOptions.pinnedDevDependency
is disabled (it is
enabled by default), projen will automatically add a dev dependency with a
pinned version for each peer dependency. This will ensure that you build &
test your module against the lowest peer version required.
pnpmVersion
Optional
public java.lang.String getPnpmVersion();
- Type: java.lang.String
- Default: "7"
The version of PNPM to use if using PNPM as a package manager.
postBuildSteps
Optional
public java.util.List<JobStep> getPostBuildSteps();
- Type: java.util.List
- Default: []
Steps to execute after build as part of the release workflow.
prerelease
Optional
public java.lang.String getPrerelease();
- Type: java.lang.String
- Default: normal semantic versions
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre").
prettier
Optional
public java.lang.Boolean getPrettier();
- Type: java.lang.Boolean
- Default: false
Setup prettier.
prettierOptions
Optional
public PrettierOptions getPrettierOptions();
- Type: io.github.cdklabs.projen.javascript.PrettierOptions
- Default: default options
Prettier options.
~~projectType
~~Optional
- Deprecated: no longer supported at the base project level
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
public java.lang.String getProjenCommand();
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
public GithubCredentials getProjenCredentials();
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenDevDependency
Optional
public java.lang.Boolean getProjenDevDependency();
- Type: java.lang.Boolean
- Default: true if not a subproject
Indicates of "projen" should be installed as a devDependency.
projenrcJs
Optional
public java.lang.Boolean getProjenrcJs();
- Type: java.lang.Boolean
- Default: true if projenrcJson is false
Generate (once) .projenrc.js (in JavaScript). Set to false
in order to disable .projenrc.js generation.
projenrcJson
Optional
public java.lang.Boolean getProjenrcJson();
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
public ProjenrcJsonOptions getProjenrcJsonOptions();
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
projenrcJsOptions
Optional
public ProjenrcOptions getProjenrcJsOptions();
- Type: io.github.cdklabs.projen.javascript.ProjenrcOptions
- Default: default options
Options for .projenrc.js.
projenrcTs
Optional
public java.lang.Boolean getProjenrcTs();
- Type: java.lang.Boolean
- Default: false
Use TypeScript for your projenrc file (.projenrc.ts
).
projenrcTsOptions
Optional
public ProjenrcOptions getProjenrcTsOptions();
- Type: io.github.cdklabs.projen.typescript.ProjenrcOptions
Options for .projenrc.ts.
~~projenTokenSecret
~~Optional
- Deprecated: use
projenCredentials
public java.lang.String getProjenTokenSecret();
- Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
projenVersion
Optional
public java.lang.String getProjenVersion();
- Type: java.lang.String
- Default: Defaults to the latest version.
Version of projen to install.
publishDryRun
Optional
public java.lang.Boolean getPublishDryRun();
- Type: java.lang.Boolean
- Default: false
Instead of actually publishing to package managers, just print the publishing command.
publishTasks
Optional
public java.lang.Boolean getPublishTasks();
- Type: java.lang.Boolean
- Default: false
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.
pullRequestTemplate
Optional
public java.lang.Boolean getPullRequestTemplate();
- Type: java.lang.Boolean
- Default: true
Include a GitHub pull request template.
pullRequestTemplateContents
Optional
public java.util.List<java.lang.String> getPullRequestTemplateContents();
- Type: java.util.List
- Default: default content
The contents of the pull request template.
readme
Optional
public SampleReadmeProps getReadme();
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
releasableCommits
Optional
public ReleasableCommits getReleasableCommits();
- Type: io.github.cdklabs.projen.ReleasableCommits
- Default: ReleasableCommits.everyCommit()
Find commits that should be considered releasable Used to decide if a release is required.
release
Optional
public java.lang.Boolean getRelease();
- Type: java.lang.Boolean
- Default: true (false for subprojects)
Add release management to this project.
releaseBranches
Optional
public java.util.Map<java.lang.String, BranchOptions> getReleaseBranches();
- Type: java.util.Map
- Default: no additional branches are used for release. you can use
addBranch()
to add additional branches.
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.
~~releaseEveryCommit
~~Optional
- Deprecated: Use
releaseTrigger: ReleaseTrigger.continuous()
instead
public java.lang.Boolean getReleaseEveryCommit();
- Type: java.lang.Boolean
- Default: true
Automatically release new versions every commit to one of branches in releaseBranches
.
releaseFailureIssue
Optional
public java.lang.Boolean getReleaseFailureIssue();
- Type: java.lang.Boolean
- Default: false
Create a github issue on every failed publishing task.
releaseFailureIssueLabel
Optional
public java.lang.String getReleaseFailureIssueLabel();
- Type: java.lang.String
- Default: "failed-release"
The label to apply to issues indicating publish failures.
Only applies if releaseFailureIssue
is true.
~~releaseSchedule
~~Optional
- Deprecated: Use
releaseTrigger: ReleaseTrigger.scheduled()
instead
public java.lang.String getReleaseSchedule();
- Type: java.lang.String
- Default: no scheduled releases
CRON schedule to trigger new releases.
releaseTagPrefix
Optional
public java.lang.String getReleaseTagPrefix();
- Type: java.lang.String
- Default: "v"
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.
releaseToNpm
Optional
public java.lang.Boolean getReleaseToNpm();
- Type: java.lang.Boolean
- Default: false
Automatically release to npm when new versions are introduced.
releaseTrigger
Optional
public ReleaseTrigger getReleaseTrigger();
- Type: io.github.cdklabs.projen.release.ReleaseTrigger
- Default: Continuous releases (
ReleaseTrigger.continuous()
)
The release trigger to use.
~~releaseWorkflow
~~Optional
- Deprecated: see
release
.
public java.lang.Boolean getReleaseWorkflow();
- Type: java.lang.Boolean
- Default: true if not a subproject
DEPRECATED: renamed to release
.
releaseWorkflowName
Optional
public java.lang.String getReleaseWorkflowName();
- Type: java.lang.String
- Default: "release"
The name of the default release workflow.
releaseWorkflowSetupSteps
Optional
public java.util.List<JobStep> getReleaseWorkflowSetupSteps();
- Type: java.util.List
A set of workflow steps to execute in order to setup the workflow container.
renovatebot
Optional
public java.lang.Boolean getRenovatebot();
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
public RenovatebotOptions getRenovatebotOptions();
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
repository
Optional
public java.lang.String getRepository();
- Type: java.lang.String
The repository is the location where the actual code for your package lives.
See https://classic.yarnpkg.com/en/docs/package-json/#toc-repository
repositoryDirectory
Optional
public java.lang.String getRepositoryDirectory();
- Type: java.lang.String
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives.
requireApproval
Optional
public ApprovalLevel getRequireApproval();
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sampleCode
Optional
public java.lang.Boolean getSampleCode();
- Type: java.lang.Boolean
- Default: true
Generate one-time sample in src/
and test/
if there are no files there.
scopedPackagesOptions
Optional
public java.util.List<ScopedPackagesOptions> getScopedPackagesOptions();
- Type: java.util.List
- Default: fetch all scoped packages from the public npm registry
Options for privately hosted scoped packages.
~~scripts
~~Optional
- Deprecated: use
project.addTask()
orpackage.setScript()
public java.util.Map<java.lang.String, java.lang.String> getScripts();
- Type: java.util.Map
- Default: {}
npm scripts to include.
If a script has the same name as a standard script, the standard script will be overwritten. Also adds the script as a task.
srcdir
Optional
public java.lang.String getSrcdir();
- Type: java.lang.String
- Default: "src"
Typescript sources directory.
stability
Optional
public java.lang.String getStability();
- Type: java.lang.String
Package's Stability.
stale
Optional
public java.lang.Boolean getStale();
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
public StaleOptions getStaleOptions();
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testdir
Optional
public java.lang.String getTestdir();
- Type: java.lang.String
- Default: "test"
Jest tests directory.
Tests files should be named xxx.test.ts
.
If this directory is under srcdir
(e.g. src/test
, src/__tests__
),
then tests are going to be compiled into lib/
and executed as javascript.
If the test directory is outside of src
, then we configure jest to
compile the code in-memory.
tsconfig
Optional
public TypescriptConfigOptions getTsconfig();
- Type: io.github.cdklabs.projen.javascript.TypescriptConfigOptions
- Default: default options
Custom TSConfig.
tsconfigDev
Optional
public TypescriptConfigOptions getTsconfigDev();
- Type: io.github.cdklabs.projen.javascript.TypescriptConfigOptions
- Default: use the production tsconfig options
Custom tsconfig options for the development tsconfig.json file (used for testing).
tsconfigDevFile
Optional
public java.lang.String getTsconfigDevFile();
- Type: java.lang.String
- Default: "tsconfig.dev.json"
The name of the development tsconfig.json file.
tsJestOptions
Optional
public TsJestOptions getTsJestOptions();
- Type: io.github.cdklabs.projen.typescript.TsJestOptions
Options for ts-jest.
typescriptVersion
Optional
public java.lang.String getTypescriptVersion();
- Type: java.lang.String
- Default: "latest"
TypeScript version to use.
NOTE: Typescript is not semantically versioned and should remain on the
same minor, so we recommend using a ~
dependency (e.g. ~1.2.3
).
versionrcOptions
Optional
public java.util.Map<java.lang.String, java.lang.Object> getVersionrcOptions();
- Type: java.util.Map
- Default: standard configuration applicable for GitHub repositories
Custom configuration used when creating changelog with standard-version package.
Given values either append to default configuration or overwrite values in it.
vscode
Optional
public java.lang.Boolean getVscode();
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
public java.util.List<java.lang.String> getWatchExcludes();
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
public java.util.List<java.lang.String> getWatchIncludes();
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
workflowBootstrapSteps
Optional
public java.util.List<JobStep> getWorkflowBootstrapSteps();
- Type: java.util.List
- Default: "yarn install --frozen-lockfile && yarn projen"
Workflow steps to use in order to bootstrap this repo.
workflowContainerImage
Optional
public java.lang.String getWorkflowContainerImage();
- Type: java.lang.String
- Default: default image
Container image to use for GitHub workflows.
workflowGitIdentity
Optional
public GitIdentity getWorkflowGitIdentity();
- Type: io.github.cdklabs.projen.github.GitIdentity
- Default: GitHub Actions
The git identity to use in workflows.
workflowNodeVersion
Optional
public java.lang.String getWorkflowNodeVersion();
- Type: java.lang.String
- Default: same as
minNodeVersion
The node version to use in GitHub workflows.
workflowPackageCache
Optional
public java.lang.Boolean getWorkflowPackageCache();
- Type: java.lang.Boolean
- Default: false
Enable Node.js package cache in GitHub workflows.
workflowRunsOn
Optional
public java.util.List<java.lang.String> getWorkflowRunsOn();
- Type: java.util.List
- Default: ["ubuntu-latest"]
Github Runner selection labels.
workflowRunsOnGroup
Optional
public GroupRunnerOptions getWorkflowRunsOnGroup();
- Type: io.github.cdklabs.projen.GroupRunnerOptions
Github Runner Group selection options.
yarnBerryOptions
Optional
public YarnBerryOptions getYarnBerryOptions();
- Type: io.github.cdklabs.projen.javascript.YarnBerryOptions
- Default: Yarn Berry v4 with all default options
Options for Yarn Berry.
DeploymentStage
Initializer
import software.aws.pdk.infrastructure.DeploymentStage;
DeploymentStage.builder()
.account(java.lang.Number)
.region(java.lang.String)
.stageName(java.lang.String)
.build();
Properties
Name | Type | Description |
---|---|---|
account |
java.lang.Number |
Account to deploy into. |
region |
java.lang.String |
AWS region to deploy into. |
stageName |
java.lang.String |
Stage name. |
account
Required
public java.lang.Number getAccount();
- Type: java.lang.Number
Account to deploy into.
region
Required
public java.lang.String getRegion();
- Type: java.lang.String
AWS region to deploy into.
stageName
Required
public java.lang.String getStageName();
- Type: java.lang.String
Stage name.
InfrastructureJavaProjectOptions
Configuration options for the InfrastructureJavaProject.
Initializer
import software.aws.pdk.infrastructure.InfrastructureJavaProjectOptions;
InfrastructureJavaProjectOptions.builder()
.name(java.lang.String)
// .artifactId(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .buildCommand(java.lang.String)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .clobber(java.lang.Boolean)
// .commitGenerated(java.lang.Boolean)
// .compileOptions(MavenCompileOptions)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .deps(java.util.List<java.lang.String>)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .distdir(java.lang.String)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .groupId(java.lang.String)
// .junit(java.lang.Boolean)
// .junitOptions(JunitOptions)
// .logging(LoggerOptions)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .outdir(java.lang.String)
// .packaging(java.lang.String)
// .packagingOptions(MavenPackagingOptions)
// .parent(Project)
// .parentPom(ParentPom)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenrcJava(java.lang.Boolean)
// .projenrcJavaOptions(ProjenrcOptions)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenTokenSecret(java.lang.String)
// .readme(SampleReadmeProps)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .requireApproval(ApprovalLevel)
// .sample(java.lang.Boolean)
// .sampleJavaPackage(java.lang.String)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testDeps(java.util.List<java.lang.String>)
// .url(java.lang.String)
// .version(java.lang.String)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .allowSignup(java.lang.Boolean)
// .cloudscapeReactTsWebsite(CloudscapeReactTsWebsiteProject)
// .cloudscapeReactTsWebsites(java.util.List<CloudscapeReactTsWebsiteProject>)
// .stackName(java.lang.String)
// .stages(java.util.List<DeploymentStage>)
// .typeSafeApi(TypeSafeApiProject)
// .typeSafeApis(java.util.List<TypeSafeApiProject>)
.build();
Properties
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
artifactId |
java.lang.String |
The artifactId is generally the name that the project is known by. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
compileOptions |
io.github.cdklabs.projen.java.MavenCompileOptions |
Compile options. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
deps |
java.util.List |
List of runtime dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver> . |
description |
java.lang.String |
Description of a project is always good. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
distdir |
java.lang.String |
Final artifact output directory. |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
groupId |
java.lang.String |
This is generally unique amongst an organization or a project. |
junit |
java.lang.Boolean |
Include junit tests. |
junitOptions |
io.github.cdklabs.projen.java.JunitOptions |
junit options. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
packaging |
java.lang.String |
Project packaging format. |
packagingOptions |
io.github.cdklabs.projen.java.MavenPackagingOptions |
Packaging options. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
parentPom |
io.github.cdklabs.projen.java.ParentPom |
A Parent Pom can be used to have a child project inherit properties/plugins/ect in order to reduce duplication and keep standards across a large amount of repos. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenrcJava |
java.lang.Boolean |
Use projenrc in java. |
projenrcJavaOptions |
io.github.cdklabs.projen.java.ProjenrcOptions |
Options related to projenrc in java. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sample |
java.lang.Boolean |
Include sample code and test if the relevant directories don't exist. |
sampleJavaPackage |
java.lang.String |
The java package to use for the code sample. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testDeps |
java.util.List |
List of test dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver> . |
url |
java.lang.String |
The URL, like the name, is not required. |
version |
java.lang.String |
This is the last piece of the naming puzzle. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
allowSignup |
java.lang.Boolean |
Allow self sign up for the UserIdentity construct. |
cloudscapeReactTsWebsite |
software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject |
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code. |
cloudscapeReactTsWebsites |
java.util.List |
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code. |
stackName |
java.lang.String |
Stack name. |
stages |
java.util.List<DeploymentStage> |
List of deployment stages. |
typeSafeApi |
software.aws.pdk.infrastructure.TypeSafeApiProject |
TypeSafeApi instance to use when setting up the initial project sample code. |
typeSafeApis |
java.util.List |
TypeSafeApi instances to use when setting up the initial project sample code. |
name
Required
public java.lang.String getName();
- Type: java.lang.String
- Default: $BASEDIR
artifactId
Optional
public java.lang.String getArtifactId();
- Type: java.lang.String
- Default: "my-app"
The artifactId is generally the name that the project is known by.
Although the groupId is important, people within the group will rarely mention the groupId in discussion (they are often all be the same ID, such as the MojoHaus project groupId: org.codehaus.mojo). It, along with the groupId, creates a key that separates this project from every other project in the world (at least, it should :) ). Along with the groupId, the artifactId fully defines the artifact's living quarters within the repository. In the case of the above project, my-project lives in $M2_REPO/org/codehaus/mojo/my-project.
autoApproveOptions
Optional
public AutoApproveOptions getAutoApproveOptions();
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoMerge
Optional
public java.lang.Boolean getAutoMerge();
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
public AutoMergeOptions getAutoMergeOptions();
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
buildCommand
Optional
public java.lang.String getBuildCommand();
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
~~cdkAssert
~~Optional
- Deprecated: The
public java.lang.Boolean getCdkAssert();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
public java.lang.Boolean getCdkAssertions();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
- Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
public java.util.List<java.lang.String> getCdkDependencies();
- Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
- Deprecated: Not supported in CDK v2.
public java.lang.Boolean getCdkDependenciesAsDeps();
- Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
public java.lang.String getCdkout();
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
- Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
public java.util.List<java.lang.String> getCdkTestDependencies();
- Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
public java.lang.String getCdkVersion();
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
public java.lang.Boolean getCdkVersionPinning();
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
clobber
Optional
public java.lang.Boolean getClobber();
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
commitGenerated
Optional
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
compileOptions
Optional
public MavenCompileOptions getCompileOptions();
- Type: io.github.cdklabs.projen.java.MavenCompileOptions
- Default: defaults
Compile options.
constructsVersion
Optional
public java.lang.String getConstructsVersion();
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
public java.util.Map<java.lang.String, java.lang.Object> getContext();
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
deps
Optional
public java.util.List<java.lang.String> getDeps();
- Type: java.util.List
- Default: []
List of runtime dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver>
.
Additional dependencies can be added via project.addDependency()
.
description
Optional
public java.lang.String getDescription();
- Type: java.lang.String
- Default: undefined
Description of a project is always good.
Although this should not replace formal documentation, a quick comment to any readers of the POM is always helpful.
devContainer
Optional
public java.lang.Boolean getDevContainer();
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
distdir
Optional
public java.lang.String getDistdir();
- Type: java.lang.String
- Default: "dist/java"
Final artifact output directory.
featureFlags
Optional
public java.lang.Boolean getFeatureFlags();
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
public java.lang.Boolean getGithub();
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
public GitHubOptions getGithubOptions();
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitIgnoreOptions
Optional
public IgnoreFileOptions getGitIgnoreOptions();
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
public GitOptions getGitOptions();
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
public java.lang.Boolean getGitpod();
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
groupId
Optional
public java.lang.String getGroupId();
- Type: java.lang.String
- Default: "org.acme"
This is generally unique amongst an organization or a project.
For example, all core Maven artifacts do (well, should) live under the groupId org.apache.maven. Group ID's do not necessarily use the dot notation, for example, the junit project. Note that the dot-notated groupId does not have to correspond to the package structure that the project contains. It is, however, a good practice to follow. When stored within a repository, the group acts much like the Java packaging structure does in an operating system. The dots are replaced by OS specific directory separators (such as '/' in Unix) which becomes a relative directory structure from the base repository. In the example given, the org.codehaus.mojo group lives within the directory $M2_REPO/org/codehaus/mojo.
junit
Optional
public java.lang.Boolean getJunit();
- Type: java.lang.Boolean
- Default: true
Include junit tests.
junitOptions
Optional
public JunitOptions getJunitOptions();
- Type: io.github.cdklabs.projen.java.JunitOptions
- Default: defaults
junit options.
logging
Optional
public LoggerOptions getLogging();
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
~~mergify
~~Optional
- Deprecated: use
githubOptions.mergify
instead
public java.lang.Boolean getMergify();
- Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
- Deprecated: use
githubOptions.mergifyOptions
instead
public MergifyOptions getMergifyOptions();
- Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
outdir
Optional
public java.lang.String getOutdir();
- Type: java.lang.String
- Default: "."
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 subprojects.
packaging
Optional
public java.lang.String getPackaging();
- Type: java.lang.String
- Default: "jar"
Project packaging format.
packagingOptions
Optional
public MavenPackagingOptions getPackagingOptions();
- Type: io.github.cdklabs.projen.java.MavenPackagingOptions
- Default: defaults
Packaging options.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
parentPom
Optional
public ParentPom getParentPom();
- Type: io.github.cdklabs.projen.java.ParentPom
- Default: undefined
A Parent Pom can be used to have a child project inherit properties/plugins/ect in order to reduce duplication and keep standards across a large amount of repos.
~~projectType
~~Optional
- Deprecated: no longer supported at the base project level
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
public java.lang.String getProjenCommand();
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
public GithubCredentials getProjenCredentials();
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenrcJava
Optional
public java.lang.Boolean getProjenrcJava();
- Type: java.lang.Boolean
- Default: true
Use projenrc in java.
This will install projen
as a java dependency and will add a synth
task which
will compile & execute main()
from src/main/java/projenrc.java
.
projenrcJavaOptions
Optional
public ProjenrcOptions getProjenrcJavaOptions();
- Type: io.github.cdklabs.projen.java.ProjenrcOptions
- Default: default options
Options related to projenrc in java.
projenrcJson
Optional
public java.lang.Boolean getProjenrcJson();
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
public ProjenrcJsonOptions getProjenrcJsonOptions();
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
~~projenTokenSecret
~~Optional
- Deprecated: use
projenCredentials
public java.lang.String getProjenTokenSecret();
- Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
readme
Optional
public SampleReadmeProps getReadme();
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
renovatebot
Optional
public java.lang.Boolean getRenovatebot();
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
public RenovatebotOptions getRenovatebotOptions();
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
requireApproval
Optional
public ApprovalLevel getRequireApproval();
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sample
Optional
public java.lang.Boolean getSample();
- Type: java.lang.Boolean
- Default: true
Include sample code and test if the relevant directories don't exist.
sampleJavaPackage
Optional
public java.lang.String getSampleJavaPackage();
- Type: java.lang.String
- Default: "org.acme"
The java package to use for the code sample.
stale
Optional
public java.lang.Boolean getStale();
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
public StaleOptions getStaleOptions();
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testDeps
Optional
public java.util.List<java.lang.String> getTestDeps();
- Type: java.util.List
- Default: []
List of test dependencies for this project. Dependencies use the format: <groupId>/<artifactId>@<semver>
.
Additional dependencies can be added via project.addTestDependency()
.
url
Optional
public java.lang.String getUrl();
- Type: java.lang.String
- Default: undefined
The URL, like the name, is not required.
This is a nice gesture for projects users, however, so that they know where the project lives.
version
Optional
public java.lang.String getVersion();
- Type: java.lang.String
- Default: "0.1.0"
This is the last piece of the naming puzzle.
groupId:artifactId denotes a single project but they cannot delineate which incarnation of that project we are talking about. Do we want the junit:junit of 2018 (version 4.12), or of 2007 (version 3.8.2)? In short: code changes, those changes should be versioned, and this element keeps those versions in line. It is also used within an artifact's repository to separate versions from each other. my-project version 1.0 files live in the directory structure $M2_REPO/org/codehaus/mojo/my-project/1.0.
vscode
Optional
public java.lang.Boolean getVscode();
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
public java.util.List<java.lang.String> getWatchExcludes();
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
public java.util.List<java.lang.String> getWatchIncludes();
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
allowSignup
Optional
public java.lang.Boolean getAllowSignup();
- Type: java.lang.Boolean
- Default: false
Allow self sign up for the UserIdentity construct.
~~cloudscapeReactTsWebsite
~~Optional
- Deprecated: use cloudscapeReactTsWebsites
public CloudscapeReactTsWebsiteProject getCloudscapeReactTsWebsite();
- Type: software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code.
cloudscapeReactTsWebsites
Optional
public java.util.List<CloudscapeReactTsWebsiteProject> getCloudscapeReactTsWebsites();
- Type: java.util.List
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code.
stackName
Optional
public java.lang.String getStackName();
- Type: java.lang.String
- Default: infra-dev
Stack name.
stages
Optional
public java.util.List<DeploymentStage> getStages();
- Type: java.util.List<DeploymentStage>
List of deployment stages.
~~typeSafeApi
~~Optional
- Deprecated: use typeSafeApis
public TypeSafeApiProject getTypeSafeApi();
- Type: software.aws.pdk.infrastructure.TypeSafeApiProject
TypeSafeApi instance to use when setting up the initial project sample code.
typeSafeApis
Optional
public java.util.List<TypeSafeApiProject> getTypeSafeApis();
- Type: java.util.List
TypeSafeApi instances to use when setting up the initial project sample code.
InfrastructurePyProjectOptions
Configuration options for the InfrastructurePyProject.
Initializer
import software.aws.pdk.infrastructure.InfrastructurePyProjectOptions;
InfrastructurePyProjectOptions.builder()
.name(java.lang.String)
// .authorEmail(java.lang.String)
// .authorName(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .buildCommand(java.lang.String)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .classifiers(java.util.List<java.lang.String>)
// .clobber(java.lang.Boolean)
// .commitGenerated(java.lang.Boolean)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .deps(java.util.List<java.lang.String>)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .devDeps(java.util.List<java.lang.String>)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .homepage(java.lang.String)
// .license(java.lang.String)
// .logging(LoggerOptions)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .moduleName(java.lang.String)
// .outdir(java.lang.String)
// .packageName(java.lang.String)
// .parent(Project)
// .poetryOptions(PoetryPyprojectOptionsWithoutDeps)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenrcPythonOptions(ProjenrcOptions)
// .projenTokenSecret(java.lang.String)
// .pytest(java.lang.Boolean)
// .pytestOptions(PytestOptions)
// .pythonExec(java.lang.String)
// .readme(SampleReadmeProps)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .requireApproval(ApprovalLevel)
// .sample(java.lang.Boolean)
// .setupConfig(java.util.Map<java.lang.String, java.lang.Object>)
// .setuptools(java.lang.Boolean)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testdir(java.lang.String)
// .version(java.lang.String)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .allowSignup(java.lang.Boolean)
// .cloudscapeReactTsWebsite(CloudscapeReactTsWebsiteProject)
// .cloudscapeReactTsWebsites(java.util.List<CloudscapeReactTsWebsiteProject>)
// .stackName(java.lang.String)
// .stages(java.util.List<DeploymentStage>)
// .typeSafeApi(TypeSafeApiProject)
// .typeSafeApis(java.util.List<TypeSafeApiProject>)
.build();
Properties
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
authorEmail |
java.lang.String |
Author's e-mail. |
authorName |
java.lang.String |
Author's name. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
classifiers |
java.util.List |
A list of PyPI trove classifiers that describe the project. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
deps |
java.util.List |
List of runtime dependencies for this project. Dependencies use the format: <module>@<semver> . |
description |
java.lang.String |
A short description of the package. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
devDeps |
java.util.List |
List of dev dependencies for this project. Dependencies use the format: <module>@<semver> . |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
homepage |
java.lang.String |
A URL to the website of the project. |
license |
java.lang.String |
License of this package as an SPDX identifier. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
moduleName |
java.lang.String |
Name of the python package as used in imports and filenames. |
outdir |
java.lang.String |
The root directory of the project. Relative to this directory, all files are synthesized. |
packageName |
java.lang.String |
Package name. |
parent |
io.github.cdklabs.projen.Project |
The parent project, if this project is part of a bigger project. |
poetryOptions |
io.github.cdklabs.projen.python.PoetryPyprojectOptionsWithoutDeps |
Additional options to set for poetry if using poetry. |
projectType |
io.github.cdklabs.projen.ProjectType |
Which type of project this is (library/app). |
projenCommand |
java.lang.String |
The shell command to use in order to run the projen CLI. |
projenCredentials |
io.github.cdklabs.projen.github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. |
projenrcJson |
java.lang.Boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation. |
projenrcJsonOptions |
io.github.cdklabs.projen.ProjenrcJsonOptions |
Options for .projenrc.json. |
projenrcPythonOptions |
io.github.cdklabs.projen.python.ProjenrcOptions |
Options related to projenrc in python. |
projenTokenSecret |
java.lang.String |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
pytest |
java.lang.Boolean |
Include pytest tests. |
pytestOptions |
io.github.cdklabs.projen.python.PytestOptions |
pytest options. |
pythonExec |
java.lang.String |
Path to the python executable to use. |
readme |
io.github.cdklabs.projen.SampleReadmeProps |
The README setup. |
renovatebot |
java.lang.Boolean |
Use renovatebot to handle dependency upgrades. |
renovatebotOptions |
io.github.cdklabs.projen.RenovatebotOptions |
Options for renovatebot. |
requireApproval |
io.github.cdklabs.projen.awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. |
sample |
java.lang.Boolean |
Include sample code and test if the relevant directories don't exist. |
setupConfig |
java.util.Map |
Additional fields to pass in the setup() function if using setuptools. |
setuptools |
java.lang.Boolean |
Use setuptools with a setup.py script for packaging and publishing. |
stale |
java.lang.Boolean |
Auto-close of stale issues and pull request. |
staleOptions |
io.github.cdklabs.projen.github.StaleOptions |
Auto-close stale issues and pull requests. |
testdir |
java.lang.String |
Python sources directory. |
version |
java.lang.String |
Version of the package. |
vscode |
java.lang.Boolean |
Enable VSCode integration. |
watchExcludes |
java.util.List |
Glob patterns to exclude from cdk watch . |
watchIncludes |
java.util.List |
Glob patterns to include in cdk watch . |
allowSignup |
java.lang.Boolean |
Allow self sign up for the UserIdentity construct. |
cloudscapeReactTsWebsite |
software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject |
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code. |
cloudscapeReactTsWebsites |
java.util.List |
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code. |
stackName |
java.lang.String |
Stack name. |
stages |
java.util.List<DeploymentStage> |
List of deployment stages. |
typeSafeApi |
software.aws.pdk.infrastructure.TypeSafeApiProject |
TypeSafeApi instance to use when setting up the initial project sample code. |
typeSafeApis |
java.util.List |
TypeSafeApi instances to use when setting up the initial project sample code. |
name
Required
public java.lang.String getName();
- Type: java.lang.String
- Default: $BASEDIR
authorEmail
Optional
public java.lang.String getAuthorEmail();
- Type: java.lang.String
- Default: $GIT_USER_EMAIL
Author's e-mail.
authorName
Optional
public java.lang.String getAuthorName();
- Type: java.lang.String
- Default: $GIT_USER_NAME
Author's name.
autoApproveOptions
Optional
public AutoApproveOptions getAutoApproveOptions();
- Type: io.github.cdklabs.projen.github.AutoApproveOptions
- Default: auto approve is disabled
Enable and configure the 'auto approve' workflow.
autoMerge
Optional
public java.lang.Boolean getAutoMerge();
- Type: java.lang.Boolean
- Default: true
Enable automatic merging on GitHub.
Has no effect if github.mergify
is set to false.
autoMergeOptions
Optional
public AutoMergeOptions getAutoMergeOptions();
- Type: io.github.cdklabs.projen.github.AutoMergeOptions
- Default: see defaults in
AutoMergeOptions
Configure options for automatic merging on GitHub.
Has no effect if
github.mergify
or autoMerge
is set to false.
buildCommand
Optional
public java.lang.String getBuildCommand();
- Type: java.lang.String
- Default: no build command
A command to execute before synthesis.
This command will be called when
running cdk synth
or when cdk watch
identifies a change in your source
code before redeployment.
~~cdkAssert
~~Optional
- Deprecated: The
public java.lang.Boolean getCdkAssert();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0
Warning: NodeJS only.
Install the
cdkAssertions
Optional
public java.lang.Boolean getCdkAssertions();
- Type: java.lang.Boolean
- Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0
Install the assertions library?
Only needed for CDK 1.x. If using CDK 2.x then assertions is already included in 'aws-cdk-lib'
~~cdkDependencies
~~Optional
- Deprecated: For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
public java.util.List<java.lang.String> getCdkDependencies();
- Type: java.util.List
Which AWS CDKv1 modules this project requires.
~~cdkDependenciesAsDeps
~~Optional
- Deprecated: Not supported in CDK v2.
public java.lang.Boolean getCdkDependenciesAsDeps();
- Type: java.lang.Boolean
- Default: true
If this is enabled (default), all modules declared in cdkDependencies
will be also added as normal dependencies
(as well as peerDependencies
).
This is to ensure that downstream consumers actually have your CDK dependencies installed
when using npm < 7 or yarn, where peer dependencies are not automatically installed.
If this is disabled, cdkDependencies
will be added to devDependencies
to ensure
they are present during development.
Note: this setting only applies to construct library projects
cdkout
Optional
public java.lang.String getCdkout();
- Type: java.lang.String
- Default: "cdk.out"
cdk.out directory.
~~cdkTestDependencies
~~Optional
- Deprecated: For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
public java.util.List<java.lang.String> getCdkTestDependencies();
- Type: java.util.List
AWS CDK modules required for testing.
cdkVersion
Optional
public java.lang.String getCdkVersion();
- Type: java.lang.String
- Default: "2.1.0"
Minimum version of the AWS CDK to depend on.
cdkVersionPinning
Optional
public java.lang.Boolean getCdkVersionPinning();
- Type: java.lang.Boolean
Use pinned version instead of caret version for CDK.
You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
classifiers
Optional
public java.util.List<java.lang.String> getClassifiers();
- Type: java.util.List
A list of PyPI trove classifiers that describe the project.
clobber
Optional
public java.lang.Boolean getClobber();
- Type: java.lang.Boolean
- Default: true, but false for subprojects
Add a clobber
task which resets the repo to origin.
commitGenerated
Optional
public java.lang.Boolean getCommitGenerated();
- Type: java.lang.Boolean
- Default: true
Whether to commit the managed files by default.
constructsVersion
Optional
public java.lang.String getConstructsVersion();
- Type: java.lang.String
- Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5".
Minimum version of the constructs
library to depend on.
context
Optional
public java.util.Map<java.lang.String, java.lang.Object> getContext();
- Type: java.util.Map
- Default: no additional context
Additional context to include in cdk.json
.
deps
Optional
public java.util.List<java.lang.String> getDeps();
- Type: java.util.List
- Default: []
List of runtime dependencies for this project. Dependencies use the format: <module>@<semver>
.
Additional dependencies can be added via project.addDependency()
.
description
Optional
public java.lang.String getDescription();
- Type: java.lang.String
A short description of the package.
devContainer
Optional
public java.lang.Boolean getDevContainer();
- Type: java.lang.Boolean
- Default: false
Add a VSCode development environment (used for GitHub Codespaces).
devDeps
Optional
public java.util.List<java.lang.String> getDevDeps();
- Type: java.util.List
- Default: []
List of dev dependencies for this project. Dependencies use the format: <module>@<semver>
.
Additional dependencies can be added via project.addDevDependency()
.
featureFlags
Optional
public java.lang.Boolean getFeatureFlags();
- Type: java.lang.Boolean
- Default: true
Include all feature flags in cdk.json.
github
Optional
public java.lang.Boolean getGithub();
- Type: java.lang.Boolean
- Default: true
Enable GitHub integration.
Enabled by default for root projects. Disabled for non-root projects.
githubOptions
Optional
public GitHubOptions getGithubOptions();
- Type: io.github.cdklabs.projen.github.GitHubOptions
- Default: see GitHubOptions
Options for GitHub integration.
gitIgnoreOptions
Optional
public IgnoreFileOptions getGitIgnoreOptions();
- Type: io.github.cdklabs.projen.IgnoreFileOptions
Configuration options for .gitignore file.
gitOptions
Optional
public GitOptions getGitOptions();
- Type: io.github.cdklabs.projen.GitOptions
Configuration options for git.
gitpod
Optional
public java.lang.Boolean getGitpod();
- Type: java.lang.Boolean
- Default: false
Add a Gitpod development environment.
homepage
Optional
public java.lang.String getHomepage();
- Type: java.lang.String
A URL to the website of the project.
license
Optional
public java.lang.String getLicense();
- Type: java.lang.String
License of this package as an SPDX identifier.
logging
Optional
public LoggerOptions getLogging();
- Type: io.github.cdklabs.projen.LoggerOptions
- Default: {}
Configure logging options such as verbosity.
~~mergify
~~Optional
- Deprecated: use
githubOptions.mergify
instead
public java.lang.Boolean getMergify();
- Type: java.lang.Boolean
- Default: true
Whether mergify should be enabled on this repository or not.
~~mergifyOptions
~~Optional
- Deprecated: use
githubOptions.mergifyOptions
instead
public MergifyOptions getMergifyOptions();
- Type: io.github.cdklabs.projen.github.MergifyOptions
- Default: default options
Options for mergify.
moduleName
Optional
public java.lang.String getModuleName();
- Type: java.lang.String
- Default: $PYTHON_MODULE_NAME
Name of the python package as used in imports and filenames.
Must only consist of alphanumeric characters and underscores.
outdir
Optional
public java.lang.String getOutdir();
- Type: java.lang.String
- Default: "."
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 subprojects.
packageName
Optional
public java.lang.String getPackageName();
- Type: java.lang.String
Package name.
parent
Optional
public Project getParent();
- Type: io.github.cdklabs.projen.Project
The parent project, if this project is part of a bigger project.
poetryOptions
Optional
public PoetryPyprojectOptionsWithoutDeps getPoetryOptions();
- Type: io.github.cdklabs.projen.python.PoetryPyprojectOptionsWithoutDeps
Additional options to set for poetry if using poetry.
~~projectType
~~Optional
- Deprecated: no longer supported at the base project level
public ProjectType getProjectType();
- Type: io.github.cdklabs.projen.ProjectType
- Default: ProjectType.UNKNOWN
Which type of project this is (library/app).
projenCommand
Optional
public java.lang.String getProjenCommand();
- Type: java.lang.String
- Default: "npx projen"
The shell command to use in order to run the projen CLI.
Can be used to customize in special environments.
projenCredentials
Optional
public GithubCredentials getProjenCredentials();
- Type: io.github.cdklabs.projen.github.GithubCredentials
- Default: use a personal access token named PROJEN_GITHUB_TOKEN
Choose a method of providing GitHub API access for projen workflows.
projenrcJson
Optional
public java.lang.Boolean getProjenrcJson();
- Type: java.lang.Boolean
- Default: false
Generate (once) .projenrc.json (in JSON). Set to false
in order to disable .projenrc.json generation.
projenrcJsonOptions
Optional
public ProjenrcJsonOptions getProjenrcJsonOptions();
- Type: io.github.cdklabs.projen.ProjenrcJsonOptions
- Default: default options
Options for .projenrc.json.
projenrcPythonOptions
Optional
public ProjenrcOptions getProjenrcPythonOptions();
- Type: io.github.cdklabs.projen.python.ProjenrcOptions
- Default: default options
Options related to projenrc in python.
~~projenTokenSecret
~~Optional
- Deprecated: use
projenCredentials
public java.lang.String getProjenTokenSecret();
- Type: java.lang.String
- Default: "PROJEN_GITHUB_TOKEN"
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
This token needs to have the repo
, workflows
and packages
scope.
pytest
Optional
public java.lang.Boolean getPytest();
- Type: java.lang.Boolean
- Default: true
Include pytest tests.
pytestOptions
Optional
public PytestOptions getPytestOptions();
- Type: io.github.cdklabs.projen.python.PytestOptions
- Default: defaults
pytest options.
pythonExec
Optional
public java.lang.String getPythonExec();
- Type: java.lang.String
- Default: "python"
Path to the python executable to use.
readme
Optional
public SampleReadmeProps getReadme();
- Type: io.github.cdklabs.projen.SampleReadmeProps
- Default: { filename: 'README.md', contents: '# replace this' }
The README setup.
renovatebot
Optional
public java.lang.Boolean getRenovatebot();
- Type: java.lang.Boolean
- Default: false
Use renovatebot to handle dependency upgrades.
renovatebotOptions
Optional
public RenovatebotOptions getRenovatebotOptions();
- Type: io.github.cdklabs.projen.RenovatebotOptions
- Default: default options
Options for renovatebot.
requireApproval
Optional
public ApprovalLevel getRequireApproval();
- Type: io.github.cdklabs.projen.awscdk.ApprovalLevel
- Default: ApprovalLevel.BROADENING
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
sample
Optional
public java.lang.Boolean getSample();
- Type: java.lang.Boolean
- Default: true
Include sample code and test if the relevant directories don't exist.
setupConfig
Optional
public java.util.Map<java.lang.String, java.lang.Object> getSetupConfig();
- Type: java.util.Map
Additional fields to pass in the setup() function if using setuptools.
setuptools
Optional
public java.lang.Boolean getSetuptools();
- Type: java.lang.Boolean
- Default: true, unless poetry is true, then false
Use setuptools with a setup.py script for packaging and publishing.
stale
Optional
public java.lang.Boolean getStale();
- Type: java.lang.Boolean
- Default: false
Auto-close of stale issues and pull request.
See staleOptions
for options.
staleOptions
Optional
public StaleOptions getStaleOptions();
- Type: io.github.cdklabs.projen.github.StaleOptions
- Default: see defaults in
StaleOptions
Auto-close stale issues and pull requests.
To disable set stale
to false
.
testdir
Optional
public java.lang.String getTestdir();
- Type: java.lang.String
- Default: "tests"
Python sources directory.
version
Optional
public java.lang.String getVersion();
- Type: java.lang.String
- Default: "0.1.0"
Version of the package.
vscode
Optional
public java.lang.Boolean getVscode();
- Type: java.lang.Boolean
- Default: true
Enable VSCode integration.
Enabled by default for root projects. Disabled for non-root projects.
watchExcludes
Optional
public java.util.List<java.lang.String> getWatchExcludes();
- Type: java.util.List
- Default: []
Glob patterns to exclude from cdk watch
.
watchIncludes
Optional
public java.util.List<java.lang.String> getWatchIncludes();
- Type: java.util.List
- Default: []
Glob patterns to include in cdk watch
.
allowSignup
Optional
public java.lang.Boolean getAllowSignup();
- Type: java.lang.Boolean
- Default: false
Allow self sign up for the UserIdentity construct.
~~cloudscapeReactTsWebsite
~~Optional
- Deprecated: use cloudscapeReactTsWebsites
public CloudscapeReactTsWebsiteProject getCloudscapeReactTsWebsite();
- Type: software.aws.pdk.infrastructure.CloudscapeReactTsWebsiteProject
CloudscapeReactTsWebsiteProject instance to use when setting up the initial project sample code.
cloudscapeReactTsWebsites
Optional
public java.util.List<CloudscapeReactTsWebsiteProject> getCloudscapeReactTsWebsites();
- Type: java.util.List
CloudscapeReactTsWebsiteProject instances to use when setting up the initial project sample code.
stackName
Optional
public java.lang.String getStackName();
- Type: java.lang.String
- Default: infra-dev
Stack name.
stages
Optional
public java.util.List<DeploymentStage> getStages();
- Type: java.util.List<DeploymentStage>
List of deployment stages.
~~typeSafeApi
~~Optional
- Deprecated: use typeSafeApis
public TypeSafeApiProject getTypeSafeApi();
- Type: software.aws.pdk.infrastructure.TypeSafeApiProject
TypeSafeApi instance to use when setting up the initial project sample code.
typeSafeApis
Optional
public java.util.List<TypeSafeApiProject> getTypeSafeApis();
- Type: java.util.List
TypeSafeApi instances to use when setting up the initial project sample code.
InfrastructureTsProjectOptions
Configuration options for the InfrastructureTsProject.
Initializer
import software.aws.pdk.infrastructure.InfrastructureTsProjectOptions;
InfrastructureTsProjectOptions.builder()
.name(java.lang.String)
// .allowLibraryDependencies(java.lang.Boolean)
// .appEntrypoint(java.lang.String)
// .artifactsDirectory(java.lang.String)
// .authorEmail(java.lang.String)
// .authorName(java.lang.String)
// .authorOrganization(java.lang.Boolean)
// .authorUrl(java.lang.String)
// .autoApproveOptions(AutoApproveOptions)
// .autoApproveUpgrades(java.lang.Boolean)
// .autoDetectBin(java.lang.Boolean)
// .autoMerge(java.lang.Boolean)
// .autoMergeOptions(AutoMergeOptions)
// .bin(java.util.Map<java.lang.String, java.lang.String>)
// .bugsEmail(java.lang.String)
// .bugsUrl(java.lang.String)
// .buildCommand(java.lang.String)
// .buildWorkflow(java.lang.Boolean)
// .buildWorkflowOptions(BuildWorkflowOptions)
// .buildWorkflowTriggers(Triggers)
// .bundledDeps(java.util.List<java.lang.String>)
// .bundlerOptions(BundlerOptions)
// .cdkAssert(java.lang.Boolean)
// .cdkAssertions(java.lang.Boolean)
// .cdkDependencies(java.util.List<java.lang.String>)
// .cdkDependenciesAsDeps(java.lang.Boolean)
// .cdkout(java.lang.String)
// .cdkTestDependencies(java.util.List<java.lang.String>)
// .cdkVersion(java.lang.String)
// .cdkVersionPinning(java.lang.Boolean)
// .checkLicenses(LicenseCheckerOptions)
// .clobber(java.lang.Boolean)
// .codeArtifactOptions(CodeArtifactOptions)
// .codeCov(java.lang.Boolean)
// .codeCovTokenSecret(java.lang.String)
// .commitGenerated(java.lang.Boolean)
// .constructsVersion(java.lang.String)
// .context(java.util.Map<java.lang.String, java.lang.Object>)
// .copyrightOwner(java.lang.String)
// .copyrightPeriod(java.lang.String)
// .defaultReleaseBranch(java.lang.String)
// .dependabot(java.lang.Boolean)
// .dependabotOptions(DependabotOptions)
// .deps(java.util.List<java.lang.String>)
// .depsUpgrade(java.lang.Boolean)
// .depsUpgradeOptions(UpgradeDependenciesOptions)
// .description(java.lang.String)
// .devContainer(java.lang.Boolean)
// .devDeps(java.util.List<java.lang.String>)
// .disableTsconfig(java.lang.Boolean)
// .disableTsconfigDev(java.lang.Boolean)
// .docgen(java.lang.Boolean)
// .docsDirectory(java.lang.String)
// .edgeLambdaAutoDiscover(java.lang.Boolean)
// .entrypoint(java.lang.String)
// .entrypointTypes(java.lang.String)
// .eslint(java.lang.Boolean)
// .eslintOptions(EslintOptions)
// .experimentalIntegRunner(java.lang.Boolean)
// .featureFlags(java.lang.Boolean)
// .github(java.lang.Boolean)
// .githubOptions(GitHubOptions)
// .gitignore(java.util.List<java.lang.String>)
// .gitIgnoreOptions(IgnoreFileOptions)
// .gitOptions(GitOptions)
// .gitpod(java.lang.Boolean)
// .homepage(java.lang.String)
// .integrationTestAutoDiscover(java.lang.Boolean)
// .jest(java.lang.Boolean)
// .jestOptions(JestOptions)
// .jsiiReleaseVersion(java.lang.String)
// .keywords(java.util.List<java.lang.String>)
// .lambdaAutoDiscover(java.lang.Boolean)
// .lambdaExtensionAutoDiscover(java.lang.Boolean)
// .lambdaOptions(LambdaFunctionCommonOptions)
// .libdir(java.lang.String)
// .license(java.lang.String)
// .licensed(java.lang.Boolean)
// .logging(LoggerOptions)
// .majorVersion(java.lang.Number)
// .maxNodeVersion(java.lang.String)
// .mergify(java.lang.Boolean)
// .mergifyOptions(MergifyOptions)
// .minMajorVersion(java.lang.Number)
// .minNodeVersion(java.lang.String)
// .mutableBuild(java.lang.Boolean)
// .npmAccess(NpmAccess)
// .npmDistTag(java.lang.String)
// .npmignore(java.util.List<java.lang.String>)
// .npmignoreEnabled(java.lang.Boolean)
// .npmIgnoreOptions(IgnoreFileOptions)
// .npmProvenance(java.lang.Boolean)
// .npmRegistry(java.lang.String)
// .npmRegistryUrl(java.lang.String)
// .npmTokenSecret(java.lang.String)
// .outdir(java.lang.String)
// .package(java.lang.Boolean)
// .packageManager(NodePackageManager)
// .packageName(java.lang.String)
// .parent(Project)
// .peerDependencyOptions(PeerDependencyOptions)
// .peerDeps(java.util.List<java.lang.String>)
// .pnpmVersion(java.lang.String)
// .postBuildSteps(java.util.List<JobStep>)
// .prerelease(java.lang.String)
// .prettier(java.lang.Boolean)
// .prettierOptions(PrettierOptions)
// .projectType(ProjectType)
// .projenCommand(java.lang.String)
// .projenCredentials(GithubCredentials)
// .projenDevDependency(java.lang.Boolean)
// .projenrcJs(java.lang.Boolean)
// .projenrcJson(java.lang.Boolean)
// .projenrcJsonOptions(ProjenrcJsonOptions)
// .projenrcJsOptions(ProjenrcOptions)
// .projenrcTs(java.lang.Boolean)
// .projenrcTsOptions(ProjenrcOptions)
// .projenTokenSecret(java.lang.String)
// .projenVersion(java.lang.String)
// .publishDryRun(java.lang.Boolean)
// .publishTasks(java.lang.Boolean)
// .pullRequestTemplate(java.lang.Boolean)
// .pullRequestTemplateContents(java.util.List<java.lang.String>)
// .readme(SampleReadmeProps)
// .releasableCommits(ReleasableCommits)
// .release(java.lang.Boolean)
// .releaseBranches(java.util.Map<java.lang.String, BranchOptions>)
// .releaseEveryCommit(java.lang.Boolean)
// .releaseFailureIssue(java.lang.Boolean)
// .releaseFailureIssueLabel(java.lang.String)
// .releaseSchedule(java.lang.String)
// .releaseTagPrefix(java.lang.String)
// .releaseToNpm(java.lang.Boolean)
// .releaseTrigger(ReleaseTrigger)
// .releaseWorkflow(java.lang.Boolean)
// .releaseWorkflowName(java.lang.String)
// .releaseWorkflowSetupSteps(java.util.List<JobStep>)
// .renovatebot(java.lang.Boolean)
// .renovatebotOptions(RenovatebotOptions)
// .repository(java.lang.String)
// .repositoryDirectory(java.lang.String)
// .requireApproval(ApprovalLevel)
// .sampleCode(java.lang.Boolean)
// .scopedPackagesOptions(java.util.List<ScopedPackagesOptions>)
// .scripts(java.util.Map<java.lang.String, java.lang.String>)
// .srcdir(java.lang.String)
// .stability(java.lang.String)
// .stale(java.lang.Boolean)
// .staleOptions(StaleOptions)
// .testdir(java.lang.String)
// .tsconfig(TypescriptConfigOptions)
// .tsconfigDev(TypescriptConfigOptions)
// .tsconfigDevFile(java.lang.String)
// .tsJestOptions(TsJestOptions)
// .typescriptVersion(java.lang.String)
// .versionrcOptions(java.util.Map<java.lang.String, java.lang.Object>)
// .vscode(java.lang.Boolean)
// .watchExcludes(java.util.List<java.lang.String>)
// .watchIncludes(java.util.List<java.lang.String>)
// .workflowBootstrapSteps(java.util.List<JobStep>)
// .workflowContainerImage(java.lang.String)
// .workflowGitIdentity(GitIdentity)
// .workflowNodeVersion(java.lang.String)
// .workflowPackageCache(java.lang.Boolean)
// .workflowRunsOn(java.util.List<java.lang.String>)
// .workflowRunsOnGroup(GroupRunnerOptions)
// .yarnBerryOptions(YarnBerryOptions)
// .allowSignup(java.lang.Boolean)
// .cloudscapeReactTsWebsite(CloudscapeReactTsWebsiteProject)
// .cloudscapeReactTsWebsites(java.util.List<CloudscapeReactTsWebsiteProject>)
// .stackName(java.lang.String)
// .stages(java.util.List<DeploymentStage>)
// .typeSafeApi(TypeSafeApiProject)
// .typeSafeApis(java.util.List<TypeSafeApiProject>)
// .typeSafeWebSocketApis(java.util.List<TypeSafeWebSocketApiProject>)
.build();
Properties
Name | Type | Description |
---|---|---|
name |
java.lang.String |
No description. |
allowLibraryDependencies |
java.lang.Boolean |
Allow the project to include peerDependencies and bundledDependencies . |
appEntrypoint |
java.lang.String |
The CDK app's entrypoint (relative to the source directory, which is "src" by default). |
artifactsDirectory |
java.lang.String |
A directory which will contain build artifacts. |
authorEmail |
java.lang.String |
Author's e-mail. |
authorName |
java.lang.String |
Author's name. |
authorOrganization |
java.lang.Boolean |
Is the author an organization. |
authorUrl |
java.lang.String |
Author's URL / Website. |
autoApproveOptions |
io.github.cdklabs.projen.github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. |
autoApproveUpgrades |
java.lang.Boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). |
autoDetectBin |
java.lang.Boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section. |
autoMerge |
java.lang.Boolean |
Enable automatic merging on GitHub. |
autoMergeOptions |
io.github.cdklabs.projen.github.AutoMergeOptions |
Configure options for automatic merging on GitHub. |
bin |
java.util.Map |
Binary programs vended with your module. |
bugsEmail |
java.lang.String |
The email address to which issues should be reported. |
bugsUrl |
java.lang.String |
The url to your project's issue tracker. |
buildCommand |
java.lang.String |
A command to execute before synthesis. |
buildWorkflow |
java.lang.Boolean |
Define a GitHub workflow for building PRs. |
buildWorkflowOptions |
io.github.cdklabs.projen.javascript.BuildWorkflowOptions |
Options for PR build workflow. |
buildWorkflowTriggers |
io.github.cdklabs.projen.github.workflows.Triggers |
Build workflow triggers. |
bundledDeps |
java.util.List |
List of dependencies to bundle into this module. |
bundlerOptions |
io.github.cdklabs.projen.javascript.BundlerOptions |
Options for Bundler . |
cdkAssert |
java.lang.Boolean |
Warning: NodeJS only. |
cdkAssertions |
java.lang.Boolean |
Install the assertions library? |
cdkDependencies |
java.util.List |
Which AWS CDKv1 modules this project requires. |
cdkDependenciesAsDeps |
java.lang.Boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies ). |
cdkout |
java.lang.String |
cdk.out directory. |
cdkTestDependencies |
java.util.List |
AWS CDK modules required for testing. |
cdkVersion |
java.lang.String |
Minimum version of the AWS CDK to depend on. |
cdkVersionPinning |
java.lang.Boolean |
Use pinned version instead of caret version for CDK. |
checkLicenses |
io.github.cdklabs.projen.javascript.LicenseCheckerOptions |
Configure which licenses should be deemed acceptable for use by dependencies. |
clobber |
java.lang.Boolean |
Add a clobber task which resets the repo to origin. |
codeArtifactOptions |
io.github.cdklabs.projen.javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. |
codeCov |
java.lang.Boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v4 A secret is required for private repos. Configured with @codeCovTokenSecret . |
codeCovTokenSecret |
java.lang.String |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. |
commitGenerated |
java.lang.Boolean |
Whether to commit the managed files by default. |
constructsVersion |
java.lang.String |
Minimum version of the constructs library to depend on. |
context |
java.util.Map |
Additional context to include in cdk.json . |
copyrightOwner |
java.lang.String |
License copyright owner. |
copyrightPeriod |
java.lang.String |
The copyright years to put in the LICENSE file. |
defaultReleaseBranch |
java.lang.String |
The name of the main release branch. |
dependabot |
java.lang.Boolean |
Use dependabot to handle dependency upgrades. |
dependabotOptions |
io.github.cdklabs.projen.github.DependabotOptions |
Options for dependabot. |
deps |
java.util.List |
Runtime dependencies of this module. |
depsUpgrade |
java.lang.Boolean |
Use tasks and github workflows to handle dependency upgrades. |
depsUpgradeOptions |
io.github.cdklabs.projen.javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies . |
description |
java.lang.String |
The description is just a string that helps people understand the purpose of the package. |
devContainer |
java.lang.Boolean |
Add a VSCode development environment (used for GitHub Codespaces). |
devDeps |
java.util.List |
Build dependencies for this module. |
disableTsconfig |
java.lang.Boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler). |
disableTsconfigDev |
java.lang.Boolean |
Do not generate a tsconfig.dev.json file. |
docgen |
java.lang.Boolean |
Docgen by Typedoc. |
docsDirectory |
java.lang.String |
Docs directory. |
edgeLambdaAutoDiscover |
java.lang.Boolean |
Automatically adds an cloudfront.experimental.EdgeFunction for each .edge-lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
entrypoint |
java.lang.String |
Module entrypoint (main in package.json ). Set to an empty string to not include main in your package.json. |
entrypointTypes |
java.lang.String |
The .d.ts file that includes the type declarations for this module. |
eslint |
java.lang.Boolean |
Setup eslint. |
eslintOptions |
io.github.cdklabs.projen.javascript.EslintOptions |
Eslint options. |
experimentalIntegRunner |
java.lang.Boolean |
Enable experimental support for the AWS CDK integ-runner. |
featureFlags |
java.lang.Boolean |
Include all feature flags in cdk.json. |
github |
java.lang.Boolean |
Enable GitHub integration. |
githubOptions |
io.github.cdklabs.projen.github.GitHubOptions |
Options for GitHub integration. |
gitignore |
java.util.List |
Additional entries to .gitignore. |
gitIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .gitignore file. |
gitOptions |
io.github.cdklabs.projen.GitOptions |
Configuration options for git. |
gitpod |
java.lang.Boolean |
Add a Gitpod development environment. |
homepage |
java.lang.String |
Package's Homepage / Website. |
integrationTestAutoDiscover |
java.lang.Boolean |
Automatically discovers and creates integration tests for each .integ.ts file in under your test directory. |
jest |
java.lang.Boolean |
Setup jest unit tests. |
jestOptions |
io.github.cdklabs.projen.javascript.JestOptions |
Jest options. |
jsiiReleaseVersion |
java.lang.String |
Version requirement of publib which is used to publish modules to npm. |
keywords |
java.util.List |
Keywords to include in package.json . |
lambdaAutoDiscover |
java.lang.Boolean |
Automatically adds an awscdk.LambdaFunction for each .lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
lambdaExtensionAutoDiscover |
java.lang.Boolean |
Automatically adds an awscdk.LambdaExtension for each .lambda-extension.ts entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project. |
lambdaOptions |
io.github.cdklabs.projen.awscdk.LambdaFunctionCommonOptions |
Common options for all AWS Lambda functions. |
libdir |
java.lang.String |
Typescript artifacts output directory. |
license |
java.lang.String |
License's SPDX identifier. |
licensed |
java.lang.Boolean |
Indicates if a license should be added. |
logging |
io.github.cdklabs.projen.LoggerOptions |
Configure logging options such as verbosity. |
majorVersion |
java.lang.Number |
Major version to release from the default branch. |
maxNodeVersion |
java.lang.String |
Minimum node.js version to require via engines (inclusive). |
mergify |
java.lang.Boolean |
Whether mergify should be enabled on this repository or not. |
mergifyOptions |
io.github.cdklabs.projen.github.MergifyOptions |
Options for mergify. |
minMajorVersion |
java.lang.Number |
Minimal Major version to release. |
minNodeVersion |
java.lang.String |
Minimum Node.js version to require via package.json engines (inclusive). |
mutableBuild |
java.lang.Boolean |
Automatically update files modified during builds to pull-request branches. |
npmAccess |
io.github.cdklabs.projen.javascript.NpmAccess |
Access level of the npm package. |
npmDistTag |
java.lang.String |
The npmDistTag to use when publishing from the default branch. |
npmignore |
java.util.List |
Additional entries to .npmignore. |
npmignoreEnabled |
java.lang.Boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. |
npmIgnoreOptions |
io.github.cdklabs.projen.IgnoreFileOptions |
Configuration options for .npmignore file. |
npmProvenance |
java.lang.Boolean |
Should provenance statements be generated when the package is published. |
npmRegistry |
java.lang.String |
The host name of the npm registry to publish to. |
npmRegistryUrl |
java.lang.String |
The base URL of the npm package registry. |
npmTokenSecret |
java.lang.String |
GitHub secret which contains the NPM token to use when publishing packages. |