Coverage for sources/accretive/__/doctab.py: 100%

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''' Docstrings table for reuse across entities. ''' 

22 

23 

24from . import imports as __ 

25 

26 

27fragments: __.cabc.Mapping[ str, str ] = __.types.MappingProxyType( { 

28 

29 'cfc class accrete': 

30 ''' By default, accretes class attributes. ''', 

31 

32 'cfc class conceal': 

33 ''' By default, conceals non-public class attributes. ''', 

34 

35 'cfc class protect': 

36 ''' By default, protects class attributes. ''', 

37 

38 'cfc dynadoc': ''' Applies Dynadoc decoration to classes. ''', 

39 

40 'cfc instance accrete': 

41 ''' Produces classes which can accrete instance attributes. ''', 

42 

43 'cfc instance conceal': 

44 ''' Produces classes which can conceal instance attributes. ''', 

45 

46 'cfc instance protect': 

47 ''' Produces classes which can protect instance attributes. ''', 

48 

49 'cfc produce abstract base class': 

50 ''' Produces abstract base classes compatible with :py:class:`abc.ABCMeta`. 

51 ''', 

52 

53 'cfc produce dataclass': 

54 ''' Produces inheritable dataclasses with keyword-only instantiation. ''', 

55 

56 'cfc produce protocol class': 

57 ''' Produces :pep:`544` protocol classes. ''', 

58 

59 'class accretion': 

60 ''' By default, class attributes are accretive. ''', 

61 

62 'class concealment': 

63 ''' By default, non-public class attributes are invisible. ''', 

64 

65 'class protection': 

66 ''' By default, class attributes are immutable. ''', 

67 

68 'class instance accrete': 

69 ''' By default, accretes instance attributes. ''', 

70 

71 'class instance conceal': 

72 ''' By default, conceals non-public instance attributes. ''', 

73 

74 'class instance protect': 

75 ''' By default, protects instance attributes. ''', 

76 

77 'dataclass': 

78 ''' Inheritable dataclass with keyword-only instantiation. ''', 

79 

80 'protocol class': 

81 ''' Protocol class (:pep:`544`). Nominal and structural subtyping. ''', 

82 

83 'class dynadoc': ''' Is decorated by Dynadoc. ''', 

84 

85 'dictionary entries accrete': ''' Accretes dictionary entries. ''', 

86 

87 'dictionary entries produce': 

88 ''' Produces default entries on attempt to access absent ones. ''', 

89 

90 'dictionary entries validate': 

91 ''' Validates dictionary entries on initialization. ''', 

92 

93 'module': 

94 ''' Python module class, derived from :py:class:`types.ModuleType`. ''', 

95 

96 'module accrete': 

97 ''' By default, accrets module attributes. ''', 

98 

99 'module conceal': 

100 ''' By default, conceals non-public module attributes. ''', 

101 

102 'namespace': 

103 ''' Namespace object, modeled after :py:class:`types.SimpleNamespace. ''', 

104 

105} )