Compare commits

2 Commits
Author SHA1 Message Date
kromskii2 f45c99b7a7 Update README.md 2024-02-19 14:22:45 +07:00
kromskii2 c26c70b94e 1.0 2024-02-19 14:07:52 +07:00
+16 -149
View File
@@ -1,161 +1,28 @@
# Kfale - Автоматизированная система загрузки файлов на FTP сервер # Kfale
# Скрипт для загрузки файлов на FTP сервер
![Python](https://img.shields.io/badge/python-3.10-blue.svg) Этот скрипт на Python позволяет легко загружать файлы на FTP сервер.
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
--- ## Возможности
## О проекте - **Управление конфигурацией**: Использует файлы конфигурации (`config.ini` и `ftp.ini`) для хранения путей к папкам и информации о подключении к FTP.
- **Простое взаимодействие с пользователем**: Скрипт взаимодействует с пользователем для установки пути к папке и деталей подключения к FTP.
**Kfale** — это мощный и простой в использовании скрипт, написанный на Python, который позволяет автоматизировать процесс загрузки файлов на FTP-сервер. С помощью этого инструмента вы можете легко управлять передачей данных между вашим локальным хранилищем и удалённым FTP-сервером. - **Загрузка файлов**: Загружает файлы на указанный FTP сервер.
- **Автоматическое удаление файлов**: После успешной загрузки, оригинальный файл удаляется из локальной директории.
Скрипт поддерживает хранение конфигурации в файлах `config.ini` и `ftp.ini`, что делает его удобным для повторного использования без необходимости каждый раз вводить параметры подключения.
---
## Основные возможности
- **Управление конфигурацией**: Все настройки сохраняются в специальных файлах (`config.ini` и `ftp.ini`), чтобы избежать ручного ввода при каждом запуске.
- **Простое взаимодействие с пользователем**: Интерактивное меню позволяет быстро указать путь к папке и параметры подключения к FTP-серверу.
- **Автоматическая загрузка файлов**: После успешной загрузки файла на FTP-сервер, он автоматически удаляется с локального устройства, освобождая место.
- **Безопасность**: Конфиденциальные данные (например, логин и пароль) хранятся в отдельном файле конфигурации.
- **Поддержка стандартных протоколов**: Использует библиотеку `ftplib` для надёжной работы с FTP-серверами.
---
## Требования ## Требования
Для работы скрипта необходимы следующие компоненты: - Python 3.x
- Библиотека `ftplib` (обычно входит в стандартную библиотеку Python)
- **Python 3.x**: Убедитесь, что у вас установлен Python версии 3.10 или выше. ## Использование
- **Библиотека ftplib**: Обычно входит в стандартную библиотеку Python, но если её нет, её можно установить через pip:
1. Клонируйте или загрузите скрипт на ваш компьютер.
2. Убедитесь, что у вас установлен Python.
3. Установите все необходимые зависимости (`ftplib`).
```bash ```bash
pip install ftplib pip install ftplib
```
---
## Установка
1. **Клонирование репозитория**
Склонируйте этот репозиторий на свой компьютер:
```bash
git clone https://github.com/your-repo-url/Kfale.git
cd Kfale
```
2. **Установка зависимостей**
Убедитесь, что у вас установлен Python 3.x. Затем установите все необходимые зависимости:
```bash
pip install configparser
```
> Примечание: В большинстве случаев `ftplib` уже включена в стандартную библиотеку Python, поэтому дополнительная установка не требуется.
---
## Как использовать
### Первый запуск
При первом запуске скрипт запросит у вас следующие данные:
1. **Путь к папке для взаимодействия со скриптом**: Укажите путь к директории, где будут находиться файлы для загрузки.
2. **Детали подключения к FTP-серверу**:
- IP-адрес FTP-сервера.
- Логин пользователя.
- Пароль.
Все эти данные будут сохранены в соответствующих файлах конфигурации (`config.ini` и `ftp.ini`).
### Работа со скриптом
1. Запустите скрипт:
```bash
python main.py
```
2. Введите имя файла, который нужно загрузить на FTP-сервер. Если файл успешно загружен, он будет автоматически удалён с локального устройства.
3. Для выхода из программы введите команду `exit`.
---
## Конфигурационные файлы
### `config.ini`
Файл содержит путь к директории, где находятся файлы для загрузки:
```ini
[DEFAULT]
folder_path = /path/to/your/folder
```
### `ftp.ini`
Файл содержит информацию о подключении к FTP-серверу:
```ini
[DEFAULT]
host = your_ftp_host
username = your_username
password = your_password
```
> **Важно**: Не забудьте защищать файл `ftp.ini`, так как он содержит конфиденциальную информацию.
---
## Пример использования
## Запустите скрипт:
```bash ```bash
$ python main.py python main.py
Введите путь к папке для взаимодействия со скриптом: /home/user/files
Введите IP адрес FTP сервера: ftp.example.com
Введите логин для FTP сервера: user123
Введите пароль для FTP сервера: password123
Введите имя файла для копирования на FTP сервер (или 'exit' для выхода): example.txt
Файл успешно загружен на FTP сервер.
Оригинальный файл удален.
Введите имя файла для копирования на FTP сервер (или 'exit' для выхода): exit
```
---
## Дополнительные функции
- **Логирование**: Вы можете добавить логирование для отслеживания действий скрипта.
- **Многопоточность**: Для загрузки нескольких файлов одновременно можно использовать многопоточность.
- **Расширенные проверки**: Добавьте проверку наличия файла перед попыткой загрузки.
---
## Лицензия
Этот проект распространяется по лицензии **MIT License**. Подробности можно найти в файле [LICENSE](LICENSE).
---
## Авторы
- **kromskii2** - *Инициатор проекта* - [GitHub](https://github.com/kromskii2)
Если у вас есть вопросы или предложения по улучшению, создайте issue или pull request!
---
## Благодарности
- Спасибо сообществу Python за отличные инструменты и библиотеки!
- Особая благодарность всем, кто помог тестировать этот проект.
---
Надеемся, что Kfale станет полезным инструментом в вашем арсенале! 😊