Coverage for sources/mimeogram/__/imports.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 imports and type aliases used throughout the package. ''' 

22 

23# pylint: disable=unused-import 

24# ruff: noqa: F401 

25 

26 

27from __future__ import annotations 

28 

29import abc 

30import asyncio 

31import collections.abc as cabc 

32import enum 

33import os 

34import re 

35import sys 

36import types 

37 

38from contextlib import AsyncExitStack as ExitsAsync 

39from dataclasses import ( 

40 dataclass, 

41 field as dataclass_declare, 

42) 

43from logging import getLogger as produce_scribe 

44from pathlib import Path 

45from uuid import uuid4 

46 

47import typing_extensions as typx 

48import tyro 

49 

50from absence import Absential, absent, is_absent 

51from accretive.qaliases import AccretiveDictionary 

52from frigid.qaliases import ( 

53 ImmutableClass, 

54 ImmutableDictionary, 

55 ImmutableObject, 

56 ImmutableProtocolClass, 

57 reclassify_modules_as_immutable, 

58) 

59from platformdirs import PlatformDirs 

60 

61 

62ComparisonResult: typx.TypeAlias = bool | types.NotImplementedType 

63NominativeDictionary: typx.TypeAlias = cabc.MutableMapping[ str, typx.Any ] 

64ImmutableNominativeDictionary: typx.TypeAlias = cabc.Mapping[ str, typx.Any ] 

65 

66 

67@typx.dataclass_transform( frozen_default = True, kw_only_default = True ) 

68class ImmutableStandardDataclass( ImmutableClass ): 

69 ''' Metaclass for immutable standard dataclasses. (Typechecker hack.) ''' 

70 

71 

72@typx.dataclass_transform( frozen_default = True, kw_only_default = True ) 

73class ImmutableStandardProtocolDataclass( ImmutableProtocolClass ): 

74 ''' Metaclass for immutable standard dataclasses. (Typechecker hack.) ''' 

75 

76 

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

78simple_tyro_class = tyro.conf.configure( ) 

79standard_dataclass = dataclass( frozen = True, kw_only = True, slots = True ) 

80standard_tyro_class = tyro.conf.configure( tyro.conf.OmitArgPrefixes )