frigid 4.2__tar.gz → 4.4__tar.gz

frigid-4.4/.gitignore

@@ -0,0 +1,7 @@
+.env
+*.so
+.*.swp
+__pycache__/
+bugs/
+build/
+dist/

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: frigid
-Version: 4.2
+Version: 4.4
 Summary: Immutable data structures.
 Project-URL: Homepage, https://github.com/emcd/python-frigid
 Project-URL: Documentation, https://emcd.github.io/python-frigid
@@ -15,17 +15,16 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development
-Requires-Python: >=3.10
+Requires-Python: >=3.12
 Requires-Dist: absence~=1.1
-Requires-Dist: classcore~=1.4
-Requires-Dist: dynadoc~=1.2
+Requires-Dist: classcore~=1.14
+Requires-Dist: dynadoc~=1.4
 Requires-Dist: typing-extensions
 Description-Content-Type: text/x-rst
 
@@ -282,6 +281,9 @@ Other Projects by This Author 🌟
 * `python-classcore <https://github.com/emcd/python-classcore>`_ (`classcore <https://pypi.org/project/classcore/>`_ on PyPI)
 
   🏭 A Python library package which provides **foundational class factories and decorators** for providing classes with attributes immutability and concealment and other custom behaviors.
+* `python-detextive <https://github.com/emcd/python-detextive>`_ (`detextive <https://pypi.org/project/detextive/>`_ on PyPI)
+
+  🕵️ A Python library which provides consolidated text detection capabilities for reliable content analysis. Offers MIME type detection, character set detection, and line separator processing.
 * `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.
@@ -291,6 +293,9 @@ Other Projects by This Author 🌟
 * `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-librovore <https://github.com/emcd/python-librovore>`_ (`librovore <https://pypi.org/project/librovore/>`_ on PyPI)
+
+  🐲 **Documentation Search Engine** - An intelligent documentation search and extraction tool that provides both a command-line interface for humans and an MCP (Model Context Protocol) server for AI agents. Search across Sphinx and MkDocs sites with fuzzy matching, extract clean markdown content, and integrate seamlessly with AI development workflows.
 * `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.

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

@@ -251,6 +251,9 @@ Other Projects by This Author 🌟
 * `python-classcore <https://github.com/emcd/python-classcore>`_ (`classcore <https://pypi.org/project/classcore/>`_ on PyPI)
 
   🏭 A Python library package which provides **foundational class factories and decorators** for providing classes with attributes immutability and concealment and other custom behaviors.
+* `python-detextive <https://github.com/emcd/python-detextive>`_ (`detextive <https://pypi.org/project/detextive/>`_ on PyPI)
+
+  🕵️ A Python library which provides consolidated text detection capabilities for reliable content analysis. Offers MIME type detection, character set detection, and line separator processing.
 * `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.
@@ -260,6 +263,9 @@ Other Projects by This Author 🌟
 * `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-librovore <https://github.com/emcd/python-librovore>`_ (`librovore <https://pypi.org/project/librovore/>`_ on PyPI)
