exceptions package

Module contents

GRASS interface to Python exceptions

exception exceptions.CalledModuleError(module, code, returncode, errors=None)[source]

Bases: CalledProcessError

Raised when a called module ends with error (non-zero return code)

Used for failures of modules called as subprocesses from Python code.

The class inherits from subprocess.CalledProcessError to allow for GRASS subprocess calls to be aligned with subprocess.check_call and subprocess.run with check=False.

Create an exception with a full error message based on the parameters.

Parameters:

  • module – module name

  • code – some code snipped which contains parameters

  • returncode – process returncode (assuming non-zero)

  • errors – errors provided by the module (e.g., stderr)

exception exceptions.DBError[source]

Bases: Exception

exception exceptions.FatalError[source]

Bases: Exception

exception exceptions.FlagError[source]

Bases: Exception

exception exceptions.GrassError[source]

Bases: Exception

exception exceptions.ImplementationError[source]

Bases: Exception

exception exceptions.OpenError[source]

Bases: Exception

exception exceptions.ParameterError[source]

Bases: Exception

exception exceptions.ScriptError(value)[source]

Bases: Exception

Raised during script execution.

>>> error = ScriptError("My error message!")
>>> error.value
'My error message!'
>>> print(error)
My error message!
exception exceptions.Usage[source]

Bases: Exception