runway.cfngin.lookups.handlers.xref module

Handler for fetching outputs from fully qualified stacks.

class runway.cfngin.lookups.handlers.xref.XrefLookup[source]

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)[source]

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.


Output from the specified stack.

Return type



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