projen-modules 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

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.
@@ -1,6 +1,8 @@
1
1
  r'''
2
2
  # projen-modules
3
3
 
4
+ A collection of custom projen modules, that can be used to bootstrap and maintain consistent project configuration, tooling, dependencies, and builds.
5
+
4
6
  ## Getting Started
5
7
 
6
8
  ```sh
@@ -241,6 +243,7 @@ class JsiiProject(
241
243
  pull_request_template: typing.Optional[builtins.bool] = None,
242
244
  pull_request_template_contents: typing.Optional[typing.Sequence[builtins.str]] = None,
243
245
  python: typing.Optional[typing.Union[_projen_cdk_04054675.JsiiPythonTarget, typing.Dict[builtins.str, typing.Any]]] = None,
246
+ readme: typing.Optional[typing.Union["ReadmeOptions", typing.Dict[builtins.str, typing.Any]]] = None,
244
247
  releasable_commits: typing.Optional[_projen_04054675.ReleasableCommits] = None,
245
248
  release: typing.Optional[builtins.bool] = None,
246
249
  release_branches: typing.Optional[typing.Mapping[builtins.str, typing.Union[_projen_release_04054675.BranchOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -404,6 +407,7 @@ class JsiiProject(
404
407
  :param pull_request_template: (experimental) Include a GitHub pull request template. Default: true
405
408
  :param pull_request_template_contents: (experimental) The contents of the pull request template. Default: - default content
406
409
  :param python:
410
+ :param readme: Configuration of the README.md file.
407
411
  :param releasable_commits: (experimental) Find commits that should be considered releasable Used to decide if a release is required. Default: ReleasableCommits.everyCommit()
408
412
  :param release: (experimental) Add release management to this project. Default: - true (false for subprojects)
409
413
  :param release_branches: (experimental) Defines additional release branches. A workflow will be created for each release branch which will publish releases from commits in this branch. Each release branch *must* be assigned a major version number which is used to enforce that versions published from that branch always use that major version. If multiple branches are used, the ``majorVersion`` field must also be provided for the default branch. Default: - no additional branches are used for release. you can use ``addBranch()`` to add additional branches.
@@ -567,6 +571,7 @@ class JsiiProject(
567
571
  pull_request_template=pull_request_template,
568
572
  pull_request_template_contents=pull_request_template_contents,
569
573
  python=python,
574
+ readme=readme,
570
575
  releasable_commits=releasable_commits,
571
576
  release=release,
572
577
  release_branches=release_branches,
@@ -749,6 +754,7 @@ class JsiiProject(
749
754
  "pull_request_template": "pullRequestTemplate",
750
755
  "pull_request_template_contents": "pullRequestTemplateContents",
751
756
  "python": "python",
757
+ "readme": "readme",
752
758
  "releasable_commits": "releasableCommits",
753
759
  "release": "release",
754
760
  "release_branches": "releaseBranches",
@@ -916,6 +922,7 @@ class JsiiProjectOptions:
916
922
  pull_request_template: typing.Optional[builtins.bool] = None,
917
923
  pull_request_template_contents: typing.Optional[typing.Sequence[builtins.str]] = None,
918
924
  python: typing.Optional[typing.Union[_projen_cdk_04054675.JsiiPythonTarget, typing.Dict[builtins.str, typing.Any]]] = None,
925
+ readme: typing.Optional[typing.Union["ReadmeOptions", typing.Dict[builtins.str, typing.Any]]] = None,
919
926
  releasable_commits: typing.Optional[_projen_04054675.ReleasableCommits] = None,
920
927
  release: typing.Optional[builtins.bool] = None,
921
928
  release_branches: typing.Optional[typing.Mapping[builtins.str, typing.Union[_projen_release_04054675.BranchOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -1080,6 +1087,7 @@ class JsiiProjectOptions:
1080
1087
  :param pull_request_template: (experimental) Include a GitHub pull request template. Default: true
1081
1088
  :param pull_request_template_contents: (experimental) The contents of the pull request template. Default: - default content
1082
1089
  :param python:
1090
+ :param readme: Configuration of the README.md file.
1083
1091
  :param releasable_commits: (experimental) Find commits that should be considered releasable Used to decide if a release is required. Default: ReleasableCommits.everyCommit()
1084
1092
  :param release: (experimental) Add release management to this project. Default: - true (false for subprojects)
1085
1093
  :param release_branches: (experimental) Defines additional release branches. A workflow will be created for each release branch which will publish releases from commits in this branch. Each release branch *must* be assigned a major version number which is used to enforce that versions published from that branch always use that major version. If multiple branches are used, the ``majorVersion`` field must also be provided for the default branch. Default: - no additional branches are used for release. you can use ``addBranch()`` to add additional branches.
@@ -1178,6 +1186,8 @@ class JsiiProjectOptions:
1178
1186
  publish_to_pypi = _projen_cdk_04054675.JsiiPythonTarget(**publish_to_pypi)
1179
1187
  if isinstance(python, dict):
1180
1188
  python = _projen_cdk_04054675.JsiiPythonTarget(**python)
1189
+ if isinstance(readme, dict):
1190
+ readme = ReadmeOptions(**readme)
1181
1191
  if isinstance(renovatebot_options, dict):
1182
1192
  renovatebot_options = _projen_04054675.RenovatebotOptions(**renovatebot_options)
1183
1193
  if isinstance(stale_options, dict):
@@ -1316,6 +1326,7 @@ class JsiiProjectOptions:
1316
1326
  check_type(argname="argument pull_request_template", value=pull_request_template, expected_type=type_hints["pull_request_template"])
1317
1327
  check_type(argname="argument pull_request_template_contents", value=pull_request_template_contents, expected_type=type_hints["pull_request_template_contents"])
1318
1328
  check_type(argname="argument python", value=python, expected_type=type_hints["python"])
1329
+ check_type(argname="argument readme", value=readme, expected_type=type_hints["readme"])
1319
1330
  check_type(argname="argument releasable_commits", value=releasable_commits, expected_type=type_hints["releasable_commits"])
1320
1331
  check_type(argname="argument release", value=release, expected_type=type_hints["release"])
1321
1332
  check_type(argname="argument release_branches", value=release_branches, expected_type=type_hints["release_branches"])
@@ -1594,6 +1605,8 @@ class JsiiProjectOptions:
1594
1605
  self._values["pull_request_template_contents"] = pull_request_template_contents
1595
1606
  if python is not None:
1596
1607
  self._values["python"] = python
1608
+ if readme is not None:
1609
+ self._values["readme"] = readme
1597
1610
  if releasable_commits is not None:
1598
1611
  self._values["releasable_commits"] = releasable_commits
1599
1612
  if release is not None:
@@ -3163,6 +3176,12 @@ class JsiiProjectOptions:
3163
3176
  result = self._values.get("python")
3164
3177
  return typing.cast(typing.Optional[_projen_cdk_04054675.JsiiPythonTarget], result)
3165
3178
 
3179
+ @builtins.property
3180
+ def readme(self) -> typing.Optional["ReadmeOptions"]:
3181
+ '''Configuration of the README.md file.'''
3182
+ result = self._values.get("readme")
3183
+ return typing.cast(typing.Optional["ReadmeOptions"], result)
3184
+
3166
3185
  @builtins.property
3167
3186
  def releasable_commits(self) -> typing.Optional[_projen_04054675.ReleasableCommits]:
3168
3187
  '''(experimental) Find commits that should be considered releasable Used to decide if a release is required.
