classcore 1.8__tar.gz → 1.10__tar.gz

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classcore
-Version: 1.8
+Version: 1.10
 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.8 → classcore-1.10}/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.8 → classcore-1.10}/pyproject.toml

@@ -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 \
+  """sphinx-build -E -b linkcheck -d .auxiliary/caches/sphinx --quiet \
       documentation .auxiliary/artifacts/sphinx-linkcheck""",
-  """sphinx-build -a -d .auxiliary/caches/sphinx \
+  """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 = [
@@ -137,7 +141,7 @@ packagers = [
 ]
 testers-documentation = [
   """coverage run -m sphinx.cmd.build \
-      -E -b doctest -d .auxiliary/caches/sphinx \
+      -E -b doctest -d .auxiliary/caches/sphinx --quiet \
       documentation .auxiliary/artifacts/sphinx-doctest""",
 ]
 testers-serotine = [ """coverage run -m pytest -m slow"""  ]
@@ -176,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.
@@ -222,7 +245,7 @@ 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 -m 'not slow'""" # TODO? '--fail-under'
+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]_*' ]
@@ -234,6 +257,7 @@ markers = [
 [tool.ruff]
 #builtins = [ 'ic' ]
 cache-dir = '.auxiliary/caches/ruff'
+extend-exclude = [ 'vulturefood.py' ]
 indent-width = 4
 line-length = 79
 [tool.ruff.lint]
@@ -323,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.8 → classcore-1.10}/sources/classcore/__init__.py

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

{classcore-1.8 → classcore-1.10}/sources/classcore/exceptions.py

@@ -22,12 +22,20 @@
 
 
 from . import __
+from . import nomina as _nomina
 from . import standard as _standard
 
 
+exception_mutables_default = (
+    '__cause__', '__context__', '__suppress_context__', '__traceback__' )
+exception_visibles_default = (
+    *exception_mutables_default, _nomina.is_public_identifier )
+
+
 class Omniexception(
     _standard.Object, BaseException,
-    instances_visibles = ( '__cause__', '__context__' ),
+    instances_mutables = exception_mutables_default,
+    instances_visibles = exception_visibles_default,
 ):
     ''' Base exception for package. '''
 

{classcore-1.8 → classcore-1.10}/sources/classcore/nomina.py

@@ -204,3 +204,8 @@ ClassInitializer: __.typx.TypeAlias = __.typx.Annotated[
     ],
     __.ddoc.Doc( ''' Initializer to use with metaclass. ''' ),
 ]
+
+
+def is_public_identifier( name: str ) -> bool:
+    ''' Is Python identifier public? '''
+    return not name.startswith( '_' )

{classcore-1.8 → classcore-1.10}/sources/classcore/standard/__.py

@@ -20,13 +20,11 @@
 
 ''' Common constants, imports, and utilities. '''
 
+# ruff: noqa: F403
 
-from ..__ import * # noqa: F403
 
-
-def is_public_identifier( name: str ) -> bool:
-    ''' Is Python identifier public? '''
-    return not name.startswith( '_' )
+from ..__ import *
+from ..nomina import is_public_identifier
 
 
 def provide_error_class( name: str ) -> type[ Exception ]:

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

@@ -205,7 +205,16 @@ class DataclassObjectMutable( metaclass = DataclassMutable ):
         'class instance conceal' )
 
 
-class Protocol( __.typx.Protocol, metaclass = ProtocolClass ):
+class Protocol(
+    __.typx.Protocol,
+    metaclass = ProtocolClass,
+    class_mutables = (
+        '_abc_cache',
+        '_abc_negative_cache',
+        '_abc_negative_cache_version',
+        '_abc_registry',
+    ),
+):
     ''' Standard base protocol class. '''
 
     _dynadoc_fragments_ = (
@@ -215,7 +224,15 @@ class Protocol( __.typx.Protocol, metaclass = ProtocolClass ):
 
 
 class ProtocolMutable(
-    __.typx.Protocol, metaclass = ProtocolClass, instances_mutables = '*'
+    __.typx.Protocol,
+    metaclass = ProtocolClass,
+    class_mutables = (
+        '_abc_cache',
+        '_abc_negative_cache',
+        '_abc_negative_cache_version',
+        '_abc_registry',
+    ),
+    instances_mutables = '*',
 ):
     ''' Base protocol class with mutable instance attributes. '''
 
@@ -226,7 +243,14 @@ class ProtocolMutable(
 
 
 class DataclassProtocol(
-    __.typx.Protocol, metaclass = ProtocolDataclass,
+    __.typx.Protocol,
+    metaclass = ProtocolDataclass,
+    class_mutables = (
+        '_abc_cache',
+        '_abc_negative_cache',
+        '_abc_negative_cache_version',
+        '_abc_registry',
+    ),
 ):
     ''' Standard base protocol dataclass. '''
 
@@ -237,7 +261,14 @@ class DataclassProtocol(
 
 
 class DataclassProtocolMutable(
-    __.typx.Protocol, metaclass = ProtocolDataclassMutable,
+    __.typx.Protocol,
+    metaclass = ProtocolDataclassMutable,
+    class_mutables = (
+        '_abc_cache',
+        '_abc_negative_cache',
+        '_abc_negative_cache_version',
+        '_abc_registry',
+    ),
 ):
     ''' Base protocol dataclass with mutable instance attributes. '''
 

{classcore-1.8 → classcore-1.10}/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.8 → classcore-1.10}/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