pyinfra.api.exceptions module

exception pyinfra.api.exceptions.ArgumentTypeError

Bases: PyinfraError, TypeError

Raised when global arguments are passed with invalid types.

exception pyinfra.api.exceptions.ConnectError

Bases: PyinfraError

Exception raised when connecting fails.

exception pyinfra.api.exceptions.ConnectorDataTypeError

Bases: PyinfraError, TypeError

Raised when host connector data has invalid types.

exception pyinfra.api.exceptions.DeployError

Bases: PyinfraError

User exception for raising in deploys or sub deploys.

exception pyinfra.api.exceptions.FactError

Bases: PyinfraError

Exception raised during fact gathering staging if a fact is unable to generate output/change state.

exception pyinfra.api.exceptions.FactNotCollected

Bases: FactError

Base exception raised when a fact could not be collected (e.g. binary absent on the remote host, or the fact was skipped by a condition).

exception pyinfra.api.exceptions.FactPreconditionError(fact_cls: type, reason: str)

Bases: FactNotCollected

Exception raised when a fact’s check_preconditions() returns a reason string (e.g. a kernel module is not loaded). Like MissingCommandError, this is silenced during the prepare phase and re-raised during execute.

exception pyinfra.api.exceptions.FactProcessError

Bases: FactError, RuntimeError

Exception raised when the data gathered for a fact cannot be processed.

exception pyinfra.api.exceptions.FactTypeError

Bases: FactError, TypeError

Exception raised when a fact is passed invalid argument types.

exception pyinfra.api.exceptions.FactValueError

Bases: FactError, ValueError

Exception raised when a fact is passed invalid argument values.

exception pyinfra.api.exceptions.InventoryError

Bases: PyinfraError

Exception raised for inventory related errors.

exception pyinfra.api.exceptions.MissingCommandError(command: str)

Bases: FactNotCollected

Exception raised when requires_command specifies a binary that is not present on the remote host. The fact returns its default() value instead of raising, unless explicitly configured otherwise.

exception pyinfra.api.exceptions.NestedOperationError

Bases: OperationError

Exception raised when a nested (immediately executed) operation fails.

exception pyinfra.api.exceptions.NoConnectorError

Bases: PyinfraError, ValueError

Raised when a requested connector is missing.

exception pyinfra.api.exceptions.NoGroupError

Bases: PyinfraError, KeyError

Raised when an inventory is missing a group.

exception pyinfra.api.exceptions.NoHostError

Bases: PyinfraError, KeyError

Raised when an inventory is missing a host.

exception pyinfra.api.exceptions.OperationError

Bases: PyinfraError

Exception raised during fact gathering staging if an operation is unable to generate output/change state.

exception pyinfra.api.exceptions.OperationTypeError

Bases: OperationError, TypeError

Exception raised when an operation is passed invalid argument types.

exception pyinfra.api.exceptions.OperationValueError

Bases: OperationError, ValueError

Exception raised when an operation is passed invalid argument values.

exception pyinfra.api.exceptions.PyinfraError

Bases: Exception

Generic pyinfra exception.