Metadata-Version: 2.1
Name: pythonFTP
Version: 0.0.6
Summary: FTP file transfer and management by Python
Home-page: https://github.com/AsajuHuishi/FTP_file_transfer_management
Author: AsajuHuishi
Author-email: zengxinyang@tju.edu.cn
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown


# FTP_file_transfer_management
## 介绍
`pyFTP` 是一个用来在Linux（Ubuntu）上管理ftp服务器文件的工具。它使用`python`实现，基于经典的`libftp`模块，保留了该模块的所有原有功能。它实现的核心功能包括：**ftp服务器上传/下载文件/文件夹，在ftp服务器上创建文件夹，删除ftp服务器上的文件/文件夹**。我们**对ftp的文件夹实现递归处理**，确保可以**实现便利的传输和管理ftp服务器上的文件和文件夹**。

## 环境

 - Ubuntu16.04
 - Python3.7

##  下载
0.0.6版本

```bash
pip install pythonFTP
```
## 使用

 - **模块导入**
```python
from pythonFTP.FTPTools import FTPTools
```
 - **对象建立**


```python
obj = FTPTools('ip', 'username', 'password')
```
- **核心功能实现**

| run() |  参数1     | 参数2|参数3|
|:--------:|:-------------:|:--------:|:--------:|
| **上传文件夹** |  ftp文件夹路径 |本地文件夹路径 |`'upload folder'`|
| **上传文件** | ftp文件夹路径 | 本地文件+文件名 |`'upload file'`|
| **下载文件夹** |  ftp文件夹路径 |本地文件夹路径 |`'download folder'`|
| **下载文件** | ftp文件路径+文件名 |本地文件夹路径 | `'download file'`|
| **删除文件夹** |  ftp文件夹路径 |`''` |`'delete folder'`|
| **删除文件** |  ftp文件路径+文件名 |`''` |`'delete file'`|
| **创建文件夹**| ftp文件夹路径|`''` |`'create folder'`|

**举例**

```python
# upload older
localPath = '/media/lwt/qysdcj/01trainset/beads1227/'
ftpPath = '/private/lwt/qysdcj/jojo/'
obj.run(ftpPath, localPath, 'upload folder')

# delete folder
# ftpFolder = '/private/lwt/qysdcj/jojo/'
# obj.run(ftpFolder, '', 'delete folder')    

# download folder
# ftpPath = '/private/lwt/qysdcj/'
# localPath = '/media/lwt/qysdcj/01trainset/beads1226/nulckaj/'
# obj.run(ftpPath, localPath, 'download folder')    

# create folder
# ftpPath = '/private/lwt/qysdcj/'
# obj.run(ftpPath, '', 'create folder') 
```

## 相关项目

 - [libftp](https://pypi.org/search/?q=libftp) -本项目在此项目的基础上进行了修改，并保留了原有的所有方法。您可以在`pyFTP`中使用 

```python
from pyFTP.utils.ftplib2 import FTP 
```
它包括原来模块中的所有内容。

## 负责人

 - [AsajuHuishi](https://github.com/AsajuHuishi)






