chore: Re-expose public API in the top-level module

Author: pawamoy

src/griffe_inherited_docstrings/__init__.py

@@ -5,6 +5,6 @@
 
 from __future__ import annotations
 
-from griffe_inherited_docstrings.extension import InheritDocstringsExtension
+from griffe_inherited_docstrings._internal.extension import InheritDocstringsExtension
 
 __all__: list[str] = ["InheritDocstringsExtension"]

src/griffe_inherited_docstrings/_internal/extension.py

@@ -1,5 +1,3 @@
-"""The Griffe extension."""
-
 from __future__ import annotations
 
 import contextlib
@@ -74,6 +72,7 @@ def __init__(self, *, merge: bool = False) -> None:
             merge: Whether to merge the docstrings from the parent classes into the docstring of the member.
         """
         self.merge = merge
+        """Whether to merge the docstrings from the parent classes into the docstring of the member."""
 
     def on_package(self, *, pkg: Module, **kwargs: Any) -> None:  # noqa: ARG002
         """Inherit docstrings from parent classes once the whole package is loaded."""

src/griffe_inherited_docstrings/extension.py

@@ -0,0 +1,17 @@
+"""Deprecated. Import from `griffe_inherited_docstrings` directly."""
+
+# YORE: Bump 2: Remove file.
+
+import warnings
+from typing import Any
+
+from griffe_inherited_docstrings._internal import extension
+
+
+def __getattr__(name: str) -> Any:
+    warnings.warn(
+        "Importing from `griffe_inherited_docstrings.extension` is deprecated. Import from `griffe_inherited_docstrings` directly.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return getattr(extension, name)