Покрытие кода docstrings

2025-10-14 11:42:57 +05:00 · 2025-10-14 11:42:57 +05:00 · 8f48df2cf5
commit 8f48df2cf5
parent 4e92aba2a2
19 changed files with 2324 additions and 1839 deletions
--- a/SRV/services/ufw_service.py
+++ b/SRV/services/ufw_service.py
@ -8,9 +8,16 @@ DEBUG = True


 class UFWService:
-    """
-    Сервис для взаимодействия с утилитой UFW (Uncomplicated Firewall) в Linux.
-    Позволяет получить список правил UFW и управлять ими.
+    """Сервис взаимодействия с UFW (Uncomplicated Firewall).
+
+    Назначение:
+        - Чтение статуса и списка правил брандмауэра.
+        - Добавление, удаление и массовая обработка правил с поддержкой диапазонов портов,
+          комментариев и выбором протоколов.
+
+    Детали реализации:
+        - Команды выполняются через `sudo ufw ...`; вывод парсится в модели pydantic.
+        - Для операций удаления соблюдается порядок с конца, чтобы не нарушать нумерацию.
    """

    def _run_command(self, command: str) -> str: