MyFTP/README.md

1.8 KiB

MyFTP

Dependencies

Zero. Only python standard libs were used. Tested on Python 3.11

Running

Client

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

Server

By default, the server IP address or hostname or server name will be 0.0.0.0 (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 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 and to specify the port number.

Testing with Docker

Dependencies

  • docker
  • docker-compose
  • make

Setup

  • 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.
  • Tear down everything with make clean.

Fast setup

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