AppProps

class aws_cdk.core.AppProps(*, analytics_reporting=None, auto_synth=None, context=None, outdir=None, runtime_info=None, stack_traces=None, tree_metadata=None)

Bases: object

Initialization props for apps.

Parameters
  • analytics_reporting (Optional[bool]) – Include runtime versioning information in the Stacks of this app. Default: Value of ‘aws:cdk:version-reporting’ context key

  • auto_synth (Optional[bool]) – Automatically call synth() before the program exits. If you set this, you don’t have to call synth() explicitly. Note that this feature is only available for certain programming languages, and calling synth() is still recommended. Default: true if running via CDK CLI (CDK_OUTDIR is set), false otherwise

  • context (Optional[Mapping[str, Any]]) – Additional context values for the application. Context set by the CLI or the context key in cdk.json has precedence. Context can be read from any construct using node.getContext(key). Default: - no additional context

  • outdir (Optional[str]) – The output directory into which to emit synthesized artifacts. Default: - If this value is not set, considers the environment variable CDK_OUTDIR. If CDK_OUTDIR is not defined, uses a temp directory.

  • runtime_info (Optional[bool]) – (deprecated) Include runtime versioning information in the Stacks of this app. Default: Value of ‘aws:cdk:version-reporting’ context key

  • stack_traces (Optional[bool]) – Include construct creation stack trace in the aws:cdk:trace metadata key of all constructs. Default: true stack traces are included unless aws:cdk:disable-stack-trace is set in the context.

  • tree_metadata (Optional[bool]) – Include construct tree metadata as part of the Cloud Assembly. Default: true

Attributes

analytics_reporting

Include runtime versioning information in the Stacks of this app.

Default

Value of ‘aws:cdk:version-reporting’ context key

Return type

Optional[bool]

auto_synth

Automatically call synth() before the program exits.

If you set this, you don’t have to call synth() explicitly. Note that this feature is only available for certain programming languages, and calling synth() is still recommended.

Default

true if running via CDK CLI (CDK_OUTDIR is set), false otherwise

Return type

Optional[bool]

context

Additional context values for the application.

Context set by the CLI or the context key in cdk.json has precedence.

Context can be read from any construct using node.getContext(key).

Default
  • no additional context

Return type

Optional[Mapping[str, Any]]

outdir

The output directory into which to emit synthesized artifacts.

Default

  • If this value is not set, considers the environment variable CDK_OUTDIR.

If CDK_OUTDIR is not defined, uses a temp directory.

Return type

Optional[str]

runtime_info

(deprecated) Include runtime versioning information in the Stacks of this app.

Default

Value of ‘aws:cdk:version-reporting’ context key

Deprecated

use versionReporting instead

Stability

deprecated

Return type

Optional[bool]

stack_traces

Include construct creation stack trace in the aws:cdk:trace metadata key of all constructs.

Default

true stack traces are included unless aws:cdk:disable-stack-trace is set in the context.

Return type

Optional[bool]

tree_metadata

Include construct tree metadata as part of the Cloud Assembly.

Default

true

Return type

Optional[bool]