From e264750187340e4121632c3dd8b4fffeb9e7600d Mon Sep 17 00:00:00 2001 From: Merelden Date: Tue, 21 Oct 2025 09:20:50 +0500 Subject: [PATCH] Unicode repair --- SRV/api/router.py | 6 +++--- SRV/config/cors.py | 2 +- SRV/core/cli_executor.py | 2 +- SRV/docs/_build/html/_modules/config/cors.html | 2 +- .../_build/html/_modules/core/cli_executor.html | 2 +- .../_build/html/_modules/services/arp_service.html | 6 +++--- .../html/_modules/services/connect_service.html | 4 ++-- .../html/_modules/services/firewalld_service.html | 2 +- .../_build/html/_modules/services/ip_service.html | 4 ++-- .../html/_modules/services/network_service.html | 8 ++++---- .../html/_modules/services/subnet_service.html | 14 +++++++------- .../html/_modules/services/wifi_service.html | 4 ++-- .../_build/html/_modules/storage/json_storage.html | 2 +- .../html/_modules/storage/session_storage.html | 2 +- SRV/docs/_build/html/_modules/utils/i18n.html | 4 ++-- SRV/docs/_build/html/api/config/cors.html | 2 +- SRV/docs/_build/html/api/core/cli_executor.html | 2 +- SRV/docs/_build/html/api/services/arp_service.html | 6 +++--- .../_build/html/api/services/connect_service.html | 4 ++-- .../html/api/services/firewalld_service.html | 2 +- SRV/docs/_build/html/api/services/ip_service.html | 4 ++-- .../_build/html/api/services/network_service.html | 8 ++++---- .../_build/html/api/services/subnet_service.html | 14 +++++++------- .../_build/html/api/services/wifi_service.html | 4 ++-- SRV/docs/_build/html/api/storage/json_storage.html | 2 +- .../_build/html/api/storage/session_storage.html | 2 +- SRV/docs/_build/html/api/utils/i18n.html | 4 ++-- SRV/docs/_build/markdown/api/config/cors.md | 2 +- SRV/docs/_build/markdown/api/core/cli_executor.md | 2 +- .../_build/markdown/api/services/arp_service.md | 6 +++--- .../markdown/api/services/connect_service.md | 4 ++-- .../markdown/api/services/firewalld_service.md | 2 +- .../_build/markdown/api/services/ip_service.md | 4 ++-- .../markdown/api/services/network_service.md | 6 +++--- .../_build/markdown/api/services/subnet_service.md | 12 ++++++------ .../_build/markdown/api/services/wifi_service.md | 4 ++-- .../_build/markdown/api/storage/json_storage.md | 2 +- .../_build/markdown/api/storage/session_storage.md | 2 +- SRV/docs/_build/markdown/api/utils/i18n.md | 4 ++-- SRV/services/arp_service.py | 6 +++--- SRV/services/connect_service.py | 4 ++-- SRV/services/firewalld_service.py | 2 +- SRV/services/ip_service.py | 4 ++-- SRV/services/network_service.py | 6 +++--- SRV/services/subnet_service.py | 12 ++++++------ SRV/services/wifi_service.py | 4 ++-- SRV/storage/json_storage.py | 2 +- SRV/storage/session_storage.py | 2 +- SRV/utils/i18n.py | 4 ++-- 49 files changed, 107 insertions(+), 107 deletions(-) diff --git a/SRV/api/router.py b/SRV/api/router.py index 6588e93..a168d73 100644 --- a/SRV/api/router.py +++ b/SRV/api/router.py @@ -12,11 +12,11 @@ управление позициями UI-контейнеров. - `/auth` (Auth): регистрация, аутентификация (JWT), сессии. - `/subnet` (Subnet): сканирование подсетей, заметки к устройствам, - взаимодействие с Wi‑Fi (скан/подключение/отключение/статус). + взаимодействие с Wi-Fi (скан/подключение/отключение/статус). - `WebSocket`: обработчики взаимодействия по WS (без префикса, путь внутри модуля), периодическая трансляция сетевых данных. - - `/settings` (Settings): сервисные операции над локальными JSON‑хранилищами - (очистка данных подсетей/wi‑fi и пр.). + - `/settings` (Settings): сервисные операции над локальными JSON-хранилищами + (очистка данных подсетей/wi-fi и пр.). Назначение: - Централизованная точка подключения доменных роутеров к приложению. diff --git a/SRV/config/cors.py b/SRV/config/cors.py index 0834483..cb06f19 100644 --- a/SRV/config/cors.py +++ b/SRV/config/cors.py @@ -3,7 +3,7 @@ Модуль инкапсулирует добавление middleware `CORSMiddleware` со списком разрешённых источников (origins), характерных для локальной разработки и -типовых портов фронтенда (например, Vite/React на 5173/5174, dev‑серверы). +типовых портов фронтенда (например, Vite/React на 5173/5174, dev-серверы). Использование: cors_config = CORSMiddlewareConfig(app) diff --git a/SRV/core/cli_executor.py b/SRV/core/cli_executor.py index 420a1da..19d10a1 100644 --- a/SRV/core/cli_executor.py +++ b/SRV/core/cli_executor.py @@ -3,7 +3,7 @@ from typing import Tuple class CLIExecutor: - """Утилита для безопасного выполнения CLI‑команд. + """Утилита для безопасного выполнения CLI-команд. Назначение: Инкапсулирует вызов `subprocess.run` и приводит результат к удобному diff --git a/SRV/docs/_build/html/_modules/config/cors.html b/SRV/docs/_build/html/_modules/config/cors.html index 2089b55..5288c7d 100644 --- a/SRV/docs/_build/html/_modules/config/cors.html +++ b/SRV/docs/_build/html/_modules/config/cors.html @@ -280,7 +280,7 @@ Модуль инкапсулирует добавление middleware `CORSMiddleware` со списком разрешённых источников (origins), характерных для локальной разработки и -типовых портов фронтенда (например, Vite/React на 5173/5174, dev‑серверы). +типовых портов фронтенда (например, Vite/React на 5173/5174, dev-серверы). Использование: cors_config = CORSMiddlewareConfig(app) diff --git a/SRV/docs/_build/html/_modules/core/cli_executor.html b/SRV/docs/_build/html/_modules/core/cli_executor.html index 9d805c7..90456d7 100644 --- a/SRV/docs/_build/html/_modules/core/cli_executor.html +++ b/SRV/docs/_build/html/_modules/core/cli_executor.html @@ -282,7 +282,7 @@
[docs] class CLIExecutor: - """Утилита для безопасного выполнения CLI‑команд. + """Утилита для безопасного выполнения CLI-команд. Назначение: Инкапсулирует вызов `subprocess.run` и приводит результат к удобному diff --git a/SRV/docs/_build/html/_modules/services/arp_service.html b/SRV/docs/_build/html/_modules/services/arp_service.html index 55816eb..266ec4a 100644 --- a/SRV/docs/_build/html/_modules/services/arp_service.html +++ b/SRV/docs/_build/html/_modules/services/arp_service.html @@ -280,18 +280,18 @@ Назначение: -- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP‑запросов от имени выбранного интерфейса. +- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP-запросов от имени выбранного интерфейса. - Помощь сервисам более высокого уровня (например, IPService) при проверке занятости адресов перед применением конфигураций. Особенности реализации: - Определяет подключённые сети интерфейса через `netifaces` и строит CIDR для сканирования. -- Формирует ARP‑пакеты с помощью `scapy` (Ether/ARP) и отправляет их с таймаутом. +- Формирует ARP-пакеты с помощью `scapy` (Ether/ARP) и отправляет их с таймаутом. - Добавляет локальный адрес интерфейса в результирующий список клиентов. Требования/ограничения: -- Для отправки ARP‑кадров могут потребоваться повышенные привилегии или capability на сырой сокет. +- Для отправки ARP-кадров могут потребоваться повышенные привилегии или capability на сырой сокет. """ from fastapi import Depends from scapy.layers.l2 import ARP, Ether diff --git a/SRV/docs/_build/html/_modules/services/connect_service.html b/SRV/docs/_build/html/_modules/services/connect_service.html index ac82525..625af53 100644 --- a/SRV/docs/_build/html/_modules/services/connect_service.html +++ b/SRV/docs/_build/html/_modules/services/connect_service.html @@ -276,7 +276,7 @@

Source code for services.connect_service

 """
