projen 0.79.4__py3-none-any.whl → 0.98.25__py3-none-any.whl

projen/gitlab/__init__.py

@@ -1,3 +1,6 @@
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime
@@ -8,7 +11,22 @@ import jsii
 import publication
 import typing_extensions
 
-from typeguard import check_type
+import typeguard
+from importlib.metadata import version as _metadata_package_version
+TYPEGUARD_MAJOR_VERSION = int(_metadata_package_version('typeguard').split('.')[0])
+
+def check_type(argname: str, value: object, expected_type: typing.Any) -> typing.Any:
+    if TYPEGUARD_MAJOR_VERSION <= 2:
+        return typeguard.check_type(argname=argname, value=value, expected_type=expected_type) # type:ignore
+    else:
+        if isinstance(value, jsii._reference_map.InterfaceDynamicProxy): # pyright: ignore [reportAttributeAccessIssue]
+           pass
+        else:
+            if TYPEGUARD_MAJOR_VERSION == 3:
+                typeguard.config.collection_check_strategy = typeguard.CollectionCheckStrategy.ALL_ITEMS # type:ignore
+                typeguard.check_type(value=value, expected_type=expected_type) # type:ignore
+            else:
+                typeguard.check_type(value=value, expected_type=expected_type, collection_check_strategy=typeguard.CollectionCheckStrategy.ALL_ITEMS) # type:ignore
 
 from .._jsii import *
 
@@ -564,6 +582,7 @@ class CiConfiguration(
         default: typing.Optional[typing.Union["Default", typing.Dict[builtins.str, typing.Any]]] = None,
         jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union["Job", typing.Dict[builtins.str, typing.Any]]]] = None,
         pages: typing.Optional[typing.Union["Job", typing.Dict[builtins.str, typing.Any]]] = None,
