astToolkit 0.6.0__tar.gz → 0.7.0__tar.gz

{asttoolkit-0.6.0 → asttoolkit-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astToolkit
-Version: 0.6.0
+Version: 0.7.0
 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
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -29,15 +30,14 @@ License-File: LICENSE
 Requires-Dist: autoflake
 Requires-Dist: hunterMakesPy
 Requires-Dist: typing_extensions>=4.10.0
+Provides-Extra: development
+Requires-Dist: mypy; extra == "development"
+Requires-Dist: pyupgrade; extra == "development"
+Requires-Dist: setuptools-scm; extra == "development"
 Provides-Extra: testing
-Requires-Dist: mypy; extra == "testing"
 Requires-Dist: pytest-cov; extra == "testing"
 Requires-Dist: pytest-xdist; extra == "testing"
 Requires-Dist: pytest; extra == "testing"
-Requires-Dist: pyupgrade; extra == "testing"
-Requires-Dist: setuptools-scm; extra == "testing"
-Requires-Dist: tomli; extra == "testing"
-Requires-Dist: trove_classifiers; extra == "testing"
 Dynamic: license-file
 
 # astToolkit

{asttoolkit-0.6.0 → asttoolkit-0.7.0}/astToolkit/__init__.py

@@ -64,7 +64,7 @@ import sys
 
 from astToolkit._astTypes import (
 	ast_attributes as ast_attributes, ast_attributes_int as ast_attributes_int,
-	ast_attributes_type_comment as ast_attributes_type_comment, ConstantValueType as ConstantValueType,
+	ast_attributes_type_comment as ast_attributes_type_comment, astASTattributes as astASTattributes, ConstantValueType as ConstantValueType,
 	hasDOTannotation as hasDOTannotation, hasDOTannotation_expr as hasDOTannotation_expr,
 	hasDOTannotation_exprOrNone as hasDOTannotation_exprOrNone, hasDOTarg as hasDOTarg, hasDOTarg_str as hasDOTarg_str,
 	hasDOTarg_strOrNone as hasDOTarg_strOrNone, hasDOTargs as hasDOTargs, hasDOTargs_arguments as hasDOTargs_arguments,
@@ -110,7 +110,8 @@ from astToolkit._astTypes import (
 if sys.version_info >= (3, 13):
 	from astToolkit._astTypes import hasDOTdefault_value as hasDOTdefault_value
 
-from astToolkit._dumpHandmade import dump as dump
+if sys.version_info >= (3, 13):
+	from astToolkit._dumpHandmade import dump as dump
 
 from astToolkit._toolkitNodeVisitor import (
 	NodeChanger as NodeChanger,

{asttoolkit-0.6.0 → asttoolkit-0.7.0}/astToolkit/_astTypes.py

@@ -5,6 +5,7 @@ import ast
 import sys
 
 type ConstantValueType = bool | bytes | complex | EllipsisType | float | int | None | range | str
+type astASTattributes = ast.AST | ConstantValueType | list[ast.AST] | list[ast.AST | None] | list[str]
 type identifierDotAttribute = str
 个 = typing_TypeVar('个', covariant=True)
 归个 = typing_TypeVar('归个', covariant=True)

asttoolkit-0.7.0/astToolkit/_dumpHandmade.py

@@ -0,0 +1,100 @@
+from astToolkit import astASTattributes
+import ast
+import sys
+
+if sys.version_info >= (3, 13):
+
+	def dump(node: ast.AST, *, annotate_fields: bool = True, include_attributes: bool = False, indent: int | str | None = None, show_empty: bool = False) -> str:  # noqa: C901, PLR0915
+		"""Return a formatted string representation of an `ast.AST` node.
+
+		Parameters
+		----------
+		node : ast.AST
+			The `ast.AST` node to format.
+		annotate_fields : bool = True
+			Whether to include field names in the output.
+		include_attributes : bool = False
+			Whether to include node "_attributes" in addition to fields. The attributes in category `_attributes` are `lineno` (line
+			_**n**umer**o**_ (_Latin_ "number")), `col_offset` (***col***umn offset), `end_lineno` (end line _**n**umer**o**_ (_Latin_
+			"number")), and `end_col_offset` (end ***col***umn offset).
+		indent : int | str | None = None
+			String for indentation or number of spaces; `None` for single-line output.
+		show_empty : bool = False
+			Whether to include fields with empty list or `None` values.
+
+		Returns
+		-------
+		formattedString : str
+			String representation of the `ast.AST` node with specified formatting.
+
+		"""
+		def _format(node: astASTattributes, level: int = 0) -> tuple[str, bool]:  # noqa: C901, PLR0912, PLR0915
+			if indentString is not None:
+				level += 1
+				ImaIndent: str = '\n' + indentString * level
+				separator: str = ',\n' + indentString * level
+			else:
+				ImaIndent = ''
+				separator = ', '
+			if isinstance(node, ast.AST):
+				astAST: type[ast.AST] = type(node)
+				listAttributes: list[str] = []
+				attributeStaging: list[str] = []
+				simpleOutput: bool = True
+				showAnnotations: bool = annotate_fields
+				for name in node._fields:
+					try:
+						value: astASTattributes = getattr(node, name)
+					except AttributeError:
+						showAnnotations = True
+						continue
+					if value is None and getattr(astAST, name, ...) is None:
+						if show_empty:
+							listAttributes.append(f'{name}={value}')
+						showAnnotations = True
+						continue
+					if not show_empty:
+						if value == []:
+							field_type: astASTattributes = astAST._field_types.get(name, object)  # noqa: SLF001
+							if getattr(field_type, '__origin__', ...) is list:
+								if not showAnnotations:
+									attributeStaging.append(repr(value))
+								continue
+						if not showAnnotations:
+							listAttributes.extend(attributeStaging)
+							attributeStaging = []
+					valueFormatted, simpleFormat = _format(value, level)
+					simpleOutput = simpleOutput and simpleFormat
+					if showAnnotations:
+						listAttributes.append(f'{name}={valueFormatted}')
+					else:
+						listAttributes.append(valueFormatted)
+				if include_attributes and node._attributes:  # noqa: SLF001
+					for name_attributes in node._attributes:  # noqa: SLF001
+						try:
+							value_attributes = getattr(node, name_attributes)
+						except AttributeError:
+							continue
+						if value_attributes is None and getattr(astAST, name_attributes, ...) is None:
+							continue
+						value_attributesFormatted, simpleFormat = _format(value_attributes, level)
+						simpleOutput = simpleOutput and simpleFormat
+						listAttributes.append(f'{name_attributes}={value_attributesFormatted}')
+				if simpleOutput and len(listAttributes) <= 3:
+					return (f"ast.{node.__class__.__name__}({', '.join(listAttributes)})", not bool(listAttributes))
+				return (f"ast.{node.__class__.__name__}({ImaIndent}{separator.join(listAttributes)})", False)
+			elif isinstance(node, list):
+				if not node:
+					return ('[]', True)
+				return (f'[{ImaIndent}{separator.join(_format(x, level)[0] for x in node)}]', False)
+			return (repr(node), True)
+
+		if not isinstance(node, ast.AST):
+			message = f'expected `ast.AST`, got {node.__class__.__name__!r}'
+			raise TypeError(message)
+		if indent is not None and not isinstance(indent, str):
+			indentString = " " * indent
+		else:
+			indentString = indent
+		return _format(node)[0]
+