Coverage for sources/ictruck/__/nomina.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''' Common names and type aliases. ''' 

22 

23 

24from . import imports as __ 

25 

26 

27H = __.typx.TypeVar( 'H', bound = __.cabc.Hashable ) # Hash Key 

28V = __.typx.TypeVar( 'V' ) # Value 

29 

30 

31ComparisonResult: __.typx.TypeAlias = bool | __.types.NotImplementedType 

32NominativeArguments: __.typx.TypeAlias = __.cabc.Mapping[ str, __.typx.Any ] 

33PositionalArguments: __.typx.TypeAlias = __.cabc.Sequence[ __.typx.Any ] 

34 

35 

36DictionaryNominativeArgument: __.typx.TypeAlias = __.typx.Annotated[ 

37 V, 

38 __.ddoc.Doc( 

39 'Zero or more keyword arguments from which to initialize ' 

40 'dictionary data.' ), 

41] 

42DictionaryPositionalArgument: __.typx.TypeAlias = __.typx.Annotated[ 

43 __.cabc.Mapping[ H, V ] | __.cabc.Iterable[ tuple[ H, V ] ], 

44 __.ddoc.Doc( 

45 'Zero or more iterables from which to initialize dictionary data. ' 

46 'Each iterable must be dictionary or sequence of key-value pairs. ' 

47 'Duplicate keys will result in an error.' ), 

48] 

49ExceptionInfo: __.typx.TypeAlias = tuple[ 

50 type[ BaseException ] | None, 

51 BaseException | None, 

52 __.types.TracebackType | None ] 

53 

54 

55package_name = __name__.split( '.', maxsplit = 1 )[ 0 ]