Coverage for sources/emcdproj/__/state.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''' Immutable global state. ''' 

22 

23 

24from . import imports as __ 

25from . import application as _application 

26from . import distribution as _distribution 

27 

28 

29# class DirectorySpecies( __.enum.Enum ): # TODO: Python 3.11: StrEnum 

30# ''' Possible species for locations. ''' 

31# 

32# Cache = 'cache' 

33# Data = 'data' 

34# State = 'state' 

35 

36 

37class Globals( metaclass = __.ImmutableDataclass ): 

38 ''' Immutable global data. Required by some library functions. ''' 

39 

40 application: _application.Information 

41 # configuration: __.AccretiveDictionary[ str, __.typx.Any ] 

42 directories: __.PlatformDirs 

43 distribution: _distribution.Information 

44 exits: __.ctxl.AsyncExitStack 

45 

46 def as_dictionary( self ) -> __.cabc.Mapping[ str, __.typx.Any ]: 

47 ''' Returns shallow copy of state. ''' 

48 from dataclasses import fields 

49 return { 

50 field.name: getattr( self, field.name ) 

51 for field in fields( self ) } 

52 

53 # def provide_cache_location( self, *appendages: str ) -> __.Path: 

54 # ''' Provides cache location from configuration. ''' 

55 # return self.provide_location( DirectorySpecies.Cache, *appendages ) 

56 

57 # def provide_data_location( self, *appendages: str ) -> __.Path: 

58 # ''' Provides data location from configuration. ''' 

59 # return self.provide_location( DirectorySpecies.Data, *appendages ) 

60 

61 # def provide_state_location( self, *appendages: str ) -> __.Path: 

62 # ''' Provides state location from configuration. ''' 

63 # return self.provide_location( DirectorySpecies.State, *appendages ) 

64 

65 # def provide_location( 

66 # self, species: DirectorySpecies, *appendages: str 

67 # ) -> __.Path: 

68 # ''' Provides particular species of location from configuration. ''' 

69 # species_name = species.value 

70 # base = getattr( self.directories, f"user_{species_name}_path" ) 

71 # spec = self.configuration.get( 'locations', { } ).get( species_name ) 

72 # if spec: 

73 # args: dict[ str, str | __.Path ] = { 

74 # f"user_{species_name}": base, 

75 # 'user_home': __.Path.home( ), 

76 # 'application_name': self.application.name, 

77 # } 

78 # base = __.Path( spec.format( **args ) ) 

79 # if appendages: return base.joinpath( *appendages ) 

80 # return base