classcore 1.5.3__tar.gz → 1.6.1__tar.gz

{classcore-1.5.3 → classcore-1.6.1}/.gitignore

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

{classcore-1.5.3 → classcore-1.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classcore
-Version: 1.5.3
+Version: 1.6.1
 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.3 → classcore-1.6.1}/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.3 → classcore-1.6.1}/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.3 → classcore-1.6.1}/sources/classcore/__init__.py

@@ -62,8 +62,8 @@ from .factories import *
 
 
 __version__: __.typx.Annotated[ str, __.ddoc.Visibilities.Reveal ]
-__version__ = '1.5.3'
+__version__ = '1.6.1'
 
 
-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.3 → classcore-1.6.1}/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_module(
+        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,
@@ -50,7 +108,6 @@ def reclassify_modules(
         __.ddoc.Doc( ''' New class for module. ''' ),
     ] = Module,
 ) -> None:
-    # TODO? Ensure correct operation with namespace packages.
     ''' Reclassifies modules to have attributes concealment and immutability.
 
         Can operate on individual modules or entire package hierarchies.
@@ -63,6 +120,46 @@ def reclassify_modules(
 
         Has no effect on already-reclassified modules.
     '''
+    _reclassify_module(
+        attributes,
+        attributes_namer = attributes_namer,
+        recursive = recursive,
+        replacement_class = replacement_class )
+
+
+def _reclassify_module(
+    attributes: __.typx.Annotated[
+        __.cabc.Mapping[ str, __.typx.Any ] | __.types.ModuleType | str,
+        __.ddoc.Doc(
+            ''' Module, module name, or dictionary of object attributes. ''' ),
+    ], /, *,
+    attributes_namer: __.typx.Annotated[
+        _nomina.AttributesNamer,
+        __.ddoc.Doc(
+            ''' Attributes namer function with which to seal class. ''' ),
+    ] = __.calculate_attrname,
+    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:
+    # TODO? Ensure correct operation with namespace packages.
+    ''' Core implementation for module reclassification.
+
+        Reclassifies modules to have attributes concealment and immutability.
+        Can operate on individual modules or entire package hierarchies.
+
+        Only converts modules within the same package to prevent unintended
+        modifications to external modules.
+
+        When used with a dictionary, converts any module objects found as
+        values if they belong to the same package.
+
+        Has no effect on already-reclassified modules.
+    '''
     if isinstance( attributes, str ):
         attributes = __.sys.modules[ attributes ]
     if isinstance( attributes, __.types.ModuleType ):
@@ -76,7 +173,7 @@ def reclassify_modules(
         if not __.inspect.ismodule( value ): continue
         if not value.__name__.startswith( f"{package_name}." ): continue
         if recursive:
-            reclassify_modules(
+            _reclassify_module(
                 value,
                 attributes_namer = attributes_namer,
                 recursive = True,