Coverage for sources/frigid/__/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 internals. ''' 

22 

23 

24from __future__ import annotations 

25 

26from . import imports as __ 

27from . import immutables as _immutables 

28 

29 

30class Omniexception( _immutables.ImmutableObject, BaseException ): 

31 ''' Base for all exceptions raised internally. ''' 

32 

33 _attribute_visibility_includes_: __.cabc.Collection[ str ] = ( 

34 frozenset( ( '__cause__', '__context__', ) ) ) 

35 

36 

37class Omnierror( Omniexception, Exception ): 

38 ''' Base for error exceptions raised internally. ''' 

39 

40 

41class EntryImmutabilityError( Omnierror, TypeError ): 

42 ''' Attempt to update or remove immutable dictionary entry. ''' 

43 

44 def __init__( self, indicator: __.cabc.Hashable ) -> None: 

45 super( ).__init__( 

46 f"Cannot alter or remove existing entry for {indicator!r}." ) 

47 

48 

49class OperationInvalidity( Omnierror, RuntimeError, TypeError ): 

50 ''' Attempt to perform invalid operation. ''' 

51 

52 def __init__( self, name: str ) -> None: 

53 super( ).__init__( f"Operation {name!r} is not valid on this object." )