refactor: generate griffe import stubs

quartodoc/_griffe_compat/_generate_stubs.py

@@ -44,7 +44,9 @@ def code_for_imports(mod_code: str, submodules: list[str]) -> str:
         new_expr.module = "griffe"
         res.append(ast.unparse(new_expr))
 
-    return black.format_str("\n".join(res), mode=black.FileMode())
+    return black.format_str(
+        "# flake8: noqa\n\n" + "\n".join(res), mode=black.FileMode()
+    )
 
 
 def generate_griffe_stub(out_path: Path, mod, submodules: list[str]):
@@ -53,7 +55,11 @@ def generate_griffe_stub(out_path: Path, mod, submodules: list[str]):
 
 
 MAPPINGS = {
-    "dataclasses": ["_griffe.models", "_griffe.mixins", "_griffe.enumerations"],
+    "dataclasses": [
+        "_griffe.models",
+        "_griffe.mixins",
+        "_griffe.enumerations",
+    ],
     "docstrings": ["_griffe.docstrings.models"],
     "expressions": ["_griffe.expressions"],
 }

quartodoc/_griffe_compat/dataclasses.py

@@ -0,0 +1,31 @@
+# flake8: noqa
+
+from griffe import (
+    Alias,
+    Attribute,
+    Class,
+    Decorator,
+    Docstring,
+    Function,
+    Module,
+    Object,
+    Parameter,
+    Parameters,
+)
+from griffe import (
+    DelMembersMixin,
+    GetMembersMixin,
+    ObjectAliasMixin,
+    SerializationMixin,
+    SetMembersMixin,
+)
+from griffe import (
+    BreakageKind,
+    DocstringSectionKind,
+    ExplanationStyle,
+    Kind,
+    LogLevel,
+    ObjectKind,
+    ParameterKind,
+    Parser,
+)

quartodoc/_griffe_compat/docstrings.py

@@ -0,0 +1,34 @@
+# flake8: noqa
+
+from griffe import (
+    DocstringAdmonition,
+    DocstringAttribute,
+    DocstringClass,
+    DocstringDeprecated,
+    DocstringElement,
+    DocstringFunction,
+    DocstringModule,
+    DocstringNamedElement,
+    DocstringParameter,
+    DocstringRaise,
+    DocstringReceive,
+    DocstringReturn,
+    DocstringSection,
+    DocstringSectionAdmonition,
+    DocstringSectionAttributes,
+    DocstringSectionClasses,
+    DocstringSectionDeprecated,
+    DocstringSectionExamples,
+    DocstringSectionFunctions,
+    DocstringSectionModules,
+    DocstringSectionOtherParameters,
+    DocstringSectionParameters,
+    DocstringSectionRaises,
+    DocstringSectionReceives,
+    DocstringSectionReturns,
+    DocstringSectionText,
+    DocstringSectionWarns,
+    DocstringSectionYields,
+    DocstringWarn,
+    DocstringYield,
+)

quartodoc/_griffe_compat/expressions.py

@@ -0,0 +1,44 @@
+# flake8: noqa
+
+from griffe import (
+    Expr,
+    ExprAttribute,
+    ExprBinOp,
+    ExprBoolOp,
+    ExprCall,
+    ExprCompare,
+    ExprComprehension,
+    ExprConstant,
+    ExprDict,
+    ExprDictComp,
+    ExprExtSlice,
+    ExprFormatted,
+    ExprGeneratorExp,
+    ExprIfExp,
+    ExprJoinedStr,
+    ExprKeyword,
+    ExprLambda,
+    ExprList,
+    ExprListComp,
+    ExprName,
+    ExprNamedExpr,
+    ExprParameter,
+    ExprSet,
+    ExprSetComp,
+    ExprSlice,
+    ExprSubscript,
+    ExprTuple,
+    ExprUnaryOp,
+    ExprVarKeyword,
+    ExprVarPositional,
+    ExprYield,
+    ExprYieldFrom,
+    get_annotation,
+    get_base_class,
+    get_condition,
+    get_expression,
+    safe_get_annotation,
+    safe_get_base_class,
+    safe_get_condition,
+    safe_get_expression,
+)