56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
### Документация к Сканеру расширению файлов
|
||
|
||
#### Обзор
|
||
Скрипт предназначен для сканирования сетевых компьютеров и поиска медиафайлов с заданными расширениями. Основные функции:
|
||
- Поиск файлов на удалённых ПК по сетевым путям
|
||
- Форматирование размера файлов
|
||
- Сохранение результатов в 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>
|
||
|