+        path: typing.Optional[builtins.str] = None,
         stages: typing.Optional[typing.Sequence[builtins.str]] = None,
         variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
         workflow: typing.Optional[typing.Union["Workflow", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -574,6 +593,7 @@ class CiConfiguration(
         :param default: (experimental) Default settings for the CI Configuration. Jobs that do not define one or more of the listed keywords use the value defined in the default section.
         :param jobs: (experimental) An initial set of jobs to add to the configuration.
         :param pages: (experimental) A special job used to upload static sites to Gitlab pages. Requires a ``public/`` directory with ``artifacts.path`` pointing to it.
+        :param path: (experimental) The path of the file to generate.
         :param stages: (experimental) Groups jobs into stages. All jobs in one stage must complete before next stage is executed. If no stages are specified. Defaults to ['build', 'test', 'deploy'].
         :param variables: (experimental) Global variables that are passed to jobs. If the job already has that variable defined, the job-level variable takes precedence.
         :param workflow: (experimental) Used to control pipeline behavior.
@@ -588,6 +608,7 @@ class CiConfiguration(
             default=default,
             jobs=jobs,
             pages=pages,
+            path=path,
             stages=stages,
             variables=variables,
             workflow=workflow,
@@ -611,6 +632,22 @@ class CiConfiguration(
             check_type(argname="argument caches", value=caches, expected_type=type_hints["caches"])
         return typing.cast(None, jsii.invoke(self, "addDefaultCaches", [caches]))
 
+    @jsii.member(jsii_name="addDefaultHooks")
+    def add_default_hooks(
+        self,
+        *,
+        pre_get_sources_script: typing.Optional[typing.Sequence[builtins.str]] = None,
+    ) -> None:
+        '''(experimental) Specify a list of commands to execute on the runner before cloning the Git repository and any submodules https://docs.gitlab.com/ci/yaml/#hookspre_get_sources_script.
+
+        :param pre_get_sources_script: (experimental) Specify a list of commands to execute on the runner before cloning the Git repository and any submodules https://docs.gitlab.com/ci/yaml/#hookspre_get_sources_script.
+
+        :stability: experimental
+        '''
+        hooks = DefaultHooks(pre_get_sources_script=pre_get_sources_script)
+
+        return typing.cast(None, jsii.invoke(self, "addDefaultHooks", [hooks]))
+
     @jsii.member(jsii_name="addGlobalVariables")
     def add_global_variables(
         self,
@@ -793,6 +830,17 @@ class CiConfiguration(
         '''
         return typing.cast(typing.Optional[typing.List[Cache]], jsii.get(self, "defaultCache"))
 
+    @builtins.property
+    @jsii.member(jsii_name="defaultIdTokens")
+    def default_id_tokens(
+        self,
+    ) -> typing.Optional[typing.Mapping[builtins.str, "IDToken"]]:
+        '''(experimental) Default ID tokens (JSON Web Tokens) that are used for CI/CD authentication to use globally for all jobs.
+
+        :stability: experimental
+        '''
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, "IDToken"]], jsii.get(self, "defaultIdTokens"))
+
     @builtins.property
     @jsii.member(jsii_name="defaultImage")
     def default_image(self) -> typing.Optional["Image"]:
@@ -862,6 +910,7 @@ class CiConfiguration(
         "default": "default",
         "jobs": "jobs",
         "pages": "pages",
+        "path": "path",
         "stages": "stages",
         "variables": "variables",
         "workflow": "workflow",
@@ -874,6 +923,7 @@ class CiConfigurationOptions:
         default: typing.Optional[typing.Union["Default", typing.Dict[builtins.str, typing.Any]]] = None,
         jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union["Job", typing.Dict[builtins.str, typing.Any]]]] = None,
         pages: typing.Optional[typing.Union["Job", typing.Dict[builtins.str, typing.Any]]] = None,
+        path: typing.Optional[builtins.str] = None,
         stages: typing.Optional[typing.Sequence[builtins.str]] = None,
         variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
         workflow: typing.Optional[typing.Union["Workflow", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -883,6 +933,7 @@ class CiConfigurationOptions:
         :param default: (experimental) Default settings for the CI Configuration. Jobs that do not define one or more of the listed keywords use the value defined in the default section.
         :param jobs: (experimental) An initial set of jobs to add to the configuration.
         :param pages: (experimental) A special job used to upload static sites to Gitlab pages. Requires a ``public/`` directory with ``artifacts.path`` pointing to it.
+        :param path: (experimental) The path of the file to generate.
         :param stages: (experimental) Groups jobs into stages. All jobs in one stage must complete before next stage is executed. If no stages are specified. Defaults to ['build', 'test', 'deploy'].
         :param variables: (experimental) Global variables that are passed to jobs. If the job already has that variable defined, the job-level variable takes precedence.
         :param workflow: (experimental) Used to control pipeline behavior.
@@ -900,6 +951,7 @@ class CiConfigurationOptions:
             check_type(argname="argument default", value=default, expected_type=type_hints["default"])
             check_type(argname="argument jobs", value=jobs, expected_type=type_hints["jobs"])
             check_type(argname="argument pages", value=pages, expected_type=type_hints["pages"])
+            check_type(argname="argument path", value=path, expected_type=type_hints["path"])
             check_type(argname="argument stages", value=stages, expected_type=type_hints["stages"])
             check_type(argname="argument variables", value=variables, expected_type=type_hints["variables"])
             check_type(argname="argument workflow", value=workflow, expected_type=type_hints["workflow"])
@@ -910,6 +962,8 @@ class CiConfigurationOptions:
             self._values["jobs"] = jobs
         if pages is not None:
             self._values["pages"] = pages
+        if path is not None:
+            self._values["path"] = path
         if stages is not None:
             self._values["stages"] = stages
         if variables is not None:
@@ -949,6 +1003,15 @@ class CiConfigurationOptions:
         result = self._values.get("pages")
         return typing.cast(typing.Optional["Job"], result)
 
+    @builtins.property
+    def path(self) -> typing.Optional[builtins.str]:
+        '''(experimental) The path of the file to generate.
+
+        :stability: experimental
+        '''
+        result = self._values.get("path")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def stages(self) -> typing.Optional[typing.List[builtins.str]]:
         '''(experimental) Groups jobs into stages.
@@ -1055,6 +1118,8 @@ class CoverageReport:
         "artifacts": "artifacts",
         "before_script": "beforeScript",
         "cache": "cache",
+        "hooks": "hooks",
+        "id_tokens": "idTokens",
         "image": "image",
         "interruptible": "interruptible",
         "retry": "retry",
@@ -1071,6 +1136,8 @@ class Default:
         artifacts: typing.Optional[typing.Union[Artifacts, typing.Dict[builtins.str, typing.Any]]] = None,
         before_script: typing.Optional[typing.Sequence[builtins.str]] = None,
         cache: typing.Optional[typing.Sequence[typing.Union[Cache, typing.Dict[builtins.str, typing.Any]]]] = None,
+        hooks: typing.Optional[typing.Union["DefaultHooks", typing.Dict[builtins.str, typing.Any]]] = None,
+        id_tokens: typing.Optional[typing.Mapping[builtins.str, "IDToken"]] = None,
         image: typing.Optional[typing.Union["Image", typing.Dict[builtins.str, typing.Any]]] = None,
         interruptible: typing.Optional[builtins.bool] = None,
         retry: typing.Optional[typing.Union["Retry", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -1086,6 +1153,8 @@ class Default:
         :param artifacts: 
         :param before_script: 
         :param cache: 
+        :param hooks: (experimental) Specify a list of commands to execute on the runner before cloning the Git repository and any submodules https://docs.gitlab.com/ci/yaml/#hookspre_get_sources_script.
+        :param id_tokens: (experimental) Specifies the default ID tokens (JSON Web Tokens) that are used for CI/CD authentication to use globally for all jobs.
         :param image: 
         :param interruptible: 
         :param retry: 
@@ -1098,6 +1167,8 @@ class Default:
         '''
         if isinstance(artifacts, dict):
             artifacts = Artifacts(**artifacts)
+        if isinstance(hooks, dict):
+            hooks = DefaultHooks(**hooks)
         if isinstance(image, dict):
             image = Image(**image)
         if isinstance(retry, dict):
@@ -1108,6 +1179,8 @@ class Default:
             check_type(argname="argument artifacts", value=artifacts, expected_type=type_hints["artifacts"])
             check_type(argname="argument before_script", value=before_script, expected_type=type_hints["before_script"])
             check_type(argname="argument cache", value=cache, expected_type=type_hints["cache"])
+            check_type(argname="argument hooks", value=hooks, expected_type=type_hints["hooks"])
+            check_type(argname="argument id_tokens", value=id_tokens, expected_type=type_hints["id_tokens"])
             check_type(argname="argument image", value=image, expected_type=type_hints["image"])
             check_type(argname="argument interruptible", value=interruptible, expected_type=type_hints["interruptible"])
             check_type(argname="argument retry", value=retry, expected_type=type_hints["retry"])
@@ -1123,6 +1196,10 @@ class Default:
             self._values["before_script"] = before_script
         if cache is not None:
             self._values["cache"] = cache
+        if hooks is not None:
+            self._values["hooks"] = hooks
+        if id_tokens is not None:
+            self._values["id_tokens"] = id_tokens
         if image is not None:
             self._values["image"] = image
         if interruptible is not None:
@@ -1168,6 +1245,24 @@ class Default:
         result = self._values.get("cache")
         return typing.cast(typing.Optional[typing.List[Cache]], result)
 
+    @builtins.property
+    def hooks(self) -> typing.Optional["DefaultHooks"]:
+        '''(experimental) Specify a list of commands to execute on the runner before cloning the Git repository and any submodules https://docs.gitlab.com/ci/yaml/#hookspre_get_sources_script.
+
+        :stability: experimental
+        '''
+        result = self._values.get("hooks")
+        return typing.cast(typing.Optional["DefaultHooks"], result)
+
+    @builtins.property
+    def id_tokens(self) -> typing.Optional[typing.Mapping[builtins.str, "IDToken"]]:
+        '''(experimental) Specifies the default ID tokens (JSON Web Tokens) that are used for CI/CD authentication to use globally for all jobs.
+
+        :stability: experimental
+        '''
+        result = self._values.get("id_tokens")
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, "IDToken"]], result)
+
     @builtins.property
     def image(self) -> typing.Optional["Image"]:
         '''
@@ -1276,6 +1371,50 @@ class DefaultElement(enum.Enum):
     '''
 
 
+@jsii.data_type(
+    jsii_type="projen.gitlab.DefaultHooks",
+    jsii_struct_bases=[],
+    name_mapping={"pre_get_sources_script": "preGetSourcesScript"},
+)
+class DefaultHooks:
+    def __init__(
+        self,
+        *,
+        pre_get_sources_script: typing.Optional[typing.Sequence[builtins.str]] = None,
+    ) -> None:
+        '''
+        :param pre_get_sources_script: (experimental) Specify a list of commands to execute on the runner before cloning the Git repository and any submodules https://docs.gitlab.com/ci/yaml/#hookspre_get_sources_script.
+
+        :stability: experimental
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9ead82c15a4a68e5b98f5a4870a986cf8bfd8558ec475eafed66ba30ae376385)
+            check_type(argname="argument pre_get_sources_script", value=pre_get_sources_script, expected_type=type_hints["pre_get_sources_script"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if pre_get_sources_script is not None:
+            self._values["pre_get_sources_script"] = pre_get_sources_script
+
+    @builtins.property
+    def pre_get_sources_script(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''(experimental) Specify a list of commands to execute on the runner before cloning the Git repository and any submodules https://docs.gitlab.com/ci/yaml/#hookspre_get_sources_script.
+
+        :stability: experimental
+        '''
+        result = self._values.get("pre_get_sources_script")
+        return typing.cast(typing.Optional[typing.List[builtins.str]], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "DefaultHooks(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.enum(jsii_type="projen.gitlab.DeploymentTier")
 class DeploymentTier(enum.Enum):
     '''(experimental) Explicitly specifies the tier of the deployment environment if non-standard environment name is used.
@@ -1617,6 +1756,7 @@ class GitlabConfiguration(
         default: typing.Optional[typing.Union[Default, typing.Dict[builtins.str, typing.Any]]] = None,
         jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union["Job", typing.Dict[builtins.str, typing.Any]]]] = None,
         pages: typing.Optional[typing.Union["Job", typing.Dict[builtins.str, typing.Any]]] = None,
+        path: typing.Optional[builtins.str] = None,
         stages: typing.Optional[typing.Sequence[builtins.str]] = None,
         variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
         workflow: typing.Optional[typing.Union["Workflow", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -1626,6 +1766,7 @@ class GitlabConfiguration(
         :param default: (experimental) Default settings for the CI Configuration. Jobs that do not define one or more of the listed keywords use the value defined in the default section.
         :param jobs: (experimental) An initial set of jobs to add to the configuration.
         :param pages: (experimental) A special job used to upload static sites to Gitlab pages. Requires a ``public/`` directory with ``artifacts.path`` pointing to it.
+        :param path: (experimental) The path of the file to generate.
         :param stages: (experimental) Groups jobs into stages. All jobs in one stage must complete before next stage is executed. If no stages are specified. Defaults to ['build', 'test', 'deploy'].
         :param variables: (experimental) Global variables that are passed to jobs. If the job already has that variable defined, the job-level variable takes precedence.
         :param workflow: (experimental) Used to control pipeline behavior.
@@ -1639,6 +1780,7 @@ class GitlabConfiguration(
             default=default,
             jobs=jobs,
             pages=pages,
+            path=path,
             stages=stages,
             variables=variables,
             workflow=workflow,
@@ -1720,7 +1862,7 @@ class _IDTokenProxy:
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a9e6bbd7c1d3e16ffa82367cdd5ca16ce06a42726f4193639790a39bb2eadef9)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "aud", value)
+        jsii.set(self, "aud", value) # pyright: ignore[reportArgumentType]
 
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
 typing.cast(typing.Any, IDToken).__jsii_proxy_class__ = lambda : _IDTokenProxy
@@ -1944,6 +2086,7 @@ class Include:
         "changes": "changes",
         "exists": "exists",
         "if_": "if",
+        "needs": "needs",
         "start_in": "startIn",
         "variables": "variables",
         "when": "when",
@@ -1957,6 +2100,7 @@ class IncludeRule:
         changes: typing.Optional[typing.Sequence[builtins.str]] = None,
         exists: typing.Optional[typing.Sequence[builtins.str]] = None,
         if_: typing.Optional[builtins.str] = None,
+        needs: typing.Optional[typing.Sequence[builtins.str]] = None,
         start_in: typing.Optional[builtins.str] = None,
         variables: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
         when: typing.Optional["JobWhen"] = None,
@@ -1967,6 +2111,7 @@ class IncludeRule:
         :param changes: 
         :param exists: 
         :param if_: 
+        :param needs: 
         :param start_in: 
         :param variables: 
         :param when: 
@@ -1980,6 +2125,7 @@ class IncludeRule:
             check_type(argname="argument changes", value=changes, expected_type=type_hints["changes"])
             check_type(argname="argument exists", value=exists, expected_type=type_hints["exists"])
             check_type(argname="argument if_", value=if_, expected_type=type_hints["if_"])
+            check_type(argname="argument needs", value=needs, expected_type=type_hints["needs"])
             check_type(argname="argument start_in", value=start_in, expected_type=type_hints["start_in"])
             check_type(argname="argument variables", value=variables, expected_type=type_hints["variables"])
             check_type(argname="argument when", value=when, expected_type=type_hints["when"])
@@ -1992,6 +2138,8 @@ class IncludeRule:
             self._values["exists"] = exists
         if if_ is not None:
             self._values["if_"] = if_
+        if needs is not None:
+            self._values["needs"] = needs
         if start_in is not None:
             self._values["start_in"] = start_in
         if variables is not None:
@@ -2033,6 +2181,14 @@ class IncludeRule:
         result = self._values.get("if_")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def needs(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''
+        :stability: experimental
+        '''
+        result = self._values.get("needs")
+        return typing.cast(typing.Optional[typing.List[builtins.str]], result)
+
     @builtins.property
     def start_in(self) -> typing.Optional[builtins.str]:
         '''
@@ -2155,6 +2311,7 @@ class Inherit:
         "environment": "environment",
         "except_": "except",
         "extends": "extends",
+        "hooks": "hooks",
         "id_tokens": "idTokens",
         "image": "image",
         "inherit": "inherit",
@@ -2192,6 +2349,7 @@ class Job:
         environment: typing.Optional[typing.Union[builtins.str, typing.Union[Environment, typing.Dict[builtins.str, typing.Any]]]] = None,
         except_: typing.Optional[typing.Union[typing.Sequence[builtins.str], typing.Union[Filter, typing.Dict[builtins.str, typing.Any]]]] = None,
         extends: typing.Optional[typing.Sequence[builtins.str]] = None,
+        hooks: typing.Optional[typing.Union[DefaultHooks, typing.Dict[builtins.str, typing.Any]]] = None,
         id_tokens: typing.Optional[typing.Mapping[builtins.str, IDToken]] = None,
         image: typing.Optional[typing.Union[Image, typing.Dict[builtins.str, typing.Any]]] = None,
         inherit: typing.Optional[typing.Union[Inherit, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -2226,6 +2384,7 @@ class Job:
         :param environment: (experimental) Used to associate environment metadata with a deploy. Environment can have a name and URL attached to it, and will be displayed under /environments under the project.
         :param except_: (experimental) Job will run *except* for when these filtering options match.
         :param extends: (experimental) The name of one or more jobs to inherit configuration from.
+        :param hooks: 
         :param id_tokens: (experimental) Configurable ID tokens (JSON Web Tokens) that are used for CI/CD authentication.
         :param image: 
         :param inherit: (experimental) Controls inheritance of globally-defined defaults and variables. Boolean values control inheritance of all default: or variables: keywords. To inherit only a subset of default: or variables: keywords, specify what you wish to inherit. Anything not listed is not inherited.
@@ -2253,6 +2412,8 @@ class Job:
         '''
         if isinstance(artifacts, dict):
             artifacts = Artifacts(**artifacts)
+        if isinstance(hooks, dict):
+            hooks = DefaultHooks(**hooks)
         if isinstance(image, dict):
             image = Image(**image)
         if isinstance(inherit, dict):
@@ -2273,6 +2434,7 @@ class Job:
             check_type(argname="argument environment", value=environment, expected_type=type_hints["environment"])
             check_type(argname="argument except_", value=except_, expected_type=type_hints["except_"])
             check_type(argname="argument extends", value=extends, expected_type=type_hints["extends"])
+            check_type(argname="argument hooks", value=hooks, expected_type=type_hints["hooks"])
             check_type(argname="argument id_tokens", value=id_tokens, expected_type=type_hints["id_tokens"])
             check_type(argname="argument image", value=image, expected_type=type_hints["image"])
             check_type(argname="argument inherit", value=inherit, expected_type=type_hints["inherit"])
@@ -2315,6 +2477,8 @@ class Job:
             self._values["except_"] = except_
         if extends is not None:
             self._values["extends"] = extends
+        if hooks is not None:
+            self._values["hooks"] = hooks
         if id_tokens is not None:
             self._values["id_tokens"] = id_tokens
         if image is not None:
@@ -2454,6 +2618,14 @@ class Job:
         result = self._values.get("extends")
         return typing.cast(typing.Optional[typing.List[builtins.str]], result)
 
+    @builtins.property
+    def hooks(self) -> typing.Optional[DefaultHooks]:
+        '''
+        :stability: experimental
+        '''
+        result = self._values.get("hooks")
+        return typing.cast(typing.Optional[DefaultHooks], result)
+
     @builtins.property
     def id_tokens(self) -> typing.Optional[typing.Mapping[builtins.str, IDToken]]:
         '''(experimental) Configurable ID tokens (JSON Web Tokens) that are used for CI/CD authentication.
@@ -3007,6 +3179,7 @@ class NestedConfiguration(
         default: typing.Optional[typing.Union[Default, typing.Dict[builtins.str, typing.Any]]] = None,
         jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union[Job, typing.Dict[builtins.str, typing.Any]]]] = None,
         pages: typing.Optional[typing.Union[Job, typing.Dict[builtins.str, typing.Any]]] = None,
+        path: typing.Optional[builtins.str] = None,
         stages: typing.Optional[typing.Sequence[builtins.str]] = None,
         variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
         workflow: typing.Optional[typing.Union["Workflow", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -3018,6 +3191,7 @@ class NestedConfiguration(
         :param default: (experimental) Default settings for the CI Configuration. Jobs that do not define one or more of the listed keywords use the value defined in the default section.
         :param jobs: (experimental) An initial set of jobs to add to the configuration.
         :param pages: (experimental) A special job used to upload static sites to Gitlab pages. Requires a ``public/`` directory with ``artifacts.path`` pointing to it.
+        :param path: (experimental) The path of the file to generate.
         :param stages: (experimental) Groups jobs into stages. All jobs in one stage must complete before next stage is executed. If no stages are specified. Defaults to ['build', 'test', 'deploy'].
         :param variables: (experimental) Global variables that are passed to jobs. If the job already has that variable defined, the job-level variable takes precedence.
         :param workflow: (experimental) Used to control pipeline behavior.
@@ -3033,6 +3207,7 @@ class NestedConfiguration(
             default=default,
             jobs=jobs,
             pages=pages,
+            path=path,
             stages=stages,
             variables=variables,
             workflow=workflow,
@@ -3804,14 +3979,22 @@ class Service:
 
 @jsii.enum(jsii_type="projen.gitlab.Strategy")
 class Strategy(enum.Enum):
-    '''(experimental) You can mirror the pipeline status from the triggered pipeline to the source bridge job by using strategy: depend.
+    '''(experimental) You can mirror the pipeline status from the triggered pipeline to the source bridge job by using strategy: depend or mirror.
 
     :see: https://docs.gitlab.com/ee/ci/yaml/#triggerstrategy
     :stability: experimental
     '''
 
     DEPEND = "DEPEND"
+    '''(experimental) Not recommended, use mirror instead.
+
+    The trigger job status shows failed, success, or running, depending on the downstream pipeline status.
+
+    :stability: experimental
     '''
+    MIRROR = "MIRROR"
+    '''(experimental) Mirrors the status of the downstream pipeline exactly.
+
     :stability: experimental
     '''
 
@@ -3822,6 +4005,7 @@ class Strategy(enum.Enum):
     name_mapping={
         "branch": "branch",
         "include": "include",
+        "inputs": "inputs",
         "project": "project",
         "strategy": "strategy",
     },
@@ -3832,6 +4016,7 @@ class Trigger:
         *,
         branch: typing.Optional[builtins.str] = None,
         include: typing.Optional[typing.Sequence[typing.Union["TriggerInclude", typing.Dict[builtins.str, typing.Any]]]] = None,
+        inputs: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
         project: typing.Optional[builtins.str] = None,
         strategy: typing.Optional[Strategy] = None,
     ) -> None:
@@ -3841,6 +4026,7 @@ class Trigger:
 
         :param branch: (experimental) The branch name that a downstream pipeline will use.
         :param include: (experimental) A list of local files or artifacts from other jobs to define the pipeline.
+        :param inputs: (experimental) Input parameters for the downstream pipeline when using spec:inputs.
         :param project: (experimental) Path to the project, e.g. ``group/project``, or ``group/sub-group/project``.
         :param strategy: (experimental) You can mirror the pipeline status from the triggered pipeline to the source bridge job by using strategy: depend.
 
@@ -3851,6 +4037,7 @@ class Trigger:
             type_hints = typing.get_type_hints(_typecheckingstub__78aec6a6c462331cffb8d8af511a7a04ea96a7e260e03f8d857ba57103b6c89f)
             check_type(argname="argument branch", value=branch, expected_type=type_hints["branch"])
             check_type(argname="argument include", value=include, expected_type=type_hints["include"])
+            check_type(argname="argument inputs", value=inputs, expected_type=type_hints["inputs"])
             check_type(argname="argument project", value=project, expected_type=type_hints["project"])
             check_type(argname="argument strategy", value=strategy, expected_type=type_hints["strategy"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
@@ -3858,6 +4045,8 @@ class Trigger:
             self._values["branch"] = branch
         if include is not None:
             self._values["include"] = include
+        if inputs is not None:
+            self._values["inputs"] = inputs
         if project is not None:
             self._values["project"] = project
         if strategy is not None:
@@ -3881,6 +4070,15 @@ class Trigger:
         result = self._values.get("include")
         return typing.cast(typing.Optional[typing.List["TriggerInclude"]], result)
 
+    @builtins.property
+    def inputs(self) -> typing.Optional[typing.Mapping[builtins.str, typing.Any]]:
+        '''(experimental) Input parameters for the downstream pipeline when using spec:inputs.
+
+        :stability: experimental
+        '''
+        result = self._values.get("inputs")
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, typing.Any]], result)
+
     @builtins.property
     def project(self) -> typing.Optional[builtins.str]:
         '''(experimental) Path to the project, e.g. ``group/project``, or ``group/sub-group/project``.
@@ -4189,16 +4387,18 @@ class VaultConfig:
 @jsii.data_type(
     jsii_type="projen.gitlab.Workflow",
     jsii_struct_bases=[],
-    name_mapping={"rules": "rules"},
+    name_mapping={"name": "name", "rules": "rules"},
 )
 class Workflow:
     def __init__(
         self,
         *,
+        name: typing.Optional[builtins.str] = None,
         rules: typing.Optional[typing.Sequence[typing.Union["WorkflowRule", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''(experimental) Used to control pipeline behavior.
 
+        :param name: (experimental) You can use name to define a name for pipelines.
         :param rules: (experimental) Used to control whether or not a whole pipeline is created.
 
         :see: https://docs.gitlab.com/ee/ci/yaml/#workflow
@@ -4206,11 +4406,23 @@ class Workflow:
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__e0b75047f6bf7eb788b08fc007a66573480a38e913bde351acaac05347d467b1)
+            check_type(argname="argument name", value=name, expected_type=type_hints["name"])
             check_type(argname="argument rules", value=rules, expected_type=type_hints["rules"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if name is not None:
+            self._values["name"] = name
         if rules is not None:
             self._values["rules"] = rules
 
+    @builtins.property
+    def name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) You can use name to define a name for pipelines.
+
+        :stability: experimental
+        '''
+        result = self._values.get("name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def rules(self) -> typing.Optional[typing.List["WorkflowRule"]]:
         '''(experimental) Used to control whether or not a whole pipeline is created.
@@ -4251,7 +4463,7 @@ class WorkflowRule:
         exists: typing.Optional[typing.Sequence[builtins.str]] = None,
         if_: typing.Optional[builtins.str] = None,
         variables: typing.Optional[typing.Mapping[builtins.str, typing.Union[builtins.str, jsii.Number]]] = None,
-        when: typing.Optional[JobWhen] = None,
+        when: typing.Optional["WorkflowWhen"] = None,
     ) -> None:
         '''(experimental) Used to control whether or not a whole pipeline is created.
 
@@ -4318,12 +4530,12 @@ class WorkflowRule:
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, typing.Union[builtins.str, jsii.Number]]], result)
 
     @builtins.property
-    def when(self) -> typing.Optional[JobWhen]:
+    def when(self) -> typing.Optional["WorkflowWhen"]:
         '''
         :stability: experimental
         '''
         result = self._values.get("when")
-        return typing.cast(typing.Optional[JobWhen], result)
+        return typing.cast(typing.Optional["WorkflowWhen"], result)
 
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -4372,6 +4584,7 @@ __all__ = [
     "CoverageReport",
     "Default",
     "DefaultElement",
+    "DefaultHooks",
     "DeploymentTier",
     "Engine",
     "Environment",
@@ -4464,6 +4677,7 @@ def _typecheckingstub__231c30bc513f8e09e345dd63392e7c50f479df9f480fc36e03e88fc4a
     default: typing.Optional[typing.Union[Default, typing.Dict[builtins.str, typing.Any]]] = None,
     jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union[Job, typing.Dict[builtins.str, typing.Any]]]] = None,
     pages: typing.Optional[typing.Union[Job, typing.Dict[builtins.str, typing.Any]]] = None,
+    path: typing.Optional[builtins.str] = None,
     stages: typing.Optional[typing.Sequence[builtins.str]] = None,
     variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
     workflow: typing.Optional[typing.Union[Workflow, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4512,6 +4726,7 @@ def _typecheckingstub__cad6204d94421a2493e44c6131e44e9ac2175546be72d0e655df76252
     default: typing.Optional[typing.Union[Default, typing.Dict[builtins.str, typing.Any]]] = None,
     jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union[Job, typing.Dict[builtins.str, typing.Any]]]] = None,
     pages: typing.Optional[typing.Union[Job, typing.Dict[builtins.str, typing.Any]]] = None,
+    path: typing.Optional[builtins.str] = None,
     stages: typing.Optional[typing.Sequence[builtins.str]] = None,
     variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
     workflow: typing.Optional[typing.Union[Workflow, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4533,6 +4748,8 @@ def _typecheckingstub__c8e71d01eda90297db6af675f51033414546212b06d49c00c218dee20
     artifacts: typing.Optional[typing.Union[Artifacts, typing.Dict[builtins.str, typing.Any]]] = None,
     before_script: typing.Optional[typing.Sequence[builtins.str]] = None,
     cache: typing.Optional[typing.Sequence[typing.Union[Cache, typing.Dict[builtins.str, typing.Any]]]] = None,
+    hooks: typing.Optional[typing.Union[DefaultHooks, typing.Dict[builtins.str, typing.Any]]] = None,
+    id_tokens: typing.Optional[typing.Mapping[builtins.str, IDToken]] = None,
     image: typing.Optional[typing.Union[Image, typing.Dict[builtins.str, typing.Any]]] = None,
     interruptible: typing.Optional[builtins.bool] = None,
     retry: typing.Optional[typing.Union[Retry, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4543,6 +4760,13 @@ def _typecheckingstub__c8e71d01eda90297db6af675f51033414546212b06d49c00c218dee20
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__9ead82c15a4a68e5b98f5a4870a986cf8bfd8558ec475eafed66ba30ae376385(
+    *,
+    pre_get_sources_script: typing.Optional[typing.Sequence[builtins.str]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__4574deb50cf9019e113c67d714da29685143324fc4e1df06c5ea08a874de8223(
     *,
     name: builtins.str,
@@ -4580,6 +4804,7 @@ def _typecheckingstub__9b7c22b752837d5c419877611c3664caa886539ab5209465bbfe27372
     default: typing.Optional[typing.Union[Default, typing.Dict[builtins.str, typing.Any]]] = None,
     jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union[Job, typing.Dict[builtins.str, typing.Any]]]] = None,
     pages: typing.Optional[typing.Union[Job, typing.Dict[builtins.str, typing.Any]]] = None,
+    path: typing.Optional[builtins.str] = None,
     stages: typing.Optional[typing.Sequence[builtins.str]] = None,
     variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
     workflow: typing.Optional[typing.Union[Workflow, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4626,6 +4851,7 @@ def _typecheckingstub__5547025bbe422124f59e782b7141894ba37dbf0049070c73b17f39de1
     changes: typing.Optional[typing.Sequence[builtins.str]] = None,
     exists: typing.Optional[typing.Sequence[builtins.str]] = None,
     if_: typing.Optional[builtins.str] = None,
+    needs: typing.Optional[typing.Sequence[builtins.str]] = None,
     start_in: typing.Optional[builtins.str] = None,
     variables: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
     when: typing.Optional[JobWhen] = None,
@@ -4653,6 +4879,7 @@ def _typecheckingstub__485afb8ca4cf12bdaab3c3455c7b90f3ea9d549eb87ec6fd05eae046f
     environment: typing.Optional[typing.Union[builtins.str, typing.Union[Environment, typing.Dict[builtins.str, typing.Any]]]] = None,
     except_: typing.Optional[typing.Union[typing.Sequence[builtins.str], typing.Union[Filter, typing.Dict[builtins.str, typing.Any]]]] = None,
     extends: typing.Optional[typing.Sequence[builtins.str]] = None,
+    hooks: typing.Optional[typing.Union[DefaultHooks, typing.Dict[builtins.str, typing.Any]]] = None,
     id_tokens: typing.Optional[typing.Mapping[builtins.str, IDToken]] = None,
     image: typing.Optional[typing.Union[Image, typing.Dict[builtins.str, typing.Any]]] = None,
     inherit: typing.Optional[typing.Union[Inherit, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4715,6 +4942,7 @@ def _typecheckingstub__23d7f1d8d243fb7e275a0eeba3f1419822bf2c274e47641e553a5675c
     default: typing.Optional[typing.Union[Default, typing.Dict[builtins.str, typing.Any]]] = None,
     jobs: typing.Optional[typing.Mapping[builtins.str, typing.Union[Job, typing.Dict[builtins.str, typing.Any]]]] = None,
     pages: typing.Optional[typing.Union[Job, typing.Dict[builtins.str, typing.Any]]] = None,
+    path: typing.Optional[builtins.str] = None,
     stages: typing.Optional[typing.Sequence[builtins.str]] = None,
     variables: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
     workflow: typing.Optional[typing.Union[Workflow, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4796,6 +5024,7 @@ def _typecheckingstub__78aec6a6c462331cffb8d8af511a7a04ea96a7e260e03f8d857ba5710
     *,
     branch: typing.Optional[builtins.str] = None,
     include: typing.Optional[typing.Sequence[typing.Union[TriggerInclude, typing.Dict[builtins.str, typing.Any]]]] = None,
+    inputs: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
     project: typing.Optional[builtins.str] = None,
     strategy: typing.Optional[Strategy] = None,
 ) -> None:
@@ -4834,6 +5063,7 @@ def _typecheckingstub__8bf8b88995e7b236e0548afd560041fc8de683c71708218ce1af2818e
 
 def _typecheckingstub__e0b75047f6bf7eb788b08fc007a66573480a38e913bde351acaac05347d467b1(
     *,
+    name: typing.Optional[builtins.str] = None,
     rules: typing.Optional[typing.Sequence[typing.Union[WorkflowRule, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -4845,7 +5075,10 @@ def _typecheckingstub__01a2cf4c2a982a749d12511d9e43468f3b4a9cca16d6c56d9a2cfd115
     exists: typing.Optional[typing.Sequence[builtins.str]] = None,
     if_: typing.Optional[builtins.str] = None,
     variables: typing.Optional[typing.Mapping[builtins.str, typing.Union[builtins.str, jsii.Number]]] = None,
-    when: typing.Optional[JobWhen] = None,
+    when: typing.Optional[WorkflowWhen] = None,
 ) -> None:
     """Type checking stubs"""
     pass
+
+for cls in [IDToken]:
+    typing.cast(typing.Any, cls).__protocol_attrs__ = typing.cast(typing.Any, cls).__protocol_attrs__ - set(['__jsii_proxy_class__', '__jsii_type__'])