classcore 1.5.2__tar.gz → 1.6__tar.gz

{classcore-1.5.2 → classcore-1.6}/.gitignore

@@ -1,7 +1,10 @@
 .env
+.gemini
+.mcp.json
 .*.swp
 AGENTS.md
 CLAUDE.md
 CONVENTIONS.md
+GEMINI.md
 __pycache__/
 bugs/

{classcore-1.5.2 → classcore-1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classcore
-Version: 1.5.2
+Version: 1.6
 Summary: Foundational class factories and decorators.
 Project-URL: Homepage, https://github.com/emcd/python-classcore
 Project-URL: Documentation, https://emcd.github.io/python-classcore

{classcore-1.5.2 → classcore-1.6}/pyproject.toml

@@ -54,6 +54,7 @@ year-of-origin = 2025
 gha-runners = [
   '/home/runner/work/python-classcore/python-classcore/',
   '/Users/runner/work/python-classcore/python-classcore/',
+  'C:\a\python-classcore\python-classcore\',
   'D:\a\python-classcore\python-classcore\',
 ]
 [tool.coverage.run]
@@ -95,9 +96,7 @@ description = ''' Development environment. '''
 dependencies = [
   'Jinja2',
   'coverage[toml]',
-  'emcd-projects',
   'furo',
-  'icecream-truck',
   'packaging',
   'pre-commit',
   'pyright',

{classcore-1.5.2 → classcore-1.6}/sources/classcore/__/imports.py

@@ -18,7 +18,7 @@
 #============================================================================#
 
 
-''' Common imports and type aliases used throughout the package. '''
+''' Common imports used throughout the package. '''
 
 # ruff: noqa: F401
 

{classcore-1.5.2 → classcore-1.6}/sources/classcore/__init__.py

@@ -62,8 +62,8 @@ from .factories import *
 
 
 __version__: __.typx.Annotated[ str, __.ddoc.Visibilities.Reveal ]
-__version__ = '1.5.2'
+__version__ = '1.6'
 
 
-standard.dynadoc.assign_module_docstring( __name__, table = __.fragments )
-standard.reclassify_modules( __name__, recursive = True )
+standard.finalize_module(
+    __name__, dynadoc_table = __.fragments, recursive = True )

{classcore-1.5.2 → classcore-1.6}/sources/classcore/standard/behaviors.py

@@ -182,6 +182,7 @@ def augment_class_attributes_allocations(
         __.cabc.Sequence[ str ],
         None
     ] = namespace.get( '__slots__' )
+    if slots and behaviors_name in slots: return
     if isinstance( slots, __.cabc.Mapping ):
         slots_ = dict( slots )
         slots_[ behaviors_name ] = 'Active behaviors.'

{classcore-1.5.2 → classcore-1.6}/sources/classcore/standard/decorators.py

@@ -47,11 +47,13 @@ def prepare_dataclass_for_instances(
     ''' Annotates dataclass in support of instantiation machinery. '''
     annotations = __.inspect.get_annotations( cls )
     behaviors_name = attributes_namer( 'instance', 'behaviors' )
-    # TODO? Only use mangling if not slotted.
-    behaviors_name_m = _utilities.mangle_name( cls, behaviors_name )
-    annotations[ behaviors_name_m ] = set[ str ]
+    # TODO: Only use mangling if not slotted.
+    # behaviors_name_ = _utilities.mangle_name( cls, behaviors_name )
+    behaviors_name_ = behaviors_name
+    annotations[ behaviors_name_ ] = set[ str ]
     setattr( cls, '__annotations__', annotations ) # in case of absence
-    setattr( cls, behaviors_name_m, __.dcls.field( init = False ) )
+    setattr( cls, behaviors_name_, __.dcls.field(
+        compare = False, hash = False, init = False, repr = False ) )
 
 
 def apply_cfc_core_functions(

{classcore-1.5.2 → classcore-1.6}/sources/classcore/standard/modules.py

@@ -24,6 +24,7 @@
 from .. import utilities as _utilities
 from . import __
 from . import classes as _classes
+from . import dynadoc as _dynadoc
 from . import nomina as _nomina
 
 
@@ -31,6 +32,63 @@ class Module( _classes.Object, __.types.ModuleType ):
     ''' Modules with attributes immutability and concealment. '''
 
 
+def finalize_module( # noqa: PLR0913
+    module: __.typx.Annotated[
+        str | __.types.ModuleType,
+        __.ddoc.Doc( ''' Module or module name to finalize. ''' ),
+    ], /,
+    *fragments: __.ddoc.interfaces.Fragment,
+    attributes_namer: _nomina.AttributesNamer = __.calculate_attrname,
+    dynadoc_introspection: _nomina.DynadocIntrospectionArgument = (
+        _dynadoc.dynadoc_introspection_on_package ),
+    dynadoc_table: _nomina.DynadocTableArgument = __.dictproxy_empty,
+    recursive: __.typx.Annotated[
+        bool, __.ddoc.Doc( ''' Recursively reclassify package modules? ''' )
+    ] = False,
+    replacement_class: __.typx.Annotated[
+        type[ __.types.ModuleType ],
+        __.ddoc.Doc( ''' New class for module. ''' ),
+    ] = Module,
+) -> None:
+    ''' Combines Dynadoc docstring assignment and module reclassification.
+
+        Applies module docstring generation via Dynadoc introspection,
+        then reclassifies modules for immutability and concealment.
+
+        When recursive is False, automatically excludes module targets from
+        dynadoc introspection to document only the provided module. When
+        recursive is True, automatically includes module targets so Dynadoc
+        can recursively document all modules.
+    '''
+    module_target = __.ddoc.IntrospectionTargets.Module
+    if recursive:
+        if not ( dynadoc_introspection.targets & module_target ):
+            targets = dynadoc_introspection.targets | module_target
+            introspection = __.ddoc.IntrospectionControl(
+                enable = dynadoc_introspection.enable,
+                class_control = dynadoc_introspection.class_control,
+                module_control = dynadoc_introspection.module_control,
+                limiters = dynadoc_introspection.limiters,
+                targets = targets )
+        else: introspection = dynadoc_introspection
+    elif dynadoc_introspection.targets & module_target:
+        limit = __.ddoc.IntrospectionLimit(
+            targets_exclusions = module_target )
+        introspection = dynadoc_introspection.with_limit( limit )
+    else: introspection = dynadoc_introspection
+    _dynadoc.assign_module_docstring(
+        module,
+        *fragments,
+        introspection = introspection,
+        table = dynadoc_table )
+    reclassify_modules(
+        module,
+        attributes_namer = attributes_namer,
+        recursive = recursive,
+        replacement_class = replacement_class )
+
+
+@__.typx.deprecated( "Use 'finalize_module' instead." )
 def reclassify_modules(
     attributes: __.typx.Annotated[
         __.cabc.Mapping[ str, __.typx.Any ] | __.types.ModuleType | str,

{classcore-1.5.2 → classcore-1.6}/sources/classcore/utilities.py

@@ -99,11 +99,11 @@ def mangle_name( objct: object, /, name: str ) -> str:
     #       Need to debug weird issue with using 'id' early on dataclasses.
     if not __.inspect.isclass( objct ):
         return mangle_name( type( objct ), name )
-    # return "{name}_{uid}".format( name = name, uid = id( objct ) )
+    # return "{name}{uid}".format( name = name, uid = id( objct ) )
     namehash = __.hashlib.sha256( )
     namehash.update( qualify_class_name( objct ).encode( ) )
     namehash_hex = namehash.hexdigest( )
-    return f"{name}_{namehash_hex}"
+    return f"{name}{namehash_hex}"
 
 
 def qualify_class_name( cls: type ) -> str: