From a7d072a7c01bef07e487311072732d57feb49755 Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Sun, 15 May 2011 21:29:49 -0400 Subject: [PATCH] features philosophy --- docs/user/quickstart.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) 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 -- 2.7.4