-Сервис управления подключениями Wi‑Fi через `nmcli`.
+Сервис управления подключениями Wi-Fi через `nmcli`.
 
 Назначение:
 
@@ -284,7 +284,7 @@
 
 Поведение:
 
-- Автоматически определяет активный Wi‑Fi‑интерфейс.
+- Автоматически определяет активный Wi-Fi-интерфейс.
 - Валидирует наличие SSID в листинге перед подключением и интерпретирует частые ошибки `nmcli` (неверный пароль, отсутствующая сеть и т.п.).
 
 Ограничения:
diff --git a/SRV/docs/_build/html/_modules/services/firewalld_service.html b/SRV/docs/_build/html/_modules/services/firewalld_service.html
index 905309f..498bfa9 100644
--- a/SRV/docs/_build/html/_modules/services/firewalld_service.html
+++ b/SRV/docs/_build/html/_modules/services/firewalld_service.html
@@ -276,7 +276,7 @@
         

Source code for services.firewalld_service

 """
-Сервис для управления firewalld через D‑Bus.
+Сервис для управления firewalld через D-Bus.
 
 Назначение:
 - Обёртка над интерфейсами `org.fedoraproject.FirewallD1` для выполнения
diff --git a/SRV/docs/_build/html/_modules/services/ip_service.html b/SRV/docs/_build/html/_modules/services/ip_service.html
index 45ae784..991df10 100644
--- a/SRV/docs/_build/html/_modules/services/ip_service.html
+++ b/SRV/docs/_build/html/_modules/services/ip_service.html
@@ -276,7 +276,7 @@
         

Source code for services.ip_service

 """
-Сервис проверки и применения IP‑настроек через NetworkManager (D‑Bus).
+Сервис проверки и применения IP-настроек через NetworkManager (D-Bus).
 
 Назначение:
 - Перед применением конфигурации проверяет занятость IP адреса, сканируя сегмент
@@ -285,7 +285,7 @@
   выполняет переподключение интерфейса.
 
 Требования/ограничения:
-- Доступ к системной шине D‑Bus и права на изменения сетевых профилей.
+- Доступ к системной шине D-Bus и права на изменения сетевых профилей.
 - Структура входных данных должна соответствовать схеме `ipv4_updates` для
   корректного обновления вложенных полей у профиля.
 """
diff --git a/SRV/docs/_build/html/_modules/services/network_service.html b/SRV/docs/_build/html/_modules/services/network_service.html
index 40d3045..0a79a74 100644
--- a/SRV/docs/_build/html/_modules/services/network_service.html
+++ b/SRV/docs/_build/html/_modules/services/network_service.html
@@ -276,16 +276,16 @@
         

Source code for services.network_service

 """
-Сервис чтения сетевого состояния через NetworkManager (D‑Bus).
+Сервис чтения сетевого состояния через NetworkManager (D-Bus).
 
 Назначение:
 - Предоставляет асинхронные методы для сборки унифицированных моделей
-  сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения
-  имени хоста. Используется API‑слоем для визуализации и управления.
+  сетевых интерфейсов (Ethernet/Wi-Fi), их IP-конфигураций, а также получения
+  имени хоста. Используется API-слоем для визуализации и управления.
 
 Особенности:
 - Фильтрация loopback и явно неактивных интерфейсов.