@@ -3812,6 +3831,7 @@ class NpmPackage(
3812
3831
  publish_tasks: typing.Optional[builtins.bool] = None,
3813
3832
  pull_request_template: typing.Optional[builtins.bool] = None,
3814
3833
  pull_request_template_contents: typing.Optional[typing.Sequence[builtins.str]] = None,
3834
+ readme: typing.Optional[typing.Union["ReadmeOptions", typing.Dict[builtins.str, typing.Any]]] = None,
3815
3835
  releasable_commits: typing.Optional[_projen_04054675.ReleasableCommits] = None,
3816
3836
  release: typing.Optional[builtins.bool] = None,
3817
3837
  release_branches: typing.Optional[typing.Mapping[builtins.str, typing.Union[_projen_release_04054675.BranchOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -3959,6 +3979,7 @@ class NpmPackage(
3959
3979
  :param publish_tasks: (experimental) Define publishing tasks that can be executed manually as well as workflows. Normally, publishing only happens within automated workflows. Enable this in order to create a publishing task for each publishing activity. Default: false
3960
3980
  :param pull_request_template: (experimental) Include a GitHub pull request template. Default: true
3961
3981
  :param pull_request_template_contents: (experimental) The contents of the pull request template. Default: - default content
3982
+ :param readme: Configuration of the README.md file.
3962
3983
  :param releasable_commits: (experimental) Find commits that should be considered releasable Used to decide if a release is required. Default: ReleasableCommits.everyCommit()
3963
3984
  :param release: (experimental) Add release management to this project. Default: - true (false for subprojects)
3964
3985
  :param release_branches: (experimental) Defines additional release branches. A workflow will be created for each release branch which will publish releases from commits in this branch. Each release branch *must* be assigned a major version number which is used to enforce that versions published from that branch always use that major version. If multiple branches are used, the ``majorVersion`` field must also be provided for the default branch. Default: - no additional branches are used for release. you can use ``addBranch()`` to add additional branches.
@@ -4106,6 +4127,7 @@ class NpmPackage(
4106
4127
  publish_tasks=publish_tasks,
4107
4128
  pull_request_template=pull_request_template,
4108
4129
  pull_request_template_contents=pull_request_template_contents,
4130
+ readme=readme,
4109
4131
  releasable_commits=releasable_commits,
4110
4132
  release=release,
4111
4133
  release_branches=release_branches,
@@ -4150,6 +4172,18 @@ class NpmPackage(
4150
4172
 
4151
4173
  jsii.create(self.__class__, self, [options])
4152
4174
 
4175
+ @builtins.property
4176
+ @jsii.member(jsii_name="readme")
4177
+ def readme(self) -> "Readme":
4178
+ return typing.cast("Readme", jsii.get(self, "readme"))
4179
+
4180
+ @readme.setter
4181
+ def readme(self, value: "Readme") -> None:
4182
+ if __debug__:
4183
+ type_hints = typing.get_type_hints(_typecheckingstub__6cb7da275ba82f1b6bb477c4c22f7721642ea0759b39a4fc1874a92b34daa7eb)
4184
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
4185
+ jsii.set(self, "readme", value) # pyright: ignore[reportArgumentType]
4186
+
4153
4187
 
4154
4188
  @jsii.data_type(
4155
4189
  jsii_type="projen-modules.NpmPackageOptions",
@@ -4260,6 +4294,7 @@ class NpmPackage(
4260
4294
  "publish_tasks": "publishTasks",
4261
4295
  "pull_request_template": "pullRequestTemplate",
4262
4296
  "pull_request_template_contents": "pullRequestTemplateContents",
4297
+ "readme": "readme",
4263
4298
  "releasable_commits": "releasableCommits",
4264
4299
  "release": "release",
4265
4300
  "release_branches": "releaseBranches",
@@ -4411,6 +4446,7 @@ class NpmPackageOptions:
4411
4446
  publish_tasks: typing.Optional[builtins.bool] = None,
4412
4447
  pull_request_template: typing.Optional[builtins.bool] = None,
4413
4448
  pull_request_template_contents: typing.Optional[typing.Sequence[builtins.str]] = None,
4449
+ readme: typing.Optional[typing.Union["ReadmeOptions", typing.Dict[builtins.str, typing.Any]]] = None,
4414
4450
  releasable_commits: typing.Optional[_projen_04054675.ReleasableCommits] = None,
4415
4451
  release: typing.Optional[builtins.bool] = None,
4416
4452
  release_branches: typing.Optional[typing.Mapping[builtins.str, typing.Union[_projen_release_04054675.BranchOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -4559,6 +4595,7 @@ class NpmPackageOptions:
4559
4595
  :param publish_tasks: (experimental) Define publishing tasks that can be executed manually as well as workflows. Normally, publishing only happens within automated workflows. Enable this in order to create a publishing task for each publishing activity. Default: false
4560
4596
  :param pull_request_template: (experimental) Include a GitHub pull request template. Default: true
4561
4597
  :param pull_request_template_contents: (experimental) The contents of the pull request template. Default: - default content
4598
+ :param readme: Configuration of the README.md file.
4562
4599
  :param releasable_commits: (experimental) Find commits that should be considered releasable Used to decide if a release is required. Default: ReleasableCommits.everyCommit()
4563
4600
  :param release: (experimental) Add release management to this project. Default: - true (false for subprojects)
4564
4601
  :param release_branches: (experimental) Defines additional release branches. A workflow will be created for each release branch which will publish releases from commits in this branch. Each release branch *must* be assigned a major version number which is used to enforce that versions published from that branch always use that major version. If multiple branches are used, the ``majorVersion`` field must also be provided for the default branch. Default: - no additional branches are used for release. you can use ``addBranch()`` to add additional branches.
@@ -4644,6 +4681,8 @@ class NpmPackageOptions:
4644
4681
  projenrc_js_options = _projen_javascript_04054675.ProjenrcOptions(**projenrc_js_options)
4645
4682
  if isinstance(projenrc_ts_options, dict):
4646
4683
  projenrc_ts_options = _projen_typescript_04054675.ProjenrcOptions(**projenrc_ts_options)
4684
+ if isinstance(readme, dict):
4685
+ readme = ReadmeOptions(**readme)
4647
4686
  if isinstance(renovatebot_options, dict):
4648
4687
  renovatebot_options = _projen_04054675.RenovatebotOptions(**renovatebot_options)
4649
4688
  if isinstance(stale_options, dict):
@@ -4767,6 +4806,7 @@ class NpmPackageOptions:
4767
4806
  check_type(argname="argument publish_tasks", value=publish_tasks, expected_type=type_hints["publish_tasks"])
4768
4807
  check_type(argname="argument pull_request_template", value=pull_request_template, expected_type=type_hints["pull_request_template"])
4769
4808
  check_type(argname="argument pull_request_template_contents", value=pull_request_template_contents, expected_type=type_hints["pull_request_template_contents"])
4809
+ check_type(argname="argument readme", value=readme, expected_type=type_hints["readme"])
4770
4810
  check_type(argname="argument releasable_commits", value=releasable_commits, expected_type=type_hints["releasable_commits"])
4771
4811
  check_type(argname="argument release", value=release, expected_type=type_hints["release"])
4772
4812
  check_type(argname="argument release_branches", value=release_branches, expected_type=type_hints["release_branches"])
@@ -5017,6 +5057,8 @@ class NpmPackageOptions:
5017
5057
  self._values["pull_request_template"] = pull_request_template
5018
5058
  if pull_request_template_contents is not None:
5019
5059
  self._values["pull_request_template_contents"] = pull_request_template_contents
5060
+ if readme is not None:
5061
+ self._values["readme"] = readme
5020
5062
  if releasable_commits is not None:
5021
5063
  self._values["releasable_commits"] = releasable_commits
5022
5064
  if release is not None:
@@ -6403,6 +6445,12 @@ class NpmPackageOptions:
6403
6445
  result = self._values.get("pull_request_template_contents")
6404
6446
  return typing.cast(typing.Optional[typing.List[builtins.str]], result)
6405
6447
 
6448
+ @builtins.property
6449
+ def readme(self) -> typing.Optional["ReadmeOptions"]:
6450
+ '''Configuration of the README.md file.'''
6451
+ result = self._values.get("readme")
6452
+ return typing.cast(typing.Optional["ReadmeOptions"], result)
6453
+
6406
6454
  @builtins.property
6407
6455
  def releasable_commits(self) -> typing.Optional[_projen_04054675.ReleasableCommits]:
6408
6456
  '''(experimental) Find commits that should be considered releasable Used to decide if a release is required.
@@ -6986,6 +7034,7 @@ class PythonPackage(
6986
7034
  pytest: typing.Optional[builtins.bool] = None,
6987
7035
  pytest_options: typing.Optional[typing.Union[_projen_python_04054675.PytestOptions, typing.Dict[builtins.str, typing.Any]]] = None,
6988
7036
  python_exec: typing.Optional[builtins.str] = None,
7037
+ readme: typing.Optional[typing.Union["ReadmeOptions", typing.Dict[builtins.str, typing.Any]]] = None,
6989
7038
  renovatebot: typing.Optional[builtins.bool] = None,
6990
7039
  renovatebot_options: typing.Optional[typing.Union[_projen_04054675.RenovatebotOptions, typing.Dict[builtins.str, typing.Any]]] = None,
6991
7040
  sample: typing.Optional[builtins.bool] = None,
@@ -7047,6 +7096,7 @@ class PythonPackage(
7047
7096
  :param pytest: (experimental) Include pytest tests. Default: true
7048
7097
  :param pytest_options: (experimental) pytest options. Default: - defaults
7049
7098
  :param python_exec: (experimental) Path to the python executable to use. Default: "python"
7099
+ :param readme: Configuration of the README.md file.
7050
7100
  :param renovatebot: (experimental) Use renovatebot to handle dependency upgrades. Default: false
7051
7101
  :param renovatebot_options: (experimental) Options for renovatebot. Default: - default options
7052
7102
  :param sample: (experimental) Include sample code and test if the relevant directories don't exist. Default: true
@@ -7108,6 +7158,7 @@ class PythonPackage(
7108
7158
  pytest=pytest,
7109
7159
  pytest_options=pytest_options,
7110
7160
  python_exec=python_exec,
7161
+ readme=readme,
7111
7162
  renovatebot=renovatebot,
7112
7163
  renovatebot_options=renovatebot_options,
7113
7164
  sample=sample,
@@ -7122,6 +7173,18 @@ class PythonPackage(
7122
7173
 
7123
7174
  jsii.create(self.__class__, self, [options])
7124
7175
 
7176
+ @builtins.property
7177
+ @jsii.member(jsii_name="readme")
7178
+ def readme(self) -> "Readme":
7179
+ return typing.cast("Readme", jsii.get(self, "readme"))
7180
+
7181
+ @readme.setter
7182
+ def readme(self, value: "Readme") -> None:
7183
+ if __debug__:
7184
+ type_hints = typing.get_type_hints(_typecheckingstub__1a456e663d7da59de9fd68ca5bb5f5bc98971d99102fdb04adfe975c14215095)
7185
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
7186
+ jsii.set(self, "readme", value) # pyright: ignore[reportArgumentType]
7187
+
7125
7188
 
7126
7189
  @jsii.data_type(
7127
7190
  jsii_type="projen-modules.PythonPackageOptions",
@@ -7176,6 +7239,7 @@ class PythonPackage(
7176
7239
  "pytest": "pytest",
7177
7240
  "pytest_options": "pytestOptions",
7178
7241
  "python_exec": "pythonExec",
7242
+ "readme": "readme",
7179
7243
  "renovatebot": "renovatebot",
7180
7244
  "renovatebot_options": "renovatebotOptions",
7181
7245
  "sample": "sample",
@@ -7241,6 +7305,7 @@ class PythonPackageOptions:
7241
7305
  pytest: typing.Optional[builtins.bool] = None,
7242
7306
  pytest_options: typing.Optional[typing.Union[_projen_python_04054675.PytestOptions, typing.Dict[builtins.str, typing.Any]]] = None,
7243
7307
  python_exec: typing.Optional[builtins.str] = None,
7308
+ readme: typing.Optional[typing.Union["ReadmeOptions", typing.Dict[builtins.str, typing.Any]]] = None,
7244
7309
  renovatebot: typing.Optional[builtins.bool] = None,
7245
7310
  renovatebot_options: typing.Optional[typing.Union[_projen_04054675.RenovatebotOptions, typing.Dict[builtins.str, typing.Any]]] = None,
7246
7311
  sample: typing.Optional[builtins.bool] = None,
@@ -7303,6 +7368,7 @@ class PythonPackageOptions:
7303
7368
  :param pytest: (experimental) Include pytest tests. Default: true
7304
7369
  :param pytest_options: (experimental) pytest options. Default: - defaults
7305
7370
  :param python_exec: (experimental) Path to the python executable to use. Default: "python"
7371
+ :param readme: Configuration of the README.md file.
7306
7372
  :param renovatebot: (experimental) Use renovatebot to handle dependency upgrades. Default: false
7307
7373
  :param renovatebot_options: (experimental) Options for renovatebot. Default: - default options
7308
7374
  :param sample: (experimental) Include sample code and test if the relevant directories don't exist. Default: true
@@ -7340,6 +7406,8 @@ class PythonPackageOptions:
7340
7406
  projenrc_ts_options = _projen_typescript_04054675.ProjenrcTsOptions(**projenrc_ts_options)
7341
7407
  if isinstance(pytest_options, dict):
7342
7408
  pytest_options = _projen_python_04054675.PytestOptions(**pytest_options)
7409
+ if isinstance(readme, dict):
7410
+ readme = ReadmeOptions(**readme)
7343
7411
  if isinstance(renovatebot_options, dict):
7344
7412
  renovatebot_options = _projen_04054675.RenovatebotOptions(**renovatebot_options)
7345
7413
  if isinstance(stale_options, dict):
@@ -7397,6 +7465,7 @@ class PythonPackageOptions:
7397
7465
  check_type(argname="argument pytest", value=pytest, expected_type=type_hints["pytest"])
7398
7466
  check_type(argname="argument pytest_options", value=pytest_options, expected_type=type_hints["pytest_options"])
7399
7467
  check_type(argname="argument python_exec", value=python_exec, expected_type=type_hints["python_exec"])
7468
+ check_type(argname="argument readme", value=readme, expected_type=type_hints["readme"])
7400
7469
  check_type(argname="argument renovatebot", value=renovatebot, expected_type=type_hints["renovatebot"])
7401
7470
  check_type(argname="argument renovatebot_options", value=renovatebot_options, expected_type=type_hints["renovatebot_options"])
7402
7471
  check_type(argname="argument sample", value=sample, expected_type=type_hints["sample"])
@@ -7501,6 +7570,8 @@ class PythonPackageOptions:
7501
7570
  self._values["pytest_options"] = pytest_options
7502
7571
  if python_exec is not None:
7503
7572
  self._values["python_exec"] = python_exec
7573
+ if readme is not None:
7574
+ self._values["readme"] = readme
7504
7575
  if renovatebot is not None:
7505
7576
  self._values["renovatebot"] = renovatebot
7506
7577
  if renovatebot_options is not None:
@@ -8111,6 +8182,12 @@ class PythonPackageOptions:
8111
8182
  result = self._values.get("python_exec")
8112
8183
  return typing.cast(typing.Optional[builtins.str], result)
8113
8184
 
8185
+ @builtins.property
8186
+ def readme(self) -> typing.Optional["ReadmeOptions"]:
8187
+ '''Configuration of the README.md file.'''
8188
+ result = self._values.get("readme")
8189
+ return typing.cast(typing.Optional["ReadmeOptions"], result)
8190
+
8114
8191
  @builtins.property
8115
8192
  def renovatebot(self) -> typing.Optional[builtins.bool]:
8116
8193
  '''(experimental) Use renovatebot to handle dependency upgrades.
@@ -8246,14 +8323,22 @@ class Readme(
8246
8323
  metaclass=jsii.JSIIMeta,
8247
8324
  jsii_type="projen-modules.Readme",
8248
8325
  ):
8249
- def __init__(self, project: _projen_04054675.Project) -> None:
8326
+ def __init__(
8327
+ self,
8328
+ project: _projen_04054675.Project,
8329
+ *,
8330
+ description: typing.Optional[builtins.str] = None,
8331
+ ) -> None:
8250
8332
  '''
8251
8333
  :param project: -
8334
+ :param description: The description of the project.
8252
8335
  '''
8253
8336
  if __debug__:
8254
8337
  type_hints = typing.get_type_hints(_typecheckingstub__5cc1200292e645dca3ec7cf2cbf9f2c41def9f24ed1dbb485999955eb69cadd7)
8255
8338
  check_type(argname="argument project", value=project, expected_type=type_hints["project"])
8256
- jsii.create(self.__class__, self, [project])
8339
+ options = ReadmeOptions(description=description)
8340
+
8341
+ jsii.create(self.__class__, self, [project, options])
8257
8342
 
8258
8343
  @jsii.member(jsii_name="addSection")
8259
8344
  def add_section(self, title: builtins.str, body: builtins.str) -> None:
@@ -8293,6 +8378,53 @@ class Readme(
8293
8378
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
8294
8379
  jsii.set(self, "sections", value) # pyright: ignore[reportArgumentType]
8295
8380
 
8381
+ @builtins.property
8382
+ @jsii.member(jsii_name="description")
8383
+ def description(self) -> typing.Optional[builtins.str]:
8384
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "description"))
8385
+
8386
+ @description.setter
8387
+ def description(self, value: typing.Optional[builtins.str]) -> None:
8388
+ if __debug__:
8389
+ type_hints = typing.get_type_hints(_typecheckingstub__3be025b008bae89967f33ac0d0514c1355ca95d6c065b6e4bf039717a4005b50)
8390
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
8391
+ jsii.set(self, "description", value) # pyright: ignore[reportArgumentType]
8392
+
8393
+
8394
+ @jsii.data_type(
8395
+ jsii_type="projen-modules.ReadmeOptions",
8396
+ jsii_struct_bases=[],
8397
+ name_mapping={"description": "description"},
8398
+ )
8399
+ class ReadmeOptions:
8400
+ def __init__(self, *, description: typing.Optional[builtins.str] = None) -> None:
8401
+ '''
8402
+ :param description: The description of the project.
8403
+ '''
8404
+ if __debug__:
8405
+ type_hints = typing.get_type_hints(_typecheckingstub__96a11fa5d843f4f5d45e2690ef6a6b6e0851eb4e74c4330cfe550d6b63ce62b8)
8406
+ check_type(argname="argument description", value=description, expected_type=type_hints["description"])
8407
+ self._values: typing.Dict[builtins.str, typing.Any] = {}
8408
+ if description is not None:
8409
+ self._values["description"] = description
8410
+
8411
+ @builtins.property
8412
+ def description(self) -> typing.Optional[builtins.str]:
8413
+ '''The description of the project.'''
8414
+ result = self._values.get("description")
8415
+ return typing.cast(typing.Optional[builtins.str], result)
8416
+
8417
+ def __eq__(self, rhs: typing.Any) -> builtins.bool:
8418
+ return isinstance(rhs, self.__class__) and rhs._values == self._values
8419
+
8420
+ def __ne__(self, rhs: typing.Any) -> builtins.bool:
8421
+ return not (rhs == self)
8422
+
8423
+ def __repr__(self) -> str:
8424
+ return "ReadmeOptions(%s)" % ", ".join(
8425
+ k + "=" + repr(v) for k, v in self._values.items()
8426
+ )
8427
+
8296
8428
 
8297
8429
  class Section(metaclass=jsii.JSIIMeta, jsii_type="projen-modules.Section"):
8298
8430
  def __init__(self, options: ISectionOptions) -> None:
@@ -8323,6 +8455,7 @@ __all__ = [
8323
8455
  "PythonPackage",
8324
8456
  "PythonPackageOptions",
8325
8457
  "Readme",
8458
+ "ReadmeOptions",
8326
8459
  "Section",
8327
8460
  ]
8328
8461
 
@@ -8468,6 +8601,7 @@ def _typecheckingstub__bcc0f0f3d874afabc142961b7ca192083fcad906385166f2e47f7e739
8468
8601
  pull_request_template: typing.Optional[builtins.bool] = None,
8469
8602
  pull_request_template_contents: typing.Optional[typing.Sequence[builtins.str]] = None,
8470
8603
  python: typing.Optional[typing.Union[_projen_cdk_04054675.JsiiPythonTarget, typing.Dict[builtins.str, typing.Any]]] = None,
8604
+ readme: typing.Optional[typing.Union[ReadmeOptions, typing.Dict[builtins.str, typing.Any]]] = None,
8471
8605
  releasable_commits: typing.Optional[_projen_04054675.ReleasableCommits] = None,
8472
8606
  release: typing.Optional[builtins.bool] = None,
8473
8607
  release_branches: typing.Optional[typing.Mapping[builtins.str, typing.Union[_projen_release_04054675.BranchOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -8513,6 +8647,12 @@ def _typecheckingstub__bcc0f0f3d874afabc142961b7ca192083fcad906385166f2e47f7e739
8513
8647
  """Type checking stubs"""
8514
8648
  pass
8515
8649
 
8650
+ def _typecheckingstub__6cb7da275ba82f1b6bb477c4c22f7721642ea0759b39a4fc1874a92b34daa7eb(
8651
+ value: Readme,
8652
+ ) -> None:
8653
+ """Type checking stubs"""
8654
+ pass
8655
+
8516
8656
  def _typecheckingstub__b17dce6f2f04ceb519c781a818d66bcf4fef528d5b613028b126fd373e7b4048(
8517
8657
  *,
8518
8658
  code_owners: typing.Sequence[builtins.str],
@@ -8620,6 +8760,7 @@ def _typecheckingstub__b17dce6f2f04ceb519c781a818d66bcf4fef528d5b613028b126fd373
8620
8760
  publish_tasks: typing.Optional[builtins.bool] = None,
8621
8761
  pull_request_template: typing.Optional[builtins.bool] = None,
8622
8762
  pull_request_template_contents: typing.Optional[typing.Sequence[builtins.str]] = None,
8763
+ readme: typing.Optional[typing.Union[ReadmeOptions, typing.Dict[builtins.str, typing.Any]]] = None,
8623
8764
  releasable_commits: typing.Optional[_projen_04054675.ReleasableCommits] = None,
8624
8765
  release: typing.Optional[builtins.bool] = None,
8625
8766
  release_branches: typing.Optional[typing.Mapping[builtins.str, typing.Union[_projen_release_04054675.BranchOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -8664,6 +8805,12 @@ def _typecheckingstub__b17dce6f2f04ceb519c781a818d66bcf4fef528d5b613028b126fd373
8664
8805
  """Type checking stubs"""
8665
8806
  pass
8666
8807
 
8808
+ def _typecheckingstub__1a456e663d7da59de9fd68ca5bb5f5bc98971d99102fdb04adfe975c14215095(
8809
+ value: Readme,
8810
+ ) -> None:
8811
+ """Type checking stubs"""
8812
+ pass
8813
+
8667
8814
  def _typecheckingstub__882525f8fb69251a060fbbe97c2383313ea4b9c0269874cb1d13172a5420010c(
8668
8815
  *,
8669
8816
  author_email: builtins.str,
@@ -8715,6 +8862,7 @@ def _typecheckingstub__882525f8fb69251a060fbbe97c2383313ea4b9c0269874cb1d13172a5
8715
8862
  pytest: typing.Optional[builtins.bool] = None,
8716
8863
  pytest_options: typing.Optional[typing.Union[_projen_python_04054675.PytestOptions, typing.Dict[builtins.str, typing.Any]]] = None,
8717
8864
  python_exec: typing.Optional[builtins.str] = None,
8865
+ readme: typing.Optional[typing.Union[ReadmeOptions, typing.Dict[builtins.str, typing.Any]]] = None,
8718
8866
  renovatebot: typing.Optional[builtins.bool] = None,
8719
8867
  renovatebot_options: typing.Optional[typing.Union[_projen_04054675.RenovatebotOptions, typing.Dict[builtins.str, typing.Any]]] = None,
8720
8868
  sample: typing.Optional[builtins.bool] = None,
@@ -8731,6 +8879,8 @@ def _typecheckingstub__882525f8fb69251a060fbbe97c2383313ea4b9c0269874cb1d13172a5
8731
8879
 
8732
8880
  def _typecheckingstub__5cc1200292e645dca3ec7cf2cbf9f2c41def9f24ed1dbb485999955eb69cadd7(
8733
8881
  project: _projen_04054675.Project,
8882
+ *,
8883
+ description: typing.Optional[builtins.str] = None,
8734
8884
  ) -> None:
8735
8885
  """Type checking stubs"""
8736
8886
  pass
@@ -8754,6 +8904,19 @@ def _typecheckingstub__b866744efc0f7f57d44f27762344fc5d2fc2a11698dc4f0fe4a59965b
8754
8904
  """Type checking stubs"""
8755
8905
  pass
8756
8906
 
8907
+ def _typecheckingstub__3be025b008bae89967f33ac0d0514c1355ca95d6c065b6e4bf039717a4005b50(
8908
+ value: typing.Optional[builtins.str],
8909
+ ) -> None:
8910
+ """Type checking stubs"""
8911
+ pass
8912
+
8913
+ def _typecheckingstub__96a11fa5d843f4f5d45e2690ef6a6b6e0851eb4e74c4330cfe550d6b63ce62b8(
8914
+ *,
8915
+ description: typing.Optional[builtins.str] = None,
8916
+ ) -> None:
8917
+ """Type checking stubs"""
8918
+ pass
8919
+
8757
8920
  def _typecheckingstub__1e42be693dde8cd80a4e05381ff22f05cb4318ab11dab8a9118ec46f997b6b78(
8758
8921
  options: ISectionOptions,
8759
8922
  ) -> None:
@@ -32,7 +32,7 @@ import constructs._jsii
32
32
  import projen._jsii
33
33
 
34
34
  __jsii_assembly__ = jsii.JSIIAssembly.load(
35
- "projen-modules", "0.1.2", __name__[0:-6], "projen-modules@0.1.2.jsii.tgz"
35
+ "projen-modules", "0.1.4", __name__[0:-6], "projen-modules@0.1.4.jsii.tgz"
36
36
  )
37
37
 
38
38
  __all__ = [
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: projen_modules
3
- Version: 0.1.2
4
- Summary: projen-modules
3
+ Version: 0.1.4
4
+ Summary: A collection of projen modules
5
5
  Home-page: https://github.com/daveshepherd/projen-modules.git
6
6
  Author: Dave Shepherd<dave.shepherd@endor.me.uk>
7
7
  License: Apache-2.0
@@ -28,6 +28,8 @@ Requires-Dist: typeguard<4.3.0,>=2.13.3
28
28
 
29
29
  # projen-modules
30
30
 
31
+ A collection of custom projen modules, that can be used to bootstrap and maintain consistent project configuration, tooling, dependencies, and builds.
32
+
31
33
  ## Getting Started
32
34
 
33
35
  ```sh
@@ -0,0 +1,9 @@
1
+ projen_modules/__init__.py,sha256=ZV3aG54Sc6KfjzQbp_LIyI6r2vGMuERsj1kuo_AtLGA,517379
2
+ projen_modules/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
+ projen_modules/_jsii/__init__.py,sha256=JKs2217UCnltdT_iLWdxMGzh7pE5EDmcge7pfJ09Rvs,1438
4
+ projen_modules/_jsii/projen-modules@0.1.4.jsii.tgz,sha256=Z4d736THEvI-2aRS40zXrzykX2sdkA2jJrjTyHagSaA,138910
5
+ projen_modules-0.1.4.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
6
+ projen_modules-0.1.4.dist-info/METADATA,sha256=a6D1uaEOd4hC1c6A22eiOVD1Fee7OhXyapGQaQECSMQ,1391
7
+ projen_modules-0.1.4.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
8
+ projen_modules-0.1.4.dist-info/top_level.txt,sha256=YhmVEeu2LoZS5cqGRszYa1QjC4sk2iA12CJBzxieX8I,15
9
+ projen_modules-0.1.4.dist-info/RECORD,,
@@ -1,9 +0,0 @@
1
- projen_modules/__init__.py,sha256=tjF5y0F8UGw0SYxW6np4SLcvNKd50et9YIxijwt28cE,510080
2
- projen_modules/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
- projen_modules/_jsii/__init__.py,sha256=DXBsAagi5iKyrWhbv_x86YOiz3g15mqzIs-_vSarDHA,1438
4
- projen_modules/_jsii/projen-modules@0.1.2.jsii.tgz,sha256=4qV87Rovnq-tPhXEHKOTRoSxO739nMjFHeq0Qj8eBKQ,137076
5
- projen_modules-0.1.2.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
6
- projen_modules-0.1.2.dist-info/METADATA,sha256=LCGY2m7AbM8lYQ0ZM7ODdO1TzBHl_4sJsniw3cm8HPM,1223
7
- projen_modules-0.1.2.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
8
- projen_modules-0.1.2.dist-info/top_level.txt,sha256=YhmVEeu2LoZS5cqGRszYa1QjC4sk2iA12CJBzxieX8I,15
9
- projen_modules-0.1.2.dist-info/RECORD,,