py.lib.aw_config

Yohn Y. 2026-06-23 Parent:34b98b38a9f0

18:ee8fb73df434 Go to Latest

py.lib.aw_config/src/aw_config/app_config_manager.py

.. 0.202606.3 . При формировании имени секции учитываем возможность появления там точек

Download raw file
View source Diff to previous Annotate
History
1 # coding: utf-8
2 """\
3 Пробуем упростить работу с объектами конфигурации при работе с приложениями.
4 """
5 from threading import Lock
6 from typing import Optional, Dict
7
8 from .error import Error
9
10
11 class AppConfManagerError(Error):
12 """\
13 Базовый класс ошибок работы с хранилищем конфигураций
14 """
15
16
17 class AppConfNotFound(AppConfManagerError):
18 """\
19 Исключение, возникающее когда в хранилище не найдена нужная конфигурация
20 """
21
22
23 _CONFIG: Optional[Dict] = None
24 _CONFIG_GUARD = Lock()
25
26
27 def init_configs():
28 """\
29 Инициализируем хранилище конфигураций
30 """
31 global _CONFIG
32 with _CONFIG_GUARD:
33 if _CONFIG is None:
34 _CONFIG = {}
35
36
37 def add_config(conf_selector, conf_obj):
38 """\
39 Добавляет в хранилище объект конфигурации. Затем его можно извлечь по селектору. Удобно указывать
40 в качестве такого селектора класс, объектом которого является данный объект конфигурации
41 """
42 global _CONFIG
43 with _CONFIG_GUARD:
44 if _CONFIG is None:
45 raise AppConfManagerError(f'При попытке добавить конфигурацию "{conf_selector}" в хранилище '
46 f'оказалось, что оно не инициализировано')
47
48 if conf_selector in _CONFIG:
49 raise AppConfManagerError(f'Селектор "{conf_selector}" дублируется.')
50
51 _CONFIG[conf_selector] = conf_obj
52
53
54 def replace_config(conf_selector, conf_obj):
55 """\
56 Заменяем добавленный ранее объект конфигурации
57 """
58 global _CONFIG
59 with _CONFIG_GUARD:
60 if _CONFIG is None:
61 raise AppConfManagerError(f'При попытке заменить конфигурацию "{conf_selector}" в хранилище '
62 f'оказалось, что оно не инициализировано')
63
64 elif conf_selector in _CONFIG:
65 _CONFIG[conf_selector] = conf_obj
66
67 else:
68 raise AppConfManagerError(f'Не найдена предыдущая конфигурация "{conf_selector}" при попытке её замены')
69
70
71 def del_config(conf_selector):
72 """\
73 Удаляет добавленный ранее объект конфигурации
74 """
75 global _CONFIG
76 with _CONFIG_GUARD:
77 if _CONFIG is None:
78 raise AppConfManagerError(f'При попытке заменить конфигурацию "{conf_selector}" в хранилище '
79 f'оказалось, что оно не инициализировано')
80
81 elif conf_selector in _CONFIG:
82 del _CONFIG[conf_selector]
83
84
85 def get_config(conf_selector):
86 """\
87 Получаем из хранилища добавленный ранее объект конфигурации по селектору.
88 """
89 if _CONFIG is None:
90 raise AppConfManagerError('Попытка работать с неинициализированным хранилищем конфигураций')
91
92 else:
93 try:
94 return _CONFIG[conf_selector]
95
96 except KeyError:
97 raise AppConfNotFound(f'Не найдена конфигурация "{conf_selector}" в хранилище')
98
99 except (ValueError, TypeError) as e:
100 raise AppConfManagerError(f'Ошибка получения конфигурации "{conf_selector}" из хранилища: {e}')