Merge pull request #9 from hunterhogan/copilot/vscode1756473539902

Copilot/vscode1756473539902

Author: hunterhogan

CC-BY-NC-4.0.png

@@ -7,12 +7,12 @@ authors:
   family-names: Hogan
   email: HunterHogan@pm.me
 cff-version: 1.2.0
-commit: 2eb89377c9ade75ebebc1a8057b8cf14b2504861
-date-released: '2025-07-21'
+commit: f69358c099d2cbf0debd2a2e64f87f3c564af484
+date-released: '2025-09-07'
 identifiers:
 - type: url
-  value: https://github.com/hunterhogan/astToolkit/releases/tag/0.7.1
-  description: The URL for astToolkit 0.7.1.
+  value: https://github.com/hunterhogan/astToolkit/releases/tag/0.7.2
+  description: The URL for astToolkit 0.7.2.
 keywords:
 - abstract syntax tree
 - ast
@@ -37,9 +37,9 @@ keywords:
 license: CC-BY-NC-4.0
 message: Cite this software with the metadata in this file.
 repository: https://github.com/hunterhogan/astToolkit.git
-repository-artifact: https://pypi.org/project/asttoolkit/0.7.1/
-repository-code: https://github.com/hunterhogan/astToolkit/releases/tag/0.7.1
+repository-artifact: https://pypi.org/project/asttoolkit/0.7.2/
+repository-code: https://github.com/hunterhogan/astToolkit/releases/tag/0.7.2
 title: astToolkit
 type: software
 url: https://github.com/hunterhogan/astToolkit
-version: 0.7.1
+version: 0.7.2

CC-BY-NC-4.0.svg

@@ -312,4 +312,4 @@ Coding One Step at a Time:
 2. Write good code.
 3. When revising, write better code.
 
-[![CC-BY-NC-4.0](https://github.com/hunterhogan/astToolkit/blob/main/CC-BY-NC-4.0.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
+[![CC-BY-NC-4.0](https://github.com/hunterhogan/astToolkit/blob/main/CC-BY-NC-4.0.png)](https://creativecommons.org/licenses/by-nc/4.0/)

CITATION.cff

@@ -71,23 +71,19 @@ def extractClassDef(astAST: ast.AST, identifier: str) -> ast.ClassDef | None:
 
 def extractFunctionDef(astAST: ast.AST, identifier: str) -> ast.FunctionDef | None:
 	"""
-	Extract a function definition with a specific name from an AST module.
-
-	(AI generated docstring)
-
-	This function searches through an AST module for a function definition that matches the provided identifier and returns it if found.
+	Extract the function from `astAST` with `ast.FunctionDef.name == identifier`.
 
 	Parameters
 	----------
 	astAST : ast.AST
-		The AST object to search within.
+		(abstract syntax tree) An `ast.AST` subclass from which to extract the function.
 	identifier : str
-		The name of the function to find.
+		The identifier in `ast.FunctionDef.name`.
 
 	Returns
 	-------
-	astFunctionDef | None
-		The matching function definition AST node, or `None` if not found.
+	astFunctionDef : ast.FunctionDef | None
+		The target function, or `None` if `extractFunctionDef` does not find `ast.FunctionDef.name == identifier`.
 
 	"""
 	return NodeTourist(IfThis.isFunctionDefIdentifier(identifier), Then.extractIt).captureLastMatch(astAST)
@@ -99,7 +95,7 @@ def parseLogicalPath2astModule(logicalPath: identifierDotAttribute, package: str
 	(AI generated docstring)
 
 	This function imports a module using its logical path (e.g., 'scipy.signal.windows') and converts its source code into an
-	`ast.Module` (abstract syntax tree) object. Supports all relevant `ast.parse` parameters.
+	`ast.Module` (abstract syntax tree) `object`. Supports all relevant `ast.parse` parameters.
 
 	Parameters
 	----------