Metadata-Version: 2.1
Name: FTP-manager
Version: 1.0.0
Summary: A Python package for FTP file management.
Home-page: https://github.com/mgutale/FTP_manager
Author: Mo Gutale
Author-email: mgutale@me.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# FTP Manager Python Package

The **FTP Manager** Python package simplifies managing files on FTP servers. It provides easy-to-use functions for listing folders, uploading files, downloading files, and creating new folders on the FTP server. Whether you're handling large datasets or a few files, this package streamlines FTP file management tasks.

## Installation

You can install the **FTP Manager** package via pip:

``` bash
pip install FTP_manager 

```

## Usage
Here's how you can use the FTP Manager package in your Python projects:

``` python

from FTP_manager import FTPManager

# Initialize FTPManager with host, username, and password
host = 'ftp.example.com'
username = 'your_username'
password = 'your_password'
ftp_manager = FTPManager(host, username, password)

# List top-level folders on the FTP server
top_level_folders = ftp_manager.list_top_level_folders()
print("Top Level Folders:", top_level_folders)

# Upload a DataFrame as a CSV file to a remote folder
import pandas as pd
data = {'Column1': [1, 2, 3], 'Column2': ['A', 'B', 'C']}
df = pd.DataFrame(data)
remote_folder = 'data'
file_name = 'data_file'
ftp_manager.upload_file(df, remote_folder, file_name)

# Download a CSV file from the FTP server as a DataFrame
downloaded_data = ftp_manager.download_file(remote_folder, file_name)
print("Downloaded Data:")
print(downloaded_data)

# Create a new folder on the FTP server
new_folder_name = 'new_folder'
ftp_manager.create_folder(new_folder_name)

```

## Features

**List Folders**: Easily list folders on the FTP server.<br>
**Upload Files**: Upload Pandas DataFrames as CSV files to the FTP server.<br>
**Download Files**: Download CSV files from the FTP server as Pandas DataFrames.<br>
**Create Folders**: Create new folders on the FTP server.
Dependencies

The FTP Manager package requires the following dependencies:

' pandas '

## License
This project is licensed under the MIT License - see the LICENSE file for details.

## Issues and Contributions
For issues and feature requests, please [open an issue](https://github.com/mgutale/FTP_manager/issues) in the GitHub repository. Contributions are welcome; you can [create a pull request](https://github.com/mgutale/FTP_manager/pulls) with your changes.
