Coverage for sources / ictr / exceptions.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''' Family of exceptions for package API. ''' 

22 

23 

24from . import __ 

25 

26 

27class Omniexception( __.immut.exceptions.Omniexception ): 

28 ''' Base for all exceptions raised by package API. ''' 

29 

30 

31class Omnierror( Omniexception, Exception ): 

32 ''' Base for error exceptions raised by package API. ''' 

33 

34 

35class ArgumentClassInvalidity( Omnierror, TypeError ): 

36 ''' Argument class is invalid. ''' 

37 

38 def __init__( self, name: str, classes: type | tuple[ type, ... ] ): 

39 if isinstance( classes, type ): classes = ( classes, ) 

40 cnames = ' | '.join( map( 

41 lambda cls: f"{cls.__module__}.{cls.__qualname__}", classes ) ) 

42 super( ).__init__( 

43 f"Argument {name!r} must be an instance of {cnames}." ) 

44 

45 

46class AttributeNondisplacement( Omnierror, AttributeError ): 

47 ''' Cannot displace existing attribute. ''' 

48 

49 def __init__( self, object_: __.typx.Any, name: str ): 

50 super( ).__init__( 

51 f"Cannot displace attribute {name!r} on: {object_}" ) 

52 

53 

54class ContentMisclassification( Omnierror, TypeError ): 

55 ''' Record content type is invalid or unsupported. ''' 

56 

57 def __init__( self, class_: type ): 

58 super( ).__init__( 

59 f"Unsupported record content type: {class_.__name__}" ) 

60 

61 

62class FlavorInavailability( Omnierror, ValueError ): 

63 ''' Requested flavor is not available. ''' 

64 

65 def __init__( self, flavor: int | str ): 

66 super( ).__init__( f"Flavor {flavor!r} is not available." ) 

67 

68 

69class FlavorMisclassification( Omnierror, TypeError ): 

70 ''' Flavor type is invalid for the requested operation. ''' 

71 

72 def __init__( self, flavor: int | str, expectation: str ): 

73 super( ).__init__( 

74 f"Expected {expectation} flavor, got {type( flavor ).__name__}: " 

75 f"{flavor!r}" ) 

76 

77 

78class ModuleInferenceFailure( Omnierror, RuntimeError ): 

79 ''' Failure to infer invoking module from call stack. ''' 

80 

81 def __init__( self ): 

82 super( ).__init__( "Could not infer invoking module from call stack." ) 

83 

84 

85class SummaryLinearizationFailure( Omnierror, RuntimeError ): 

86 ''' Failure to linearize summary. ''' 

87 

88 def __init__( self ): 

89 super( ).__init__( "Summary linearization produced no lines." )