POP-C-Client

Requirements

• X11 Library
• change the makefile link to X11 library according to its path on your system
• Python

To Execute

Compile the files with the following command:

make

Now first start the server:

python pop-server.py host:port messagesDir

where messagesDir simulates the database where your mail would be stored in your server. Now you can start the POP-Client with one of the following commands:

./main-pop host port -t --> text mode
./main-pop host port -c --> clickable mode
./main-pop host port -g --> graphical mode 

Synopsis

This project is a Post-Office-Protocol (POP) Client for retrieving mails from an email Server. Only a part of the protocol has been considered in this implementation, that is to say the following requests from the protocol:

The two first to handle the login phase:

• USER username
• PASS password, for specifying the unencrypted password

The others for interacting with the server:

• LIST, to retrieve line by line the message ID followed by its size
• TOP n 0, to retrieve the SMTP headers of the message which has n has an ID
• QUIT, to quit the server and stop the client
• RETR n, to retrieve the message n

Three modes are proposed to interact with the server:

• text mode: everything happens via command line
• clickable mode: the login becomes graphical, a click on the message ID will save the message on the hard drive
• graphical mode: a complete message can be read on a new window instead of being saved (third mode is still a work in progress)

Automatic Tests

The Server and the Client will be automatically set and executed in order to make their communication possible. Tests named t-test-N take not only care about setting the programs but simulate a predefined communication between the Server and the Client.

1. Text mode:

   • The first automatic test starts the Server Simulator and sends a list request after having logged in, then correctly stops the program notifying it to the Server (quit request):

       make t-test-1 
     

   • The second test shows the POP-Client checking the headers of the message which id is 1 and retrieving it:

       make t-test-2
     

   • The third one shows the POP-Client directly retrieving the third message from the mail-box:

       make t-test-3
     

2. Clickable mode:

    make c-test
   

3. Graphical mode:

    make g-test (Work in Progress)
   

Clean

To clean your project directory from temporary and executable files:

make cleanall