frigid 4.1__tar.gz → 4.2__tar.gz

{frigid-4.1 → frigid-4.2}/.gitignore

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

{frigid-4.1 → frigid-4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frigid
-Version: 4.1
+Version: 4.2
 Summary: Immutable data structures.
 Project-URL: Homepage, https://github.com/emcd/python-frigid
 Project-URL: Documentation, https://emcd.github.io/python-frigid
@@ -106,6 +106,18 @@ Key Features ⭐
 Installation 📦
 ===============================================================================
 
+Method: Install Python Package
+-------------------------------------------------------------------------------
+
+Install via `uv <https://github.com/astral-sh/uv/blob/main/README.md>`_ ``pip``
+command:
+
+::
+
+    uv pip install frigid
+
+Or, install via ``pip``:
+
 ::
 
     pip install frigid
@@ -204,7 +216,24 @@ Use Cases 🎯
   complete immutability guarantees.
 
 
-`More Flair <https://www.imdb.com/title/tt0151804/characters/nm0431918>`_
+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-frigid/issues>`_ or submit `pull
+requests <https://github.com/emcd/python-frigid/pulls>`_ to
+improve the source code or documentation.
+
+For development guidance and standards, please see the `development guide
+<https://emcd.github.io/python-frigid/stable/sphinx-html/contribution.html#development>`_.
+
+
+Additional Indicia
 ===============================================================================
 
 .. image:: https://img.shields.io/github/last-commit/emcd/python-frigid

{frigid-4.1 → frigid-4.2}/README.rst

@@ -75,6 +75,18 @@ Key Features ⭐
 Installation 📦
 ===============================================================================
 
+Method: Install Python Package
+-------------------------------------------------------------------------------
+
+Install via `uv <https://github.com/astral-sh/uv/blob/main/README.md>`_ ``pip``
+command:
+
+::
+
+    uv pip install frigid
+
+Or, install via ``pip``:
+
 ::
 
     pip install frigid
@@ -173,7 +185,24 @@ Use Cases 🎯
   complete immutability guarantees.
 
 
-`More Flair <https://www.imdb.com/title/tt0151804/characters/nm0431918>`_
+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-frigid/issues>`_ or submit `pull
+requests <https://github.com/emcd/python-frigid/pulls>`_ to
+improve the source code or documentation.
+
+For development guidance and standards, please see the `development guide
+<https://emcd.github.io/python-frigid/stable/sphinx-html/contribution.html#development>`_.
+
+
+Additional Indicia
 ===============================================================================
 
 .. image:: https://img.shields.io/github/last-commit/emcd/python-frigid

{frigid-4.1 → frigid-4.2}/pyproject.toml

@@ -61,7 +61,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' ]
@@ -99,6 +99,7 @@ dependencies = [
   'Jinja2',
   'coverage[toml]',
   'furo',
+  'isort',
   'packaging',
   'pre-commit',
   'pyright',
@@ -108,6 +109,7 @@ dependencies = [
   'sphinx-copybutton',
   'sphinx-inline-tabs',
   'towncrier',
+  'vulture',
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
 ]
@@ -121,15 +123,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 = [
@@ -137,14 +141,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/frigid/__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 = [ 'frigid' ]
+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,16 +245,19 @@ stubPath = 'sources/frigid/_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'
-filterwarnings = [ 'ignore::DeprecationWarning' ]
+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]
@@ -316,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' ]

{frigid-4.1 → frigid-4.2}/sources/frigid/__/__init__.py

@@ -25,11 +25,3 @@ from .dictionaries import *
 from .doctab import *
 from .imports import *
 from .nomina import *
-
-
-dynadoc_introspection_limiter = (
-    ccstd.dynadoc.produce_dynadoc_introspection_limiter(
-        attributes_namer = calculate_attrname ) )
-dynadoc_introspection_control_on_class = (
-    ccstd.dynadoc.produce_dynadoc_introspection_control(
-        limiters = ( dynadoc_introspection_limiter, ) ) )

{frigid-4.1 → frigid-4.2}/sources/frigid/__/imports.py

@@ -31,6 +31,7 @@ import                          inspect
 import                          sys
 import                          types
 
+import classcore.exceptions as  ccexc
 import classcore.standard as    ccstd
 import classcore.utilities as   ccutils
 import dynadoc as               ddoc

{frigid-4.1 → frigid-4.2}/sources/frigid/__/nomina.py

@@ -23,7 +23,7 @@
 # ruff: noqa: F401
 
 
-from classcore.standard.nomina import (
+from classcore.standard.nomina import ( # isort: skip
                             AttributesNamer,
                             BehaviorExclusionVerifiersOmni,
     DecorationPreparers as  ClassDecorationPreparers,

{frigid-4.1 → frigid-4.2}/sources/frigid/__init__.py

@@ -40,7 +40,7 @@ from .sequences import *
 
 
 __version__: __.typx.Annotated[ str, __.ddoc.Visibilities.Reveal ]
-__version__ = '4.1'
+__version__ = '4.2'
 
 
 finalize_module( __name__, dynadoc_table = __.fragments, recursive = True )

{frigid-4.1 → frigid-4.2}/sources/frigid/classes.py

@@ -26,6 +26,12 @@
 from . import __
 
 
+abc_class_mutables = (
+    '_abc_cache',
+    '_abc_negative_cache',
+    '_abc_negative_cache_version',
+    '_abc_registry',
+)
 is_public_identifier = __.is_public_identifier
 mutables_default = ( )
 visibles_default = ( is_public_identifier, )
@@ -44,9 +50,7 @@ def _provide_error_class( name: str ) -> type[ Exception ]:
 
 _dataclass_core = __.dcls.dataclass( kw_only = True, slots = True )
 _dynadoc_configuration = (
-    __.ccstd.dynadoc.produce_dynadoc_configuration(
-        introspection = __.dynadoc_introspection_control_on_class,
-        table = __.fragments ) )
+    __.ccstd.dynadoc.produce_dynadoc_configuration( table = __.fragments ) )
 _class_factory = __.funct.partial(
     __.ccstd.class_factory,
     attributes_namer = __.calculate_attrname,
@@ -232,7 +236,11 @@ class DataclassObjectMutable( metaclass = DataclassMutable ):
         'class instance conceal' )
 
 
-class Protocol( __.typx.Protocol, metaclass = ProtocolClass ):
+class Protocol(
+    __.typx.Protocol,
+    metaclass = ProtocolClass,
+    class_mutables = abc_class_mutables,
+):
     ''' Standard base protocol class. '''
 
     _dynadoc_fragments_ = (
@@ -242,7 +250,10 @@ class Protocol( __.typx.Protocol, metaclass = ProtocolClass ):
 
 
 class ProtocolMutable(
-    __.typx.Protocol, metaclass = ProtocolClass, instances_mutables = '*'
+    __.typx.Protocol,
+    metaclass = ProtocolClass,
+    class_mutables = abc_class_mutables,
+    instances_mutables = '*',
 ):
     ''' Base protocol class with mutable instance attributes. '''
 
@@ -253,7 +264,9 @@ class ProtocolMutable(
 
 
 class DataclassProtocol(
-    __.typx.Protocol, metaclass = ProtocolDataclass,
+    __.typx.Protocol,
+    metaclass = ProtocolDataclass,
+    class_mutables = abc_class_mutables,
 ):
     ''' Standard base protocol dataclass. '''
 
@@ -264,7 +277,9 @@ class DataclassProtocol(
 
 
 class DataclassProtocolMutable(
-    __.typx.Protocol, metaclass = ProtocolDataclassMutable,
+    __.typx.Protocol,
+    metaclass = ProtocolDataclassMutable,
+    class_mutables = abc_class_mutables,
 ):
     ''' Base protocol dataclass with mutable instance attributes. '''
 

{frigid-4.1 → frigid-4.2}/sources/frigid/dictionaries.py

@@ -162,6 +162,7 @@ class _DictionaryOperations( AbstractDictionary[ __.H, __.V ] ):
 class Dictionary( # noqa: PLW1641
     _DictionaryOperations[ __.H, __.V ],
     metaclass = _classes.AbstractBaseClass,
+    class_mutables = _classes.abc_class_mutables,
 ):
     ''' Immutable dictionary. '''
 

{frigid-4.1 → frigid-4.2}/sources/frigid/exceptions.py

@@ -32,8 +32,8 @@ from . import classes as _classes
 
 class Omniexception(
     _classes.Object, BaseException,
-    instances_visibles = (
-        '__cause__', '__context__', _classes.is_public_identifier ),
+    instances_mutables = __.ccexc.exception_mutables_default,
+    instances_visibles = __.ccexc.exception_visibles_default,
 ):
     ''' Base exceptions for package. '''
 

{frigid-4.1 → frigid-4.2}/sources/frigid/modules.py

@@ -130,4 +130,5 @@ def reclassify_modules(
     __.ccstd.reclassify_modules(
         module,
         attributes_namer = __.calculate_attrname,
+        recursive = recursive,
         replacement_class = Module )