From: Kenneth Reitz Date: Mon, 16 May 2011 01:29:49 +0000 (-0400) Subject: features philosophy X-Git-Tag: v0.4.1^2~40 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a7d072a7c01bef07e487311072732d57feb49755;p=services%2Fpython-requests.git features philosophy --- diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst index 52f49d0..fea0766 100644 --- a/docs/user/quickstart.rst +++ b/docs/user/quickstart.rst @@ -1,6 +1,10 @@ Feature Overview ================ +Requests is designed to solve a 90% use case — making simple requests. While most +HTTP libraries are extremely extensible, they often attempt to support the entire HTTP Spec. +This often leads to extremely messy and cumbersome APIs, as is the case with urllib2. Requests abandons support for edge-cases, and focuses on the essentials. + .. _features: @@ -12,10 +16,11 @@ Requests Can: - Add Request headers (with a simple dictionary) - URLEncode your Form Data (with a simple dictionary) - Add Multi-part File Uploads (with a simple dictionary) -- Add CookieJars -- Automatically decompress of GZipped responses -- Support Unicode URLs +- Handle CookieJars (with a single parameter) +- Add HTTP Authentication (with a single parameter) - Handle redirects (with history) +- Automatically decompress GZip'd responses +- Support Unicode URLs - Gracefully timeout - Interface with Eventlet & Gevent