classcore 1.6.1__tar.gz → 1.8__tar.gz

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

@@ -1,4 +1,5 @@
 .env
+.claude
 .gemini
 .mcp.json
 .*.swp
@@ -8,3 +9,4 @@ CONVENTIONS.md
 GEMINI.md
 __pycache__/
 bugs/
+build/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classcore
-Version: 1.6.1
+Version: 1.8
 Summary: Foundational class factories and decorators.
 Project-URL: Homepage, https://github.com/emcd/python-classcore
 Project-URL: Documentation, https://emcd.github.io/python-classcore
@@ -110,14 +110,17 @@ modules.
 Installation 📦
 ===============================================================================
 
-Via `uv <https://github.com/astral-sh/uv/blob/main/README.md>`_ ``pip``
+Method: Install Python Package
+-------------------------------------------------------------------------------
+
+Install via `uv <https://github.com/astral-sh/uv/blob/main/README.md>`_ ``pip``
 command:
 
 ::
 
     uv pip install classcore
 
-Or, via ``pip``:
+Or, install via ``pip``:
 
 ::
 
@@ -217,6 +220,23 @@ Use Cases 🎯
 * 📦 **Frameworks**: Frameworks with controlled extension and modification.
 
 
+Contribution 🤝
+===============================================================================
+
+Contribution to this project is welcome! However, it must follow the `code of
+conduct
+<https://emcd.github.io/python-project-common/stable/sphinx-html/common/conduct.html>`_
+for the project.
+
+Please file bug reports and feature requests in the `issue tracker
+<https://github.com/emcd/python-classcore/issues>`_ or submit `pull
+requests <https://github.com/emcd/python-classcore/pulls>`_ to
+improve the source code or documentation.
+
+For development guidance and standards, please see the `development guide
+<https://emcd.github.io/python-classcore/stable/sphinx-html/contribution.html#development>`_.
+
+
 `More Flair <https://www.imdb.com/title/tt0151804/characters/nm0431918>`_
 ===============================================================================
 
@@ -257,24 +277,24 @@ Other Projects by This Author 🌟
 ===============================================================================
 
 
-* `python-absence <https://github.com/emcd/python-absence>`_ (`absence <https://pypi.org/project/absence/>`_ on PyPI) 
+* `python-absence <https://github.com/emcd/python-absence>`_ (`absence <https://pypi.org/project/absence/>`_ on PyPI)
 
   🕳️ A Python library package which provides a **sentinel for absent values** - a falsey, immutable singleton that represents the absence of a value in contexts where ``None`` or ``False`` may be valid values.
-* `python-accretive <https://github.com/emcd/python-accretive>`_ (`accretive <https://pypi.org/project/accretive/>`_ on PyPI) 
+* `python-accretive <https://github.com/emcd/python-accretive>`_ (`accretive <https://pypi.org/project/accretive/>`_ on PyPI)
 
   🌌 A Python library package which provides **accretive data structures** - collections which can grow but never shrink.
-* `python-dynadoc <https://github.com/emcd/python-dynadoc>`_ (`dynadoc <https://pypi.org/project/dynadoc/>`_ on PyPI) 
+* `python-dynadoc <https://github.com/emcd/python-dynadoc>`_ (`dynadoc <https://pypi.org/project/dynadoc/>`_ on PyPI)
 
   📝 A Python library package which bridges the gap between **rich annotations** and **automatic documentation generation** with configurable renderers and support for reusable fragments.
-* `python-falsifier <https://github.com/emcd/python-falsifier>`_ (`falsifier <https://pypi.org/project/falsifier/>`_ on PyPI) 
+* `python-falsifier <https://github.com/emcd/python-falsifier>`_ (`falsifier <https://pypi.org/project/falsifier/>`_ on PyPI)
 
   🎭 A very simple Python library package which provides a **base class for falsey objects** - objects that evaluate to ``False`` in boolean contexts.
-* `python-frigid <https://github.com/emcd/python-frigid>`_ (`frigid <https://pypi.org/project/frigid/>`_ on PyPI) 
+* `python-frigid <https://github.com/emcd/python-frigid>`_ (`frigid <https://pypi.org/project/frigid/>`_ on PyPI)
 
   🔒 A Python library package which provides **immutable data structures** - collections which cannot be modified after creation.