+
+  🐲 **Documentation Search Engine** - An intelligent documentation search and extraction tool that provides both a command-line interface for humans and an MCP (Model Context Protocol) server for AI agents. Search across Sphinx and MkDocs sites with fuzzy matching, extract clean markdown content, and integrate seamlessly with AI development workflows.
 * `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.

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

@@ -13,11 +13,11 @@ description = 'Immutable data structures.'
 dynamic = [ 'version' ]
 license = 'Apache-2.0'
 readme = { 'file' = 'README.rst', 'content-type' = 'text/x-rst' }
-requires-python = '>= 3.10'
+requires-python = '>= 3.12'
 dependencies = [
   'absence~=1.1',
-  'classcore~=1.4',
-  'dynadoc~=1.2',
+  'classcore~=1.14',
+  'dynadoc~=1.4',
   'typing-extensions',
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
@@ -28,12 +28,11 @@ classifiers = [ # https://pypi.org/classifiers
   'License :: OSI Approved :: Apache Software License',
   'Programming Language :: Python :: 3 :: Only',
   # --- BEGIN: Injected by Copier ---
-  'Programming Language :: Python :: 3.10',
-  'Programming Language :: Python :: 3.11',
   'Programming Language :: Python :: 3.12',
   'Programming Language :: Python :: 3.13',
+  'Programming Language :: Python :: 3.14',
+  'Programming Language :: Python :: 3.15',
   'Programming Language :: Python :: Implementation :: CPython',
-  'Programming Language :: Python :: Implementation :: PyPy',
   # --- END: Injected by Copier ---
   'Topic :: Software Development',
 ]
@@ -92,15 +91,16 @@ strict-naming = false
 # --- BEGIN: Injected by Copier ---
 # --- END: Injected by Copier ---
 [tool.hatch.envs.default]
-python = '3.10'
+python = '3.12'
 [tool.hatch.envs.develop]
 description = ''' Development environment. '''
+builder = true
 dependencies = [
-  'Jinja2',
   'coverage[toml]',
+  'emcd-vibe-linter~=1.0a2',
   'furo',
   'isort',
-  'packaging',
+  'myst-parser',
   'pre-commit',
   'pyright',
   'pytest',
@@ -128,13 +128,21 @@ docsgen = [
   """sphinx-build -a -d .auxiliary/caches/sphinx --quiet \
       documentation .auxiliary/artifacts/sphinx-html""",
 ]
+fragments = [
+  """python .auxiliary/scripts/validate-fragments.py""",
+]
+module-sizes = [
+  """python .auxiliary/scripts/validate-module-sizes.py""",
+]
 linters = [
   """ruff check --quiet sources documentation tests""",
+  """vibelinter check""",
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
   """isort --check-only --diff sources tests""",
-  """vulture""",
   """pyright sources""",
+  'fragments',
+  'module-sizes',
 ]
 packagers = [
   """hatch build""",
@@ -171,11 +179,10 @@ description = ''' Quality assurance environment. '''
 template = 'develop'
 [[tool.hatch.envs.qa.matrix]]
 python = [
-    '3.10',
-    '3.11',
     '3.12',
     '3.13',
-    'pypy3.10',
+    '3.14',
+    '3.15',
 ]
 [tool.hatch.version]
 path = 'sources/frigid/__init__.py'
@@ -348,6 +355,14 @@ directory = 'repair'
 name = 'Repairs'
 showcontent = true
 
+[tool.vibelinter]
+context = 3
+exclude_paths = [ '.auxiliary/**', '.venv/**', 'tests/**',  ]
+[tool.vibelinter.rules.VBL201]
+hub_patterns = [
+  '__init__.py', '__main__.py', '__.py', '__/imports.py', '__/nomina.py',
+]
+
 [tool.vulture]
 paths = [ '.auxiliary/configuration/vulturefood.py', 'sources' ]
 min_confidence = 60

frigid-4.4/sources/frigid/README.md

@@ -0,0 +1,119 @@
+# frigid
+
+Immutable data structures for Python. Provides collections and class behaviors
+that cannot be modified after creation.
+
+## Architecture
+
+Layered architecture with three tiers:
+
+```
+┌─────────────────────────────────────────────────┐
+│  Public API                                      │
+│  (Dictionary, Namespace, Object, decorators)     │
+└─────────────────────────────────────────────────┘
+                      ↓
+┌─────────────────────────────────────────────────┐
+│  Core Implementation (*/)                        │
+│  (ImmutableDictionary, type aliases, doc frags)  │
+└─────────────────────────────────────────────────┘
+                      ↓
+┌─────────────────────────────────────────────────┐
+│  Foundation Libraries                            │
+│  (classcore, dynadoc, absence)                   │
+└─────────────────────────────────────────────────┘
+```
+
+All modules follow the `__` import pattern: public modules import from
+`. import __`, which provides centralized access to external dependencies.
+
+## Modules
+
+### Public API (`sources/frigid/`)
+
+| Module | Purpose |
+|---|---|
+| `__init__.py` | Package entry point; re-exports public API |
+| `classes.py` | Metaclasses (`Class`, `Dataclass`, `AbstractBaseClass`, `Protocol*`) and decorators (`with_standard_behaviors`, `dataclass_with_standard_behaviors`) |
+| `dictionaries.py` | `Dictionary`, `ValidatorDictionary` with set operations (`\|`, `&`) |
+| `namespaces.py` | `Namespace` — like `SimpleNamespace`, but immutable |
+| `modules.py` | `Module` type and `finalize_module()` utility |
+| `sequences.py` | `one()` — single-item tuple factory |
+| `exceptions.py` | `Omniexception` → `Omnierror` → `AttributeImmutability`, `EntryImmutability`, `EntryInvalidity` |
+| `installers.py` | Utilities for installing into builtins |
+
+### Internal (`sources/frigid/__/`)
+
+| Module | Purpose |
+|---|---|
+| `imports.py` | Centralized external library imports |
+| `nomina.py` | Type aliases, type variables, `calculate_attrname()` |
+| `dictionaries.py` | `ImmutableDictionary` — core dict subclass with immutability enforcement |
+| `doctab.py` | Documentation fragments table for dynadoc |
+| `exceptions.py` | Internal exception classes |
+
+## Key Patterns
+
+**Wrapper Pattern**: `Dictionary` wraps `ImmutableDictionary` in `_data_`.
+`Namespace` uses `ImmutableDictionary` for `__dict__`.
+
+**Delegation Pattern**: Core immutability enforcement delegated to
+`classcore.standard.class_factory`. Frigid provides configuration (attribute
+naming, dynadoc, error classes) via `functools.partial`.
+
+**Behavioral Flags**: `ImmutableDictionary` uses `_behaviors_` set to track
+state. During `__init__`, immutability is not active. After `__init__`,
+`'immutability'` is added to the set and all mutations are blocked.
+
+**Template Method**: `Dictionary.with_data()` creates new instances with
+same type and validator but different data. Subclasses override to maintain
+behavior.
+
+## Data Flow
+
+### Initialization Flow
+
+Immutable objects follow a consistent initialization pattern:
+
+1. Object creation begins with `__new__`
+2. During `__init__`, attributes/entries can be freely set
+3. After `__init__` completes, protection activates via `__setattr__`/`__delattr__` overrides
+4. Subsequent modification or deletion attempts raise immutability exceptions
+
+For `ImmutableDictionary`, the `_behaviors_` set controls this: `'immutability'`
+is absent during `__init__` (mutations allowed) and added after initialization.
+
+### Dictionary Operation Flow
+
+Set operations (union, intersection) maintain immutability guarantees:
+
+1. User invokes operation: `dict1 | dict2`
+2. Operation method computes new data (checks for key conflicts on union)
+3. Method calls `with_data()` to create a new instance
+4. New instance has the same type and validator (if applicable)
+5. Returns a new immutable dictionary — originals are unchanged
+
+## Dependencies
+
+- **classcore** `~=1.11`: Class factory mechanism and attribute protection
+- **dynadoc** `~=1.4`: Dynamic documentation generation with reusable fragments
+- **absence** `~=1.1`: Sentinel for absent values (distinguishes missing from `None`)
+- **typing-extensions**: Backported typing features
+
+## Exception Hierarchy
+
+```
+Omniexception (BaseException)
+└── Omnierror (Exception)
+    ├── AttributeImmutability (+ AttributeError)
+    ├── EntryImmutability (+ TypeError)
+    ├── EntryInvalidity (+ ValueError)
+    └── ErrorProvideFailure (+ RuntimeError)
+```
+
+Dual inheritance allows catching via frigid's hierarchy or Python built-ins.
+
+## Sister Projects
+
+- **[classcore](https://github.com/emcd/python-classcore)** — Foundational class factory and behavior system. Provides the metaclass machinery, attribute protection, and concealment that frigid delegates to.
+- **[accretive](https://github.com/emcd/python-accretive)** — Grow-only data structures. Like frigid, but values can be added (never modified or removed) after creation. Useful for registries, plugin systems, and sticky-state configurations.

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

@@ -39,5 +39,6 @@ import typing_extensions as     typx
 # --- BEGIN: Injected by Copier ---
 # --- END: Injected by Copier ---
 
-
 from absence import AbsentSingleton, Absential, absent, is_absent
+# --- BEGIN: Injected by Copier ---
+# --- END: Injected by Copier ---

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

@@ -26,10 +26,17 @@
 from classcore.standard.nomina import ( # isort: skip
                             AttributesNamer,
                             BehaviorExclusionVerifiersOmni,
+                            ClassDecorator,
+                            ClassDecorators,
+                            ClassDecoratorFactory,
     DecorationPreparers as  ClassDecorationPreparers,
                             DynadocConfiguration,
+                            ModuleReclassifier,
+                            abc_class_mutables,
                             concealment_label,
                             immutability_label,
+                            is_public_identifier,
+                            typing_class_mutables,
 )
 
 from . import imports as __
@@ -45,16 +52,6 @@ ComparisonResult: __.typx.TypeAlias = bool | __.types.NotImplementedType
 NominativeArguments: __.typx.TypeAlias = __.cabc.Mapping[ str, __.typx.Any ]
 PositionalArguments: __.typx.TypeAlias = __.cabc.Sequence[ __.typx.Any ]
 
-# TODO: Import ClassDecorator aliases from 'classcore' once documentation
-#       fragments have been removed from them.
-ClassDecorator: __.typx.TypeAlias = (
-    __.cabc.Callable[ [ type[ U ] ], type[ U ] ] )
-ClassDecorators: __.typx.TypeAlias = (
-    __.cabc.Sequence[ ClassDecorator[ U ] ] )
-ClassDecoratorFactory: __.typx.TypeAlias = (
-    __.cabc.Callable[ ..., ClassDecorator[ U ] ] )
-ModuleReclassifier: __.typx.TypeAlias = __.cabc.Callable[
-    [ __.cabc.Mapping[ str, __.typx.Any ] ], None ]
 
 DictionaryNominativeArgument: __.typx.TypeAlias = __.typx.Annotated[
     V,
@@ -81,9 +78,3 @@ package_name = __name__.split( '.', maxsplit = 1 )[ 0 ]
 
 def calculate_attrname( level: str, core: str ) -> str:
     return f"_{package_name}_{level}_{core}_"
-
-
-# TODO: Import 'is_public_identifier' from 'classcore'.
-def is_public_identifier( name: str ) -> bool:
-    ''' Is Python identifier public? '''
-    return not name.startswith( '_' )

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

@@ -27,8 +27,8 @@
 
 
 from . import __
-# --- BEGIN: Injected by Copier ---
 from . import exceptions
+# --- BEGIN: Injected by Copier ---
 # --- END: Injected by Copier ---
 
 from .classes import *
@@ -40,7 +40,7 @@ from .sequences import *
 
 
 __version__: __.typx.Annotated[ str, __.ddoc.Visibilities.Reveal ]
-__version__ = '4.2'
+__version__ = '4.4'
 
 
 finalize_module( __name__, dynadoc_table = __.fragments, recursive = True )

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

@@ -26,12 +26,6 @@
 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, )
@@ -161,7 +155,7 @@ class ProtocolClass( type( __.typx.Protocol ) ):
 
 @_class_factory( )
 @__.typx.dataclass_transform( frozen_default = True, kw_only_default = True )
-class ProtocolDataclass( type( __.typx.Protocol ) ):
+class ProtocolDataclass( ProtocolClass ):
     ''' Metaclass for standard protocol dataclasses. '''
 
     _dynadoc_fragments_ = (
@@ -182,7 +176,7 @@ class ProtocolDataclass( type( __.typx.Protocol ) ):
 
 @_class_factory( )
 @__.typx.dataclass_transform( kw_only_default = True )
-class ProtocolDataclassMutable( type( __.typx.Protocol ) ):
+class ProtocolDataclassMutable( ProtocolDataclass ):
     ''' Metaclass for protocol dataclasses with mutable instances.
     '''
 
@@ -239,7 +233,7 @@ class DataclassObjectMutable( metaclass = DataclassMutable ):
 class Protocol(
     __.typx.Protocol,
     metaclass = ProtocolClass,
-    class_mutables = abc_class_mutables,
+    class_mutables = ( *__.abc_class_mutables, *__.typing_class_mutables ),
 ):
     ''' Standard base protocol class. '''
 
@@ -252,7 +246,7 @@ class Protocol(
 class ProtocolMutable(
     __.typx.Protocol,
     metaclass = ProtocolClass,
-    class_mutables = abc_class_mutables,
+    class_mutables = ( *__.abc_class_mutables, *__.typing_class_mutables ),
     instances_mutables = '*',
 ):
     ''' Base protocol class with mutable instance attributes. '''
@@ -266,7 +260,7 @@ class ProtocolMutable(
 class DataclassProtocol(
     __.typx.Protocol,
     metaclass = ProtocolDataclass,
-    class_mutables = abc_class_mutables,
+    class_mutables = ( *__.abc_class_mutables, *__.typing_class_mutables ),
 ):
     ''' Standard base protocol dataclass. '''
 
@@ -279,7 +273,7 @@ class DataclassProtocol(
 class DataclassProtocolMutable(
     __.typx.Protocol,
     metaclass = ProtocolDataclassMutable,
-    class_mutables = abc_class_mutables,
+    class_mutables = ( *__.abc_class_mutables, *__.typing_class_mutables ),
 ):
     ''' Base protocol dataclass with mutable instance attributes. '''
 

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

@@ -120,7 +120,13 @@ class _DictionaryOperations( AbstractDictionary[ __.H, __.V ] ):
 
     def __ror__( self, other: __.cabc.Mapping[ __.H, __.V ] ) -> __.typx.Self:
         if not isinstance( other, __.cabc.Mapping ): return NotImplemented
-        return self | other
+        conflicts = set( self.keys( ) ) & set( other.keys( ) )
+        if conflicts:
+            from .exceptions import EntryImmutability
+            raise EntryImmutability( next( iter( conflicts ) ) )
+        data = dict( other )
+        data.update( self )
+        return self.with_data( data )
 
     def __and__(
         self,
@@ -162,7 +168,7 @@ class _DictionaryOperations( AbstractDictionary[ __.H, __.V ] ):
 class Dictionary( # noqa: PLW1641
     _DictionaryOperations[ __.H, __.V ],
     metaclass = _classes.AbstractBaseClass,
-    class_mutables = _classes.abc_class_mutables,
+    class_mutables = __.abc_class_mutables,
 ):
     ''' Immutable dictionary. '''
 

{frigid-4.2 → frigid-4.4}/sources/frigid/namespaces.py

@@ -59,9 +59,9 @@ class Namespace( metaclass = _classes.Class ): # noqa: PLW1641
         *iterables: __.DictionaryPositionalArgument[ __.H, __.V ],
         **attributes: __.DictionaryNominativeArgument[ __.V ],
     ) -> None:
-        self.__dict__.update(
+        self.__dict__.update( # pyright: ignore
             __.ImmutableDictionary(
-                *iterables, **attributes ) ) # pyright: ignore
+                *iterables, **attributes ) )
         super( ).__init__( )
 
     def __repr__( self ) -> str:

frigid-4.2/.gitignore

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