refactor: Reorganize exceptions

src/griffe/dataclasses.py

@@ -16,7 +16,7 @@
 from griffe.collections import lines_collection
 from griffe.docstrings.dataclasses import DocstringSection
 from griffe.docstrings.parsers import Parser, parse  # noqa: WPS347
-from griffe.exceptions import ResolutionError
+from griffe.exceptions import NameResolutionError
 from griffe.expressions import Expression, Name
 
 
@@ -477,7 +477,7 @@ def resolve(self, name: str) -> str:
             name: The name to resolve.
 
         Raises:
-            ResolutionError: When the name could not be resolved.
+            NameResolutionError: When the name could not be resolved.
 
         Returns:
             The resolved name.
@@ -488,7 +488,7 @@ def resolve(self, name: str) -> str:
             return self.imports[name]
         if self.parent is None:
             # could be a built-in
-            raise ResolutionError(f"{name} could not be resolved in the scope of {self.path}")
+            raise NameResolutionError(f"{name} could not be resolved in the scope of {self.path}")
         if name == self.parent.name:
             return self.parent.path
         return self.parent.resolve(name)

src/griffe/exceptions.py

@@ -1,9 +1,21 @@
 """This module contains all the exceptions specific to Griffe."""
 
 
-class ResolutionError(Exception):
+class GriffeError(Exception):
+    """The base exception for all Griffe errors."""
+
+
+class NameResolutionError(GriffeError):
     """Exception for names that cannot be resolved in a object scope."""
 
 
-class UnhandledPthFileError(Exception):
+class UnhandledPthFileError(GriffeError):
     """Exception for unhandled .path files, when searching modules."""
+
+
+class LastNodeError(GriffeError):
+    """Exception raised when trying to access a next or previous node."""
+
+
+class RootNodeError(GriffeError):
+    """Exception raised when trying to use siblings properties on a root node."""

src/griffe/expressions.py

@@ -4,7 +4,7 @@
 
 from typing import Any, Callable
 
-from griffe.exceptions import ResolutionError
+from griffe.exceptions import NameResolutionError
 
 
 class Name:
@@ -49,7 +49,7 @@ def full(self) -> str:
         if not self._full:
             try:
                 self._full = self._resolver() or self.source
-            except ResolutionError:
+            except NameResolutionError:
                 # probably a built-in
                 self._full = self.source
         return self._full

src/griffe/extended_ast.py

@@ -22,13 +22,7 @@
 from ast import AST  # noqa: WPS458
 from functools import cached_property
 
-
-class LastNodeError(Exception):
-    """Exception raised when trying to access a next or previous node."""
-
-
-class RootNodeError(Exception):
-    """Exception raised when trying to use siblings properties on a root node."""
+from griffe.exceptions import LastNodeError, RootNodeError
 
 
 class _ExtendedAST: