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 

48# --- BEGIN: Injected by Copier --- 

49import tyro 

50# --- END: Injected by Copier --- 

51 

52from absence import Absential, absent, is_absent 

53from accretive.qaliases import AccretiveDictionary 

54from frigid.qaliases import ( 

55 ImmutableClass, 

56 ImmutableDictionary, 

57 ImmutableObject, 

58 ImmutableProtocolClass, 

59 reclassify_modules_as_immutable, 

60) 

61from platformdirs import PlatformDirs 

62 

63 

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

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

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

67 

68 

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

70class ImmutableStandardDataclass( ImmutableClass ): 

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

72 

73 

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

75class ImmutableStandardProtocolDataclass( ImmutableProtocolClass ): 

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

77 

78 

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

80simple_tyro_class = tyro.conf.configure( ) 

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

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