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 дней, чтобы поддерживать актуальность списка.
Класс для сканирования подсети с использованием 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.
-
class services.wifi_service.WifiService(translations: Translations = Depends(translations_dependency))[source]¶
Bases: object
-Сервис для сканирования текущих Wi‑Fi точек доступа и заметок.
+Сервис для сканирования текущих Wi-Fi точек доступа и заметок.
- Источники данных:
pywifi для базового сканирования и получения списка AP.
-
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, если контекст запроса не передан).
> “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`, если контекст запроса не передан).