Merge branch 'develop' into main

1 files changed, 41 insertions, 0 deletions

diff --git a/bsfs/utils/errors.py b/bsfs/utils/errors.py
new file mode 100644
index 0000000..c5e8e16
--- /dev/null
+++ b/bsfs/utils/errors.py
@@ -0,0 +1,41 @@
+"""
+
+Part of the BlackStar filesystem (bsfs) module.
+A copy of the license is provided with the project.
+Author: Matthias Baumgartner, 2022
+"""
+# imports
+import typing
+
+# exports
+__all__: typing.Sequence[str] = (
+    )
+
+
+## code ##
+
+class _BSFSError(Exception):
+    """Generic bsfs error."""
+
+class SchemaError(_BSFSError):
+    """Generic schema errios."""
+
+class ConsistencyError(SchemaError):
+    """A requested operation is inconsistent with the schema."""
+
+class InstanceError(SchemaError):
+    """An instance affected by some operation is inconsistent with the schema."""
+
+class PermissionDeniedError(_BSFSError):
+    """An operation was aborted due to access control restrictions."""
+
+class ProgrammingError(_BSFSError):
+    """An assertion-like error that indicates a code-base issue."""
+
+class UnreachableError(ProgrammingError):
+    """Bravo, you've reached a point in code that should logically not be reachable."""
+
+class ConfigError(_BSFSError):
+    """User config issue."""
+
+## EOF ##