classcore 1.7__tar.gz → 1.9__tar.gz

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

@@ -2,10 +2,14 @@
 .claude
 .gemini
 .mcp.json
+.opencode
 .*.swp
 AGENTS.md
 CLAUDE.md
 CONVENTIONS.md
 GEMINI.md
+opencode.jsonc
 __pycache__/
 bugs/
+build/
+dist/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classcore
-Version: 1.7
+Version: 1.9
 Summary: Foundational class factories and decorators.
 Project-URL: Homepage, https://github.com/emcd/python-classcore
 Project-URL: Documentation, https://emcd.github.io/python-classcore
@@ -237,7 +237,7 @@ 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>`_
+Additional Indicia
 ===============================================================================
 
 .. image:: https://img.shields.io/github/last-commit/emcd/python-classcore

{classcore-1.7 → classcore-1.9}/README.rst

@@ -208,7 +208,7 @@ 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>`_
+Additional Indicia
 ===============================================================================
 
 .. image:: https://img.shields.io/github/last-commit/emcd/python-classcore

{classcore-1.7 → classcore-1.9}/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' ]
@@ -97,6 +97,7 @@ dependencies = [
   'Jinja2',
   'coverage[toml]',
   'furo',
+  'isort',
   'packaging',
   'pre-commit',
   'pyright',
@@ -106,6 +107,7 @@ dependencies = [
   'sphinx-copybutton',
   'sphinx-inline-tabs',
   'towncrier',
+  'vulture',
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
 ]
@@ -119,15 +121,17 @@ PYTHONUNBUFFERED = 'TRUE' # TODO: Only for coverage/pytest.
 # --- END: Injected by Copier ---
 [tool.hatch.envs.develop.scripts]
 docsgen = [
-  """sphinx-build -E -b linkcheck -d .auxiliary/caches/sphinx \
-     documentation .auxiliary/artifacts/sphinx-linkcheck""",
-  """sphinx-build -a -d .auxiliary/caches/sphinx \
-     documentation .auxiliary/artifacts/sphinx-html""",
+  """sphinx-build -E -b linkcheck -d .auxiliary/caches/sphinx --quiet \
+      documentation .auxiliary/artifacts/sphinx-linkcheck""",
+  """sphinx-build -a -d .auxiliary/caches/sphinx --quiet \
+      documentation .auxiliary/artifacts/sphinx-html""",
 ]
 linters = [
   """ruff check --quiet sources documentation tests""",
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
+  """isort --check-only --diff sources tests""",
+  """vulture""",
   """pyright sources""",
 ]
 packagers = [
@@ -135,14 +139,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 --quiet \
+      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',
@@ -171,6 +180,25 @@ python = [
 [tool.hatch.version]
 path = 'sources/classcore/__init__.py'
 
+# https://pycqa.github.io/isort/docs/configuration/config_files.html
+[tool.isort]
+# profile = 'black'
+src_paths = [ 'sources', 'tests' ]
+case_sensitive = true
+# ensure_newline_before_comments = true
+# force_sort_within_sections = true
+ignore_whitespace = true
+include_trailing_comma = true
+known_first_party = [ 'classcore' ]
+lines_between_types = 1
+line_length = 79
+multi_line_output = 3
+quiet = true
+# skip_gitignore = true
+skip_glob = [ '*/__/imports.py', '*/__init__.py' ]
+split_on_trailing_comma = true
+use_parentheses = true
+
 # https://mypy.readthedocs.io/en/stable/config_file.html
 [tool.mypy]
 # Note: Due to repeated painful experiences with Mypy, we use Pyright instead.
@@ -184,8 +212,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,15 +245,19 @@ 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 --quiet -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' ]
 cache-dir = '.auxiliary/caches/ruff'
+extend-exclude = [ 'vulturefood.py' ]
 indent-width = 4
 line-length = 79
 [tool.ruff.lint]
@@ -315,3 +347,12 @@ showcontent = true
 directory = 'repair'
 name = 'Repairs'
 showcontent = true
+
+[tool.vulture]
+paths = [ '.auxiliary/configuration/vulturefood.py', 'sources' ]
+min_confidence = 60
+exclude = [
+  '*/imports.py',
+]
+ignore_decorators = [ '@__.abc.abstractmethod', '@__.typx.overload' ]
+ignore_names = [ 'main' ]

{classcore-1.7 → classcore-1.9}/sources/classcore/__init__.py

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

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

{classcore-1.7 → classcore-1.9}/sources/classcore/standard/nomina.py

@@ -22,9 +22,8 @@
 # ruff: noqa: F403,F405
 
 
-from . import __
 from ..nomina import *
-
+from . import __
 
 concealment_label = 'concealment'
 immutability_label = 'immutability'

{classcore-1.7 → classcore-1.9}/sources/classcore/utilities.py

@@ -114,7 +114,7 @@ def qualify_class_name( cls: type ) -> str:
 def repair_class_reproduction( original: type, reproduction: type ) -> None:
     ''' Repairs a class reproduction, if necessary. '''
     match __.platform.python_implementation( ):
-        case 'CPython':  # pragma: no branch
+        case 'CPython' | 'PyPy':  # pragma: no branch
             _repair_cpython_class_closures( original, reproduction )
         case _: pass  # pragma: no cover