Housekeeping

Author: hunterhogan

.isort.cfg

@@ -0,0 +1,15 @@
+[settings]
+combine_as_imports=true
+force_alphabetical_sort_within_sections=true
+from_first=true
+honor_noqa=true
+indent='	'
+line_length=120
+lines_after_imports=1
+lines_between_types=0
+multi_line_output=4
+no_sections=true
+skip=__init__.py
+use_parentheses=true
+overwrite_in_place=true
+# line_ending='\n'

astToolkit/_toolThen.py

@@ -4,18 +4,18 @@
 import ast
 
 class Then:
-	"""Action functions for AST node transformations in the antecedent-action pattern.
-
-	(AI generated docstring)
-
-	Provides action functions that serve as consequents in the antecedent-action pattern, working with visitor classes like
-	`NodeTourist` and `NodeChanger` as the `doThat` parameter. Each method returns a function that performs a specific operation
-	on AST nodes identified by predicate functions from classes like `IfThis` or `Be`.
-
-	The action functions fall into five categories: collection operations for gathering nodes, identity operations for extraction
-	without modification, insertion operations for adding nodes relative to existing ones, removal operations for deletion, and
-	replacement operations for substitution. These actions enable precise AST transformations while maintaining the composable
-	nature of the toolkit's architecture.
+	"""Apply an action to a `node`, especially in the antecedent-action pattern of `NodeTourist` and `NodeChanger`.
+
+	Keep the `node`:
+	- `appendTo()` a list your provide.
+	- `extractIt()` as a return value.
+	- `updateKeyValueIn()` a dictionary you provide.
+
+	Change the `node`:
+	- `insertThisAbove()` the `node`.
+	- `insertThisBelow()` the `node`.
+	- `removeIt()`.
+	- `replaceWith()` an `ast.AST` or appropriate `object`.
 
 	"""