Index: third_party/uritemplate/README.rst |
diff --git a/third_party/uritemplate/README.rst b/third_party/uritemplate/README.rst |
new file mode 100644 |
index 0000000000000000000000000000000000000000..80129cbccc7cac35809c3729bdd736b29b9fc75c |
--- /dev/null |
+++ b/third_party/uritemplate/README.rst |
@@ -0,0 +1,71 @@ |
+uritemplate |
+=========== |
+ |
+.. image:: https://secure.travis-ci.org/uri-templates/uritemplate-py.png?branch=master |
+ :alt: build status |
+ :target: http://travis-ci.org/uri-templates/uritemplate-py |
+ |
+This is a Python implementation of `RFC6570`_, URI Template, and can |
+expand templates up to and including Level 4 in that specification. |
+ |
+It exposes a method, *expand*. For example: |
+ |
+.. code-block:: python |
+ |
+ >>> from uritemplate import expand |
+ >>> expand("http://www.{domain}/", {"domain": "foo.com"}) |
+ 'http://www.foo.com/' |
+ |
+It also exposes a method *variables* that returns all variables used in a |
+uritemplate. For example: |
+ |
+.. code-block:: python |
+ |
+ >>> from uritemplate import variables |
+ >>> variables('http:www{.domain*}{/top,next}{?q:20}') |
+ >>> set(['domain', 'next', 'q', 'top']) |
+ |
+This function can be useful to determine what keywords are available to be |
+expanded. |
+ |
+.. _RFC6570: http://tools.ietf.org/html/rfc6570 |
+ |
+ |
+Requirements |
+------------ |
+ |
+uritemplate works with Python 2.5+. |
+ |
+.. note:: You need to install `simplejson`_ module for Python 2.5. |
+ |
+.. _simplejson: https://pypi.python.org/pypi/simplejson/ |
+ |
+ |
+Install |
+------- |
+ |
+The easiest way to install uritemplate is with pip:: |
+ |
+ $ pip install uritemplate |
+ |
+See its `Python Package Index entry`_ for more. |
+ |
+.. _Python Package Index entry: http://pypi.python.org/pypi/uritemplate |
+ |
+ |
+License |
+======= |
+ |
+Copyright 2011-2013 Joe Gregorio |
+ |
+Licensed under the Apache License, Version 2.0 (the "License"); |
+you may not use this file except in compliance with the License. |
+You may obtain a copy of the License at |
+ |
+http://www.apache.org/licenses/LICENSE-2.0 |
+ |
+Unless required by applicable law or agreed to in writing, software |
+distributed under the License is distributed on an "AS IS" BASIS, |
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
+See the License for the specific language governing permissions and |
+limitations under the License. |