СДоРаз

root

awgur@undisclosed.example.com (awgur) — Wed, 24 Jun 2026 10:41:31 +0000

24.06.2026 13:38		текущий
Строка 70:		Строка 70:
	add_config(NetConfig, conf_ar)		add_config(NetConfig, conf_ar)
	</code>		</code>
		+
		+	Кроме массива можно строить словарь, если выделить некий ключевой элемент в конфигурации
		+	<code python>
		+	with ConfigFile('/etc/application.conf') as root_section:
		+	conf_ar = {}
		+	for net_section in root_sectin.get_list_section('net'):
		+	_name = net_section.get_value('name')
		+	conf_ar[_name] = NetConfig(
		+	name=_name,
		+	ip=net_section.get_value('ip')
		+	)
		+
		+	add_config(NetConfig, conf_ar)
		+	</code>
		+

	Иной работы объекты класса ''ConfigFile'' не делают.		Иной работы объекты класса ''ConfigFile'' не делают.

obj

awgur@undisclosed.example.com (awgur) — Tue, 23 Jun 2026 09:26:01 +0000

03.11.2024 16:46		текущий
Строка 4:		Строка 4:
	* ''ConfigFile'' - обрабатывает файл целиком и предоставляет интерфейс работы с конфигурацией.		* ''ConfigFile'' - обрабатывает файл целиком и предоставляет интерфейс работы с конфигурацией.
	* ''ConfigFileContent'' - обрабатывает секции файла, давая интерфейс доступа к элементам конфигурации.		* ''ConfigFileContent'' - обрабатывает секции файла, давая интерфейс доступа к элементам конфигурации.
-
-
-	====== Работа с файлом конфигурации ======
-
-	Конструктор объекта ''ConfigFile'' принимает путь к файлу конфигурации. Путь задаётся строкой и может быть относительным.
-
-	<code python>
-	conf_file = ConfigFile('/etc/application.conf')
-	</code>
-
-	Далее объект ''ConfigFileContent'' можно получить либо вызвав метод ''get()'', либо, что более предпочтительно, воспользовавшись менеджером контекста:
-
-	<code python>
-	with ConfigFile(config_file) as root_section:
-	port = root_section.get_value('port', int, 8080)
-	</code>
-
-	Особенно хорошо и лаконично получается при использовании хранилища конфигураций:
-	<code python>
-	with ConfigFile('/etc/application.conf') as root_section:
-	add_config(NetConfig, NetConfig(
-	port=root_section.get_value('port', int, 8080),
-	baseurl=root_section.get_value('baseurl', str)
-	))
-	</code>
-
-	Иной работы объекты класса ''ConfigFile'' не делают.
-
-
-	===== Работа с параметрами конфигурации =====
-
-	Как известно, файлы конфигурации в формате toml легко можно представить в виде словаря Python (либо JSON-объекта). Для работы с одним уровнем данного словаря и создан класс ''ConfigFileContent''. Он даёт API работы с параметрами на данном текущем уровне.


