cdktn 0.26.0.dev24__tar.gz → 0.26.0.dev26__tar.gz

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,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: cdktn
3
- Version: 0.26.0.dev24
3
+ Version: 0.26.0.dev26
4
4
  Summary: Cloud Development Kit for Terraform
5
5
  Home-page: https://github.com/open-constructs/cdk-terrain
6
6
  Author: OpenConstructs
@@ -5,7 +5,7 @@ kwargs = json.loads(
5
5
  """
6
6
  {
7
7
  "name": "cdktn",
8
- "version": "0.26.0.dev24",
8
+ "version": "0.26.0.dev26",
9
9
  "description": "Cloud Development Kit for Terraform",
10
10
  "license": "MPL-2.0",
11
11
  "url": "https://github.com/open-constructs/cdk-terrain",
@@ -27,7 +27,7 @@ kwargs = json.loads(
27
27
  ],
28
28
  "package_data": {
29
29
  "cdktn._jsii": [
30
- "cdktn@0.26.0-pre.24.jsii.tgz"
30
+ "cdktn@0.26.0-pre.26.jsii.tgz"
31
31
  ],
32
32
  "cdktn": [
33
33
  "py.typed"
@@ -1730,7 +1730,12 @@ class BundlerKey(metaclass=jsii.JSIIMeta, jsii_type="cdktn.BundlerKey"):
1730
1730
  self,
1731
1731
  entries: typing.Mapping[builtins.str, builtins.str],
1732
1732
  ) -> "BundlerKey":
1733
- '''(experimental) Append ``key=value`` parts for a record, sorted by key so the result does not depend on property order.
1733
+ '''(experimental) Append ``env=key=value`` parts for a record, sorted by key so the result does not depend on property order.
1734
+
1735
+ The ``env=`` prefix keeps these parts in their own namespace, so they
1736
+ cannot collide with an unrelated ``key=value`` part passed to {@link add}.
1737
+ The key and value are escaped so an ``=`` inside either cannot be mistaken
1738
+ for the key/value separator.
1734
1739
 
1735
1740
  :param entries: -
1736
1741
 
@@ -13674,9 +13679,9 @@ class TerraformAsset(
13674
13679
  :param path:
13675
13680
  :param asset_hash:
13676
13681
  :param asset_hash_type: (experimental) How the ``assetHash`` is derived. ``SOURCE`` (the default) hashes the source path. ``CUSTOM`` uses the ``assetHash`` value verbatim and requires it to be set. ``OUTPUT`` hashes the source too, unless a ``bundler`` is set — then it hashes the bundler's built output, which forces an eager build (see ``bundler``). If ``assetHash`` is set, this must be ``undefined`` or ``AssetHashType.CUSTOM``. Default: AssetHashType.SOURCE
13677
- :param bundler: (experimental) A bundler that builds the source into an artifact before staging. Core ships no bundler; implement ``IAssetBundler`` or use one from a bundler package. Under the default ``SOURCE`` hashing the build is deferred to synth and stays skippable; ``OUTPUT`` hashing builds eagerly to hash the artifact. The bundler's output shape must match ``type``. See ``AssetStagingOptions.bundler``. Default: - the source is staged verbatim, with no build step
13682
+ :param bundler: (experimental) A bundler that builds the source into an artifact before staging. Core ships no bundler; implement ``IAssetBundler`` or use one from a bundler package. Under the default ``SOURCE`` hashing the build is deferred to synth and stays skippable; ``OUTPUT`` hashing builds eagerly to hash the artifact. The bundler's output shape must match ``type``. See ``AssetStagingOptions.bundler``. Under ``SOURCE`` hashing or a fixed ``assetHash``, a synth keeps the artifact already staged for the same hash and ``type``. See ``extraHash`` for inputs the hash cannot see; deleting the output directory also forces a rebuild. Default: - the source is staged verbatim, with no build step
13678
13683
  :param exclude: (experimental) Paths to exclude from the asset, relative to ``path``. See ``AssetStagingOptions.exclude`` for the accepted forms. Both the computed hash and the staged/packed content honor the exclusion. Cannot be combined with ``ignoreStrategy``, which replaces this matcher rather than layering on top of it. Default: - nothing is excluded
13679
- :param extra_hash: (experimental) Extra information to fold into the hash (e.g. build instructions and other inputs). Default: - no extra hash
13684
+ :param extra_hash: (experimental) Extra information to fold into the hash (e.g. build instructions and other inputs). A bundled asset reuses the artifact an earlier synth staged for the same hash, so set this for build inputs the hash cannot see: files outside ``path``, a mutable Docker tag such as ``node:20``, or which bundler is used and its options when it has no ``bundlerKey``. It is ignored when ``assetHash`` is set; change ``assetHash`` instead. Default: - no extra hash
13680
13685
  :param ignore_strategy: (experimental) Exclusion matching, for callers that need ``.gitignore`` / ``.dockerignore`` parity (including ``!``-negation) rather than the built-in exact-path / suffix / directory matcher. See ``AssetStagingOptions.ignoreStrategy``. ``!``-negation only takes effect if the strategy also sets ``pruneExcludedDirectories: false``; otherwise an excluded directory is pruned before its contents are ever checked against a re-include pattern. See ``IIgnoreStrategy.pruneExcludedDirectories``. Default: - ``exclude`` is used with the built-in matcher
13681
13686
  :param type:
13682
13687
 
@@ -13776,9 +13781,9 @@ class TerraformAssetConfig:
13776
13781
  :param path:
13777
13782
  :param asset_hash:
13778
13783
  :param asset_hash_type: (experimental) How the ``assetHash`` is derived. ``SOURCE`` (the default) hashes the source path. ``CUSTOM`` uses the ``assetHash`` value verbatim and requires it to be set. ``OUTPUT`` hashes the source too, unless a ``bundler`` is set — then it hashes the bundler's built output, which forces an eager build (see ``bundler``). If ``assetHash`` is set, this must be ``undefined`` or ``AssetHashType.CUSTOM``. Default: AssetHashType.SOURCE
13779
- :param bundler: (experimental) A bundler that builds the source into an artifact before staging. Core ships no bundler; implement ``IAssetBundler`` or use one from a bundler package. Under the default ``SOURCE`` hashing the build is deferred to synth and stays skippable; ``OUTPUT`` hashing builds eagerly to hash the artifact. The bundler's output shape must match ``type``. See ``AssetStagingOptions.bundler``. Default: - the source is staged verbatim, with no build step
13784
+ :param bundler: (experimental) A bundler that builds the source into an artifact before staging. Core ships no bundler; implement ``IAssetBundler`` or use one from a bundler package. Under the default ``SOURCE`` hashing the build is deferred to synth and stays skippable; ``OUTPUT`` hashing builds eagerly to hash the artifact. The bundler's output shape must match ``type``. See ``AssetStagingOptions.bundler``. Under ``SOURCE`` hashing or a fixed ``assetHash``, a synth keeps the artifact already staged for the same hash and ``type``. See ``extraHash`` for inputs the hash cannot see; deleting the output directory also forces a rebuild. Default: - the source is staged verbatim, with no build step
13780
13785
  :param exclude: (experimental) Paths to exclude from the asset, relative to ``path``. See ``AssetStagingOptions.exclude`` for the accepted forms. Both the computed hash and the staged/packed content honor the exclusion. Cannot be combined with ``ignoreStrategy``, which replaces this matcher rather than layering on top of it. Default: - nothing is excluded
13781
- :param extra_hash: (experimental) Extra information to fold into the hash (e.g. build instructions and other inputs). Default: - no extra hash
13786
+ :param extra_hash: (experimental) Extra information to fold into the hash (e.g. build instructions and other inputs). A bundled asset reuses the artifact an earlier synth staged for the same hash, so set this for build inputs the hash cannot see: files outside ``path``, a mutable Docker tag such as ``node:20``, or which bundler is used and its options when it has no ``bundlerKey``. It is ignored when ``assetHash`` is set; change ``assetHash`` instead. Default: - no extra hash
13782
13787
  :param ignore_strategy: (experimental) Exclusion matching, for callers that need ``.gitignore`` / ``.dockerignore`` parity (including ``!``-negation) rather than the built-in exact-path / suffix / directory matcher. See ``AssetStagingOptions.ignoreStrategy``. ``!``-negation only takes effect if the strategy also sets ``pruneExcludedDirectories: false``; otherwise an excluded directory is pruned before its contents are ever checked against a re-include pattern. See ``IIgnoreStrategy.pruneExcludedDirectories``. Default: - ``exclude`` is used with the built-in matcher
13783
13788
  :param type:
13784
13789
 
@@ -13857,6 +13862,10 @@ class TerraformAssetConfig:
13857
13862
  The bundler's output shape must match ``type``. See
13858
13863
  ``AssetStagingOptions.bundler``.
13859
13864
 
13865
+ Under ``SOURCE`` hashing or a fixed ``assetHash``, a synth keeps the artifact
13866
+ already staged for the same hash and ``type``. See ``extraHash`` for inputs
13867
+ the hash cannot see; deleting the output directory also forces a rebuild.
13868
+
13860
13869
  :default: - the source is staged verbatim, with no build step
13861
13870
 
13862
13871
  :stability: experimental
@@ -13885,6 +13894,12 @@ class TerraformAssetConfig:
13885
13894
  def extra_hash(self) -> typing.Optional[builtins.str]:
13886
13895
  '''(experimental) Extra information to fold into the hash (e.g. build instructions and other inputs).
13887
13896
 
13897
+ A bundled asset reuses the artifact an earlier synth staged for the same
13898
+ hash, so set this for build inputs the hash cannot see: files outside
13899
+ ``path``, a mutable Docker tag such as ``node:20``, or which bundler is used
13900
+ and its options when it has no ``bundlerKey``. It is ignored when
13901
+ ``assetHash`` is set; change ``assetHash`` instead.
13902
+
13888
13903
  :default: - no extra hash
13889
13904
 
13890
13905
  :stability: experimental
@@ -21,7 +21,7 @@ _SUBMODULE_FQN_MAP = {
21
21
  }
22
22
 
23
23
  __jsii_assembly__ = jsii.JSIIAssembly.load(
24
- "cdktn", "0.26.0-pre.24", __name__[0:-6], "cdktn@0.26.0-pre.24.jsii.tgz"
24
+ "cdktn", "0.26.0-pre.26", __name__[0:-6], "cdktn@0.26.0-pre.26.jsii.tgz"
25
25
  )
26
26
 
27
27
  __all__ = [
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: cdktn
3
- Version: 0.26.0.dev24
3
+ Version: 0.26.0.dev26
4
4
  Summary: Cloud Development Kit for Terraform
5
5
  Home-page: https://github.com/open-constructs/cdk-terrain
6
6
  Author: OpenConstructs
@@ -11,5 +11,5 @@ src/cdktn.egg-info/dependency_links.txt
11
11
  src/cdktn.egg-info/requires.txt
12
12
  src/cdktn.egg-info/top_level.txt
13
13
  src/cdktn/_jsii/__init__.py
14
- src/cdktn/_jsii/cdktn@0.26.0-pre.24.jsii.tgz
14
+ src/cdktn/_jsii/cdktn@0.26.0-pre.26.jsii.tgz
15
15
  src/cdktn/testing_matchers/__init__.py
File without changes
File without changes
File without changes
File without changes