Temporarily allowing bad docstring indentation.

Author: hunterhogan

astToolkit/_toolGrab.py

@@ -554,26 +554,26 @@ def workhorse(node: hasDOTdecorator_list) -> hasDOTdecorator_list:
         def default_valueAttribute(action: Callable[[工 | None], 工 | None]) -> Callable[[hasDOTdefault_value], hasDOTdefault_value]:
             """Apply a function to the `default_value` attribute of a 'node' of `type` `hasDOTdefault_value`.
 
-            The `type` of the `default_value` attribute is `something` for [any of] `class` `ast.IDK`.  If `type` were
-            represented by a `TypeVar`, I would tell you what the ideogram is.  If `default_value` could be a second type, I
-            would tell you it is `type` `somethingElse` for [any of] `class` `ast.FML`.
+        The `type` of the `default_value` attribute is `something` for [any of] `class` `ast.IDK`.  If `type` were
+        represented by a `TypeVar`, I would tell you what the ideogram is.  If `default_value` could be a second type, I
+        would tell you it is `type` `somethingElse` for [any of] `class` `ast.FML`.
 
-            Parameters
-            ----------
-            action : Callable[[工 | None], 工 | None]
+        Parameters
+        ----------
+        action : Callable[[工 | None], 工 | None]
             A function with one parameter and a `return` of the same `type`.
 
-            Returns
-            -------
-            workhorse : Callable[[hasDOTdefault_value], hasDOTdefault_value]
+        Returns
+        -------
+        workhorse : Callable[[hasDOTdefault_value], hasDOTdefault_value]
             A function with one parameter for a 'node' of `type` `hasDOTdefault_value` and a `return` of the same
             `type`.
 
-            Type Checker Error?
-            -------------------
-            If you use `Grab` with one level of complexity, your type checker will give you accurate guidance. With two levels of complexity, such as nesting `Grab`
-            in another `Grab`, your type checker will be angry. I recommend `typing.cast()`. The fault is mine: the 'type safety' of `Grab` is inherently limited.
-            """
+        Type Checker Error?
+        -------------------
+        If you use `Grab` with one level of complexity, your type checker will give you accurate guidance. With two levels of complexity, such as nesting `Grab`
+        in another `Grab`, your type checker will be angry. I recommend `typing.cast()`. The fault is mine: the 'type safety' of `Grab` is inherently limited.
+        """
 
             def workhorse(node: hasDOTdefault_value) -> hasDOTdefault_value:
                 setattr(node, 'default_value', action(getattr(node, 'default_value')))

astToolkit/_toolMake.py

@@ -2639,49 +2639,49 @@ def join(cls, expressions: Sequence[ast.expr], **keywordArguments: Unpack[ast_at
         def ParamSpec(name: str, default_value: ast.expr | None=None, **keywordArguments: Unpack[ast_attributes_int]) -> ast.ParamSpec:
             """Make a parameter specification type parameter for generic callable types.
 
-            (AI generated docstring.)
+        (AI generated docstring.)
 
-            The `ast.ParamSpec` (***Param***eter ***Spec***ification) object represents parameter specification type
-            parameters used in generic callable types. Captures both positional and keyword argument signatures for type-
-            safe function composition and higher-order functions.
+        The `ast.ParamSpec` (***Param***eter ***Spec***ification) object represents parameter specification type
+        parameters used in generic callable types. Captures both positional and keyword argument signatures for type-
+        safe function composition and higher-order functions.
 
-            Parameters
-            ----------
-            name :
+        Parameters
+        ----------
+        name :
             Type parameter name as string identifier.
-            default_value :
+        default_value :
             Optional default type expression (Python 3.13+).
 
-            Returns
-            -------
-            parameterSpecification : ast.ParamSpec
+        Returns
+        -------
+        parameterSpecification : ast.ParamSpec
             AST object representing a parameter specification type parameter.
-            """
+        """
             return ast.ParamSpec(name=name, default_value=default_value, **keywordArguments)
     else:
 
         @staticmethod
         def ParamSpec(name: str, **keywordArguments: Unpack[ast_attributes_int]) -> ast.ParamSpec:
             """Make a parameter specification type parameter for generic callable types.
 
-            (AI generated docstring.)
+        (AI generated docstring.)
 
-            The `ast.ParamSpec` (***Param***eter ***Spec***ification) object represents parameter specification type
-            parameters used in generic callable types. Captures both positional and keyword argument signatures for type-
-            safe function composition and higher-order functions.
+        The `ast.ParamSpec` (***Param***eter ***Spec***ification) object represents parameter specification type
+        parameters used in generic callable types. Captures both positional and keyword argument signatures for type-
+        safe function composition and higher-order functions.
 
-            Parameters
-            ----------
-            name :
+        Parameters
+        ----------
+        name :
             Type parameter name as string identifier.
-            default_value :
+        default_value :
             Optional default type expression (Python 3.13+).
 
-            Returns
-            -------
-            parameterSpecification : ast.ParamSpec
+        Returns
+        -------
+        parameterSpecification : ast.ParamSpec
             AST object representing a parameter specification type parameter.
-            """
+        """
             return ast.ParamSpec(name=name, **keywordArguments)
 
     @staticmethod
@@ -3231,103 +3231,103 @@ def TypeIgnore(lineno: int, tag: str) -> ast.TypeIgnore:
         def TypeVar(name: str, bound: ast.expr | None=None, default_value: ast.expr | None=None, **keywordArguments: Unpack[ast_attributes_int]) -> ast.TypeVar:
             """Make a type variable parameter for generic types with optional bounds and defaults.
 
