runway.cfngin.exceptions module

CFNgin exceptions.

exception runway.cfngin.exceptions.CancelExecution

Bases: CfnginError

Raised when we want to cancel executing the plan.

message: str = 'Plan canceled'

Error message.

exception runway.cfngin.exceptions.CfnginBucketAccessDenied

Bases: CfnginError

Access denied to CFNgin bucket.

This can occur when the bucket exists in another AWS account and/or the credentials being used do not have adequate permissions to access the bucket.

__init__(bucket_name: str) → None

Instantiate class.

Parameters:

bucket_name – Name of the CFNgin bucket.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.CfnginBucketNotFound

Bases: CfnginError

CFNgin bucket specified or default bucket being used but it does not exist.

This can occur when using a custom stack to deploy the CFNgin bucket but the custom stack does not create bucket that is expected.

__init__(bucket_name: str) → None

Instantiate class.

Parameters:

bucket_name – Name of the CFNgin bucket.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.CfnginBucketRequired

Bases: CfnginError

CFNgin bucket is required to use a feature but it not provided/disabled.

__init__(config_path: AnyPath | None = None, reason: str | None = None) → None

Instantiate class.

Parameters:

• config_path – Path to the CFNgin config file.

• reason – Reason why CFNgin bucket is needed.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.CfnginError

Bases: RunwayError

Base class for custom exceptions raised by Runway.

message: str

Error message.

exception runway.cfngin.exceptions.CfnginOnlyLookupError

Bases: CfnginError

Attempted to use a CFNgin lookup outside of CFNgin.

__init__(lookup_name: str) → None

Instantiate class.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

exception runway.cfngin.exceptions.ChangesetDidNotStabilize

Bases: CfnginError

Raised when the applying a changeset fails.

__init__(change_set_id: str) → None

Instantiate class.

Parameters:

change_set_id – The changeset that failed.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.GraphError

Bases: CfnginError

Raised when the graph is invalid (e.g. acyclic dependencies).

__init__(exception: Exception, stack: str, dependency: str) → None

Instantiate class.

Parameters:

• exception – The exception that was raised by the invalid graph.

• stack – Name of the stack causing the error.

• dependency – Name of the dependency causing the error.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.ImproperlyConfigured

Bases: CfnginError

Raised when a component is improperly configured.

