almanac.errors

exception AlmanacError[source]

Bases: Exception

Base exception type for almanac library errors.

exception ArgumentNameCollisionError(*names: str)[source]

Bases: almanac.errors.argument_errors.BaseArgumentError

An exception type for when argument names would collide.

property names

A tuple of the argument names that spawned this error.

exception BaseArgumentError[source]

Bases: almanac.errors.almanac_error.AlmanacError

The base exception type for invalid arguments.

exception InvalidArgumentNameError[source]

Bases: almanac.errors.argument_errors.BaseArgumentError

An exception type for attempting to register invalid argument names.

exception MissingArgumentsError(*missing_args: str)[source]

Bases: almanac.errors.argument_errors.BaseArgumentError

An exception type for missing arguments.

property missing_args

The arguments that were missing.

exception NoSuchArgumentError(*names: str)[source]

Bases: almanac.errors.argument_errors.BaseArgumentError, almanac.errors.generic_errors.AlmanacKeyError

An exception type for resolutions of non-existent arguments.

property names

A tuple of the argument names that triggered this error.

exception TooManyPositionalArgumentsError(*values: Any)[source]

Bases: almanac.errors.argument_errors.BaseArgumentError

An exception type for when too many positional arguments are specified.

property values

A tuple of the excess positional argument values.

exception UnknownArgumentBindingError(signature: inspect.Signature, pos_args: Iterable[Any], kw_args: Dict[str, Any])[source]

Bases: almanac.errors.argument_errors.BaseArgumentError

An exception type for unknown issues in argument-binding.

property kw_args

The kw_args that could not be bound to the signature.

property pos_args

The pos_args that could not be bound to the signature.

property signature

The signature that could not be bound to.

exception BaseCommandError[source]

Bases: almanac.errors.almanac_error.AlmanacError

The base exception type for command-related errors.

exception CommandNameCollisionError(*names: str)[source]

Bases: almanac.errors.command_errors.BaseCommandError

An exception type for when command names would collide.

property names

A tuple of the command names that spawned this error.

exception CommandRegistrationError[source]

Bases: almanac.errors.command_errors.BaseCommandError

An exception type for invalid command registration.

exception NoSuchCommandError(*names: str)[source]

Bases: almanac.errors.command_errors.BaseCommandError, almanac.errors.configuration_errors.BaseConfigurationError, almanac.errors.generic_errors.AlmanacKeyError

An exception type for resolutions of non-existent commands.

property names

A tuple of the command names that spawned this error.

exception BaseConfigurationError[source]

Bases: almanac.errors.almanac_error.AlmanacError

The base exception type for configuration errors.

exception ConflictingExceptionCallbacksError[source]

Bases: almanac.errors.configuration_errors.BaseConfigurationError

Exception type for trying to implicitly overwrite an exception hook callback.

exception ConflictingPromoterTypesError[source]

Bases: almanac.errors.configuration_errors.BaseConfigurationError

An exception type for attempting to map multiple promoters to one type.

exception InvalidCallbackTypeError[source]

Bases: almanac.errors.configuration_errors.BaseConfigurationError

An error type for invalid callback types.

exception MissingRequiredParameterError[source]

Bases: almanac.errors.configuration_errors.BaseConfigurationError

An exception type for missing configuration parameters.

exception AlmanacKeyError[source]

Bases: almanac.errors.almanac_error.AlmanacError, KeyError

A subclass of KeyError that does not surround exception messages with quotes.

exception FrozenAccessError[source]

Bases: almanac.errors.almanac_error.AlmanacError

An exception type for invalid accesses on frozen objects.

exception PositionalValueError(msg: str, error_pos: int)[source]

Bases: ValueError, almanac.errors.almanac_error.AlmanacError

An exception that holds a specific, error-causing input position.

property error_pos

The zero-based index of an error-causing position.

exception BasePageError[source]

Bases: almanac.errors.almanac_error.AlmanacError

Base error for all page-based errors.

exception BlockedPageOverwriteError(path: PagePathLike)[source]

Bases: almanac.errors.page_errors.BasePageError

An exception type for attempted (but blocked) page entry overwrites.

property path

The path that generated this error.

exception NoSuchPageError(path: PagePathLike)[source]

Bases: almanac.errors.page_errors.BasePageError, almanac.errors.generic_errors.AlmanacKeyError

An exception type for attempting to access a non-existent page.

property path

The path that generated this error.

exception OutOfBoundsPageError(path: PagePathLike)[source]

Bases: almanac.errors.page_errors.BasePageError

An exception type for attempting to reference pages beyond the root directory.

property path

The path that generated this error.

exception PathSyntaxError(msg: str, error_pos: int)[source]

Bases: almanac.errors.page_errors.BasePageError, almanac.errors.generic_errors.PositionalValueError

An exception type for path syntax errors.

exception BaseParseError[source]

Bases: almanac.errors.almanac_error.AlmanacError

The base class exception type for parser-related errors.

exception PartialParseError(msg: str, remaining: str, partial_result: pyparsing.ParseResults, col: int)[source]

Bases: almanac.errors.parsing_errors.BaseParseError, almanac.errors.generic_errors.PositionalValueError

An exception type for when command parsing partially fails.

exception TotalParseError[source]

Bases: almanac.errors.parsing_errors.BaseParseError

Exception type for when command parsing totally fails.

exception NoActiveApplicationError[source]

Bases: almanac.errors.almanac_error.AlmanacError

An exception type for when context methods are called without an active app.