Строка 85:		Строка 53:
	with ConfigFile('/etc/application.conf') as root_section:		with ConfigFile('/etc/application.conf') as root_section:
	with root_section.get_section('section') as section_section:		with root_section.get_section('section') as section_section:
		+	param1 = section_section.get_value('parma1')
		+	</code>
		+
		+
		+	==== get_list_section() ====
		+
		+	Подобен ''get_section()'', но ожидает увидеть либо словарь, либо список словарей.
		+
		+	<code>
		+	obj.get_list_section(name, [mandatory])
		+	</code>
		+
		+	Возвращает: Массив объектов ''ConfigFileContent'' содержимого нижележащего уровня.
		+
		+	^ Параметр ^ Тип ^ Описание ^
		+	\| ''name'' \| ''str'' \| Имя секции, как оно задано в файле \|
		+	\| ''mandatory'' \| ''bool'' \| Является ли секция обязательной. Если да, и она отсутствует, то возбуждается исключение ''ConfigSectionNotFound''. В противном случае возвращается пустая секция, не содержащая параметров. //По умолчанию// ''True'' \|
		+
		+	Для работы с секциями можно применять менеджер контекста. Например для файла с содержимым:
		+	<code toml>
		+	[[section]]
		+	param = "value1"
		+
		+	[[section]]
		+	param = "value2"
		+	</code>
		+
		+	Можно применить следующий код:
		+	<code python>
		+	with ConfigFile('/etc/application.conf') as root_section:
		+	with root_sectin.get_list_section('section') as section_section:
		+	conf_ar = []
		+	for el in net_section:
		+	conf_ar.append(dict(
		+	param1 = el.get_value('parma1')
		+	))
		+
		+	</code>
		+
		+
		+	==== get_section_by_path() ====
		+
		+	Подобен ''get_section()'', но позволяет пройти по иерархии дальше чем на один уровень. Каждый уровень указывается отдельным параметром
		+
		+	<code>
		+	obj.get_section_by_path(name, ..., [mandatory=False])
		+	</code>
		+
		+	Возвращает: Объект ''ConfigFileContent'' содержимого нижележашего уровня.
		+
		+	^ Параметр ^ Тип ^ Описание ^
		+	\| ''name'' \| ''str'' \| Имя секции, как оно задано в файле. Параметр можно задавать несколько раз \|
		+	\| ''mandatory'' \| ''bool'' \| Является ли секция обязательной. Если да, и она отсутствует, то возбуждается исключение ''ConfigSectionNotFound''. В противном случае возвращается пустая секция, не содержащая параметров. //По умолчанию// ''True''. Задаётся ТОЛЬКО в формате ключ-значение \|
		+
		+	Для работы с секциями можно применять менеджер контекста. Например для файла с содержимым:
		+	<code toml>
		+	[section.section2]
		+	param1 = "value1"
		+	</code>
		+
		+	Можно применить следующий код:
		+	<code python>
		+	with ConfigFile('/etc/application.conf') as root_section:
		+	with root_section.get_section_by_path('section', 'section2') as section_section:
	param1 = section_section.get_value('parma1')		param1 = section_section.get_value('parma1')
	</code>		</code>

func

awgur@undisclosed.example.com (awgur) — Tue, 23 Jun 2026 08:57:13 +0000