-- Адаптация данных D‑Bus в pydantic‑модели (`NetworkInterface`, `WiFiDevice`,
+- Адаптация данных D-Bus в pydantic-модели (`NetworkInterface`, `WiFiDevice`,
   `NetworkInterfacesContainer`).
 """
 from typing import List, Dict, Tuple, Union, Optional
diff --git a/SRV/docs/_build/html/_modules/services/subnet_service.html b/SRV/docs/_build/html/_modules/services/subnet_service.html
index c37b763..03c03b3 100644
--- a/SRV/docs/_build/html/_modules/services/subnet_service.html
+++ b/SRV/docs/_build/html/_modules/services/subnet_service.html
@@ -328,7 +328,7 @@
 
     Назначение:
         Обнаруживает активные устройства в локальной сети, отправляя широковещательные
-        ARP‑запросы по указанной подсети и собирая ответы (IP, MAC).
+        ARP-запросы по указанной подсети и собирая ответы (IP, MAC).
 
     Детали реализации:
         - Использует `scapy` (`Ether` + `ARP`) для генерации пакетов и `srp` для
@@ -393,7 +393,7 @@
     """Класс для сканирования открытых портов на устройствах.
 
     Назначение:
-        Плейсхолдер для будущего функционала активного сканирования TCP/UDP‑портов
+        Плейсхолдер для будущего функционала активного сканирования TCP/UDP-портов
         у обнаруженных узлов. В текущей версии возвращает пустой список.
 
     План развития:
@@ -438,7 +438,7 @@
     Источники данных:
         - MacLookup: сопоставление префикса MAC (OUI) с названием производителя.
         - DNS: `gethostbyaddr` с малым таймаутом для обратного разрешения имени.
-        - NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS‑имён.
+        - NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS-имён.
 
     Политика кэширования:
         - Результаты `get_vendor` кэшируются с помощью `functools.lru_cache`.
@@ -552,13 +552,13 @@
     """Класс для хранения и управления данными об устройствах.
 
     Формат файла подсети:
-        JSON‑структура вида
+        JSON-структура вида
         {
           "devices": [Device, ...]
         }
 
     Политика очистки:
-        - Метод `_clean_old_devices` удаляет оффлайн‑устройства, не наблюдавшиеся
+        - Метод `_clean_old_devices` удаляет оффлайн-устройства, не наблюдавшиеся
           более 7 дней, чтобы поддерживать актуальность списка.
     """
     def __init__(self, base_path: str = "storage/subnets", translations: Translations = None):
@@ -699,8 +699,8 @@
         1) Определение подсети (вручную или авто по интерфейсу).
         2) Загрузка ранее сохранённых устройств подсети.
         3) Добавление локального устройства (если принадлежит подсети).
