Initial commit!

LICENSE

@@ -0,0 +1,71 @@
+Requests
+========
+
+Copyright (c) 2010-2012 Ryan McCue and contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+ComplexPie IRI Parser
+=====================
+
+Copyright (c) 2007-2010, Geoffrey Sneddon and Steve Minutillo.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+ * Neither the name of the SimplePie Team nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+
+IDNA
+====
+
+By Matthias Sommerfeld <[email protected]>
+Copyright 2004-2007 phlyLabs Berlin, http://phlylabs.de
+
+This library is free software; you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as      
+published by the Free Software Foundation; either version 2.1 of the
+License, or (at your option) any later version.                     
+
+This library is distributed in the hope that it will be useful, but 
+WITHOUT ANY WARRANTY; without even the implied warranty of          
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU   
+Lesser General Public License for more details.                     
+
+You should have received a copy of the GNU Lesser General Public    
+License along with this library; if not, write to the Free Software 
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
+USA.                                                                

README.md

@@ -0,0 +1,77 @@
+Requests for PHP
+================
+
+Requests is an ISC Licensed HTTP library, written in PHP, for human beings. It
+is roughly based on the API from the excellent
+[Requests Python library](http://python-requests.org/).
+
+Despite PHP's use as a language for the web, its tools for sending HTTP requests
+are severely lacking. cURL has an
+[interesting API](http://php.net/manual/en/function.curl-setopt.php), to say the
+least, and you can't always rely on it being available. Sockets provide only low
+level access, and require you to build most of the HTTP response parsing
+yourself.
+
+We all have better things to do. That's why Requests was born.
+
+	$headers = array('Accept' => 'application/json');
+	$data = null;
+	$options = array('auth' => array('user', 'pass'));
+    $request = Requests::get('https://api.github.com/gists', $headers, $data, $options);
+
+    var_dump($request->status_code);
+    // int(200)
+
+    var_dump($request->headers['content-type']);
+    // string(31) "application/json; charset=utf-8"
+
+    var_dump($request->body);
+    // string(26891) "[...]"
+
+See [the same code, without Requests](https://gist.github.com/973705).
+
+Requests allows you to send  **HEAD**, **GET** and **POST** HTTP requests. You
+can add headers, form data, multipart files, and parameters with simple arrays,
+and access the response data in the same way. Requests uses cURL and fsockopen,
+depending on what your system has available, but abstracts all the nasty stuff
+out of your way, providing a consistent API.
+
+
+Features
+--------
+
+- International Domains and URLs
+- Browser-style SSL Verification
+- Basic/Digest Authentication
+- Automatic Decompression
+- Connection Timeouts
+
+
+Installation
+------------
+
+To install Requests via PEAR, simply:
+
+    $ pear install ryanmccue.info/requests
+
+If you want to include it with your project, either [grab it as a zip](https://github.com/rmccue/Requests/zipball/master) or grab it as a tarball:
+
+    $ curl https://github.com/rmccue/Requests/tarball/master | tar xzv
+    (or)
+    $ wget https://github.com/rmccue/Requests/tarball/master -O - | tar xzv
+
+Or clone it via Git:
+
+    $ git clone https://github.com/rmccue/Requests.git
+
+
+Contribute
+----------
+
+1. Check for open issues or open a new issue for a feature request or a bug
+2. Fork [the repository][] on Github to start making your changes to the
+    `master` branch (or branch off of it)
+3. Write a test which shows that the bug was fixed or that the feature works as expected
+4. Send a pull request and bug me until I merge it
+
+[the repository]: https://github.com/rmccue/Requests