-* `python-icecream-truck <https://github.com/emcd/python-icecream-truck>`_ (`icecream-truck <https://pypi.org/project/icecream-truck/>`_ on PyPI) 
+* `python-icecream-truck <https://github.com/emcd/python-icecream-truck>`_ (`icecream-truck <https://pypi.org/project/icecream-truck/>`_ on PyPI)
 
   🍦 **Flavorful Debugging** - A Python library which enhances the powerful and well-known ``icecream`` package with flavored traces, configuration hierarchies, customized outputs, ready-made recipes, and more.
-* `python-mimeogram <https://github.com/emcd/python-mimeogram>`_ (`mimeogram <https://pypi.org/project/mimeogram/>`_ on PyPI) 
+* `python-mimeogram <https://github.com/emcd/python-mimeogram>`_ (`mimeogram <https://pypi.org/project/mimeogram/>`_ on PyPI)
 
   📨 A command-line tool for **exchanging collections of files with Large Language Models** - bundle multiple files into a single clipboard-ready document while preserving directory structure and metadata... good for code reviews, project sharing, and LLM interactions.

{classcore-1.6.1 → classcore-1.8}/README.rst

@@ -81,14 +81,17 @@ modules.
 Installation 📦
 ===============================================================================
 
-Via `uv <https://github.com/astral-sh/uv/blob/main/README.md>`_ ``pip``
+Method: Install Python Package
+-------------------------------------------------------------------------------
+
+Install via `uv <https://github.com/astral-sh/uv/blob/main/README.md>`_ ``pip``
 command:
 
 ::
 
     uv pip install classcore
 
-Or, via ``pip``:
+Or, install via ``pip``:
 
 ::
 
@@ -188,6 +191,23 @@ Use Cases 🎯
 * 📦 **Frameworks**: Frameworks with controlled extension and modification.
 
 
+Contribution 🤝
+===============================================================================
+
+Contribution to this project is welcome! However, it must follow the `code of
+conduct
+<https://emcd.github.io/python-project-common/stable/sphinx-html/common/conduct.html>`_
+for the project.
+
+Please file bug reports and feature requests in the `issue tracker
+<https://github.com/emcd/python-classcore/issues>`_ or submit `pull
+requests <https://github.com/emcd/python-classcore/pulls>`_ to
+improve the source code or documentation.
+
+For development guidance and standards, please see the `development guide
+<https://emcd.github.io/python-classcore/stable/sphinx-html/contribution.html#development>`_.
+
+
 `More Flair <https://www.imdb.com/title/tt0151804/characters/nm0431918>`_
 ===============================================================================
 
@@ -228,24 +248,24 @@ Other Projects by This Author 🌟
 ===============================================================================
 
 
-* `python-absence <https://github.com/emcd/python-absence>`_ (`absence <https://pypi.org/project/absence/>`_ on PyPI) 
+* `python-absence <https://github.com/emcd/python-absence>`_ (`absence <https://pypi.org/project/absence/>`_ on PyPI)
 
   🕳️ A Python library package which provides a **sentinel for absent values** - a falsey, immutable singleton that represents the absence of a value in contexts where ``None`` or ``False`` may be valid values.
-* `python-accretive <https://github.com/emcd/python-accretive>`_ (`accretive <https://pypi.org/project/accretive/>`_ on PyPI) 
+* `python-accretive <https://github.com/emcd/python-accretive>`_ (`accretive <https://pypi.org/project/accretive/>`_ on PyPI)
 
   🌌 A Python library package which provides **accretive data structures** - collections which can grow but never shrink.
-* `python-dynadoc <https://github.com/emcd/python-dynadoc>`_ (`dynadoc <https://pypi.org/project/dynadoc/>`_ on PyPI) 
+* `python-dynadoc <https://github.com/emcd/python-dynadoc>`_ (`dynadoc <https://pypi.org/project/dynadoc/>`_ on PyPI)
 
   📝 A Python library package which bridges the gap between **rich annotations** and **automatic documentation generation** with configurable renderers and support for reusable fragments.
-* `python-falsifier <https://github.com/emcd/python-falsifier>`_ (`falsifier <https://pypi.org/project/falsifier/>`_ on PyPI) 
+* `python-falsifier <https://github.com/emcd/python-falsifier>`_ (`falsifier <https://pypi.org/project/falsifier/>`_ on PyPI)
 
   🎭 A very simple Python library package which provides a **base class for falsey objects** - objects that evaluate to ``False`` in boolean contexts.
