A low level HDF5 operation failed. This exception is raised the low level PyTables components used for accessing HDF5 files. It usually signals that something is not going well in the HDF5 library or even at the Input/Output level. Errors in the HDF5 C library may be accompanied b
| 37 | |
| 38 | |
| 39 | class HDF5ExtError(RuntimeError): |
| 40 | """A low level HDF5 operation failed. |
| 41 | |
| 42 | This exception is raised the low level PyTables components used for |
| 43 | accessing HDF5 files. It usually signals that something is not |
| 44 | going well in the HDF5 library or even at the Input/Output level. |
| 45 | |
| 46 | Errors in the HDF5 C library may be accompanied by an extensive |
| 47 | HDF5 back trace on standard error (see also |
| 48 | :func:`tables.silence_hdf5_messages`). |
| 49 | |
| 50 | .. versionchanged:: 2.4 |
| 51 | |
| 52 | Parameters |
| 53 | ---------- |
| 54 | message |
| 55 | error message |
| 56 | h5bt |
| 57 | This parameter (keyword only) controls the HDF5 back trace |
| 58 | handling. Any keyword arguments other than h5bt is ignored. |
| 59 | |
| 60 | * if set to False the HDF5 back trace is ignored and the |
| 61 | :attr:`HDF5ExtError.h5backtrace` attribute is set to None |
| 62 | * if set to True the back trace is retrieved from the HDF5 |
| 63 | library and stored in the :attr:`HDF5ExtError.h5backtrace` |
| 64 | attribute as a list of tuples |
| 65 | * if set to "VERBOSE" (default) the HDF5 back trace is |
| 66 | stored in the :attr:`HDF5ExtError.h5backtrace` attribute |
| 67 | and also included in the string representation of the |
| 68 | exception |
| 69 | * if not set (or set to None) the default policy is used |
| 70 | (see :attr:`HDF5ExtError.DEFAULT_H5_BACKTRACE_POLICY`) |
| 71 | |
| 72 | """ |
| 73 | |
| 74 | # NOTE: in order to avoid circular dependencies between modules the |
| 75 | # _dump_h5_backtrace method is set at initialization time in |
| 76 | # the utilsextension.pyx. |
| 77 | _dump_h5_backtrace: ( |
| 78 | Callable[[], list[tuple[str, int, str, str]]] | None |
| 79 | ) = None |
| 80 | |
| 81 | DEFAULT_H5_BACKTRACE_POLICY = "VERBOSE" |
| 82 | """Default policy for HDF5 backtrace handling |
| 83 | |
| 84 | * if set to False the HDF5 back trace is ignored and the |
| 85 | :attr:`HDF5ExtError.h5backtrace` attribute is set to None |
| 86 | * if set to True the back trace is retrieved from the HDF5 |
| 87 | library and stored in the :attr:`HDF5ExtError.h5backtrace` |
| 88 | attribute as a list of tuples |
| 89 | * if set to "VERBOSE" (default) the HDF5 back trace is |
| 90 | stored in the :attr:`HDF5ExtError.h5backtrace` attribute |
| 91 | and also included in the string representation of the |
| 92 | exception |
| 93 | |
| 94 | This parameter can be set using the |
| 95 | :envvar:`PT_DEFAULT_H5_BACKTRACE_POLICY` environment variable. |
| 96 | Allowed values are "IGNORE" (or "FALSE"), "SAVE" (or "TRUE") and |