This commit is contained in:
2025-05-29 20:26:59 +08:00
parent a674cdd0ed
commit 3e711e7fe8

View File

@@ -0,0 +1,56 @@
### Документация к Сканеру расширению файлов
#### Обзор
Скрипт предназначен для сканирования сетевых компьютеров и поиска медиафайлов с заданными расширениями. Основные функции:
- Поиск файлов на удалённых ПК по сетевым путям
- Форматирование размера файлов
- Сохранение результатов в CSV
- Отслеживание недоступных хостов
#### Константы
- `SEARCH_DIRS`: Директории для поиска (Рабочий стол, Загрузки и т.д.)
- `EXTENSIONS`: Расширения искомых файлов (.mov, .mp4 и др.)
- `EXCLUDE_FOLDERS`: Системные папки для исключения из поиска
#### Основные функции
1. `format_size()`: Конвертирует размер файла в читаемый формат
2. `get_users_from_folders()`: Получает список пользователей ПК
3. `scan_host()`: Основная функция сканирования хоста
4. `main()`: Управляющая функция выполнения скрипта
---
### Список зависимостей
Используются только стандартные библиотеки Python:
```python:requirements.txt
import os
import csv
import time
import pathlib
from datetime import datetime
```
---
### Инструкция по развёртыванию
1. Установите Python 3.8+:
```bash
brew install python
```
2. Создайте файл с хостами:
```bash
echo "PC-NAME-1" >> hosts.txt
echo "PC-NAME-2" >> hosts.txt
```
3. Запустите скрипт:
```bash
python3 main.py
```
---
### Полезные ресурсы
1. <mcurl name="Официальная документация Python" url="https://docs.python.org/3/"></mcurl>
2. <mcurl name="Работа с путями в Python" url="https://realpython.com/python-pathlib/"></mcurl>
3. <mcurl name="Примеры работы с CSV" url="https://pythonexamples.org/python-csv/"></mcurl>
4. <mcurl name="Сетевые пути Windows" url="https://learn.microsoft.com/ru-ru/windows/win32/fileio/naming-a-file"></mcurl>