03.11.2024 16:46		текущий
Строка 102:		Строка 102:
	\| ''conf_selector'' \| Идентификатор объекта конфигурации. См. [[#add_config]] \|		\| ''conf_selector'' \| Идентификатор объекта конфигурации. См. [[#add_config]] \|
	\| ''conf_obj'' \| Собственно объект конфигурации. См. [[#add_config]] \|		\| ''conf_obj'' \| Собственно объект конфигурации. См. [[#add_config]] \|
		+
		+
		+	===== del_config() =====
		+
		+	Удаляем конфигурацию из хранилища. Полезно для конфигурации с паролями, которая больше не нужна в приложении
		+
		+	<code>
		+	del_config(conf_selector)
		+	</code>
		+
		+	^ Параметр ^ Описание ^
		+	\| ''conf_selector'' \| Идентификатор добавленного ранее объекта конфигурации \|

api

awgur@undisclosed.example.com (awgur) — Tue, 23 Jun 2026 08:42:38 +0000

03.11.2024 16:45		текущий
Строка 74:		Строка 74:
	^ Параметр ^ Тип ^ Описание ^		^ Параметр ^ Тип ^ Описание ^
	\| ''name'' \| ''str'' \| Идентификатор таймера, если не указан, выводится не будет \|		\| ''name'' \| ''str'' \| Идентификатор таймера, если не указан, выводится не будет \|
		+
		+
		+	====== format_msg() ======
		+
		+	Создание сообщения, более дружелюбного к средствам разбора логов. Ориентир на ''victoria_logs'' и её ''unpack_logfmt''
		+
		+	<code>
		+	obj.format_msg(msg, [key = val]...)
		+	</code>
		+
		+	Возвращает: Строку, которую нужно затем отправить в лог соответствующими методами (ниже). Формат строки:
		+
		+	<code>
		+	${! MSG !} \| ${! КЛЮЧ }=${! ЗНАЧЕНИЕ !} ${! КЛЮЧ2 !}="${! ЗНАЧЕНИЕ С ПРОБЕЛАМИ !}"
		+	</code>
		+
		+
		+	^ Параметр ^ Тип ^ Описание ^
		+	\| ''msg'' \| ''str'' \| Основная строка сообщения \|
		+	\| ''key = val'' \| \| Переданные по значению элементы, которыми затем будет обогащено сообщение. Пар ключ-значение может быть сколько угодно \|
		+
		+

authelia_helper

awgur@undisclosed.example.com (awgur) — Wed, 15 Oct 2025 14:29:09 +0000

09.11.2024 17:09		текущий
Строка 38:		Строка 38:
	\| ''header_email'' \| ''str'' \| ''Remote-Email'' \| Имя заголовка c e-mail пользователя \|		\| ''header_email'' \| ''str'' \| ''Remote-Email'' \| Имя заголовка c e-mail пользователя \|
	\| ''header_name'' \| ''str'' \| ''Remote-Name'' \| Имя заголовка с именем пользователя \|		\| ''header_name'' \| ''str'' \| ''Remote-Name'' \| Имя заголовка с именем пользователя \|
		+	\| ''fake_auth'' \| ''bool'' \| ''False'' \| Включение режима подставной авторизации \|
		+
		+	Режим подставной авторизации, который включается параметром ''fake_auth'', создан для выполнения предварительной разработки приложения в целом (на этапе преальфа). На данном этапе АРМ разработчика может быть не оснащена ПО ''Authelia'', и во избежание дополнительных не контролируемых решений конкретного программиста данной проблемы с возможным появлением уязвимостей, и добавлен этот режим. В данном режиме объект пользователя имеет предопределённое значение:
		+	* ''uname'': ''//__UNK__//''
		+	* ''name'': ''//John Doe//''
		+	* ''email'': ''//devnull@localhost.localdomain//''
		+
		+	Группы в этом режиме не назначаются и являются пустым массивом.

root

awgur@undisclosed.example.com (awgur) — Sun, 27 Jul 2025 07:04:03 +0000

23.12.2024 23:19		текущий
Строка 1:		Строка 1:
	^ Наименование ^ Описание ^		^ Наименование ^ Описание ^
-	\| [[.:freebsd.common\|FreeBSD общий]] \| Дополнительные элементы для мониторинга ''FreeBSD'' \|	+	\| [[.:freebsd.common2\|FreeBSD общий]] \| Дополнительные элементы для мониторинга ''FreeBSD'', несколько переработанные \|
-	\| [[.:freebsd.common2\|FreeBSD общий, второе поколение]] \| Дополнительные элементы для мониторинга ''FreeBSD'', несколько переработанные \|	+
	\| [[https://s3.fs.a0fs.ru/dist/config/zabbix/www-angie.yaml\|Шаблон Angie]] \| Предельно грубая адаптация шаблона под Nginx на шаблон под [[https://angie.software/\|Angie]] \|		\| [[https://s3.fs.a0fs.ru/dist/config/zabbix/www-angie.yaml\|Шаблон Angie]] \| Предельно грубая адаптация шаблона под Nginx на шаблон под [[https://angie.software/\|Angie]] \|

btle_tools

awgur@undisclosed.example.com (awgur) — Sat, 12 Jul 2025 12:17:26 +0000

02.11.2024 20:08		текущий
Строка 16:		Строка 16:
	Получение реального адреса клиента.		Получение реального адреса клиента.

-	Пытается получить адрес клиента из специальной переменной реверс-прокси. В случае неудачи, берёт IP узла, откуда пришёл запрос.	+	Пытается получить адрес клиента из специальной переменной реверс-прокси ''X-Real-IP''. В случае неудачи, берёт IP узла, откуда пришёл запрос.

-	Проверки на установку IP доверенным источником не производится. Поскольку приложения не выставляются наружу без прикрытия ''nginx'', который можно соответственно настроить, это не считается проблемой.	+	Проверки на установку IP доверенным источником не производится. Поскольку приложения не выставляются наружу без прикрытия ''nginx'', который можно соответственно настроить. Это не считается проблемой.

	<code>		<code>
Строка 162:		Строка 162:
	</code>		</code>

-	Возвращает: Строку, которую можно использовать для инициализации [[lib.py:aw_log:api\|объекта лога]]	+	Возвращает: Строку, которую можно использовать для инициализации [[lib.py:aw_log:api\|объекта лога]]. Строка представляет собой:
		+	<code bash>
		+	${USER}[${IP} \| ${REQ_ID} \| ${CONN_ID}] - ${URL}
		+	</code>
		+	Где:
		+	* ''${USER}'' - Переданное имя пользователя или ''_NOUID_'' если ничего передано не было.
		+	* ''${IP}'' - Результат работы функции [[#get_client_ip\|get_client_ip()]].
		+	* ''${REQ_ID}'' - Значение заголовка ''REQ_ID_HEADER'', если он имеется. В противном случае ничего не подставляется и не выводится разделитель.
		+	* ''${CONN_ID}'' - Значение заголовка ''CONN_ID_HEADER'', если он имеется. В противном случае ничего не подставляется и не выводится разделитель.
		+	* ''${URL}'' - Путь переданный в запросе.

simple_template_helper

awgur@undisclosed.example.com (awgur) — Sat, 12 Jul 2025 09:24:09 +0000

12.07.2025 12:23		текущий
Строка 45:		Строка 45:
	Вместо объекта создаётся фабрика объектов, при каждом вызове которой инициализируется новый объект.		Вместо объекта создаётся фабрика объектов, при каждом вызове которой инициализируется новый объект.

-	Помогает в работе над шаблонами. В частности препятствует кешированию и способствует перечитыванию файла с шаблоном на каждом вызове данного шаблона в коде	+	Помогает в работе над шаблонами. В частности, препятствует кешированию и способствует перечитыванию файла с шаблоном на каждом вызове данного шаблона в коде

	^ Параметр ^ Тип ^ Описание ^		^ Параметр ^ Тип ^ Описание ^

freebsd.common2

awgur@undisclosed.example.com (awgur) — Sun, 01 Jun 2025 09:16:40 +0000

24.01.2025 22:04		текущий
Строка 13:		Строка 13:
	</code>		</code>
	- Активировать конфигурацию экземпляра: <code bash>cp /opt/aw.fbsd-mon-helper/config.dist.sh /opt/aw.fbsd-mon-helper/config.sh</code>		- Активировать конфигурацию экземпляра: <code bash>cp /opt/aw.fbsd-mon-helper/config.dist.sh /opt/aw.fbsd-mon-helper/config.sh</code>
-	- Прописать в ''crontab(5)'' запуск инструмента: <code bash>${Случайное число от 0 до 59} /2 * * /bin/sh /opt/aw.fbsd-mon-helper/bin/lounch.sh</code> Естественно вместо ''${Случайное число от 0 до 59}'' требуется придумать число	+	- Прописать в ''crontab(5)'' запуск инструмента: <code bash>/15 * * * /bin/sh /opt/aw.fbsd-mon-helper/bin/lounch.sh</code> Естественно вместо ''${Случайное число от 0 до 59}'' требуется придумать число
	- Загрузить конфигурацию ''syslog'': <code bash>fetch -ao \		- Загрузить конфигурацию ''syslog'': <code bash>fetch -ao \
	/etc/syslog.d/warnmsg.conf \		/etc/syslog.d/warnmsg.conf \