Ben Copsey

Added README back in

  1 +ASIHTTPRequest is an easy to use wrapper around the CFNetwork API that makes some of the more tedious aspects of communicating with web servers easier. It is written in Objective-C and works in both Mac OS X and iPhone applications.
  2 +
  3 +It is suitable performing basic HTTP requests and interacting with REST-based services (GET / POST / PUT / DELETE). The included ASIFormDataRequest subclass makes it easy to submit POST data and files using multipart/form-data.
  4 +
  5 +It provides:
  6 +* A straightforward interface for submitting data to and fetching data from webservers
  7 +* Download data to memory or directly to a file on disk(i)
  8 +* The ability to submit files on local drives as part of POST data, compatible with the HTML file input mechanism
  9 +* Easy access to request and response HTTP headers
  10 +* Ability for setting up progress delegates (NSProgressIndicators and UIProgressViews) to show information about download AND upload progress
  11 +* Auto-magic management of upload and download progress indicators for operation queues
  12 +* Basic authentication (username and password) support, credentials are automatically for the duration of a session, and can be stored for later in the Keychain.
  13 +* Cookie support
  14 +* Based on NSOperation to make queuing requests and background operation easy
  15 +* Basic unit tests (more to come!)
  16 +
  17 +Documentation is available "here":http://allseeing-i.com/ASI-HTTP-REQUEST.