-        4) ARP‑сканирование и параллельная обработка узлов (обогащение данных).
-        5) Маркировка оффлайн‑узлов из кэша, не встреченных в текущем скане.
+        4) ARP-сканирование и параллельная обработка узлов (обогащение данных).
+        5) Маркировка оффлайн-узлов из кэша, не встреченных в текущем скане.
         6) Сортировка по IP и сохранение объединённого списка в JSON.
     """
     def __init__(self, translations: Translations):
diff --git a/SRV/docs/_build/html/_modules/services/wifi_service.html b/SRV/docs/_build/html/_modules/services/wifi_service.html
index d5798fb..2d432f8 100644
--- a/SRV/docs/_build/html/_modules/services/wifi_service.html
+++ b/SRV/docs/_build/html/_modules/services/wifi_service.html
@@ -300,7 +300,7 @@
 
[docs] class WifiStorage: - """Класс для хранения данных о Wi‑Fi сетях и их заметках по SSID. + """Класс для хранения данных о Wi-Fi сетях и их заметках по SSID. Формат: { @@ -359,7 +359,7 @@
[docs] class WifiService: - """Сервис для сканирования текущих Wi‑Fi точек доступа и заметок. + """Сервис для сканирования текущих Wi-Fi точек доступа и заметок. Источники данных: - `pywifi` для базового сканирования и получения списка AP. diff --git a/SRV/docs/_build/html/_modules/storage/json_storage.html b/SRV/docs/_build/html/_modules/storage/json_storage.html index 7ebd5f4..8c24acc 100644 --- a/SRV/docs/_build/html/_modules/storage/json_storage.html +++ b/SRV/docs/_build/html/_modules/storage/json_storage.html @@ -296,7 +296,7 @@ где важна минимальная зависимость от внешних сервисов. Формат данных: - JSON‑структура вида: + JSON-структура вида: { "users": [ {"id": int, "username": str, "password_hash": str, "is_admin": bool}, diff --git a/SRV/docs/_build/html/_modules/storage/session_storage.html b/SRV/docs/_build/html/_modules/storage/session_storage.html index dfdcc72..1f63918 100644 --- a/SRV/docs/_build/html/_modules/storage/session_storage.html +++ b/SRV/docs/_build/html/_modules/storage/session_storage.html @@ -293,7 +293,7 @@ Назначение: Лёгкое файловое хранилище для сессионных токенов, сопоставленных с `client_id` (например, IP клиента). Предназначено для сред без БД и - persistent‑кэшей. Обеспечивает базовые операции и авто‑очистку протухших + persistent-кэшей. Обеспечивает базовые операции и авто-очистку протухших сессий. Формат данных: diff --git a/SRV/docs/_build/html/_modules/utils/i18n.html b/SRV/docs/_build/html/_modules/utils/i18n.html index 71583d5..c2cd81c 100644 --- a/SRV/docs/_build/html/_modules/utils/i18n.html +++ b/SRV/docs/_build/html/_modules/utils/i18n.html @@ -280,8 +280,8 @@ Содержимое модуля: - `get_translations()`: фабрика зависимости FastAPI, считывающая локаль из - query‑параметра `locale`, cookie `locale` или заголовка `Accept-Language` - (по приоритету), с дефолтом `ru`. Возвращает функцию‑зависимость, которая + query-параметра `locale`, cookie `locale` или заголовка `Accept-Language` + (по приоритету), с дефолтом `ru`. Возвращает функцию-зависимость, которая подгружает `babel.support.Translations` из каталога `SRV/locales`. - `_()`: удобная обёртка для получения перевода строки с использованием текущей локали (или дефолтного `ru`, если контекст запроса не передан). diff --git a/SRV/docs/_build/html/api/config/cors.html b/SRV/docs/_build/html/api/config/cors.html index a779f8b..087a164 100644 --- a/SRV/docs/_build/html/api/config/cors.html +++ b/SRV/docs/_build/html/api/config/cors.html @@ -286,7 +286,7 @@

Конфигурация CORS для FastAPI-приложения GONETS.

Модуль инкапсулирует добавление middleware CORSMiddleware со списком разрешённых источников (origins), характерных для локальной разработки и -типовых портов фронтенда (например, Vite/React на 5173/5174, dev‑серверы).

+типовых портов фронтенда (например, Vite/React на 5173/5174, dev-серверы).

Использование:

cors_config = CORSMiddlewareConfig(app) cors_config.add_cors_middleware()

diff --git a/SRV/docs/_build/html/api/core/cli_executor.html b/SRV/docs/_build/html/api/core/cli_executor.html index 2f9da31..b54646d 100644 --- a/SRV/docs/_build/html/api/core/cli_executor.html +++ b/SRV/docs/_build/html/api/core/cli_executor.html @@ -287,7 +287,7 @@
class core.cli_executor.CLIExecutor[source]

Bases: object

-

Утилита для безопасного выполнения CLI‑команд.

+

Утилита для безопасного выполнения CLI-команд.

Назначение:

Инкапсулирует вызов subprocess.run и приводит результат к удобному кортежу (код возврата, stdout) без генерации исключений при ошибках.

diff --git a/SRV/docs/_build/html/api/services/arp_service.html b/SRV/docs/_build/html/api/services/arp_service.html index 8193733..f0060f9 100644 --- a/SRV/docs/_build/html/api/services/arp_service.html +++ b/SRV/docs/_build/html/api/services/arp_service.html @@ -286,18 +286,18 @@

Сервис низкоуровневого ARP-сканирования локальной сети.

Назначение:

    -
  • Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP‑запросов от имени выбранного интерфейса.

  • +
  • Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP-запросов от имени выбранного интерфейса.

  • Помощь сервисам более высокого уровня (например, IPService) при проверке занятости адресов перед применением конфигураций.

Особенности реализации:

  • Определяет подключённые сети интерфейса через netifaces и строит CIDR для сканирования.

  • -
  • Формирует ARP‑пакеты с помощью scapy (Ether/ARP) и отправляет их с таймаутом.

  • +
  • Формирует ARP-пакеты с помощью scapy (Ether/ARP) и отправляет их с таймаутом.

  • Добавляет локальный адрес интерфейса в результирующий список клиентов.

Требования/ограничения:

    -
  • Для отправки ARP‑кадров могут потребоваться повышенные привилегии или capability на сырой сокет.

  • +
  • Для отправки ARP-кадров могут потребоваться повышенные привилегии или capability на сырой сокет.

diff --git a/SRV/docs/_build/html/api/services/connect_service.html b/SRV/docs/_build/html/api/services/connect_service.html index 467b9a1..cada764 100644 --- a/SRV/docs/_build/html/api/services/connect_service.html +++ b/SRV/docs/_build/html/api/services/connect_service.html @@ -283,14 +283,14 @@

Connect Service

-

Сервис управления подключениями Wi‑Fi через nmcli.

+

Сервис управления подключениями Wi-Fi через nmcli.

Назначение:

  • Предоставляет операции подключения/отключения к точкам доступа и проверки текущего статуса, ориентируясь на системный NetworkManager.

Поведение:

    -
  • Автоматически определяет активный Wi‑Fi‑интерфейс.

  • +
  • Автоматически определяет активный Wi-Fi-интерфейс.

  • Валидирует наличие SSID в листинге перед подключением и интерпретирует частые ошибки nmcli (неверный пароль, отсутствующая сеть и т.п.).

Ограничения:

diff --git a/SRV/docs/_build/html/api/services/firewalld_service.html b/SRV/docs/_build/html/api/services/firewalld_service.html index cda00d6..a5e5c85 100644 --- a/SRV/docs/_build/html/api/services/firewalld_service.html +++ b/SRV/docs/_build/html/api/services/firewalld_service.html @@ -283,7 +283,7 @@

Firewalld Service

-

Сервис для управления firewalld через D‑Bus.

+

Сервис для управления firewalld через D-Bus.

Назначение: - Обёртка над интерфейсами org.fedoraproject.FirewallD1 для выполнения

diff --git a/SRV/docs/_build/html/api/services/ip_service.html b/SRV/docs/_build/html/api/services/ip_service.html index 18fc2df..0651449 100644 --- a/SRV/docs/_build/html/api/services/ip_service.html +++ b/SRV/docs/_build/html/api/services/ip_service.html @@ -283,7 +283,7 @@

IP Service

-

Сервис проверки и применения IP‑настроек через NetworkManager (D‑Bus).

+

Сервис проверки и применения IP-настроек через NetworkManager (D-Bus).

Назначение: - Перед применением конфигурации проверяет занятость IP адреса, сканируя сегмент

@@ -294,7 +294,7 @@ выполняет переподключение интерфейса.

Требования/ограничения: -- Доступ к системной шине D‑Bus и права на изменения сетевых профилей. +- Доступ к системной шине D-Bus и права на изменения сетевых профилей. - Структура входных данных должна соответствовать схеме ipv4_updates для

корректного обновления вложенных полей у профиля.

diff --git a/SRV/docs/_build/html/api/services/network_service.html b/SRV/docs/_build/html/api/services/network_service.html index 4022b4d..82e1f14 100644 --- a/SRV/docs/_build/html/api/services/network_service.html +++ b/SRV/docs/_build/html/api/services/network_service.html @@ -283,16 +283,16 @@

Network Service

-

Сервис чтения сетевого состояния через NetworkManager (D‑Bus).

+

Сервис чтения сетевого состояния через NetworkManager (D-Bus).

Назначение: - Предоставляет асинхронные методы для сборки унифицированных моделей

-

сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения -имени хоста. Используется API‑слоем для визуализации и управления.

+

сетевых интерфейсов (Ethernet/Wi-Fi), их IP-конфигураций, а также получения +имени хоста. Используется API-слоем для визуализации и управления.

Особенности: - Фильтрация loopback и явно неактивных интерфейсов. -- Адаптация данных D‑Bus в pydantic‑модели (NetworkInterface, WiFiDevice,

+- Адаптация данных D-Bus в pydantic-модели (NetworkInterface, WiFiDevice,

NetworkInterfacesContainer).

diff --git a/SRV/docs/_build/html/api/services/subnet_service.html b/SRV/docs/_build/html/api/services/subnet_service.html index 278c1f8..90c667e 100644 --- a/SRV/docs/_build/html/api/services/subnet_service.html +++ b/SRV/docs/_build/html/api/services/subnet_service.html @@ -292,7 +292,7 @@
Источники данных:
  • MacLookup: сопоставление префикса MAC (OUI) с названием производителя.

  • DNS: gethostbyaddr с малым таймаутом для обратного разрешения имени.

  • -
  • NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS‑имён.

  • +
  • NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS-имён.

Политика кэширования:
    @@ -347,7 +347,7 @@

    Bases: object

    Класс для хранения и управления данными об устройствах.

    -
    Формат файла подсети:

    JSON‑структура вида +

    Формат файла подсети:

    JSON-структура вида {

    “devices”: [Device, …]

    @@ -355,7 +355,7 @@

    }

    Политика очистки:
      -
    • Метод _clean_old_devices удаляет оффлайн‑устройства, не наблюдавшиеся +

    • Метод _clean_old_devices удаляет оффлайн-устройства, не наблюдавшиеся более 7 дней, чтобы поддерживать актуальность списка.

    @@ -409,7 +409,7 @@ devices (List[Device]): Список устройств для сохранен

    Класс для сканирования подсети с использованием ARP-запросов.

    Назначение:

    Обнаруживает активные устройства в локальной сети, отправляя широковещательные -ARP‑запросы по указанной подсети и собирая ответы (IP, MAC).

    +ARP-запросы по указанной подсети и собирая ответы (IP, MAC).

    Детали реализации:
    • Использует scapy (Ether + ARP) для генерации пакетов и srp для @@ -449,7 +449,7 @@ ARP‑запросы по указанной подсети и собирая о

      Bases: object

      Класс для сканирования открытых портов на устройствах.

      -
      Назначение:

      Плейсхолдер для будущего функционала активного сканирования TCP/UDP‑портов +

      Назначение:

      Плейсхолдер для будущего функционала активного сканирования TCP/UDP-портов у обнаруженных узлов. В текущей версии возвращает пустой список.

      План развития:
        @@ -489,8 +489,8 @@ ARP‑запросы по указанной подсети и собирая о
      • Определение подсети (вручную или авто по интерфейсу).

      • Загрузка ранее сохранённых устройств подсети.

      • Добавление локального устройства (если принадлежит подсети).

      • -
      • ARP‑сканирование и параллельная обработка узлов (обогащение данных).

      • -
      • Маркировка оффлайн‑узлов из кэша, не встреченных в текущем скане.

      • +
      • ARP-сканирование и параллельная обработка узлов (обогащение данных).

      • +
      • Маркировка оффлайн-узлов из кэша, не встреченных в текущем скане.

      • Сортировка по IP и сохранение объединённого списка в JSON.

      diff --git a/SRV/docs/_build/html/api/services/wifi_service.html b/SRV/docs/_build/html/api/services/wifi_service.html index ca423d9..a594e2a 100644 --- a/SRV/docs/_build/html/api/services/wifi_service.html +++ b/SRV/docs/_build/html/api/services/wifi_service.html @@ -287,7 +287,7 @@
      class services.wifi_service.WifiService(translations: Translations = Depends(translations_dependency))[source]

      Bases: object

      -

      Сервис для сканирования текущих Wi‑Fi точек доступа и заметок.

      +

      Сервис для сканирования текущих Wi-Fi точек доступа и заметок.

      Источники данных:
      • pywifi для базового сканирования и получения списка AP.

      • @@ -338,7 +338,7 @@
        class services.wifi_service.WifiStorage(storage_path: str = 'storage/wifi/wifi.json', translations: Translations = Depends(translations_dependency))[source]

        Bases: object

        -

        Класс для хранения данных о Wi‑Fi сетях и их заметках по SSID.

        +

        Класс для хранения данных о Wi-Fi сетях и их заметках по SSID.

        Формат:
        {

        “networks”: [{“ssid”: str, “note”: Optional[str]}]

        diff --git a/SRV/docs/_build/html/api/storage/json_storage.html b/SRV/docs/_build/html/api/storage/json_storage.html index 47c0085..2073556 100644 --- a/SRV/docs/_build/html/api/storage/json_storage.html +++ b/SRV/docs/_build/html/api/storage/json_storage.html @@ -293,7 +293,7 @@ без полноценной СУБД. Подходит для встраиваемых окружений и сценариев, где важна минимальная зависимость от внешних сервисов.

        -
        Формат данных:

        JSON‑структура вида: +

        Формат данных:

        JSON-структура вида: {

        diff --git a/SRV/docs/_build/html/api/storage/session_storage.html b/SRV/docs/_build/html/api/storage/session_storage.html index b1af138..32c8e17 100644 --- a/SRV/docs/_build/html/api/storage/session_storage.html +++ b/SRV/docs/_build/html/api/storage/session_storage.html @@ -291,7 +291,7 @@
        Назначение:

        Лёгкое файловое хранилище для сессионных токенов, сопоставленных с client_id (например, IP клиента). Предназначено для сред без БД и -persistent‑кэшей. Обеспечивает базовые операции и авто‑очистку протухших +persistent-кэшей. Обеспечивает базовые операции и авто-очистку протухших сессий.

        Формат данных:
        diff --git a/SRV/docs/_build/html/api/utils/i18n.html b/SRV/docs/_build/html/api/utils/i18n.html index d73d003..c2b2246 100644 --- a/SRV/docs/_build/html/api/utils/i18n.html +++ b/SRV/docs/_build/html/api/utils/i18n.html @@ -287,8 +287,8 @@
        Содержимое модуля:
        • get_translations(): фабрика зависимости FastAPI, считывающая локаль из -query‑параметра locale, cookie locale или заголовка Accept-Language -(по приоритету), с дефолтом ru. Возвращает функцию‑зависимость, которая +query-параметра locale, cookie locale или заголовка Accept-Language +(по приоритету), с дефолтом ru. Возвращает функцию-зависимость, которая подгружает babel.support.Translations из каталога SRV/locales.

        • _(): удобная обёртка для получения перевода строки с использованием текущей локали (или дефолтного ru, если контекст запроса не передан).

        • diff --git a/SRV/docs/_build/markdown/api/config/cors.md b/SRV/docs/_build/markdown/api/config/cors.md index eef216b..227c54f 100644 --- a/SRV/docs/_build/markdown/api/config/cors.md +++ b/SRV/docs/_build/markdown/api/config/cors.md @@ -4,7 +4,7 @@ Модуль инкапсулирует добавление middleware CORSMiddleware со списком разрешённых источников (origins), характерных для локальной разработки и -типовых портов фронтенда (например, Vite/React на 5173/5174, dev‑серверы). +типовых портов фронтенда (например, Vite/React на 5173/5174, dev-серверы). Использование: : cors_config = CORSMiddlewareConfig(app) diff --git a/SRV/docs/_build/markdown/api/core/cli_executor.md b/SRV/docs/_build/markdown/api/core/cli_executor.md index df8c657..1c3c3a3 100644 --- a/SRV/docs/_build/markdown/api/core/cli_executor.md +++ b/SRV/docs/_build/markdown/api/core/cli_executor.md @@ -4,7 +4,7 @@ Bases: `object` -Утилита для безопасного выполнения CLI‑команд. +Утилита для безопасного выполнения CLI-команд. Назначение: : Инкапсулирует вызов subprocess.run и приводит результат к удобному diff --git a/SRV/docs/_build/markdown/api/services/arp_service.md b/SRV/docs/_build/markdown/api/services/arp_service.md index 609b0b7..ec7b283 100644 --- a/SRV/docs/_build/markdown/api/services/arp_service.md +++ b/SRV/docs/_build/markdown/api/services/arp_service.md @@ -4,18 +4,18 @@ Назначение: -- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP‑запросов от имени выбранного интерфейса. +- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP-запросов от имени выбранного интерфейса. - Помощь сервисам более высокого уровня (например, IPService) при проверке занятости адресов перед применением конфигураций. Особенности реализации: - Определяет подключённые сети интерфейса через netifaces и строит CIDR для сканирования. -- Формирует ARP‑пакеты с помощью scapy (Ether/ARP) и отправляет их с таймаутом. +- Формирует ARP-пакеты с помощью scapy (Ether/ARP) и отправляет их с таймаутом. - Добавляет локальный адрес интерфейса в результирующий список клиентов. Требования/ограничения: -- Для отправки ARP‑кадров могут потребоваться повышенные привилегии или capability на сырой сокет. +- Для отправки ARP-кадров могут потребоваться повышенные привилегии или capability на сырой сокет. ### *class* services.arp_service.NetworkScanner(interface=None, translations: Translations = Depends(translations_dependency)) diff --git a/SRV/docs/_build/markdown/api/services/connect_service.md b/SRV/docs/_build/markdown/api/services/connect_service.md index 9c0c9fa..542224d 100644 --- a/SRV/docs/_build/markdown/api/services/connect_service.md +++ b/SRV/docs/_build/markdown/api/services/connect_service.md @@ -1,6 +1,6 @@ # Connect Service -Сервис управления подключениями Wi‑Fi через nmcli. +Сервис управления подключениями Wi-Fi через nmcli. Назначение: @@ -8,7 +8,7 @@ Поведение: -- Автоматически определяет активный Wi‑Fi‑интерфейс. +- Автоматически определяет активный Wi-Fi-интерфейс. - Валидирует наличие SSID в листинге перед подключением и интерпретирует частые ошибки nmcli (неверный пароль, отсутствующая сеть и т.п.). Ограничения: diff --git a/SRV/docs/_build/markdown/api/services/firewalld_service.md b/SRV/docs/_build/markdown/api/services/firewalld_service.md index bfd4951..cbe8002 100644 --- a/SRV/docs/_build/markdown/api/services/firewalld_service.md +++ b/SRV/docs/_build/markdown/api/services/firewalld_service.md @@ -1,6 +1,6 @@ # Firewalld Service -Сервис для управления firewalld через D‑Bus. +Сервис для управления firewalld через D-Bus. Назначение: diff --git a/SRV/docs/_build/markdown/api/services/ip_service.md b/SRV/docs/_build/markdown/api/services/ip_service.md index 390ff87..8c88361 100644 --- a/SRV/docs/_build/markdown/api/services/ip_service.md +++ b/SRV/docs/_build/markdown/api/services/ip_service.md @@ -1,6 +1,6 @@ # IP Service -Сервис проверки и применения IP‑настроек через NetworkManager (D‑Bus). +Сервис проверки и применения IP-настроек через NetworkManager (D-Bus). Назначение: @@ -9,7 +9,7 @@ Требования/ограничения: -- Доступ к системной шине D‑Bus и права на изменения сетевых профилей. +- Доступ к системной шине D-Bus и права на изменения сетевых профилей. - Структура входных данных должна соответствовать схеме ipv4_updates для корректного обновления вложенных полей у профиля. ### *class* services.ip_service.IPService diff --git a/SRV/docs/_build/markdown/api/services/network_service.md b/SRV/docs/_build/markdown/api/services/network_service.md index 27780ef..268651b 100644 --- a/SRV/docs/_build/markdown/api/services/network_service.md +++ b/SRV/docs/_build/markdown/api/services/network_service.md @@ -1,15 +1,15 @@ # Network Service -Сервис чтения сетевого состояния через NetworkManager (D‑Bus). +Сервис чтения сетевого состояния через NetworkManager (D-Bus). Назначение: -- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения имени хоста. Используется API‑слоем для визуализации и управления. +- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi-Fi), их IP-конфигураций, а также получения имени хоста. Используется API-слоем для визуализации и управления. Особенности: - Фильтрация loopback и явно неактивных интерфейсов. -- Адаптация данных D‑Bus в pydantic‑модели (NetworkInterface, WiFiDevice, NetworkInterfacesContainer). +- Адаптация данных D-Bus в pydantic-модели (NetworkInterface, WiFiDevice, NetworkInterfacesContainer). ### *class* services.network_service.NetworkService(translations: Translations = Depends(translations_dependency)) diff --git a/SRV/docs/_build/markdown/api/services/subnet_service.md b/SRV/docs/_build/markdown/api/services/subnet_service.md index 009e602..c350c71 100644 --- a/SRV/docs/_build/markdown/api/services/subnet_service.md +++ b/SRV/docs/_build/markdown/api/services/subnet_service.md @@ -9,7 +9,7 @@ Bases: `object` Источники данных: : - MacLookup: сопоставление префикса MAC (OUI) с названием производителя. - DNS: gethostbyaddr с малым таймаутом для обратного разрешения имени. - - NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS‑имён. + - NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS-имён. Политика кэширования: : - Результаты get_vendor кэшируются с помощью functools.lru_cache. @@ -67,7 +67,7 @@ Bases: `object` Политика очистки: -- Метод \_clean_old_devices удаляет оффлайн‑устройства, не наблюдавшиеся более 7 дней, +- Метод \_clean_old_devices удаляет оффлайн-устройства, не наблюдавшиеся более 7 дней, чтобы поддерживать актуальность списка. #### get_subnet_file(subnet: str) → Path @@ -116,7 +116,7 @@ Bases: `object` Назначение: : Обнаруживает активные устройства в локальной сети, отправляя широковещательные - ARP‑запросы по указанной подсети и собирая ответы (IP, MAC). + ARP-запросы по указанной подсети и собирая ответы (IP, MAC). Детали реализации: : - Использует scapy (Ether + ARP) для генерации пакетов и srp для @@ -152,7 +152,7 @@ Bases: `object` Класс для сканирования открытых портов на устройствах. Назначение: -: Плейсхолдер для будущего функционала активного сканирования TCP/UDP‑портов +: Плейсхолдер для будущего функционала активного сканирования TCP/UDP-портов у обнаруженных узлов. В текущей версии возвращает пустой список. План развития: @@ -189,8 +189,8 @@ Bases: `object` : 1. Определение подсети (вручную или авто по интерфейсу). 2. Загрузка ранее сохранённых устройств подсети. 3. Добавление локального устройства (если принадлежит подсети). - 4. ARP‑сканирование и параллельная обработка узлов (обогащение данных). - 5. Маркировка оффлайн‑узлов из кэша, не встреченных в текущем скане. + 4. ARP-сканирование и параллельная обработка узлов (обогащение данных). + 5. Маркировка оффлайн-узлов из кэша, не встреченных в текущем скане. 6. Сортировка по IP и сохранение объединённого списка в JSON. #### add_note(mac: str, note: str, translations: Translations) → Tuple[bool, Tuple[str, Dict] | None] diff --git a/SRV/docs/_build/markdown/api/services/wifi_service.md b/SRV/docs/_build/markdown/api/services/wifi_service.md index 2bfee67..43e1af0 100644 --- a/SRV/docs/_build/markdown/api/services/wifi_service.md +++ b/SRV/docs/_build/markdown/api/services/wifi_service.md @@ -4,7 +4,7 @@ Bases: `object` -Сервис для сканирования текущих Wi‑Fi точек доступа и заметок. +Сервис для сканирования текущих Wi-Fi точек доступа и заметок. Источники данных: : - pywifi для базового сканирования и получения списка AP. @@ -40,7 +40,7 @@ Bases: `object` Bases: `object` -Класс для хранения данных о Wi‑Fi сетях и их заметках по SSID. +Класс для хранения данных о Wi-Fi сетях и их заметках по SSID. Формат: : { diff --git a/SRV/docs/_build/markdown/api/storage/json_storage.md b/SRV/docs/_build/markdown/api/storage/json_storage.md index 261e32d..ef4696c 100644 --- a/SRV/docs/_build/markdown/api/storage/json_storage.md +++ b/SRV/docs/_build/markdown/api/storage/json_storage.md @@ -12,7 +12,7 @@ Bases: `object` где важна минимальная зависимость от внешних сервисов. Формат данных: -: JSON‑структура вида: +: JSON-структура вида: {
          > “users”: [ diff --git a/SRV/docs/_build/markdown/api/storage/session_storage.md b/SRV/docs/_build/markdown/api/storage/session_storage.md index 87a7991..361ae22 100644 --- a/SRV/docs/_build/markdown/api/storage/session_storage.md +++ b/SRV/docs/_build/markdown/api/storage/session_storage.md @@ -9,7 +9,7 @@ Bases: `object` Назначение: : Лёгкое файловое хранилище для сессионных токенов, сопоставленных с client_id (например, IP клиента). Предназначено для сред без БД и - persistent‑кэшей. Обеспечивает базовые операции и авто‑очистку протухших + persistent-кэшей. Обеспечивает базовые операции и авто-очистку протухших сессий. Формат данных: diff --git a/SRV/docs/_build/markdown/api/utils/i18n.md b/SRV/docs/_build/markdown/api/utils/i18n.md index 7ccd96f..6cdff50 100644 --- a/SRV/docs/_build/markdown/api/utils/i18n.md +++ b/SRV/docs/_build/markdown/api/utils/i18n.md @@ -4,8 +4,8 @@ Содержимое модуля: : - get_translations(): фабрика зависимости FastAPI, считывающая локаль из - query‑параметра locale, cookie locale или заголовка Accept-Language - (по приоритету), с дефолтом ru. Возвращает функцию‑зависимость, которая + query-параметра locale, cookie locale или заголовка Accept-Language + (по приоритету), с дефолтом ru. Возвращает функцию-зависимость, которая подгружает babel.support.Translations из каталога SRV/locales. - \_(): удобная обёртка для получения перевода строки с использованием текущей локали (или дефолтного ru, если контекст запроса не передан). diff --git a/SRV/services/arp_service.py b/SRV/services/arp_service.py index 4fabf62..c3afbae 100644 --- a/SRV/services/arp_service.py +++ b/SRV/services/arp_service.py @@ -3,18 +3,18 @@ Назначение: -- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP‑запросов от имени выбранного интерфейса. +- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP-запросов от имени выбранного интерфейса. - Помощь сервисам более высокого уровня (например, IPService) при проверке занятости адресов перед применением конфигураций. Особенности реализации: - Определяет подключённые сети интерфейса через `netifaces` и строит CIDR для сканирования. -- Формирует ARP‑пакеты с помощью `scapy` (Ether/ARP) и отправляет их с таймаутом. +- Формирует ARP-пакеты с помощью `scapy` (Ether/ARP) и отправляет их с таймаутом. - Добавляет локальный адрес интерфейса в результирующий список клиентов. Требования/ограничения: -- Для отправки ARP‑кадров могут потребоваться повышенные привилегии или capability на сырой сокет. +- Для отправки ARP-кадров могут потребоваться повышенные привилегии или capability на сырой сокет. """ from fastapi import Depends from scapy.layers.l2 import ARP, Ether diff --git a/SRV/services/connect_service.py b/SRV/services/connect_service.py index 637bd1e..51b9d79 100644 --- a/SRV/services/connect_service.py +++ b/SRV/services/connect_service.py @@ -1,5 +1,5 @@ """ -Сервис управления подключениями Wi‑Fi через `nmcli`. +Сервис управления подключениями Wi-Fi через `nmcli`. Назначение: @@ -7,7 +7,7 @@ Поведение: -- Автоматически определяет активный Wi‑Fi‑интерфейс. +- Автоматически определяет активный Wi-Fi-интерфейс. - Валидирует наличие SSID в листинге перед подключением и интерпретирует частые ошибки `nmcli` (неверный пароль, отсутствующая сеть и т.п.). Ограничения: diff --git a/SRV/services/firewalld_service.py b/SRV/services/firewalld_service.py index 1593f4d..95776e7 100644 --- a/SRV/services/firewalld_service.py +++ b/SRV/services/firewalld_service.py @@ -1,5 +1,5 @@ """ -Сервис для управления firewalld через D‑Bus. +Сервис для управления firewalld через D-Bus. Назначение: diff --git a/SRV/services/ip_service.py b/SRV/services/ip_service.py index 8cf6354..f552560 100644 --- a/SRV/services/ip_service.py +++ b/SRV/services/ip_service.py @@ -1,5 +1,5 @@ """ -Сервис проверки и применения IP‑настроек через NetworkManager (D‑Bus). +Сервис проверки и применения IP-настроек через NetworkManager (D-Bus). Назначение: @@ -8,7 +8,7 @@ Требования/ограничения: -- Доступ к системной шине D‑Bus и права на изменения сетевых профилей. +- Доступ к системной шине D-Bus и права на изменения сетевых профилей. - Структура входных данных должна соответствовать схеме `ipv4_updates` для корректного обновления вложенных полей у профиля. """ from typing import Dict, Any diff --git a/SRV/services/network_service.py b/SRV/services/network_service.py index 1fa691d..30b5e25 100644 --- a/SRV/services/network_service.py +++ b/SRV/services/network_service.py @@ -1,14 +1,14 @@ """ -Сервис чтения сетевого состояния через NetworkManager (D‑Bus). +Сервис чтения сетевого состояния через NetworkManager (D-Bus). Назначение: -- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения имени хоста. Используется API‑слоем для визуализации и управления. +- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi-Fi), их IP-конфигураций, а также получения имени хоста. Используется API-слоем для визуализации и управления. Особенности: - Фильтрация loopback и явно неактивных интерфейсов. -- Адаптация данных D‑Bus в pydantic‑модели (`NetworkInterface`, `WiFiDevice`, `NetworkInterfacesContainer`). +- Адаптация данных D-Bus в pydantic-модели (`NetworkInterface`, `WiFiDevice`, `NetworkInterfacesContainer`). """ from typing import List, Dict, Tuple, Union, Optional from sdbus_async.networkmanager import ( diff --git a/SRV/services/subnet_service.py b/SRV/services/subnet_service.py index af65ed6..0b9ac09 100644 --- a/SRV/services/subnet_service.py +++ b/SRV/services/subnet_service.py @@ -46,7 +46,7 @@ class NetworkScanner: Назначение: Обнаруживает активные устройства в локальной сети, отправляя широковещательные - ARP‑запросы по указанной подсети и собирая ответы (IP, MAC). + ARP-запросы по указанной подсети и собирая ответы (IP, MAC). Детали реализации: - Использует `scapy` (`Ether` + `ARP`) для генерации пакетов и `srp` для @@ -105,7 +105,7 @@ class PortScanner: """Класс для сканирования открытых портов на устройствах. Назначение: - Плейсхолдер для будущего функционала активного сканирования TCP/UDP‑портов + Плейсхолдер для будущего функционала активного сканирования TCP/UDP-портов у обнаруженных узлов. В текущей версии возвращает пустой список. План развития: @@ -144,7 +144,7 @@ class DeviceInfoCollector: Источники данных: - MacLookup: сопоставление префикса MAC (OUI) с названием производителя. - DNS: `gethostbyaddr` с малым таймаутом для обратного разрешения имени. - - NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS‑имён. + - NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS-имён. Политика кэширования: - Результаты `get_vendor` кэшируются с помощью `functools.lru_cache`. @@ -253,7 +253,7 @@ class DeviceStorage: Политика очистки: - - Метод `_clean_old_devices` удаляет оффлайн‑устройства, не наблюдавшиеся более 7 дней, + - Метод `_clean_old_devices` удаляет оффлайн-устройства, не наблюдавшиеся более 7 дней, чтобы поддерживать актуальность списка. """ def __init__(self, base_path: str = "storage/subnets", translations: Translations = None): @@ -382,8 +382,8 @@ class SubnetService: 1) Определение подсети (вручную или авто по интерфейсу). 2) Загрузка ранее сохранённых устройств подсети. 3) Добавление локального устройства (если принадлежит подсети). - 4) ARP‑сканирование и параллельная обработка узлов (обогащение данных). - 5) Маркировка оффлайн‑узлов из кэша, не встреченных в текущем скане. + 4) ARP-сканирование и параллельная обработка узлов (обогащение данных). + 5) Маркировка оффлайн-узлов из кэша, не встреченных в текущем скане. 6) Сортировка по IP и сохранение объединённого списка в JSON. """ def __init__(self, translations: Translations): diff --git a/SRV/services/wifi_service.py b/SRV/services/wifi_service.py index 8d8016a..8daaf58 100644 --- a/SRV/services/wifi_service.py +++ b/SRV/services/wifi_service.py @@ -21,7 +21,7 @@ logging.basicConfig( logger = logging.getLogger(__name__) class WifiStorage: - """Класс для хранения данных о Wi‑Fi сетях и их заметках по SSID. + """Класс для хранения данных о Wi-Fi сетях и их заметках по SSID. Формат: { @@ -71,7 +71,7 @@ class WifiStorage: raise Exception(self.translations.gettext("Ошибка при сохранении заметок: {error}").format(error=str(e))) class WifiService: - """Сервис для сканирования текущих Wi‑Fi точек доступа и заметок. + """Сервис для сканирования текущих Wi-Fi точек доступа и заметок. Источники данных: - `pywifi` для базового сканирования и получения списка AP. diff --git a/SRV/storage/json_storage.py b/SRV/storage/json_storage.py index c8707fd..f8863d9 100644 --- a/SRV/storage/json_storage.py +++ b/SRV/storage/json_storage.py @@ -17,7 +17,7 @@ class JsonStorage: где важна минимальная зависимость от внешних сервисов. Формат данных: - JSON‑структура вида: + JSON-структура вида: { "users": [ {"id": int, "username": str, "password_hash": str, "is_admin": bool}, diff --git a/SRV/storage/session_storage.py b/SRV/storage/session_storage.py index decf083..77baaa6 100644 --- a/SRV/storage/session_storage.py +++ b/SRV/storage/session_storage.py @@ -14,7 +14,7 @@ class SessionStorage: Назначение: Лёгкое файловое хранилище для сессионных токенов, сопоставленных с `client_id` (например, IP клиента). Предназначено для сред без БД и - persistent‑кэшей. Обеспечивает базовые операции и авто‑очистку протухших + persistent-кэшей. Обеспечивает базовые операции и авто-очистку протухших сессий. Формат данных: diff --git a/SRV/utils/i18n.py b/SRV/utils/i18n.py index c3c8dcb..75a0977 100644 --- a/SRV/utils/i18n.py +++ b/SRV/utils/i18n.py @@ -3,8 +3,8 @@ Содержимое модуля: - `get_translations()`: фабрика зависимости FastAPI, считывающая локаль из - query‑параметра `locale`, cookie `locale` или заголовка `Accept-Language` - (по приоритету), с дефолтом `ru`. Возвращает функцию‑зависимость, которая + query-параметра `locale`, cookie `locale` или заголовка `Accept-Language` + (по приоритету), с дефолтом `ru`. Возвращает функцию-зависимость, которая подгружает `babel.support.Translations` из каталога `SRV/locales`. - `_()`: удобная обёртка для получения перевода строки с использованием текущей локали (или дефолтного `ru`, если контекст запроса не передан).