Initial commit

2024-02-19 13:58:36 +07:00
8 changed files with 2 additions and 267 deletions
@@ -1,3 +0,0 @@
 # Default ignored files
 /shelf/
 /workspace.xml
@@ -1,8 +0,0 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <module type="PYTHON_MODULE" version="4">
  <component name="NewModuleRootManager">
    <content url="file://$MODULE_DIR$" />
    <orderEntry type="inheritedJdk" />
    <orderEntry type="sourceFolder" forTests="false" />
  </component>
 </module>
@@ -1,6 +0,0 @@
 <component name="InspectionProjectProfileManager">
  <settings>
    <option name="USE_PROJECT_PROFILE" value="false" />
    <version value="1.0" />
  </settings>
 </component>
@@ -1,7 +0,0 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
  <component name="Black">
    <option name="sdkName" value="Python 3.10 (Kfale)" />
  </component>
  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.10 (Kfale)" project-jdk-type="Python SDK" />
 </project>
@@ -1,8 +0,0 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
  <component name="ProjectModuleManager">
    <modules>
      <module fileurl="file://$PROJECT_DIR$/.idea/Kfale.iml" filepath="$PROJECT_DIR$/.idea/Kfale.iml" />
    </modules>
  </component>
 </project>
@@ -1,6 +0,0 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
  <component name="VcsDirectoryMappings">
    <mapping directory="" vcs="Git" />
  </component>
 </project>
@@ -1,161 +1,2 @@
-# Kfale - Автоматизированная система загрузки файлов на FTP сервер
+# Kfale
-
+ Kfale
 ![Python](https://img.shields.io/badge/python-3.10-blue.svg)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 ---
 ## О проекте
 **Kfale** — это мощный и простой в использовании скрипт, написанный на Python, который позволяет автоматизировать процесс загрузки файлов на FTP-сервер. С помощью этого инструмента вы можете легко управлять передачей данных между вашим локальным хранилищем и удалённым FTP-сервером.
 Скрипт поддерживает хранение конфигурации в файлах `config.ini` и `ftp.ini`, что делает его удобным для повторного использования без необходимости каждый раз вводить параметры подключения.
 ---
 ## Основные возможности
 - **Управление конфигурацией**: Все настройки сохраняются в специальных файлах (`config.ini` и `ftp.ini`), чтобы избежать ручного ввода при каждом запуске.
 - **Простое взаимодействие с пользователем**: Интерактивное меню позволяет быстро указать путь к папке и параметры подключения к FTP-серверу.
 - **Автоматическая загрузка файлов**: После успешной загрузки файла на FTP-сервер, он автоматически удаляется с локального устройства, освобождая место.
 - **Безопасность**: Конфиденциальные данные (например, логин и пароль) хранятся в отдельном файле конфигурации.
 - **Поддержка стандартных протоколов**: Использует библиотеку `ftplib` для надёжной работы с FTP-серверами.
 ---
 ## Требования
 Для работы скрипта необходимы следующие компоненты:
 - **Python 3.x**: Убедитесь, что у вас установлен Python версии 3.10 или выше.
 - **Библиотека ftplib**: Обычно входит в стандартную библиотеку Python, но если её нет, её можно установить через pip:
  ```bash
  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
 $ 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 станет полезным инструментом в вашем арсенале! 😊
@@ -1,68 +0,0 @@
 import os
 from ftplib import FTP
 import configparser
 def read_config():
    config = configparser.ConfigParser()
    config.read('config.ini')
    folder_path = config['DEFAULT']['folder_path']
    return folder_path
 def write_config(folder_path):
    config = configparser.ConfigParser()
    config['DEFAULT'] = {'folder_path': folder_path}
    with open('config.ini', 'w') as configfile:
        config.write(configfile)
 def read_ftp_config():
    config = configparser.ConfigParser()
    config.read('ftp.ini')
    ftp_info = {
        'host': config['DEFAULT']['host'],
        'username': config['DEFAULT']['username'],
        'password': config['DEFAULT']['password']
    }
    return ftp_info
 def write_ftp_config(host, username, password):
    config = configparser.ConfigParser()
    config['DEFAULT'] = {'host': host, 'username': username, 'password': password}
    with open('ftp.ini', 'w') as configfile:
        config.write(configfile)
 def upload_file_ftp(file_path, ftp_info):
    with FTP(ftp_info['host']) as ftp:
        ftp.login(ftp_info['username'], ftp_info['password'])
        with open(file_path, 'rb') as file:
            ftp.storbinary(f'STOR {os.path.basename(file_path)}', file)
 def main():
    folder_path = input("Введите путь к папке для взаимодействия со скриптом: ")
    write_config(folder_path)
    host = input("Введите IP адрес FTP сервера: ")
    username = input("Введите логин для FTP сервера: ")
    password = input("Введите пароль для FTP сервера: ")
    write_ftp_config(host, username, password)
    folder_path = read_config()
    ftp_info = read_ftp_config()
    while True:
        file_name = input("Введите имя файла для копирования на FTP сервер (или 'exit' для выхода): ")
        if file_name.lower() == 'exit':
            break
        file_path = os.path.join(folder_path, file_name)
        if os.path.exists(file_path):
            upload_file_ftp(file_path, ftp_info)
            print("Файл успешно загружен на FTP сервер.")
            # После успешной загрузки файла на FTP сервер можно удалить оригинальный файл.
            os.remove(file_path)
            print("Оригинальный файл удален.")
        else:
            print("Файл не найден.")
 if __name__ == "__main__":
    main()