-* `python-frigid <https://github.com/emcd/python-frigid>`_ (`frigid <https://pypi.org/project/frigid/>`_ on PyPI) 
+* `python-frigid <https://github.com/emcd/python-frigid>`_ (`frigid <https://pypi.org/project/frigid/>`_ on PyPI)
 
   🔒 A Python library package which provides **immutable data structures** - collections which cannot be modified after creation.
-* `python-icecream-truck <https://github.com/emcd/python-icecream-truck>`_ (`icecream-truck <https://pypi.org/project/icecream-truck/>`_ on PyPI) 
+* `python-icecream-truck <https://github.com/emcd/python-icecream-truck>`_ (`icecream-truck <https://pypi.org/project/icecream-truck/>`_ on PyPI)
 
   🍦 **Flavorful Debugging** - A Python library which enhances the powerful and well-known ``icecream`` package with flavored traces, configuration hierarchies, customized outputs, ready-made recipes, and more.
-* `python-mimeogram <https://github.com/emcd/python-mimeogram>`_ (`mimeogram <https://pypi.org/project/mimeogram/>`_ on PyPI) 
+* `python-mimeogram <https://github.com/emcd/python-mimeogram>`_ (`mimeogram <https://pypi.org/project/mimeogram/>`_ on PyPI)
 
   📨 A command-line tool for **exchanging collections of files with Large Language Models** - bundle multiple files into a single clipboard-ready document while preserving directory structure and metadata... good for code reviews, project sharing, and LLM interactions.

{classcore-1.6.1 → classcore-1.8}/pyproject.toml

@@ -59,7 +59,7 @@ gha-runners = [
 ]
 [tool.coverage.run]
 branch = true
-command_line = '-m pytest' # TODO? '--fail-under'
+command_line = '-m pytest'
 data_file = '.auxiliary/caches/pytest/coverage.sqlite3'
 parallel = true
 source = [ 'sources' ]
