astToolkit 0.7.2__tar.gz → 0.7.4__tar.gz

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astToolkit
-Version: 0.7.2
+Version: 0.7.4
 Summary: A powerfully composable, type-safe toolkit for Python abstract syntax tree (AST) manipulation, analysis, transformation, and code generation with a layered architecture designed for building sophisticated code processing assembly-lines.
 Author-email: Hunter Hogan <HunterHogan@pm.me>
 License: CC-BY-NC-4.0

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/astToolkit/__init__.py

@@ -120,7 +120,7 @@ from astToolkit._toolkitNodeVisitor import (
 
 from astToolkit._toolBe import Be as Be
 from astToolkit._toolDOT import DOT as DOT
-from astToolkit._toolGrab import Grab as Grab, index as index, indices as indices
+from astToolkit._toolGrab import Grab as Grab
 from astToolkit._toolMake import Make as Make
 from astToolkit._prototypeFind import Find as Find
 

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/astToolkit/_toolBe.py

@@ -270,7 +270,7 @@ class Be:
 
     @staticmethod
     def AST(node: ast.AST) -> TypeIs[ast.AST]:
-        """`Be.AST`, Abstract Syntax Tree, matches any of `class` `ast.AST` | `ast._NoParent` | `ast.alias` | `ast.arg` | `ast.arguments` | `ast.boolop` | `ast.cmpop` | `ast.comprehension` | `ast.excepthandler` | `ast.Exec` | `ast.expr_context` | `ast.expr` | `ast.keyword` | `ast.match_case` | `ast.mod` | `ast.operator` | `ast.pattern` | `ast.slice` | `ast.stmt` | `ast.type_ignore` | `ast.type_param` | `ast.unaryop` | `ast.withitem`.
+        """`Be.AST`, Abstract Syntax Tree, matches any of `class` `ast.AST` | `ast.alias` | `ast.arg` | `ast.arguments` | `ast.boolop` | `ast.cmpop` | `ast.comprehension` | `ast.excepthandler` | `ast.expr_context` | `ast.expr` | `ast.keyword` | `ast.match_case` | `ast.mod` | `ast.operator` | `ast.pattern` | `ast.slice` | `ast.stmt` | `ast.type_ignore` | `ast.type_param` | `ast.unaryop` | `ast.withitem`.
 
         It is a subclass of `ast.object`.
         """

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/astToolkit/_toolGrab.py

@@ -12,25 +12,13 @@ from astToolkit import (
 	hasDOTsubject, hasDOTtag, hasDOTtarget, hasDOTtargets, hasDOTtest, hasDOTtype, hasDOTtype_comment, hasDOTtype_ignores,
 	hasDOTtype_params, hasDOTupper, hasDOTvalue, hasDOTvalues, hasDOTvararg, 一符, 个, 二符, 俪, 口, 工, 工位, 布尔符, 形, 比符)
 from collections.abc import Callable, Sequence
-from typing import Any, cast
+from typing import Any
 import ast
 import sys
 
 if sys.version_info >= (3, 13):
     from astToolkit import hasDOTdefault_value
 
-def index[个, 归个](at: int) -> Callable[[Sequence[个]], 归个]:
-
-    def workhorse(node: Sequence[个]) -> 归个:
-        return cast('归个', node[at])
-    return workhorse
-
-def indices[个, 归个](at: slice) -> Callable[[Sequence[个]], 归个]:
-
-    def workhorse(node: Sequence[个]) -> 归个:
-        return cast('归个', node[at])
-    return workhorse
-
 class Grab:
     """Modify specific attributes of AST nodes while preserving the node structure.
 
@@ -51,6 +39,21 @@ class Grab:
             return node
         return workhorse
 
+    @staticmethod
+    def index(at: int, /, action: Callable[[Any], Any]) -> Callable[[Sequence[个]], list[个]]:
+
+        def workhorse(node: Sequence[个]) -> list[个]:
+            node = list(node)
+            consequences = action(node[at])
+            if consequences is None:
+                node.pop(at)
+            elif isinstance(consequences, list):
+                node = node[0:at] + consequences + node[at + 1:None]
+            else:
+                node[at] = consequences
+            return node
+        return workhorse
+
     @staticmethod
     def annotationAttribute(action: Callable[[工], 工] | Callable[[工 | None], 工 | None]) -> Callable[[hasDOTannotation], hasDOTannotation]:
 

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/astToolkit/_toolMake.py

@@ -2422,25 +2422,7 @@ class Make:
 
     @staticmethod
     def mod() -> ast.mod:
-        """Create an appropriate `ast.mod` (***mod***ule) node based on the body content.
-
-        (AI generated docstring)
-
-        The `mod` method creates the appropriate module type node based on the
-        provided body. This is a convenience method that determines whether to
-        create a `Module`, `Expression`, or `Interactive` node.
-
-        Parameters
-        ----------
-        body : list[ast.stmt] | ast.expr
-            Either a list of statements or a single expression
-
-        Returns
-        -------
-        nodeMod : ast.mod
-            The constructed module node of appropriate type
-
-        """
+        """Create an abstract `ast.mod` (***mod***ule) `object`."""
         return ast.mod()
 
     class Mod(ast.Mod):

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/astToolkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astToolkit
-Version: 0.7.2
+Version: 0.7.4
 Summary: A powerfully composable, type-safe toolkit for Python abstract syntax tree (AST) manipulation, analysis, transformation, and code generation with a layered architecture designed for building sophisticated code processing assembly-lines.
 Author-email: Hunter Hogan <HunterHogan@pm.me>
 License: CC-BY-NC-4.0

{asttoolkit-0.7.2 → asttoolkit-0.7.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "astToolkit"
-version = "0.7.2"
+version = "0.7.4"
 description = "A powerfully composable, type-safe toolkit for Python abstract syntax tree (AST) manipulation, analysis, transformation, and code generation with a layered architecture designed for building sophisticated code processing assembly-lines."
 readme = "README.md"
 requires-python = ">=3.12"