classcore 1.0__tar.gz → 1.1__tar.gz

{classcore-1.0 → classcore-1.1}/PKG-INFO

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

@@ -119,28 +119,31 @@ 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 \
+     documentation .auxiliary/artifacts/sphinx-linkcheck""",
+  """sphinx-build -a -d .auxiliary/caches/sphinx \
+     documentation .auxiliary/artifacts/sphinx-html""",
 ]
 linters = [
-  '''ruff check --quiet sources documentation tests''',
+  """ruff check --quiet sources documentation tests""",
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
-  '''pyright sources''',
+  """pyright sources""",
 ]
 packagers = [
-  '''hatch build''',
+  """hatch build""",
   # --- BEGIN: Injected by Copier ---
   # --- END: Injected by Copier ---
 ]
-testers = [
+testers-no-reports = [
   'coverage erase',
   'coverage run',
-  '''coverage run -m sphinx.cmd.build \
+  """coverage run -m sphinx.cmd.build \
      -E -b doctest -d .auxiliary/caches/sphinx \
-     documentation .auxiliary/artifacts/sphinx-doctest''',
+     documentation .auxiliary/artifacts/sphinx-doctest""",
+]
+testers = [
+  'testers-no-reports',
   'coverage combine',
   'coverage report --skip-covered',
   'coverage html',

{classcore-1.0 → classcore-1.1}/sources/classcore/__/imports.py

@@ -28,6 +28,7 @@ from __future__ import annotations
 import collections.abc as   cabc
 import dataclasses as       dcls
 import functools as         funct
+import                      hashlib
 import                      inspect
 import                      platform
 import                      re

{classcore-1.0 → classcore-1.1}/sources/classcore/__init__.py

@@ -32,7 +32,7 @@ from .decorators import *
 from .factories import *
 
 
-__version__ = '1.0'
+__version__ = '1.1'
 
 
 standard.reclassify_modules( __name__, recursive = True )

{classcore-1.0 → classcore-1.1}/sources/classcore/factories.py

@@ -58,12 +58,13 @@ def produce_class_constructor(
         # Some decorators create new classes, which invokes this method again.
         # Short-circuit to prevent recursive decoration and other tangles.
         progress_name = attributes_namer( 'class', 'in_progress' )
-        in_progress = _utilities.getattr0( cls, progress_name, False )
+        progress_name_m = _utilities.mangle_name( cls, progress_name )
+        in_progress = getattr( cls, progress_name_m, False )
         if in_progress: return cls
-        setattr( cls, progress_name, True )
+        setattr( cls, progress_name_m, True )
         for postp in postprocessors: postp( cls, decorators_ )
         cls = _decorators.apply_decorators( cls, decorators_ )
-        setattr( cls, progress_name, False )
+        setattr( cls, progress_name_m, False )
         return cls
 
     return construct
@@ -84,9 +85,10 @@ def produce_class_initializer(
         ''' Initializes class, applying hooks. '''
         superf( *posargs, **nomargs )
         progress_name = attributes_namer( 'class', 'in_progress' )
-        in_progress = _utilities.getattr0( cls, progress_name, False )
+        progress_name_m = _utilities.mangle_name( cls, progress_name )
+        in_progress = getattr( cls, progress_name_m, False )
         if in_progress: return # If non-empty, then not top-level.
-        delattr( cls, progress_name )
+        delattr( cls, progress_name_m )
         for completer in completers: completer( cls )
 
     return initialize

{classcore-1.0 → classcore-1.1}/sources/classcore/standard/behaviors.py

@@ -251,7 +251,8 @@ def produce_class_initialization_completer(
             label = concealment_label, behaviors = behaviors,
             verifiers = visibles )
         # Set behaviors attribute last since it enables enforcement.
-        setattr( cls, attributes_namer( 'class', 'behaviors' ), behaviors )
+        behaviors_name = attributes_namer( 'class', 'behaviors' )
+        _utilities.setattr0( cls, behaviors_name, frozenset( behaviors ) )
 
     return complete
 

{classcore-1.0 → classcore-1.1}/sources/classcore/standard/decorators.py

@@ -77,9 +77,10 @@ def prepare_dataclass_for_instances(
     ''' Annotates dataclass in support of instantiation machinery. '''
     annotations = __.inspect.get_annotations( cls )
     behaviors_name = attributes_namer( 'instance', 'behaviors' )
-    annotations[ behaviors_name ] = set[ str ]
+    behaviors_name_m = _utilities.mangle_name( cls, behaviors_name )
+    annotations[ behaviors_name_m ] = set[ str ]
     setattr( cls, '__annotations__', annotations ) # in case of absence
-    setattr( cls, behaviors_name, __.dcls.field( init = False ) )
+    setattr( cls, behaviors_name_m, __.dcls.field( init = False ) )
 
 
 def produce_class_factory_decorators(
@@ -137,6 +138,7 @@ def produce_instances_initialization_decorator(
         if extant is original: return cls
         behaviors: set[ str ] = set( )
         behaviors_name = attributes_namer( 'instance', 'behaviors' )
+        behaviors_name_m = _utilities.mangle_name( cls, behaviors_name )
         _behaviors.record_behavior(
             cls, attributes_namer = attributes_namer,
             level = 'instances', basename = 'mutables',
@@ -153,9 +155,9 @@ def produce_instances_initialization_decorator(
             self: object, *posargs: __.typx.Any, **nomargs: __.typx.Any
         ) -> None:
             original( self, *posargs, **nomargs )
-            behaviors_ = _utilities.getattr0( self, behaviors_name, set( ) )
-            if not behaviors_: setattr( self, behaviors_name, behaviors_ )
+            behaviors_: set[ str ] = getattr( self, behaviors_name_m, set( ) )
             behaviors_.update( behaviors )
+            setattr( self, behaviors_name_m, frozenset( behaviors_ ) )
 
         setattr( cls, initializer_name, initialize )
         cls.__init__ = initialize

{classcore-1.0 → classcore-1.1}/sources/classcore/standard/modules.py

@@ -23,6 +23,7 @@
 
 from __future__ import annotations
 
+from .. import utilities as _utilities
 from . import __
 from . import behaviors as _behaviors
 from . import classes as _classes
@@ -85,5 +86,5 @@ def _seal_module(
 ) -> None:
     behaviors = { _behaviors.concealment_label, _behaviors.immutability_label }
     behaviors_name = attributes_namer( 'instance', 'behaviors' )
-    setattr( module, behaviors_name, behaviors )
+    _utilities.setattr0( module, behaviors_name, behaviors )
     module.__class__ = Module

{classcore-1.0 → classcore-1.1}/sources/classcore/utilities.py

@@ -34,14 +34,44 @@ def describe_object( obj: object ) -> str:
 
 
 def getattr0( obj: object, name: str, default: __.typx.Any ) -> __.typx.Any:
-    ''' Returns attribute from object without inheritance. '''
-    # Inspect object dictionary directly to suppress getattr inheritance.
-    attrsdict = getattr( obj, '__dict__', { } )
-    if name in attrsdict: return attrsdict[ name ]
-    slots = getattr( obj, '__slots__', ( ) )
-    # Name may be in slots but not yet assigned.
-    if name in slots: return getattr( obj, name, default )
-    return default
+    ''' Returns private attribute from object.
+
+        Uses mangled attribute which is unique to the class.
+    '''
+    name_m = mangle_name( obj, name )
+    return getattr( obj, name_m, default )
+
+
+def delattr0( obj: object, name: str ) -> None:
+    ''' Deletes private attribute on object.
+
+        Uses mangled attribute which is unique to the class.
+    '''
+    name_m = mangle_name( obj, name )
+    delattr( obj, name_m )
+
+
+def setattr0( obj: object, name: str, value: __.typx.Any ) -> None:
+    ''' Assigns private attribute to object.
+
+        Uses mangled attribute which is unique to the class.
+    '''
+    name_m = mangle_name( obj, name )
+    setattr( obj, name_m, value )
+
+
+def mangle_name( obj: object, name: str ) -> str:
+    ''' Mangles attribute name so that it is unique.
+
+        Effectively provides name of private member attribute,
+        which is unique across class inheritance.
+    '''
+    if not __.inspect.isclass( obj ):
+        return mangle_name( type( obj ), name )
+    namehash = __.hashlib.sha256( )
+    namehash.update( qualify_class_name( obj ).encode( ) )
+    namehash_hex = namehash.hexdigest( )
+    return f"{name}_{namehash_hex}"
 
 
 def qualify_class_name( cls: type ) -> str: