sceptre.resolvers package

exception sceptre.resolvers.RecursiveResolve

Bases: Exception

class sceptre.resolvers.ResolvableContainerProperty(name, placeholder_type=PlaceholderType.explicit)

Bases: ResolvableProperty

This is a descriptor class used to store an attribute that may CONTAIN Resolver objects. Resolvers will be resolved upon access of this property. When resolvers are resolved, they will be replaced in the container with their resolved value, in order to avoid redundant resolutions.

Supports nested dictionary and lists.

Parameters

name (str) – Attribute suffix used to store the property in the instance.

class ResolveLater(instance, name, key, resolution_function)

Bases: object

Represents a value that could not yet be resolved but can be resolved in the future.

assign_value_to_stack(stack, value)

Assigns a COPY of the specified value to the stack instance. This method copies the value rather than directly assigns it to avoid bugs related to shared objects in memory.

Parameters

• stack (Stack) – The stack to assign the value to

• value (Union[dict, list]) – The value to assign

get_resolved_value(stack, stack_class)

Obtains the resolved value for this property. Any resolvers that resolve to None will have their key/index removed from their dict/list where they are. Other resolvers will have their key/index’s value replace with the resolved value to avoid redundant resolutions.

Parameters

• stack (Stack) – The Stack instance to obtain the value for

• stack_class (Type[Stack]) – The class of the Stack instance.

Return type

TypeVar(T_Container, bound= Union[dict, list])

Returns

The fully resolved container.

class sceptre.resolvers.ResolvableProperty(name, placeholder_type=PlaceholderType.explicit)

Bases: ABC

This is an abstract base class for a descriptor used to store an attribute that have values associated with Resolver objects.

Parameters

• name (str) – Attribute suffix used to store the property in the instance.

• placeholder_type – The type of placeholder that should be returned, when placeholders are allowed, when a resolver can’t be resolved.

abstract assign_value_to_stack(stack, value)

Implement this method to assign the value to the resolvable property.

abstract get_resolved_value(stack, stack_class)

Implement this method to return the value of the resolvable_property.

Return type

Any

get_setup_resolver_for_stack(stack, resolver)

Obtains a clone of the resolver with the stack set on it and the setup method having been called on it.

Parameters

• stack (Stack) – The stack to set on the Resolver

• resolver (Resolver) – The Resolver to clone and set up

Return type

Resolver

Returns

The cloned resolver.

resolve_resolver_value(resolver)

Returns the resolved parameter value.

If the resolver happens to raise an error and placeholders are currently allowed for resolvers, a placeholder will be returned instead of reraising the error.

Parameters

resolver (Resolver) – The resolver to resolve.

Return type

Any

Returns

The resolved value (or placeholder, in certain circumstances)

class sceptre.resolvers.ResolvableValueProperty(name, placeholder_type=PlaceholderType.explicit)

Bases: ResolvableProperty

This is a descriptor class used to store an attribute that may BE a single Resolver object. If it is a resolver, it will be resolved upon access of this property. When resolved, the resolved value will replace the resolver on the stack in order to avoid redundant resolutions.

Parameters

name (str) – Attribute suffix used to store the property in the instance.

assign_value_to_stack(stack, value)

Assigns the value to the Stack instance passed, setting up and cloning the value if it is a Resolver.

Parameters

• stack (Stack) – The Stack instance to set the value on

• value (Any) – The value to set

get_resolved_value(stack, stack_class)

Gets the fully-resolved value from the property. Resolvers will be replaced on the stack instance with their resolved value to avoid redundant resolutions.

Parameters

• stack (Stack) – The Stack instance to obtain the value from

• stack_class (Type[Stack]) – The class of the Stack instance

Return type

Any

Returns

The fully resolved value

class sceptre.resolvers.Resolver(argument=None, stack=None)

Bases: ABC

Resolver is an abstract base class that should be inherited by all Resolvers.

Parameters

• argument (Optional[Any]) – The argument of the resolver.

• stack (Optional[Stack]) – The associated stack of the resolver.

clone(stack)

Produces a “fresh” copy of the Resolver, with the specified stack.

Parameters

stack (Stack) – The stack to set on the cloned resolver

Return type

Resolver

abstract resolve()

