Coverage for sources/classcore/factories.py: 100%

36 statements  

« prev     ^ index     » next       coverage.py v7.16.2, created at 2026-10-16 06:16 +0000

1# vim: set filetype=python fileencoding=utf-8: 

2# -*- coding: utf-8 -*- 

3 

4#============================================================================# 

5# # 

6# Licensed under the Apache License, Version 2.0 (the "License"); # 

7# you may not use this file except in compliance with the License. # 

8# You may obtain a copy of the License at # 

9# # 

10# http://www.apache.org/licenses/LICENSE-2.0 # 

11# # 

12# Unless required by applicable law or agreed to in writing, software # 

13# distributed under the License is distributed on an "AS IS" BASIS, # 

14# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # 

15# See the License for the specific language governing permissions and # 

16# limitations under the License. # 

17# # 

18#============================================================================# 

19 

20 

21''' Factories which produce metaclass implementations. ''' 

22 

23 

24from . import __ 

25from . import decorators as _decorators 

26from . import nomina as _nomina 

27from . import utilities as _utilities 

28 

29 

30def produce_class_constructor( 

31 attributes_namer: _nomina.AttributesNamer, 

32 preprocessors: _nomina.ClassConstructionPreprocessors[ __.T ] = ( ), 

33 postprocessors: _nomina.ClassConstructionPostprocessors[ __.T ] = ( ), 

34) -> _nomina.ClassConstructor[ __.T ]: 

35 ''' Produces constructors for classes. ''' 

36 

37 def construct( # noqa: PLR0913, PLR0917 

38 clscls: type[ __.T ], 

39 superf: _nomina.ClassConstructorLigation, 

40 name: str, 

41 bases: tuple[ type, ... ], 

42 namespace: dict[ str, __.typx.Any ], 

43 arguments: __.NominativeArguments, 

44 decorators: _nomina.Decorators[ __.T ], 

45 ) -> type: 

46 ''' Constructs class, applying decorators and hooks. ''' 

47 bases_ = list( bases ) 

48 arguments_ = dict( arguments ) 

49 decorators_ = list( decorators ) 

50 for preprocessor in preprocessors: 

51 preprocessor( 

52 clscls, name, bases_, namespace, arguments_, decorators_ ) 

53 cls = superf( clscls, name, tuple( bases_ ), namespace, **arguments_ ) 

54 # Some decorators create new classes, which invokes this method again. 

55 # Short-circuit to prevent recursive decoration and other tangles. 

56 progress_name = attributes_namer( 'class', 'in_progress' ) 

57 progress_names = _utilities.survey_mangled_names( cls, progress_name ) 

58 in_progress = any( 

59 getattr( cls, key, False ) for key in progress_names ) 

60 if in_progress: return cls 

61 progress_name_m = _utilities.mangle_name( cls, progress_name ) 

62 setattr( cls, progress_name_m, True ) 

63 for postprocessor in postprocessors: postprocessor( cls, decorators_ ) 

64 cls = _decorators.apply_decorators( cls, decorators_ ) 

65 # Decoration may have replaced the class. Clear every marker 

66 # variant, including ones inherited from the original namespace, 

67 # so initialization completes regardless of qualname restoration. 

68 progress_names = _utilities.survey_mangled_names( cls, progress_name ) 

69 for progress_name_ in progress_names: 

70 setattr( cls, progress_name_, False ) 

71 setattr( cls, progress_name_m, False ) 

72 return cls 

73 

74 return construct 

75 

76 

77def produce_class_initializer( 

78 attributes_namer: _nomina.AttributesNamer, 

79 completers: _nomina.ClassInitializationCompleters = ( ), 

80) -> _nomina.ClassInitializer: 

81 ''' Produces initializers for classes. ''' 

82 

83 def initialize( 

84 cls: type, 

85 superf: _nomina.InitializerLigation, 

86 posargs: __.PositionalArguments, 

87 nomargs: __.NominativeArguments, 

88 ) -> None: 

89 ''' Initializes class, applying hooks. ''' 

90 superf( *posargs, **nomargs ) 

91 progress_name = attributes_namer( 'class', 'in_progress' ) 

92 progress_names = _utilities.survey_mangled_names( cls, progress_name ) 

93 in_progress = any( 

94 getattr( cls, key, False ) for key in progress_names ) 

95 if in_progress: return # If non-empty, then not top-level. 

96 for progress_name_m in progress_names: delattr( cls, progress_name_m ) 

97 for completer in completers: completer( cls ) 

98 

99 return initialize