__init__(kls: Any, error: Exception, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• kls – The class that was improperly configured.

• error – The exception that was raised when trying to use cls.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.InvalidConfig

Bases: CfnginError

Provided config file is invalid.

__init__(errors: str | list[Exception | str]) → None

Instantiate class.

Parameters:

errors – Errors or error messages that are raised to identify that a config is invalid.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.InvalidDockerizePipConfiguration

Bases: CfnginError

Raised when the provided configuration for dockerized pip is invalid.

__init__(msg: str) → None

Instantiate class.

Parameters:

msg – The reason for the error being raised.

message: str

Error message.

exception runway.cfngin.exceptions.InvalidUserdataPlaceholder

Bases: CfnginError

Raised when a placeholder name in raw_user_data is not valid.

E.g ${100} would raise this.

__init__(blueprint_name: str, exception_message: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• blueprint_name – Name of the blueprint with invalid userdata placeholder.

• exception_message – Message from the exception that was raised while parsing the userdata.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.MissingEnvironment

Bases: CfnginError

Raised when an environment lookup is used but the key doesn’t exist.

__init__(key: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• key – The key that was used but doesn’t exist in the environment.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.MissingParameterException

Bases: CfnginError

Raised if a required parameter with no default is missing.

__init__(parameters: list[str], *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• parameters – A list of the parameters that are missing.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.MissingVariable

Bases: CfnginError

Raised when a variable with no default is not provided a value.

__init__(blueprint_name: str, variable_name: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• blueprint_name – Name of the blueprint.

• variable_name – Name of the variable missing a value.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.PersistentGraphCannotLock

Bases: CfnginError

Raised when the persistent graph in S3 cannot be locked.

__init__(reason: str) → None

Instantiate class.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.PersistentGraphCannotUnlock

Bases: CfnginError

Raised when the persistent graph in S3 cannot be unlocked.

__init__(reason: Exception | str) → None

Instantiate class.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.PersistentGraphLockCodeMismatch

Bases: CfnginError

Raised when the provided persistent graph lock code does not match.

The code used to unlock the persistent graph must match the s3 object lock code.

__init__(provided_code: str, s3_code: str | None) → None

Instantiate class.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.PersistentGraphLocked

Bases: CfnginError

Raised when the persistent graph in S3 is lock.

The action being executed requires it to be unlocked before attempted.

__init__(message: str | None = None, reason: str | None = None) → None

Instantiate class.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.PersistentGraphUnlocked

Bases: CfnginError

Raised when the persistent graph in S3 is unlock.

The action being executed requires it to be locked before attempted.

__init__(message: str | None = None, reason: str | None = None) → None

Instantiate class.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.PipError

Bases: CfnginError

Raised when pip returns a non-zero exit code.

__init__() → None

Instantiate class.

message: str

Error message.

exception runway.cfngin.exceptions.PipenvError

Bases: CfnginError

Raised when pipenv returns a non-zero exit code.

__init__() → None

Instantiate class.

message: str

Error message.

exception runway.cfngin.exceptions.PlanFailed

Bases: CfnginError

Raised if any step of a plan fails.

__init__(failed_steps: list[Step], *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• failed_steps – The steps that failed.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.StackDidNotChange

Bases: CfnginError

Raised when there are no changes to be made by the provider.

message: str = 'Stack did not change'

Error message.

exception runway.cfngin.exceptions.StackDoesNotExist

Bases: CfnginError

Raised when a stack does not exist in AWS.

__init__(stack_name: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• stack_name – Name of the stack that does not exist.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.StackFailed

Bases: CfnginError

Raised when a stack action fails.

Primarily used with hooks that act on stacks.

__init__(stack_name: str, status_reason: str | None = None) → None

Instantiate class.

Parameters:

• stack_name – Name of the stack.

• status_reason – The reason for the current status.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.StackUpdateBadStatus

Bases: CfnginError

Raised if the state of a stack can’t be handled.

__init__(stack_name: str, stack_status: str, reason: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• stack_name – Name of the stack.

• stack_status – The stack’s status.

• reason – The reason for the current status.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.UnableToExecuteChangeSet

Bases: CfnginError

Raised if changeset execution status is not AVAILABLE.

__init__(stack_name: str, change_set_id: str, execution_status: str) → None

Instantiate class.

Parameters:

• stack_name – Name of the stack.

• change_set_id – The changeset that failed.

• execution_status – The value of the changeset’s ExecutionStatus attribute.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.UnhandledChangeSetStatus

Bases: CfnginError

Raised when creating a changeset failed for an unhandled reason.

Handled failure reasons include: no changes

__init__(stack_name: str, change_set_id: str, status: str, status_reason: str) → None

Instantiate class.

Parameters:

• stack_name – Name of the stack.

• change_set_id – The changeset that failed.

• status – The state that could not be handled.

• status_reason – Cause of the current state.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.UnresolvedBlueprintVariable

Bases: CfnginError

Raised when trying to use a variable before it has been resolved.

__init__(blueprint_name: str, variable: Variable, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• blueprint_name – Name of the blueprint that tried to use the unresolved variables.

• variable – The unresolved variable.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str = 'Variable has not been resolved'

Error message.

exception runway.cfngin.exceptions.UnresolvedBlueprintVariables

Bases: CfnginError

Raised when trying to use variables before they has been resolved.

__init__(blueprint_name: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• blueprint_name – Name of the blueprint that tried to use the unresolved variables.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.

exception runway.cfngin.exceptions.ValidatorError

Bases: CfnginError

Used for errors raised by custom validators of blueprint variables.

__init__(variable: str, validator: str, value: str, exception: Exception) → None

Instantiate class.

Parameters:

• variable – The variable that failed validation.

• validator – The validator that was not passed.

• value – The value of the variable that did not pass the validator.

• exception – The exception raised by the validator.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

__str__() → str

Return the exception’s message when converting to a string.

message: str

Error message.

exception runway.cfngin.exceptions.VariableTypeRequired

Bases: CfnginError

Raised when a variable defined in a blueprint is missing a type.

__init__(blueprint_name: str, variable_name: str, *args: Any, **kwargs: Any) → None

Instantiate class.

Parameters:

• blueprint_name – Name of the blueprint.

• variable_name – Name of the variable missing a type.

• *args – Variable length argument list.

• **kwargs – Arbitrary keyword arguments.

__reduce__() → tuple[type[Exception], tuple[Any, ...]]

Support for pickling.

message: str

Error message.