classcore 1.13__tar.gz → 1.15__tar.gz

{classcore-1.13 → classcore-1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: classcore
-Version: 1.13
+Version: 1.15
 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.13 → classcore-1.15}/sources/classcore/__/nomina.py

@@ -51,13 +51,32 @@ class AttrnameCalculator:
 
         Reference implementation of the attribute namer convention:
         call instances to produce names, and consult ``is_internal_name``
-        to detect names this framework generated. Downstream packages
-        may subclass (or otherwise provide callables exposing the same
-        optional detector) to contribute their own internal names.
+        to detect names this framework generated. The package prefix is
+        construction-time configuration (default: this package):
+        downstream packages construct with their own prefix rather
+        than overriding either method, and it is read-only
+        thereafter: assignment raises, so a registered prefix cannot
+        drift. Detection consults the reserved
+        framework grammar (shape conformance, not proof of
+        generation); generation emits the class-level mangling stems
+        whose bare forms the detector does not accept. Downstream
+        callers writing conformance or drift tests can detect a
+        generated name without the private mangled-core vocabulary:
+        try the bare form first, then the form with 64 'a'
+        characters appended, which covers the two class-level
+        mangling stems the bare form never matches.
     '''
 
+    def __init__( self, package_name: str = package_name ) -> None:
+        self._package_name = package_name
+
+    @property
+    def package_name( self ) -> str:
+        ''' Package prefix this calculator generates and detects. '''
+        return self._package_name
+
     def is_internal_name( self, name: str ) -> bool:
-        prefix = f"_{package_name}_"
+        prefix = f"_{self.package_name}_"
         if not name.startswith( prefix ):
             return False
         body = name[ len( prefix ): ]
@@ -84,7 +103,7 @@ class AttrnameCalculator:
         return False
 
     def __call__( self, level: str, core: str ) -> str:
-        return f"_{package_name}_{level}_{core}_"
+        return f"_{self.package_name}_{level}_{core}_"
 
 
 calculate_attrname = AttrnameCalculator( )

{classcore-1.13 → classcore-1.15}/sources/classcore/__init__.py

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

{classcore-1.13 → classcore-1.15}/sources/classcore/nomina.py

@@ -29,8 +29,11 @@ AttributesNamer: __.typx.TypeAlias = __.typx.Annotated[
     __.ddoc.Doc(
         ''' Names attribute from level and core arguments.
 
-            Level will be one of 'class', 'instances', or 'instance'.
-            Core will be the core of the name as supplied this package.
+            Level will be one of 'class', 'classes', 'instance', or
+            'instances'. Core will be one of the framework cores
+            named in the attribute-namer grammar (mutables and
+            visibles rules, assigner, deleter, and surveyor cores,
+            and construction bookkeeping).
 
             Can be used by downstream packages to determine names of
             bookkeeping attributes assigned by this package.

{classcore-1.13 → classcore-1.15}/sources/classcore/standard/behaviors.py

@@ -185,10 +185,15 @@ def render_verifier_text( verifier: __.typx.Any, / ) -> str:
         qualified name is available. Strings do not reach this
         function; they are classified as names before rendering. A
         non-string 'pattern' attribute is not trusted as text; such
-        verifiers fall through to qualified-name rendering. Hostile
-        metadata (raising descriptors, custom '__getattribute__')
-        yields '<unrenderable>' rather than raising, so diagnostic
-        rendering never disrupts its callers.
+        verifiers fall through to qualified-name rendering, where a
+        non-string qualified name falls back to '<anonymous>' while
+        a non-string module name preserves the qualified name.
+        Hostile metadata (raising descriptors, custom
+        '__getattribute__') yields '<unrenderable>' rather than
+        raising, so diagnostic rendering never disrupts its callers.
+        The broad 'except Exception' is deliberate: rendering is
+        diagnostics, and diagnostics must never break enforcement
+        or survey paths.
 
         Note: the inspect utilities were considered and rejected here;
         they resolve modules to objects and provide no qualified-name
@@ -501,8 +506,8 @@ def _render_verifier_text( verifier: __.typx.Any, / ) -> str:
     pattern = getattr( verifier, 'pattern', None )
     if isinstance( pattern, str ): return pattern
     qualname = getattr( verifier, '__qualname__', None )
-    if qualname is None: return '<anonymous>'
+    if not isinstance( qualname, str ): return '<anonymous>'
     module = getattr( verifier, '__module__', None )
-    if module is None or '<locals>' in qualname:
+    if not isinstance( module, str ) or '<locals>' in qualname:
         return qualname
     return f"{module}.{qualname}"

{classcore-1.13 → classcore-1.15}/sources/classcore/standard/nomina.py

@@ -29,6 +29,11 @@ concealment_label = 'concealment'
 immutability_label = 'immutability'
 
 
+abc_class_mutables = __.abc_class_mutables
+typing_class_mutables = __.typing_class_mutables
+AttrnameCalculator = __.AttrnameCalculator
+
+
 BehaviorExclusionNames: __.typx.TypeAlias = __.cabc.Set[ str ]
 BehaviorExclusionNamesOmni: __.typx.TypeAlias = (
     BehaviorExclusionNames | __.typx.Literal[ '*' ] )