@@ -120,9 +120,9 @@ PYTHONUNBUFFERED = 'TRUE' # TODO: Only for coverage/pytest.
 [tool.hatch.envs.develop.scripts]
 docsgen = [
   """sphinx-build -E -b linkcheck -d .auxiliary/caches/sphinx \
-     documentation .auxiliary/artifacts/sphinx-linkcheck""",
+      documentation .auxiliary/artifacts/sphinx-linkcheck""",
   """sphinx-build -a -d .auxiliary/caches/sphinx \
-     documentation .auxiliary/artifacts/sphinx-html""",
+      documentation .auxiliary/artifacts/sphinx-html""",
 ]
 linters = [
   """ruff check --quiet sources documentation tests""",
@@ -135,14 +135,19 @@ packagers = [
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
 ]
+testers-documentation = [
+  """coverage run -m sphinx.cmd.build \
+      -E -b doctest -d .auxiliary/caches/sphinx \
+      documentation .auxiliary/artifacts/sphinx-doctest""",
+]
+testers-serotine = [ """coverage run -m pytest -m slow"""  ]
 testers-no-reports = [
-  'coverage erase',
   'coverage run',
-  """coverage run -m sphinx.cmd.build \
-     -E -b doctest -d .auxiliary/caches/sphinx \
-     documentation .auxiliary/artifacts/sphinx-doctest""",
+  'testers-documentation',
+  'testers-serotine',
 ]
 testers = [
+  'coverage erase',
   'testers-no-reports',
   'coverage combine',
   'coverage report --skip-covered',
@@ -184,8 +189,8 @@ strict = false
 
 # https://microsoft.github.io/pyright/#/configuration
 [tool.pyright]
-ignore = [ 'documentation', 'tests' ] # Stronger hint for language server.
-include = [ 'sources' ]
+ignore = [ '.auxiliary', 'documentation', 'tests' ] # Ignore diagnostics.
+include = [ 'sources', 'tests' ]      # Consider for operations.
 reportConstantRedefinition = true
 reportInvalidTypeVarUse = true
 reportMatchNotExhaustive = true
@@ -217,11 +222,14 @@ stubPath = 'sources/classcore/_typedecls'
 # Note: Cannot run doctests from Pytest, because Pytest tries to update '_'
 #       attribute on protected modules. Instead, we use Sphinx to run doctests.
 minversion = '8.1'
-addopts = '--capture=no --exitfirst -rfE'
+addopts = """--capture=no --exitfirst -rfE -m 'not slow'""" # TODO? '--fail-under'
 testpaths = [ 'tests' ]
 python_files = [ 'test_*.py' ]
 python_functions = [ 'test_[0-9][0-9][0-9]_*' ]
 cache_dir = '.auxiliary/caches/pytest'
+markers = [
+    "slow: long-running tests",
+]
 
 [tool.ruff]
 #builtins = [ 'ic' ]

{classcore-1.6.1 → classcore-1.8}/sources/classcore/__init__.py

@@ -62,7 +62,7 @@ from .factories import *
 
 
 __version__: __.typx.Annotated[ str, __.ddoc.Visibilities.Reveal ]
-__version__ = '1.6.1'
+__version__ = '1.8'
 
 
 standard.finalize_module(

{classcore-1.6.1 → classcore-1.8}/sources/classcore/standard/behaviors.py

@@ -272,6 +272,8 @@ def produce_class_construction_postprocessor(
             'instances_mutables', __.mutables_default )
         instances_visibles = arguments.get(
             'instances_visibles', __.visibles_default )
+        instances_ignore_init_arguments = arguments.get(
+            'instances_ignore_init_arguments', False )
         if dcls_spec and dcls_spec.get( 'kw_only_default', False ):
             from .decorators import dataclass_with_standard_behaviors
             decorator_factory = dataclass_with_standard_behaviors
@@ -289,6 +291,7 @@ def produce_class_construction_postprocessor(
                 _nomina.DeleterCore, cores[ 'deleter' ] ),
             surveyor_core = __.typx.cast(
                 _nomina.SurveyorCore, cores[ 'surveyor' ] ),
+            ignore_init_arguments = instances_ignore_init_arguments,
             mutables = instances_mutables,
             visibles = instances_visibles )
         decorators.append( decorator )
@@ -391,6 +394,7 @@ def record_class_construction_arguments(
         'instances_assigner_core',
         'instances_deleter_core',
         'instances_surveyor_core',
+        'instances_ignore_init_arguments',
         'instances_mutables', 'instances_visibles',
     ):
         if name not in arguments: continue

{classcore-1.6.1 → classcore-1.8}/sources/classcore/standard/classes.py

@@ -42,6 +42,7 @@ class ClassFactoryExtraArguments( __.typx.TypedDict, total = False ):
     instances_assigner_core: _nomina.AssignerCore
     instances_deleter_core: _nomina.DeleterCore
     instances_surveyor_core: _nomina.SurveyorCore
+    instances_ignore_init_arguments: bool
     instances_mutables: _nomina.BehaviorExclusionVerifiersOmni
     instances_visibles: _nomina.BehaviorExclusionVerifiersOmni
 

{classcore-1.6.1 → classcore-1.8}/sources/classcore/standard/decorators.py

@@ -220,15 +220,19 @@ def class_factory( # noqa: PLR0913
     return decorate
 
 
-def produce_instances_initialization_decorator( # noqa: PLR0913
+def produce_instances_inception_decorator( # noqa: PLR0913
     attributes_namer: _nomina.AttributesNamer,
     assigner_core: __.typx.Optional[ _nomina.AssignerCore ],
     deleter_core: __.typx.Optional[ _nomina.DeleterCore ],
     surveyor_core: __.typx.Optional[ _nomina.SurveyorCore ],
+    ignore_init_arguments: bool,
     mutables: _nomina.BehaviorExclusionVerifiersOmni,
     visibles: _nomina.BehaviorExclusionVerifiersOmni,
 ) -> _nomina.Decorator[ __.U ]:
-    ''' Produces decorator to inject '__init__' method into class. '''
+    ''' Produces decorator to inject '__new__' or '__init__' method.
+
+        Also handles common bookkeeping tasks.
+    '''
     cores = dict(
         instances_assigner_core = assigner_core,
         instances_deleter_core = deleter_core,
@@ -249,7 +253,6 @@ def produce_instances_initialization_decorator( # noqa: PLR0913
             core_aname = attributes_namer( 'instances', f"{core_name}_core" )
             setattr( cls, core_aname, core_function )
         behaviors: set[ str ] = set( )
-        behaviors_name = attributes_namer( 'instance', 'behaviors' )
         _behaviors.record_behavior(
             cls, attributes_namer = attributes_namer,
             level = 'instances', basename = 'mutables',
@@ -260,6 +263,66 @@ def produce_instances_initialization_decorator( # noqa: PLR0913
             level = 'instances', basename = 'visibles',
             label = _nomina.concealment_label, behaviors = behaviors,
             verifiers = visibles )
+        decorator = produce_instances_initialization_decorator(
+            attributes_namer = attributes_namer,
+            behaviors = behaviors,
+            ignore_init_arguments = ignore_init_arguments )
+        return decorator( cls )
+
+    return decorate
+
+
+# def produce_instances_construction_decorator(
+#     attributes_namer: _nomina.AttributesNamer,
+#     behaviors: __.cabc.MutableSet[ str ],
+# ) -> _nomina.Decorator[ __.U ]:
+#     ''' Produces decorator to inject '__new__' method. '''
+#     def decorate( cls_: type[ __.U ] ) -> type[ __.U ]:
+#         behaviors_name = attributes_namer( 'instance', 'behaviors' )
+#         original = cls_.__dict__.get( '__new__' )
+#
+#         if original is None:
+#
+#             def initialize_with_super(
+#                 cls: type[ __.U ],
+#                 *posargs: __.typx.Any,
+#                 **nomargs: __.typx.Any,
+#             ) -> __.U:
+#                 self = super( cls_, cls ).__new__( cls, *posargs, **nomargs )
+#                 _activate_instance_behaviors(
+#                     cls_, self, behaviors_name, behaviors )
+#                 return self
+#
+#             cls_.__new__ = initialize_with_super
+#
+#         else:
+#
+#             @__.funct.wraps( original )
+#             def initialize_with_original(
+#                 cls: type[ __.U ],
+#                 *posargs: __.typx.Any,
+#                 **nomargs: __.typx.Any,
+#             ) -> __.U:
+#                 self = original( cls, *posargs, **nomargs )
+#                 _activate_instance_behaviors(
+#                     cls_, self, behaviors_name, behaviors )
+#                 return self
+#
+#             cls_.__new__ = initialize_with_original
+#
+#         return cls_
+#
+#     return decorate
+
+
+def produce_instances_initialization_decorator(
+    attributes_namer: _nomina.AttributesNamer,
+    behaviors: __.cabc.MutableSet[ str ],
+    ignore_init_arguments: bool,
+) -> _nomina.Decorator[ __.U ]:
+    ''' Produces decorator to inject '__init__' method into class. '''
+    def decorate( cls: type[ __.U ] ) -> type[ __.U ]:
+        behaviors_name = attributes_namer( 'instance', 'behaviors' )
         original = cls.__dict__.get( '__init__' )
 
         if original is None:
@@ -267,14 +330,10 @@ def produce_instances_initialization_decorator( # noqa: PLR0913
             def initialize_with_super(
                 self: object, *posargs: __.typx.Any, **nomargs: __.typx.Any
             ) -> None:
-                super( cls, self ).__init__( *posargs, **nomargs )
-                # Only record behaviors at start of MRO.
-                if cls is not type( self ): return
-                behaviors_: set[ str ] = (
-                    _utilities.getattr0( self, behaviors_name, set( ) ) )
-                behaviors_.update( behaviors )
-                _utilities.setattr0(
-                    self, behaviors_name, frozenset( behaviors_ ) )
+                if ignore_init_arguments: super( cls, self ).__init__( )
+                else: super( cls, self ).__init__( *posargs, **nomargs )
+                _activate_instance_behaviors(
+                    cls, self, behaviors_name, behaviors )
 
             cls.__init__ = initialize_with_super
 
@@ -284,14 +343,10 @@ def produce_instances_initialization_decorator( # noqa: PLR0913
             def initialize_with_original(
                 self: object, *posargs: __.typx.Any, **nomargs: __.typx.Any
             ) -> None:
-                original( self, *posargs, **nomargs )
-                # Only record behaviors at start of MRO.
-                if cls is not type( self ): return
-                behaviors_: set[ str ] = (
-                    _utilities.getattr0( self, behaviors_name, set( ) ) )
-                behaviors_.update( behaviors )
-                _utilities.setattr0(
-                    self, behaviors_name, frozenset( behaviors_ ) )
+                if ignore_init_arguments: original( self )
+                else: original( self, *posargs, **nomargs )
+                _activate_instance_behaviors(
+                    cls, self, behaviors_name, behaviors )
 
             cls.__init__ = initialize_with_original
 
@@ -484,6 +539,7 @@ def dataclass_with_standard_behaviors( # noqa: PLR0913
     assigner_core: __.typx.Optional[ _nomina.AssignerCore ] = None,
     deleter_core: __.typx.Optional[ _nomina.DeleterCore ] = None,
     surveyor_core: __.typx.Optional[ _nomina.SurveyorCore ] = None,
+    ignore_init_arguments: bool = False,
     mutables: _nomina.BehaviorExclusionVerifiersOmni = __.mutables_default,
     visibles: _nomina.BehaviorExclusionVerifiersOmni = __.visibles_default,
 ) -> _nomina.Decorator[ __.U ]:
@@ -496,6 +552,7 @@ def dataclass_with_standard_behaviors( # noqa: PLR0913
             assigner_core = assigner_core,
             deleter_core = deleter_core,
             surveyor_core = surveyor_core,
+            ignore_init_arguments = ignore_init_arguments,
             mutables = mutables,
             visibles = visibles ) )
     preparers: _nomina.DecorationPreparers[ __.U ] = (
@@ -514,6 +571,7 @@ def with_standard_behaviors( # noqa: PLR0913
     assigner_core: __.typx.Optional[ _nomina.AssignerCore ] = None,
     deleter_core: __.typx.Optional[ _nomina.DeleterCore ] = None,
     surveyor_core: __.typx.Optional[ _nomina.SurveyorCore ] = None,
+    ignore_init_arguments: bool = False,
     mutables: _nomina.BehaviorExclusionVerifiersOmni = __.mutables_default,
     visibles: _nomina.BehaviorExclusionVerifiersOmni = __.visibles_default,
 ) -> _nomina.Decorator[ __.U ]:
@@ -525,6 +583,7 @@ def with_standard_behaviors( # noqa: PLR0913
             assigner_core = assigner_core,
             deleter_core = deleter_core,
             surveyor_core = surveyor_core,
+            ignore_init_arguments = ignore_init_arguments,
             mutables = mutables,
             visibles = visibles ) )
     preparers: _nomina.DecorationPreparers[ __.U ] = (
@@ -534,6 +593,20 @@ def with_standard_behaviors( # noqa: PLR0913
     return decoration_by( *decorators, *decorators_, preparers = preparers )
 
 
+def _activate_instance_behaviors(
+    cls: type[ __.U ],
+    self: object,
+    behaviors_name: str,
+    behaviors: __.cabc.MutableSet[ str ],
+) -> None:
+    # Only record behaviors at start of MRO.
+    if cls is not type( self ): return
+    behaviors_: set[ str ] = (
+        _utilities.getattr0( self, behaviors_name, set( ) ) )
+    behaviors_.update( behaviors )
+    _utilities.setattr0( self, behaviors_name, frozenset( behaviors_ ) )
+
+
 def _produce_instances_decoration_preparers(
     attributes_namer: _nomina.AttributesNamer,
     error_class_provider: _nomina.ErrorClassProvider,
@@ -554,17 +627,19 @@ def _produce_instances_decorators( # noqa: PLR0913
     assigner_core: __.typx.Optional[ _nomina.AssignerCore ],
     deleter_core: __.typx.Optional[ _nomina.DeleterCore ],
     surveyor_core: __.typx.Optional[ _nomina.SurveyorCore ],
+    ignore_init_arguments: bool,
     mutables: _nomina.BehaviorExclusionVerifiersOmni,
     visibles: _nomina.BehaviorExclusionVerifiersOmni,
 ) -> _nomina.Decorators[ __.U ]:
     ''' Produces standard decorators. '''
     decorators: list[ _nomina.Decorator[ __.U ] ] = [ ]
     decorators.append(
-        produce_instances_initialization_decorator(
+        produce_instances_inception_decorator(
             attributes_namer = attributes_namer,
             assigner_core = assigner_core,
             deleter_core = deleter_core,
             surveyor_core = surveyor_core,
+            ignore_init_arguments = ignore_init_arguments,
             mutables = mutables, visibles = visibles ) )
     decorators.append(
         produce_attributes_assignment_decorator(

{classcore-1.6.1 → classcore-1.8}/sources/classcore/standard/modules.py

@@ -42,6 +42,10 @@ def finalize_module( # noqa: PLR0913
     dynadoc_introspection: _nomina.DynadocIntrospectionArgument = (
         _dynadoc.dynadoc_introspection_on_package ),
     dynadoc_table: _nomina.DynadocTableArgument = __.dictproxy_empty,
+    excludes: __.typx.Annotated[
+        __.typx.Optional[ __.cabc.MutableSet[ __.types.ModuleType ] ],
+        __.ddoc.Doc( ''' Modules to exclude from reclassification. ''' ),
+    ] = None,
     recursive: __.typx.Annotated[
         bool, __.ddoc.Doc( ''' Recursively reclassify package modules? ''' )
     ] = False,
@@ -84,7 +88,7 @@ def finalize_module( # noqa: PLR0913
     _reclassify_module(
         module,
         attributes_namer = attributes_namer,
-        recursive = recursive,
+        excludes = excludes, recursive = recursive,
         replacement_class = replacement_class )
 
 
@@ -100,6 +104,10 @@ def reclassify_modules(
         __.ddoc.Doc(
             ''' Attributes namer function with which to seal class. ''' ),
     ] = __.calculate_attrname,
+    excludes: __.typx.Annotated[
+        __.typx.Optional[ __.cabc.MutableSet[ __.types.ModuleType ] ],
+        __.ddoc.Doc( ''' Modules to exclude from reclassification. ''' ),
+    ] = None,
     recursive: __.typx.Annotated[
         bool, __.ddoc.Doc( ''' Recursively reclassify package modules? ''' )
     ] = False,
@@ -123,11 +131,11 @@ def reclassify_modules(
     _reclassify_module(
         attributes,
         attributes_namer = attributes_namer,
-        recursive = recursive,
+        excludes = excludes, recursive = recursive,
         replacement_class = replacement_class )
 
 
-def _reclassify_module(
+def _reclassify_module( # noqa: C901,PLR0912
     attributes: __.typx.Annotated[
         __.cabc.Mapping[ str, __.typx.Any ] | __.types.ModuleType | str,
         __.ddoc.Doc(
@@ -138,6 +146,10 @@ def _reclassify_module(
         __.ddoc.Doc(
             ''' Attributes namer function with which to seal class. ''' ),
     ] = __.calculate_attrname,
+    excludes: __.typx.Annotated[
+        __.typx.Optional[ __.cabc.MutableSet[ __.types.ModuleType ] ],
+        __.ddoc.Doc( ''' Modules to exclude from reclassification. ''' ),
+    ] = None,
     recursive: __.typx.Annotated[
         bool, __.ddoc.Doc( ''' Recursively reclassify package modules? ''' )
     ] = False,
@@ -164,22 +176,24 @@ def _reclassify_module(
         attributes = __.sys.modules[ attributes ]
     if isinstance( attributes, __.types.ModuleType ):
         module = attributes
-        attributes = attributes.__dict__
+        if excludes and module in excludes: return
+        attributes = module.__dict__
     else: module = None
+    if excludes is None: excludes = set( )
+    if module: excludes.add( module )
     package_name = (
         attributes.get( '__package__' ) or attributes.get( '__name__' ) )
     if not package_name: return
     for value in attributes.values( ):
         if not __.inspect.ismodule( value ): continue
         if not value.__name__.startswith( f"{package_name}." ): continue
+        if isinstance( value, replacement_class ): continue
         if recursive:
             _reclassify_module(
                 value,
                 attributes_namer = attributes_namer,
-                recursive = True,
+                excludes = excludes, recursive = True,
                 replacement_class = replacement_class )
-        if isinstance( value, replacement_class ): continue
-        _seal_module( value, attributes_namer, replacement_class )
     if module and not isinstance( module, replacement_class ):
         _seal_module( module, attributes_namer, replacement_class )