runway.cfngin.lookups.handlers.xref module

Handler for fetching outputs from fully qualified stacks.

class runway.cfngin.lookups.handlers.xref.XrefLookup

Bases: runway.lookups.handlers.base.LookupHandler

Xref lookup.

DEPRECATION_MSG = 'xref Lookup has been deprecated; use the cfn lookup instead'

classmethod handle(value, context=None, provider=None, **kwargs)

Fetch an output from the designated, fully qualified stack.

The output handler supports fetching outputs from stacks created within a single config file. Sometimes it’s useful to fetch outputs from stacks created outside of the current config file. xref supports this by not using the runway.cfngin.context.Context to expand the fqn of the stack.

Parameters

• value (str) – Parameter(s) given to this lookup. <stack_name>::<output_name>

• context (runway.cfngin.context.Context) – Context instance.

• provider (runway.cfngin.providers.base.BaseProvider) – Provider instance.

Returns

Output from the specified stack.

Return type

str

Example

conf_value: ${xref fully-qualified-stack-name::SomeOutputName}