MyFTP

A Python implementation of a FTP client - server. Supports both TCP and UDP protocols. Tested on Python 3.11 and Python 3.10.

All specfications regarding opcodes, return codes and payload are included in the pdf at the root of the repo ./project_coen366.pdf

Dependencies

Zero. Only python standard libs were used.

Running

Client

Always start the FTP server before starting the FTP client.

You can run python3 src/myftp/client.py --directory <insert valid directory that you have read/write permissions> to start the client.

To run with debug info: python3 src/myftp/client.py --debug 1 --directory <insert valid directory that you have read/write permissions>.

Some example test commands:

• get file_server.txt
• summary numbers.txt
• put file_local.txt
• put image_local.png
• change file_server.txt file_server1.txt
• help

Server

By default, the server IP address or hostname or server name will be 0.0.0.0 or localhost (meaning it will bind to all interfaces). The --port_number flag, if not specified will be by default 12000.

You can run python3 src/myftp/server.py --directory <insert valid directory that you have read/write permissions> to start the server.

Or run python3 src/myftp/server.py --ip_addr <insert ip addr of the server> --port_number <insert port number here> --debug 1 --directory <insert valid directory that you have read/write permissions> for debugging purposes.

Localhost testing

Checkout this repo, go the root of the repo.

Client

Run python3 src/myftp/client.py --debug 1 --directory client_directory

Server

Run python3 src/myftp/server.py --debug 1 --directory server_directory

Testing with Docker

Dependencies

• docker
• docker-compose
• make

Setup

• git clone https://github.com/minhtrannhat/MyFTP.git project
• Make you are at the root of this repo.
• Build the system with make build.
• Wait 10 seconds.
• 2 containers will be created on the same network mynetwork. Their respective IP addresses will be printed to stdout.
• Open two terminal windows: one for each of server and client.
• Run the server with make server in a terminal.
• Run the client with make client in a terminal.
• For the client, when asked to put in the ip address and port number of the server, you can put in ftp_server 12000 or adjust to your chosen port number. The IP address is resolved by Docker so ftp_server can not be changed.
• Go into the client docker container with make docker-client. The folder in which FTP is using to host client files is located at /client_directory/
• Or go into the server docker container with make docker-server. The folder in which FTP is using to host server files is located at /server_directory/
• Tear down everything with make clean.

Fast setup

• Require tmuxinator and tmux.
• Type tmuxinator start . at the root of this repo.