classcore 1.14__tar.gz → 1.15__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: classcore
-Version: 1.14
+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.14 → 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.14 → classcore-1.15}/sources/classcore/__init__.py

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

{classcore-1.14 → 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.14 → classcore-1.15}/sources/classcore/standard/nomina.py

@@ -31,6 +31,7 @@ immutability_label = 'immutability'
 
 abc_class_mutables = __.abc_class_mutables
 typing_class_mutables = __.typing_class_mutables
+AttrnameCalculator = __.AttrnameCalculator
 
 
 BehaviorExclusionNames: __.typx.TypeAlias = __.cabc.Set[ str ]