Skip to content

Latest commit

 

History

History
80 lines (67 loc) · 2.98 KB

requirements.org

File metadata and controls

80 lines (67 loc) · 2.98 KB
Raw

Build an HTTP Client

Description

Your task is to build a partially HTTP 1.1 compliant HTTP Client that can GET and POST to a webserver.

You are meant to understand the very basics of HTTP by having a hands-on ground up understanding of what it takes to have an HTTP connection.

Collaboration

  • You may consult with others but the submission should be your own source code.
  • You may work (pair program) with 1 other person, but both of you need to submit your work separately.
  • Collaboration but be documents in the README.md file
  • Any external source code must be referenced and documented in the README.md file

User Stories

  • As a user I want to GET from URLs
  • As a user I want to GET from URLs that use virtualhosting
  • As a user I want to POST to URLs
  • As a user I want to POST from URLs that use virtualhosting
  • As a user when I GET or POST I want the result printed to stdout
  • As a developer when I GET or POST I want the result returned as a HTTPRequest object

Requirements

  • [ ] Implement basic HTTP GET
  • [ ] Implement basic HTTP POST
  • [ ] The httpclient can pass all the tests in freetests.py
  • [ ] The webserver can pass all the tests in not-free-tests.py (you don’t have this one!)
  • [ ] HTTP POST can post vars
  • [ ] HTTP POST handles at least Content-Type: application/x-www-form-urlencoded
  • [ ] httpclient can handle 404 requests and 200 requests

Restrictions

  • [ ] Use Python 2.7
  • [ ] Must run in the undergrad lab (Ubuntu 12.04)
  • [ ] License your httpclient properly (use an OSI approved license)
    • Put your name on it!
  • [ ] You cannot use a Web Client library except for urllib utils to convert strings to url-encode and query-string format and back
  • [ ] You should use the socket library that comes with python

Recommendations

  • Use the server.py skeleton. Handling sockets yourself is not that fun
  • Keep it short, keep it modular
  • READ the spec, read the format of a request
  • It’s a good idea to send the Host header in a GET or POST

Submission Instructions

  • Fork my repository from github https://github.com/abramhindle/CMPUT404-assignment-web-client
  • Push your commits to your fork
  • In EClass for this assignment submit a URL to the git repository. I would prefer github for the host.
    • Line 1: the git URL
    • Line 2: Your CCID
    • Line 3: Your collaborator’s CCID
  • To mark your assignment I should be able to type: git clone http://github.com/youruserid/thisassignment.git yourccid cd yourccid python freetests.py
  • Marks will be deducted if I cannot successfully do this.
  • Marks will be deducted for using library code that does the assignment
  • Marks can be deducated for egregious violation of requirements (e.g. hard coding path names etc.).

Marking

  • 5 marks for passing all of the tests except testInternetGets
  • 2 marks for passing testInternetGets