-            (AI generated docstring.)
+        (AI generated docstring.)
 
-            The `ast.TypeVar` (Type ***Var***iable) object represents type variable parameters used in generic classes,
-            functions, and type aliases. Supports type bounds, constraints, and default values for flexible generic
-            programming.
+        The `ast.TypeVar` (Type ***Var***iable) object represents type variable parameters used in generic classes,
+        functions, and type aliases. Supports type bounds, constraints, and default values for flexible generic
+        programming.
 
-            Parameters
-            ----------
-            name :
+        Parameters
+        ----------
+        name :
             Type variable name as string identifier.
-            bound :
+        bound :
             Optional type expression constraining allowed types.
-            default_value :
+        default_value :
             Optional default type expression (Python 3.13+).
 
-            Returns
-            -------
-            typeVariable : ast.TypeVar
+        Returns
+        -------
+        typeVariable : ast.TypeVar
             AST object representing a type variable with optional constraints.
-            """
+        """
             return ast.TypeVar(name=name, bound=bound, default_value=default_value, **keywordArguments)
     else:
 
         @staticmethod
         def TypeVar(name: str, bound: ast.expr | None=None, **keywordArguments: Unpack[ast_attributes_int]) -> ast.TypeVar:
             """Make a type variable parameter for generic types with optional bounds and defaults.
 
-            (AI generated docstring.)
+        (AI generated docstring.)
 
-            The `ast.TypeVar` (Type ***Var***iable) object represents type variable parameters used in generic classes,
-            functions, and type aliases. Supports type bounds, constraints, and default values for flexible generic
-            programming.
+        The `ast.TypeVar` (Type ***Var***iable) object represents type variable parameters used in generic classes,
+        functions, and type aliases. Supports type bounds, constraints, and default values for flexible generic
+        programming.
 
-            Parameters
-            ----------
-            name :
+        Parameters
+        ----------
+        name :
             Type variable name as string identifier.
-            bound :
+        bound :
             Optional type expression constraining allowed types.
-            default_value :
+        default_value :
             Optional default type expression (Python 3.13+).
 
-            Returns
-            -------
-            typeVariable : ast.TypeVar
+        Returns
+        -------
+        typeVariable : ast.TypeVar
             AST object representing a type variable with optional constraints.
-            """
+        """
             return ast.TypeVar(name=name, bound=bound, **keywordArguments)
     if sys.version_info >= (3, 13):
 
         @staticmethod
         def TypeVarTuple(name: str, default_value: ast.expr | None=None, **keywordArguments: Unpack[ast_attributes_int]) -> ast.TypeVarTuple:
             """Make a type variable tuple for variadic generic types.
 
-            (AI generated docstring.)
+        (AI generated docstring.)
 
-            The `ast.TypeVarTuple` (Type ***Var***iable ***Tuple***) object represents type variable tuples used for
-            variadic generic types that accept variable numbers of type arguments. Enables generic types that work with
-            arbitrary-length type sequences.
+        The `ast.TypeVarTuple` (Type ***Var***iable ***Tuple***) object represents type variable tuples used for
+        variadic generic types that accept variable numbers of type arguments. Enables generic types that work with
+        arbitrary-length type sequences.
 
-            Parameters
-            ----------
-            name :
+        Parameters
+        ----------
+        name :
             Type variable tuple name as string identifier.
-            default_value :
+        default_value :
             Optional default type tuple expression (Python 3.13+).
 
-            Returns
-            -------
-            typeVariableTuple : ast.TypeVarTuple
+        Returns
+        -------
+        typeVariableTuple : ast.TypeVarTuple
             AST object representing a variadic type variable.
-            """
+        """
             return ast.TypeVarTuple(name=name, default_value=default_value, **keywordArguments)
     else:
 
         @staticmethod
         def TypeVarTuple(name: str, **keywordArguments: Unpack[ast_attributes_int]) -> ast.TypeVarTuple:
             """Make a type variable tuple for variadic generic types.
 
-            (AI generated docstring.)
+        (AI generated docstring.)
 
-            The `ast.TypeVarTuple` (Type ***Var***iable ***Tuple***) object represents type variable tuples used for
-            variadic generic types that accept variable numbers of type arguments. Enables generic types that work with
-            arbitrary-length type sequences.
+        The `ast.TypeVarTuple` (Type ***Var***iable ***Tuple***) object represents type variable tuples used for
+        variadic generic types that accept variable numbers of type arguments. Enables generic types that work with
+        arbitrary-length type sequences.
 
-            Parameters
-            ----------
-            name :
+        Parameters
+        ----------
+        name :
             Type variable tuple name as string identifier.
-            default_value :
+        default_value :
             Optional default type tuple expression (Python 3.13+).
 
-            Returns
-            -------
-            typeVariableTuple : ast.TypeVarTuple
+        Returns
+        -------
+        typeVariableTuple : ast.TypeVarTuple
             AST object representing a variadic type variable.
-            """
+        """
             return ast.TypeVarTuple(name=name, **keywordArguments)
 
     @staticmethod