@cdktn/provider-project 0.7.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.jsii +419 -0
- package/API.md +4154 -0
- package/CLAUDE.md +172 -0
- package/LICENSE +355 -0
- package/README.md +82 -0
- package/lib/alert-open-prs.d.ts +14 -0
- package/lib/alert-open-prs.js +67 -0
- package/lib/auto-approve.d.ts +11 -0
- package/lib/auto-approve.js +70 -0
- package/lib/auto-close-community-issues.d.ts +15 -0
- package/lib/auto-close-community-issues.js +104 -0
- package/lib/automerge.d.ts +11 -0
- package/lib/automerge.js +67 -0
- package/lib/cdktf-config.d.ts +33 -0
- package/lib/cdktf-config.js +134 -0
- package/lib/copyright-headers.d.ts +4 -0
- package/lib/copyright-headers.js +44 -0
- package/lib/customized-license.d.ts +8 -0
- package/lib/customized-license.js +19 -0
- package/lib/dependabot.d.ts +8 -0
- package/lib/dependabot.js +40 -0
- package/lib/deprecate-packages.d.ts +14 -0
- package/lib/deprecate-packages.js +91 -0
- package/lib/force-release.d.ts +12 -0
- package/lib/force-release.js +112 -0
- package/lib/github-issues.d.ts +15 -0
- package/lib/github-issues.js +33 -0
- package/lib/index.d.ts +53 -0
- package/lib/index.js +447 -0
- package/lib/lock-issues.d.ts +13 -0
- package/lib/lock-issues.js +54 -0
- package/lib/package-info.d.ts +14 -0
- package/lib/package-info.js +7 -0
- package/lib/provider-upgrade.d.ts +17 -0
- package/lib/provider-upgrade.js +145 -0
- package/lib/readme.d.ts +21 -0
- package/lib/readme.js +147 -0
- package/lib/scripts/check-for-upgrades.d.ts +15 -0
- package/lib/scripts/check-for-upgrades.js +186 -0
- package/lib/scripts/should-release.d.ts +13 -0
- package/lib/scripts/should-release.js +96 -0
- package/lib/util/random-cron.d.ts +18 -0
- package/lib/util/random-cron.js +33 -0
- package/mise.toml +2 -0
- package/node_modules/camel-case/LICENSE +21 -0
- package/node_modules/camel-case/README.md +47 -0
- package/node_modules/camel-case/dist/index.d.ts +5 -0
- package/node_modules/camel-case/dist/index.js +23 -0
- package/node_modules/camel-case/dist/index.js.map +1 -0
- package/node_modules/camel-case/dist/index.spec.d.ts +1 -0
- package/node_modules/camel-case/dist/index.spec.js +26 -0
- package/node_modules/camel-case/dist/index.spec.js.map +1 -0
- package/node_modules/camel-case/dist.es2015/index.d.ts +5 -0
- package/node_modules/camel-case/dist.es2015/index.js +17 -0
- package/node_modules/camel-case/dist.es2015/index.js.map +1 -0
- package/node_modules/camel-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/camel-case/dist.es2015/index.spec.js +24 -0
- package/node_modules/camel-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/camel-case/package.json +89 -0
- package/node_modules/capital-case/LICENSE +21 -0
- package/node_modules/capital-case/README.md +37 -0
- package/node_modules/capital-case/dist/index.d.ts +4 -0
- package/node_modules/capital-case/dist/index.js +16 -0
- package/node_modules/capital-case/dist/index.js.map +1 -0
- package/node_modules/capital-case/dist/index.spec.d.ts +1 -0
- package/node_modules/capital-case/dist/index.spec.js +24 -0
- package/node_modules/capital-case/dist/index.spec.js.map +1 -0
- package/node_modules/capital-case/dist.es2015/index.d.ts +4 -0
- package/node_modules/capital-case/dist.es2015/index.js +11 -0
- package/node_modules/capital-case/dist.es2015/index.js.map +1 -0
- package/node_modules/capital-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/capital-case/dist.es2015/index.spec.js +22 -0
- package/node_modules/capital-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/capital-case/package.json +90 -0
- package/node_modules/change-case/LICENSE +21 -0
- package/node_modules/change-case/README.md +44 -0
- package/node_modules/change-case/dist/index.d.ts +11 -0
- package/node_modules/change-case/dist/index.js +15 -0
- package/node_modules/change-case/dist/index.js.map +1 -0
- package/node_modules/change-case/dist/index.spec.d.ts +1 -0
- package/node_modules/change-case/dist/index.spec.js +9 -0
- package/node_modules/change-case/dist/index.spec.js.map +1 -0
- package/node_modules/change-case/dist.es2015/index.d.ts +11 -0
- package/node_modules/change-case/dist.es2015/index.js +12 -0
- package/node_modules/change-case/dist.es2015/index.js.map +1 -0
- package/node_modules/change-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/change-case/dist.es2015/index.spec.js +7 -0
- package/node_modules/change-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/change-case/package.json +101 -0
- package/node_modules/constant-case/LICENSE +21 -0
- package/node_modules/constant-case/README.md +37 -0
- package/node_modules/constant-case/dist/index.d.ts +3 -0
- package/node_modules/constant-case/dist/index.js +12 -0
- package/node_modules/constant-case/dist/index.js.map +1 -0
- package/node_modules/constant-case/dist/index.spec.d.ts +1 -0
- package/node_modules/constant-case/dist/index.spec.js +26 -0
- package/node_modules/constant-case/dist/index.spec.js.map +1 -0
- package/node_modules/constant-case/dist.es2015/index.d.ts +3 -0
- package/node_modules/constant-case/dist.es2015/index.js +8 -0
- package/node_modules/constant-case/dist.es2015/index.js.map +1 -0
- package/node_modules/constant-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/constant-case/dist.es2015/index.spec.js +24 -0
- package/node_modules/constant-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/constant-case/package.json +90 -0
- package/node_modules/dot-case/LICENSE +21 -0
- package/node_modules/dot-case/README.md +37 -0
- package/node_modules/dot-case/dist/index.d.ts +3 -0
- package/node_modules/dot-case/dist/index.js +11 -0
- package/node_modules/dot-case/dist/index.js.map +1 -0
- package/node_modules/dot-case/dist/index.spec.d.ts +1 -0
- package/node_modules/dot-case/dist/index.spec.js +26 -0
- package/node_modules/dot-case/dist/index.spec.js.map +1 -0
- package/node_modules/dot-case/dist.es2015/index.d.ts +3 -0
- package/node_modules/dot-case/dist.es2015/index.js +7 -0
- package/node_modules/dot-case/dist.es2015/index.js.map +1 -0
- package/node_modules/dot-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/dot-case/dist.es2015/index.spec.js +24 -0
- package/node_modules/dot-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/dot-case/package.json +89 -0
- package/node_modules/fs-extra/LICENSE +15 -0
- package/node_modules/fs-extra/README.md +262 -0
- package/node_modules/fs-extra/lib/copy/copy-sync.js +169 -0
- package/node_modules/fs-extra/lib/copy/copy.js +235 -0
- package/node_modules/fs-extra/lib/copy/index.js +7 -0
- package/node_modules/fs-extra/lib/empty/index.js +39 -0
- package/node_modules/fs-extra/lib/ensure/file.js +69 -0
- package/node_modules/fs-extra/lib/ensure/index.js +23 -0
- package/node_modules/fs-extra/lib/ensure/link.js +64 -0
- package/node_modules/fs-extra/lib/ensure/symlink-paths.js +99 -0
- package/node_modules/fs-extra/lib/ensure/symlink-type.js +31 -0
- package/node_modules/fs-extra/lib/ensure/symlink.js +82 -0
- package/node_modules/fs-extra/lib/fs/index.js +128 -0
- package/node_modules/fs-extra/lib/index.js +16 -0
- package/node_modules/fs-extra/lib/json/index.js +16 -0
- package/node_modules/fs-extra/lib/json/jsonfile.js +11 -0
- package/node_modules/fs-extra/lib/json/output-json-sync.js +12 -0
- package/node_modules/fs-extra/lib/json/output-json.js +12 -0
- package/node_modules/fs-extra/lib/mkdirs/index.js +14 -0
- package/node_modules/fs-extra/lib/mkdirs/make-dir.js +27 -0
- package/node_modules/fs-extra/lib/mkdirs/utils.js +21 -0
- package/node_modules/fs-extra/lib/move/index.js +7 -0
- package/node_modules/fs-extra/lib/move/move-sync.js +54 -0
- package/node_modules/fs-extra/lib/move/move.js +75 -0
- package/node_modules/fs-extra/lib/output-file/index.js +40 -0
- package/node_modules/fs-extra/lib/path-exists/index.js +12 -0
- package/node_modules/fs-extra/lib/remove/index.js +22 -0
- package/node_modules/fs-extra/lib/remove/rimraf.js +302 -0
- package/node_modules/fs-extra/lib/util/stat.js +154 -0
- package/node_modules/fs-extra/lib/util/utimes.js +26 -0
- package/node_modules/fs-extra/package.json +67 -0
- package/node_modules/graceful-fs/LICENSE +15 -0
- package/node_modules/graceful-fs/README.md +143 -0
- package/node_modules/graceful-fs/clone.js +23 -0
- package/node_modules/graceful-fs/graceful-fs.js +448 -0
- package/node_modules/graceful-fs/legacy-streams.js +118 -0
- package/node_modules/graceful-fs/package.json +53 -0
- package/node_modules/graceful-fs/polyfills.js +355 -0
- package/node_modules/header-case/LICENSE +21 -0
- package/node_modules/header-case/README.md +37 -0
- package/node_modules/header-case/dist/index.d.ts +3 -0
- package/node_modules/header-case/dist/index.js +11 -0
- package/node_modules/header-case/dist/index.js.map +1 -0
- package/node_modules/header-case/dist/index.spec.d.ts +1 -0
- package/node_modules/header-case/dist/index.spec.js +24 -0
- package/node_modules/header-case/dist/index.spec.js.map +1 -0
- package/node_modules/header-case/dist.es2015/index.d.ts +3 -0
- package/node_modules/header-case/dist.es2015/index.js +7 -0
- package/node_modules/header-case/dist.es2015/index.js.map +1 -0
- package/node_modules/header-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/header-case/dist.es2015/index.spec.js +22 -0
- package/node_modules/header-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/header-case/package.json +89 -0
- package/node_modules/jsonfile/LICENSE +15 -0
- package/node_modules/jsonfile/README.md +230 -0
- package/node_modules/jsonfile/index.js +88 -0
- package/node_modules/jsonfile/package.json +40 -0
- package/node_modules/jsonfile/utils.js +14 -0
- package/node_modules/lower-case/LICENSE +21 -0
- package/node_modules/lower-case/README.md +35 -0
- package/node_modules/lower-case/dist/index.d.ts +8 -0
- package/node_modules/lower-case/dist/index.js +53 -0
- package/node_modules/lower-case/dist/index.js.map +1 -0
- package/node_modules/lower-case/dist/index.spec.d.ts +1 -0
- package/node_modules/lower-case/dist/index.spec.js +36 -0
- package/node_modules/lower-case/dist/index.spec.js.map +1 -0
- package/node_modules/lower-case/dist.es2015/index.d.ts +8 -0
- package/node_modules/lower-case/dist.es2015/index.js +48 -0
- package/node_modules/lower-case/dist.es2015/index.js.map +1 -0
- package/node_modules/lower-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/lower-case/dist.es2015/index.spec.js +34 -0
- package/node_modules/lower-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/lower-case/package.json +87 -0
- package/node_modules/no-case/LICENSE +21 -0
- package/node_modules/no-case/README.md +37 -0
- package/node_modules/no-case/dist/index.d.ts +10 -0
- package/node_modules/no-case/dist/index.js +35 -0
- package/node_modules/no-case/dist/index.js.map +1 -0
- package/node_modules/no-case/dist/index.spec.d.ts +1 -0
- package/node_modules/no-case/dist/index.spec.js +59 -0
- package/node_modules/no-case/dist/index.spec.js.map +1 -0
- package/node_modules/no-case/dist.es2015/index.d.ts +10 -0
- package/node_modules/no-case/dist.es2015/index.js +31 -0
- package/node_modules/no-case/dist.es2015/index.js.map +1 -0
- package/node_modules/no-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/no-case/dist.es2015/index.spec.js +57 -0
- package/node_modules/no-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/no-case/package.json +85 -0
- package/node_modules/param-case/LICENSE +21 -0
- package/node_modules/param-case/README.md +37 -0
- package/node_modules/param-case/dist/index.d.ts +3 -0
- package/node_modules/param-case/dist/index.js +11 -0
- package/node_modules/param-case/dist/index.js.map +1 -0
- package/node_modules/param-case/dist/index.spec.d.ts +1 -0
- package/node_modules/param-case/dist/index.spec.js +24 -0
- package/node_modules/param-case/dist/index.spec.js.map +1 -0
- package/node_modules/param-case/dist.es2015/index.d.ts +3 -0
- package/node_modules/param-case/dist.es2015/index.js +7 -0
- package/node_modules/param-case/dist.es2015/index.js.map +1 -0
- package/node_modules/param-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/param-case/dist.es2015/index.spec.js +22 -0
- package/node_modules/param-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/param-case/package.json +91 -0
- package/node_modules/pascal-case/LICENSE +21 -0
- package/node_modules/pascal-case/README.md +47 -0
- package/node_modules/pascal-case/dist/index.d.ts +5 -0
- package/node_modules/pascal-case/dist/index.js +24 -0
- package/node_modules/pascal-case/dist/index.js.map +1 -0
- package/node_modules/pascal-case/dist/index.spec.d.ts +1 -0
- package/node_modules/pascal-case/dist/index.spec.js +25 -0
- package/node_modules/pascal-case/dist/index.spec.js.map +1 -0
- package/node_modules/pascal-case/dist.es2015/index.d.ts +5 -0
- package/node_modules/pascal-case/dist.es2015/index.js +18 -0
- package/node_modules/pascal-case/dist.es2015/index.js.map +1 -0
- package/node_modules/pascal-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/pascal-case/dist.es2015/index.spec.js +23 -0
- package/node_modules/pascal-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/pascal-case/package.json +90 -0
- package/node_modules/path-case/LICENSE +21 -0
- package/node_modules/path-case/README.md +37 -0
- package/node_modules/path-case/dist/index.d.ts +3 -0
- package/node_modules/path-case/dist/index.js +11 -0
- package/node_modules/path-case/dist/index.js.map +1 -0
- package/node_modules/path-case/dist/index.spec.d.ts +1 -0
- package/node_modules/path-case/dist/index.spec.js +24 -0
- package/node_modules/path-case/dist/index.spec.js.map +1 -0
- package/node_modules/path-case/dist.es2015/index.d.ts +3 -0
- package/node_modules/path-case/dist.es2015/index.js +7 -0
- package/node_modules/path-case/dist.es2015/index.js.map +1 -0
- package/node_modules/path-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/path-case/dist.es2015/index.spec.js +22 -0
- package/node_modules/path-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/path-case/package.json +88 -0
- package/node_modules/sentence-case/LICENSE +21 -0
- package/node_modules/sentence-case/README.md +37 -0
- package/node_modules/sentence-case/dist/index.d.ts +4 -0
- package/node_modules/sentence-case/dist/index.js +19 -0
- package/node_modules/sentence-case/dist/index.js.map +1 -0
- package/node_modules/sentence-case/dist/index.spec.d.ts +1 -0
- package/node_modules/sentence-case/dist/index.spec.js +24 -0
- package/node_modules/sentence-case/dist/index.spec.js.map +1 -0
- package/node_modules/sentence-case/dist.es2015/index.d.ts +4 -0
- package/node_modules/sentence-case/dist.es2015/index.js +14 -0
- package/node_modules/sentence-case/dist.es2015/index.js.map +1 -0
- package/node_modules/sentence-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/sentence-case/dist.es2015/index.spec.js +22 -0
- package/node_modules/sentence-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/sentence-case/package.json +89 -0
- package/node_modules/snake-case/LICENSE +21 -0
- package/node_modules/snake-case/README.md +37 -0
- package/node_modules/snake-case/dist/index.d.ts +3 -0
- package/node_modules/snake-case/dist/index.js +11 -0
- package/node_modules/snake-case/dist/index.js.map +1 -0
- package/node_modules/snake-case/dist/index.spec.d.ts +1 -0
- package/node_modules/snake-case/dist/index.spec.js +25 -0
- package/node_modules/snake-case/dist/index.spec.js.map +1 -0
- package/node_modules/snake-case/dist.es2015/index.d.ts +3 -0
- package/node_modules/snake-case/dist.es2015/index.js +7 -0
- package/node_modules/snake-case/dist.es2015/index.js.map +1 -0
- package/node_modules/snake-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/snake-case/dist.es2015/index.spec.js +23 -0
- package/node_modules/snake-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/snake-case/package.json +90 -0
- package/node_modules/tslib/CopyrightNotice.txt +15 -0
- package/node_modules/tslib/LICENSE.txt +12 -0
- package/node_modules/tslib/README.md +164 -0
- package/node_modules/tslib/SECURITY.md +41 -0
- package/node_modules/tslib/modules/index.d.ts +38 -0
- package/node_modules/tslib/modules/index.js +70 -0
- package/node_modules/tslib/modules/package.json +3 -0
- package/node_modules/tslib/package.json +47 -0
- package/node_modules/tslib/tslib.d.ts +460 -0
- package/node_modules/tslib/tslib.es6.html +1 -0
- package/node_modules/tslib/tslib.es6.js +402 -0
- package/node_modules/tslib/tslib.es6.mjs +401 -0
- package/node_modules/tslib/tslib.html +1 -0
- package/node_modules/tslib/tslib.js +484 -0
- package/node_modules/universalify/LICENSE +20 -0
- package/node_modules/universalify/README.md +76 -0
- package/node_modules/universalify/index.js +24 -0
- package/node_modules/universalify/package.json +34 -0
- package/node_modules/upper-case/README.md +34 -0
- package/node_modules/upper-case/dist/index.d.ts +8 -0
- package/node_modules/upper-case/dist/index.js +49 -0
- package/node_modules/upper-case/dist/index.js.map +1 -0
- package/node_modules/upper-case/dist/index.spec.d.ts +1 -0
- package/node_modules/upper-case/dist/index.spec.js +34 -0
- package/node_modules/upper-case/dist/index.spec.js.map +1 -0
- package/node_modules/upper-case/dist.es2015/index.d.ts +8 -0
- package/node_modules/upper-case/dist.es2015/index.js +44 -0
- package/node_modules/upper-case/dist.es2015/index.js.map +1 -0
- package/node_modules/upper-case/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/upper-case/dist.es2015/index.spec.js +32 -0
- package/node_modules/upper-case/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/upper-case/package.json +86 -0
- package/node_modules/upper-case-first/LICENSE +21 -0
- package/node_modules/upper-case-first/README.md +32 -0
- package/node_modules/upper-case-first/dist/index.d.ts +4 -0
- package/node_modules/upper-case-first/dist/index.js +11 -0
- package/node_modules/upper-case-first/dist/index.js.map +1 -0
- package/node_modules/upper-case-first/dist/index.spec.d.ts +1 -0
- package/node_modules/upper-case-first/dist/index.spec.js +20 -0
- package/node_modules/upper-case-first/dist/index.spec.js.map +1 -0
- package/node_modules/upper-case-first/dist.es2015/index.d.ts +4 -0
- package/node_modules/upper-case-first/dist.es2015/index.js +7 -0
- package/node_modules/upper-case-first/dist.es2015/index.js.map +1 -0
- package/node_modules/upper-case-first/dist.es2015/index.spec.d.ts +1 -0
- package/node_modules/upper-case-first/dist.es2015/index.spec.js +18 -0
- package/node_modules/upper-case-first/dist.es2015/index.spec.js.map +1 -0
- package/node_modules/upper-case-first/package.json +87 -0
- package/package.json +181 -0
package/API.md
ADDED
|
@@ -0,0 +1,4154 @@
|
|
|
1
|
+
# API Reference <a name="API Reference" id="api-reference"></a>
|
|
2
|
+
|
|
3
|
+
## Constructs <a name="Constructs" id="Constructs"></a>
|
|
4
|
+
|
|
5
|
+
### CdktnProviderProject <a name="CdktnProviderProject" id="@cdktn/provider-project.CdktnProviderProject"></a>
|
|
6
|
+
|
|
7
|
+
#### Initializers <a name="Initializers" id="@cdktn/provider-project.CdktnProviderProject.Initializer"></a>
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { CdktnProviderProject } from '@cdktn/provider-project'
|
|
11
|
+
|
|
12
|
+
new CdktnProviderProject(options: CdktnProviderProjectOptions)
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
| **Name** | **Type** | **Description** |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.Initializer.parameter.options">options</a></code> | <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions">CdktnProviderProjectOptions</a></code> | *No description.* |
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
##### `options`<sup>Required</sup> <a name="options" id="@cdktn/provider-project.CdktnProviderProject.Initializer.parameter.options"></a>
|
|
22
|
+
|
|
23
|
+
- *Type:* <a href="#@cdktn/provider-project.CdktnProviderProjectOptions">CdktnProviderProjectOptions</a>
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
#### Methods <a name="Methods" id="Methods"></a>
|
|
28
|
+
|
|
29
|
+
| **Name** | **Description** |
|
|
30
|
+
| --- | --- |
|
|
31
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.toString">toString</a></code> | Returns a string representation of this construct. |
|
|
32
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addExcludeFromCleanup">addExcludeFromCleanup</a></code> | Exclude the matching files from pre-synth cleanup. |
|
|
33
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addGitIgnore">addGitIgnore</a></code> | Adds a .gitignore pattern. |
|
|
34
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addPackageIgnore">addPackageIgnore</a></code> | Adds patterns to be ignored by npm. |
|
|
35
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addTask">addTask</a></code> | Adds a new task to this project. |
|
|
36
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addTip">addTip</a></code> | Prints a "tip" message during synthesis. |
|
|
37
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.annotateGenerated">annotateGenerated</a></code> | Marks the provided file(s) as being generated. |
|
|
38
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.postSynthesize">postSynthesize</a></code> | Called after all components are synthesized. |
|
|
39
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.preSynthesize">preSynthesize</a></code> | Called before all components are synthesized. |
|
|
40
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.removeTask">removeTask</a></code> | Removes a task from a project. |
|
|
41
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.runTaskCommand">runTaskCommand</a></code> | Returns the shell command to execute in order to run a task. |
|
|
42
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.synth">synth</a></code> | Synthesize all project files into `outdir`. |
|
|
43
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.tryFindFile">tryFindFile</a></code> | Finds a file at the specified relative path within this project and all its subprojects. |
|
|
44
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.tryFindJsonFile">tryFindJsonFile</a></code> | Finds a json file by name. |
|
|
45
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.tryFindObjectFile">tryFindObjectFile</a></code> | Finds an object file (like JsonFile, YamlFile, etc.) by name. |
|
|
46
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.tryRemoveFile">tryRemoveFile</a></code> | Finds a file at the specified relative path within this project and removes it. |
|
|
47
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addBins">addBins</a></code> | *No description.* |
|
|
48
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addBundledDeps">addBundledDeps</a></code> | Defines bundled dependencies. |
|
|
49
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addCompileCommand">addCompileCommand</a></code> | DEPRECATED. |
|
|
50
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addDeps">addDeps</a></code> | Defines normal dependencies. |
|
|
51
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addDevDeps">addDevDeps</a></code> | Defines development/test dependencies. |
|
|
52
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addFields">addFields</a></code> | Directly set fields in `package.json`. |
|
|
53
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addKeywords">addKeywords</a></code> | Adds keywords to package.json (deduplicated). |
|
|
54
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addPeerDeps">addPeerDeps</a></code> | Defines peer dependencies. |
|
|
55
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addScripts">addScripts</a></code> | Replaces the contents of multiple npm package.json scripts. |
|
|
56
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.addTestCommand">addTestCommand</a></code> | DEPRECATED. |
|
|
57
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.hasScript">hasScript</a></code> | Indicates if a script by the name name is defined. |
|
|
58
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.removeScript">removeScript</a></code> | Removes the npm script (always successful). |
|
|
59
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.renderWorkflowSetup">renderWorkflowSetup</a></code> | Returns the set of workflow steps which should be executed to bootstrap a workflow. |
|
|
60
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.setScript">setScript</a></code> | Replaces the contents of an npm package.json script. |
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
##### `toString` <a name="toString" id="@cdktn/provider-project.CdktnProviderProject.toString"></a>
|
|
65
|
+
|
|
66
|
+
```typescript
|
|
67
|
+
public toString(): string
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Returns a string representation of this construct.
|
|
71
|
+
|
|
72
|
+
##### `addExcludeFromCleanup` <a name="addExcludeFromCleanup" id="@cdktn/provider-project.CdktnProviderProject.addExcludeFromCleanup"></a>
|
|
73
|
+
|
|
74
|
+
```typescript
|
|
75
|
+
public addExcludeFromCleanup(globs: ...string[]): void
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Exclude the matching files from pre-synth cleanup.
|
|
79
|
+
|
|
80
|
+
Can be used when, for example, some
|
|
81
|
+
source files include the projen marker and we don't want them to be erased during synth.
|
|
82
|
+
|
|
83
|
+
###### `globs`<sup>Required</sup> <a name="globs" id="@cdktn/provider-project.CdktnProviderProject.addExcludeFromCleanup.parameter.globs"></a>
|
|
84
|
+
|
|
85
|
+
- *Type:* ...string[]
|
|
86
|
+
|
|
87
|
+
The glob patterns to match.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
##### `addGitIgnore` <a name="addGitIgnore" id="@cdktn/provider-project.CdktnProviderProject.addGitIgnore"></a>
|
|
92
|
+
|
|
93
|
+
```typescript
|
|
94
|
+
public addGitIgnore(pattern: string): void
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Adds a .gitignore pattern.
|
|
98
|
+
|
|
99
|
+
###### `pattern`<sup>Required</sup> <a name="pattern" id="@cdktn/provider-project.CdktnProviderProject.addGitIgnore.parameter.pattern"></a>
|
|
100
|
+
|
|
101
|
+
- *Type:* string
|
|
102
|
+
|
|
103
|
+
The glob pattern to ignore.
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
##### `addPackageIgnore` <a name="addPackageIgnore" id="@cdktn/provider-project.CdktnProviderProject.addPackageIgnore"></a>
|
|
108
|
+
|
|
109
|
+
```typescript
|
|
110
|
+
public addPackageIgnore(pattern: string): void
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Adds patterns to be ignored by npm.
|
|
114
|
+
|
|
115
|
+
###### `pattern`<sup>Required</sup> <a name="pattern" id="@cdktn/provider-project.CdktnProviderProject.addPackageIgnore.parameter.pattern"></a>
|
|
116
|
+
|
|
117
|
+
- *Type:* string
|
|
118
|
+
|
|
119
|
+
The pattern to ignore.
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
##### `addTask` <a name="addTask" id="@cdktn/provider-project.CdktnProviderProject.addTask"></a>
|
|
124
|
+
|
|
125
|
+
```typescript
|
|
126
|
+
public addTask(name: string, props?: TaskOptions): Task
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
Adds a new task to this project.
|
|
130
|
+
|
|
131
|
+
This will fail if the project already has
|
|
132
|
+
a task with this name.
|
|
133
|
+
|
|
134
|
+
###### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProject.addTask.parameter.name"></a>
|
|
135
|
+
|
|
136
|
+
- *Type:* string
|
|
137
|
+
|
|
138
|
+
The task name to add.
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
###### `props`<sup>Optional</sup> <a name="props" id="@cdktn/provider-project.CdktnProviderProject.addTask.parameter.props"></a>
|
|
143
|
+
|
|
144
|
+
- *Type:* projen.TaskOptions
|
|
145
|
+
|
|
146
|
+
Task properties.
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
##### ~~`addTip`~~ <a name="addTip" id="@cdktn/provider-project.CdktnProviderProject.addTip"></a>
|
|
151
|
+
|
|
152
|
+
```typescript
|
|
153
|
+
public addTip(message: string): void
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
Prints a "tip" message during synthesis.
|
|
157
|
+
|
|
158
|
+
###### `message`<sup>Required</sup> <a name="message" id="@cdktn/provider-project.CdktnProviderProject.addTip.parameter.message"></a>
|
|
159
|
+
|
|
160
|
+
- *Type:* string
|
|
161
|
+
|
|
162
|
+
The message.
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
##### `annotateGenerated` <a name="annotateGenerated" id="@cdktn/provider-project.CdktnProviderProject.annotateGenerated"></a>
|
|
167
|
+
|
|
168
|
+
```typescript
|
|
169
|
+
public annotateGenerated(glob: string): void
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
Marks the provided file(s) as being generated.
|
|
173
|
+
|
|
174
|
+
This is achieved using the
|
|
175
|
+
github-linguist attributes. Generated files do not count against the
|
|
176
|
+
repository statistics and language breakdown.
|
|
177
|
+
|
|
178
|
+
> [https://github.com/github/linguist/blob/master/docs/overrides.md](https://github.com/github/linguist/blob/master/docs/overrides.md)
|
|
179
|
+
|
|
180
|
+
###### `glob`<sup>Required</sup> <a name="glob" id="@cdktn/provider-project.CdktnProviderProject.annotateGenerated.parameter.glob"></a>
|
|
181
|
+
|
|
182
|
+
- *Type:* string
|
|
183
|
+
|
|
184
|
+
the glob pattern to match (could be a file path).
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
##### `postSynthesize` <a name="postSynthesize" id="@cdktn/provider-project.CdktnProviderProject.postSynthesize"></a>
|
|
189
|
+
|
|
190
|
+
```typescript
|
|
191
|
+
public postSynthesize(): void
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
Called after all components are synthesized.
|
|
195
|
+
|
|
196
|
+
Order is *not* guaranteed.
|
|
197
|
+
|
|
198
|
+
##### `preSynthesize` <a name="preSynthesize" id="@cdktn/provider-project.CdktnProviderProject.preSynthesize"></a>
|
|
199
|
+
|
|
200
|
+
```typescript
|
|
201
|
+
public preSynthesize(): void
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
Called before all components are synthesized.
|
|
205
|
+
|
|
206
|
+
##### `removeTask` <a name="removeTask" id="@cdktn/provider-project.CdktnProviderProject.removeTask"></a>
|
|
207
|
+
|
|
208
|
+
```typescript
|
|
209
|
+
public removeTask(name: string): Task
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Removes a task from a project.
|
|
213
|
+
|
|
214
|
+
###### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProject.removeTask.parameter.name"></a>
|
|
215
|
+
|
|
216
|
+
- *Type:* string
|
|
217
|
+
|
|
218
|
+
The name of the task to remove.
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
##### `runTaskCommand` <a name="runTaskCommand" id="@cdktn/provider-project.CdktnProviderProject.runTaskCommand"></a>
|
|
223
|
+
|
|
224
|
+
```typescript
|
|
225
|
+
public runTaskCommand(task: Task): string
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
Returns the shell command to execute in order to run a task.
|
|
229
|
+
|
|
230
|
+
This will
|
|
231
|
+
typically be `npx projen TASK`.
|
|
232
|
+
|
|
233
|
+
###### `task`<sup>Required</sup> <a name="task" id="@cdktn/provider-project.CdktnProviderProject.runTaskCommand.parameter.task"></a>
|
|
234
|
+
|
|
235
|
+
- *Type:* projen.Task
|
|
236
|
+
|
|
237
|
+
The task for which the command is required.
|
|
238
|
+
|
|
239
|
+
---
|
|
240
|
+
|
|
241
|
+
##### `synth` <a name="synth" id="@cdktn/provider-project.CdktnProviderProject.synth"></a>
|
|
242
|
+
|
|
243
|
+
```typescript
|
|
244
|
+
public synth(): void
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
Synthesize all project files into `outdir`.
|
|
248
|
+
|
|
249
|
+
1. Call "this.preSynthesize()"
|
|
250
|
+
2. Delete all generated files
|
|
251
|
+
3. Synthesize all subprojects
|
|
252
|
+
4. Synthesize all components of this project
|
|
253
|
+
5. Call "postSynthesize()" for all components of this project
|
|
254
|
+
6. Call "this.postSynthesize()"
|
|
255
|
+
|
|
256
|
+
##### `tryFindFile` <a name="tryFindFile" id="@cdktn/provider-project.CdktnProviderProject.tryFindFile"></a>
|
|
257
|
+
|
|
258
|
+
```typescript
|
|
259
|
+
public tryFindFile(filePath: string): FileBase
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
Finds a file at the specified relative path within this project and all its subprojects.
|
|
263
|
+
|
|
264
|
+
###### `filePath`<sup>Required</sup> <a name="filePath" id="@cdktn/provider-project.CdktnProviderProject.tryFindFile.parameter.filePath"></a>
|
|
265
|
+
|
|
266
|
+
- *Type:* string
|
|
267
|
+
|
|
268
|
+
The file path.
|
|
269
|
+
|
|
270
|
+
If this path is relative, it will be resolved
|
|
271
|
+
from the root of _this_ project.
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
##### ~~`tryFindJsonFile`~~ <a name="tryFindJsonFile" id="@cdktn/provider-project.CdktnProviderProject.tryFindJsonFile"></a>
|
|
276
|
+
|
|
277
|
+
```typescript
|
|
278
|
+
public tryFindJsonFile(filePath: string): JsonFile
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
Finds a json file by name.
|
|
282
|
+
|
|
283
|
+
###### `filePath`<sup>Required</sup> <a name="filePath" id="@cdktn/provider-project.CdktnProviderProject.tryFindJsonFile.parameter.filePath"></a>
|
|
284
|
+
|
|
285
|
+
- *Type:* string
|
|
286
|
+
|
|
287
|
+
The file path.
|
|
288
|
+
|
|
289
|
+
---
|
|
290
|
+
|
|
291
|
+
##### `tryFindObjectFile` <a name="tryFindObjectFile" id="@cdktn/provider-project.CdktnProviderProject.tryFindObjectFile"></a>
|
|
292
|
+
|
|
293
|
+
```typescript
|
|
294
|
+
public tryFindObjectFile(filePath: string): ObjectFile
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
Finds an object file (like JsonFile, YamlFile, etc.) by name.
|
|
298
|
+
|
|
299
|
+
###### `filePath`<sup>Required</sup> <a name="filePath" id="@cdktn/provider-project.CdktnProviderProject.tryFindObjectFile.parameter.filePath"></a>
|
|
300
|
+
|
|
301
|
+
- *Type:* string
|
|
302
|
+
|
|
303
|
+
The file path.
|
|
304
|
+
|
|
305
|
+
---
|
|
306
|
+
|
|
307
|
+
##### `tryRemoveFile` <a name="tryRemoveFile" id="@cdktn/provider-project.CdktnProviderProject.tryRemoveFile"></a>
|
|
308
|
+
|
|
309
|
+
```typescript
|
|
310
|
+
public tryRemoveFile(filePath: string): FileBase
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
Finds a file at the specified relative path within this project and removes it.
|
|
314
|
+
|
|
315
|
+
###### `filePath`<sup>Required</sup> <a name="filePath" id="@cdktn/provider-project.CdktnProviderProject.tryRemoveFile.parameter.filePath"></a>
|
|
316
|
+
|
|
317
|
+
- *Type:* string
|
|
318
|
+
|
|
319
|
+
The file path.
|
|
320
|
+
|
|
321
|
+
If this path is relative, it will be
|
|
322
|
+
resolved from the root of _this_ project.
|
|
323
|
+
|
|
324
|
+
---
|
|
325
|
+
|
|
326
|
+
##### `addBins` <a name="addBins" id="@cdktn/provider-project.CdktnProviderProject.addBins"></a>
|
|
327
|
+
|
|
328
|
+
```typescript
|
|
329
|
+
public addBins(bins: {[ key: string ]: string}): void
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
###### `bins`<sup>Required</sup> <a name="bins" id="@cdktn/provider-project.CdktnProviderProject.addBins.parameter.bins"></a>
|
|
333
|
+
|
|
334
|
+
- *Type:* {[ key: string ]: string}
|
|
335
|
+
|
|
336
|
+
---
|
|
337
|
+
|
|
338
|
+
##### `addBundledDeps` <a name="addBundledDeps" id="@cdktn/provider-project.CdktnProviderProject.addBundledDeps"></a>
|
|
339
|
+
|
|
340
|
+
```typescript
|
|
341
|
+
public addBundledDeps(deps: ...string[]): void
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
Defines bundled dependencies.
|
|
345
|
+
|
|
346
|
+
Bundled dependencies will be added as normal dependencies as well as to the
|
|
347
|
+
`bundledDependencies` section of your `package.json`.
|
|
348
|
+
|
|
349
|
+
###### `deps`<sup>Required</sup> <a name="deps" id="@cdktn/provider-project.CdktnProviderProject.addBundledDeps.parameter.deps"></a>
|
|
350
|
+
|
|
351
|
+
- *Type:* ...string[]
|
|
352
|
+
|
|
353
|
+
Names modules to install.
|
|
354
|
+
|
|
355
|
+
By default, the the dependency will
|
|
356
|
+
be installed in the next `npx projen` run and the version will be recorded
|
|
357
|
+
in your `package.json` file. You can upgrade manually or using `yarn
|
|
358
|
+
add/upgrade`. If you wish to specify a version range use this syntax:
|
|
359
|
+
`module@^7`.
|
|
360
|
+
|
|
361
|
+
---
|
|
362
|
+
|
|
363
|
+
##### ~~`addCompileCommand`~~ <a name="addCompileCommand" id="@cdktn/provider-project.CdktnProviderProject.addCompileCommand"></a>
|
|
364
|
+
|
|
365
|
+
```typescript
|
|
366
|
+
public addCompileCommand(commands: ...string[]): void
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
DEPRECATED.
|
|
370
|
+
|
|
371
|
+
###### `commands`<sup>Required</sup> <a name="commands" id="@cdktn/provider-project.CdktnProviderProject.addCompileCommand.parameter.commands"></a>
|
|
372
|
+
|
|
373
|
+
- *Type:* ...string[]
|
|
374
|
+
|
|
375
|
+
---
|
|
376
|
+
|
|
377
|
+
##### `addDeps` <a name="addDeps" id="@cdktn/provider-project.CdktnProviderProject.addDeps"></a>
|
|
378
|
+
|
|
379
|
+
```typescript
|
|
380
|
+
public addDeps(deps: ...string[]): void
|
|
381
|
+
```
|
|
382
|
+
|
|
383
|
+
Defines normal dependencies.
|
|
384
|
+
|
|
385
|
+
###### `deps`<sup>Required</sup> <a name="deps" id="@cdktn/provider-project.CdktnProviderProject.addDeps.parameter.deps"></a>
|
|
386
|
+
|
|
387
|
+
- *Type:* ...string[]
|
|
388
|
+
|
|
389
|
+
Names modules to install.
|
|
390
|
+
|
|
391
|
+
By default, the the dependency will
|
|
392
|
+
be installed in the next `npx projen` run and the version will be recorded
|
|
393
|
+
in your `package.json` file. You can upgrade manually or using `yarn
|
|
394
|
+
add/upgrade`. If you wish to specify a version range use this syntax:
|
|
395
|
+
`module@^7`.
|
|
396
|
+
|
|
397
|
+
---
|
|
398
|
+
|
|
399
|
+
##### `addDevDeps` <a name="addDevDeps" id="@cdktn/provider-project.CdktnProviderProject.addDevDeps"></a>
|
|
400
|
+
|
|
401
|
+
```typescript
|
|
402
|
+
public addDevDeps(deps: ...string[]): void
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
Defines development/test dependencies.
|
|
406
|
+
|
|
407
|
+
###### `deps`<sup>Required</sup> <a name="deps" id="@cdktn/provider-project.CdktnProviderProject.addDevDeps.parameter.deps"></a>
|
|
408
|
+
|
|
409
|
+
- *Type:* ...string[]
|
|
410
|
+
|
|
411
|
+
Names modules to install.
|
|
412
|
+
|
|
413
|
+
By default, the the dependency will
|
|
414
|
+
be installed in the next `npx projen` run and the version will be recorded
|
|
415
|
+
in your `package.json` file. You can upgrade manually or using `yarn
|
|
416
|
+
add/upgrade`. If you wish to specify a version range use this syntax:
|
|
417
|
+
`module@^7`.
|
|
418
|
+
|
|
419
|
+
---
|
|
420
|
+
|
|
421
|
+
##### `addFields` <a name="addFields" id="@cdktn/provider-project.CdktnProviderProject.addFields"></a>
|
|
422
|
+
|
|
423
|
+
```typescript
|
|
424
|
+
public addFields(fields: {[ key: string ]: any}): void
|
|
425
|
+
```
|
|
426
|
+
|
|
427
|
+
Directly set fields in `package.json`.
|
|
428
|
+
|
|
429
|
+
###### `fields`<sup>Required</sup> <a name="fields" id="@cdktn/provider-project.CdktnProviderProject.addFields.parameter.fields"></a>
|
|
430
|
+
|
|
431
|
+
- *Type:* {[ key: string ]: any}
|
|
432
|
+
|
|
433
|
+
The fields to set.
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
437
|
+
##### `addKeywords` <a name="addKeywords" id="@cdktn/provider-project.CdktnProviderProject.addKeywords"></a>
|
|
438
|
+
|
|
439
|
+
```typescript
|
|
440
|
+
public addKeywords(keywords: ...string[]): void
|
|
441
|
+
```
|
|
442
|
+
|
|
443
|
+
Adds keywords to package.json (deduplicated).
|
|
444
|
+
|
|
445
|
+
###### `keywords`<sup>Required</sup> <a name="keywords" id="@cdktn/provider-project.CdktnProviderProject.addKeywords.parameter.keywords"></a>
|
|
446
|
+
|
|
447
|
+
- *Type:* ...string[]
|
|
448
|
+
|
|
449
|
+
The keywords to add.
|
|
450
|
+
|
|
451
|
+
---
|
|
452
|
+
|
|
453
|
+
##### `addPeerDeps` <a name="addPeerDeps" id="@cdktn/provider-project.CdktnProviderProject.addPeerDeps"></a>
|
|
454
|
+
|
|
455
|
+
```typescript
|
|
456
|
+
public addPeerDeps(deps: ...string[]): void
|
|
457
|
+
```
|
|
458
|
+
|
|
459
|
+
Defines peer dependencies.
|
|
460
|
+
|
|
461
|
+
When adding peer dependencies, a devDependency will also be added on the
|
|
462
|
+
pinned version of the declared peer. This will ensure that you are testing
|
|
463
|
+
your code against the minimum version required from your consumers.
|
|
464
|
+
|
|
465
|
+
###### `deps`<sup>Required</sup> <a name="deps" id="@cdktn/provider-project.CdktnProviderProject.addPeerDeps.parameter.deps"></a>
|
|
466
|
+
|
|
467
|
+
- *Type:* ...string[]
|
|
468
|
+
|
|
469
|
+
Names modules to install.
|
|
470
|
+
|
|
471
|
+
By default, the the dependency will
|
|
472
|
+
be installed in the next `npx projen` run and the version will be recorded
|
|
473
|
+
in your `package.json` file. You can upgrade manually or using `yarn
|
|
474
|
+
add/upgrade`. If you wish to specify a version range use this syntax:
|
|
475
|
+
`module@^7`.
|
|
476
|
+
|
|
477
|
+
---
|
|
478
|
+
|
|
479
|
+
##### `addScripts` <a name="addScripts" id="@cdktn/provider-project.CdktnProviderProject.addScripts"></a>
|
|
480
|
+
|
|
481
|
+
```typescript
|
|
482
|
+
public addScripts(scripts: {[ key: string ]: string}): void
|
|
483
|
+
```
|
|
484
|
+
|
|
485
|
+
Replaces the contents of multiple npm package.json scripts.
|
|
486
|
+
|
|
487
|
+
###### `scripts`<sup>Required</sup> <a name="scripts" id="@cdktn/provider-project.CdktnProviderProject.addScripts.parameter.scripts"></a>
|
|
488
|
+
|
|
489
|
+
- *Type:* {[ key: string ]: string}
|
|
490
|
+
|
|
491
|
+
The scripts to set.
|
|
492
|
+
|
|
493
|
+
---
|
|
494
|
+
|
|
495
|
+
##### ~~`addTestCommand`~~ <a name="addTestCommand" id="@cdktn/provider-project.CdktnProviderProject.addTestCommand"></a>
|
|
496
|
+
|
|
497
|
+
```typescript
|
|
498
|
+
public addTestCommand(commands: ...string[]): void
|
|
499
|
+
```
|
|
500
|
+
|
|
501
|
+
DEPRECATED.
|
|
502
|
+
|
|
503
|
+
###### `commands`<sup>Required</sup> <a name="commands" id="@cdktn/provider-project.CdktnProviderProject.addTestCommand.parameter.commands"></a>
|
|
504
|
+
|
|
505
|
+
- *Type:* ...string[]
|
|
506
|
+
|
|
507
|
+
---
|
|
508
|
+
|
|
509
|
+
##### ~~`hasScript`~~ <a name="hasScript" id="@cdktn/provider-project.CdktnProviderProject.hasScript"></a>
|
|
510
|
+
|
|
511
|
+
```typescript
|
|
512
|
+
public hasScript(name: string): boolean
|
|
513
|
+
```
|
|
514
|
+
|
|
515
|
+
Indicates if a script by the name name is defined.
|
|
516
|
+
|
|
517
|
+
###### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProject.hasScript.parameter.name"></a>
|
|
518
|
+
|
|
519
|
+
- *Type:* string
|
|
520
|
+
|
|
521
|
+
The name of the script.
|
|
522
|
+
|
|
523
|
+
---
|
|
524
|
+
|
|
525
|
+
##### `removeScript` <a name="removeScript" id="@cdktn/provider-project.CdktnProviderProject.removeScript"></a>
|
|
526
|
+
|
|
527
|
+
```typescript
|
|
528
|
+
public removeScript(name: string): void
|
|
529
|
+
```
|
|
530
|
+
|
|
531
|
+
Removes the npm script (always successful).
|
|
532
|
+
|
|
533
|
+
###### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProject.removeScript.parameter.name"></a>
|
|
534
|
+
|
|
535
|
+
- *Type:* string
|
|
536
|
+
|
|
537
|
+
The name of the script.
|
|
538
|
+
|
|
539
|
+
---
|
|
540
|
+
|
|
541
|
+
##### `renderWorkflowSetup` <a name="renderWorkflowSetup" id="@cdktn/provider-project.CdktnProviderProject.renderWorkflowSetup"></a>
|
|
542
|
+
|
|
543
|
+
```typescript
|
|
544
|
+
public renderWorkflowSetup(options?: RenderWorkflowSetupOptions): JobStep[]
|
|
545
|
+
```
|
|
546
|
+
|
|
547
|
+
Returns the set of workflow steps which should be executed to bootstrap a workflow.
|
|
548
|
+
|
|
549
|
+
###### `options`<sup>Optional</sup> <a name="options" id="@cdktn/provider-project.CdktnProviderProject.renderWorkflowSetup.parameter.options"></a>
|
|
550
|
+
|
|
551
|
+
- *Type:* projen.javascript.RenderWorkflowSetupOptions
|
|
552
|
+
|
|
553
|
+
Options.
|
|
554
|
+
|
|
555
|
+
---
|
|
556
|
+
|
|
557
|
+
##### `setScript` <a name="setScript" id="@cdktn/provider-project.CdktnProviderProject.setScript"></a>
|
|
558
|
+
|
|
559
|
+
```typescript
|
|
560
|
+
public setScript(name: string, command: string): void
|
|
561
|
+
```
|
|
562
|
+
|
|
563
|
+
Replaces the contents of an npm package.json script.
|
|
564
|
+
|
|
565
|
+
###### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProject.setScript.parameter.name"></a>
|
|
566
|
+
|
|
567
|
+
- *Type:* string
|
|
568
|
+
|
|
569
|
+
The script name.
|
|
570
|
+
|
|
571
|
+
---
|
|
572
|
+
|
|
573
|
+
###### `command`<sup>Required</sup> <a name="command" id="@cdktn/provider-project.CdktnProviderProject.setScript.parameter.command"></a>
|
|
574
|
+
|
|
575
|
+
- *Type:* string
|
|
576
|
+
|
|
577
|
+
The command to execute.
|
|
578
|
+
|
|
579
|
+
---
|
|
580
|
+
|
|
581
|
+
#### Static Functions <a name="Static Functions" id="Static Functions"></a>
|
|
582
|
+
|
|
583
|
+
| **Name** | **Description** |
|
|
584
|
+
| --- | --- |
|
|
585
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
|
|
586
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.isProject">isProject</a></code> | Test whether the given construct is a project. |
|
|
587
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.of">of</a></code> | Find the closest ancestor project for given construct. |
|
|
588
|
+
|
|
589
|
+
---
|
|
590
|
+
|
|
591
|
+
##### `isConstruct` <a name="isConstruct" id="@cdktn/provider-project.CdktnProviderProject.isConstruct"></a>
|
|
592
|
+
|
|
593
|
+
```typescript
|
|
594
|
+
import { CdktnProviderProject } from '@cdktn/provider-project'
|
|
595
|
+
|
|
596
|
+
CdktnProviderProject.isConstruct(x: any)
|
|
597
|
+
```
|
|
598
|
+
|
|
599
|
+
Checks if `x` is a construct.
|
|
600
|
+
|
|
601
|
+
Use this method instead of `instanceof` to properly detect `Construct`
|
|
602
|
+
instances, even when the construct library is symlinked.
|
|
603
|
+
|
|
604
|
+
Explanation: in JavaScript, multiple copies of the `constructs` library on
|
|
605
|
+
disk are seen as independent, completely different libraries. As a
|
|
606
|
+
consequence, the class `Construct` in each copy of the `constructs` library
|
|
607
|
+
is seen as a different class, and an instance of one class will not test as
|
|
608
|
+
`instanceof` the other class. `npm install` will not create installations
|
|
609
|
+
like this, but users may manually symlink construct libraries together or
|
|
610
|
+
use a monorepo tool: in those cases, multiple copies of the `constructs`
|
|
611
|
+
library can be accidentally installed, and `instanceof` will behave
|
|
612
|
+
unpredictably. It is safest to avoid using `instanceof`, and using
|
|
613
|
+
this type-testing method instead.
|
|
614
|
+
|
|
615
|
+
###### `x`<sup>Required</sup> <a name="x" id="@cdktn/provider-project.CdktnProviderProject.isConstruct.parameter.x"></a>
|
|
616
|
+
|
|
617
|
+
- *Type:* any
|
|
618
|
+
|
|
619
|
+
Any object.
|
|
620
|
+
|
|
621
|
+
---
|
|
622
|
+
|
|
623
|
+
##### `isProject` <a name="isProject" id="@cdktn/provider-project.CdktnProviderProject.isProject"></a>
|
|
624
|
+
|
|
625
|
+
```typescript
|
|
626
|
+
import { CdktnProviderProject } from '@cdktn/provider-project'
|
|
627
|
+
|
|
628
|
+
CdktnProviderProject.isProject(x: any)
|
|
629
|
+
```
|
|
630
|
+
|
|
631
|
+
Test whether the given construct is a project.
|
|
632
|
+
|
|
633
|
+
###### `x`<sup>Required</sup> <a name="x" id="@cdktn/provider-project.CdktnProviderProject.isProject.parameter.x"></a>
|
|
634
|
+
|
|
635
|
+
- *Type:* any
|
|
636
|
+
|
|
637
|
+
---
|
|
638
|
+
|
|
639
|
+
##### `of` <a name="of" id="@cdktn/provider-project.CdktnProviderProject.of"></a>
|
|
640
|
+
|
|
641
|
+
```typescript
|
|
642
|
+
import { CdktnProviderProject } from '@cdktn/provider-project'
|
|
643
|
+
|
|
644
|
+
CdktnProviderProject.of(construct: IConstruct)
|
|
645
|
+
```
|
|
646
|
+
|
|
647
|
+
Find the closest ancestor project for given construct.
|
|
648
|
+
|
|
649
|
+
When given a project, this it the project itself.
|
|
650
|
+
|
|
651
|
+
###### `construct`<sup>Required</sup> <a name="construct" id="@cdktn/provider-project.CdktnProviderProject.of.parameter.construct"></a>
|
|
652
|
+
|
|
653
|
+
- *Type:* constructs.IConstruct
|
|
654
|
+
|
|
655
|
+
---
|
|
656
|
+
|
|
657
|
+
#### Properties <a name="Properties" id="Properties"></a>
|
|
658
|
+
|
|
659
|
+
| **Name** | **Type** | **Description** |
|
|
660
|
+
| --- | --- | --- |
|
|
661
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
|
|
662
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.buildTask">buildTask</a></code> | <code>projen.Task</code> | *No description.* |
|
|
663
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.commitGenerated">commitGenerated</a></code> | <code>boolean</code> | Whether to commit the managed files by default. |
|
|
664
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.compileTask">compileTask</a></code> | <code>projen.Task</code> | *No description.* |
|
|
665
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.components">components</a></code> | <code>projen.Component[]</code> | Returns all the components within this project. |
|
|
666
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.deps">deps</a></code> | <code>projen.Dependencies</code> | Project dependencies. |
|
|
667
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.ejected">ejected</a></code> | <code>boolean</code> | Whether or not the project is being ejected. |
|
|
668
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.files">files</a></code> | <code>projen.FileBase[]</code> | All files in this project. |
|
|
669
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.gitattributes">gitattributes</a></code> | <code>projen.GitAttributesFile</code> | The .gitattributes file for this repository. |
|
|
670
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.gitignore">gitignore</a></code> | <code>projen.IgnoreFile</code> | .gitignore. |
|
|
671
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.logger">logger</a></code> | <code>projen.Logger</code> | Logging utilities. |
|
|
672
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.name">name</a></code> | <code>string</code> | Project name. |
|
|
673
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.outdir">outdir</a></code> | <code>string</code> | Absolute output directory of this project. |
|
|
674
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.packageTask">packageTask</a></code> | <code>projen.Task</code> | *No description.* |
|
|
675
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.postCompileTask">postCompileTask</a></code> | <code>projen.Task</code> | *No description.* |
|
|
676
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.preCompileTask">preCompileTask</a></code> | <code>projen.Task</code> | *No description.* |
|
|
677
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.projectBuild">projectBuild</a></code> | <code>projen.ProjectBuild</code> | Manages the build process of the project. |
|
|
678
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.projenCommand">projenCommand</a></code> | <code>string</code> | The command to use in order to run the projen CLI. |
|
|
679
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.root">root</a></code> | <code>projen.Project</code> | The root project. |
|
|
680
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.subprojects">subprojects</a></code> | <code>projen.Project[]</code> | Returns all the subprojects within this project. |
|
|
681
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.tasks">tasks</a></code> | <code>projen.Tasks</code> | Project tasks. |
|
|
682
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.testTask">testTask</a></code> | <code>projen.Task</code> | *No description.* |
|
|
683
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.defaultTask">defaultTask</a></code> | <code>projen.Task</code> | This is the "default" task, the one that executes "projen". |
|
|
684
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.initProject">initProject</a></code> | <code>projen.InitProject</code> | The options used when this project is bootstrapped via `projen new`. |
|
|
685
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.parent">parent</a></code> | <code>projen.Project</code> | A parent project. |
|
|
686
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.projectType">projectType</a></code> | <code>projen.ProjectType</code> | *No description.* |
|
|
687
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.autoApprove">autoApprove</a></code> | <code>projen.github.AutoApprove</code> | Auto approve set up for this project. |
|
|
688
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.devContainer">devContainer</a></code> | <code>projen.vscode.DevContainer</code> | Access for .devcontainer.json (used for GitHub Codespaces). |
|
|
689
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.github">github</a></code> | <code>projen.github.GitHub</code> | Access all github components. |
|
|
690
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.gitpod">gitpod</a></code> | <code>projen.Gitpod</code> | Access for Gitpod. |
|
|
691
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.vscode">vscode</a></code> | <code>projen.vscode.VsCode</code> | Access all VSCode components. |
|
|
692
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.allowLibraryDependencies">allowLibraryDependencies</a></code> | <code>boolean</code> | *No description.* |
|
|
693
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.artifactsDirectory">artifactsDirectory</a></code> | <code>string</code> | The build output directory. |
|
|
694
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.artifactsJavascriptDirectory">artifactsJavascriptDirectory</a></code> | <code>string</code> | The location of the npm tarball after build (`${artifactsDirectory}/js`). |
|
|
695
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.bundler">bundler</a></code> | <code>projen.javascript.Bundler</code> | *No description.* |
|
|
696
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.entrypoint">entrypoint</a></code> | <code>string</code> | *No description.* |
|
|
697
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.manifest">manifest</a></code> | <code>any</code> | *No description.* |
|
|
698
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.npmrc">npmrc</a></code> | <code>projen.javascript.NpmConfig</code> | The .npmrc file. |
|
|
699
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.package">package</a></code> | <code>projen.javascript.NodePackage</code> | API for managing the node package. |
|
|
700
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.packageManager">packageManager</a></code> | <code>projen.javascript.NodePackageManager</code> | The package manager to use. |
|
|
701
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.runScriptCommand">runScriptCommand</a></code> | <code>string</code> | The command to use to run scripts (e.g. `yarn run` or `npm run` depends on the package manager). |
|
|
702
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.autoMerge">autoMerge</a></code> | <code>projen.github.AutoMerge</code> | Component that sets up mergify for merging approved pull requests. |
|
|
703
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.buildWorkflow">buildWorkflow</a></code> | <code>projen.build.BuildWorkflow</code> | The PR build GitHub workflow. |
|
|
704
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.buildWorkflowJobId">buildWorkflowJobId</a></code> | <code>string</code> | The job ID of the build workflow. |
|
|
705
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.jest">jest</a></code> | <code>projen.javascript.Jest</code> | The Jest configuration (if enabled). |
|
|
706
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.maxNodeVersion">maxNodeVersion</a></code> | <code>string</code> | Maximum node version required by this package. |
|
|
707
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.minNodeVersion">minNodeVersion</a></code> | <code>string</code> | Minimum node.js version required by this package. |
|
|
708
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.npmignore">npmignore</a></code> | <code>projen.IgnoreFile</code> | The .npmignore file. |
|
|
709
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.prettier">prettier</a></code> | <code>projen.javascript.Prettier</code> | *No description.* |
|
|
710
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.publisher">publisher</a></code> | <code>projen.release.Publisher</code> | Package publisher. |
|
|
711
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.release">release</a></code> | <code>projen.release.Release</code> | Release management. |
|
|
712
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.upgradeWorkflow">upgradeWorkflow</a></code> | <code>projen.javascript.UpgradeDependencies</code> | The upgrade workflow. |
|
|
713
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.docsDirectory">docsDirectory</a></code> | <code>string</code> | *No description.* |
|
|
714
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.libdir">libdir</a></code> | <code>string</code> | The directory in which compiled .js files reside. |
|
|
715
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.srcdir">srcdir</a></code> | <code>string</code> | The directory in which the .ts sources reside. |
|
|
716
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.testdir">testdir</a></code> | <code>string</code> | The directory in which tests reside. |
|
|
717
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.tsconfigDev">tsconfigDev</a></code> | <code>projen.javascript.TypescriptConfig</code> | A typescript configuration file which covers all files (sources, tests, projen). |
|
|
718
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.watchTask">watchTask</a></code> | <code>projen.Task</code> | The "watch" task. |
|
|
719
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.docgen">docgen</a></code> | <code>boolean</code> | *No description.* |
|
|
720
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.eslint">eslint</a></code> | <code>projen.javascript.Eslint</code> | *No description.* |
|
|
721
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.tsconfig">tsconfig</a></code> | <code>projen.javascript.TypescriptConfig</code> | *No description.* |
|
|
722
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.tsconfigEslint">tsconfigEslint</a></code> | <code>projen.javascript.TypescriptConfig</code> | *No description.* |
|
|
723
|
+
|
|
724
|
+
---
|
|
725
|
+
|
|
726
|
+
##### `node`<sup>Required</sup> <a name="node" id="@cdktn/provider-project.CdktnProviderProject.property.node"></a>
|
|
727
|
+
|
|
728
|
+
```typescript
|
|
729
|
+
public readonly node: Node;
|
|
730
|
+
```
|
|
731
|
+
|
|
732
|
+
- *Type:* constructs.Node
|
|
733
|
+
|
|
734
|
+
The tree node.
|
|
735
|
+
|
|
736
|
+
---
|
|
737
|
+
|
|
738
|
+
##### `buildTask`<sup>Required</sup> <a name="buildTask" id="@cdktn/provider-project.CdktnProviderProject.property.buildTask"></a>
|
|
739
|
+
|
|
740
|
+
```typescript
|
|
741
|
+
public readonly buildTask: Task;
|
|
742
|
+
```
|
|
743
|
+
|
|
744
|
+
- *Type:* projen.Task
|
|
745
|
+
|
|
746
|
+
---
|
|
747
|
+
|
|
748
|
+
##### `commitGenerated`<sup>Required</sup> <a name="commitGenerated" id="@cdktn/provider-project.CdktnProviderProject.property.commitGenerated"></a>
|
|
749
|
+
|
|
750
|
+
```typescript
|
|
751
|
+
public readonly commitGenerated: boolean;
|
|
752
|
+
```
|
|
753
|
+
|
|
754
|
+
- *Type:* boolean
|
|
755
|
+
|
|
756
|
+
Whether to commit the managed files by default.
|
|
757
|
+
|
|
758
|
+
---
|
|
759
|
+
|
|
760
|
+
##### `compileTask`<sup>Required</sup> <a name="compileTask" id="@cdktn/provider-project.CdktnProviderProject.property.compileTask"></a>
|
|
761
|
+
|
|
762
|
+
```typescript
|
|
763
|
+
public readonly compileTask: Task;
|
|
764
|
+
```
|
|
765
|
+
|
|
766
|
+
- *Type:* projen.Task
|
|
767
|
+
|
|
768
|
+
---
|
|
769
|
+
|
|
770
|
+
##### `components`<sup>Required</sup> <a name="components" id="@cdktn/provider-project.CdktnProviderProject.property.components"></a>
|
|
771
|
+
|
|
772
|
+
```typescript
|
|
773
|
+
public readonly components: Component[];
|
|
774
|
+
```
|
|
775
|
+
|
|
776
|
+
- *Type:* projen.Component[]
|
|
777
|
+
|
|
778
|
+
Returns all the components within this project.
|
|
779
|
+
|
|
780
|
+
---
|
|
781
|
+
|
|
782
|
+
##### `deps`<sup>Required</sup> <a name="deps" id="@cdktn/provider-project.CdktnProviderProject.property.deps"></a>
|
|
783
|
+
|
|
784
|
+
```typescript
|
|
785
|
+
public readonly deps: Dependencies;
|
|
786
|
+
```
|
|
787
|
+
|
|
788
|
+
- *Type:* projen.Dependencies
|
|
789
|
+
|
|
790
|
+
Project dependencies.
|
|
791
|
+
|
|
792
|
+
---
|
|
793
|
+
|
|
794
|
+
##### `ejected`<sup>Required</sup> <a name="ejected" id="@cdktn/provider-project.CdktnProviderProject.property.ejected"></a>
|
|
795
|
+
|
|
796
|
+
```typescript
|
|
797
|
+
public readonly ejected: boolean;
|
|
798
|
+
```
|
|
799
|
+
|
|
800
|
+
- *Type:* boolean
|
|
801
|
+
|
|
802
|
+
Whether or not the project is being ejected.
|
|
803
|
+
|
|
804
|
+
---
|
|
805
|
+
|
|
806
|
+
##### `files`<sup>Required</sup> <a name="files" id="@cdktn/provider-project.CdktnProviderProject.property.files"></a>
|
|
807
|
+
|
|
808
|
+
```typescript
|
|
809
|
+
public readonly files: FileBase[];
|
|
810
|
+
```
|
|
811
|
+
|
|
812
|
+
- *Type:* projen.FileBase[]
|
|
813
|
+
|
|
814
|
+
All files in this project.
|
|
815
|
+
|
|
816
|
+
---
|
|
817
|
+
|
|
818
|
+
##### `gitattributes`<sup>Required</sup> <a name="gitattributes" id="@cdktn/provider-project.CdktnProviderProject.property.gitattributes"></a>
|
|
819
|
+
|
|
820
|
+
```typescript
|
|
821
|
+
public readonly gitattributes: GitAttributesFile;
|
|
822
|
+
```
|
|
823
|
+
|
|
824
|
+
- *Type:* projen.GitAttributesFile
|
|
825
|
+
|
|
826
|
+
The .gitattributes file for this repository.
|
|
827
|
+
|
|
828
|
+
---
|
|
829
|
+
|
|
830
|
+
##### `gitignore`<sup>Required</sup> <a name="gitignore" id="@cdktn/provider-project.CdktnProviderProject.property.gitignore"></a>
|
|
831
|
+
|
|
832
|
+
```typescript
|
|
833
|
+
public readonly gitignore: IgnoreFile;
|
|
834
|
+
```
|
|
835
|
+
|
|
836
|
+
- *Type:* projen.IgnoreFile
|
|
837
|
+
|
|
838
|
+
.gitignore.
|
|
839
|
+
|
|
840
|
+
---
|
|
841
|
+
|
|
842
|
+
##### `logger`<sup>Required</sup> <a name="logger" id="@cdktn/provider-project.CdktnProviderProject.property.logger"></a>
|
|
843
|
+
|
|
844
|
+
```typescript
|
|
845
|
+
public readonly logger: Logger;
|
|
846
|
+
```
|
|
847
|
+
|
|
848
|
+
- *Type:* projen.Logger
|
|
849
|
+
|
|
850
|
+
Logging utilities.
|
|
851
|
+
|
|
852
|
+
---
|
|
853
|
+
|
|
854
|
+
##### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProject.property.name"></a>
|
|
855
|
+
|
|
856
|
+
```typescript
|
|
857
|
+
public readonly name: string;
|
|
858
|
+
```
|
|
859
|
+
|
|
860
|
+
- *Type:* string
|
|
861
|
+
|
|
862
|
+
Project name.
|
|
863
|
+
|
|
864
|
+
---
|
|
865
|
+
|
|
866
|
+
##### `outdir`<sup>Required</sup> <a name="outdir" id="@cdktn/provider-project.CdktnProviderProject.property.outdir"></a>
|
|
867
|
+
|
|
868
|
+
```typescript
|
|
869
|
+
public readonly outdir: string;
|
|
870
|
+
```
|
|
871
|
+
|
|
872
|
+
- *Type:* string
|
|
873
|
+
|
|
874
|
+
Absolute output directory of this project.
|
|
875
|
+
|
|
876
|
+
---
|
|
877
|
+
|
|
878
|
+
##### `packageTask`<sup>Required</sup> <a name="packageTask" id="@cdktn/provider-project.CdktnProviderProject.property.packageTask"></a>
|
|
879
|
+
|
|
880
|
+
```typescript
|
|
881
|
+
public readonly packageTask: Task;
|
|
882
|
+
```
|
|
883
|
+
|
|
884
|
+
- *Type:* projen.Task
|
|
885
|
+
|
|
886
|
+
---
|
|
887
|
+
|
|
888
|
+
##### `postCompileTask`<sup>Required</sup> <a name="postCompileTask" id="@cdktn/provider-project.CdktnProviderProject.property.postCompileTask"></a>
|
|
889
|
+
|
|
890
|
+
```typescript
|
|
891
|
+
public readonly postCompileTask: Task;
|
|
892
|
+
```
|
|
893
|
+
|
|
894
|
+
- *Type:* projen.Task
|
|
895
|
+
|
|
896
|
+
---
|
|
897
|
+
|
|
898
|
+
##### `preCompileTask`<sup>Required</sup> <a name="preCompileTask" id="@cdktn/provider-project.CdktnProviderProject.property.preCompileTask"></a>
|
|
899
|
+
|
|
900
|
+
```typescript
|
|
901
|
+
public readonly preCompileTask: Task;
|
|
902
|
+
```
|
|
903
|
+
|
|
904
|
+
- *Type:* projen.Task
|
|
905
|
+
|
|
906
|
+
---
|
|
907
|
+
|
|
908
|
+
##### `projectBuild`<sup>Required</sup> <a name="projectBuild" id="@cdktn/provider-project.CdktnProviderProject.property.projectBuild"></a>
|
|
909
|
+
|
|
910
|
+
```typescript
|
|
911
|
+
public readonly projectBuild: ProjectBuild;
|
|
912
|
+
```
|
|
913
|
+
|
|
914
|
+
- *Type:* projen.ProjectBuild
|
|
915
|
+
|
|
916
|
+
Manages the build process of the project.
|
|
917
|
+
|
|
918
|
+
---
|
|
919
|
+
|
|
920
|
+
##### `projenCommand`<sup>Required</sup> <a name="projenCommand" id="@cdktn/provider-project.CdktnProviderProject.property.projenCommand"></a>
|
|
921
|
+
|
|
922
|
+
```typescript
|
|
923
|
+
public readonly projenCommand: string;
|
|
924
|
+
```
|
|
925
|
+
|
|
926
|
+
- *Type:* string
|
|
927
|
+
|
|
928
|
+
The command to use in order to run the projen CLI.
|
|
929
|
+
|
|
930
|
+
---
|
|
931
|
+
|
|
932
|
+
##### `root`<sup>Required</sup> <a name="root" id="@cdktn/provider-project.CdktnProviderProject.property.root"></a>
|
|
933
|
+
|
|
934
|
+
```typescript
|
|
935
|
+
public readonly root: Project;
|
|
936
|
+
```
|
|
937
|
+
|
|
938
|
+
- *Type:* projen.Project
|
|
939
|
+
|
|
940
|
+
The root project.
|
|
941
|
+
|
|
942
|
+
---
|
|
943
|
+
|
|
944
|
+
##### `subprojects`<sup>Required</sup> <a name="subprojects" id="@cdktn/provider-project.CdktnProviderProject.property.subprojects"></a>
|
|
945
|
+
|
|
946
|
+
```typescript
|
|
947
|
+
public readonly subprojects: Project[];
|
|
948
|
+
```
|
|
949
|
+
|
|
950
|
+
- *Type:* projen.Project[]
|
|
951
|
+
|
|
952
|
+
Returns all the subprojects within this project.
|
|
953
|
+
|
|
954
|
+
---
|
|
955
|
+
|
|
956
|
+
##### `tasks`<sup>Required</sup> <a name="tasks" id="@cdktn/provider-project.CdktnProviderProject.property.tasks"></a>
|
|
957
|
+
|
|
958
|
+
```typescript
|
|
959
|
+
public readonly tasks: Tasks;
|
|
960
|
+
```
|
|
961
|
+
|
|
962
|
+
- *Type:* projen.Tasks
|
|
963
|
+
|
|
964
|
+
Project tasks.
|
|
965
|
+
|
|
966
|
+
---
|
|
967
|
+
|
|
968
|
+
##### `testTask`<sup>Required</sup> <a name="testTask" id="@cdktn/provider-project.CdktnProviderProject.property.testTask"></a>
|
|
969
|
+
|
|
970
|
+
```typescript
|
|
971
|
+
public readonly testTask: Task;
|
|
972
|
+
```
|
|
973
|
+
|
|
974
|
+
- *Type:* projen.Task
|
|
975
|
+
|
|
976
|
+
---
|
|
977
|
+
|
|
978
|
+
##### `defaultTask`<sup>Optional</sup> <a name="defaultTask" id="@cdktn/provider-project.CdktnProviderProject.property.defaultTask"></a>
|
|
979
|
+
|
|
980
|
+
```typescript
|
|
981
|
+
public readonly defaultTask: Task;
|
|
982
|
+
```
|
|
983
|
+
|
|
984
|
+
- *Type:* projen.Task
|
|
985
|
+
|
|
986
|
+
This is the "default" task, the one that executes "projen".
|
|
987
|
+
|
|
988
|
+
Undefined if
|
|
989
|
+
the project is being ejected.
|
|
990
|
+
|
|
991
|
+
---
|
|
992
|
+
|
|
993
|
+
##### `initProject`<sup>Optional</sup> <a name="initProject" id="@cdktn/provider-project.CdktnProviderProject.property.initProject"></a>
|
|
994
|
+
|
|
995
|
+
```typescript
|
|
996
|
+
public readonly initProject: InitProject;
|
|
997
|
+
```
|
|
998
|
+
|
|
999
|
+
- *Type:* projen.InitProject
|
|
1000
|
+
|
|
1001
|
+
The options used when this project is bootstrapped via `projen new`.
|
|
1002
|
+
|
|
1003
|
+
It
|
|
1004
|
+
includes the original set of options passed to the CLI and also the JSII
|
|
1005
|
+
FQN of the project type.
|
|
1006
|
+
|
|
1007
|
+
---
|
|
1008
|
+
|
|
1009
|
+
##### `parent`<sup>Optional</sup> <a name="parent" id="@cdktn/provider-project.CdktnProviderProject.property.parent"></a>
|
|
1010
|
+
|
|
1011
|
+
```typescript
|
|
1012
|
+
public readonly parent: Project;
|
|
1013
|
+
```
|
|
1014
|
+
|
|
1015
|
+
- *Type:* projen.Project
|
|
1016
|
+
|
|
1017
|
+
A parent project.
|
|
1018
|
+
|
|
1019
|
+
If undefined, this is the root project.
|
|
1020
|
+
|
|
1021
|
+
---
|
|
1022
|
+
|
|
1023
|
+
##### `projectType`<sup>Required</sup> <a name="projectType" id="@cdktn/provider-project.CdktnProviderProject.property.projectType"></a>
|
|
1024
|
+
|
|
1025
|
+
```typescript
|
|
1026
|
+
public readonly projectType: ProjectType;
|
|
1027
|
+
```
|
|
1028
|
+
|
|
1029
|
+
- *Type:* projen.ProjectType
|
|
1030
|
+
|
|
1031
|
+
---
|
|
1032
|
+
|
|
1033
|
+
##### `autoApprove`<sup>Optional</sup> <a name="autoApprove" id="@cdktn/provider-project.CdktnProviderProject.property.autoApprove"></a>
|
|
1034
|
+
|
|
1035
|
+
```typescript
|
|
1036
|
+
public readonly autoApprove: AutoApprove;
|
|
1037
|
+
```
|
|
1038
|
+
|
|
1039
|
+
- *Type:* projen.github.AutoApprove
|
|
1040
|
+
|
|
1041
|
+
Auto approve set up for this project.
|
|
1042
|
+
|
|
1043
|
+
---
|
|
1044
|
+
|
|
1045
|
+
##### `devContainer`<sup>Optional</sup> <a name="devContainer" id="@cdktn/provider-project.CdktnProviderProject.property.devContainer"></a>
|
|
1046
|
+
|
|
1047
|
+
```typescript
|
|
1048
|
+
public readonly devContainer: DevContainer;
|
|
1049
|
+
```
|
|
1050
|
+
|
|
1051
|
+
- *Type:* projen.vscode.DevContainer
|
|
1052
|
+
|
|
1053
|
+
Access for .devcontainer.json (used for GitHub Codespaces).
|
|
1054
|
+
|
|
1055
|
+
This will be `undefined` if devContainer boolean is false
|
|
1056
|
+
|
|
1057
|
+
---
|
|
1058
|
+
|
|
1059
|
+
##### `github`<sup>Optional</sup> <a name="github" id="@cdktn/provider-project.CdktnProviderProject.property.github"></a>
|
|
1060
|
+
|
|
1061
|
+
```typescript
|
|
1062
|
+
public readonly github: GitHub;
|
|
1063
|
+
```
|
|
1064
|
+
|
|
1065
|
+
- *Type:* projen.github.GitHub
|
|
1066
|
+
|
|
1067
|
+
Access all github components.
|
|
1068
|
+
|
|
1069
|
+
This will be `undefined` for subprojects.
|
|
1070
|
+
|
|
1071
|
+
---
|
|
1072
|
+
|
|
1073
|
+
##### `gitpod`<sup>Optional</sup> <a name="gitpod" id="@cdktn/provider-project.CdktnProviderProject.property.gitpod"></a>
|
|
1074
|
+
|
|
1075
|
+
```typescript
|
|
1076
|
+
public readonly gitpod: Gitpod;
|
|
1077
|
+
```
|
|
1078
|
+
|
|
1079
|
+
- *Type:* projen.Gitpod
|
|
1080
|
+
|
|
1081
|
+
Access for Gitpod.
|
|
1082
|
+
|
|
1083
|
+
This will be `undefined` if gitpod boolean is false
|
|
1084
|
+
|
|
1085
|
+
---
|
|
1086
|
+
|
|
1087
|
+
##### `vscode`<sup>Optional</sup> <a name="vscode" id="@cdktn/provider-project.CdktnProviderProject.property.vscode"></a>
|
|
1088
|
+
|
|
1089
|
+
```typescript
|
|
1090
|
+
public readonly vscode: VsCode;
|
|
1091
|
+
```
|
|
1092
|
+
|
|
1093
|
+
- *Type:* projen.vscode.VsCode
|
|
1094
|
+
|
|
1095
|
+
Access all VSCode components.
|
|
1096
|
+
|
|
1097
|
+
This will be `undefined` for subprojects.
|
|
1098
|
+
|
|
1099
|
+
---
|
|
1100
|
+
|
|
1101
|
+
##### ~~`allowLibraryDependencies`~~<sup>Required</sup> <a name="allowLibraryDependencies" id="@cdktn/provider-project.CdktnProviderProject.property.allowLibraryDependencies"></a>
|
|
1102
|
+
|
|
1103
|
+
- *Deprecated:* use `package.allowLibraryDependencies`
|
|
1104
|
+
|
|
1105
|
+
```typescript
|
|
1106
|
+
public readonly allowLibraryDependencies: boolean;
|
|
1107
|
+
```
|
|
1108
|
+
|
|
1109
|
+
- *Type:* boolean
|
|
1110
|
+
|
|
1111
|
+
---
|
|
1112
|
+
|
|
1113
|
+
##### `artifactsDirectory`<sup>Required</sup> <a name="artifactsDirectory" id="@cdktn/provider-project.CdktnProviderProject.property.artifactsDirectory"></a>
|
|
1114
|
+
|
|
1115
|
+
```typescript
|
|
1116
|
+
public readonly artifactsDirectory: string;
|
|
1117
|
+
```
|
|
1118
|
+
|
|
1119
|
+
- *Type:* string
|
|
1120
|
+
|
|
1121
|
+
The build output directory.
|
|
1122
|
+
|
|
1123
|
+
An npm tarball will be created under the `js`
|
|
1124
|
+
subdirectory. For example, if this is set to `dist` (the default), the npm
|
|
1125
|
+
tarball will be placed under `dist/js/boom-boom-1.2.3.tg`.
|
|
1126
|
+
|
|
1127
|
+
---
|
|
1128
|
+
|
|
1129
|
+
##### `artifactsJavascriptDirectory`<sup>Required</sup> <a name="artifactsJavascriptDirectory" id="@cdktn/provider-project.CdktnProviderProject.property.artifactsJavascriptDirectory"></a>
|
|
1130
|
+
|
|
1131
|
+
```typescript
|
|
1132
|
+
public readonly artifactsJavascriptDirectory: string;
|
|
1133
|
+
```
|
|
1134
|
+
|
|
1135
|
+
- *Type:* string
|
|
1136
|
+
|
|
1137
|
+
The location of the npm tarball after build (`${artifactsDirectory}/js`).
|
|
1138
|
+
|
|
1139
|
+
---
|
|
1140
|
+
|
|
1141
|
+
##### `bundler`<sup>Required</sup> <a name="bundler" id="@cdktn/provider-project.CdktnProviderProject.property.bundler"></a>
|
|
1142
|
+
|
|
1143
|
+
```typescript
|
|
1144
|
+
public readonly bundler: Bundler;
|
|
1145
|
+
```
|
|
1146
|
+
|
|
1147
|
+
- *Type:* projen.javascript.Bundler
|
|
1148
|
+
|
|
1149
|
+
---
|
|
1150
|
+
|
|
1151
|
+
##### ~~`entrypoint`~~<sup>Required</sup> <a name="entrypoint" id="@cdktn/provider-project.CdktnProviderProject.property.entrypoint"></a>
|
|
1152
|
+
|
|
1153
|
+
- *Deprecated:* use `package.entrypoint`
|
|
1154
|
+
|
|
1155
|
+
```typescript
|
|
1156
|
+
public readonly entrypoint: string;
|
|
1157
|
+
```
|
|
1158
|
+
|
|
1159
|
+
- *Type:* string
|
|
1160
|
+
|
|
1161
|
+
---
|
|
1162
|
+
|
|
1163
|
+
##### ~~`manifest`~~<sup>Required</sup> <a name="manifest" id="@cdktn/provider-project.CdktnProviderProject.property.manifest"></a>
|
|
1164
|
+
|
|
1165
|
+
- *Deprecated:* use `package.addField(x, y)`
|
|
1166
|
+
|
|
1167
|
+
```typescript
|
|
1168
|
+
public readonly manifest: any;
|
|
1169
|
+
```
|
|
1170
|
+
|
|
1171
|
+
- *Type:* any
|
|
1172
|
+
|
|
1173
|
+
---
|
|
1174
|
+
|
|
1175
|
+
##### `npmrc`<sup>Required</sup> <a name="npmrc" id="@cdktn/provider-project.CdktnProviderProject.property.npmrc"></a>
|
|
1176
|
+
|
|
1177
|
+
```typescript
|
|
1178
|
+
public readonly npmrc: NpmConfig;
|
|
1179
|
+
```
|
|
1180
|
+
|
|
1181
|
+
- *Type:* projen.javascript.NpmConfig
|
|
1182
|
+
|
|
1183
|
+
The .npmrc file.
|
|
1184
|
+
|
|
1185
|
+
---
|
|
1186
|
+
|
|
1187
|
+
##### `package`<sup>Required</sup> <a name="package" id="@cdktn/provider-project.CdktnProviderProject.property.package"></a>
|
|
1188
|
+
|
|
1189
|
+
```typescript
|
|
1190
|
+
public readonly package: NodePackage;
|
|
1191
|
+
```
|
|
1192
|
+
|
|
1193
|
+
- *Type:* projen.javascript.NodePackage
|
|
1194
|
+
|
|
1195
|
+
API for managing the node package.
|
|
1196
|
+
|
|
1197
|
+
---
|
|
1198
|
+
|
|
1199
|
+
##### ~~`packageManager`~~<sup>Required</sup> <a name="packageManager" id="@cdktn/provider-project.CdktnProviderProject.property.packageManager"></a>
|
|
1200
|
+
|
|
1201
|
+
- *Deprecated:* use `package.packageManager`
|
|
1202
|
+
|
|
1203
|
+
```typescript
|
|
1204
|
+
public readonly packageManager: NodePackageManager;
|
|
1205
|
+
```
|
|
1206
|
+
|
|
1207
|
+
- *Type:* projen.javascript.NodePackageManager
|
|
1208
|
+
|
|
1209
|
+
The package manager to use.
|
|
1210
|
+
|
|
1211
|
+
---
|
|
1212
|
+
|
|
1213
|
+
##### `runScriptCommand`<sup>Required</sup> <a name="runScriptCommand" id="@cdktn/provider-project.CdktnProviderProject.property.runScriptCommand"></a>
|
|
1214
|
+
|
|
1215
|
+
```typescript
|
|
1216
|
+
public readonly runScriptCommand: string;
|
|
1217
|
+
```
|
|
1218
|
+
|
|
1219
|
+
- *Type:* string
|
|
1220
|
+
|
|
1221
|
+
The command to use to run scripts (e.g. `yarn run` or `npm run` depends on the package manager).
|
|
1222
|
+
|
|
1223
|
+
---
|
|
1224
|
+
|
|
1225
|
+
##### `autoMerge`<sup>Optional</sup> <a name="autoMerge" id="@cdktn/provider-project.CdktnProviderProject.property.autoMerge"></a>
|
|
1226
|
+
|
|
1227
|
+
```typescript
|
|
1228
|
+
public readonly autoMerge: AutoMerge;
|
|
1229
|
+
```
|
|
1230
|
+
|
|
1231
|
+
- *Type:* projen.github.AutoMerge
|
|
1232
|
+
|
|
1233
|
+
Component that sets up mergify for merging approved pull requests.
|
|
1234
|
+
|
|
1235
|
+
---
|
|
1236
|
+
|
|
1237
|
+
##### `buildWorkflow`<sup>Optional</sup> <a name="buildWorkflow" id="@cdktn/provider-project.CdktnProviderProject.property.buildWorkflow"></a>
|
|
1238
|
+
|
|
1239
|
+
```typescript
|
|
1240
|
+
public readonly buildWorkflow: BuildWorkflow;
|
|
1241
|
+
```
|
|
1242
|
+
|
|
1243
|
+
- *Type:* projen.build.BuildWorkflow
|
|
1244
|
+
|
|
1245
|
+
The PR build GitHub workflow.
|
|
1246
|
+
|
|
1247
|
+
`undefined` if `buildWorkflow` is disabled.
|
|
1248
|
+
|
|
1249
|
+
---
|
|
1250
|
+
|
|
1251
|
+
##### `buildWorkflowJobId`<sup>Optional</sup> <a name="buildWorkflowJobId" id="@cdktn/provider-project.CdktnProviderProject.property.buildWorkflowJobId"></a>
|
|
1252
|
+
|
|
1253
|
+
```typescript
|
|
1254
|
+
public readonly buildWorkflowJobId: string;
|
|
1255
|
+
```
|
|
1256
|
+
|
|
1257
|
+
- *Type:* string
|
|
1258
|
+
|
|
1259
|
+
The job ID of the build workflow.
|
|
1260
|
+
|
|
1261
|
+
---
|
|
1262
|
+
|
|
1263
|
+
##### `jest`<sup>Optional</sup> <a name="jest" id="@cdktn/provider-project.CdktnProviderProject.property.jest"></a>
|
|
1264
|
+
|
|
1265
|
+
```typescript
|
|
1266
|
+
public readonly jest: Jest;
|
|
1267
|
+
```
|
|
1268
|
+
|
|
1269
|
+
- *Type:* projen.javascript.Jest
|
|
1270
|
+
|
|
1271
|
+
The Jest configuration (if enabled).
|
|
1272
|
+
|
|
1273
|
+
---
|
|
1274
|
+
|
|
1275
|
+
##### `maxNodeVersion`<sup>Optional</sup> <a name="maxNodeVersion" id="@cdktn/provider-project.CdktnProviderProject.property.maxNodeVersion"></a>
|
|
1276
|
+
|
|
1277
|
+
```typescript
|
|
1278
|
+
public readonly maxNodeVersion: string;
|
|
1279
|
+
```
|
|
1280
|
+
|
|
1281
|
+
- *Type:* string
|
|
1282
|
+
|
|
1283
|
+
Maximum node version required by this package.
|
|
1284
|
+
|
|
1285
|
+
---
|
|
1286
|
+
|
|
1287
|
+
##### `minNodeVersion`<sup>Optional</sup> <a name="minNodeVersion" id="@cdktn/provider-project.CdktnProviderProject.property.minNodeVersion"></a>
|
|
1288
|
+
|
|
1289
|
+
```typescript
|
|
1290
|
+
public readonly minNodeVersion: string;
|
|
1291
|
+
```
|
|
1292
|
+
|
|
1293
|
+
- *Type:* string
|
|
1294
|
+
|
|
1295
|
+
Minimum node.js version required by this package.
|
|
1296
|
+
|
|
1297
|
+
---
|
|
1298
|
+
|
|
1299
|
+
##### `npmignore`<sup>Optional</sup> <a name="npmignore" id="@cdktn/provider-project.CdktnProviderProject.property.npmignore"></a>
|
|
1300
|
+
|
|
1301
|
+
```typescript
|
|
1302
|
+
public readonly npmignore: IgnoreFile;
|
|
1303
|
+
```
|
|
1304
|
+
|
|
1305
|
+
- *Type:* projen.IgnoreFile
|
|
1306
|
+
|
|
1307
|
+
The .npmignore file.
|
|
1308
|
+
|
|
1309
|
+
---
|
|
1310
|
+
|
|
1311
|
+
##### `prettier`<sup>Optional</sup> <a name="prettier" id="@cdktn/provider-project.CdktnProviderProject.property.prettier"></a>
|
|
1312
|
+
|
|
1313
|
+
```typescript
|
|
1314
|
+
public readonly prettier: Prettier;
|
|
1315
|
+
```
|
|
1316
|
+
|
|
1317
|
+
- *Type:* projen.javascript.Prettier
|
|
1318
|
+
|
|
1319
|
+
---
|
|
1320
|
+
|
|
1321
|
+
##### ~~`publisher`~~<sup>Optional</sup> <a name="publisher" id="@cdktn/provider-project.CdktnProviderProject.property.publisher"></a>
|
|
1322
|
+
|
|
1323
|
+
- *Deprecated:* use `release.publisher`.
|
|
1324
|
+
|
|
1325
|
+
```typescript
|
|
1326
|
+
public readonly publisher: Publisher;
|
|
1327
|
+
```
|
|
1328
|
+
|
|
1329
|
+
- *Type:* projen.release.Publisher
|
|
1330
|
+
|
|
1331
|
+
Package publisher.
|
|
1332
|
+
|
|
1333
|
+
This will be `undefined` if the project does not have a
|
|
1334
|
+
release workflow.
|
|
1335
|
+
|
|
1336
|
+
---
|
|
1337
|
+
|
|
1338
|
+
##### `release`<sup>Optional</sup> <a name="release" id="@cdktn/provider-project.CdktnProviderProject.property.release"></a>
|
|
1339
|
+
|
|
1340
|
+
```typescript
|
|
1341
|
+
public readonly release: Release;
|
|
1342
|
+
```
|
|
1343
|
+
|
|
1344
|
+
- *Type:* projen.release.Release
|
|
1345
|
+
|
|
1346
|
+
Release management.
|
|
1347
|
+
|
|
1348
|
+
---
|
|
1349
|
+
|
|
1350
|
+
##### `upgradeWorkflow`<sup>Optional</sup> <a name="upgradeWorkflow" id="@cdktn/provider-project.CdktnProviderProject.property.upgradeWorkflow"></a>
|
|
1351
|
+
|
|
1352
|
+
```typescript
|
|
1353
|
+
public readonly upgradeWorkflow: UpgradeDependencies;
|
|
1354
|
+
```
|
|
1355
|
+
|
|
1356
|
+
- *Type:* projen.javascript.UpgradeDependencies
|
|
1357
|
+
|
|
1358
|
+
The upgrade workflow.
|
|
1359
|
+
|
|
1360
|
+
---
|
|
1361
|
+
|
|
1362
|
+
##### `docsDirectory`<sup>Required</sup> <a name="docsDirectory" id="@cdktn/provider-project.CdktnProviderProject.property.docsDirectory"></a>
|
|
1363
|
+
|
|
1364
|
+
```typescript
|
|
1365
|
+
public readonly docsDirectory: string;
|
|
1366
|
+
```
|
|
1367
|
+
|
|
1368
|
+
- *Type:* string
|
|
1369
|
+
|
|
1370
|
+
---
|
|
1371
|
+
|
|
1372
|
+
##### `libdir`<sup>Required</sup> <a name="libdir" id="@cdktn/provider-project.CdktnProviderProject.property.libdir"></a>
|
|
1373
|
+
|
|
1374
|
+
```typescript
|
|
1375
|
+
public readonly libdir: string;
|
|
1376
|
+
```
|
|
1377
|
+
|
|
1378
|
+
- *Type:* string
|
|
1379
|
+
|
|
1380
|
+
The directory in which compiled .js files reside.
|
|
1381
|
+
|
|
1382
|
+
---
|
|
1383
|
+
|
|
1384
|
+
##### `srcdir`<sup>Required</sup> <a name="srcdir" id="@cdktn/provider-project.CdktnProviderProject.property.srcdir"></a>
|
|
1385
|
+
|
|
1386
|
+
```typescript
|
|
1387
|
+
public readonly srcdir: string;
|
|
1388
|
+
```
|
|
1389
|
+
|
|
1390
|
+
- *Type:* string
|
|
1391
|
+
|
|
1392
|
+
The directory in which the .ts sources reside.
|
|
1393
|
+
|
|
1394
|
+
---
|
|
1395
|
+
|
|
1396
|
+
##### `testdir`<sup>Required</sup> <a name="testdir" id="@cdktn/provider-project.CdktnProviderProject.property.testdir"></a>
|
|
1397
|
+
|
|
1398
|
+
```typescript
|
|
1399
|
+
public readonly testdir: string;
|
|
1400
|
+
```
|
|
1401
|
+
|
|
1402
|
+
- *Type:* string
|
|
1403
|
+
|
|
1404
|
+
The directory in which tests reside.
|
|
1405
|
+
|
|
1406
|
+
---
|
|
1407
|
+
|
|
1408
|
+
##### `tsconfigDev`<sup>Required</sup> <a name="tsconfigDev" id="@cdktn/provider-project.CdktnProviderProject.property.tsconfigDev"></a>
|
|
1409
|
+
|
|
1410
|
+
```typescript
|
|
1411
|
+
public readonly tsconfigDev: TypescriptConfig;
|
|
1412
|
+
```
|
|
1413
|
+
|
|
1414
|
+
- *Type:* projen.javascript.TypescriptConfig
|
|
1415
|
+
|
|
1416
|
+
A typescript configuration file which covers all files (sources, tests, projen).
|
|
1417
|
+
|
|
1418
|
+
---
|
|
1419
|
+
|
|
1420
|
+
##### `watchTask`<sup>Required</sup> <a name="watchTask" id="@cdktn/provider-project.CdktnProviderProject.property.watchTask"></a>
|
|
1421
|
+
|
|
1422
|
+
```typescript
|
|
1423
|
+
public readonly watchTask: Task;
|
|
1424
|
+
```
|
|
1425
|
+
|
|
1426
|
+
- *Type:* projen.Task
|
|
1427
|
+
|
|
1428
|
+
The "watch" task.
|
|
1429
|
+
|
|
1430
|
+
---
|
|
1431
|
+
|
|
1432
|
+
##### `docgen`<sup>Optional</sup> <a name="docgen" id="@cdktn/provider-project.CdktnProviderProject.property.docgen"></a>
|
|
1433
|
+
|
|
1434
|
+
```typescript
|
|
1435
|
+
public readonly docgen: boolean;
|
|
1436
|
+
```
|
|
1437
|
+
|
|
1438
|
+
- *Type:* boolean
|
|
1439
|
+
|
|
1440
|
+
---
|
|
1441
|
+
|
|
1442
|
+
##### `eslint`<sup>Optional</sup> <a name="eslint" id="@cdktn/provider-project.CdktnProviderProject.property.eslint"></a>
|
|
1443
|
+
|
|
1444
|
+
```typescript
|
|
1445
|
+
public readonly eslint: Eslint;
|
|
1446
|
+
```
|
|
1447
|
+
|
|
1448
|
+
- *Type:* projen.javascript.Eslint
|
|
1449
|
+
|
|
1450
|
+
---
|
|
1451
|
+
|
|
1452
|
+
##### `tsconfig`<sup>Optional</sup> <a name="tsconfig" id="@cdktn/provider-project.CdktnProviderProject.property.tsconfig"></a>
|
|
1453
|
+
|
|
1454
|
+
```typescript
|
|
1455
|
+
public readonly tsconfig: TypescriptConfig;
|
|
1456
|
+
```
|
|
1457
|
+
|
|
1458
|
+
- *Type:* projen.javascript.TypescriptConfig
|
|
1459
|
+
|
|
1460
|
+
---
|
|
1461
|
+
|
|
1462
|
+
##### `tsconfigEslint`<sup>Optional</sup> <a name="tsconfigEslint" id="@cdktn/provider-project.CdktnProviderProject.property.tsconfigEslint"></a>
|
|
1463
|
+
|
|
1464
|
+
```typescript
|
|
1465
|
+
public readonly tsconfigEslint: TypescriptConfig;
|
|
1466
|
+
```
|
|
1467
|
+
|
|
1468
|
+
- *Type:* projen.javascript.TypescriptConfig
|
|
1469
|
+
|
|
1470
|
+
---
|
|
1471
|
+
|
|
1472
|
+
#### Constants <a name="Constants" id="Constants"></a>
|
|
1473
|
+
|
|
1474
|
+
| **Name** | **Type** | **Description** |
|
|
1475
|
+
| --- | --- | --- |
|
|
1476
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.DEFAULT_TASK">DEFAULT_TASK</a></code> | <code>string</code> | The name of the default task (the task executed when `projen` is run without arguments). |
|
|
1477
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProject.property.DEFAULT_TS_JEST_TRANFORM_PATTERN">DEFAULT_TS_JEST_TRANFORM_PATTERN</a></code> | <code>string</code> | *No description.* |
|
|
1478
|
+
|
|
1479
|
+
---
|
|
1480
|
+
|
|
1481
|
+
##### `DEFAULT_TASK`<sup>Required</sup> <a name="DEFAULT_TASK" id="@cdktn/provider-project.CdktnProviderProject.property.DEFAULT_TASK"></a>
|
|
1482
|
+
|
|
1483
|
+
```typescript
|
|
1484
|
+
public readonly DEFAULT_TASK: string;
|
|
1485
|
+
```
|
|
1486
|
+
|
|
1487
|
+
- *Type:* string
|
|
1488
|
+
|
|
1489
|
+
The name of the default task (the task executed when `projen` is run without arguments).
|
|
1490
|
+
|
|
1491
|
+
Normally
|
|
1492
|
+
this task should synthesize the project files.
|
|
1493
|
+
|
|
1494
|
+
---
|
|
1495
|
+
|
|
1496
|
+
##### `DEFAULT_TS_JEST_TRANFORM_PATTERN`<sup>Required</sup> <a name="DEFAULT_TS_JEST_TRANFORM_PATTERN" id="@cdktn/provider-project.CdktnProviderProject.property.DEFAULT_TS_JEST_TRANFORM_PATTERN"></a>
|
|
1497
|
+
|
|
1498
|
+
```typescript
|
|
1499
|
+
public readonly DEFAULT_TS_JEST_TRANFORM_PATTERN: string;
|
|
1500
|
+
```
|
|
1501
|
+
|
|
1502
|
+
- *Type:* string
|
|
1503
|
+
|
|
1504
|
+
---
|
|
1505
|
+
|
|
1506
|
+
## Structs <a name="Structs" id="Structs"></a>
|
|
1507
|
+
|
|
1508
|
+
### CdktnProviderProjectOptions <a name="CdktnProviderProjectOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions"></a>
|
|
1509
|
+
|
|
1510
|
+
#### Initializer <a name="Initializer" id="@cdktn/provider-project.CdktnProviderProjectOptions.Initializer"></a>
|
|
1511
|
+
|
|
1512
|
+
```typescript
|
|
1513
|
+
import { CdktnProviderProjectOptions } from '@cdktn/provider-project'
|
|
1514
|
+
|
|
1515
|
+
const cdktnProviderProjectOptions: CdktnProviderProjectOptions = { ... }
|
|
1516
|
+
```
|
|
1517
|
+
|
|
1518
|
+
#### Properties <a name="Properties" id="Properties"></a>
|
|
1519
|
+
|
|
1520
|
+
| **Name** | **Type** | **Description** |
|
|
1521
|
+
| --- | --- | --- |
|
|
1522
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.name">name</a></code> | <code>string</code> | This is the name of your project. |
|
|
1523
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.commitGenerated">commitGenerated</a></code> | <code>boolean</code> | Whether to commit the managed files by default. |
|
|
1524
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.gitIgnoreOptions">gitIgnoreOptions</a></code> | <code>projen.IgnoreFileOptions</code> | Configuration options for .gitignore file. |
|
|
1525
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.gitOptions">gitOptions</a></code> | <code>projen.GitOptions</code> | Configuration options for git. |
|
|
1526
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.logging">logging</a></code> | <code>projen.LoggerOptions</code> | Configure logging options such as verbosity. |
|
|
1527
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.outdir">outdir</a></code> | <code>string</code> | The root directory of the project. |
|
|
1528
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.parent">parent</a></code> | <code>projen.Project</code> | The parent project, if this project is part of a bigger project. |
|
|
1529
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenCommand">projenCommand</a></code> | <code>string</code> | The shell command to use in order to run the projen CLI. |
|
|
1530
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJson">projenrcJson</a></code> | <code>boolean</code> | Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation. |
|
|
1531
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJsonOptions">projenrcJsonOptions</a></code> | <code>projen.ProjenrcJsonOptions</code> | Options for .projenrc.json. |
|
|
1532
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.renovatebot">renovatebot</a></code> | <code>boolean</code> | Use renovatebot to handle dependency upgrades. |
|
|
1533
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.renovatebotOptions">renovatebotOptions</a></code> | <code>projen.RenovatebotOptions</code> | Options for renovatebot. |
|
|
1534
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.autoApproveOptions">autoApproveOptions</a></code> | <code>projen.github.AutoApproveOptions</code> | Enable and configure the 'auto approve' workflow. |
|
|
1535
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.autoMerge">autoMerge</a></code> | <code>boolean</code> | Enable automatic merging on GitHub. |
|
|
1536
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.autoMergeOptions">autoMergeOptions</a></code> | <code>projen.github.AutoMergeOptions</code> | Configure options for automatic merging on GitHub. |
|
|
1537
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.clobber">clobber</a></code> | <code>boolean</code> | Add a `clobber` task which resets the repo to origin. |
|
|
1538
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.devContainer">devContainer</a></code> | <code>boolean</code> | Add a VSCode development environment (used for GitHub Codespaces). |
|
|
1539
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.github">github</a></code> | <code>boolean</code> | Enable GitHub integration. |
|
|
1540
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.githubOptions">githubOptions</a></code> | <code>projen.github.GitHubOptions</code> | Options for GitHub integration. |
|
|
1541
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.gitpod">gitpod</a></code> | <code>boolean</code> | Add a Gitpod development environment. |
|
|
1542
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.mergify">mergify</a></code> | <code>boolean</code> | Whether mergify should be enabled on this repository or not. |
|
|
1543
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.mergifyOptions">mergifyOptions</a></code> | <code>projen.github.MergifyOptions</code> | Options for mergify. |
|
|
1544
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projectType">projectType</a></code> | <code>projen.ProjectType</code> | Which type of project this is (library/app). |
|
|
1545
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenCredentials">projenCredentials</a></code> | <code>projen.github.GithubCredentials</code> | Choose a method of providing GitHub API access for projen workflows. |
|
|
1546
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenTokenSecret">projenTokenSecret</a></code> | <code>string</code> | The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
|
|
1547
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.readme">readme</a></code> | <code>projen.SampleReadmeProps</code> | The README setup. |
|
|
1548
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.stale">stale</a></code> | <code>boolean</code> | Auto-close of stale issues and pull request. |
|
|
1549
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.staleOptions">staleOptions</a></code> | <code>projen.github.StaleOptions</code> | Auto-close stale issues and pull requests. |
|
|
1550
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.vscode">vscode</a></code> | <code>boolean</code> | Enable VSCode integration. |
|
|
1551
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.allowLibraryDependencies">allowLibraryDependencies</a></code> | <code>boolean</code> | Allow the project to include `peerDependencies` and `bundledDependencies`. |
|
|
1552
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.authorEmail">authorEmail</a></code> | <code>string</code> | Author's e-mail. |
|
|
1553
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.authorName">authorName</a></code> | <code>string</code> | Author's name. |
|
|
1554
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.authorOrganization">authorOrganization</a></code> | <code>boolean</code> | Is the author an organization. |
|
|
1555
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.authorUrl">authorUrl</a></code> | <code>string</code> | Author's URL / Website. |
|
|
1556
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.autoDetectBin">autoDetectBin</a></code> | <code>boolean</code> | Automatically add all executables under the `bin` directory to your `package.json` file under the `bin` section. |
|
|
1557
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.bin">bin</a></code> | <code>{[ key: string ]: string}</code> | Binary programs vended with your module. |
|
|
1558
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.bugsEmail">bugsEmail</a></code> | <code>string</code> | The email address to which issues should be reported. |
|
|
1559
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.bugsUrl">bugsUrl</a></code> | <code>string</code> | The url to your project's issue tracker. |
|
|
1560
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.bundledDeps">bundledDeps</a></code> | <code>string[]</code> | List of dependencies to bundle into this module. |
|
|
1561
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.codeArtifactOptions">codeArtifactOptions</a></code> | <code>projen.javascript.CodeArtifactOptions</code> | Options for npm packages using AWS CodeArtifact. |
|
|
1562
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.deps">deps</a></code> | <code>string[]</code> | Runtime dependencies of this module. |
|
|
1563
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.description">description</a></code> | <code>string</code> | The description is just a string that helps people understand the purpose of the package. |
|
|
1564
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.devDeps">devDeps</a></code> | <code>string[]</code> | Build dependencies for this module. |
|
|
1565
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.entrypoint">entrypoint</a></code> | <code>string</code> | Module entrypoint (`main` in `package.json`). |
|
|
1566
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.homepage">homepage</a></code> | <code>string</code> | Package's Homepage / Website. |
|
|
1567
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.keywords">keywords</a></code> | <code>string[]</code> | Keywords to include in `package.json`. |
|
|
1568
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.license">license</a></code> | <code>string</code> | License's SPDX identifier. |
|
|
1569
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.licensed">licensed</a></code> | <code>boolean</code> | Indicates if a license should be added. |
|
|
1570
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.maxNodeVersion">maxNodeVersion</a></code> | <code>string</code> | Minimum node.js version to require via `engines` (inclusive). |
|
|
1571
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.minNodeVersion">minNodeVersion</a></code> | <code>string</code> | Minimum Node.js version to require via package.json `engines` (inclusive). |
|
|
1572
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmAccess">npmAccess</a></code> | <code>projen.javascript.NpmAccess</code> | Access level of the npm package. |
|
|
1573
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmProvenance">npmProvenance</a></code> | <code>boolean</code> | Should provenance statements be generated when the package is published. |
|
|
1574
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmRegistry">npmRegistry</a></code> | <code>string</code> | The host name of the npm registry to publish to. |
|
|
1575
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmRegistryUrl">npmRegistryUrl</a></code> | <code>string</code> | The base URL of the npm package registry. |
|
|
1576
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmTokenSecret">npmTokenSecret</a></code> | <code>string</code> | GitHub secret which contains the NPM token to use when publishing packages. |
|
|
1577
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.packageManager">packageManager</a></code> | <code>projen.javascript.NodePackageManager</code> | The Node Package Manager used to execute scripts. |
|
|
1578
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.packageName">packageName</a></code> | <code>string</code> | The "name" in package.json. |
|
|
1579
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.peerDependencyOptions">peerDependencyOptions</a></code> | <code>projen.javascript.PeerDependencyOptions</code> | Options for `peerDeps`. |
|
|
1580
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.peerDeps">peerDeps</a></code> | <code>string[]</code> | Peer dependencies for this module. |
|
|
1581
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.pnpmVersion">pnpmVersion</a></code> | <code>string</code> | The version of PNPM to use if using PNPM as a package manager. |
|
|
1582
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.repository">repository</a></code> | <code>string</code> | The repository is the location where the actual code for your package lives. |
|
|
1583
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.repositoryDirectory">repositoryDirectory</a></code> | <code>string</code> | 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. |
|
|
1584
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.scopedPackagesOptions">scopedPackagesOptions</a></code> | <code>projen.javascript.ScopedPackagesOptions[]</code> | Options for privately hosted scoped packages. |
|
|
1585
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.scripts">scripts</a></code> | <code>{[ key: string ]: string}</code> | npm scripts to include. |
|
|
1586
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.stability">stability</a></code> | <code>string</code> | Package's Stability. |
|
|
1587
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.yarnBerryOptions">yarnBerryOptions</a></code> | <code>projen.javascript.YarnBerryOptions</code> | Options for Yarn Berry. |
|
|
1588
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.jsiiReleaseVersion">jsiiReleaseVersion</a></code> | <code>string</code> | Version requirement of `publib` which is used to publish modules to npm. |
|
|
1589
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.majorVersion">majorVersion</a></code> | <code>number</code> | Major version to release from the default branch. |
|
|
1590
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.minMajorVersion">minMajorVersion</a></code> | <code>number</code> | Minimal Major version to release. |
|
|
1591
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmDistTag">npmDistTag</a></code> | <code>string</code> | The npmDistTag to use when publishing from the default branch. |
|
|
1592
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.postBuildSteps">postBuildSteps</a></code> | <code>projen.github.workflows.JobStep[]</code> | Steps to execute after build as part of the release workflow. |
|
|
1593
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.prerelease">prerelease</a></code> | <code>string</code> | Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). |
|
|
1594
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.publishDryRun">publishDryRun</a></code> | <code>boolean</code> | Instead of actually publishing to package managers, just print the publishing command. |
|
|
1595
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.publishTasks">publishTasks</a></code> | <code>boolean</code> | Define publishing tasks that can be executed manually as well as workflows. |
|
|
1596
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releasableCommits">releasableCommits</a></code> | <code>projen.ReleasableCommits</code> | Find commits that should be considered releasable Used to decide if a release is required. |
|
|
1597
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseBranches">releaseBranches</a></code> | <code>{[ key: string ]: projen.release.BranchOptions}</code> | Defines additional release branches. |
|
|
1598
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseEveryCommit">releaseEveryCommit</a></code> | <code>boolean</code> | Automatically release new versions every commit to one of branches in `releaseBranches`. |
|
|
1599
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseFailureIssue">releaseFailureIssue</a></code> | <code>boolean</code> | Create a github issue on every failed publishing task. |
|
|
1600
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseFailureIssueLabel">releaseFailureIssueLabel</a></code> | <code>string</code> | The label to apply to issues indicating publish failures. |
|
|
1601
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseSchedule">releaseSchedule</a></code> | <code>string</code> | CRON schedule to trigger new releases. |
|
|
1602
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseTagPrefix">releaseTagPrefix</a></code> | <code>string</code> | Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. |
|
|
1603
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseTrigger">releaseTrigger</a></code> | <code>projen.release.ReleaseTrigger</code> | The release trigger to use. |
|
|
1604
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseWorkflowName">releaseWorkflowName</a></code> | <code>string</code> | The name of the default release workflow. |
|
|
1605
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseWorkflowSetupSteps">releaseWorkflowSetupSteps</a></code> | <code>projen.github.workflows.JobStep[]</code> | A set of workflow steps to execute in order to setup the workflow container. |
|
|
1606
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.versionrcOptions">versionrcOptions</a></code> | <code>{[ key: string ]: any}</code> | Custom configuration used when creating changelog with commit-and-tag-version package. |
|
|
1607
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowContainerImage">workflowContainerImage</a></code> | <code>string</code> | Container image to use for GitHub workflows. |
|
|
1608
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowRunsOn">workflowRunsOn</a></code> | <code>string[]</code> | Github Runner selection labels. |
|
|
1609
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowRunsOnGroup">workflowRunsOnGroup</a></code> | <code>projen.GroupRunnerOptions</code> | Github Runner Group selection options. |
|
|
1610
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.defaultReleaseBranch">defaultReleaseBranch</a></code> | <code>string</code> | The name of the main release branch. |
|
|
1611
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.artifactsDirectory">artifactsDirectory</a></code> | <code>string</code> | A directory which will contain build artifacts. |
|
|
1612
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.autoApproveUpgrades">autoApproveUpgrades</a></code> | <code>boolean</code> | Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). |
|
|
1613
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.buildWorkflow">buildWorkflow</a></code> | <code>boolean</code> | Define a GitHub workflow for building PRs. |
|
|
1614
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.buildWorkflowOptions">buildWorkflowOptions</a></code> | <code>projen.javascript.BuildWorkflowOptions</code> | Options for PR build workflow. |
|
|
1615
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.buildWorkflowTriggers">buildWorkflowTriggers</a></code> | <code>projen.github.workflows.Triggers</code> | Build workflow triggers. |
|
|
1616
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.bundlerOptions">bundlerOptions</a></code> | <code>projen.javascript.BundlerOptions</code> | Options for `Bundler`. |
|
|
1617
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.checkLicenses">checkLicenses</a></code> | <code>projen.javascript.LicenseCheckerOptions</code> | Configure which licenses should be deemed acceptable for use by dependencies. |
|
|
1618
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.codeCov">codeCov</a></code> | <code>boolean</code> | 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`. |
|
|
1619
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.codeCovTokenSecret">codeCovTokenSecret</a></code> | <code>string</code> | Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. |
|
|
1620
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.copyrightOwner">copyrightOwner</a></code> | <code>string</code> | License copyright owner. |
|
|
1621
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.copyrightPeriod">copyrightPeriod</a></code> | <code>string</code> | The copyright years to put in the LICENSE file. |
|
|
1622
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.dependabot">dependabot</a></code> | <code>boolean</code> | Use dependabot to handle dependency upgrades. |
|
|
1623
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.dependabotOptions">dependabotOptions</a></code> | <code>projen.github.DependabotOptions</code> | Options for dependabot. |
|
|
1624
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.depsUpgrade">depsUpgrade</a></code> | <code>boolean</code> | Use tasks and github workflows to handle dependency upgrades. |
|
|
1625
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.depsUpgradeOptions">depsUpgradeOptions</a></code> | <code>projen.javascript.UpgradeDependenciesOptions</code> | Options for `UpgradeDependencies`. |
|
|
1626
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.gitignore">gitignore</a></code> | <code>string[]</code> | Additional entries to .gitignore. |
|
|
1627
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.jest">jest</a></code> | <code>boolean</code> | Setup jest unit tests. |
|
|
1628
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.jestOptions">jestOptions</a></code> | <code>projen.javascript.JestOptions</code> | Jest options. |
|
|
1629
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.mutableBuild">mutableBuild</a></code> | <code>boolean</code> | Automatically update files modified during builds to pull-request branches. |
|
|
1630
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmignore">npmignore</a></code> | <code>string[]</code> | Additional entries to .npmignore. |
|
|
1631
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmignoreEnabled">npmignoreEnabled</a></code> | <code>boolean</code> | Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. |
|
|
1632
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.npmIgnoreOptions">npmIgnoreOptions</a></code> | <code>projen.IgnoreFileOptions</code> | Configuration options for .npmignore file. |
|
|
1633
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.package">package</a></code> | <code>boolean</code> | Defines a `package` task that will produce an npm tarball under the artifacts directory (e.g. `dist`). |
|
|
1634
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.prettier">prettier</a></code> | <code>boolean</code> | Setup prettier. |
|
|
1635
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.prettierOptions">prettierOptions</a></code> | <code>projen.javascript.PrettierOptions</code> | Prettier options. |
|
|
1636
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenDevDependency">projenDevDependency</a></code> | <code>boolean</code> | Indicates of "projen" should be installed as a devDependency. |
|
|
1637
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJs">projenrcJs</a></code> | <code>boolean</code> | Generate (once) .projenrc.js (in JavaScript). Set to `false` in order to disable .projenrc.js generation. |
|
|
1638
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJsOptions">projenrcJsOptions</a></code> | <code>projen.javascript.ProjenrcOptions</code> | Options for .projenrc.js. |
|
|
1639
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenVersion">projenVersion</a></code> | <code>string</code> | Version of projen to install. |
|
|
1640
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.pullRequestTemplate">pullRequestTemplate</a></code> | <code>boolean</code> | Include a GitHub pull request template. |
|
|
1641
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.pullRequestTemplateContents">pullRequestTemplateContents</a></code> | <code>string[]</code> | The contents of the pull request template. |
|
|
1642
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.release">release</a></code> | <code>boolean</code> | Add release management to this project. |
|
|
1643
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseToNpm">releaseToNpm</a></code> | <code>boolean</code> | Automatically release to npm when new versions are introduced. |
|
|
1644
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseWorkflow">releaseWorkflow</a></code> | <code>boolean</code> | DEPRECATED: renamed to `release`. |
|
|
1645
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowBootstrapSteps">workflowBootstrapSteps</a></code> | <code>projen.github.workflows.JobStep[]</code> | Workflow steps to use in order to bootstrap this repo. |
|
|
1646
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowGitIdentity">workflowGitIdentity</a></code> | <code>projen.github.GitIdentity</code> | The git identity to use in workflows. |
|
|
1647
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowNodeVersion">workflowNodeVersion</a></code> | <code>string</code> | The node version to use in GitHub workflows. |
|
|
1648
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowPackageCache">workflowPackageCache</a></code> | <code>boolean</code> | Enable Node.js package cache in GitHub workflows. |
|
|
1649
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.disableTsconfig">disableTsconfig</a></code> | <code>boolean</code> | Do not generate a `tsconfig.json` file (used by jsii projects since tsconfig.json is generated by the jsii compiler). |
|
|
1650
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.disableTsconfigDev">disableTsconfigDev</a></code> | <code>boolean</code> | Do not generate a `tsconfig.dev.json` file. |
|
|
1651
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.docgen">docgen</a></code> | <code>boolean</code> | Docgen by Typedoc. |
|
|
1652
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.docsDirectory">docsDirectory</a></code> | <code>string</code> | Docs directory. |
|
|
1653
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.entrypointTypes">entrypointTypes</a></code> | <code>string</code> | The .d.ts file that includes the type declarations for this module. |
|
|
1654
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.eslint">eslint</a></code> | <code>boolean</code> | Setup eslint. |
|
|
1655
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.eslintOptions">eslintOptions</a></code> | <code>projen.javascript.EslintOptions</code> | Eslint options. |
|
|
1656
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.libdir">libdir</a></code> | <code>string</code> | Typescript artifacts output directory. |
|
|
1657
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcTs">projenrcTs</a></code> | <code>boolean</code> | Use TypeScript for your projenrc file (`.projenrc.ts`). |
|
|
1658
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcTsOptions">projenrcTsOptions</a></code> | <code>projen.typescript.ProjenrcOptions</code> | Options for .projenrc.ts. |
|
|
1659
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.sampleCode">sampleCode</a></code> | <code>boolean</code> | Generate one-time sample in `src/` and `test/` if there are no files there. |
|
|
1660
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.srcdir">srcdir</a></code> | <code>string</code> | Typescript sources directory. |
|
|
1661
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.testdir">testdir</a></code> | <code>string</code> | Jest tests directory. Tests files should be named `xxx.test.ts`. |
|
|
1662
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.tsconfig">tsconfig</a></code> | <code>projen.javascript.TypescriptConfigOptions</code> | Custom TSConfig. |
|
|
1663
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.tsconfigDev">tsconfigDev</a></code> | <code>projen.javascript.TypescriptConfigOptions</code> | Custom tsconfig options for the development tsconfig.json file (used for testing). |
|
|
1664
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.tsconfigDevFile">tsconfigDevFile</a></code> | <code>string</code> | The name of the development tsconfig.json file. |
|
|
1665
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.tsJestOptions">tsJestOptions</a></code> | <code>projen.typescript.TsJestOptions</code> | Options for ts-jest. |
|
|
1666
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.typescriptVersion">typescriptVersion</a></code> | <code>string</code> | TypeScript version to use. |
|
|
1667
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.author">author</a></code> | <code>string</code> | The name of the library author. |
|
|
1668
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.authorAddress">authorAddress</a></code> | <code>string</code> | Email or URL of the library author. |
|
|
1669
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.repositoryUrl">repositoryUrl</a></code> | <code>string</code> | Git repository URL. |
|
|
1670
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.compat">compat</a></code> | <code>boolean</code> | Automatically run API compatibility test against the latest version published to npm after compilation. |
|
|
1671
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.compatIgnore">compatIgnore</a></code> | <code>string</code> | Name of the ignore file for API compatibility tests. |
|
|
1672
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.compressAssembly">compressAssembly</a></code> | <code>boolean</code> | Emit a compressed version of the assembly. |
|
|
1673
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.docgenFilePath">docgenFilePath</a></code> | <code>string</code> | File path for generated docs. |
|
|
1674
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.dotnet">dotnet</a></code> | <code>projen.cdk.JsiiDotNetTarget</code> | *No description.* |
|
|
1675
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.excludeTypescript">excludeTypescript</a></code> | <code>string[]</code> | Accepts a list of glob patterns. |
|
|
1676
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.jsiiVersion">jsiiVersion</a></code> | <code>string</code> | Version of the jsii compiler to use. |
|
|
1677
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToGo">publishToGo</a></code> | <code>projen.cdk.JsiiGoTarget</code> | Publish Go bindings to a git repository. |
|
|
1678
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToMaven">publishToMaven</a></code> | <code>projen.cdk.JsiiJavaTarget</code> | Publish to maven. |
|
|
1679
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToNuget">publishToNuget</a></code> | <code>projen.cdk.JsiiDotNetTarget</code> | Publish to NuGet. |
|
|
1680
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToPypi">publishToPypi</a></code> | <code>projen.cdk.JsiiPythonTarget</code> | Publish to pypi. |
|
|
1681
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.python">python</a></code> | <code>projen.cdk.JsiiPythonTarget</code> | *No description.* |
|
|
1682
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.rootdir">rootdir</a></code> | <code>string</code> | *No description.* |
|
|
1683
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.cdktfVersion">cdktfVersion</a></code> | <code>string</code> | *No description.* |
|
|
1684
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.constructsVersion">constructsVersion</a></code> | <code>string</code> | *No description.* |
|
|
1685
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.terraformProvider">terraformProvider</a></code> | <code>string</code> | *No description.* |
|
|
1686
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.creationYear">creationYear</a></code> | <code>number</code> | The year of the creation of the repository, for copyright purposes. |
|
|
1687
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.deprecationDate">deprecationDate</a></code> | <code>string</code> | An optional date when the project should be considered deprecated, to be used in the README text. |
|
|
1688
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.forceMajorVersion">forceMajorVersion</a></code> | <code>number</code> | *No description.* |
|
|
1689
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.githubNamespace">githubNamespace</a></code> | <code>string</code> | defaults to "cdktn-io" previously was "cdktf". |
|
|
1690
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.isDeprecated">isDeprecated</a></code> | <code>boolean</code> | Whether or not this prebuilt provider is deprecated. |
|
|
1691
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.licensee">licensee</a></code> | <code>string</code> | defaults to "HashiCorp, Inc.". |
|
|
1692
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.mavenEndpoint">mavenEndpoint</a></code> | <code>string</code> | *No description.* |
|
|
1693
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.mavenGroupId">mavenGroupId</a></code> | <code>string</code> | defaults to "io.${mavenOrg}". |
|
|
1694
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.mavenOrg">mavenOrg</a></code> | <code>string</code> | defaults to "cdktn". |
|
|
1695
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.namespace">namespace</a></code> | <code>string</code> | defaults to "cdktn". |
|
|
1696
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.nugetOrg">nugetOrg</a></code> | <code>string</code> | defaults to "Io.Cdktn". |
|
|
1697
|
+
| <code><a href="#@cdktn/provider-project.CdktnProviderProjectOptions.property.useCustomGithubRunner">useCustomGithubRunner</a></code> | <code>boolean</code> | *No description.* |
|
|
1698
|
+
|
|
1699
|
+
---
|
|
1700
|
+
|
|
1701
|
+
##### `name`<sup>Required</sup> <a name="name" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.name"></a>
|
|
1702
|
+
|
|
1703
|
+
```typescript
|
|
1704
|
+
public readonly name: string;
|
|
1705
|
+
```
|
|
1706
|
+
|
|
1707
|
+
- *Type:* string
|
|
1708
|
+
- *Default:* $BASEDIR
|
|
1709
|
+
|
|
1710
|
+
This is the name of your project.
|
|
1711
|
+
|
|
1712
|
+
---
|
|
1713
|
+
|
|
1714
|
+
##### `commitGenerated`<sup>Optional</sup> <a name="commitGenerated" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.commitGenerated"></a>
|
|
1715
|
+
|
|
1716
|
+
```typescript
|
|
1717
|
+
public readonly commitGenerated: boolean;
|
|
1718
|
+
```
|
|
1719
|
+
|
|
1720
|
+
- *Type:* boolean
|
|
1721
|
+
- *Default:* true
|
|
1722
|
+
|
|
1723
|
+
Whether to commit the managed files by default.
|
|
1724
|
+
|
|
1725
|
+
---
|
|
1726
|
+
|
|
1727
|
+
##### `gitIgnoreOptions`<sup>Optional</sup> <a name="gitIgnoreOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.gitIgnoreOptions"></a>
|
|
1728
|
+
|
|
1729
|
+
```typescript
|
|
1730
|
+
public readonly gitIgnoreOptions: IgnoreFileOptions;
|
|
1731
|
+
```
|
|
1732
|
+
|
|
1733
|
+
- *Type:* projen.IgnoreFileOptions
|
|
1734
|
+
|
|
1735
|
+
Configuration options for .gitignore file.
|
|
1736
|
+
|
|
1737
|
+
---
|
|
1738
|
+
|
|
1739
|
+
##### `gitOptions`<sup>Optional</sup> <a name="gitOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.gitOptions"></a>
|
|
1740
|
+
|
|
1741
|
+
```typescript
|
|
1742
|
+
public readonly gitOptions: GitOptions;
|
|
1743
|
+
```
|
|
1744
|
+
|
|
1745
|
+
- *Type:* projen.GitOptions
|
|
1746
|
+
|
|
1747
|
+
Configuration options for git.
|
|
1748
|
+
|
|
1749
|
+
---
|
|
1750
|
+
|
|
1751
|
+
##### `logging`<sup>Optional</sup> <a name="logging" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.logging"></a>
|
|
1752
|
+
|
|
1753
|
+
```typescript
|
|
1754
|
+
public readonly logging: LoggerOptions;
|
|
1755
|
+
```
|
|
1756
|
+
|
|
1757
|
+
- *Type:* projen.LoggerOptions
|
|
1758
|
+
- *Default:* {}
|
|
1759
|
+
|
|
1760
|
+
Configure logging options such as verbosity.
|
|
1761
|
+
|
|
1762
|
+
---
|
|
1763
|
+
|
|
1764
|
+
##### `outdir`<sup>Optional</sup> <a name="outdir" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.outdir"></a>
|
|
1765
|
+
|
|
1766
|
+
```typescript
|
|
1767
|
+
public readonly outdir: string;
|
|
1768
|
+
```
|
|
1769
|
+
|
|
1770
|
+
- *Type:* string
|
|
1771
|
+
- *Default:* "."
|
|
1772
|
+
|
|
1773
|
+
The root directory of the project.
|
|
1774
|
+
|
|
1775
|
+
Relative to this directory, all files are synthesized.
|
|
1776
|
+
|
|
1777
|
+
If this project has a parent, this directory is relative to the parent
|
|
1778
|
+
directory and it cannot be the same as the parent or any of it's other
|
|
1779
|
+
subprojects.
|
|
1780
|
+
|
|
1781
|
+
---
|
|
1782
|
+
|
|
1783
|
+
##### `parent`<sup>Optional</sup> <a name="parent" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.parent"></a>
|
|
1784
|
+
|
|
1785
|
+
```typescript
|
|
1786
|
+
public readonly parent: Project;
|
|
1787
|
+
```
|
|
1788
|
+
|
|
1789
|
+
- *Type:* projen.Project
|
|
1790
|
+
|
|
1791
|
+
The parent project, if this project is part of a bigger project.
|
|
1792
|
+
|
|
1793
|
+
---
|
|
1794
|
+
|
|
1795
|
+
##### `projenCommand`<sup>Optional</sup> <a name="projenCommand" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenCommand"></a>
|
|
1796
|
+
|
|
1797
|
+
```typescript
|
|
1798
|
+
public readonly projenCommand: string;
|
|
1799
|
+
```
|
|
1800
|
+
|
|
1801
|
+
- *Type:* string
|
|
1802
|
+
- *Default:* "npx projen"
|
|
1803
|
+
|
|
1804
|
+
The shell command to use in order to run the projen CLI.
|
|
1805
|
+
|
|
1806
|
+
Can be used to customize in special environments.
|
|
1807
|
+
|
|
1808
|
+
---
|
|
1809
|
+
|
|
1810
|
+
##### `projenrcJson`<sup>Optional</sup> <a name="projenrcJson" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJson"></a>
|
|
1811
|
+
|
|
1812
|
+
```typescript
|
|
1813
|
+
public readonly projenrcJson: boolean;
|
|
1814
|
+
```
|
|
1815
|
+
|
|
1816
|
+
- *Type:* boolean
|
|
1817
|
+
- *Default:* false
|
|
1818
|
+
|
|
1819
|
+
Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation.
|
|
1820
|
+
|
|
1821
|
+
---
|
|
1822
|
+
|
|
1823
|
+
##### `projenrcJsonOptions`<sup>Optional</sup> <a name="projenrcJsonOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJsonOptions"></a>
|
|
1824
|
+
|
|
1825
|
+
```typescript
|
|
1826
|
+
public readonly projenrcJsonOptions: ProjenrcJsonOptions;
|
|
1827
|
+
```
|
|
1828
|
+
|
|
1829
|
+
- *Type:* projen.ProjenrcJsonOptions
|
|
1830
|
+
- *Default:* default options
|
|
1831
|
+
|
|
1832
|
+
Options for .projenrc.json.
|
|
1833
|
+
|
|
1834
|
+
---
|
|
1835
|
+
|
|
1836
|
+
##### `renovatebot`<sup>Optional</sup> <a name="renovatebot" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.renovatebot"></a>
|
|
1837
|
+
|
|
1838
|
+
```typescript
|
|
1839
|
+
public readonly renovatebot: boolean;
|
|
1840
|
+
```
|
|
1841
|
+
|
|
1842
|
+
- *Type:* boolean
|
|
1843
|
+
- *Default:* false
|
|
1844
|
+
|
|
1845
|
+
Use renovatebot to handle dependency upgrades.
|
|
1846
|
+
|
|
1847
|
+
---
|
|
1848
|
+
|
|
1849
|
+
##### `renovatebotOptions`<sup>Optional</sup> <a name="renovatebotOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.renovatebotOptions"></a>
|
|
1850
|
+
|
|
1851
|
+
```typescript
|
|
1852
|
+
public readonly renovatebotOptions: RenovatebotOptions;
|
|
1853
|
+
```
|
|
1854
|
+
|
|
1855
|
+
- *Type:* projen.RenovatebotOptions
|
|
1856
|
+
- *Default:* default options
|
|
1857
|
+
|
|
1858
|
+
Options for renovatebot.
|
|
1859
|
+
|
|
1860
|
+
---
|
|
1861
|
+
|
|
1862
|
+
##### `autoApproveOptions`<sup>Optional</sup> <a name="autoApproveOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.autoApproveOptions"></a>
|
|
1863
|
+
|
|
1864
|
+
```typescript
|
|
1865
|
+
public readonly autoApproveOptions: AutoApproveOptions;
|
|
1866
|
+
```
|
|
1867
|
+
|
|
1868
|
+
- *Type:* projen.github.AutoApproveOptions
|
|
1869
|
+
- *Default:* auto approve is disabled
|
|
1870
|
+
|
|
1871
|
+
Enable and configure the 'auto approve' workflow.
|
|
1872
|
+
|
|
1873
|
+
---
|
|
1874
|
+
|
|
1875
|
+
##### `autoMerge`<sup>Optional</sup> <a name="autoMerge" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.autoMerge"></a>
|
|
1876
|
+
|
|
1877
|
+
```typescript
|
|
1878
|
+
public readonly autoMerge: boolean;
|
|
1879
|
+
```
|
|
1880
|
+
|
|
1881
|
+
- *Type:* boolean
|
|
1882
|
+
- *Default:* true
|
|
1883
|
+
|
|
1884
|
+
Enable automatic merging on GitHub.
|
|
1885
|
+
|
|
1886
|
+
Has no effect if `github.mergify`
|
|
1887
|
+
is set to false.
|
|
1888
|
+
|
|
1889
|
+
---
|
|
1890
|
+
|
|
1891
|
+
##### `autoMergeOptions`<sup>Optional</sup> <a name="autoMergeOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.autoMergeOptions"></a>
|
|
1892
|
+
|
|
1893
|
+
```typescript
|
|
1894
|
+
public readonly autoMergeOptions: AutoMergeOptions;
|
|
1895
|
+
```
|
|
1896
|
+
|
|
1897
|
+
- *Type:* projen.github.AutoMergeOptions
|
|
1898
|
+
- *Default:* see defaults in `AutoMergeOptions`
|
|
1899
|
+
|
|
1900
|
+
Configure options for automatic merging on GitHub.
|
|
1901
|
+
|
|
1902
|
+
Has no effect if
|
|
1903
|
+
`github.mergify` or `autoMerge` is set to false.
|
|
1904
|
+
|
|
1905
|
+
---
|
|
1906
|
+
|
|
1907
|
+
##### `clobber`<sup>Optional</sup> <a name="clobber" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.clobber"></a>
|
|
1908
|
+
|
|
1909
|
+
```typescript
|
|
1910
|
+
public readonly clobber: boolean;
|
|
1911
|
+
```
|
|
1912
|
+
|
|
1913
|
+
- *Type:* boolean
|
|
1914
|
+
- *Default:* true, but false for subprojects
|
|
1915
|
+
|
|
1916
|
+
Add a `clobber` task which resets the repo to origin.
|
|
1917
|
+
|
|
1918
|
+
---
|
|
1919
|
+
|
|
1920
|
+
##### `devContainer`<sup>Optional</sup> <a name="devContainer" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.devContainer"></a>
|
|
1921
|
+
|
|
1922
|
+
```typescript
|
|
1923
|
+
public readonly devContainer: boolean;
|
|
1924
|
+
```
|
|
1925
|
+
|
|
1926
|
+
- *Type:* boolean
|
|
1927
|
+
- *Default:* false
|
|
1928
|
+
|
|
1929
|
+
Add a VSCode development environment (used for GitHub Codespaces).
|
|
1930
|
+
|
|
1931
|
+
---
|
|
1932
|
+
|
|
1933
|
+
##### `github`<sup>Optional</sup> <a name="github" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.github"></a>
|
|
1934
|
+
|
|
1935
|
+
```typescript
|
|
1936
|
+
public readonly github: boolean;
|
|
1937
|
+
```
|
|
1938
|
+
|
|
1939
|
+
- *Type:* boolean
|
|
1940
|
+
- *Default:* true
|
|
1941
|
+
|
|
1942
|
+
Enable GitHub integration.
|
|
1943
|
+
|
|
1944
|
+
Enabled by default for root projects. Disabled for non-root projects.
|
|
1945
|
+
|
|
1946
|
+
---
|
|
1947
|
+
|
|
1948
|
+
##### `githubOptions`<sup>Optional</sup> <a name="githubOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.githubOptions"></a>
|
|
1949
|
+
|
|
1950
|
+
```typescript
|
|
1951
|
+
public readonly githubOptions: GitHubOptions;
|
|
1952
|
+
```
|
|
1953
|
+
|
|
1954
|
+
- *Type:* projen.github.GitHubOptions
|
|
1955
|
+
- *Default:* see GitHubOptions
|
|
1956
|
+
|
|
1957
|
+
Options for GitHub integration.
|
|
1958
|
+
|
|
1959
|
+
---
|
|
1960
|
+
|
|
1961
|
+
##### `gitpod`<sup>Optional</sup> <a name="gitpod" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.gitpod"></a>
|
|
1962
|
+
|
|
1963
|
+
```typescript
|
|
1964
|
+
public readonly gitpod: boolean;
|
|
1965
|
+
```
|
|
1966
|
+
|
|
1967
|
+
- *Type:* boolean
|
|
1968
|
+
- *Default:* false
|
|
1969
|
+
|
|
1970
|
+
Add a Gitpod development environment.
|
|
1971
|
+
|
|
1972
|
+
---
|
|
1973
|
+
|
|
1974
|
+
##### ~~`mergify`~~<sup>Optional</sup> <a name="mergify" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.mergify"></a>
|
|
1975
|
+
|
|
1976
|
+
- *Deprecated:* use `githubOptions.mergify` instead
|
|
1977
|
+
|
|
1978
|
+
```typescript
|
|
1979
|
+
public readonly mergify: boolean;
|
|
1980
|
+
```
|
|
1981
|
+
|
|
1982
|
+
- *Type:* boolean
|
|
1983
|
+
- *Default:* true
|
|
1984
|
+
|
|
1985
|
+
Whether mergify should be enabled on this repository or not.
|
|
1986
|
+
|
|
1987
|
+
---
|
|
1988
|
+
|
|
1989
|
+
##### ~~`mergifyOptions`~~<sup>Optional</sup> <a name="mergifyOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.mergifyOptions"></a>
|
|
1990
|
+
|
|
1991
|
+
- *Deprecated:* use `githubOptions.mergifyOptions` instead
|
|
1992
|
+
|
|
1993
|
+
```typescript
|
|
1994
|
+
public readonly mergifyOptions: MergifyOptions;
|
|
1995
|
+
```
|
|
1996
|
+
|
|
1997
|
+
- *Type:* projen.github.MergifyOptions
|
|
1998
|
+
- *Default:* default options
|
|
1999
|
+
|
|
2000
|
+
Options for mergify.
|
|
2001
|
+
|
|
2002
|
+
---
|
|
2003
|
+
|
|
2004
|
+
##### ~~`projectType`~~<sup>Optional</sup> <a name="projectType" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projectType"></a>
|
|
2005
|
+
|
|
2006
|
+
- *Deprecated:* no longer supported at the base project level
|
|
2007
|
+
|
|
2008
|
+
```typescript
|
|
2009
|
+
public readonly projectType: ProjectType;
|
|
2010
|
+
```
|
|
2011
|
+
|
|
2012
|
+
- *Type:* projen.ProjectType
|
|
2013
|
+
- *Default:* ProjectType.UNKNOWN
|
|
2014
|
+
|
|
2015
|
+
Which type of project this is (library/app).
|
|
2016
|
+
|
|
2017
|
+
---
|
|
2018
|
+
|
|
2019
|
+
##### `projenCredentials`<sup>Optional</sup> <a name="projenCredentials" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenCredentials"></a>
|
|
2020
|
+
|
|
2021
|
+
```typescript
|
|
2022
|
+
public readonly projenCredentials: GithubCredentials;
|
|
2023
|
+
```
|
|
2024
|
+
|
|
2025
|
+
- *Type:* projen.github.GithubCredentials
|
|
2026
|
+
- *Default:* use a personal access token named PROJEN_GITHUB_TOKEN
|
|
2027
|
+
|
|
2028
|
+
Choose a method of providing GitHub API access for projen workflows.
|
|
2029
|
+
|
|
2030
|
+
---
|
|
2031
|
+
|
|
2032
|
+
##### ~~`projenTokenSecret`~~<sup>Optional</sup> <a name="projenTokenSecret" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenTokenSecret"></a>
|
|
2033
|
+
|
|
2034
|
+
- *Deprecated:* use `projenCredentials`
|
|
2035
|
+
|
|
2036
|
+
```typescript
|
|
2037
|
+
public readonly projenTokenSecret: string;
|
|
2038
|
+
```
|
|
2039
|
+
|
|
2040
|
+
- *Type:* string
|
|
2041
|
+
- *Default:* "PROJEN_GITHUB_TOKEN"
|
|
2042
|
+
|
|
2043
|
+
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
|
|
2044
|
+
|
|
2045
|
+
This token needs to have the `repo`, `workflows`
|
|
2046
|
+
and `packages` scope.
|
|
2047
|
+
|
|
2048
|
+
---
|
|
2049
|
+
|
|
2050
|
+
##### `readme`<sup>Optional</sup> <a name="readme" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.readme"></a>
|
|
2051
|
+
|
|
2052
|
+
```typescript
|
|
2053
|
+
public readonly readme: SampleReadmeProps;
|
|
2054
|
+
```
|
|
2055
|
+
|
|
2056
|
+
- *Type:* projen.SampleReadmeProps
|
|
2057
|
+
- *Default:* { filename: 'README.md', contents: '# replace this' }
|
|
2058
|
+
|
|
2059
|
+
The README setup.
|
|
2060
|
+
|
|
2061
|
+
---
|
|
2062
|
+
|
|
2063
|
+
*Example*
|
|
2064
|
+
|
|
2065
|
+
```typescript
|
|
2066
|
+
"{ filename: 'readme.md', contents: '# title' }"
|
|
2067
|
+
```
|
|
2068
|
+
|
|
2069
|
+
|
|
2070
|
+
##### `stale`<sup>Optional</sup> <a name="stale" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.stale"></a>
|
|
2071
|
+
|
|
2072
|
+
```typescript
|
|
2073
|
+
public readonly stale: boolean;
|
|
2074
|
+
```
|
|
2075
|
+
|
|
2076
|
+
- *Type:* boolean
|
|
2077
|
+
- *Default:* false
|
|
2078
|
+
|
|
2079
|
+
Auto-close of stale issues and pull request.
|
|
2080
|
+
|
|
2081
|
+
See `staleOptions` for options.
|
|
2082
|
+
|
|
2083
|
+
---
|
|
2084
|
+
|
|
2085
|
+
##### `staleOptions`<sup>Optional</sup> <a name="staleOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.staleOptions"></a>
|
|
2086
|
+
|
|
2087
|
+
```typescript
|
|
2088
|
+
public readonly staleOptions: StaleOptions;
|
|
2089
|
+
```
|
|
2090
|
+
|
|
2091
|
+
- *Type:* projen.github.StaleOptions
|
|
2092
|
+
- *Default:* see defaults in `StaleOptions`
|
|
2093
|
+
|
|
2094
|
+
Auto-close stale issues and pull requests.
|
|
2095
|
+
|
|
2096
|
+
To disable set `stale` to `false`.
|
|
2097
|
+
|
|
2098
|
+
---
|
|
2099
|
+
|
|
2100
|
+
##### `vscode`<sup>Optional</sup> <a name="vscode" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.vscode"></a>
|
|
2101
|
+
|
|
2102
|
+
```typescript
|
|
2103
|
+
public readonly vscode: boolean;
|
|
2104
|
+
```
|
|
2105
|
+
|
|
2106
|
+
- *Type:* boolean
|
|
2107
|
+
- *Default:* true
|
|
2108
|
+
|
|
2109
|
+
Enable VSCode integration.
|
|
2110
|
+
|
|
2111
|
+
Enabled by default for root projects. Disabled for non-root projects.
|
|
2112
|
+
|
|
2113
|
+
---
|
|
2114
|
+
|
|
2115
|
+
##### `allowLibraryDependencies`<sup>Optional</sup> <a name="allowLibraryDependencies" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.allowLibraryDependencies"></a>
|
|
2116
|
+
|
|
2117
|
+
```typescript
|
|
2118
|
+
public readonly allowLibraryDependencies: boolean;
|
|
2119
|
+
```
|
|
2120
|
+
|
|
2121
|
+
- *Type:* boolean
|
|
2122
|
+
- *Default:* true
|
|
2123
|
+
|
|
2124
|
+
Allow the project to include `peerDependencies` and `bundledDependencies`.
|
|
2125
|
+
|
|
2126
|
+
This is normally only allowed for libraries. For apps, there's no meaning
|
|
2127
|
+
for specifying these.
|
|
2128
|
+
|
|
2129
|
+
---
|
|
2130
|
+
|
|
2131
|
+
##### `authorEmail`<sup>Optional</sup> <a name="authorEmail" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.authorEmail"></a>
|
|
2132
|
+
|
|
2133
|
+
```typescript
|
|
2134
|
+
public readonly authorEmail: string;
|
|
2135
|
+
```
|
|
2136
|
+
|
|
2137
|
+
- *Type:* string
|
|
2138
|
+
|
|
2139
|
+
Author's e-mail.
|
|
2140
|
+
|
|
2141
|
+
---
|
|
2142
|
+
|
|
2143
|
+
##### `authorName`<sup>Optional</sup> <a name="authorName" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.authorName"></a>
|
|
2144
|
+
|
|
2145
|
+
```typescript
|
|
2146
|
+
public readonly authorName: string;
|
|
2147
|
+
```
|
|
2148
|
+
|
|
2149
|
+
- *Type:* string
|
|
2150
|
+
|
|
2151
|
+
Author's name.
|
|
2152
|
+
|
|
2153
|
+
---
|
|
2154
|
+
|
|
2155
|
+
##### `authorOrganization`<sup>Optional</sup> <a name="authorOrganization" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.authorOrganization"></a>
|
|
2156
|
+
|
|
2157
|
+
```typescript
|
|
2158
|
+
public readonly authorOrganization: boolean;
|
|
2159
|
+
```
|
|
2160
|
+
|
|
2161
|
+
- *Type:* boolean
|
|
2162
|
+
|
|
2163
|
+
Is the author an organization.
|
|
2164
|
+
|
|
2165
|
+
---
|
|
2166
|
+
|
|
2167
|
+
##### `authorUrl`<sup>Optional</sup> <a name="authorUrl" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.authorUrl"></a>
|
|
2168
|
+
|
|
2169
|
+
```typescript
|
|
2170
|
+
public readonly authorUrl: string;
|
|
2171
|
+
```
|
|
2172
|
+
|
|
2173
|
+
- *Type:* string
|
|
2174
|
+
|
|
2175
|
+
Author's URL / Website.
|
|
2176
|
+
|
|
2177
|
+
---
|
|
2178
|
+
|
|
2179
|
+
##### `autoDetectBin`<sup>Optional</sup> <a name="autoDetectBin" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.autoDetectBin"></a>
|
|
2180
|
+
|
|
2181
|
+
```typescript
|
|
2182
|
+
public readonly autoDetectBin: boolean;
|
|
2183
|
+
```
|
|
2184
|
+
|
|
2185
|
+
- *Type:* boolean
|
|
2186
|
+
- *Default:* true
|
|
2187
|
+
|
|
2188
|
+
Automatically add all executables under the `bin` directory to your `package.json` file under the `bin` section.
|
|
2189
|
+
|
|
2190
|
+
---
|
|
2191
|
+
|
|
2192
|
+
##### `bin`<sup>Optional</sup> <a name="bin" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.bin"></a>
|
|
2193
|
+
|
|
2194
|
+
```typescript
|
|
2195
|
+
public readonly bin: {[ key: string ]: string};
|
|
2196
|
+
```
|
|
2197
|
+
|
|
2198
|
+
- *Type:* {[ key: string ]: string}
|
|
2199
|
+
|
|
2200
|
+
Binary programs vended with your module.
|
|
2201
|
+
|
|
2202
|
+
You can use this option to add/customize how binaries are represented in
|
|
2203
|
+
your `package.json`, but unless `autoDetectBin` is `false`, every
|
|
2204
|
+
executable file under `bin` will automatically be added to this section.
|
|
2205
|
+
|
|
2206
|
+
---
|
|
2207
|
+
|
|
2208
|
+
##### `bugsEmail`<sup>Optional</sup> <a name="bugsEmail" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.bugsEmail"></a>
|
|
2209
|
+
|
|
2210
|
+
```typescript
|
|
2211
|
+
public readonly bugsEmail: string;
|
|
2212
|
+
```
|
|
2213
|
+
|
|
2214
|
+
- *Type:* string
|
|
2215
|
+
|
|
2216
|
+
The email address to which issues should be reported.
|
|
2217
|
+
|
|
2218
|
+
---
|
|
2219
|
+
|
|
2220
|
+
##### `bugsUrl`<sup>Optional</sup> <a name="bugsUrl" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.bugsUrl"></a>
|
|
2221
|
+
|
|
2222
|
+
```typescript
|
|
2223
|
+
public readonly bugsUrl: string;
|
|
2224
|
+
```
|
|
2225
|
+
|
|
2226
|
+
- *Type:* string
|
|
2227
|
+
|
|
2228
|
+
The url to your project's issue tracker.
|
|
2229
|
+
|
|
2230
|
+
---
|
|
2231
|
+
|
|
2232
|
+
##### `bundledDeps`<sup>Optional</sup> <a name="bundledDeps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.bundledDeps"></a>
|
|
2233
|
+
|
|
2234
|
+
```typescript
|
|
2235
|
+
public readonly bundledDeps: string[];
|
|
2236
|
+
```
|
|
2237
|
+
|
|
2238
|
+
- *Type:* string[]
|
|
2239
|
+
|
|
2240
|
+
List of dependencies to bundle into this module.
|
|
2241
|
+
|
|
2242
|
+
These modules will be
|
|
2243
|
+
added both to the `dependencies` section and `bundledDependencies` section of
|
|
2244
|
+
your `package.json`.
|
|
2245
|
+
|
|
2246
|
+
The recommendation is to only specify the module name here (e.g.
|
|
2247
|
+
`express`). This will behave similar to `yarn add` or `npm install` in the
|
|
2248
|
+
sense that it will add the module as a dependency to your `package.json`
|
|
2249
|
+
file with the latest version (`^`). You can specify semver requirements in
|
|
2250
|
+
the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
|
|
2251
|
+
this will be what you `package.json` will eventually include.
|
|
2252
|
+
|
|
2253
|
+
---
|
|
2254
|
+
|
|
2255
|
+
##### `codeArtifactOptions`<sup>Optional</sup> <a name="codeArtifactOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.codeArtifactOptions"></a>
|
|
2256
|
+
|
|
2257
|
+
```typescript
|
|
2258
|
+
public readonly codeArtifactOptions: CodeArtifactOptions;
|
|
2259
|
+
```
|
|
2260
|
+
|
|
2261
|
+
- *Type:* projen.javascript.CodeArtifactOptions
|
|
2262
|
+
- *Default:* undefined
|
|
2263
|
+
|
|
2264
|
+
Options for npm packages using AWS CodeArtifact.
|
|
2265
|
+
|
|
2266
|
+
This is required if publishing packages to, or installing scoped packages from AWS CodeArtifact
|
|
2267
|
+
|
|
2268
|
+
---
|
|
2269
|
+
|
|
2270
|
+
##### `deps`<sup>Optional</sup> <a name="deps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.deps"></a>
|
|
2271
|
+
|
|
2272
|
+
```typescript
|
|
2273
|
+
public readonly deps: string[];
|
|
2274
|
+
```
|
|
2275
|
+
|
|
2276
|
+
- *Type:* string[]
|
|
2277
|
+
- *Default:* []
|
|
2278
|
+
|
|
2279
|
+
Runtime dependencies of this module.
|
|
2280
|
+
|
|
2281
|
+
The recommendation is to only specify the module name here (e.g.
|
|
2282
|
+
`express`). This will behave similar to `yarn add` or `npm install` in the
|
|
2283
|
+
sense that it will add the module as a dependency to your `package.json`
|
|
2284
|
+
file with the latest version (`^`). You can specify semver requirements in
|
|
2285
|
+
the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
|
|
2286
|
+
this will be what you `package.json` will eventually include.
|
|
2287
|
+
|
|
2288
|
+
---
|
|
2289
|
+
|
|
2290
|
+
*Example*
|
|
2291
|
+
|
|
2292
|
+
```typescript
|
|
2293
|
+
[ 'express', 'lodash', 'foo@^2' ]
|
|
2294
|
+
```
|
|
2295
|
+
|
|
2296
|
+
|
|
2297
|
+
##### `description`<sup>Optional</sup> <a name="description" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.description"></a>
|
|
2298
|
+
|
|
2299
|
+
```typescript
|
|
2300
|
+
public readonly description: string;
|
|
2301
|
+
```
|
|
2302
|
+
|
|
2303
|
+
- *Type:* string
|
|
2304
|
+
|
|
2305
|
+
The description is just a string that helps people understand the purpose of the package.
|
|
2306
|
+
|
|
2307
|
+
It can be used when searching for packages in a package manager as well.
|
|
2308
|
+
See https://classic.yarnpkg.com/en/docs/package-json/#toc-description
|
|
2309
|
+
|
|
2310
|
+
---
|
|
2311
|
+
|
|
2312
|
+
##### `devDeps`<sup>Optional</sup> <a name="devDeps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.devDeps"></a>
|
|
2313
|
+
|
|
2314
|
+
```typescript
|
|
2315
|
+
public readonly devDeps: string[];
|
|
2316
|
+
```
|
|
2317
|
+
|
|
2318
|
+
- *Type:* string[]
|
|
2319
|
+
- *Default:* []
|
|
2320
|
+
|
|
2321
|
+
Build dependencies for this module.
|
|
2322
|
+
|
|
2323
|
+
These dependencies will only be
|
|
2324
|
+
available in your build environment but will not be fetched when this
|
|
2325
|
+
module is consumed.
|
|
2326
|
+
|
|
2327
|
+
The recommendation is to only specify the module name here (e.g.
|
|
2328
|
+
`express`). This will behave similar to `yarn add` or `npm install` in the
|
|
2329
|
+
sense that it will add the module as a dependency to your `package.json`
|
|
2330
|
+
file with the latest version (`^`). You can specify semver requirements in
|
|
2331
|
+
the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
|
|
2332
|
+
this will be what you `package.json` will eventually include.
|
|
2333
|
+
|
|
2334
|
+
---
|
|
2335
|
+
|
|
2336
|
+
*Example*
|
|
2337
|
+
|
|
2338
|
+
```typescript
|
|
2339
|
+
[ 'typescript', '@types/express' ]
|
|
2340
|
+
```
|
|
2341
|
+
|
|
2342
|
+
|
|
2343
|
+
##### `entrypoint`<sup>Optional</sup> <a name="entrypoint" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.entrypoint"></a>
|
|
2344
|
+
|
|
2345
|
+
```typescript
|
|
2346
|
+
public readonly entrypoint: string;
|
|
2347
|
+
```
|
|
2348
|
+
|
|
2349
|
+
- *Type:* string
|
|
2350
|
+
- *Default:* "lib/index.js"
|
|
2351
|
+
|
|
2352
|
+
Module entrypoint (`main` in `package.json`).
|
|
2353
|
+
|
|
2354
|
+
Set to an empty string to not include `main` in your package.json
|
|
2355
|
+
|
|
2356
|
+
---
|
|
2357
|
+
|
|
2358
|
+
##### `homepage`<sup>Optional</sup> <a name="homepage" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.homepage"></a>
|
|
2359
|
+
|
|
2360
|
+
```typescript
|
|
2361
|
+
public readonly homepage: string;
|
|
2362
|
+
```
|
|
2363
|
+
|
|
2364
|
+
- *Type:* string
|
|
2365
|
+
|
|
2366
|
+
Package's Homepage / Website.
|
|
2367
|
+
|
|
2368
|
+
---
|
|
2369
|
+
|
|
2370
|
+
##### `keywords`<sup>Optional</sup> <a name="keywords" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.keywords"></a>
|
|
2371
|
+
|
|
2372
|
+
```typescript
|
|
2373
|
+
public readonly keywords: string[];
|
|
2374
|
+
```
|
|
2375
|
+
|
|
2376
|
+
- *Type:* string[]
|
|
2377
|
+
|
|
2378
|
+
Keywords to include in `package.json`.
|
|
2379
|
+
|
|
2380
|
+
---
|
|
2381
|
+
|
|
2382
|
+
##### `license`<sup>Optional</sup> <a name="license" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.license"></a>
|
|
2383
|
+
|
|
2384
|
+
```typescript
|
|
2385
|
+
public readonly license: string;
|
|
2386
|
+
```
|
|
2387
|
+
|
|
2388
|
+
- *Type:* string
|
|
2389
|
+
- *Default:* "Apache-2.0"
|
|
2390
|
+
|
|
2391
|
+
License's SPDX identifier.
|
|
2392
|
+
|
|
2393
|
+
See https://github.com/projen/projen/tree/main/license-text for a list of supported licenses.
|
|
2394
|
+
Use the `licensed` option if you want to no license to be specified.
|
|
2395
|
+
|
|
2396
|
+
---
|
|
2397
|
+
|
|
2398
|
+
##### `licensed`<sup>Optional</sup> <a name="licensed" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.licensed"></a>
|
|
2399
|
+
|
|
2400
|
+
```typescript
|
|
2401
|
+
public readonly licensed: boolean;
|
|
2402
|
+
```
|
|
2403
|
+
|
|
2404
|
+
- *Type:* boolean
|
|
2405
|
+
- *Default:* true
|
|
2406
|
+
|
|
2407
|
+
Indicates if a license should be added.
|
|
2408
|
+
|
|
2409
|
+
---
|
|
2410
|
+
|
|
2411
|
+
##### `maxNodeVersion`<sup>Optional</sup> <a name="maxNodeVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.maxNodeVersion"></a>
|
|
2412
|
+
|
|
2413
|
+
```typescript
|
|
2414
|
+
public readonly maxNodeVersion: string;
|
|
2415
|
+
```
|
|
2416
|
+
|
|
2417
|
+
- *Type:* string
|
|
2418
|
+
- *Default:* no max
|
|
2419
|
+
|
|
2420
|
+
Minimum node.js version to require via `engines` (inclusive).
|
|
2421
|
+
|
|
2422
|
+
---
|
|
2423
|
+
|
|
2424
|
+
##### `minNodeVersion`<sup>Optional</sup> <a name="minNodeVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.minNodeVersion"></a>
|
|
2425
|
+
|
|
2426
|
+
```typescript
|
|
2427
|
+
public readonly minNodeVersion: string;
|
|
2428
|
+
```
|
|
2429
|
+
|
|
2430
|
+
- *Type:* string
|
|
2431
|
+
- *Default:* no "engines" specified
|
|
2432
|
+
|
|
2433
|
+
Minimum Node.js version to require via package.json `engines` (inclusive).
|
|
2434
|
+
|
|
2435
|
+
---
|
|
2436
|
+
|
|
2437
|
+
##### `npmAccess`<sup>Optional</sup> <a name="npmAccess" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmAccess"></a>
|
|
2438
|
+
|
|
2439
|
+
```typescript
|
|
2440
|
+
public readonly npmAccess: NpmAccess;
|
|
2441
|
+
```
|
|
2442
|
+
|
|
2443
|
+
- *Type:* projen.javascript.NpmAccess
|
|
2444
|
+
- *Default:* for scoped packages (e.g. `foo@bar`), the default is `NpmAccess.RESTRICTED`, for non-scoped packages, the default is `NpmAccess.PUBLIC`.
|
|
2445
|
+
|
|
2446
|
+
Access level of the npm package.
|
|
2447
|
+
|
|
2448
|
+
---
|
|
2449
|
+
|
|
2450
|
+
##### `npmProvenance`<sup>Optional</sup> <a name="npmProvenance" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmProvenance"></a>
|
|
2451
|
+
|
|
2452
|
+
```typescript
|
|
2453
|
+
public readonly npmProvenance: boolean;
|
|
2454
|
+
```
|
|
2455
|
+
|
|
2456
|
+
- *Type:* boolean
|
|
2457
|
+
- *Default:* true for public packages, false otherwise
|
|
2458
|
+
|
|
2459
|
+
Should provenance statements be generated when the package is published.
|
|
2460
|
+
|
|
2461
|
+
A supported package manager is required to publish a package with npm provenance statements and
|
|
2462
|
+
you will need to use a supported CI/CD provider.
|
|
2463
|
+
|
|
2464
|
+
Note that the projen `Release` and `Publisher` components are using `publib` to publish packages,
|
|
2465
|
+
which is using npm internally and supports provenance statements independently of the package manager used.
|
|
2466
|
+
|
|
2467
|
+
> [https://docs.npmjs.com/generating-provenance-statements](https://docs.npmjs.com/generating-provenance-statements)
|
|
2468
|
+
|
|
2469
|
+
---
|
|
2470
|
+
|
|
2471
|
+
##### ~~`npmRegistry`~~<sup>Optional</sup> <a name="npmRegistry" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmRegistry"></a>
|
|
2472
|
+
|
|
2473
|
+
- *Deprecated:* use `npmRegistryUrl` instead
|
|
2474
|
+
|
|
2475
|
+
```typescript
|
|
2476
|
+
public readonly npmRegistry: string;
|
|
2477
|
+
```
|
|
2478
|
+
|
|
2479
|
+
- *Type:* string
|
|
2480
|
+
|
|
2481
|
+
The host name of the npm registry to publish to.
|
|
2482
|
+
|
|
2483
|
+
Cannot be set together with `npmRegistryUrl`.
|
|
2484
|
+
|
|
2485
|
+
---
|
|
2486
|
+
|
|
2487
|
+
##### `npmRegistryUrl`<sup>Optional</sup> <a name="npmRegistryUrl" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmRegistryUrl"></a>
|
|
2488
|
+
|
|
2489
|
+
```typescript
|
|
2490
|
+
public readonly npmRegistryUrl: string;
|
|
2491
|
+
```
|
|
2492
|
+
|
|
2493
|
+
- *Type:* string
|
|
2494
|
+
- *Default:* "https://registry.npmjs.org"
|
|
2495
|
+
|
|
2496
|
+
The base URL of the npm package registry.
|
|
2497
|
+
|
|
2498
|
+
Must be a URL (e.g. start with "https://" or "http://")
|
|
2499
|
+
|
|
2500
|
+
---
|
|
2501
|
+
|
|
2502
|
+
##### `npmTokenSecret`<sup>Optional</sup> <a name="npmTokenSecret" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmTokenSecret"></a>
|
|
2503
|
+
|
|
2504
|
+
```typescript
|
|
2505
|
+
public readonly npmTokenSecret: string;
|
|
2506
|
+
```
|
|
2507
|
+
|
|
2508
|
+
- *Type:* string
|
|
2509
|
+
- *Default:* "NPM_TOKEN"
|
|
2510
|
+
|
|
2511
|
+
GitHub secret which contains the NPM token to use when publishing packages.
|
|
2512
|
+
|
|
2513
|
+
---
|
|
2514
|
+
|
|
2515
|
+
##### `packageManager`<sup>Optional</sup> <a name="packageManager" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.packageManager"></a>
|
|
2516
|
+
|
|
2517
|
+
```typescript
|
|
2518
|
+
public readonly packageManager: NodePackageManager;
|
|
2519
|
+
```
|
|
2520
|
+
|
|
2521
|
+
- *Type:* projen.javascript.NodePackageManager
|
|
2522
|
+
- *Default:* NodePackageManager.YARN_CLASSIC
|
|
2523
|
+
|
|
2524
|
+
The Node Package Manager used to execute scripts.
|
|
2525
|
+
|
|
2526
|
+
---
|
|
2527
|
+
|
|
2528
|
+
##### `packageName`<sup>Optional</sup> <a name="packageName" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.packageName"></a>
|
|
2529
|
+
|
|
2530
|
+
```typescript
|
|
2531
|
+
public readonly packageName: string;
|
|
2532
|
+
```
|
|
2533
|
+
|
|
2534
|
+
- *Type:* string
|
|
2535
|
+
- *Default:* defaults to project name
|
|
2536
|
+
|
|
2537
|
+
The "name" in package.json.
|
|
2538
|
+
|
|
2539
|
+
---
|
|
2540
|
+
|
|
2541
|
+
##### `peerDependencyOptions`<sup>Optional</sup> <a name="peerDependencyOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.peerDependencyOptions"></a>
|
|
2542
|
+
|
|
2543
|
+
```typescript
|
|
2544
|
+
public readonly peerDependencyOptions: PeerDependencyOptions;
|
|
2545
|
+
```
|
|
2546
|
+
|
|
2547
|
+
- *Type:* projen.javascript.PeerDependencyOptions
|
|
2548
|
+
|
|
2549
|
+
Options for `peerDeps`.
|
|
2550
|
+
|
|
2551
|
+
---
|
|
2552
|
+
|
|
2553
|
+
##### `peerDeps`<sup>Optional</sup> <a name="peerDeps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.peerDeps"></a>
|
|
2554
|
+
|
|
2555
|
+
```typescript
|
|
2556
|
+
public readonly peerDeps: string[];
|
|
2557
|
+
```
|
|
2558
|
+
|
|
2559
|
+
- *Type:* string[]
|
|
2560
|
+
- *Default:* []
|
|
2561
|
+
|
|
2562
|
+
Peer dependencies for this module.
|
|
2563
|
+
|
|
2564
|
+
Dependencies listed here are required to
|
|
2565
|
+
be installed (and satisfied) by the _consumer_ of this library. Using peer
|
|
2566
|
+
dependencies allows you to ensure that only a single module of a certain
|
|
2567
|
+
library exists in the `node_modules` tree of your consumers.
|
|
2568
|
+
|
|
2569
|
+
Note that prior to npm@7, peer dependencies are _not_ automatically
|
|
2570
|
+
installed, which means that adding peer dependencies to a library will be a
|
|
2571
|
+
breaking change for your customers.
|
|
2572
|
+
|
|
2573
|
+
Unless `peerDependencyOptions.pinnedDevDependency` is disabled (it is
|
|
2574
|
+
enabled by default), projen will automatically add a dev dependency with a
|
|
2575
|
+
pinned version for each peer dependency. This will ensure that you build &
|
|
2576
|
+
test your module against the lowest peer version required.
|
|
2577
|
+
|
|
2578
|
+
---
|
|
2579
|
+
|
|
2580
|
+
##### `pnpmVersion`<sup>Optional</sup> <a name="pnpmVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.pnpmVersion"></a>
|
|
2581
|
+
|
|
2582
|
+
```typescript
|
|
2583
|
+
public readonly pnpmVersion: string;
|
|
2584
|
+
```
|
|
2585
|
+
|
|
2586
|
+
- *Type:* string
|
|
2587
|
+
- *Default:* "7"
|
|
2588
|
+
|
|
2589
|
+
The version of PNPM to use if using PNPM as a package manager.
|
|
2590
|
+
|
|
2591
|
+
---
|
|
2592
|
+
|
|
2593
|
+
##### `repository`<sup>Optional</sup> <a name="repository" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.repository"></a>
|
|
2594
|
+
|
|
2595
|
+
```typescript
|
|
2596
|
+
public readonly repository: string;
|
|
2597
|
+
```
|
|
2598
|
+
|
|
2599
|
+
- *Type:* string
|
|
2600
|
+
|
|
2601
|
+
The repository is the location where the actual code for your package lives.
|
|
2602
|
+
|
|
2603
|
+
See https://classic.yarnpkg.com/en/docs/package-json/#toc-repository
|
|
2604
|
+
|
|
2605
|
+
---
|
|
2606
|
+
|
|
2607
|
+
##### `repositoryDirectory`<sup>Optional</sup> <a name="repositoryDirectory" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.repositoryDirectory"></a>
|
|
2608
|
+
|
|
2609
|
+
```typescript
|
|
2610
|
+
public readonly repositoryDirectory: string;
|
|
2611
|
+
```
|
|
2612
|
+
|
|
2613
|
+
- *Type:* string
|
|
2614
|
+
|
|
2615
|
+
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.
|
|
2616
|
+
|
|
2617
|
+
---
|
|
2618
|
+
|
|
2619
|
+
##### `scopedPackagesOptions`<sup>Optional</sup> <a name="scopedPackagesOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.scopedPackagesOptions"></a>
|
|
2620
|
+
|
|
2621
|
+
```typescript
|
|
2622
|
+
public readonly scopedPackagesOptions: ScopedPackagesOptions[];
|
|
2623
|
+
```
|
|
2624
|
+
|
|
2625
|
+
- *Type:* projen.javascript.ScopedPackagesOptions[]
|
|
2626
|
+
- *Default:* fetch all scoped packages from the public npm registry
|
|
2627
|
+
|
|
2628
|
+
Options for privately hosted scoped packages.
|
|
2629
|
+
|
|
2630
|
+
---
|
|
2631
|
+
|
|
2632
|
+
##### ~~`scripts`~~<sup>Optional</sup> <a name="scripts" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.scripts"></a>
|
|
2633
|
+
|
|
2634
|
+
- *Deprecated:* use `project.addTask()` or `package.setScript()`
|
|
2635
|
+
|
|
2636
|
+
```typescript
|
|
2637
|
+
public readonly scripts: {[ key: string ]: string};
|
|
2638
|
+
```
|
|
2639
|
+
|
|
2640
|
+
- *Type:* {[ key: string ]: string}
|
|
2641
|
+
- *Default:* {}
|
|
2642
|
+
|
|
2643
|
+
npm scripts to include.
|
|
2644
|
+
|
|
2645
|
+
If a script has the same name as a standard script,
|
|
2646
|
+
the standard script will be overwritten.
|
|
2647
|
+
Also adds the script as a task.
|
|
2648
|
+
|
|
2649
|
+
---
|
|
2650
|
+
|
|
2651
|
+
##### `stability`<sup>Optional</sup> <a name="stability" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.stability"></a>
|
|
2652
|
+
|
|
2653
|
+
```typescript
|
|
2654
|
+
public readonly stability: string;
|
|
2655
|
+
```
|
|
2656
|
+
|
|
2657
|
+
- *Type:* string
|
|
2658
|
+
|
|
2659
|
+
Package's Stability.
|
|
2660
|
+
|
|
2661
|
+
---
|
|
2662
|
+
|
|
2663
|
+
##### `yarnBerryOptions`<sup>Optional</sup> <a name="yarnBerryOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.yarnBerryOptions"></a>
|
|
2664
|
+
|
|
2665
|
+
```typescript
|
|
2666
|
+
public readonly yarnBerryOptions: YarnBerryOptions;
|
|
2667
|
+
```
|
|
2668
|
+
|
|
2669
|
+
- *Type:* projen.javascript.YarnBerryOptions
|
|
2670
|
+
- *Default:* Yarn Berry v4 with all default options
|
|
2671
|
+
|
|
2672
|
+
Options for Yarn Berry.
|
|
2673
|
+
|
|
2674
|
+
---
|
|
2675
|
+
|
|
2676
|
+
##### `jsiiReleaseVersion`<sup>Optional</sup> <a name="jsiiReleaseVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.jsiiReleaseVersion"></a>
|
|
2677
|
+
|
|
2678
|
+
```typescript
|
|
2679
|
+
public readonly jsiiReleaseVersion: string;
|
|
2680
|
+
```
|
|
2681
|
+
|
|
2682
|
+
- *Type:* string
|
|
2683
|
+
- *Default:* "latest"
|
|
2684
|
+
|
|
2685
|
+
Version requirement of `publib` which is used to publish modules to npm.
|
|
2686
|
+
|
|
2687
|
+
---
|
|
2688
|
+
|
|
2689
|
+
##### `majorVersion`<sup>Optional</sup> <a name="majorVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.majorVersion"></a>
|
|
2690
|
+
|
|
2691
|
+
```typescript
|
|
2692
|
+
public readonly majorVersion: number;
|
|
2693
|
+
```
|
|
2694
|
+
|
|
2695
|
+
- *Type:* number
|
|
2696
|
+
- *Default:* Major version is not enforced.
|
|
2697
|
+
|
|
2698
|
+
Major version to release from the default branch.
|
|
2699
|
+
|
|
2700
|
+
If this is specified, we bump the latest version of this major version line.
|
|
2701
|
+
If not specified, we bump the global latest version.
|
|
2702
|
+
|
|
2703
|
+
---
|
|
2704
|
+
|
|
2705
|
+
##### `minMajorVersion`<sup>Optional</sup> <a name="minMajorVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.minMajorVersion"></a>
|
|
2706
|
+
|
|
2707
|
+
```typescript
|
|
2708
|
+
public readonly minMajorVersion: number;
|
|
2709
|
+
```
|
|
2710
|
+
|
|
2711
|
+
- *Type:* number
|
|
2712
|
+
- *Default:* No minimum version is being enforced
|
|
2713
|
+
|
|
2714
|
+
Minimal Major version to release.
|
|
2715
|
+
|
|
2716
|
+
This can be useful to set to 1, as breaking changes before the 1.x major
|
|
2717
|
+
release are not incrementing the major version number.
|
|
2718
|
+
|
|
2719
|
+
Can not be set together with `majorVersion`.
|
|
2720
|
+
|
|
2721
|
+
---
|
|
2722
|
+
|
|
2723
|
+
##### `npmDistTag`<sup>Optional</sup> <a name="npmDistTag" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmDistTag"></a>
|
|
2724
|
+
|
|
2725
|
+
```typescript
|
|
2726
|
+
public readonly npmDistTag: string;
|
|
2727
|
+
```
|
|
2728
|
+
|
|
2729
|
+
- *Type:* string
|
|
2730
|
+
- *Default:* "latest"
|
|
2731
|
+
|
|
2732
|
+
The npmDistTag to use when publishing from the default branch.
|
|
2733
|
+
|
|
2734
|
+
To set the npm dist-tag for release branches, set the `npmDistTag` property
|
|
2735
|
+
for each branch.
|
|
2736
|
+
|
|
2737
|
+
---
|
|
2738
|
+
|
|
2739
|
+
##### `postBuildSteps`<sup>Optional</sup> <a name="postBuildSteps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.postBuildSteps"></a>
|
|
2740
|
+
|
|
2741
|
+
```typescript
|
|
2742
|
+
public readonly postBuildSteps: JobStep[];
|
|
2743
|
+
```
|
|
2744
|
+
|
|
2745
|
+
- *Type:* projen.github.workflows.JobStep[]
|
|
2746
|
+
- *Default:* []
|
|
2747
|
+
|
|
2748
|
+
Steps to execute after build as part of the release workflow.
|
|
2749
|
+
|
|
2750
|
+
---
|
|
2751
|
+
|
|
2752
|
+
##### `prerelease`<sup>Optional</sup> <a name="prerelease" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.prerelease"></a>
|
|
2753
|
+
|
|
2754
|
+
```typescript
|
|
2755
|
+
public readonly prerelease: string;
|
|
2756
|
+
```
|
|
2757
|
+
|
|
2758
|
+
- *Type:* string
|
|
2759
|
+
- *Default:* normal semantic versions
|
|
2760
|
+
|
|
2761
|
+
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre").
|
|
2762
|
+
|
|
2763
|
+
---
|
|
2764
|
+
|
|
2765
|
+
##### `publishDryRun`<sup>Optional</sup> <a name="publishDryRun" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.publishDryRun"></a>
|
|
2766
|
+
|
|
2767
|
+
```typescript
|
|
2768
|
+
public readonly publishDryRun: boolean;
|
|
2769
|
+
```
|
|
2770
|
+
|
|
2771
|
+
- *Type:* boolean
|
|
2772
|
+
- *Default:* false
|
|
2773
|
+
|
|
2774
|
+
Instead of actually publishing to package managers, just print the publishing command.
|
|
2775
|
+
|
|
2776
|
+
---
|
|
2777
|
+
|
|
2778
|
+
##### `publishTasks`<sup>Optional</sup> <a name="publishTasks" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.publishTasks"></a>
|
|
2779
|
+
|
|
2780
|
+
```typescript
|
|
2781
|
+
public readonly publishTasks: boolean;
|
|
2782
|
+
```
|
|
2783
|
+
|
|
2784
|
+
- *Type:* boolean
|
|
2785
|
+
- *Default:* false
|
|
2786
|
+
|
|
2787
|
+
Define publishing tasks that can be executed manually as well as workflows.
|
|
2788
|
+
|
|
2789
|
+
Normally, publishing only happens within automated workflows. Enable this
|
|
2790
|
+
in order to create a publishing task for each publishing activity.
|
|
2791
|
+
|
|
2792
|
+
---
|
|
2793
|
+
|
|
2794
|
+
##### `releasableCommits`<sup>Optional</sup> <a name="releasableCommits" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releasableCommits"></a>
|
|
2795
|
+
|
|
2796
|
+
```typescript
|
|
2797
|
+
public readonly releasableCommits: ReleasableCommits;
|
|
2798
|
+
```
|
|
2799
|
+
|
|
2800
|
+
- *Type:* projen.ReleasableCommits
|
|
2801
|
+
- *Default:* ReleasableCommits.everyCommit()
|
|
2802
|
+
|
|
2803
|
+
Find commits that should be considered releasable Used to decide if a release is required.
|
|
2804
|
+
|
|
2805
|
+
---
|
|
2806
|
+
|
|
2807
|
+
##### `releaseBranches`<sup>Optional</sup> <a name="releaseBranches" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseBranches"></a>
|
|
2808
|
+
|
|
2809
|
+
```typescript
|
|
2810
|
+
public readonly releaseBranches: {[ key: string ]: BranchOptions};
|
|
2811
|
+
```
|
|
2812
|
+
|
|
2813
|
+
- *Type:* {[ key: string ]: projen.release.BranchOptions}
|
|
2814
|
+
- *Default:* no additional branches are used for release. you can use `addBranch()` to add additional branches.
|
|
2815
|
+
|
|
2816
|
+
Defines additional release branches.
|
|
2817
|
+
|
|
2818
|
+
A workflow will be created for each
|
|
2819
|
+
release branch which will publish releases from commits in this branch.
|
|
2820
|
+
Each release branch _must_ be assigned a major version number which is used
|
|
2821
|
+
to enforce that versions published from that branch always use that major
|
|
2822
|
+
version. If multiple branches are used, the `majorVersion` field must also
|
|
2823
|
+
be provided for the default branch.
|
|
2824
|
+
|
|
2825
|
+
---
|
|
2826
|
+
|
|
2827
|
+
##### ~~`releaseEveryCommit`~~<sup>Optional</sup> <a name="releaseEveryCommit" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseEveryCommit"></a>
|
|
2828
|
+
|
|
2829
|
+
- *Deprecated:* Use `releaseTrigger: ReleaseTrigger.continuous()` instead
|
|
2830
|
+
|
|
2831
|
+
```typescript
|
|
2832
|
+
public readonly releaseEveryCommit: boolean;
|
|
2833
|
+
```
|
|
2834
|
+
|
|
2835
|
+
- *Type:* boolean
|
|
2836
|
+
- *Default:* true
|
|
2837
|
+
|
|
2838
|
+
Automatically release new versions every commit to one of branches in `releaseBranches`.
|
|
2839
|
+
|
|
2840
|
+
---
|
|
2841
|
+
|
|
2842
|
+
##### `releaseFailureIssue`<sup>Optional</sup> <a name="releaseFailureIssue" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseFailureIssue"></a>
|
|
2843
|
+
|
|
2844
|
+
```typescript
|
|
2845
|
+
public readonly releaseFailureIssue: boolean;
|
|
2846
|
+
```
|
|
2847
|
+
|
|
2848
|
+
- *Type:* boolean
|
|
2849
|
+
- *Default:* false
|
|
2850
|
+
|
|
2851
|
+
Create a github issue on every failed publishing task.
|
|
2852
|
+
|
|
2853
|
+
---
|
|
2854
|
+
|
|
2855
|
+
##### `releaseFailureIssueLabel`<sup>Optional</sup> <a name="releaseFailureIssueLabel" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseFailureIssueLabel"></a>
|
|
2856
|
+
|
|
2857
|
+
```typescript
|
|
2858
|
+
public readonly releaseFailureIssueLabel: string;
|
|
2859
|
+
```
|
|
2860
|
+
|
|
2861
|
+
- *Type:* string
|
|
2862
|
+
- *Default:* "failed-release"
|
|
2863
|
+
|
|
2864
|
+
The label to apply to issues indicating publish failures.
|
|
2865
|
+
|
|
2866
|
+
Only applies if `releaseFailureIssue` is true.
|
|
2867
|
+
|
|
2868
|
+
---
|
|
2869
|
+
|
|
2870
|
+
##### ~~`releaseSchedule`~~<sup>Optional</sup> <a name="releaseSchedule" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseSchedule"></a>
|
|
2871
|
+
|
|
2872
|
+
- *Deprecated:* Use `releaseTrigger: ReleaseTrigger.scheduled()` instead
|
|
2873
|
+
|
|
2874
|
+
```typescript
|
|
2875
|
+
public readonly releaseSchedule: string;
|
|
2876
|
+
```
|
|
2877
|
+
|
|
2878
|
+
- *Type:* string
|
|
2879
|
+
- *Default:* no scheduled releases
|
|
2880
|
+
|
|
2881
|
+
CRON schedule to trigger new releases.
|
|
2882
|
+
|
|
2883
|
+
---
|
|
2884
|
+
|
|
2885
|
+
##### `releaseTagPrefix`<sup>Optional</sup> <a name="releaseTagPrefix" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseTagPrefix"></a>
|
|
2886
|
+
|
|
2887
|
+
```typescript
|
|
2888
|
+
public readonly releaseTagPrefix: string;
|
|
2889
|
+
```
|
|
2890
|
+
|
|
2891
|
+
- *Type:* string
|
|
2892
|
+
- *Default:* "v"
|
|
2893
|
+
|
|
2894
|
+
Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers.
|
|
2895
|
+
|
|
2896
|
+
Note: this prefix is used to detect the latest tagged version
|
|
2897
|
+
when bumping, so if you change this on a project with an existing version
|
|
2898
|
+
history, you may need to manually tag your latest release
|
|
2899
|
+
with the new prefix.
|
|
2900
|
+
|
|
2901
|
+
---
|
|
2902
|
+
|
|
2903
|
+
##### `releaseTrigger`<sup>Optional</sup> <a name="releaseTrigger" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseTrigger"></a>
|
|
2904
|
+
|
|
2905
|
+
```typescript
|
|
2906
|
+
public readonly releaseTrigger: ReleaseTrigger;
|
|
2907
|
+
```
|
|
2908
|
+
|
|
2909
|
+
- *Type:* projen.release.ReleaseTrigger
|
|
2910
|
+
- *Default:* Continuous releases (`ReleaseTrigger.continuous()`)
|
|
2911
|
+
|
|
2912
|
+
The release trigger to use.
|
|
2913
|
+
|
|
2914
|
+
---
|
|
2915
|
+
|
|
2916
|
+
##### `releaseWorkflowName`<sup>Optional</sup> <a name="releaseWorkflowName" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseWorkflowName"></a>
|
|
2917
|
+
|
|
2918
|
+
```typescript
|
|
2919
|
+
public readonly releaseWorkflowName: string;
|
|
2920
|
+
```
|
|
2921
|
+
|
|
2922
|
+
- *Type:* string
|
|
2923
|
+
- *Default:* "release"
|
|
2924
|
+
|
|
2925
|
+
The name of the default release workflow.
|
|
2926
|
+
|
|
2927
|
+
---
|
|
2928
|
+
|
|
2929
|
+
##### `releaseWorkflowSetupSteps`<sup>Optional</sup> <a name="releaseWorkflowSetupSteps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseWorkflowSetupSteps"></a>
|
|
2930
|
+
|
|
2931
|
+
```typescript
|
|
2932
|
+
public readonly releaseWorkflowSetupSteps: JobStep[];
|
|
2933
|
+
```
|
|
2934
|
+
|
|
2935
|
+
- *Type:* projen.github.workflows.JobStep[]
|
|
2936
|
+
|
|
2937
|
+
A set of workflow steps to execute in order to setup the workflow container.
|
|
2938
|
+
|
|
2939
|
+
---
|
|
2940
|
+
|
|
2941
|
+
##### `versionrcOptions`<sup>Optional</sup> <a name="versionrcOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.versionrcOptions"></a>
|
|
2942
|
+
|
|
2943
|
+
```typescript
|
|
2944
|
+
public readonly versionrcOptions: {[ key: string ]: any};
|
|
2945
|
+
```
|
|
2946
|
+
|
|
2947
|
+
- *Type:* {[ key: string ]: any}
|
|
2948
|
+
- *Default:* standard configuration applicable for GitHub repositories
|
|
2949
|
+
|
|
2950
|
+
Custom configuration used when creating changelog with commit-and-tag-version package.
|
|
2951
|
+
|
|
2952
|
+
Given values either append to default configuration or overwrite values in it.
|
|
2953
|
+
|
|
2954
|
+
---
|
|
2955
|
+
|
|
2956
|
+
##### `workflowContainerImage`<sup>Optional</sup> <a name="workflowContainerImage" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowContainerImage"></a>
|
|
2957
|
+
|
|
2958
|
+
```typescript
|
|
2959
|
+
public readonly workflowContainerImage: string;
|
|
2960
|
+
```
|
|
2961
|
+
|
|
2962
|
+
- *Type:* string
|
|
2963
|
+
- *Default:* default image
|
|
2964
|
+
|
|
2965
|
+
Container image to use for GitHub workflows.
|
|
2966
|
+
|
|
2967
|
+
---
|
|
2968
|
+
|
|
2969
|
+
##### `workflowRunsOn`<sup>Optional</sup> <a name="workflowRunsOn" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowRunsOn"></a>
|
|
2970
|
+
|
|
2971
|
+
```typescript
|
|
2972
|
+
public readonly workflowRunsOn: string[];
|
|
2973
|
+
```
|
|
2974
|
+
|
|
2975
|
+
- *Type:* string[]
|
|
2976
|
+
- *Default:* ["ubuntu-latest"]
|
|
2977
|
+
|
|
2978
|
+
Github Runner selection labels.
|
|
2979
|
+
|
|
2980
|
+
---
|
|
2981
|
+
|
|
2982
|
+
##### `workflowRunsOnGroup`<sup>Optional</sup> <a name="workflowRunsOnGroup" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowRunsOnGroup"></a>
|
|
2983
|
+
|
|
2984
|
+
```typescript
|
|
2985
|
+
public readonly workflowRunsOnGroup: GroupRunnerOptions;
|
|
2986
|
+
```
|
|
2987
|
+
|
|
2988
|
+
- *Type:* projen.GroupRunnerOptions
|
|
2989
|
+
|
|
2990
|
+
Github Runner Group selection options.
|
|
2991
|
+
|
|
2992
|
+
---
|
|
2993
|
+
|
|
2994
|
+
##### `defaultReleaseBranch`<sup>Required</sup> <a name="defaultReleaseBranch" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.defaultReleaseBranch"></a>
|
|
2995
|
+
|
|
2996
|
+
```typescript
|
|
2997
|
+
public readonly defaultReleaseBranch: string;
|
|
2998
|
+
```
|
|
2999
|
+
|
|
3000
|
+
- *Type:* string
|
|
3001
|
+
- *Default:* "main"
|
|
3002
|
+
|
|
3003
|
+
The name of the main release branch.
|
|
3004
|
+
|
|
3005
|
+
---
|
|
3006
|
+
|
|
3007
|
+
##### `artifactsDirectory`<sup>Optional</sup> <a name="artifactsDirectory" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.artifactsDirectory"></a>
|
|
3008
|
+
|
|
3009
|
+
```typescript
|
|
3010
|
+
public readonly artifactsDirectory: string;
|
|
3011
|
+
```
|
|
3012
|
+
|
|
3013
|
+
- *Type:* string
|
|
3014
|
+
- *Default:* "dist"
|
|
3015
|
+
|
|
3016
|
+
A directory which will contain build artifacts.
|
|
3017
|
+
|
|
3018
|
+
---
|
|
3019
|
+
|
|
3020
|
+
##### `autoApproveUpgrades`<sup>Optional</sup> <a name="autoApproveUpgrades" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.autoApproveUpgrades"></a>
|
|
3021
|
+
|
|
3022
|
+
```typescript
|
|
3023
|
+
public readonly autoApproveUpgrades: boolean;
|
|
3024
|
+
```
|
|
3025
|
+
|
|
3026
|
+
- *Type:* boolean
|
|
3027
|
+
- *Default:* true
|
|
3028
|
+
|
|
3029
|
+
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued).
|
|
3030
|
+
|
|
3031
|
+
Throw if set to true but `autoApproveOptions` are not defined.
|
|
3032
|
+
|
|
3033
|
+
---
|
|
3034
|
+
|
|
3035
|
+
##### `buildWorkflow`<sup>Optional</sup> <a name="buildWorkflow" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.buildWorkflow"></a>
|
|
3036
|
+
|
|
3037
|
+
```typescript
|
|
3038
|
+
public readonly buildWorkflow: boolean;
|
|
3039
|
+
```
|
|
3040
|
+
|
|
3041
|
+
- *Type:* boolean
|
|
3042
|
+
- *Default:* true if not a subproject
|
|
3043
|
+
|
|
3044
|
+
Define a GitHub workflow for building PRs.
|
|
3045
|
+
|
|
3046
|
+
---
|
|
3047
|
+
|
|
3048
|
+
##### `buildWorkflowOptions`<sup>Optional</sup> <a name="buildWorkflowOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.buildWorkflowOptions"></a>
|
|
3049
|
+
|
|
3050
|
+
```typescript
|
|
3051
|
+
public readonly buildWorkflowOptions: BuildWorkflowOptions;
|
|
3052
|
+
```
|
|
3053
|
+
|
|
3054
|
+
- *Type:* projen.javascript.BuildWorkflowOptions
|
|
3055
|
+
|
|
3056
|
+
Options for PR build workflow.
|
|
3057
|
+
|
|
3058
|
+
---
|
|
3059
|
+
|
|
3060
|
+
##### ~~`buildWorkflowTriggers`~~<sup>Optional</sup> <a name="buildWorkflowTriggers" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.buildWorkflowTriggers"></a>
|
|
3061
|
+
|
|
3062
|
+
- *Deprecated:* - Use `buildWorkflowOptions.workflowTriggers`
|
|
3063
|
+
|
|
3064
|
+
```typescript
|
|
3065
|
+
public readonly buildWorkflowTriggers: Triggers;
|
|
3066
|
+
```
|
|
3067
|
+
|
|
3068
|
+
- *Type:* projen.github.workflows.Triggers
|
|
3069
|
+
- *Default:* "{ pullRequest: {}, workflowDispatch: {} }"
|
|
3070
|
+
|
|
3071
|
+
Build workflow triggers.
|
|
3072
|
+
|
|
3073
|
+
---
|
|
3074
|
+
|
|
3075
|
+
##### `bundlerOptions`<sup>Optional</sup> <a name="bundlerOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.bundlerOptions"></a>
|
|
3076
|
+
|
|
3077
|
+
```typescript
|
|
3078
|
+
public readonly bundlerOptions: BundlerOptions;
|
|
3079
|
+
```
|
|
3080
|
+
|
|
3081
|
+
- *Type:* projen.javascript.BundlerOptions
|
|
3082
|
+
|
|
3083
|
+
Options for `Bundler`.
|
|
3084
|
+
|
|
3085
|
+
---
|
|
3086
|
+
|
|
3087
|
+
##### `checkLicenses`<sup>Optional</sup> <a name="checkLicenses" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.checkLicenses"></a>
|
|
3088
|
+
|
|
3089
|
+
```typescript
|
|
3090
|
+
public readonly checkLicenses: LicenseCheckerOptions;
|
|
3091
|
+
```
|
|
3092
|
+
|
|
3093
|
+
- *Type:* projen.javascript.LicenseCheckerOptions
|
|
3094
|
+
- *Default:* no license checks are run during the build and all licenses will be accepted
|
|
3095
|
+
|
|
3096
|
+
Configure which licenses should be deemed acceptable for use by dependencies.
|
|
3097
|
+
|
|
3098
|
+
This setting will cause the build to fail, if any prohibited or not allowed licenses ares encountered.
|
|
3099
|
+
|
|
3100
|
+
---
|
|
3101
|
+
|
|
3102
|
+
##### `codeCov`<sup>Optional</sup> <a name="codeCov" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.codeCov"></a>
|
|
3103
|
+
|
|
3104
|
+
```typescript
|
|
3105
|
+
public readonly codeCov: boolean;
|
|
3106
|
+
```
|
|
3107
|
+
|
|
3108
|
+
- *Type:* boolean
|
|
3109
|
+
- *Default:* false
|
|
3110
|
+
|
|
3111
|
+
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`.
|
|
3112
|
+
|
|
3113
|
+
---
|
|
3114
|
+
|
|
3115
|
+
##### `codeCovTokenSecret`<sup>Optional</sup> <a name="codeCovTokenSecret" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.codeCovTokenSecret"></a>
|
|
3116
|
+
|
|
3117
|
+
```typescript
|
|
3118
|
+
public readonly codeCovTokenSecret: string;
|
|
3119
|
+
```
|
|
3120
|
+
|
|
3121
|
+
- *Type:* string
|
|
3122
|
+
- *Default:* if this option is not specified, only public repositories are supported
|
|
3123
|
+
|
|
3124
|
+
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories.
|
|
3125
|
+
|
|
3126
|
+
---
|
|
3127
|
+
|
|
3128
|
+
##### `copyrightOwner`<sup>Optional</sup> <a name="copyrightOwner" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.copyrightOwner"></a>
|
|
3129
|
+
|
|
3130
|
+
```typescript
|
|
3131
|
+
public readonly copyrightOwner: string;
|
|
3132
|
+
```
|
|
3133
|
+
|
|
3134
|
+
- *Type:* string
|
|
3135
|
+
- *Default:* defaults to the value of authorName or "" if `authorName` is undefined.
|
|
3136
|
+
|
|
3137
|
+
License copyright owner.
|
|
3138
|
+
|
|
3139
|
+
---
|
|
3140
|
+
|
|
3141
|
+
##### `copyrightPeriod`<sup>Optional</sup> <a name="copyrightPeriod" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.copyrightPeriod"></a>
|
|
3142
|
+
|
|
3143
|
+
```typescript
|
|
3144
|
+
public readonly copyrightPeriod: string;
|
|
3145
|
+
```
|
|
3146
|
+
|
|
3147
|
+
- *Type:* string
|
|
3148
|
+
- *Default:* current year
|
|
3149
|
+
|
|
3150
|
+
The copyright years to put in the LICENSE file.
|
|
3151
|
+
|
|
3152
|
+
---
|
|
3153
|
+
|
|
3154
|
+
##### `dependabot`<sup>Optional</sup> <a name="dependabot" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.dependabot"></a>
|
|
3155
|
+
|
|
3156
|
+
```typescript
|
|
3157
|
+
public readonly dependabot: boolean;
|
|
3158
|
+
```
|
|
3159
|
+
|
|
3160
|
+
- *Type:* boolean
|
|
3161
|
+
- *Default:* false
|
|
3162
|
+
|
|
3163
|
+
Use dependabot to handle dependency upgrades.
|
|
3164
|
+
|
|
3165
|
+
Cannot be used in conjunction with `depsUpgrade`.
|
|
3166
|
+
|
|
3167
|
+
---
|
|
3168
|
+
|
|
3169
|
+
##### `dependabotOptions`<sup>Optional</sup> <a name="dependabotOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.dependabotOptions"></a>
|
|
3170
|
+
|
|
3171
|
+
```typescript
|
|
3172
|
+
public readonly dependabotOptions: DependabotOptions;
|
|
3173
|
+
```
|
|
3174
|
+
|
|
3175
|
+
- *Type:* projen.github.DependabotOptions
|
|
3176
|
+
- *Default:* default options
|
|
3177
|
+
|
|
3178
|
+
Options for dependabot.
|
|
3179
|
+
|
|
3180
|
+
---
|
|
3181
|
+
|
|
3182
|
+
##### `depsUpgrade`<sup>Optional</sup> <a name="depsUpgrade" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.depsUpgrade"></a>
|
|
3183
|
+
|
|
3184
|
+
```typescript
|
|
3185
|
+
public readonly depsUpgrade: boolean;
|
|
3186
|
+
```
|
|
3187
|
+
|
|
3188
|
+
- *Type:* boolean
|
|
3189
|
+
- *Default:* true
|
|
3190
|
+
|
|
3191
|
+
Use tasks and github workflows to handle dependency upgrades.
|
|
3192
|
+
|
|
3193
|
+
Cannot be used in conjunction with `dependabot`.
|
|
3194
|
+
|
|
3195
|
+
---
|
|
3196
|
+
|
|
3197
|
+
##### `depsUpgradeOptions`<sup>Optional</sup> <a name="depsUpgradeOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.depsUpgradeOptions"></a>
|
|
3198
|
+
|
|
3199
|
+
```typescript
|
|
3200
|
+
public readonly depsUpgradeOptions: UpgradeDependenciesOptions;
|
|
3201
|
+
```
|
|
3202
|
+
|
|
3203
|
+
- *Type:* projen.javascript.UpgradeDependenciesOptions
|
|
3204
|
+
- *Default:* default options
|
|
3205
|
+
|
|
3206
|
+
Options for `UpgradeDependencies`.
|
|
3207
|
+
|
|
3208
|
+
---
|
|
3209
|
+
|
|
3210
|
+
##### `gitignore`<sup>Optional</sup> <a name="gitignore" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.gitignore"></a>
|
|
3211
|
+
|
|
3212
|
+
```typescript
|
|
3213
|
+
public readonly gitignore: string[];
|
|
3214
|
+
```
|
|
3215
|
+
|
|
3216
|
+
- *Type:* string[]
|
|
3217
|
+
|
|
3218
|
+
Additional entries to .gitignore.
|
|
3219
|
+
|
|
3220
|
+
---
|
|
3221
|
+
|
|
3222
|
+
##### `jest`<sup>Optional</sup> <a name="jest" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.jest"></a>
|
|
3223
|
+
|
|
3224
|
+
```typescript
|
|
3225
|
+
public readonly jest: boolean;
|
|
3226
|
+
```
|
|
3227
|
+
|
|
3228
|
+
- *Type:* boolean
|
|
3229
|
+
- *Default:* true
|
|
3230
|
+
|
|
3231
|
+
Setup jest unit tests.
|
|
3232
|
+
|
|
3233
|
+
---
|
|
3234
|
+
|
|
3235
|
+
##### `jestOptions`<sup>Optional</sup> <a name="jestOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.jestOptions"></a>
|
|
3236
|
+
|
|
3237
|
+
```typescript
|
|
3238
|
+
public readonly jestOptions: JestOptions;
|
|
3239
|
+
```
|
|
3240
|
+
|
|
3241
|
+
- *Type:* projen.javascript.JestOptions
|
|
3242
|
+
- *Default:* default options
|
|
3243
|
+
|
|
3244
|
+
Jest options.
|
|
3245
|
+
|
|
3246
|
+
---
|
|
3247
|
+
|
|
3248
|
+
##### ~~`mutableBuild`~~<sup>Optional</sup> <a name="mutableBuild" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.mutableBuild"></a>
|
|
3249
|
+
|
|
3250
|
+
- *Deprecated:* - Use `buildWorkflowOptions.mutableBuild`
|
|
3251
|
+
|
|
3252
|
+
```typescript
|
|
3253
|
+
public readonly mutableBuild: boolean;
|
|
3254
|
+
```
|
|
3255
|
+
|
|
3256
|
+
- *Type:* boolean
|
|
3257
|
+
- *Default:* true
|
|
3258
|
+
|
|
3259
|
+
Automatically update files modified during builds to pull-request branches.
|
|
3260
|
+
|
|
3261
|
+
This means
|
|
3262
|
+
that any files synthesized by projen or e.g. test snapshots will always be up-to-date
|
|
3263
|
+
before a PR is merged.
|
|
3264
|
+
|
|
3265
|
+
Implies that PR builds do not have anti-tamper checks.
|
|
3266
|
+
|
|
3267
|
+
---
|
|
3268
|
+
|
|
3269
|
+
##### ~~`npmignore`~~<sup>Optional</sup> <a name="npmignore" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmignore"></a>
|
|
3270
|
+
|
|
3271
|
+
- *Deprecated:* - use `project.addPackageIgnore`
|
|
3272
|
+
|
|
3273
|
+
```typescript
|
|
3274
|
+
public readonly npmignore: string[];
|
|
3275
|
+
```
|
|
3276
|
+
|
|
3277
|
+
- *Type:* string[]
|
|
3278
|
+
|
|
3279
|
+
Additional entries to .npmignore.
|
|
3280
|
+
|
|
3281
|
+
---
|
|
3282
|
+
|
|
3283
|
+
##### `npmignoreEnabled`<sup>Optional</sup> <a name="npmignoreEnabled" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmignoreEnabled"></a>
|
|
3284
|
+
|
|
3285
|
+
```typescript
|
|
3286
|
+
public readonly npmignoreEnabled: boolean;
|
|
3287
|
+
```
|
|
3288
|
+
|
|
3289
|
+
- *Type:* boolean
|
|
3290
|
+
- *Default:* true
|
|
3291
|
+
|
|
3292
|
+
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs.
|
|
3293
|
+
|
|
3294
|
+
---
|
|
3295
|
+
|
|
3296
|
+
##### `npmIgnoreOptions`<sup>Optional</sup> <a name="npmIgnoreOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.npmIgnoreOptions"></a>
|
|
3297
|
+
|
|
3298
|
+
```typescript
|
|
3299
|
+
public readonly npmIgnoreOptions: IgnoreFileOptions;
|
|
3300
|
+
```
|
|
3301
|
+
|
|
3302
|
+
- *Type:* projen.IgnoreFileOptions
|
|
3303
|
+
|
|
3304
|
+
Configuration options for .npmignore file.
|
|
3305
|
+
|
|
3306
|
+
---
|
|
3307
|
+
|
|
3308
|
+
##### `package`<sup>Optional</sup> <a name="package" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.package"></a>
|
|
3309
|
+
|
|
3310
|
+
```typescript
|
|
3311
|
+
public readonly package: boolean;
|
|
3312
|
+
```
|
|
3313
|
+
|
|
3314
|
+
- *Type:* boolean
|
|
3315
|
+
- *Default:* true
|
|
3316
|
+
|
|
3317
|
+
Defines a `package` task that will produce an npm tarball under the artifacts directory (e.g. `dist`).
|
|
3318
|
+
|
|
3319
|
+
---
|
|
3320
|
+
|
|
3321
|
+
##### `prettier`<sup>Optional</sup> <a name="prettier" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.prettier"></a>
|
|
3322
|
+
|
|
3323
|
+
```typescript
|
|
3324
|
+
public readonly prettier: boolean;
|
|
3325
|
+
```
|
|
3326
|
+
|
|
3327
|
+
- *Type:* boolean
|
|
3328
|
+
- *Default:* false
|
|
3329
|
+
|
|
3330
|
+
Setup prettier.
|
|
3331
|
+
|
|
3332
|
+
---
|
|
3333
|
+
|
|
3334
|
+
##### `prettierOptions`<sup>Optional</sup> <a name="prettierOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.prettierOptions"></a>
|
|
3335
|
+
|
|
3336
|
+
```typescript
|
|
3337
|
+
public readonly prettierOptions: PrettierOptions;
|
|
3338
|
+
```
|
|
3339
|
+
|
|
3340
|
+
- *Type:* projen.javascript.PrettierOptions
|
|
3341
|
+
- *Default:* default options
|
|
3342
|
+
|
|
3343
|
+
Prettier options.
|
|
3344
|
+
|
|
3345
|
+
---
|
|
3346
|
+
|
|
3347
|
+
##### `projenDevDependency`<sup>Optional</sup> <a name="projenDevDependency" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenDevDependency"></a>
|
|
3348
|
+
|
|
3349
|
+
```typescript
|
|
3350
|
+
public readonly projenDevDependency: boolean;
|
|
3351
|
+
```
|
|
3352
|
+
|
|
3353
|
+
- *Type:* boolean
|
|
3354
|
+
- *Default:* true if not a subproject
|
|
3355
|
+
|
|
3356
|
+
Indicates of "projen" should be installed as a devDependency.
|
|
3357
|
+
|
|
3358
|
+
---
|
|
3359
|
+
|
|
3360
|
+
##### `projenrcJs`<sup>Optional</sup> <a name="projenrcJs" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJs"></a>
|
|
3361
|
+
|
|
3362
|
+
```typescript
|
|
3363
|
+
public readonly projenrcJs: boolean;
|
|
3364
|
+
```
|
|
3365
|
+
|
|
3366
|
+
- *Type:* boolean
|
|
3367
|
+
- *Default:* true if projenrcJson is false
|
|
3368
|
+
|
|
3369
|
+
Generate (once) .projenrc.js (in JavaScript). Set to `false` in order to disable .projenrc.js generation.
|
|
3370
|
+
|
|
3371
|
+
---
|
|
3372
|
+
|
|
3373
|
+
##### `projenrcJsOptions`<sup>Optional</sup> <a name="projenrcJsOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcJsOptions"></a>
|
|
3374
|
+
|
|
3375
|
+
```typescript
|
|
3376
|
+
public readonly projenrcJsOptions: ProjenrcOptions;
|
|
3377
|
+
```
|
|
3378
|
+
|
|
3379
|
+
- *Type:* projen.javascript.ProjenrcOptions
|
|
3380
|
+
- *Default:* default options
|
|
3381
|
+
|
|
3382
|
+
Options for .projenrc.js.
|
|
3383
|
+
|
|
3384
|
+
---
|
|
3385
|
+
|
|
3386
|
+
##### `projenVersion`<sup>Optional</sup> <a name="projenVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenVersion"></a>
|
|
3387
|
+
|
|
3388
|
+
```typescript
|
|
3389
|
+
public readonly projenVersion: string;
|
|
3390
|
+
```
|
|
3391
|
+
|
|
3392
|
+
- *Type:* string
|
|
3393
|
+
- *Default:* Defaults to the latest version.
|
|
3394
|
+
|
|
3395
|
+
Version of projen to install.
|
|
3396
|
+
|
|
3397
|
+
---
|
|
3398
|
+
|
|
3399
|
+
##### `pullRequestTemplate`<sup>Optional</sup> <a name="pullRequestTemplate" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.pullRequestTemplate"></a>
|
|
3400
|
+
|
|
3401
|
+
```typescript
|
|
3402
|
+
public readonly pullRequestTemplate: boolean;
|
|
3403
|
+
```
|
|
3404
|
+
|
|
3405
|
+
- *Type:* boolean
|
|
3406
|
+
- *Default:* true
|
|
3407
|
+
|
|
3408
|
+
Include a GitHub pull request template.
|
|
3409
|
+
|
|
3410
|
+
---
|
|
3411
|
+
|
|
3412
|
+
##### `pullRequestTemplateContents`<sup>Optional</sup> <a name="pullRequestTemplateContents" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.pullRequestTemplateContents"></a>
|
|
3413
|
+
|
|
3414
|
+
```typescript
|
|
3415
|
+
public readonly pullRequestTemplateContents: string[];
|
|
3416
|
+
```
|
|
3417
|
+
|
|
3418
|
+
- *Type:* string[]
|
|
3419
|
+
- *Default:* default content
|
|
3420
|
+
|
|
3421
|
+
The contents of the pull request template.
|
|
3422
|
+
|
|
3423
|
+
---
|
|
3424
|
+
|
|
3425
|
+
##### `release`<sup>Optional</sup> <a name="release" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.release"></a>
|
|
3426
|
+
|
|
3427
|
+
```typescript
|
|
3428
|
+
public readonly release: boolean;
|
|
3429
|
+
```
|
|
3430
|
+
|
|
3431
|
+
- *Type:* boolean
|
|
3432
|
+
- *Default:* true (false for subprojects)
|
|
3433
|
+
|
|
3434
|
+
Add release management to this project.
|
|
3435
|
+
|
|
3436
|
+
---
|
|
3437
|
+
|
|
3438
|
+
##### `releaseToNpm`<sup>Optional</sup> <a name="releaseToNpm" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseToNpm"></a>
|
|
3439
|
+
|
|
3440
|
+
```typescript
|
|
3441
|
+
public readonly releaseToNpm: boolean;
|
|
3442
|
+
```
|
|
3443
|
+
|
|
3444
|
+
- *Type:* boolean
|
|
3445
|
+
- *Default:* false
|
|
3446
|
+
|
|
3447
|
+
Automatically release to npm when new versions are introduced.
|
|
3448
|
+
|
|
3449
|
+
---
|
|
3450
|
+
|
|
3451
|
+
##### ~~`releaseWorkflow`~~<sup>Optional</sup> <a name="releaseWorkflow" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.releaseWorkflow"></a>
|
|
3452
|
+
|
|
3453
|
+
- *Deprecated:* see `release`.
|
|
3454
|
+
|
|
3455
|
+
```typescript
|
|
3456
|
+
public readonly releaseWorkflow: boolean;
|
|
3457
|
+
```
|
|
3458
|
+
|
|
3459
|
+
- *Type:* boolean
|
|
3460
|
+
- *Default:* true if not a subproject
|
|
3461
|
+
|
|
3462
|
+
DEPRECATED: renamed to `release`.
|
|
3463
|
+
|
|
3464
|
+
---
|
|
3465
|
+
|
|
3466
|
+
##### `workflowBootstrapSteps`<sup>Optional</sup> <a name="workflowBootstrapSteps" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowBootstrapSteps"></a>
|
|
3467
|
+
|
|
3468
|
+
```typescript
|
|
3469
|
+
public readonly workflowBootstrapSteps: JobStep[];
|
|
3470
|
+
```
|
|
3471
|
+
|
|
3472
|
+
- *Type:* projen.github.workflows.JobStep[]
|
|
3473
|
+
- *Default:* "yarn install --frozen-lockfile && yarn projen"
|
|
3474
|
+
|
|
3475
|
+
Workflow steps to use in order to bootstrap this repo.
|
|
3476
|
+
|
|
3477
|
+
---
|
|
3478
|
+
|
|
3479
|
+
##### `workflowGitIdentity`<sup>Optional</sup> <a name="workflowGitIdentity" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowGitIdentity"></a>
|
|
3480
|
+
|
|
3481
|
+
```typescript
|
|
3482
|
+
public readonly workflowGitIdentity: GitIdentity;
|
|
3483
|
+
```
|
|
3484
|
+
|
|
3485
|
+
- *Type:* projen.github.GitIdentity
|
|
3486
|
+
- *Default:* GitHub Actions
|
|
3487
|
+
|
|
3488
|
+
The git identity to use in workflows.
|
|
3489
|
+
|
|
3490
|
+
---
|
|
3491
|
+
|
|
3492
|
+
##### `workflowNodeVersion`<sup>Optional</sup> <a name="workflowNodeVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowNodeVersion"></a>
|
|
3493
|
+
|
|
3494
|
+
```typescript
|
|
3495
|
+
public readonly workflowNodeVersion: string;
|
|
3496
|
+
```
|
|
3497
|
+
|
|
3498
|
+
- *Type:* string
|
|
3499
|
+
- *Default:* same as `minNodeVersion`
|
|
3500
|
+
|
|
3501
|
+
The node version to use in GitHub workflows.
|
|
3502
|
+
|
|
3503
|
+
---
|
|
3504
|
+
|
|
3505
|
+
##### `workflowPackageCache`<sup>Optional</sup> <a name="workflowPackageCache" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.workflowPackageCache"></a>
|
|
3506
|
+
|
|
3507
|
+
```typescript
|
|
3508
|
+
public readonly workflowPackageCache: boolean;
|
|
3509
|
+
```
|
|
3510
|
+
|
|
3511
|
+
- *Type:* boolean
|
|
3512
|
+
- *Default:* false
|
|
3513
|
+
|
|
3514
|
+
Enable Node.js package cache in GitHub workflows.
|
|
3515
|
+
|
|
3516
|
+
---
|
|
3517
|
+
|
|
3518
|
+
##### `disableTsconfig`<sup>Optional</sup> <a name="disableTsconfig" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.disableTsconfig"></a>
|
|
3519
|
+
|
|
3520
|
+
```typescript
|
|
3521
|
+
public readonly disableTsconfig: boolean;
|
|
3522
|
+
```
|
|
3523
|
+
|
|
3524
|
+
- *Type:* boolean
|
|
3525
|
+
- *Default:* false
|
|
3526
|
+
|
|
3527
|
+
Do not generate a `tsconfig.json` file (used by jsii projects since tsconfig.json is generated by the jsii compiler).
|
|
3528
|
+
|
|
3529
|
+
---
|
|
3530
|
+
|
|
3531
|
+
##### `disableTsconfigDev`<sup>Optional</sup> <a name="disableTsconfigDev" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.disableTsconfigDev"></a>
|
|
3532
|
+
|
|
3533
|
+
```typescript
|
|
3534
|
+
public readonly disableTsconfigDev: boolean;
|
|
3535
|
+
```
|
|
3536
|
+
|
|
3537
|
+
- *Type:* boolean
|
|
3538
|
+
- *Default:* false
|
|
3539
|
+
|
|
3540
|
+
Do not generate a `tsconfig.dev.json` file.
|
|
3541
|
+
|
|
3542
|
+
---
|
|
3543
|
+
|
|
3544
|
+
##### `docgen`<sup>Optional</sup> <a name="docgen" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.docgen"></a>
|
|
3545
|
+
|
|
3546
|
+
```typescript
|
|
3547
|
+
public readonly docgen: boolean;
|
|
3548
|
+
```
|
|
3549
|
+
|
|
3550
|
+
- *Type:* boolean
|
|
3551
|
+
- *Default:* false
|
|
3552
|
+
|
|
3553
|
+
Docgen by Typedoc.
|
|
3554
|
+
|
|
3555
|
+
---
|
|
3556
|
+
|
|
3557
|
+
##### `docsDirectory`<sup>Optional</sup> <a name="docsDirectory" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.docsDirectory"></a>
|
|
3558
|
+
|
|
3559
|
+
```typescript
|
|
3560
|
+
public readonly docsDirectory: string;
|
|
3561
|
+
```
|
|
3562
|
+
|
|
3563
|
+
- *Type:* string
|
|
3564
|
+
- *Default:* "docs"
|
|
3565
|
+
|
|
3566
|
+
Docs directory.
|
|
3567
|
+
|
|
3568
|
+
---
|
|
3569
|
+
|
|
3570
|
+
##### `entrypointTypes`<sup>Optional</sup> <a name="entrypointTypes" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.entrypointTypes"></a>
|
|
3571
|
+
|
|
3572
|
+
```typescript
|
|
3573
|
+
public readonly entrypointTypes: string;
|
|
3574
|
+
```
|
|
3575
|
+
|
|
3576
|
+
- *Type:* string
|
|
3577
|
+
- *Default:* .d.ts file derived from the project's entrypoint (usually lib/index.d.ts)
|
|
3578
|
+
|
|
3579
|
+
The .d.ts file that includes the type declarations for this module.
|
|
3580
|
+
|
|
3581
|
+
---
|
|
3582
|
+
|
|
3583
|
+
##### `eslint`<sup>Optional</sup> <a name="eslint" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.eslint"></a>
|
|
3584
|
+
|
|
3585
|
+
```typescript
|
|
3586
|
+
public readonly eslint: boolean;
|
|
3587
|
+
```
|
|
3588
|
+
|
|
3589
|
+
- *Type:* boolean
|
|
3590
|
+
- *Default:* true
|
|
3591
|
+
|
|
3592
|
+
Setup eslint.
|
|
3593
|
+
|
|
3594
|
+
---
|
|
3595
|
+
|
|
3596
|
+
##### `eslintOptions`<sup>Optional</sup> <a name="eslintOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.eslintOptions"></a>
|
|
3597
|
+
|
|
3598
|
+
```typescript
|
|
3599
|
+
public readonly eslintOptions: EslintOptions;
|
|
3600
|
+
```
|
|
3601
|
+
|
|
3602
|
+
- *Type:* projen.javascript.EslintOptions
|
|
3603
|
+
- *Default:* opinionated default options
|
|
3604
|
+
|
|
3605
|
+
Eslint options.
|
|
3606
|
+
|
|
3607
|
+
---
|
|
3608
|
+
|
|
3609
|
+
##### `libdir`<sup>Optional</sup> <a name="libdir" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.libdir"></a>
|
|
3610
|
+
|
|
3611
|
+
```typescript
|
|
3612
|
+
public readonly libdir: string;
|
|
3613
|
+
```
|
|
3614
|
+
|
|
3615
|
+
- *Type:* string
|
|
3616
|
+
- *Default:* "lib"
|
|
3617
|
+
|
|
3618
|
+
Typescript artifacts output directory.
|
|
3619
|
+
|
|
3620
|
+
---
|
|
3621
|
+
|
|
3622
|
+
##### `projenrcTs`<sup>Optional</sup> <a name="projenrcTs" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcTs"></a>
|
|
3623
|
+
|
|
3624
|
+
```typescript
|
|
3625
|
+
public readonly projenrcTs: boolean;
|
|
3626
|
+
```
|
|
3627
|
+
|
|
3628
|
+
- *Type:* boolean
|
|
3629
|
+
- *Default:* false
|
|
3630
|
+
|
|
3631
|
+
Use TypeScript for your projenrc file (`.projenrc.ts`).
|
|
3632
|
+
|
|
3633
|
+
---
|
|
3634
|
+
|
|
3635
|
+
##### `projenrcTsOptions`<sup>Optional</sup> <a name="projenrcTsOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.projenrcTsOptions"></a>
|
|
3636
|
+
|
|
3637
|
+
```typescript
|
|
3638
|
+
public readonly projenrcTsOptions: ProjenrcOptions;
|
|
3639
|
+
```
|
|
3640
|
+
|
|
3641
|
+
- *Type:* projen.typescript.ProjenrcOptions
|
|
3642
|
+
|
|
3643
|
+
Options for .projenrc.ts.
|
|
3644
|
+
|
|
3645
|
+
---
|
|
3646
|
+
|
|
3647
|
+
##### `sampleCode`<sup>Optional</sup> <a name="sampleCode" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.sampleCode"></a>
|
|
3648
|
+
|
|
3649
|
+
```typescript
|
|
3650
|
+
public readonly sampleCode: boolean;
|
|
3651
|
+
```
|
|
3652
|
+
|
|
3653
|
+
- *Type:* boolean
|
|
3654
|
+
- *Default:* true
|
|
3655
|
+
|
|
3656
|
+
Generate one-time sample in `src/` and `test/` if there are no files there.
|
|
3657
|
+
|
|
3658
|
+
---
|
|
3659
|
+
|
|
3660
|
+
##### `srcdir`<sup>Optional</sup> <a name="srcdir" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.srcdir"></a>
|
|
3661
|
+
|
|
3662
|
+
```typescript
|
|
3663
|
+
public readonly srcdir: string;
|
|
3664
|
+
```
|
|
3665
|
+
|
|
3666
|
+
- *Type:* string
|
|
3667
|
+
- *Default:* "src"
|
|
3668
|
+
|
|
3669
|
+
Typescript sources directory.
|
|
3670
|
+
|
|
3671
|
+
---
|
|
3672
|
+
|
|
3673
|
+
##### `testdir`<sup>Optional</sup> <a name="testdir" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.testdir"></a>
|
|
3674
|
+
|
|
3675
|
+
```typescript
|
|
3676
|
+
public readonly testdir: string;
|
|
3677
|
+
```
|
|
3678
|
+
|
|
3679
|
+
- *Type:* string
|
|
3680
|
+
- *Default:* "test"
|
|
3681
|
+
|
|
3682
|
+
Jest tests directory. Tests files should be named `xxx.test.ts`.
|
|
3683
|
+
|
|
3684
|
+
If this directory is under `srcdir` (e.g. `src/test`, `src/__tests__`),
|
|
3685
|
+
then tests are going to be compiled into `lib/` and executed as javascript.
|
|
3686
|
+
If the test directory is outside of `src`, then we configure jest to
|
|
3687
|
+
compile the code in-memory.
|
|
3688
|
+
|
|
3689
|
+
---
|
|
3690
|
+
|
|
3691
|
+
##### `tsconfig`<sup>Optional</sup> <a name="tsconfig" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.tsconfig"></a>
|
|
3692
|
+
|
|
3693
|
+
```typescript
|
|
3694
|
+
public readonly tsconfig: TypescriptConfigOptions;
|
|
3695
|
+
```
|
|
3696
|
+
|
|
3697
|
+
- *Type:* projen.javascript.TypescriptConfigOptions
|
|
3698
|
+
- *Default:* default options
|
|
3699
|
+
|
|
3700
|
+
Custom TSConfig.
|
|
3701
|
+
|
|
3702
|
+
---
|
|
3703
|
+
|
|
3704
|
+
##### `tsconfigDev`<sup>Optional</sup> <a name="tsconfigDev" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.tsconfigDev"></a>
|
|
3705
|
+
|
|
3706
|
+
```typescript
|
|
3707
|
+
public readonly tsconfigDev: TypescriptConfigOptions;
|
|
3708
|
+
```
|
|
3709
|
+
|
|
3710
|
+
- *Type:* projen.javascript.TypescriptConfigOptions
|
|
3711
|
+
- *Default:* use the production tsconfig options
|
|
3712
|
+
|
|
3713
|
+
Custom tsconfig options for the development tsconfig.json file (used for testing).
|
|
3714
|
+
|
|
3715
|
+
---
|
|
3716
|
+
|
|
3717
|
+
##### `tsconfigDevFile`<sup>Optional</sup> <a name="tsconfigDevFile" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.tsconfigDevFile"></a>
|
|
3718
|
+
|
|
3719
|
+
```typescript
|
|
3720
|
+
public readonly tsconfigDevFile: string;
|
|
3721
|
+
```
|
|
3722
|
+
|
|
3723
|
+
- *Type:* string
|
|
3724
|
+
- *Default:* "tsconfig.dev.json"
|
|
3725
|
+
|
|
3726
|
+
The name of the development tsconfig.json file.
|
|
3727
|
+
|
|
3728
|
+
---
|
|
3729
|
+
|
|
3730
|
+
##### `tsJestOptions`<sup>Optional</sup> <a name="tsJestOptions" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.tsJestOptions"></a>
|
|
3731
|
+
|
|
3732
|
+
```typescript
|
|
3733
|
+
public readonly tsJestOptions: TsJestOptions;
|
|
3734
|
+
```
|
|
3735
|
+
|
|
3736
|
+
- *Type:* projen.typescript.TsJestOptions
|
|
3737
|
+
|
|
3738
|
+
Options for ts-jest.
|
|
3739
|
+
|
|
3740
|
+
---
|
|
3741
|
+
|
|
3742
|
+
##### `typescriptVersion`<sup>Optional</sup> <a name="typescriptVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.typescriptVersion"></a>
|
|
3743
|
+
|
|
3744
|
+
```typescript
|
|
3745
|
+
public readonly typescriptVersion: string;
|
|
3746
|
+
```
|
|
3747
|
+
|
|
3748
|
+
- *Type:* string
|
|
3749
|
+
- *Default:* "latest"
|
|
3750
|
+
|
|
3751
|
+
TypeScript version to use.
|
|
3752
|
+
|
|
3753
|
+
NOTE: Typescript is not semantically versioned and should remain on the
|
|
3754
|
+
same minor, so we recommend using a `~` dependency (e.g. `~1.2.3`).
|
|
3755
|
+
|
|
3756
|
+
---
|
|
3757
|
+
|
|
3758
|
+
##### `author`<sup>Required</sup> <a name="author" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.author"></a>
|
|
3759
|
+
|
|
3760
|
+
```typescript
|
|
3761
|
+
public readonly author: string;
|
|
3762
|
+
```
|
|
3763
|
+
|
|
3764
|
+
- *Type:* string
|
|
3765
|
+
- *Default:* $GIT_USER_NAME
|
|
3766
|
+
|
|
3767
|
+
The name of the library author.
|
|
3768
|
+
|
|
3769
|
+
---
|
|
3770
|
+
|
|
3771
|
+
##### `authorAddress`<sup>Required</sup> <a name="authorAddress" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.authorAddress"></a>
|
|
3772
|
+
|
|
3773
|
+
```typescript
|
|
3774
|
+
public readonly authorAddress: string;
|
|
3775
|
+
```
|
|
3776
|
+
|
|
3777
|
+
- *Type:* string
|
|
3778
|
+
- *Default:* $GIT_USER_EMAIL
|
|
3779
|
+
|
|
3780
|
+
Email or URL of the library author.
|
|
3781
|
+
|
|
3782
|
+
---
|
|
3783
|
+
|
|
3784
|
+
##### `repositoryUrl`<sup>Required</sup> <a name="repositoryUrl" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.repositoryUrl"></a>
|
|
3785
|
+
|
|
3786
|
+
```typescript
|
|
3787
|
+
public readonly repositoryUrl: string;
|
|
3788
|
+
```
|
|
3789
|
+
|
|
3790
|
+
- *Type:* string
|
|
3791
|
+
- *Default:* $GIT_REMOTE
|
|
3792
|
+
|
|
3793
|
+
Git repository URL.
|
|
3794
|
+
|
|
3795
|
+
---
|
|
3796
|
+
|
|
3797
|
+
##### `compat`<sup>Optional</sup> <a name="compat" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.compat"></a>
|
|
3798
|
+
|
|
3799
|
+
```typescript
|
|
3800
|
+
public readonly compat: boolean;
|
|
3801
|
+
```
|
|
3802
|
+
|
|
3803
|
+
- *Type:* boolean
|
|
3804
|
+
- *Default:* false
|
|
3805
|
+
|
|
3806
|
+
Automatically run API compatibility test against the latest version published to npm after compilation.
|
|
3807
|
+
|
|
3808
|
+
You can manually run compatibility tests using `yarn compat` if this feature is disabled.
|
|
3809
|
+
- You can ignore compatibility failures by adding lines to a ".compatignore" file.
|
|
3810
|
+
|
|
3811
|
+
---
|
|
3812
|
+
|
|
3813
|
+
##### `compatIgnore`<sup>Optional</sup> <a name="compatIgnore" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.compatIgnore"></a>
|
|
3814
|
+
|
|
3815
|
+
```typescript
|
|
3816
|
+
public readonly compatIgnore: string;
|
|
3817
|
+
```
|
|
3818
|
+
|
|
3819
|
+
- *Type:* string
|
|
3820
|
+
- *Default:* ".compatignore"
|
|
3821
|
+
|
|
3822
|
+
Name of the ignore file for API compatibility tests.
|
|
3823
|
+
|
|
3824
|
+
---
|
|
3825
|
+
|
|
3826
|
+
##### `compressAssembly`<sup>Optional</sup> <a name="compressAssembly" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.compressAssembly"></a>
|
|
3827
|
+
|
|
3828
|
+
```typescript
|
|
3829
|
+
public readonly compressAssembly: boolean;
|
|
3830
|
+
```
|
|
3831
|
+
|
|
3832
|
+
- *Type:* boolean
|
|
3833
|
+
- *Default:* false
|
|
3834
|
+
|
|
3835
|
+
Emit a compressed version of the assembly.
|
|
3836
|
+
|
|
3837
|
+
---
|
|
3838
|
+
|
|
3839
|
+
##### `docgenFilePath`<sup>Optional</sup> <a name="docgenFilePath" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.docgenFilePath"></a>
|
|
3840
|
+
|
|
3841
|
+
```typescript
|
|
3842
|
+
public readonly docgenFilePath: string;
|
|
3843
|
+
```
|
|
3844
|
+
|
|
3845
|
+
- *Type:* string
|
|
3846
|
+
- *Default:* "API.md"
|
|
3847
|
+
|
|
3848
|
+
File path for generated docs.
|
|
3849
|
+
|
|
3850
|
+
---
|
|
3851
|
+
|
|
3852
|
+
##### ~~`dotnet`~~<sup>Optional</sup> <a name="dotnet" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.dotnet"></a>
|
|
3853
|
+
|
|
3854
|
+
- *Deprecated:* use `publishToNuget`
|
|
3855
|
+
|
|
3856
|
+
```typescript
|
|
3857
|
+
public readonly dotnet: JsiiDotNetTarget;
|
|
3858
|
+
```
|
|
3859
|
+
|
|
3860
|
+
- *Type:* projen.cdk.JsiiDotNetTarget
|
|
3861
|
+
|
|
3862
|
+
---
|
|
3863
|
+
|
|
3864
|
+
##### `excludeTypescript`<sup>Optional</sup> <a name="excludeTypescript" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.excludeTypescript"></a>
|
|
3865
|
+
|
|
3866
|
+
```typescript
|
|
3867
|
+
public readonly excludeTypescript: string[];
|
|
3868
|
+
```
|
|
3869
|
+
|
|
3870
|
+
- *Type:* string[]
|
|
3871
|
+
|
|
3872
|
+
Accepts a list of glob patterns.
|
|
3873
|
+
|
|
3874
|
+
Files matching any of those patterns will be excluded from the TypeScript compiler input.
|
|
3875
|
+
|
|
3876
|
+
By default, jsii will include all *.ts files (except .d.ts files) in the TypeScript compiler input.
|
|
3877
|
+
This can be problematic for example when the package's build or test procedure generates .ts files
|
|
3878
|
+
that cannot be compiled with jsii's compiler settings.
|
|
3879
|
+
|
|
3880
|
+
---
|
|
3881
|
+
|
|
3882
|
+
##### `jsiiVersion`<sup>Optional</sup> <a name="jsiiVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.jsiiVersion"></a>
|
|
3883
|
+
|
|
3884
|
+
```typescript
|
|
3885
|
+
public readonly jsiiVersion: string;
|
|
3886
|
+
```
|
|
3887
|
+
|
|
3888
|
+
- *Type:* string
|
|
3889
|
+
- *Default:* "1.x"
|
|
3890
|
+
|
|
3891
|
+
Version of the jsii compiler to use.
|
|
3892
|
+
|
|
3893
|
+
Set to "*" if you want to manually manage the version of jsii in your
|
|
3894
|
+
project by managing updates to `package.json` on your own.
|
|
3895
|
+
|
|
3896
|
+
NOTE: The jsii compiler releases since 5.0.0 are not semantically versioned
|
|
3897
|
+
and should remain on the same minor, so we recommend using a `~` dependency
|
|
3898
|
+
(e.g. `~5.0.0`).
|
|
3899
|
+
|
|
3900
|
+
---
|
|
3901
|
+
|
|
3902
|
+
##### `publishToGo`<sup>Optional</sup> <a name="publishToGo" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToGo"></a>
|
|
3903
|
+
|
|
3904
|
+
```typescript
|
|
3905
|
+
public readonly publishToGo: JsiiGoTarget;
|
|
3906
|
+
```
|
|
3907
|
+
|
|
3908
|
+
- *Type:* projen.cdk.JsiiGoTarget
|
|
3909
|
+
- *Default:* no publishing
|
|
3910
|
+
|
|
3911
|
+
Publish Go bindings to a git repository.
|
|
3912
|
+
|
|
3913
|
+
---
|
|
3914
|
+
|
|
3915
|
+
##### `publishToMaven`<sup>Optional</sup> <a name="publishToMaven" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToMaven"></a>
|
|
3916
|
+
|
|
3917
|
+
```typescript
|
|
3918
|
+
public readonly publishToMaven: JsiiJavaTarget;
|
|
3919
|
+
```
|
|
3920
|
+
|
|
3921
|
+
- *Type:* projen.cdk.JsiiJavaTarget
|
|
3922
|
+
- *Default:* no publishing
|
|
3923
|
+
|
|
3924
|
+
Publish to maven.
|
|
3925
|
+
|
|
3926
|
+
---
|
|
3927
|
+
|
|
3928
|
+
##### `publishToNuget`<sup>Optional</sup> <a name="publishToNuget" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToNuget"></a>
|
|
3929
|
+
|
|
3930
|
+
```typescript
|
|
3931
|
+
public readonly publishToNuget: JsiiDotNetTarget;
|
|
3932
|
+
```
|
|
3933
|
+
|
|
3934
|
+
- *Type:* projen.cdk.JsiiDotNetTarget
|
|
3935
|
+
- *Default:* no publishing
|
|
3936
|
+
|
|
3937
|
+
Publish to NuGet.
|
|
3938
|
+
|
|
3939
|
+
---
|
|
3940
|
+
|
|
3941
|
+
##### `publishToPypi`<sup>Optional</sup> <a name="publishToPypi" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.publishToPypi"></a>
|
|
3942
|
+
|
|
3943
|
+
```typescript
|
|
3944
|
+
public readonly publishToPypi: JsiiPythonTarget;
|
|
3945
|
+
```
|
|
3946
|
+
|
|
3947
|
+
- *Type:* projen.cdk.JsiiPythonTarget
|
|
3948
|
+
- *Default:* no publishing
|
|
3949
|
+
|
|
3950
|
+
Publish to pypi.
|
|
3951
|
+
|
|
3952
|
+
---
|
|
3953
|
+
|
|
3954
|
+
##### ~~`python`~~<sup>Optional</sup> <a name="python" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.python"></a>
|
|
3955
|
+
|
|
3956
|
+
- *Deprecated:* use `publishToPyPi`
|
|
3957
|
+
|
|
3958
|
+
```typescript
|
|
3959
|
+
public readonly python: JsiiPythonTarget;
|
|
3960
|
+
```
|
|
3961
|
+
|
|
3962
|
+
- *Type:* projen.cdk.JsiiPythonTarget
|
|
3963
|
+
|
|
3964
|
+
---
|
|
3965
|
+
|
|
3966
|
+
##### `rootdir`<sup>Optional</sup> <a name="rootdir" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.rootdir"></a>
|
|
3967
|
+
|
|
3968
|
+
```typescript
|
|
3969
|
+
public readonly rootdir: string;
|
|
3970
|
+
```
|
|
3971
|
+
|
|
3972
|
+
- *Type:* string
|
|
3973
|
+
- *Default:* "."
|
|
3974
|
+
|
|
3975
|
+
---
|
|
3976
|
+
|
|
3977
|
+
##### `cdktfVersion`<sup>Required</sup> <a name="cdktfVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.cdktfVersion"></a>
|
|
3978
|
+
|
|
3979
|
+
```typescript
|
|
3980
|
+
public readonly cdktfVersion: string;
|
|
3981
|
+
```
|
|
3982
|
+
|
|
3983
|
+
- *Type:* string
|
|
3984
|
+
|
|
3985
|
+
---
|
|
3986
|
+
|
|
3987
|
+
##### `constructsVersion`<sup>Required</sup> <a name="constructsVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.constructsVersion"></a>
|
|
3988
|
+
|
|
3989
|
+
```typescript
|
|
3990
|
+
public readonly constructsVersion: string;
|
|
3991
|
+
```
|
|
3992
|
+
|
|
3993
|
+
- *Type:* string
|
|
3994
|
+
|
|
3995
|
+
---
|
|
3996
|
+
|
|
3997
|
+
##### `terraformProvider`<sup>Required</sup> <a name="terraformProvider" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.terraformProvider"></a>
|
|
3998
|
+
|
|
3999
|
+
```typescript
|
|
4000
|
+
public readonly terraformProvider: string;
|
|
4001
|
+
```
|
|
4002
|
+
|
|
4003
|
+
- *Type:* string
|
|
4004
|
+
|
|
4005
|
+
---
|
|
4006
|
+
|
|
4007
|
+
##### `creationYear`<sup>Optional</sup> <a name="creationYear" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.creationYear"></a>
|
|
4008
|
+
|
|
4009
|
+
```typescript
|
|
4010
|
+
public readonly creationYear: number;
|
|
4011
|
+
```
|
|
4012
|
+
|
|
4013
|
+
- *Type:* number
|
|
4014
|
+
|
|
4015
|
+
The year of the creation of the repository, for copyright purposes.
|
|
4016
|
+
|
|
4017
|
+
Will fall back to the current year if not specified.
|
|
4018
|
+
|
|
4019
|
+
---
|
|
4020
|
+
|
|
4021
|
+
##### `deprecationDate`<sup>Optional</sup> <a name="deprecationDate" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.deprecationDate"></a>
|
|
4022
|
+
|
|
4023
|
+
```typescript
|
|
4024
|
+
public readonly deprecationDate: string;
|
|
4025
|
+
```
|
|
4026
|
+
|
|
4027
|
+
- *Type:* string
|
|
4028
|
+
|
|
4029
|
+
An optional date when the project should be considered deprecated, to be used in the README text.
|
|
4030
|
+
|
|
4031
|
+
If no date is provided, then the date of the build will be used by default.
|
|
4032
|
+
|
|
4033
|
+
---
|
|
4034
|
+
|
|
4035
|
+
##### `forceMajorVersion`<sup>Optional</sup> <a name="forceMajorVersion" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.forceMajorVersion"></a>
|
|
4036
|
+
|
|
4037
|
+
```typescript
|
|
4038
|
+
public readonly forceMajorVersion: number;
|
|
4039
|
+
```
|
|
4040
|
+
|
|
4041
|
+
- *Type:* number
|
|
4042
|
+
|
|
4043
|
+
---
|
|
4044
|
+
|
|
4045
|
+
##### `githubNamespace`<sup>Optional</sup> <a name="githubNamespace" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.githubNamespace"></a>
|
|
4046
|
+
|
|
4047
|
+
```typescript
|
|
4048
|
+
public readonly githubNamespace: string;
|
|
4049
|
+
```
|
|
4050
|
+
|
|
4051
|
+
- *Type:* string
|
|
4052
|
+
|
|
4053
|
+
defaults to "cdktn-io" previously was "cdktf".
|
|
4054
|
+
|
|
4055
|
+
Used for GitHub org name and package scoping
|
|
4056
|
+
|
|
4057
|
+
---
|
|
4058
|
+
|
|
4059
|
+
##### `isDeprecated`<sup>Optional</sup> <a name="isDeprecated" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.isDeprecated"></a>
|
|
4060
|
+
|
|
4061
|
+
```typescript
|
|
4062
|
+
public readonly isDeprecated: boolean;
|
|
4063
|
+
```
|
|
4064
|
+
|
|
4065
|
+
- *Type:* boolean
|
|
4066
|
+
|
|
4067
|
+
Whether or not this prebuilt provider is deprecated.
|
|
4068
|
+
|
|
4069
|
+
If true, no new versions will be published.
|
|
4070
|
+
|
|
4071
|
+
---
|
|
4072
|
+
|
|
4073
|
+
##### `licensee`<sup>Optional</sup> <a name="licensee" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.licensee"></a>
|
|
4074
|
+
|
|
4075
|
+
```typescript
|
|
4076
|
+
public readonly licensee: string;
|
|
4077
|
+
```
|
|
4078
|
+
|
|
4079
|
+
- *Type:* string
|
|
4080
|
+
|
|
4081
|
+
defaults to "HashiCorp, Inc.".
|
|
4082
|
+
|
|
4083
|
+
---
|
|
4084
|
+
|
|
4085
|
+
##### `mavenEndpoint`<sup>Optional</sup> <a name="mavenEndpoint" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.mavenEndpoint"></a>
|
|
4086
|
+
|
|
4087
|
+
```typescript
|
|
4088
|
+
public readonly mavenEndpoint: string;
|
|
4089
|
+
```
|
|
4090
|
+
|
|
4091
|
+
- *Type:* string
|
|
4092
|
+
|
|
4093
|
+
---
|
|
4094
|
+
|
|
4095
|
+
##### `mavenGroupId`<sup>Optional</sup> <a name="mavenGroupId" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.mavenGroupId"></a>
|
|
4096
|
+
|
|
4097
|
+
```typescript
|
|
4098
|
+
public readonly mavenGroupId: string;
|
|
4099
|
+
```
|
|
4100
|
+
|
|
4101
|
+
- *Type:* string
|
|
4102
|
+
|
|
4103
|
+
defaults to "io.${mavenOrg}".
|
|
4104
|
+
|
|
4105
|
+
---
|
|
4106
|
+
|
|
4107
|
+
##### `mavenOrg`<sup>Optional</sup> <a name="mavenOrg" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.mavenOrg"></a>
|
|
4108
|
+
|
|
4109
|
+
```typescript
|
|
4110
|
+
public readonly mavenOrg: string;
|
|
4111
|
+
```
|
|
4112
|
+
|
|
4113
|
+
- *Type:* string
|
|
4114
|
+
|
|
4115
|
+
defaults to "cdktn".
|
|
4116
|
+
|
|
4117
|
+
---
|
|
4118
|
+
|
|
4119
|
+
##### `namespace`<sup>Optional</sup> <a name="namespace" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.namespace"></a>
|
|
4120
|
+
|
|
4121
|
+
```typescript
|
|
4122
|
+
public readonly namespace: string;
|
|
4123
|
+
```
|
|
4124
|
+
|
|
4125
|
+
- *Type:* string
|
|
4126
|
+
|
|
4127
|
+
defaults to "cdktn".
|
|
4128
|
+
|
|
4129
|
+
---
|
|
4130
|
+
|
|
4131
|
+
##### `nugetOrg`<sup>Optional</sup> <a name="nugetOrg" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.nugetOrg"></a>
|
|
4132
|
+
|
|
4133
|
+
```typescript
|
|
4134
|
+
public readonly nugetOrg: string;
|
|
4135
|
+
```
|
|
4136
|
+
|
|
4137
|
+
- *Type:* string
|
|
4138
|
+
|
|
4139
|
+
defaults to "Io.Cdktn".
|
|
4140
|
+
|
|
4141
|
+
---
|
|
4142
|
+
|
|
4143
|
+
##### `useCustomGithubRunner`<sup>Optional</sup> <a name="useCustomGithubRunner" id="@cdktn/provider-project.CdktnProviderProjectOptions.property.useCustomGithubRunner"></a>
|
|
4144
|
+
|
|
4145
|
+
```typescript
|
|
4146
|
+
public readonly useCustomGithubRunner: boolean;
|
|
4147
|
+
```
|
|
4148
|
+
|
|
4149
|
+
- *Type:* boolean
|
|
4150
|
+
|
|
4151
|
+
---
|
|
4152
|
+
|
|
4153
|
+
|
|
4154
|
+
|