An abstract method which must be overwritten by all inheriting classes. This method is called to retrieve the final desired value. Implementation of this method in subclasses must return a suitable object or primitive type.

setup()

This method is called at during stack initialisation. Implementation of this method in subclasses can be used to do any initial setup of the object.

Submodules

sceptre.resolvers.environment_variable module

class sceptre.resolvers.environment_variable.EnvironmentVariable(*args, **kwargs)

Bases: Resolver

Resolver for shell environment variables.

Parameters

argument (str) – Name of the environment variable to return.

resolve()

Retrieves the value of a named environment variable.

Returns

Value of the environment variable.

Return type

str

sceptre.resolvers.file_contents module

class sceptre.resolvers.file_contents.FileContents(*args, **kwargs)

Bases: Resolver

Resolver for the contents of a file.

Parameters

argument (str) – Absolute path to file.

resolve()

Retrieves the contents of a file at a given absolute file path.

Returns

Contents of file.

Return type

str

sceptre.resolvers.no_value module

class sceptre.resolvers.no_value.NoValue(argument=None, stack=None)

Bases: Resolver

This resolver resolves to nothing, functioning just like the AWS::NoValue special value. When assigned to a resolvable Stack property, it will remove the config key/value from the stack or the container on the stack where it has been assigned, as if this value wasn’t assigned at all.

This is mostly useful for simplifying conditional logic on Stack and StackGroup config files where, if a certain condition is met, a value is passed, otherwise it’s not passed at all.

resolve()

An abstract method which must be overwritten by all inheriting classes. This method is called to retrieve the final desired value. Implementation of this method in subclasses must return a suitable object or primitive type.

Return type

None

sceptre.resolvers.placeholders module

class sceptre.resolvers.placeholders.PlaceholderType(value)

Bases: Enum

An enumeration.

alphanum = 2

explicit = 1

none = 3

sceptre.resolvers.placeholders.are_placeholders_enabled()

Indicates whether placeholders have been globally enabled or not.

Return type

bool

sceptre.resolvers.placeholders.create_placeholder_value(resolver, placeholder_type)

Return type

Any

sceptre.resolvers.placeholders.use_resolver_placeholders_on_error()

A context manager that toggles on placeholders for resolvers that error out. This should NOT be used while creating/launching stacks, but it is often required when validating or diffing stacks whose dependencies haven’t yet been deployed and that reference those dependencies with resolvers, especially in the sceptre_user_data.

sceptre.resolvers.stack_attr module

class sceptre.resolvers.stack_attr.StackAttr(argument=None, stack=None)

Bases: Resolver

Resolves to the value of another field on the Stack Config, including other resolvers.

The argument for this resolver should be the “key path” from the stack object, which can access nested keys/indexes using a “.” to separate segments.

For example, given this Stack Config structure…

sceptre_user_data:

nested_list:

• first

• second

Using “!stack_attr sceptre_user_data.nested_list.1” on your stack would resolve to “second”.

STACK_ATTR_MAP = {'protect': 'protected', 'stack_name': 'external_name', 'stack_tags': 'tags', 'template': 'template_handler_config'}

resolve()

Returns the resolved value of the field referenced by the resolver’s argument.

Return type

Any

sceptre.resolvers.stack_output module

class sceptre.resolvers.stack_output.StackOutput(*args, **kwargs)

Bases: StackOutputBase

Resolver for retrieving the value of a Stack output within the current Sceptre StackGroup. Adds the target Stack to the dependencies of the Stack using the Resolver.

Parameters

argument (str in the format "<stack name>::<output key>") – The Stack name and output name to get.

resolve()

Retrieves the value of an output of an internal Stack.

Returns

The value of the Stack output.

Return type

str

setup()

Adds dependency to a Stack.

class sceptre.resolvers.stack_output.StackOutputBase(*args, **kwargs)

Bases: Resolver

A abstract base class which provides methods for getting Stack outputs.

class sceptre.resolvers.stack_output.StackOutputExternal(*args, **kwargs)

Bases: StackOutputBase

Resolver for retrieving the value of an output of any Stack within the current Sceptre stack_group’s account and region.

Parameters

argument (str in the format "<full stack name>::<output key>") – The Stack name and output name to get.

resolve()

Retrieves the value of CloudFormation output of the external Stack

Returns

The value of the Stack output.

Return type

str