classcore 1.7__tar.gz → 1.8__tar.gz

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

@@ -9,3 +9,4 @@ CONVENTIONS.md
 GEMINI.md
 __pycache__/
 bugs/
+build/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classcore
-Version: 1.7
+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

{classcore-1.7 → 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.7 → classcore-1.8}/sources/classcore/__init__.py

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

{classcore-1.7 → 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 )