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

projen/java/__init__.py

@@ -11,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 *
 
@@ -40,6 +55,26 @@ from ..github import (
 )
 
 
+@jsii.enum(jsii_type="projen.java.ChecksumPolicy")
+class ChecksumPolicy(enum.Enum):
+    '''
+    :stability: experimental
+    '''
+
+    IGNORE = "IGNORE"
+    '''
+    :stability: experimental
+    '''
+    FAIL = "FAIL"
+    '''
+    :stability: experimental
+    '''
+    WARN = "WARN"
+    '''
+    :stability: experimental
+    '''
+
+
 class JavaProject(
     _GitHubProject_c48bc7ea,
     metaclass=jsii.JSIIMeta,
@@ -689,7 +724,14 @@ class MavenPackagingOptions:
 @jsii.data_type(
     jsii_type="projen.java.MavenRepository",
     jsii_struct_bases=[],
-    name_mapping={"id": "id", "url": "url", "layout": "layout", "name": "name"},
+    name_mapping={
+        "id": "id",
+        "url": "url",
+        "layout": "layout",
+        "name": "name",
+        "releases": "releases",
+        "snapshots": "snapshots",
+    },
 )
 class MavenRepository:
     def __init__(
@@ -699,6 +741,8 @@ class MavenRepository:
         url: builtins.str,
         layout: typing.Optional[builtins.str] = None,
         name: typing.Optional[builtins.str] = None,
+        releases: typing.Optional[typing.Union["MavenRepositoryPolicy", typing.Dict[builtins.str, typing.Any]]] = None,
+        snapshots: typing.Optional[typing.Union["MavenRepositoryPolicy", typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''(experimental) Represents a Maven repository.
 
@@ -706,16 +750,24 @@ class MavenRepository:
         :param url: (experimental) The url of the repository.
         :param layout: (experimental) The layout of the repository.
         :param name: (experimental) The name of the repository.
+        :param releases: (experimental) Repository Policy for Releases.
+        :param snapshots: (experimental) Repository Policy for Snapshots.
 
         :see: https://maven.apache.org/guides/introduction/introduction-to-repositories.html
         :stability: experimental
         '''
+        if isinstance(releases, dict):
+            releases = MavenRepositoryPolicy(**releases)
+        if isinstance(snapshots, dict):
+            snapshots = MavenRepositoryPolicy(**snapshots)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__12e8ee88cd330385feef214bd08b3bc44314dc15ddbcd48e4f74c198bda84bde)
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
             check_type(argname="argument url", value=url, expected_type=type_hints["url"])
             check_type(argname="argument layout", value=layout, expected_type=type_hints["layout"])
             check_type(argname="argument name", value=name, expected_type=type_hints["name"])
+            check_type(argname="argument releases", value=releases, expected_type=type_hints["releases"])
+            check_type(argname="argument snapshots", value=snapshots, expected_type=type_hints["snapshots"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "id": id,
             "url": url,
@@ -724,6 +776,10 @@ class MavenRepository:
             self._values["layout"] = layout
         if name is not None:
             self._values["name"] = name
+        if releases is not None:
+            self._values["releases"] = releases
+        if snapshots is not None:
+            self._values["snapshots"] = snapshots
 
     @builtins.property
     def id(self) -> builtins.str:
@@ -763,6 +819,24 @@ class MavenRepository:
         result = self._values.get("name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def releases(self) -> typing.Optional["MavenRepositoryPolicy"]:
+        '''(experimental) Repository Policy for Releases.
+
+        :stability: experimental
+        '''
+        result = self._values.get("releases")
+        return typing.cast(typing.Optional["MavenRepositoryPolicy"], result)
+
+    @builtins.property
+    def snapshots(self) -> typing.Optional["MavenRepositoryPolicy"]:
+        '''(experimental) Repository Policy for Snapshots.
+
+        :stability: experimental
+        '''
+        result = self._values.get("snapshots")
+        return typing.cast(typing.Optional["MavenRepositoryPolicy"], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -775,6 +849,87 @@ class MavenRepository:
         )
 
 
+@jsii.data_type(
+    jsii_type="projen.java.MavenRepositoryPolicy",
+    jsii_struct_bases=[],
+    name_mapping={
+        "checksum_policy": "checksumPolicy",
+        "enabled": "enabled",
+        "update_policy": "updatePolicy",
+    },
+)
+class MavenRepositoryPolicy:
+    def __init__(
+        self,
+        *,
+        checksum_policy: typing.Optional[ChecksumPolicy] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        update_policy: typing.Optional["UpdatePolicy"] = None,
+    ) -> None:
+        '''(experimental) Represents a Maven Repository Policy.
+
+        :param checksum_policy: (experimental) Checksum Policy When Maven deploys files to the repository, it also deploys corresponding checksum files.
+        :param enabled: 
+        :param update_policy: (experimental) Update Policy This element specifies how often updates should attempt to occur. Maven will compare the local POM's timestamp (stored in a repository's maven-metadata file) to the remote. Default: UpdatePolicy.DAILY
+
+        :see: https://maven.apache.org/settings.html#repositories
+        :stability: experimental
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__041e104cddeb68a13d0b79cfdce8653000ee58d2c7cef3088a2c8717d7f02ebf)
+            check_type(argname="argument checksum_policy", value=checksum_policy, expected_type=type_hints["checksum_policy"])
+            check_type(argname="argument enabled", value=enabled, expected_type=type_hints["enabled"])
+            check_type(argname="argument update_policy", value=update_policy, expected_type=type_hints["update_policy"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if checksum_policy is not None:
+            self._values["checksum_policy"] = checksum_policy
+        if enabled is not None:
+            self._values["enabled"] = enabled
+        if update_policy is not None:
+            self._values["update_policy"] = update_policy
+
+    @builtins.property
+    def checksum_policy(self) -> typing.Optional[ChecksumPolicy]:
+        '''(experimental) Checksum Policy When Maven deploys files to the repository, it also deploys corresponding checksum files.
+
+        :stability: experimental
+        '''
+        result = self._values.get("checksum_policy")
+        return typing.cast(typing.Optional[ChecksumPolicy], result)
+
+    @builtins.property
+    def enabled(self) -> typing.Optional[builtins.bool]:
+        '''
+        :stability: experimental
+        '''
+        result = self._values.get("enabled")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    @builtins.property
+    def update_policy(self) -> typing.Optional["UpdatePolicy"]:
+        '''(experimental) Update Policy This element specifies how often updates should attempt to occur.
+
+        Maven will compare the local POM's timestamp (stored in a repository's maven-metadata file) to the remote.
+
+        :default: UpdatePolicy.DAILY
+
+        :stability: experimental
+        '''
+        result = self._values.get("update_policy")
+        return typing.cast(typing.Optional["UpdatePolicy"], 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 "MavenRepositoryPolicy(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 class MavenSample(
     _Component_2b0ad27f,
     metaclass=jsii.JSIIMeta,
@@ -935,7 +1090,12 @@ class ParentPom:
 @jsii.data_type(
     jsii_type="projen.java.PluginExecution",
     jsii_struct_bases=[],
-    name_mapping={"goals": "goals", "id": "id", "phase": "phase"},
+    name_mapping={
+        "goals": "goals",
+        "id": "id",
+        "configuration": "configuration",
+        "phase": "phase",
+    },
 )
 class PluginExecution:
     def __init__(
@@ -943,12 +1103,14 @@ class PluginExecution:
         *,
         goals: typing.Sequence[builtins.str],
         id: builtins.str,
+        configuration: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
         phase: typing.Optional[builtins.str] = None,
     ) -> None:
         '''(experimental) Plugin execution definition.
 
         :param goals: (experimental) Which Maven goals this plugin should be associated with.
         :param id: (experimental) The ID.
+        :param configuration: (experimental) Execution key/value configuration. Default: {}
         :param phase: (experimental) The phase in which the plugin should execute.
 
         :stability: experimental
@@ -957,11 +1119,14 @@ class PluginExecution:
             type_hints = typing.get_type_hints(_typecheckingstub__b8b1bc2eb1ab79c9e54c8b62fd341a87dd82eec6a2b2ec76a5fdb6f1c51d5444)
             check_type(argname="argument goals", value=goals, expected_type=type_hints["goals"])
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument configuration", value=configuration, expected_type=type_hints["configuration"])
             check_type(argname="argument phase", value=phase, expected_type=type_hints["phase"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "goals": goals,
             "id": id,
         }
+        if configuration is not None:
+            self._values["configuration"] = configuration
         if phase is not None:
             self._values["phase"] = phase
 
@@ -985,6 +1150,19 @@ class PluginExecution:
         assert result is not None, "Required property 'id' is missing"
         return typing.cast(builtins.str, result)
 
+    @builtins.property
+    def configuration(
+        self,
+    ) -> typing.Optional[typing.Mapping[builtins.str, typing.Any]]:
+        '''(experimental) Execution key/value configuration.
+
+        :default: {}
+
+        :stability: experimental
+        '''
+        result = self._values.get("configuration")
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, typing.Any]], result)
+
     @builtins.property
     def phase(self) -> typing.Optional[builtins.str]:
         '''(experimental) The phase in which the plugin should execute.
@@ -1186,6 +1364,38 @@ class Pom(_Component_2b0ad27f, metaclass=jsii.JSIIMeta, jsii_type="projen.java.P
 
         return typing.cast(_Dependency_f510e013, jsii.invoke(self, "addPlugin", [spec, options]))
 
+    @jsii.member(jsii_name="addPluginRepository")
+    def add_plugin_repository(
+        self,
+        *,
+        id: builtins.str,
+        url: builtins.str,
+        layout: typing.Optional[builtins.str] = None,
+        name: typing.Optional[builtins.str] = None,
+        releases: typing.Optional[typing.Union[MavenRepositoryPolicy, typing.Dict[builtins.str, typing.Any]]] = None,
+        snapshots: typing.Optional[typing.Union[MavenRepositoryPolicy, typing.Dict[builtins.str, typing.Any]]] = None,
+    ) -> None:
+        '''
+        :param id: (experimental) The identifier for the repository.
+        :param url: (experimental) The url of the repository.
+        :param layout: (experimental) The layout of the repository.
+        :param name: (experimental) The name of the repository.
+        :param releases: (experimental) Repository Policy for Releases.
+        :param snapshots: (experimental) Repository Policy for Snapshots.
+
+        :stability: experimental
+        '''
+        repository = MavenRepository(
+            id=id,
+            url=url,
+            layout=layout,
+            name=name,
+            releases=releases,
+            snapshots=snapshots,
+        )
+
+        return typing.cast(None, jsii.invoke(self, "addPluginRepository", [repository]))
+
     @jsii.member(jsii_name="addProperty")
     def add_property(self, key: builtins.str, value: builtins.str) -> None:
         '''(experimental) Adds a key/value property to the pom.
@@ -1209,6 +1419,8 @@ class Pom(_Component_2b0ad27f, metaclass=jsii.JSIIMeta, jsii_type="projen.java.P
         url: builtins.str,
         layout: typing.Optional[builtins.str] = None,
         name: typing.Optional[builtins.str] = None,
+        releases: typing.Optional[typing.Union[MavenRepositoryPolicy, typing.Dict[builtins.str, typing.Any]]] = None,
+        snapshots: typing.Optional[typing.Union[MavenRepositoryPolicy, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''(experimental) Adds a repository to the pom.
 
@@ -1216,10 +1428,19 @@ class Pom(_Component_2b0ad27f, metaclass=jsii.JSIIMeta, jsii_type="projen.java.P
         :param url: (experimental) The url of the repository.
         :param layout: (experimental) The layout of the repository.
         :param name: (experimental) The name of the repository.
+        :param releases: (experimental) Repository Policy for Releases.
+        :param snapshots: (experimental) Repository Policy for Snapshots.
 
         :stability: experimental
         '''
-        repository = MavenRepository(id=id, url=url, layout=layout, name=name)
+        repository = MavenRepository(
+            id=id,
+            url=url,
+            layout=layout,
+            name=name,
+            releases=releases,
+            snapshots=snapshots,
+        )
 
         return typing.cast(None, jsii.invoke(self, "addRepository", [repository]))
 
@@ -1659,6 +1880,56 @@ class ProjenrcOptions:
         )
 
 
+class UpdatePolicy(metaclass=jsii.JSIIMeta, jsii_type="projen.java.UpdatePolicy"):
+    '''
+    :stability: experimental
+    '''
+
+    def __init__(self) -> None:
+        '''
+        :stability: experimental
+        '''
+        jsii.create(self.__class__, self, [])
+
+    @jsii.member(jsii_name="interval")
+    @builtins.classmethod
+    def interval(cls, minutes: jsii.Number) -> builtins.str:
+        '''(experimental) Updates at an interval of X minutes.
+
+        :param minutes: -
+
+        :stability: experimental
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__0bf8e37b8aa70ecfb764a100f3a50eabbce221f62cf2cc199c929b8132fe42cc)
+            check_type(argname="argument minutes", value=minutes, expected_type=type_hints["minutes"])
+        return typing.cast(builtins.str, jsii.sinvoke(cls, "interval", [minutes]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="ALWAYS")
+    def ALWAYS(cls) -> builtins.str:
+        '''
+        :stability: experimental
+        '''
+        return typing.cast(builtins.str, jsii.sget(cls, "ALWAYS"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="DAILY")
+    def DAILY(cls) -> builtins.str:
+        '''
+        :stability: experimental
+        '''
+        return typing.cast(builtins.str, jsii.sget(cls, "DAILY"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="NEVER")
+    def NEVER(cls) -> builtins.str:
+        '''
+        :stability: experimental
+        '''
+        return typing.cast(builtins.str, jsii.sget(cls, "NEVER"))
+
+
 @jsii.data_type(
     jsii_type="projen.java.JavaProjectCommonOptions",
     jsii_struct_bases=[_GitHubProjectOptions_547f2d08, PomOptions],
@@ -3532,6 +3803,7 @@ class JavaProjectOptions(JavaProjectCommonOptions):
 
 
 __all__ = [
+    "ChecksumPolicy",
     "JavaProject",
     "JavaProjectCommonOptions",
     "JavaProjectOptions",
@@ -3542,6 +3814,7 @@ __all__ = [
     "MavenPackaging",
     "MavenPackagingOptions",
     "MavenRepository",
+    "MavenRepositoryPolicy",
     "MavenSample",
     "MavenSampleOptions",
     "ParentPom",
@@ -3551,6 +3824,7 @@ __all__ = [
     "PomOptions",
     "Projenrc",
     "ProjenrcOptions",
+    "UpdatePolicy",
 ]
 
 publication.publish()
@@ -3642,6 +3916,17 @@ def _typecheckingstub__12e8ee88cd330385feef214bd08b3bc44314dc15ddbcd48e4f74c198b
     url: builtins.str,
     layout: typing.Optional[builtins.str] = None,
     name: typing.Optional[builtins.str] = None,
+    releases: typing.Optional[typing.Union[MavenRepositoryPolicy, typing.Dict[builtins.str, typing.Any]]] = None,
+    snapshots: typing.Optional[typing.Union[MavenRepositoryPolicy, typing.Dict[builtins.str, typing.Any]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__041e104cddeb68a13d0b79cfdce8653000ee58d2c7cef3088a2c8717d7f02ebf(
+    *,
+    checksum_policy: typing.Optional[ChecksumPolicy] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    update_policy: typing.Optional[UpdatePolicy] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -3675,6 +3960,7 @@ def _typecheckingstub__b8b1bc2eb1ab79c9e54c8b62fd341a87dd82eec6a2b2ec76a5fdb6f1c
     *,
     goals: typing.Sequence[builtins.str],
     id: builtins.str,
+    configuration: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
     phase: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -3765,6 +4051,12 @@ def _typecheckingstub__6ae2ae91be40e1fe4218504ad4a0a84a64d14b1c1274575f956490848
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__0bf8e37b8aa70ecfb764a100f3a50eabbce221f62cf2cc199c929b8132fe42cc(
+    minutes: jsii.Number,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__95d1347bcc9244ea45fe2d94ee57536743a6579b8c3cbeefd1a9832f2acb54b0(
     *,
     name: builtins.str,