fix pop

.gitignore

@@ -1,4 +1,5 @@
 *.vscode
 *.pyc
 *.db
-venv
+venv
+/.idea

.idea/workspace.xml

@@ -2,14 +2,95 @@
 <project version="4">
   <component name="ChangeListManager">
     <list default="true" id="24d4e717-d5fe-45ea-9d4b-5aab93817d90" name="Default" comment="">
-      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/__init__.py" afterPath="$PROJECT_DIR$/proxypool/__init__.py" />
-      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/api.py" afterPath="$PROJECT_DIR$/proxypool/api.py" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/1.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/2.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/3.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/4.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/Makefile" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/doctrees/environment.pickle" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/doctrees/flask/flask.doctree" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/doctrees/flask/flask.ext.doctree" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/doctrees/flask/index.doctree" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/doctrees/index.doctree" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/doctrees/proxypool.doctree" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/.buildinfo" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/app.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/blueprints.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/cli.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/config.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/ctx.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/debughelpers.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/exthook.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/helpers.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/json.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/logging.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/sessions.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/signals.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/templating.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/testing.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/views.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/flask/wrappers.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/index.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/proxypool/db.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/proxypool/error.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/proxypool/proxyGetter.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/proxypool/schedule.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/proxypool/utils.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/werkzeug/datastructures.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_modules/werkzeug/routing.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_sources/flask/flask.ext.txt" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_sources/flask/flask.txt" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_sources/flask/index.txt" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_sources/index.txt" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_sources/proxypool.txt" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/ajax-loader.gif" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/alabaster.css" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/basic.css" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/comment-bright.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/comment-close.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/comment.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/custom.css" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/doctools.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/down-pressed.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/down.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/file.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/jquery-1.11.1.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/jquery.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/minus.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/plus.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/pygments.css" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/searchtools.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/underscore-1.3.1.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/underscore.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/up-pressed.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/up.png" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/_static/websupport.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/flask/flask.ext.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/flask/flask.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/flask/index.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/genindex.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/index.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/objects.inv" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/proxypool.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/py-modindex.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/search.html" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/_build/html/searchindex.js" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/conf.py" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/index.rst" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/make.bat" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/docs/proxypool.rst" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/examples/testaio.py" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/examples/testaio2.py" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/tests/test_api.py" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/tests/test_db.py" afterPath="" />
+      <change type="DELETED" beforePath="$PROJECT_DIR$/tests/test_schdule.py" afterPath="" />
+      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/.gitignore" afterPath="$PROJECT_DIR$/.gitignore" />
+      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/.idea/workspace.xml" afterPath="$PROJECT_DIR$/.idea/workspace.xml" />
+      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/examples/example.py" afterPath="$PROJECT_DIR$/examples/example.py" />
       <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/db.py" afterPath="$PROJECT_DIR$/proxypool/db.py" />
-      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/error.py" afterPath="$PROJECT_DIR$/proxypool/error.py" />
       <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/getter.py" afterPath="$PROJECT_DIR$/proxypool/getter.py" />
       <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/schedule.py" afterPath="$PROJECT_DIR$/proxypool/schedule.py" />
       <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/setting.py" afterPath="$PROJECT_DIR$/proxypool/setting.py" />
-      <change type="MODIFICATION" beforePath="$PROJECT_DIR$/proxypool/utils.py" afterPath="$PROJECT_DIR$/proxypool/utils.py" />
     </list>
     <ignored path="ProxyPool.iws" />
     <ignored path=".idea/workspace.xml" />
@@ -24,7 +105,7 @@
   <component name="ChangesViewManager" flattened_view="true" show_ignored="false" />
   <component name="CoverageDataManager">
     <SUITE FILE_PATH="coverage/ProxyPool$example.coverage" NAME="example Coverage Results" MODIFIED="1487830200820" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="true" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/examples" />
-    <SUITE FILE_PATH="coverage/ProxyPool$db.coverage" NAME="db Coverage Results" MODIFIED="1487855837836" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="true" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/proxypool" />
+    <SUITE FILE_PATH="coverage/ProxyPool$db.coverage" NAME="db Coverage Results" MODIFIED="1487860457152" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="true" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/proxypool" />
     <SUITE FILE_PATH="coverage/ProxyPool$testaio.coverage" NAME="testaio Coverage Results" MODIFIED="1487831286992" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="true" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/examples" />
     <SUITE FILE_PATH="coverage/ProxyPool$testaio2.coverage" NAME="testaio2 Coverage Results" MODIFIED="1487834393115" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="true" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/examples" />
   </component>
@@ -37,25 +118,25 @@
   </component>
   <component name="FileEditorManager">
     <leaf>
-      <file leaf-file-name="example.py" pinned="false" current-in-tab="false">
-        <entry file="file://$PROJECT_DIR$/examples/example.py">
+      <file leaf-file-name="utils.py" pinned="false" current-in-tab="false">
+        <entry file="file://$PROJECT_DIR$/proxypool/utils.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="285">
-              <caret line="15" column="16" selection-start-line="15" selection-start-column="16" selection-end-line="15" selection-end-column="16" />
+            <state relative-caret-position="-171">
+              <caret line="15" column="8" selection-start-line="15" selection-start-column="8" selection-end-line="15" selection-end-column="8" />
               <folding>
-                <element signature="e#0#9#0" expanded="true" />
+                <element signature="e#0#15#0" expanded="true" />
               </folding>
             </state>
           </provider>
         </entry>
       </file>
-      <file leaf-file-name="utils.py" pinned="false" current-in-tab="false">
-        <entry file="file://$PROJECT_DIR$/proxypool/utils.py">
+      <file leaf-file-name="example.py" pinned="false" current-in-tab="false">
+        <entry file="file://$PROJECT_DIR$/examples/example.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="-338">
-              <caret line="10" column="0" selection-start-line="10" selection-start-column="0" selection-end-line="10" selection-end-column="0" />
+            <state relative-caret-position="133">
+              <caret line="7" column="0" selection-start-line="7" selection-start-column="0" selection-end-line="7" selection-end-column="0" />
               <folding>
-                <element signature="e#0#15#0" expanded="true" />
+                <element signature="e#0#9#0" expanded="true" />
               </folding>
             </state>
           </provider>
@@ -64,8 +145,8 @@
       <file leaf-file-name="getter.py" pinned="false" current-in-tab="false">
         <entry file="file://$PROJECT_DIR$/proxypool/getter.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="-19">
-              <caret line="29" column="4" selection-start-line="29" selection-start-column="4" selection-end-line="29" selection-end-column="4" />
+            <state relative-caret-position="21">
+              <caret line="69" column="0" selection-start-line="69" selection-start-column="0" selection-end-line="69" selection-end-column="0" />
               <folding>
                 <element signature="e#0#27#0" expanded="true" />
               </folding>
@@ -76,8 +157,8 @@
       <file leaf-file-name="error.py" pinned="false" current-in-tab="false">
         <entry file="file://$PROJECT_DIR$/proxypool/error.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="57">
-              <caret line="3" column="11" selection-start-line="3" selection-start-column="11" selection-end-line="3" selection-end-column="11" />
+            <state relative-caret-position="304">
+              <caret line="16" column="7" selection-start-line="16" selection-start-column="7" selection-end-line="16" selection-end-column="7" />
               <folding />
             </state>
           </provider>
@@ -86,28 +167,20 @@
       <file leaf-file-name="schedule.py" pinned="false" current-in-tab="false">
         <entry file="file://$PROJECT_DIR$/proxypool/schedule.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="133">
-              <caret line="7" column="14" selection-start-line="7" selection-start-column="14" selection-end-line="7" selection-end-column="14" />
-              <folding />
-            </state>
-          </provider>
-        </entry>
-      </file>
-      <file leaf-file-name="__init__.py" pinned="false" current-in-tab="false">
-        <entry file="file://$PROJECT_DIR$/proxypool/__init__.py">
-          <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="0">
-              <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
-              <folding />
+            <state relative-caret-position="418">
+              <caret line="46" column="0" selection-start-line="46" selection-start-column="0" selection-end-line="46" selection-end-column="0" />
+              <folding>
+                <element signature="e#0#11#0" expanded="true" />
+              </folding>
             </state>
           </provider>
         </entry>
       </file>
-      <file leaf-file-name="db.py" pinned="false" current-in-tab="true">
+      <file leaf-file-name="db.py" pinned="false" current-in-tab="false">
         <entry file="file://$PROJECT_DIR$/proxypool/db.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="1045">
-              <caret line="55" column="26" selection-start-line="55" selection-start-column="26" selection-end-line="55" selection-end-column="26" />
+            <state relative-caret-position="817">
+              <caret line="53" column="27" selection-start-line="53" selection-start-column="27" selection-end-line="53" selection-end-column="27" />
               <folding>
                 <element signature="e#0#12#0" expanded="true" />
               </folding>
@@ -115,11 +188,11 @@
           </provider>
         </entry>
       </file>
-      <file leaf-file-name="api.py" pinned="false" current-in-tab="false">
+      <file leaf-file-name="api.py" pinned="false" current-in-tab="true">
         <entry file="file://$PROJECT_DIR$/proxypool/api.py">
           <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="0">
-              <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
+            <state relative-caret-position="209">
+              <caret line="11" column="26" selection-start-line="11" selection-start-column="26" selection-end-line="11" selection-end-column="26" />
               <folding>
                 <element signature="e#0#26#0" expanded="true" />
               </folding>
@@ -129,19 +202,9 @@
       </file>
       <file leaf-file-name="setting.py" pinned="false" current-in-tab="false">
         <entry file="file://$PROJECT_DIR$/proxypool/setting.py">
-          <provider selected="true" editor-type-id="text-editor">
-            <state relative-caret-position="0">
-              <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
-              <folding />
-            </state>
-          </provider>
-        </entry>
-      </file>
-      <file leaf-file-name=".travis.yml" pinned="false" current-in-tab="false">
-        <entry file="file://$PROJECT_DIR$/.travis.yml">
           <provider selected="true" editor-type-id="text-editor">
             <state relative-caret-position="228">
-              <caret line="12" column="17" selection-start-line="12" selection-start-column="17" selection-end-line="12" selection-end-column="17" />
+              <caret line="12" column="31" selection-start-line="12" selection-start-column="31" selection-end-line="12" selection-end-column="31" />
               <folding />
             </state>
           </provider>
@@ -162,13 +225,15 @@
         <option value="$PROJECT_DIR$/.travis.yml" />
         <option value="$PROJECT_DIR$/proxypool/proxyGetter.py" />
         <option value="$PROJECT_DIR$/proxypool/error.py" />
-        <option value="$PROJECT_DIR$/proxypool/setting.py" />
         <option value="$PROJECT_DIR$/proxypool/__init__.py" />
-        <option value="$PROJECT_DIR$/proxypool/schedule.py" />
         <option value="$PROJECT_DIR$/proxypool/api.py" />
         <option value="$PROJECT_DIR$/proxypool/utils.py" />
-        <option value="$PROJECT_DIR$/proxypool/db.py" />
         <option value="$PROJECT_DIR$/proxypool/getter.py" />
+        <option value="$PROJECT_DIR$/.gitignore" />
+        <option value="$PROJECT_DIR$/examples/example.py" />
+        <option value="$PROJECT_DIR$/proxypool/setting.py" />
+        <option value="$PROJECT_DIR$/proxypool/schedule.py" />
+        <option value="$PROJECT_DIR$/proxypool/db.py" />
       </list>
     </option>
   </component>
@@ -228,20 +293,6 @@
               <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.PsiDirectoryNode" />
             </PATH_ELEMENT>
           </PATH>
-          <PATH>
-            <PATH_ELEMENT>
-              <option name="myItemId" value="ProxyPool" />
-              <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.ProjectViewProjectNode" />
-            </PATH_ELEMENT>
-            <PATH_ELEMENT>
-              <option name="myItemId" value="ProxyPool" />
-              <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.PsiDirectoryNode" />
-            </PATH_ELEMENT>
-            <PATH_ELEMENT>
-              <option name="myItemId" value="tests" />
-              <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.PsiDirectoryNode" />
-            </PATH_ELEMENT>
-          </PATH>
           <PATH>
             <PATH_ELEMENT>
               <option name="myItemId" value="ProxyPool" />
@@ -282,6 +333,7 @@
     <property name="WebServerToolWindowFactoryState" value="false" />
     <property name="js-jscs-nodeInterpreter" value="/usr/local/bin/node" />
     <property name="FullScreen" value="true" />
+    <property name="prop_add_unversioned_files" value="true" />
   </component>
   <component name="RunManager" selected="Python.db">
     <configuration default="false" name="example" type="PythonConfigurationType" factoryName="Python" temporary="true">
@@ -449,6 +501,24 @@
       <module name="ProxyPool" />
       <method />
     </configuration>
+    <configuration default="true" type="docs" factoryName="Sphinx task">
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="" />
+      <option name="IS_MODULE_SDK" value="false" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <module name="ProxyPool" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" enabled="false" sample_coverage="true" runner="coverage.py" />
+      <option name="docutils_input_file" value="" />
+      <option name="docutils_output_file" value="" />
+      <option name="docutils_params" value="" />
+      <option name="docutils_task" value="" />
+      <option name="docutils_open_in_browser" value="false" />
+      <method />
+    </configuration>
     <configuration default="true" type="js.build_tools.gulp" factoryName="Gulp.js">
       <method />
     </configuration>
@@ -608,9 +678,9 @@
       <window_info id="Find" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.32959184" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
       <window_info id="Python Console" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.33" sideWeight="0.5" order="-1" side_tool="false" content_ui="tabs" />
       <window_info id="Version Control" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.33" sideWeight="0.5" order="-1" side_tool="false" content_ui="tabs" />
-      <window_info id="Run" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.4622449" sideWeight="0.5" order="2" side_tool="false" content_ui="tabs" />
+      <window_info id="Run" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="true" show_stripe_button="true" weight="0.4622449" sideWeight="0.5" order="2" side_tool="false" content_ui="tabs" />
       <window_info id="Structure" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.25" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
-      <window_info id="Terminal" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="true" show_stripe_button="true" weight="0.39183673" sideWeight="0.5" order="-1" side_tool="false" content_ui="tabs" />
+      <window_info id="Terminal" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.4642857" sideWeight="0.5" order="-1" side_tool="false" content_ui="tabs" />
       <window_info id="Favorites" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.33" sideWeight="0.5" order="-1" side_tool="true" content_ui="tabs" />
       <window_info id="Debug" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.4" sideWeight="0.5" order="3" side_tool="false" content_ui="tabs" />
       <window_info id="Cvs" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" show_stripe_button="true" weight="0.25" sideWeight="0.5" order="4" side_tool="false" content_ui="tabs" />
@@ -629,16 +699,6 @@
     <watches-manager />
   </component>
   <component name="editorHistoryManager">
-    <entry file="file://$PROJECT_DIR$/tests/test_db.py">
-      <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="0">
-          <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
-          <folding>
-            <element signature="e#0#15#0" expanded="false" />
-          </folding>
-        </state>
-      </provider>
-    </entry>
     <entry file="file://$PROJECT_DIR$/requirements.txt">
       <provider selected="true" editor-type-id="text-editor">
         <state relative-caret-position="76">
@@ -660,16 +720,6 @@
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/tests/test_api.py">
-      <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="418">
-          <caret line="22" column="35" selection-start-line="22" selection-start-column="35" selection-end-line="22" selection-end-column="35" />
-          <folding>
-            <element signature="e#0#15#0" expanded="false" />
-          </folding>
-        </state>
-      </provider>
-    </entry>
     <entry file="file://$PROJECT_DIR$/docs/index.rst">
       <provider selected="true" editor-type-id="text-editor">
         <state relative-caret-position="285">
@@ -690,9 +740,7 @@
       <provider selected="true" editor-type-id="text-editor">
         <state relative-caret-position="247">
           <caret line="13" column="0" selection-start-line="13" selection-start-column="0" selection-end-line="13" selection-end-column="0" />
-          <folding>
-            <element signature="e#0#14#0" expanded="true" />
-          </folding>
+          <folding />
         </state>
       </provider>
     </entry>
@@ -700,9 +748,7 @@
       <provider selected="true" editor-type-id="text-editor">
         <state relative-caret-position="327">
           <caret line="33" column="5" selection-start-line="33" selection-start-column="5" selection-end-line="33" selection-end-column="5" />
-          <folding>
-            <element signature="e#0#14#0" expanded="true" />
-          </folding>
+          <folding />
         </state>
       </provider>
     </entry>
@@ -730,18 +776,23 @@
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/README.md">
-      <provider editor-type-id="MarkdownPreviewEditor">
-        <state />
+    <entry file="file://$PROJECT_DIR$/proxypool/__init__.py">
+      <provider selected="true" editor-type-id="text-editor">
+        <state relative-caret-position="0">
+          <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
+          <folding />
+        </state>
       </provider>
+    </entry>
+    <entry file="file://$PROJECT_DIR$/tests/test_schdule.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="231">
-          <caret line="85" column="13" selection-start-line="85" selection-start-column="13" selection-end-line="85" selection-end-column="13" />
+        <state relative-caret-position="0">
+          <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
           <folding />
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/proxypool/__init__.py">
+    <entry file="file://$PROJECT_DIR$/tests/test_db.py">
       <provider selected="true" editor-type-id="text-editor">
         <state relative-caret-position="0">
           <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
@@ -749,30 +800,37 @@
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/proxypool/utils.py">
+    <entry file="file://$PROJECT_DIR$/tests/test_api.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="-338">
-          <caret line="10" column="0" selection-start-line="10" selection-start-column="0" selection-end-line="10" selection-end-column="0" />
-          <folding>
-            <element signature="e#0#15#0" expanded="true" />
-          </folding>
+        <state relative-caret-position="21">
+          <caret line="22" column="35" selection-start-line="22" selection-start-column="35" selection-end-line="22" selection-end-column="35" />
+          <folding />
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/proxypool/api.py">
+    <entry file="file://$PROJECT_DIR$/.gitignore">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="0">
-          <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
-          <folding>
-            <element signature="e#0#26#0" expanded="true" />
-          </folding>
+        <state relative-caret-position="76">
+          <caret line="4" column="6" selection-start-line="4" selection-start-column="6" selection-end-line="4" selection-end-column="6" />
+          <folding />
+        </state>
+      </provider>
+    </entry>
+    <entry file="file://$PROJECT_DIR$/README.md">
+      <provider editor-type-id="MarkdownPreviewEditor">
+        <state />
+      </provider>
+      <provider selected="true" editor-type-id="text-editor">
+        <state relative-caret-position="231">
+          <caret line="85" column="13" selection-start-line="85" selection-start-column="13" selection-end-line="85" selection-end-column="13" />
+          <folding />
         </state>
       </provider>
     </entry>
     <entry file="file://$PROJECT_DIR$/examples/example.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="285">
-          <caret line="15" column="16" selection-start-line="15" selection-start-column="16" selection-end-line="15" selection-end-column="16" />
+        <state relative-caret-position="133">
+          <caret line="7" column="0" selection-start-line="7" selection-start-column="0" selection-end-line="7" selection-end-column="0" />
           <folding>
             <element signature="e#0#9#0" expanded="true" />
           </folding>
@@ -781,47 +839,69 @@
     </entry>
     <entry file="file://$PROJECT_DIR$/proxypool/getter.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="-19">
-          <caret line="29" column="4" selection-start-line="29" selection-start-column="4" selection-end-line="29" selection-end-column="4" />
+        <state relative-caret-position="21">
+          <caret line="69" column="0" selection-start-line="69" selection-start-column="0" selection-end-line="69" selection-end-column="0" />
           <folding>
             <element signature="e#0#27#0" expanded="true" />
           </folding>
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/proxypool/schedule.py">
+    <entry file="file://$PROJECT_DIR$/proxypool/setting.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="133">
-          <caret line="7" column="14" selection-start-line="7" selection-start-column="14" selection-end-line="7" selection-end-column="14" />
+        <state relative-caret-position="228">
+          <caret line="12" column="31" selection-start-line="12" selection-start-column="31" selection-end-line="12" selection-end-column="31" />
           <folding />
         </state>
       </provider>
     </entry>
-    <entry file="file://$PROJECT_DIR$/proxypool/setting.py">
+    <entry file="file://$PROJECT_DIR$/proxypool/utils.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="0">
-          <caret line="0" column="0" selection-start-line="0" selection-start-column="0" selection-end-line="0" selection-end-column="0" />
-          <folding />
+        <state relative-caret-position="-171">
+          <caret line="15" column="8" selection-start-line="15" selection-start-column="8" selection-end-line="15" selection-end-column="8" />
+          <folding>
+            <element signature="e#0#15#0" expanded="true" />
+          </folding>
+        </state>
+      </provider>
+    </entry>
+    <entry file="file://$PROJECT_DIR$/proxypool/schedule.py">
+      <provider selected="true" editor-type-id="text-editor">
+        <state relative-caret-position="418">
+          <caret line="46" column="0" selection-start-line="46" selection-start-column="0" selection-end-line="46" selection-end-column="0" />
+          <folding>
+            <element signature="e#0#11#0" expanded="true" />
+          </folding>
         </state>
       </provider>
     </entry>
     <entry file="file://$PROJECT_DIR$/proxypool/error.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="57">
-          <caret line="3" column="11" selection-start-line="3" selection-start-column="11" selection-end-line="3" selection-end-column="11" />
+        <state relative-caret-position="304">
+          <caret line="16" column="7" selection-start-line="16" selection-start-column="7" selection-end-line="16" selection-end-column="7" />
           <folding />
         </state>
       </provider>
     </entry>
     <entry file="file://$PROJECT_DIR$/proxypool/db.py">
       <provider selected="true" editor-type-id="text-editor">
-        <state relative-caret-position="1045">
-          <caret line="55" column="26" selection-start-line="55" selection-start-column="26" selection-end-line="55" selection-end-column="26" />
+        <state relative-caret-position="817">
+          <caret line="53" column="27" selection-start-line="53" selection-start-column="27" selection-end-line="53" selection-end-column="27" />
           <folding>
             <element signature="e#0#12#0" expanded="true" />
           </folding>
         </state>
       </provider>
     </entry>
+    <entry file="file://$PROJECT_DIR$/proxypool/api.py">
+      <provider selected="true" editor-type-id="text-editor">
+        <state relative-caret-position="209">
+          <caret line="11" column="26" selection-start-line="11" selection-start-column="26" selection-end-line="11" selection-end-column="26" />
+          <folding>
+            <element signature="e#0#26#0" expanded="true" />
+          </folding>
+        </state>
+      </provider>
+    </entry>
   </component>
 </project>

docs/Makefile

@@ -1,225 +0,0 @@
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = _build
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: help
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  applehelp  to make an Apple Help Book"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  epub3      to make an epub3"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  xml        to make Docutils-native XML files"
-	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-	@echo "  coverage   to run coverage check of the documentation (if enabled)"
-	@echo "  dummy      to check syntax errors of document sources"
-
-.PHONY: clean
-clean:
-	rm -rf $(BUILDDIR)/*
-
-.PHONY: html
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-.PHONY: dirhtml
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-.PHONY: singlehtml
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-.PHONY: pickle
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-.PHONY: json
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-.PHONY: htmlhelp
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-.PHONY: qthelp
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/proxypool.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/proxypool.qhc"
-
-.PHONY: applehelp
-applehelp:
-	$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
-	@echo
-	@echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
-	@echo "N.B. You won't be able to view it unless you put it in" \
-	      "~/Library/Documentation/Help or install it in your application" \
-	      "bundle."
-
-.PHONY: devhelp
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/proxypool"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/proxypool"
-	@echo "# devhelp"
-
-.PHONY: epub
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-.PHONY: epub3
-epub3:
-	$(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3
-	@echo
-	@echo "Build finished. The epub3 file is in $(BUILDDIR)/epub3."
-
-.PHONY: latex
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-.PHONY: latexpdf
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-.PHONY: latexpdfja
-latexpdfja:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through platex and dvipdfmx..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-.PHONY: text
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-.PHONY: man
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-.PHONY: texinfo
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-.PHONY: info
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-.PHONY: gettext
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-.PHONY: changes
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-.PHONY: linkcheck
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-.PHONY: doctest
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
-
-.PHONY: coverage
-coverage:
-	$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
-	@echo "Testing of coverage in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/coverage/python.txt."
-
-.PHONY: xml
-xml:
-	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
-	@echo
-	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
-
-.PHONY: pseudoxml
-pseudoxml:
-	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
-	@echo
-	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
-
-.PHONY: dummy
-dummy:
-	$(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy
-	@echo
-	@echo "Build finished. Dummy builder generates no files."

docs/_build/html/.buildinfo

@@ -1,4 +0,0 @@
-# Sphinx build info version 1
-# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 1b8b833db0798ac0297d31bbe796b196
-tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_build/html/_modules/flask/app.html

@@ -1,2094 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.app &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.app</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.app</span>
-<span class="sd">    ~~~~~~~~~</span>
-
-<span class="sd">    This module implements the central WSGI application object.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">import</span> <span class="nn">sys</span>
-<span class="kn">from</span> <span class="nn">threading</span> <span class="k">import</span> <span class="n">Lock</span>
-<span class="kn">from</span> <span class="nn">datetime</span> <span class="k">import</span> <span class="n">timedelta</span>
-<span class="kn">from</span> <span class="nn">itertools</span> <span class="k">import</span> <span class="n">chain</span>
-<span class="kn">from</span> <span class="nn">functools</span> <span class="k">import</span> <span class="n">update_wrapper</span>
-<span class="kn">from</span> <span class="nn">collections</span> <span class="k">import</span> <span class="n">deque</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.datastructures</span> <span class="k">import</span> <span class="n">ImmutableDict</span>
-<span class="kn">from</span> <span class="nn">werkzeug.routing</span> <span class="k">import</span> <span class="n">Map</span><span class="p">,</span> <span class="n">Rule</span><span class="p">,</span> <span class="n">RequestRedirect</span><span class="p">,</span> <span class="n">BuildError</span>
-<span class="kn">from</span> <span class="nn">werkzeug.exceptions</span> <span class="k">import</span> <span class="n">HTTPException</span><span class="p">,</span> <span class="n">InternalServerError</span><span class="p">,</span> \
-     <span class="n">MethodNotAllowed</span><span class="p">,</span> <span class="n">BadRequest</span><span class="p">,</span> <span class="n">default_exceptions</span>
-
-<span class="kn">from</span> <span class="nn">.helpers</span> <span class="k">import</span> <span class="n">_PackageBoundObject</span><span class="p">,</span> <span class="n">url_for</span><span class="p">,</span> <span class="n">get_flashed_messages</span><span class="p">,</span> \
-     <span class="n">locked_cached_property</span><span class="p">,</span> <span class="n">_endpoint_from_view_func</span><span class="p">,</span> <span class="n">find_package</span><span class="p">,</span> \
-     <span class="n">get_debug_flag</span>
-<span class="kn">from</span> <span class="nn">.</span> <span class="k">import</span> <span class="n">json</span><span class="p">,</span> <span class="n">cli</span>
-<span class="kn">from</span> <span class="nn">.wrappers</span> <span class="k">import</span> <span class="n">Request</span><span class="p">,</span> <span class="n">Response</span>
-<span class="kn">from</span> <span class="nn">.config</span> <span class="k">import</span> <span class="n">ConfigAttribute</span><span class="p">,</span> <span class="n">Config</span>
-<span class="kn">from</span> <span class="nn">.ctx</span> <span class="k">import</span> <span class="n">RequestContext</span><span class="p">,</span> <span class="n">AppContext</span><span class="p">,</span> <span class="n">_AppCtxGlobals</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">session</span><span class="p">,</span> <span class="n">g</span>
-<span class="kn">from</span> <span class="nn">.sessions</span> <span class="k">import</span> <span class="n">SecureCookieSessionInterface</span>
-<span class="kn">from</span> <span class="nn">.templating</span> <span class="k">import</span> <span class="n">DispatchingJinjaLoader</span><span class="p">,</span> <span class="n">Environment</span><span class="p">,</span> \
-     <span class="n">_default_template_ctx_processor</span>
-<span class="kn">from</span> <span class="nn">.signals</span> <span class="k">import</span> <span class="n">request_started</span><span class="p">,</span> <span class="n">request_finished</span><span class="p">,</span> <span class="n">got_request_exception</span><span class="p">,</span> \
-     <span class="n">request_tearing_down</span><span class="p">,</span> <span class="n">appcontext_tearing_down</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">reraise</span><span class="p">,</span> <span class="n">string_types</span><span class="p">,</span> <span class="n">text_type</span><span class="p">,</span> <span class="n">integer_types</span>
-
-<span class="c1"># a lock used for logger initialization</span>
-<span class="n">_logger_lock</span> <span class="o">=</span> <span class="n">Lock</span><span class="p">()</span>
-
-<span class="c1"># a singleton sentinel value for parameter defaults</span>
-<span class="n">_sentinel</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span>
-
-
-<span class="k">def</span> <span class="nf">_make_timedelta</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">timedelta</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">timedelta</span><span class="p">(</span><span class="n">seconds</span><span class="o">=</span><span class="n">value</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">value</span>
-
-
-<div class="viewcode-block" id="setupmethod"><a class="viewcode-back" href="../../flask/flask.html#flask.app.setupmethod">[docs]</a><span class="k">def</span> <span class="nf">setupmethod</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Wraps a method so that it performs a check in debug mode if the</span>
-<span class="sd">    first request was already handled.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">def</span> <span class="nf">wrapper_func</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">AssertionError</span><span class="p">(</span><span class="s1">&#39;A setup function was called after the &#39;</span>
-                <span class="s1">&#39;first request was handled.  This usually indicates a bug &#39;</span>
-                <span class="s1">&#39;in the application where a module was not imported &#39;</span>
-                <span class="s1">&#39;and decorators or other functionality was called too late.</span><span class="se">\n</span><span class="s1">&#39;</span>
-                <span class="s1">&#39;To fix this make sure to import all your view modules, &#39;</span>
-                <span class="s1">&#39;database models and everything related at a central place &#39;</span>
-                <span class="s1">&#39;before the application starts serving requests.&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">update_wrapper</span><span class="p">(</span><span class="n">wrapper_func</span><span class="p">,</span> <span class="n">f</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="Flask"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask">[docs]</a><span class="k">class</span> <span class="nc">Flask</span><span class="p">(</span><span class="n">_PackageBoundObject</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The flask object implements a WSGI application and acts as the central</span>
-<span class="sd">    object.  It is passed the name of the module or package of the</span>
-<span class="sd">    application.  Once it is created it will act as a central registry for</span>
-<span class="sd">    the view functions, the URL rules, template configuration and much more.</span>
-
-<span class="sd">    The name of the package is used to resolve resources from inside the</span>
-<span class="sd">    package or the folder the module is contained in depending on if the</span>
-<span class="sd">    package parameter resolves to an actual python package (a folder with</span>
-<span class="sd">    an :file:`__init__.py` file inside) or a standard module (just a ``.py`` file).</span>
-
-<span class="sd">    For more information about resource loading, see :func:`open_resource`.</span>
-
-<span class="sd">    Usually you create a :class:`Flask` instance in your main module or</span>
-<span class="sd">    in the :file:`__init__.py` file of your package like this::</span>
-
-<span class="sd">        from flask import Flask</span>
-<span class="sd">        app = Flask(__name__)</span>
-
-<span class="sd">    .. admonition:: About the First Parameter</span>
-
-<span class="sd">        The idea of the first parameter is to give Flask an idea of what</span>
-<span class="sd">        belongs to your application.  This name is used to find resources</span>
-<span class="sd">        on the filesystem, can be used by extensions to improve debugging</span>
-<span class="sd">        information and a lot more.</span>
-
-<span class="sd">        So it&#39;s important what you provide there.  If you are using a single</span>
-<span class="sd">        module, `__name__` is always the correct value.  If you however are</span>
-<span class="sd">        using a package, it&#39;s usually recommended to hardcode the name of</span>
-<span class="sd">        your package there.</span>
-
-<span class="sd">        For example if your application is defined in :file:`yourapplication/app.py`</span>
-<span class="sd">        you should create it with one of the two versions below::</span>
-
-<span class="sd">            app = Flask(&#39;yourapplication&#39;)</span>
-<span class="sd">            app = Flask(__name__.split(&#39;.&#39;)[0])</span>
-
-<span class="sd">        Why is that?  The application will work even with `__name__`, thanks</span>
-<span class="sd">        to how resources are looked up.  However it will make debugging more</span>
-<span class="sd">        painful.  Certain extensions can make assumptions based on the</span>
-<span class="sd">        import name of your application.  For example the Flask-SQLAlchemy</span>
-<span class="sd">        extension will look for the code in your application that triggered</span>
-<span class="sd">        an SQL query in debug mode.  If the import name is not properly set</span>
-<span class="sd">        up, that debugging information is lost.  (For example it would only</span>
-<span class="sd">        pick up SQL queries in `yourapplication.app` and not</span>
-<span class="sd">        `yourapplication.views.frontend`)</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">       The `static_url_path`, `static_folder`, and `template_folder`</span>
-<span class="sd">       parameters were added.</span>
-
-<span class="sd">    .. versionadded:: 0.8</span>
-<span class="sd">       The `instance_path` and `instance_relative_config` parameters were</span>
-<span class="sd">       added.</span>
-
-<span class="sd">    .. versionadded:: 0.11</span>
-<span class="sd">       The `root_path` parameter was added.</span>
-
-<span class="sd">    :param import_name: the name of the application package</span>
-<span class="sd">    :param static_url_path: can be used to specify a different path for the</span>
-<span class="sd">                            static files on the web.  Defaults to the name</span>
-<span class="sd">                            of the `static_folder` folder.</span>
-<span class="sd">    :param static_folder: the folder with static files that should be served</span>
-<span class="sd">                          at `static_url_path`.  Defaults to the ``&#39;static&#39;``</span>
-<span class="sd">                          folder in the root path of the application.</span>
-<span class="sd">    :param template_folder: the folder that contains the templates that should</span>
-<span class="sd">                            be used by the application.  Defaults to</span>
-<span class="sd">                            ``&#39;templates&#39;`` folder in the root path of the</span>
-<span class="sd">                            application.</span>
-<span class="sd">    :param instance_path: An alternative instance path for the application.</span>
-<span class="sd">                          By default the folder ``&#39;instance&#39;`` next to the</span>
-<span class="sd">                          package or module is assumed to be the instance</span>
-<span class="sd">                          path.</span>
-<span class="sd">    :param instance_relative_config: if set to ``True`` relative filenames</span>
-<span class="sd">                                     for loading the config are assumed to</span>
-<span class="sd">                                     be relative to the instance path instead</span>
-<span class="sd">                                     of the application root.</span>
-<span class="sd">    :param root_path: Flask by default will automatically calculate the path</span>
-<span class="sd">                      to the root of the application.  In certain situations</span>
-<span class="sd">                      this cannot be achieved (for instance if the package</span>
-<span class="sd">                      is a Python 3 namespace package) and needs to be</span>
-<span class="sd">                      manually defined.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="c1">#: The class that is used for request objects.  See :class:`~flask.Request`</span>
-    <span class="c1">#: for more information.</span>
-    <span class="n">request_class</span> <span class="o">=</span> <span class="n">Request</span>
-
-    <span class="c1">#: The class that is used for response objects.  See</span>
-    <span class="c1">#: :class:`~flask.Response` for more information.</span>
-    <span class="n">response_class</span> <span class="o">=</span> <span class="n">Response</span>
-
-    <span class="c1">#: The class that is used for the Jinja environment.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.11</span>
-    <span class="n">jinja_environment</span> <span class="o">=</span> <span class="n">Environment</span>
-
-    <span class="c1">#: The class that is used for the :data:`~flask.g` instance.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: Example use cases for a custom class:</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: 1. Store arbitrary attributes on flask.g.</span>
-    <span class="c1">#: 2. Add a property for lazy per-request database connectors.</span>
-    <span class="c1">#: 3. Return None instead of AttributeError on unexpected attributes.</span>
-    <span class="c1">#: 4. Raise exception if an unexpected attr is set, a &quot;controlled&quot; flask.g.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: In Flask 0.9 this property was called `request_globals_class` but it</span>
-    <span class="c1">#: was changed in 0.10 to :attr:`app_ctx_globals_class` because the</span>
-    <span class="c1">#: flask.g object is now application context scoped.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.10</span>
-    <span class="n">app_ctx_globals_class</span> <span class="o">=</span> <span class="n">_AppCtxGlobals</span>
-
-    <span class="c1"># Backwards compatibility support</span>
-    <span class="k">def</span> <span class="nf">_get_request_globals_class</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">app_ctx_globals_class</span>
-    <span class="k">def</span> <span class="nf">_set_request_globals_class</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-        <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;request_globals_class attribute is now &#39;</span>
-                                <span class="s1">&#39;called app_ctx_globals_class&#39;</span><span class="p">))</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app_ctx_globals_class</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="n">request_globals_class</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_request_globals_class</span><span class="p">,</span>
-                                     <span class="n">_set_request_globals_class</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_request_globals_class</span><span class="p">,</span> <span class="n">_set_request_globals_class</span>
-
-    <span class="c1">#: The class that is used for the ``config`` attribute of this app.</span>
-    <span class="c1">#: Defaults to :class:`~flask.Config`.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: Example use cases for a custom class:</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: 1. Default values for certain config options.</span>
-    <span class="c1">#: 2. Access to config values through attributes in addition to keys.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.11</span>
-    <span class="n">config_class</span> <span class="o">=</span> <span class="n">Config</span>
-
-    <span class="c1">#: The debug flag.  Set this to ``True`` to enable debugging of the</span>
-    <span class="c1">#: application.  In debug mode the debugger will kick in when an unhandled</span>
-    <span class="c1">#: exception occurs and the integrated server will automatically reload</span>
-    <span class="c1">#: the application if changes in the code are detected.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the ``DEBUG``</span>
-    <span class="c1">#: configuration key.  Defaults to ``False``.</span>
-    <span class="n">debug</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;DEBUG&#39;</span><span class="p">)</span>
-
-    <span class="c1">#: The testing flag.  Set this to ``True`` to enable the test mode of</span>
-    <span class="c1">#: Flask extensions (and in the future probably also Flask itself).</span>
-    <span class="c1">#: For example this might activate unittest helpers that have an</span>
-    <span class="c1">#: additional runtime cost which should not be enabled by default.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: If this is enabled and PROPAGATE_EXCEPTIONS is not changed from the</span>
-    <span class="c1">#: default it&#39;s implicitly enabled.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the</span>
-    <span class="c1">#: ``TESTING`` configuration key.  Defaults to ``False``.</span>
-    <span class="n">testing</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;TESTING&#39;</span><span class="p">)</span>
-
-    <span class="c1">#: If a secret key is set, cryptographic components can use this to</span>
-    <span class="c1">#: sign cookies and other things.  Set this to a complex random value</span>
-    <span class="c1">#: when you want to use the secure cookie for instance.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the</span>
-    <span class="c1">#: ``SECRET_KEY`` configuration key.  Defaults to ``None``.</span>
-    <span class="n">secret_key</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;SECRET_KEY&#39;</span><span class="p">)</span>
-
-    <span class="c1">#: The secure cookie uses this for the name of the session cookie.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the</span>
-    <span class="c1">#: ``SESSION_COOKIE_NAME`` configuration key.  Defaults to ``&#39;session&#39;``</span>
-    <span class="n">session_cookie_name</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;SESSION_COOKIE_NAME&#39;</span><span class="p">)</span>
-
-    <span class="c1">#: A :class:`~datetime.timedelta` which is used to set the expiration</span>
-    <span class="c1">#: date of a permanent session.  The default is 31 days which makes a</span>
-    <span class="c1">#: permanent session survive for roughly one month.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the</span>
-    <span class="c1">#: ``PERMANENT_SESSION_LIFETIME`` configuration key.  Defaults to</span>
-    <span class="c1">#: ``timedelta(days=31)``</span>
-    <span class="n">permanent_session_lifetime</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;PERMANENT_SESSION_LIFETIME&#39;</span><span class="p">,</span>
-        <span class="n">get_converter</span><span class="o">=</span><span class="n">_make_timedelta</span><span class="p">)</span>
-
-    <span class="c1">#: A :class:`~datetime.timedelta` which is used as default cache_timeout</span>
-    <span class="c1">#: for the :func:`send_file` functions. The default is 12 hours.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the</span>
-    <span class="c1">#: ``SEND_FILE_MAX_AGE_DEFAULT`` configuration key. This configuration</span>
-    <span class="c1">#: variable can also be set with an integer value used as seconds.</span>
-    <span class="c1">#: Defaults to ``timedelta(hours=12)``</span>
-    <span class="n">send_file_max_age_default</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;SEND_FILE_MAX_AGE_DEFAULT&#39;</span><span class="p">,</span>
-        <span class="n">get_converter</span><span class="o">=</span><span class="n">_make_timedelta</span><span class="p">)</span>
-
-    <span class="c1">#: Enable this if you want to use the X-Sendfile feature.  Keep in</span>
-    <span class="c1">#: mind that the server has to support this.  This only affects files</span>
-    <span class="c1">#: sent with the :func:`send_file` method.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.2</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: This attribute can also be configured from the config with the</span>
-    <span class="c1">#: ``USE_X_SENDFILE`` configuration key.  Defaults to ``False``.</span>
-    <span class="n">use_x_sendfile</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;USE_X_SENDFILE&#39;</span><span class="p">)</span>
-
-    <span class="c1">#: The name of the logger to use.  By default the logger name is the</span>
-    <span class="c1">#: package name passed to the constructor.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.4</span>
-    <span class="n">logger_name</span> <span class="o">=</span> <span class="n">ConfigAttribute</span><span class="p">(</span><span class="s1">&#39;LOGGER_NAME&#39;</span><span class="p">)</span>
-
-    <span class="c1">#: The JSON encoder class to use.  Defaults to :class:`~flask.json.JSONEncoder`.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.10</span>
-    <span class="n">json_encoder</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">JSONEncoder</span>
-
-    <span class="c1">#: The JSON decoder class to use.  Defaults to :class:`~flask.json.JSONDecoder`.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.10</span>
-    <span class="n">json_decoder</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">JSONDecoder</span>
-
-    <span class="c1">#: Options that are passed directly to the Jinja2 environment.</span>
-    <span class="n">jinja_options</span> <span class="o">=</span> <span class="n">ImmutableDict</span><span class="p">(</span>
-        <span class="n">extensions</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;jinja2.ext.autoescape&#39;</span><span class="p">,</span> <span class="s1">&#39;jinja2.ext.with_&#39;</span><span class="p">]</span>
-    <span class="p">)</span>
-
-    <span class="c1">#: Default configuration parameters.</span>
-    <span class="n">default_config</span> <span class="o">=</span> <span class="n">ImmutableDict</span><span class="p">({</span>
-        <span class="s1">&#39;DEBUG&#39;</span><span class="p">:</span>                                <span class="n">get_debug_flag</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">False</span><span class="p">),</span>
-        <span class="s1">&#39;TESTING&#39;</span><span class="p">:</span>                              <span class="kc">False</span><span class="p">,</span>
-        <span class="s1">&#39;PROPAGATE_EXCEPTIONS&#39;</span><span class="p">:</span>                 <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;PRESERVE_CONTEXT_ON_EXCEPTION&#39;</span><span class="p">:</span>        <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;SECRET_KEY&#39;</span><span class="p">:</span>                           <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;PERMANENT_SESSION_LIFETIME&#39;</span><span class="p">:</span>           <span class="n">timedelta</span><span class="p">(</span><span class="n">days</span><span class="o">=</span><span class="mi">31</span><span class="p">),</span>
-        <span class="s1">&#39;USE_X_SENDFILE&#39;</span><span class="p">:</span>                       <span class="kc">False</span><span class="p">,</span>
-        <span class="s1">&#39;LOGGER_NAME&#39;</span><span class="p">:</span>                          <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;LOGGER_HANDLER_POLICY&#39;</span><span class="p">:</span>               <span class="s1">&#39;always&#39;</span><span class="p">,</span>
-        <span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">:</span>                          <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;APPLICATION_ROOT&#39;</span><span class="p">:</span>                     <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;SESSION_COOKIE_NAME&#39;</span><span class="p">:</span>                  <span class="s1">&#39;session&#39;</span><span class="p">,</span>
-        <span class="s1">&#39;SESSION_COOKIE_DOMAIN&#39;</span><span class="p">:</span>                <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;SESSION_COOKIE_PATH&#39;</span><span class="p">:</span>                  <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;SESSION_COOKIE_HTTPONLY&#39;</span><span class="p">:</span>              <span class="kc">True</span><span class="p">,</span>
-        <span class="s1">&#39;SESSION_COOKIE_SECURE&#39;</span><span class="p">:</span>                <span class="kc">False</span><span class="p">,</span>
-        <span class="s1">&#39;SESSION_REFRESH_EACH_REQUEST&#39;</span><span class="p">:</span>         <span class="kc">True</span><span class="p">,</span>
-        <span class="s1">&#39;MAX_CONTENT_LENGTH&#39;</span><span class="p">:</span>                   <span class="kc">None</span><span class="p">,</span>
-        <span class="s1">&#39;SEND_FILE_MAX_AGE_DEFAULT&#39;</span><span class="p">:</span>            <span class="n">timedelta</span><span class="p">(</span><span class="n">hours</span><span class="o">=</span><span class="mi">12</span><span class="p">),</span>
-        <span class="s1">&#39;TRAP_BAD_REQUEST_ERRORS&#39;</span><span class="p">:</span>              <span class="kc">False</span><span class="p">,</span>
-        <span class="s1">&#39;TRAP_HTTP_EXCEPTIONS&#39;</span><span class="p">:</span>                 <span class="kc">False</span><span class="p">,</span>
-        <span class="s1">&#39;EXPLAIN_TEMPLATE_LOADING&#39;</span><span class="p">:</span>             <span class="kc">False</span><span class="p">,</span>
-        <span class="s1">&#39;PREFERRED_URL_SCHEME&#39;</span><span class="p">:</span>                 <span class="s1">&#39;http&#39;</span><span class="p">,</span>
-        <span class="s1">&#39;JSON_AS_ASCII&#39;</span><span class="p">:</span>                        <span class="kc">True</span><span class="p">,</span>
-        <span class="s1">&#39;JSON_SORT_KEYS&#39;</span><span class="p">:</span>                       <span class="kc">True</span><span class="p">,</span>
-        <span class="s1">&#39;JSONIFY_PRETTYPRINT_REGULAR&#39;</span><span class="p">:</span>          <span class="kc">True</span><span class="p">,</span>
-        <span class="s1">&#39;JSONIFY_MIMETYPE&#39;</span><span class="p">:</span>                     <span class="s1">&#39;application/json&#39;</span><span class="p">,</span>
-        <span class="s1">&#39;TEMPLATES_AUTO_RELOAD&#39;</span><span class="p">:</span>                <span class="kc">None</span><span class="p">,</span>
-    <span class="p">})</span>
-
-    <span class="c1">#: The rule object to use for URL rules created.  This is used by</span>
-    <span class="c1">#: :meth:`add_url_rule`.  Defaults to :class:`werkzeug.routing.Rule`.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.7</span>
-    <span class="n">url_rule_class</span> <span class="o">=</span> <span class="n">Rule</span>
-
-    <span class="c1">#: the test client that is used with when `test_client` is used.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.7</span>
-    <span class="n">test_client_class</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="c1">#: the session interface to use.  By default an instance of</span>
-    <span class="c1">#: :class:`~flask.sessions.SecureCookieSessionInterface` is used here.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.8</span>
-    <span class="n">session_interface</span> <span class="o">=</span> <span class="n">SecureCookieSessionInterface</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">import_name</span><span class="p">,</span> <span class="n">static_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">static_url_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">static_folder</span><span class="o">=</span><span class="s1">&#39;static&#39;</span><span class="p">,</span> <span class="n">template_folder</span><span class="o">=</span><span class="s1">&#39;templates&#39;</span><span class="p">,</span>
-                 <span class="n">instance_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">instance_relative_config</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-                 <span class="n">root_path</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">_PackageBoundObject</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">import_name</span><span class="p">,</span>
-                                     <span class="n">template_folder</span><span class="o">=</span><span class="n">template_folder</span><span class="p">,</span>
-                                     <span class="n">root_path</span><span class="o">=</span><span class="n">root_path</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">static_path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-            <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;static_path is now called &#39;</span>
-                                    <span class="s1">&#39;static_url_path&#39;</span><span class="p">),</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-            <span class="n">static_url_path</span> <span class="o">=</span> <span class="n">static_path</span>
-
-        <span class="k">if</span> <span class="n">static_url_path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">static_url_path</span> <span class="o">=</span> <span class="n">static_url_path</span>
-        <span class="k">if</span> <span class="n">static_folder</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">static_folder</span> <span class="o">=</span> <span class="n">static_folder</span>
-        <span class="k">if</span> <span class="n">instance_path</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">instance_path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">auto_find_instance_path</span><span class="p">()</span>
-        <span class="k">elif</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">instance_path</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;If an instance path is provided it must be &#39;</span>
-                             <span class="s1">&#39;absolute.  A relative path was given instead.&#39;</span><span class="p">)</span>
-
-        <span class="c1">#: Holds the path to the instance folder.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.8</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">instance_path</span> <span class="o">=</span> <span class="n">instance_path</span>
-
-        <span class="c1">#: The configuration dictionary as :class:`Config`.  This behaves</span>
-        <span class="c1">#: exactly like a regular dictionary but supports additional methods</span>
-        <span class="c1">#: to load a config from files.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">config</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_config</span><span class="p">(</span><span class="n">instance_relative_config</span><span class="p">)</span>
-
-        <span class="c1"># Prepare the deferred setup of the logger.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">logger_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">import_name</span>
-
-        <span class="c1">#: A dictionary of all view functions registered.  The keys will</span>
-        <span class="c1">#: be function names which are also used to generate URLs and</span>
-        <span class="c1">#: the values are the function objects themselves.</span>
-        <span class="c1">#: To register a view function, use the :meth:`route` decorator.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">view_functions</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1"># support for the now deprecated `error_handlers` attribute.  The</span>
-        <span class="c1"># :attr:`error_handler_spec` shall be used now.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_error_handlers</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: A dictionary of all registered error handlers.  The key is ``None``</span>
-        <span class="c1">#: for error handlers active on the application, otherwise the key is</span>
-        <span class="c1">#: the name of the blueprint.  Each key points to another dictionary</span>
-        <span class="c1">#: where the key is the status code of the http exception.  The</span>
-        <span class="c1">#: special key ``None`` points to a list of tuples where the first item</span>
-        <span class="c1">#: is the class for the instance check and the second the error handler</span>
-        <span class="c1">#: function.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: To register a error handler, use the :meth:`errorhandler`</span>
-        <span class="c1">#: decorator.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">error_handler_spec</span> <span class="o">=</span> <span class="p">{</span><span class="kc">None</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_error_handlers</span><span class="p">}</span>
-
-        <span class="c1">#: A list of functions that are called when :meth:`url_for` raises a</span>
-        <span class="c1">#: :exc:`~werkzeug.routing.BuildError`.  Each function registered here</span>
-        <span class="c1">#: is called with `error`, `endpoint` and `values`.  If a function</span>
-        <span class="c1">#: returns ``None`` or raises a :exc:`BuildError` the next function is</span>
-        <span class="c1">#: tried.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.9</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_build_error_handlers</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="c1">#: A dictionary with lists of functions that should be called at the</span>
-        <span class="c1">#: beginning of the request.  The key of the dictionary is the name of</span>
-        <span class="c1">#: the blueprint this function is active for, ``None`` for all requests.</span>
-        <span class="c1">#: This can for example be used to open database connections or</span>
-        <span class="c1">#: getting hold of the currently logged in user.  To register a</span>
-        <span class="c1">#: function here, use the :meth:`before_request` decorator.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">before_request_funcs</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: A lists of functions that should be called at the beginning of the</span>
-        <span class="c1">#: first request to this instance.  To register a function here, use</span>
-        <span class="c1">#: the :meth:`before_first_request` decorator.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.8</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">before_first_request_funcs</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="c1">#: A dictionary with lists of functions that should be called after</span>
-        <span class="c1">#: each request.  The key of the dictionary is the name of the blueprint</span>
-        <span class="c1">#: this function is active for, ``None`` for all requests.  This can for</span>
-        <span class="c1">#: example be used to close database connections. To register a function</span>
-        <span class="c1">#: here, use the :meth:`after_request` decorator.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">after_request_funcs</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: A dictionary with lists of functions that are called after</span>
-        <span class="c1">#: each request, even if an exception has occurred. The key of the</span>
-        <span class="c1">#: dictionary is the name of the blueprint this function is active for,</span>
-        <span class="c1">#: ``None`` for all requests. These functions are not allowed to modify</span>
-        <span class="c1">#: the request, and their return values are ignored. If an exception</span>
-        <span class="c1">#: occurred while processing the request, it gets passed to each</span>
-        <span class="c1">#: teardown_request function. To register a function here, use the</span>
-        <span class="c1">#: :meth:`teardown_request` decorator.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.7</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">teardown_request_funcs</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: A list of functions that are called when the application context</span>
-        <span class="c1">#: is destroyed.  Since the application context is also torn down</span>
-        <span class="c1">#: if the request ends this is the place to store code that disconnects</span>
-        <span class="c1">#: from databases.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.9</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">teardown_appcontext_funcs</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="c1">#: A dictionary with lists of functions that can be used as URL</span>
-        <span class="c1">#: value processor functions.  Whenever a URL is built these functions</span>
-        <span class="c1">#: are called to modify the dictionary of values in place.  The key</span>
-        <span class="c1">#: ``None`` here is used for application wide</span>
-        <span class="c1">#: callbacks, otherwise the key is the name of the blueprint.</span>
-        <span class="c1">#: Each of these functions has the chance to modify the dictionary</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.7</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_value_preprocessors</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: A dictionary with lists of functions that can be used as URL value</span>
-        <span class="c1">#: preprocessors.  The key ``None`` here is used for application wide</span>
-        <span class="c1">#: callbacks, otherwise the key is the name of the blueprint.</span>
-        <span class="c1">#: Each of these functions has the chance to modify the dictionary</span>
-        <span class="c1">#: of URL values before they are used as the keyword arguments of the</span>
-        <span class="c1">#: view function.  For each function registered this one should also</span>
-        <span class="c1">#: provide a :meth:`url_defaults` function that adds the parameters</span>
-        <span class="c1">#: automatically again that were removed that way.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.7</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_default_functions</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: A dictionary with list of functions that are called without argument</span>
-        <span class="c1">#: to populate the template context.  The key of the dictionary is the</span>
-        <span class="c1">#: name of the blueprint this function is active for, ``None`` for all</span>
-        <span class="c1">#: requests.  Each returns a dictionary that the template context is</span>
-        <span class="c1">#: updated with.  To register a function here, use the</span>
-        <span class="c1">#: :meth:`context_processor` decorator.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">template_context_processors</span> <span class="o">=</span> <span class="p">{</span>
-            <span class="kc">None</span><span class="p">:</span> <span class="p">[</span><span class="n">_default_template_ctx_processor</span><span class="p">]</span>
-        <span class="p">}</span>
-
-        <span class="c1">#: A list of shell context processor functions that should be run</span>
-        <span class="c1">#: when a shell context is created.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.11</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">shell_context_processors</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="c1">#: all the attached blueprints in a dictionary by name.  Blueprints</span>
-        <span class="c1">#: can be attached multiple times so this dictionary does not tell</span>
-        <span class="c1">#: you how often they got attached.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.7</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">blueprints</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_blueprint_order</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="c1">#: a place where extensions can store application specific state.  For</span>
-        <span class="c1">#: example this is where an extension could store database engines and</span>
-        <span class="c1">#: similar things.  For backwards compatibility extensions should register</span>
-        <span class="c1">#: themselves like this::</span>
-        <span class="c1">#:</span>
-        <span class="c1">#:      if not hasattr(app, &#39;extensions&#39;):</span>
-        <span class="c1">#:          app.extensions = {}</span>
-        <span class="c1">#:      app.extensions[&#39;extensionname&#39;] = SomeObject()</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: The key must match the name of the extension module. For example in</span>
-        <span class="c1">#: case of a &quot;Flask-Foo&quot; extension in `flask_foo`, the key would be</span>
-        <span class="c1">#: ``&#39;foo&#39;``.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: .. versionadded:: 0.7</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">extensions</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="c1">#: The :class:`~werkzeug.routing.Map` for this instance.  You can use</span>
-        <span class="c1">#: this to change the routing converters after the class was created</span>
-        <span class="c1">#: but before any routes are connected.  Example::</span>
-        <span class="c1">#:</span>
-        <span class="c1">#:    from werkzeug.routing import BaseConverter</span>
-        <span class="c1">#:</span>
-        <span class="c1">#:    class ListConverter(BaseConverter):</span>
-        <span class="c1">#:        def to_python(self, value):</span>
-        <span class="c1">#:            return value.split(&#39;,&#39;)</span>
-        <span class="c1">#:        def to_url(self, values):</span>
-        <span class="c1">#:            return &#39;,&#39;.join(BaseConverter.to_url(value)</span>
-        <span class="c1">#:                            for value in values)</span>
-        <span class="c1">#:</span>
-        <span class="c1">#:    app = Flask(__name__)</span>
-        <span class="c1">#:    app.url_map.converters[&#39;list&#39;] = ListConverter</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_map</span> <span class="o">=</span> <span class="n">Map</span><span class="p">()</span>
-
-        <span class="c1"># tracks internally if the application already handled at least one</span>
-        <span class="c1"># request.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span> <span class="o">=</span> <span class="kc">False</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_before_request_lock</span> <span class="o">=</span> <span class="n">Lock</span><span class="p">()</span>
-
-        <span class="c1"># register the static folder for the application.  Do that even</span>
-        <span class="c1"># if the folder does not exist.  First of all it might be created</span>
-        <span class="c1"># while the server is running (usually happens during development)</span>
-        <span class="c1"># but also because google appengine stores static files somewhere</span>
-        <span class="c1"># else when mapped with the .yml file.</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">has_static_folder</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">static_url_path</span> <span class="o">+</span> <span class="s1">&#39;/&lt;path:filename&gt;&#39;</span><span class="p">,</span>
-                              <span class="n">endpoint</span><span class="o">=</span><span class="s1">&#39;static&#39;</span><span class="p">,</span>
-                              <span class="n">view_func</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">send_static_file</span><span class="p">)</span>
-
-        <span class="c1">#: The click command line context for this application.  Commands</span>
-        <span class="c1">#: registered here show up in the :command:`flask` command once the</span>
-        <span class="c1">#: application has been discovered.  The default commands are</span>
-        <span class="c1">#: provided by Flask itself and can be overridden.</span>
-        <span class="c1">#:</span>
-        <span class="c1">#: This is an instance of a :class:`click.Group` object.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">cli</span> <span class="o">=</span> <span class="n">cli</span><span class="o">.</span><span class="n">AppGroup</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_get_error_handlers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-        <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;error_handlers is deprecated, use the &#39;</span>
-            <span class="s1">&#39;new error_handler_spec attribute instead.&#39;</span><span class="p">),</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_error_handlers</span>
-    <span class="k">def</span> <span class="nf">_set_error_handlers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_error_handlers</span> <span class="o">=</span> <span class="n">value</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">error_handler_spec</span><span class="p">[</span><span class="kc">None</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="n">error_handlers</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_error_handlers</span><span class="p">,</span> <span class="n">_set_error_handlers</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_error_handlers</span><span class="p">,</span> <span class="n">_set_error_handlers</span>
-
-    <span class="nd">@locked_cached_property</span>
-<div class="viewcode-block" id="Flask.name"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.name">[docs]</a>    <span class="k">def</span> <span class="nf">name</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The name of the application.  This is usually the import name</span>
-<span class="sd">        with the difference that it&#39;s guessed from the run file if the</span>
-<span class="sd">        import name is main.  This name is used as a display name when</span>
-<span class="sd">        Flask needs the name of the application.  It can be set and overridden</span>
-<span class="sd">        to change the value.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">import_name</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>
-            <span class="n">fn</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="s1">&#39;__main__&#39;</span><span class="p">],</span> <span class="s1">&#39;__file__&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">fn</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="s1">&#39;__main__&#39;</span>
-            <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">splitext</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">basename</span><span class="p">(</span><span class="n">fn</span><span class="p">))[</span><span class="mi">0</span><span class="p">]</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">import_name</span></div>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">propagate_exceptions</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the value of the ``PROPAGATE_EXCEPTIONS`` configuration</span>
-<span class="sd">        value in case it&#39;s set, otherwise a sensible default is returned.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;PROPAGATE_EXCEPTIONS&#39;</span><span class="p">]</span>
-        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">rv</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">testing</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">preserve_context_on_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the value of the ``PRESERVE_CONTEXT_ON_EXCEPTION``</span>
-<span class="sd">        configuration value in case it&#39;s set, otherwise a sensible default</span>
-<span class="sd">        is returned.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;PRESERVE_CONTEXT_ON_EXCEPTION&#39;</span><span class="p">]</span>
-        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">rv</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">logger</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A :class:`logging.Logger` object for this application.  The</span>
-<span class="sd">        default configuration is to log to stderr if the application is</span>
-<span class="sd">        in debug mode.  This logger can be used to (surprise) log messages.</span>
-<span class="sd">        Here some examples::</span>
-
-<span class="sd">            app.logger.debug(&#39;A value for debugging&#39;)</span>
-<span class="sd">            app.logger.warning(&#39;A warning occurred (%d apples)&#39;, 42)</span>
-<span class="sd">            app.logger.error(&#39;An error occurred&#39;)</span>
-
-<span class="sd">        .. versionadded:: 0.3</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">logger_name</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span>
-        <span class="k">with</span> <span class="n">_logger_lock</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">logger_name</span><span class="p">:</span>
-                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span>
-            <span class="kn">from</span> <span class="nn">flask.logging</span> <span class="k">import</span> <span class="n">create_logger</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_logger</span> <span class="o">=</span> <span class="n">rv</span> <span class="o">=</span> <span class="n">create_logger</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="nd">@locked_cached_property</span>
-<div class="viewcode-block" id="Flask.jinja_env"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.jinja_env">[docs]</a>    <span class="k">def</span> <span class="nf">jinja_env</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The Jinja2 environment used to load templates.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_jinja_environment</span><span class="p">()</span></div>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">got_first_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This attribute is set to ``True`` if the application started</span>
-<span class="sd">        handling the first request.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span>
-
-<div class="viewcode-block" id="Flask.make_config"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.make_config">[docs]</a>    <span class="k">def</span> <span class="nf">make_config</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instance_relative</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Used to create the config attribute by the Flask constructor.</span>
-<span class="sd">        The `instance_relative` parameter is passed in from the constructor</span>
-<span class="sd">        of Flask (there named `instance_relative_config`) and indicates if</span>
-<span class="sd">        the config should be relative to the instance path or the root path</span>
-<span class="sd">        of the application.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">root_path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">root_path</span>
-        <span class="k">if</span> <span class="n">instance_relative</span><span class="p">:</span>
-            <span class="n">root_path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance_path</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">config_class</span><span class="p">(</span><span class="n">root_path</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_config</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.auto_find_instance_path"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.auto_find_instance_path">[docs]</a>    <span class="k">def</span> <span class="nf">auto_find_instance_path</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Tries to locate the instance path if it was not provided to the</span>
-<span class="sd">        constructor of the application class.  It will basically calculate</span>
-<span class="sd">        the path to a folder named ``instance`` next to your main file or</span>
-<span class="sd">        the package.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">prefix</span><span class="p">,</span> <span class="n">package_path</span> <span class="o">=</span> <span class="n">find_package</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">import_name</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">prefix</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">package_path</span><span class="p">,</span> <span class="s1">&#39;instance&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">prefix</span><span class="p">,</span> <span class="s1">&#39;var&#39;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">+</span> <span class="s1">&#39;-instance&#39;</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.open_instance_resource"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.open_instance_resource">[docs]</a>    <span class="k">def</span> <span class="nf">open_instance_resource</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">resource</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s1">&#39;rb&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Opens a resource from the application&#39;s instance folder</span>
-<span class="sd">        (:attr:`instance_path`).  Otherwise works like</span>
-<span class="sd">        :meth:`open_resource`.  Instance resources can also be opened for</span>
-<span class="sd">        writing.</span>
-
-<span class="sd">        :param resource: the name of the resource.  To access resources within</span>
-<span class="sd">                         subfolders use forward slashes as separator.</span>
-<span class="sd">        :param mode: resource file opening mode, default is &#39;rb&#39;.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">open</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance_path</span><span class="p">,</span> <span class="n">resource</span><span class="p">),</span> <span class="n">mode</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.create_jinja_environment"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.create_jinja_environment">[docs]</a>    <span class="k">def</span> <span class="nf">create_jinja_environment</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates the Jinja2 environment based on :attr:`jinja_options`</span>
-<span class="sd">        and :meth:`select_jinja_autoescape`.  Since 0.7 this also adds</span>
-<span class="sd">        the Jinja2 globals and filters after initialization.  Override</span>
-<span class="sd">        this function to customize the behavior.</span>
-
-<span class="sd">        .. versionadded:: 0.5</span>
-<span class="sd">        .. versionchanged:: 0.11</span>
-<span class="sd">           ``Environment.auto_reload`` set in accordance with</span>
-<span class="sd">           ``TEMPLATES_AUTO_RELOAD`` configuration option.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">options</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">jinja_options</span><span class="p">)</span>
-        <span class="k">if</span> <span class="s1">&#39;autoescape&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">options</span><span class="p">:</span>
-            <span class="n">options</span><span class="p">[</span><span class="s1">&#39;autoescape&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_jinja_autoescape</span>
-        <span class="k">if</span> <span class="s1">&#39;auto_reload&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">options</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;TEMPLATES_AUTO_RELOAD&#39;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">options</span><span class="p">[</span><span class="s1">&#39;auto_reload&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;TEMPLATES_AUTO_RELOAD&#39;</span><span class="p">]</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">options</span><span class="p">[</span><span class="s1">&#39;auto_reload&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">jinja_environment</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span>
-        <span class="n">rv</span><span class="o">.</span><span class="n">globals</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-            <span class="n">url_for</span><span class="o">=</span><span class="n">url_for</span><span class="p">,</span>
-            <span class="n">get_flashed_messages</span><span class="o">=</span><span class="n">get_flashed_messages</span><span class="p">,</span>
-            <span class="n">config</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">,</span>
-            <span class="c1"># request, session and g are normally added with the</span>
-            <span class="c1"># context processor for efficiency reasons but for imported</span>
-            <span class="c1"># templates we also want the proxies in there.</span>
-            <span class="n">request</span><span class="o">=</span><span class="n">request</span><span class="p">,</span>
-            <span class="n">session</span><span class="o">=</span><span class="n">session</span><span class="p">,</span>
-            <span class="n">g</span><span class="o">=</span><span class="n">g</span>
-        <span class="p">)</span>
-        <span class="n">rv</span><span class="o">.</span><span class="n">filters</span><span class="p">[</span><span class="s1">&#39;tojson&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">tojson_filter</span>
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="Flask.create_global_jinja_loader"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.create_global_jinja_loader">[docs]</a>    <span class="k">def</span> <span class="nf">create_global_jinja_loader</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates the loader for the Jinja2 environment.  Can be used to</span>
-<span class="sd">        override just the loader and keeping the rest unchanged.  It&#39;s</span>
-<span class="sd">        discouraged to override this function.  Instead one should override</span>
-<span class="sd">        the :meth:`jinja_loader` function instead.</span>
-
-<span class="sd">        The global loader dispatches between the loaders of the application</span>
-<span class="sd">        and the individual blueprints.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">DispatchingJinjaLoader</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.init_jinja_globals"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.init_jinja_globals">[docs]</a>    <span class="k">def</span> <span class="nf">init_jinja_globals</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Deprecated.  Used to initialize the Jinja2 globals.</span>
-
-<span class="sd">        .. versionadded:: 0.5</span>
-<span class="sd">        .. versionchanged:: 0.7</span>
-<span class="sd">           This method is deprecated with 0.7.  Override</span>
-<span class="sd">           :meth:`create_jinja_environment` instead.</span>
-<span class="sd">        &quot;&quot;&quot;</span></div>
-
-<div class="viewcode-block" id="Flask.select_jinja_autoescape"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.select_jinja_autoescape">[docs]</a>    <span class="k">def</span> <span class="nf">select_jinja_autoescape</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filename</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns ``True`` if autoescaping should be active for the given</span>
-<span class="sd">        template name. If no template name is given, returns `True`.</span>
-
-<span class="sd">        .. versionadded:: 0.5</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="n">filename</span><span class="o">.</span><span class="n">endswith</span><span class="p">((</span><span class="s1">&#39;.html&#39;</span><span class="p">,</span> <span class="s1">&#39;.htm&#39;</span><span class="p">,</span> <span class="s1">&#39;.xml&#39;</span><span class="p">,</span> <span class="s1">&#39;.xhtml&#39;</span><span class="p">))</span></div>
-
-<div class="viewcode-block" id="Flask.update_template_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.update_template_context">[docs]</a>    <span class="k">def</span> <span class="nf">update_template_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">context</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Update the template context with some commonly used variables.</span>
-<span class="sd">        This injects request, session, config and g into the template</span>
-<span class="sd">        context as well as everything template context processors want</span>
-<span class="sd">        to inject.  Note that the as of Flask 0.6, the original values</span>
-<span class="sd">        in the context will not be overridden if a context processor</span>
-<span class="sd">        decides to return a value with the same key.</span>
-
-<span class="sd">        :param context: the context as a dictionary that is updated in place</span>
-<span class="sd">                        to add extra variables.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">funcs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">template_context_processors</span><span class="p">[</span><span class="kc">None</span><span class="p">]</span>
-        <span class="n">reqctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">reqctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">bp</span> <span class="o">=</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span>
-            <span class="k">if</span> <span class="n">bp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">bp</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">template_context_processors</span><span class="p">:</span>
-                <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">template_context_processors</span><span class="p">[</span><span class="n">bp</span><span class="p">])</span>
-        <span class="n">orig_ctx</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="n">funcs</span><span class="p">:</span>
-            <span class="n">context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">func</span><span class="p">())</span>
-        <span class="c1"># make sure the original values win.  This makes it possible to</span>
-        <span class="c1"># easier add new variables in context processors without breaking</span>
-        <span class="c1"># existing views.</span>
-        <span class="n">context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">orig_ctx</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.make_shell_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.make_shell_context">[docs]</a>    <span class="k">def</span> <span class="nf">make_shell_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the shell context for an interactive shell for this</span>
-<span class="sd">        application.  This runs all the registered shell context</span>
-<span class="sd">        processors.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;app&#39;</span><span class="p">:</span> <span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;g&#39;</span><span class="p">:</span> <span class="n">g</span><span class="p">}</span>
-        <span class="k">for</span> <span class="n">processor</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">shell_context_processors</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">processor</span><span class="p">())</span>
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="Flask.run"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.run">[docs]</a>    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">port</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">debug</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Runs the application on a local development server.</span>
-
-<span class="sd">        Do not use ``run()`` in a production setting. It is not intended to</span>
-<span class="sd">        meet security and performance requirements for a production server.</span>
-<span class="sd">        Instead, see :ref:`deployment` for WSGI server recommendations.</span>
-
-<span class="sd">        If the :attr:`debug` flag is set the server will automatically reload</span>
-<span class="sd">        for code changes and show a debugger in case an exception happened.</span>
-
-<span class="sd">        If you want to run the application in debug mode, but disable the</span>
-<span class="sd">        code execution on the interactive debugger, you can pass</span>
-<span class="sd">        ``use_evalex=False`` as parameter.  This will keep the debugger&#39;s</span>
-<span class="sd">        traceback screen active, but disable code execution.</span>
-
-<span class="sd">        It is not recommended to use this function for development with</span>
-<span class="sd">        automatic reloading as this is badly supported.  Instead you should</span>
-<span class="sd">        be using the :command:`flask` command line script&#39;s ``run`` support.</span>
-
-<span class="sd">        .. admonition:: Keep in Mind</span>
-
-<span class="sd">           Flask will suppress any server error with a generic error page</span>
-<span class="sd">           unless it is in debug mode.  As such to enable just the</span>
-<span class="sd">           interactive debugger without the code reloading, you have to</span>
-<span class="sd">           invoke :meth:`run` with ``debug=True`` and ``use_reloader=False``.</span>
-<span class="sd">           Setting ``use_debugger`` to ``True`` without being in debug mode</span>
-<span class="sd">           won&#39;t catch any exceptions because there won&#39;t be any to</span>
-<span class="sd">           catch.</span>
-
-<span class="sd">        .. versionchanged:: 0.10</span>
-<span class="sd">           The default port is now picked from the ``SERVER_NAME`` variable.</span>
-
-<span class="sd">        :param host: the hostname to listen on. Set this to ``&#39;0.0.0.0&#39;`` to</span>
-<span class="sd">                     have the server available externally as well. Defaults to</span>
-<span class="sd">                     ``&#39;127.0.0.1&#39;``.</span>
-<span class="sd">        :param port: the port of the webserver. Defaults to ``5000`` or the</span>
-<span class="sd">                     port defined in the ``SERVER_NAME`` config variable if</span>
-<span class="sd">                     present.</span>
-<span class="sd">        :param debug: if given, enable or disable debug mode.</span>
-<span class="sd">                      See :attr:`debug`.</span>
-<span class="sd">        :param options: the options to be forwarded to the underlying</span>
-<span class="sd">                        Werkzeug server.  See</span>
-<span class="sd">                        :func:`werkzeug.serving.run_simple` for more</span>
-<span class="sd">                        information.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="kn">from</span> <span class="nn">werkzeug.serving</span> <span class="k">import</span> <span class="n">run_simple</span>
-        <span class="k">if</span> <span class="n">host</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">host</span> <span class="o">=</span> <span class="s1">&#39;127.0.0.1&#39;</span>
-        <span class="k">if</span> <span class="n">port</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">server_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">]</span>
-            <span class="k">if</span> <span class="n">server_name</span> <span class="ow">and</span> <span class="s1">&#39;:&#39;</span> <span class="ow">in</span> <span class="n">server_name</span><span class="p">:</span>
-                <span class="n">port</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">server_name</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s1">&#39;:&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">1</span><span class="p">])</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">port</span> <span class="o">=</span> <span class="mi">5000</span>
-        <span class="k">if</span> <span class="n">debug</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">debug</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="n">debug</span><span class="p">)</span>
-        <span class="n">options</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;use_reloader&#39;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span><span class="p">)</span>
-        <span class="n">options</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;use_debugger&#39;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span><span class="p">)</span>
-        <span class="n">options</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;passthrough_errors&#39;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">run_simple</span><span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">,</span> <span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="c1"># reset the first request information if the development server</span>
-            <span class="c1"># resetted normally.  This makes it possible to restart the server</span>
-            <span class="c1"># without reloader and that stuff from an interactive shell.</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span> <span class="o">=</span> <span class="kc">False</span></div>
-
-<div class="viewcode-block" id="Flask.test_client"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.test_client">[docs]</a>    <span class="k">def</span> <span class="nf">test_client</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">use_cookies</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a test client for this application.  For information</span>
-<span class="sd">        about unit testing head over to :ref:`testing`.</span>
-
-<span class="sd">        Note that if you are testing for assertions or exceptions in your</span>
-<span class="sd">        application code, you must set ``app.testing = True`` in order for the</span>
-<span class="sd">        exceptions to propagate to the test client.  Otherwise, the exception</span>
-<span class="sd">        will be handled by the application (not visible to the test client) and</span>
-<span class="sd">        the only indication of an AssertionError or other exception will be a</span>
-<span class="sd">        500 status code response to the test client.  See the :attr:`testing`</span>
-<span class="sd">        attribute.  For example::</span>
-
-<span class="sd">            app.testing = True</span>
-<span class="sd">            client = app.test_client()</span>
-
-<span class="sd">        The test client can be used in a ``with`` block to defer the closing down</span>
-<span class="sd">        of the context until the end of the ``with`` block.  This is useful if</span>
-<span class="sd">        you want to access the context locals for testing::</span>
-
-<span class="sd">            with app.test_client() as c:</span>
-<span class="sd">                rv = c.get(&#39;/?vodka=42&#39;)</span>
-<span class="sd">                assert request.args[&#39;vodka&#39;] == &#39;42&#39;</span>
-
-<span class="sd">        Additionally, you may pass optional keyword arguments that will then</span>
-<span class="sd">        be passed to the application&#39;s :attr:`test_client_class` constructor.</span>
-<span class="sd">        For example::</span>
-
-<span class="sd">            from flask.testing import FlaskClient</span>
-
-<span class="sd">            class CustomClient(FlaskClient):</span>
-<span class="sd">                def __init__(self, authentication=None, *args, **kwargs):</span>
-<span class="sd">                    FlaskClient.__init__(*args, **kwargs)</span>
-<span class="sd">                    self._authentication = authentication</span>
-
-<span class="sd">            app.test_client_class = CustomClient</span>
-<span class="sd">            client = app.test_client(authentication=&#39;Basic ....&#39;)</span>
-
-<span class="sd">        See :class:`~flask.testing.FlaskClient` for more information.</span>
-
-<span class="sd">        .. versionchanged:: 0.4</span>
-<span class="sd">           added support for ``with`` block usage for the client.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">           The `use_cookies` parameter was added as well as the ability</span>
-<span class="sd">           to override the client to be used by setting the</span>
-<span class="sd">           :attr:`test_client_class` attribute.</span>
-
-<span class="sd">        .. versionchanged:: 0.11</span>
-<span class="sd">           Added `**kwargs` to support passing additional keyword arguments to</span>
-<span class="sd">           the constructor of :attr:`test_client_class`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">cls</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">test_client_class</span>
-        <span class="k">if</span> <span class="n">cls</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="kn">from</span> <span class="nn">flask.testing</span> <span class="k">import</span> <span class="n">FlaskClient</span> <span class="k">as</span> <span class="n">cls</span>
-        <span class="k">return</span> <span class="n">cls</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">response_class</span><span class="p">,</span> <span class="n">use_cookies</span><span class="o">=</span><span class="n">use_cookies</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.open_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.open_session">[docs]</a>    <span class="k">def</span> <span class="nf">open_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates or opens a new session.  Default implementation stores all</span>
-<span class="sd">        session data in a signed cookie.  This requires that the</span>
-<span class="sd">        :attr:`secret_key` is set.  Instead of overriding this method</span>
-<span class="sd">        we recommend replacing the :class:`session_interface`.</span>
-
-<span class="sd">        :param request: an instance of :attr:`request_class`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_interface</span><span class="o">.</span><span class="n">open_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.save_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.save_session">[docs]</a>    <span class="k">def</span> <span class="nf">save_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">session</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Saves the session if it needs updates.  For the default</span>
-<span class="sd">        implementation, check :meth:`open_session`.  Instead of overriding this</span>
-<span class="sd">        method we recommend replacing the :class:`session_interface`.</span>
-
-<span class="sd">        :param session: the session to be saved (a</span>
-<span class="sd">                        :class:`~werkzeug.contrib.securecookie.SecureCookie`</span>
-<span class="sd">                        object)</span>
-<span class="sd">        :param response: an instance of :attr:`response_class`</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_interface</span><span class="o">.</span><span class="n">save_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">session</span><span class="p">,</span> <span class="n">response</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.make_null_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.make_null_session">[docs]</a>    <span class="k">def</span> <span class="nf">make_null_session</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a new instance of a missing session.  Instead of overriding</span>
-<span class="sd">        this method we recommend replacing the :class:`session_interface`.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_interface</span><span class="o">.</span><span class="n">make_null_session</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.register_blueprint"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.register_blueprint">[docs]</a>    <span class="k">def</span> <span class="nf">register_blueprint</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">blueprint</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a blueprint on the application. For information about </span>
-<span class="sd">        blueprints head over to :ref:`blueprints`.</span>
-
-<span class="sd">        The blueprint name is passed in as the first argument.	</span>
-<span class="sd">        Options are passed as additional keyword arguments and forwarded to </span>
-<span class="sd">        `blueprints` in an &quot;options&quot; dictionary.</span>
-
-<span class="sd">        :param subdomain: set a subdomain for the blueprint</span>
-<span class="sd">        :param url_prefix: set the prefix for all URLs defined on the blueprint.</span>
-<span class="sd">                            ``(url_prefix=&#39;/&lt;lang code&gt;&#39;)``</span>
-<span class="sd">        :param url_defaults: a dictionary with URL defaults that is added to </span>
-<span class="sd">                            each and every URL defined with this blueprint</span>
-<span class="sd">        :param static_folder: add a static folder to urls in this blueprint</span>
-<span class="sd">        :param static_url_path: add a static url path to urls in this blueprint</span>
-<span class="sd">        :param template_folder: set an alternate template folder</span>
-<span class="sd">        :param root_path: set an alternate root path for this blueprint</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">first_registration</span> <span class="o">=</span> <span class="kc">False</span>
-        <span class="k">if</span> <span class="n">blueprint</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">blueprints</span><span class="p">:</span>
-            <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">blueprints</span><span class="p">[</span><span class="n">blueprint</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> <span class="ow">is</span> <span class="n">blueprint</span><span class="p">,</span> \
-                <span class="s1">&#39;A blueprint</span><span class="se">\&#39;</span><span class="s1">s name collision occurred between </span><span class="si">%r</span><span class="s1"> and &#39;</span> \
-                <span class="s1">&#39;</span><span class="si">%r</span><span class="s1">.  Both share the same name &quot;</span><span class="si">%s</span><span class="s1">&quot;.  Blueprints that &#39;</span> \
-                <span class="s1">&#39;are created on the fly need unique names.&#39;</span> <span class="o">%</span> \
-                <span class="p">(</span><span class="n">blueprint</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">blueprints</span><span class="p">[</span><span class="n">blueprint</span><span class="o">.</span><span class="n">name</span><span class="p">],</span> <span class="n">blueprint</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">blueprints</span><span class="p">[</span><span class="n">blueprint</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">blueprint</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_blueprint_order</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">blueprint</span><span class="p">)</span>
-            <span class="n">first_registration</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="n">blueprint</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">first_registration</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.iter_blueprints"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.iter_blueprints">[docs]</a>    <span class="k">def</span> <span class="nf">iter_blueprints</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Iterates over all blueprints by the order they were registered.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_blueprint_order</span><span class="p">)</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.add_url_rule"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.add_url_rule">[docs]</a>    <span class="k">def</span> <span class="nf">add_url_rule</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">,</span> <span class="n">endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">view_func</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Connects a URL rule.  Works exactly like the :meth:`route`</span>
-<span class="sd">        decorator.  If a view_func is provided it will be registered with the</span>
-<span class="sd">        endpoint.</span>
-
-<span class="sd">        Basically this example::</span>
-
-<span class="sd">            @app.route(&#39;/&#39;)</span>
-<span class="sd">            def index():</span>
-<span class="sd">                pass</span>
-
-<span class="sd">        Is equivalent to the following::</span>
-
-<span class="sd">            def index():</span>
-<span class="sd">                pass</span>
-<span class="sd">            app.add_url_rule(&#39;/&#39;, &#39;index&#39;, index)</span>
-
-<span class="sd">        If the view_func is not provided you will need to connect the endpoint</span>
-<span class="sd">        to a view function like so::</span>
-
-<span class="sd">            app.view_functions[&#39;index&#39;] = index</span>
-
-<span class="sd">        Internally :meth:`route` invokes :meth:`add_url_rule` so if you want</span>
-<span class="sd">        to customize the behavior via subclassing you only need to change</span>
-<span class="sd">        this method.</span>
-
-<span class="sd">        For more information refer to :ref:`url-route-registrations`.</span>
-
-<span class="sd">        .. versionchanged:: 0.2</span>
-<span class="sd">           `view_func` parameter added.</span>
-
-<span class="sd">        .. versionchanged:: 0.6</span>
-<span class="sd">           ``OPTIONS`` is added automatically as method.</span>
-
-<span class="sd">        :param rule: the URL rule as string</span>
-<span class="sd">        :param endpoint: the endpoint for the registered URL rule.  Flask</span>
-<span class="sd">                         itself assumes the name of the view function as</span>
-<span class="sd">                         endpoint</span>
-<span class="sd">        :param view_func: the function to call when serving a request to the</span>
-<span class="sd">                          provided endpoint</span>
-<span class="sd">        :param options: the options to be forwarded to the underlying</span>
-<span class="sd">                        :class:`~werkzeug.routing.Rule` object.  A change</span>
-<span class="sd">                        to Werkzeug is handling of method options.  methods</span>
-<span class="sd">                        is a list of methods this rule should be limited</span>
-<span class="sd">                        to (``GET``, ``POST`` etc.).  By default a rule</span>
-<span class="sd">                        just listens for ``GET`` (and implicitly ``HEAD``).</span>
-<span class="sd">                        Starting with Flask 0.6, ``OPTIONS`` is implicitly</span>
-<span class="sd">                        added and handled by the standard request handling.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">endpoint</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">endpoint</span> <span class="o">=</span> <span class="n">_endpoint_from_view_func</span><span class="p">(</span><span class="n">view_func</span><span class="p">)</span>
-        <span class="n">options</span><span class="p">[</span><span class="s1">&#39;endpoint&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">endpoint</span>
-        <span class="n">methods</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;methods&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-        <span class="c1"># if the methods are not given and the view_func object knows its</span>
-        <span class="c1"># methods we can use that instead.  If neither exists, we go with</span>
-        <span class="c1"># a tuple of only ``GET`` as default.</span>
-        <span class="k">if</span> <span class="n">methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">methods</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">view_func</span><span class="p">,</span> <span class="s1">&#39;methods&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="s1">&#39;GET&#39;</span><span class="p">,)</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">methods</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;Allowed methods have to be iterables of strings, &#39;</span>
-                            <span class="s1">&#39;for example: @app.route(..., methods=[&quot;POST&quot;])&#39;</span><span class="p">)</span>
-        <span class="n">methods</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span> <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">methods</span><span class="p">)</span>
-
-        <span class="c1"># Methods that should always be added</span>
-        <span class="n">required_methods</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="n">view_func</span><span class="p">,</span> <span class="s1">&#39;required_methods&#39;</span><span class="p">,</span> <span class="p">()))</span>
-
-        <span class="c1"># starting with Flask 0.8 the view_func object can disable and</span>
-        <span class="c1"># force-enable the automatic options handling.</span>
-        <span class="n">provide_automatic_options</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">view_func</span><span class="p">,</span>
-            <span class="s1">&#39;provide_automatic_options&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">provide_automatic_options</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="s1">&#39;OPTIONS&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">methods</span><span class="p">:</span>
-                <span class="n">provide_automatic_options</span> <span class="o">=</span> <span class="kc">True</span>
-                <span class="n">required_methods</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="s1">&#39;OPTIONS&#39;</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">provide_automatic_options</span> <span class="o">=</span> <span class="kc">False</span>
-
-        <span class="c1"># Add the required methods now.</span>
-        <span class="n">methods</span> <span class="o">|=</span> <span class="n">required_methods</span>
-
-        <span class="n">rule</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_rule_class</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="n">methods</span><span class="o">=</span><span class="n">methods</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span>
-        <span class="n">rule</span><span class="o">.</span><span class="n">provide_automatic_options</span> <span class="o">=</span> <span class="n">provide_automatic_options</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_map</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">rule</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">view_func</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">old_func</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">view_functions</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">endpoint</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">old_func</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">old_func</span> <span class="o">!=</span> <span class="n">view_func</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">AssertionError</span><span class="p">(</span><span class="s1">&#39;View function mapping is overwriting an &#39;</span>
-                                     <span class="s1">&#39;existing endpoint function: </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">endpoint</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">view_functions</span><span class="p">[</span><span class="n">endpoint</span><span class="p">]</span> <span class="o">=</span> <span class="n">view_func</span></div>
-
-<div class="viewcode-block" id="Flask.route"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.route">[docs]</a>    <span class="k">def</span> <span class="nf">route</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A decorator that is used to register a view function for a</span>
-<span class="sd">        given URL rule.  This does the same thing as :meth:`add_url_rule`</span>
-<span class="sd">        but is intended for decorator usage::</span>
-
-<span class="sd">            @app.route(&#39;/&#39;)</span>
-<span class="sd">            def index():</span>
-<span class="sd">                return &#39;Hello World&#39;</span>
-
-<span class="sd">        For more information refer to :ref:`url-route-registrations`.</span>
-
-<span class="sd">        :param rule: the URL rule as string</span>
-<span class="sd">        :param endpoint: the endpoint for the registered URL rule.  Flask</span>
-<span class="sd">                         itself assumes the name of the view function as</span>
-<span class="sd">                         endpoint</span>
-<span class="sd">        :param options: the options to be forwarded to the underlying</span>
-<span class="sd">                        :class:`~werkzeug.routing.Rule` object.  A change</span>
-<span class="sd">                        to Werkzeug is handling of method options.  methods</span>
-<span class="sd">                        is a list of methods this rule should be limited</span>
-<span class="sd">                        to (``GET``, ``POST`` etc.).  By default a rule</span>
-<span class="sd">                        just listens for ``GET`` (and implicitly ``HEAD``).</span>
-<span class="sd">                        Starting with Flask 0.6, ``OPTIONS`` is implicitly</span>
-<span class="sd">                        added and handled by the standard request handling.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="n">endpoint</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;endpoint&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.endpoint"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.endpoint">[docs]</a>    <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A decorator to register a function as an endpoint.</span>
-<span class="sd">        Example::</span>
-
-<span class="sd">            @app.endpoint(&#39;example.endpoint&#39;)</span>
-<span class="sd">            def example():</span>
-<span class="sd">                return &quot;example&quot;</span>
-
-<span class="sd">        :param endpoint: the name of the endpoint</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">view_functions</span><span class="p">[</span><span class="n">endpoint</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-    <span class="nd">@staticmethod</span>
-    <span class="k">def</span> <span class="nf">_get_exc_class_and_code</span><span class="p">(</span><span class="n">exc_class_or_code</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Ensure that we register only exceptions as handler keys&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">exc_class_or_code</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">):</span>
-            <span class="n">exc_class</span> <span class="o">=</span> <span class="n">default_exceptions</span><span class="p">[</span><span class="n">exc_class_or_code</span><span class="p">]</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">exc_class</span> <span class="o">=</span> <span class="n">exc_class_or_code</span>
-
-        <span class="k">assert</span> <span class="nb">issubclass</span><span class="p">(</span><span class="n">exc_class</span><span class="p">,</span> <span class="ne">Exception</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="nb">issubclass</span><span class="p">(</span><span class="n">exc_class</span><span class="p">,</span> <span class="n">HTTPException</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">exc_class</span><span class="p">,</span> <span class="n">exc_class</span><span class="o">.</span><span class="n">code</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">exc_class</span><span class="p">,</span> <span class="kc">None</span>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.errorhandler"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.errorhandler">[docs]</a>    <span class="k">def</span> <span class="nf">errorhandler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A decorator that is used to register a function give a given</span>
-<span class="sd">        error code.  Example::</span>
-
-<span class="sd">            @app.errorhandler(404)</span>
-<span class="sd">            def page_not_found(error):</span>
-<span class="sd">                return &#39;This page does not exist&#39;, 404</span>
-
-<span class="sd">        You can also register handlers for arbitrary exceptions::</span>
-
-<span class="sd">            @app.errorhandler(DatabaseError)</span>
-<span class="sd">            def special_exception_handler(error):</span>
-<span class="sd">                return &#39;Database connection failed&#39;, 500</span>
-
-<span class="sd">        You can also register a function as error handler without using</span>
-<span class="sd">        the :meth:`errorhandler` decorator.  The following example is</span>
-<span class="sd">        equivalent to the one above::</span>
-
-<span class="sd">            def page_not_found(error):</span>
-<span class="sd">                return &#39;This page does not exist&#39;, 404</span>
-<span class="sd">            app.error_handler_spec[None][404] = page_not_found</span>
-
-<span class="sd">        Setting error handlers via assignments to :attr:`error_handler_spec`</span>
-<span class="sd">        however is discouraged as it requires fiddling with nested dictionaries</span>
-<span class="sd">        and the special case for arbitrary exception types.</span>
-
-<span class="sd">        The first ``None`` refers to the active blueprint.  If the error</span>
-<span class="sd">        handler should be application wide ``None`` shall be used.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">            Use :meth:`register_error_handler` instead of modifying</span>
-<span class="sd">            :attr:`error_handler_spec` directly, for application wide error</span>
-<span class="sd">            handlers.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">           One can now additionally also register custom exception types</span>
-<span class="sd">           that do not necessarily have to be a subclass of the</span>
-<span class="sd">           :class:`~werkzeug.exceptions.HTTPException` class.</span>
-
-<span class="sd">        :param code: the code as integer for the handler</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_register_error_handler</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Flask.register_error_handler"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.register_error_handler">[docs]</a>    <span class="k">def</span> <span class="nf">register_error_handler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Alternative error attach function to the :meth:`errorhandler`</span>
-<span class="sd">        decorator that is more straightforward to use for non decorator</span>
-<span class="sd">        usage.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_register_error_handler</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">)</span></div>
-
-    <span class="nd">@setupmethod</span>
-    <span class="k">def</span> <span class="nf">_register_error_handler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        :type key: None|str</span>
-<span class="sd">        :type code_or_exception: int|T&lt;=Exception</span>
-<span class="sd">        :type f: callable</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">code_or_exception</span><span class="p">,</span> <span class="n">HTTPException</span><span class="p">):</span>  <span class="c1"># old broken behavior</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                <span class="s1">&#39;Tried to register a handler for an exception instance </span><span class="si">{0!r}</span><span class="s1">. &#39;</span>
-                <span class="s1">&#39;Handlers can only be registered for exception classes or HTTP error codes.&#39;</span>
-                <span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">code_or_exception</span><span class="p">))</span>
-
-        <span class="n">exc_class</span><span class="p">,</span> <span class="n">code</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_exc_class_and_code</span><span class="p">(</span><span class="n">code_or_exception</span><span class="p">)</span>
-
-        <span class="n">handlers</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">error_handler_spec</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="p">{})</span>
-        <span class="n">handlers</span><span class="p">[</span><span class="n">exc_class</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.template_filter"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.template_filter">[docs]</a>    <span class="k">def</span> <span class="nf">template_filter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A decorator that is used to register custom template filter.</span>
-<span class="sd">        You can specify a name for the filter, otherwise the function</span>
-<span class="sd">        name will be used. Example::</span>
-
-<span class="sd">          @app.template_filter()</span>
-<span class="sd">          def reverse(s):</span>
-<span class="sd">              return s[::-1]</span>
-
-<span class="sd">        :param name: the optional name of the filter, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_template_filter</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.add_template_filter"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.add_template_filter">[docs]</a>    <span class="k">def</span> <span class="nf">add_template_filter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template filter.  Works exactly like the</span>
-<span class="sd">        :meth:`template_filter` decorator.</span>
-
-<span class="sd">        :param name: the optional name of the filter, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">filters</span><span class="p">[</span><span class="n">name</span> <span class="ow">or</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.template_test"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.template_test">[docs]</a>    <span class="k">def</span> <span class="nf">template_test</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A decorator that is used to register custom template test.</span>
-<span class="sd">        You can specify a name for the test, otherwise the function</span>
-<span class="sd">        name will be used. Example::</span>
-
-<span class="sd">          @app.template_test()</span>
-<span class="sd">          def is_prime(n):</span>
-<span class="sd">              if n == 2:</span>
-<span class="sd">                  return True</span>
-<span class="sd">              for i in range(2, int(math.ceil(math.sqrt(n))) + 1):</span>
-<span class="sd">                  if n % i == 0:</span>
-<span class="sd">                      return False</span>
-<span class="sd">              return True</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the test, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_template_test</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.add_template_test"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.add_template_test">[docs]</a>    <span class="k">def</span> <span class="nf">add_template_test</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template test.  Works exactly like the</span>
-<span class="sd">        :meth:`template_test` decorator.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the test, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">tests</span><span class="p">[</span><span class="n">name</span> <span class="ow">or</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.template_global"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.template_global">[docs]</a>    <span class="k">def</span> <span class="nf">template_global</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A decorator that is used to register a custom template global function.</span>
-<span class="sd">        You can specify a name for the global function, otherwise the function</span>
-<span class="sd">        name will be used. Example::</span>
-
-<span class="sd">            @app.template_global()</span>
-<span class="sd">            def double(n):</span>
-<span class="sd">                return 2 * n</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the global function, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_template_global</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.add_template_global"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.add_template_global">[docs]</a>    <span class="k">def</span> <span class="nf">add_template_global</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template global function. Works exactly like the</span>
-<span class="sd">        :meth:`template_global` decorator.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the global function, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">globals</span><span class="p">[</span><span class="n">name</span> <span class="ow">or</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.before_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.before_request">[docs]</a>    <span class="k">def</span> <span class="nf">before_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a function to run before each request.</span>
-
-<span class="sd">        The function will be called without any arguments.</span>
-<span class="sd">        If the function returns a non-None value, it&#39;s handled as</span>
-<span class="sd">        if it was the return value from the view and further</span>
-<span class="sd">        request handling is stopped.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">before_request_funcs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.before_first_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.before_first_request">[docs]</a>    <span class="k">def</span> <span class="nf">before_first_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a function to be run before the first request to this</span>
-<span class="sd">        instance of the application.</span>
-
-<span class="sd">        The function will be called without any arguments and its return</span>
-<span class="sd">        value is ignored.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">before_first_request_funcs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.after_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.after_request">[docs]</a>    <span class="k">def</span> <span class="nf">after_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a function to be run after each request.</span>
-
-<span class="sd">        Your function must take one parameter, an instance of</span>
-<span class="sd">        :attr:`response_class` and return a new response object or the</span>
-<span class="sd">        same (see :meth:`process_response`).</span>
-
-<span class="sd">        As of Flask 0.7 this function might not be executed at the end of the</span>
-<span class="sd">        request in case an unhandled exception occurred.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">after_request_funcs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.teardown_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.teardown_request">[docs]</a>    <span class="k">def</span> <span class="nf">teardown_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a function to be run at the end of each request,</span>
-<span class="sd">        regardless of whether there was an exception or not.  These functions</span>
-<span class="sd">        are executed when the request context is popped, even if not an</span>
-<span class="sd">        actual request was performed.</span>
-
-<span class="sd">        Example::</span>
-
-<span class="sd">            ctx = app.test_request_context()</span>
-<span class="sd">            ctx.push()</span>
-<span class="sd">            ...</span>
-<span class="sd">            ctx.pop()</span>
-
-<span class="sd">        When ``ctx.pop()`` is executed in the above example, the teardown</span>
-<span class="sd">        functions are called just before the request context moves from the</span>
-<span class="sd">        stack of active contexts.  This becomes relevant if you are using</span>
-<span class="sd">        such constructs in tests.</span>
-
-<span class="sd">        Generally teardown functions must take every necessary step to avoid</span>
-<span class="sd">        that they will fail.  If they do execute code that might fail they</span>
-<span class="sd">        will have to surround the execution of these code by try/except</span>
-<span class="sd">        statements and log occurring errors.</span>
-
-<span class="sd">        When a teardown function was called because of a exception it will</span>
-<span class="sd">        be passed an error object.</span>
-
-<span class="sd">        The return values of teardown functions are ignored.</span>
-
-<span class="sd">        .. admonition:: Debug Note</span>
-
-<span class="sd">           In debug mode Flask will not tear down a request on an exception</span>
-<span class="sd">           immediately.  Instead it will keep it alive so that the interactive</span>
-<span class="sd">           debugger can still access it.  This behavior can be controlled</span>
-<span class="sd">           by the ``PRESERVE_CONTEXT_ON_EXCEPTION`` configuration variable.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">teardown_request_funcs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.teardown_appcontext"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.teardown_appcontext">[docs]</a>    <span class="k">def</span> <span class="nf">teardown_appcontext</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a function to be called when the application context</span>
-<span class="sd">        ends.  These functions are typically also called when the request</span>
-<span class="sd">        context is popped.</span>
-
-<span class="sd">        Example::</span>
-
-<span class="sd">            ctx = app.app_context()</span>
-<span class="sd">            ctx.push()</span>
-<span class="sd">            ...</span>
-<span class="sd">            ctx.pop()</span>
-
-<span class="sd">        When ``ctx.pop()`` is executed in the above example, the teardown</span>
-<span class="sd">        functions are called just before the app context moves from the</span>
-<span class="sd">        stack of active contexts.  This becomes relevant if you are using</span>
-<span class="sd">        such constructs in tests.</span>
-
-<span class="sd">        Since a request context typically also manages an application</span>
-<span class="sd">        context it would also be called when you pop a request context.</span>
-
-<span class="sd">        When a teardown function was called because of an exception it will</span>
-<span class="sd">        be passed an error object.</span>
-
-<span class="sd">        The return values of teardown functions are ignored.</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">teardown_appcontext_funcs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.context_processor"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.context_processor">[docs]</a>    <span class="k">def</span> <span class="nf">context_processor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a template context processor function.&quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">template_context_processors</span><span class="p">[</span><span class="kc">None</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.shell_context_processor"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.shell_context_processor">[docs]</a>    <span class="k">def</span> <span class="nf">shell_context_processor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a shell context processor function.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">shell_context_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.url_value_preprocessor"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.url_value_preprocessor">[docs]</a>    <span class="k">def</span> <span class="nf">url_value_preprocessor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a function as URL value preprocessor for all view</span>
-<span class="sd">        functions of the application.  It&#39;s called before the view functions</span>
-<span class="sd">        are called and can modify the url values provided.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_value_preprocessors</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="nd">@setupmethod</span>
-<div class="viewcode-block" id="Flask.url_defaults"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.url_defaults">[docs]</a>    <span class="k">def</span> <span class="nf">url_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Callback function for URL defaults for all view functions of the</span>
-<span class="sd">        application.  It&#39;s called with the endpoint and values and should</span>
-<span class="sd">        update the values passed in place.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_default_functions</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-    <span class="k">def</span> <span class="nf">_find_error_handler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">e</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Finds a registered error handler for the request’s blueprint.</span>
-<span class="sd">        Otherwise falls back to the app, returns None if not a suitable</span>
-<span class="sd">        handler is found.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">exc_class</span><span class="p">,</span> <span class="n">code</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_exc_class_and_code</span><span class="p">(</span><span class="nb">type</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-
-        <span class="k">def</span> <span class="nf">find_handler</span><span class="p">(</span><span class="n">handler_map</span><span class="p">):</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">handler_map</span><span class="p">:</span>
-                <span class="k">return</span>
-            <span class="n">queue</span> <span class="o">=</span> <span class="n">deque</span><span class="p">(</span><span class="n">exc_class</span><span class="o">.</span><span class="n">__mro__</span><span class="p">)</span>
-            <span class="c1"># Protect from geniuses who might create circular references in</span>
-            <span class="c1"># __mro__</span>
-            <span class="n">done</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-
-            <span class="k">while</span> <span class="n">queue</span><span class="p">:</span>
-                <span class="n">cls</span> <span class="o">=</span> <span class="n">queue</span><span class="o">.</span><span class="n">popleft</span><span class="p">()</span>
-                <span class="k">if</span> <span class="n">cls</span> <span class="ow">in</span> <span class="n">done</span><span class="p">:</span>
-                    <span class="k">continue</span>
-                <span class="n">done</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">cls</span><span class="p">)</span>
-                <span class="n">handler</span> <span class="o">=</span> <span class="n">handler_map</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">cls</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">handler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="c1"># cache for next time exc_class is raised</span>
-                    <span class="n">handler_map</span><span class="p">[</span><span class="n">exc_class</span><span class="p">]</span> <span class="o">=</span> <span class="n">handler</span>
-                    <span class="k">return</span> <span class="n">handler</span>
-
-                <span class="n">queue</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">cls</span><span class="o">.</span><span class="n">__mro__</span><span class="p">)</span>
-
-        <span class="c1"># try blueprint handlers</span>
-        <span class="n">handler</span> <span class="o">=</span> <span class="n">find_handler</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">error_handler_spec</span>
-                               <span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span><span class="p">,</span> <span class="p">{})</span>
-                               <span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">code</span><span class="p">))</span>
-        <span class="k">if</span> <span class="n">handler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">handler</span>
-
-        <span class="c1"># fall back to app handlers</span>
-        <span class="k">return</span> <span class="n">find_handler</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">error_handler_spec</span><span class="p">[</span><span class="kc">None</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">code</span><span class="p">))</span>
-
-<div class="viewcode-block" id="Flask.handle_http_exception"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.handle_http_exception">[docs]</a>    <span class="k">def</span> <span class="nf">handle_http_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">e</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Handles an HTTP exception.  By default this will invoke the</span>
-<span class="sd">        registered error handlers and fall back to returning the</span>
-<span class="sd">        exception as response.</span>
-
-<span class="sd">        .. versionadded:: 0.3</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="c1"># Proxy exceptions don&#39;t have error codes.  We want to always return</span>
-        <span class="c1"># those unchanged as errors</span>
-        <span class="k">if</span> <span class="n">e</span><span class="o">.</span><span class="n">code</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">e</span>
-
-        <span class="n">handler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_error_handler</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">handler</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">e</span>
-        <span class="k">return</span> <span class="n">handler</span><span class="p">(</span><span class="n">e</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.trap_http_exception"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.trap_http_exception">[docs]</a>    <span class="k">def</span> <span class="nf">trap_http_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">e</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Checks if an HTTP exception should be trapped or not.  By default</span>
-<span class="sd">        this will return ``False`` for all exceptions except for a bad request</span>
-<span class="sd">        key error if ``TRAP_BAD_REQUEST_ERRORS`` is set to ``True``.  It</span>
-<span class="sd">        also returns ``True`` if ``TRAP_HTTP_EXCEPTIONS`` is set to ``True``.</span>
-
-<span class="sd">        This is called for all HTTP exceptions raised by a view function.</span>
-<span class="sd">        If it returns ``True`` for any exception the error handler for this</span>
-<span class="sd">        exception is not called and it shows up as regular exception in the</span>
-<span class="sd">        traceback.  This is helpful for debugging implicitly raised HTTP</span>
-<span class="sd">        exceptions.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;TRAP_HTTP_EXCEPTIONS&#39;</span><span class="p">]:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;TRAP_BAD_REQUEST_ERRORS&#39;</span><span class="p">]:</span>
-            <span class="k">return</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">e</span><span class="p">,</span> <span class="n">BadRequest</span><span class="p">)</span>
-        <span class="k">return</span> <span class="kc">False</span></div>
-
-<div class="viewcode-block" id="Flask.handle_user_exception"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.handle_user_exception">[docs]</a>    <span class="k">def</span> <span class="nf">handle_user_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">e</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This method is called whenever an exception occurs that should be</span>
-<span class="sd">        handled.  A special case are</span>
-<span class="sd">        :class:`~werkzeug.exception.HTTPException`\s which are forwarded by</span>
-<span class="sd">        this function to the :meth:`handle_http_exception` method.  This</span>
-<span class="sd">        function will either return a response value or reraise the</span>
-<span class="sd">        exception with the same traceback.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-        <span class="k">assert</span> <span class="n">exc_value</span> <span class="ow">is</span> <span class="n">e</span>
-
-        <span class="c1"># ensure not to trash sys.exc_info() at that point in case someone</span>
-        <span class="c1"># wants the traceback preserved in handle_http_exception.  Of course</span>
-        <span class="c1"># we cannot prevent users from trashing it themselves in a custom</span>
-        <span class="c1"># trap_http_exception method so that&#39;s their fault then.</span>
-
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">e</span><span class="p">,</span> <span class="n">HTTPException</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">trap_http_exception</span><span class="p">(</span><span class="n">e</span><span class="p">):</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">handle_http_exception</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
-
-        <span class="n">handler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_error_handler</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">handler</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">reraise</span><span class="p">(</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">handler</span><span class="p">(</span><span class="n">e</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.handle_exception"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.handle_exception">[docs]</a>    <span class="k">def</span> <span class="nf">handle_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">e</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Default exception handling that kicks in when an exception</span>
-<span class="sd">        occurs that is not caught.  In debug mode the exception will</span>
-<span class="sd">        be re-raised immediately, otherwise it is logged and the handler</span>
-<span class="sd">        for a 500 internal server error is used.  If no such handler</span>
-<span class="sd">        exists, a default 500 internal server error message is displayed.</span>
-
-<span class="sd">        .. versionadded:: 0.3</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-
-        <span class="n">got_request_exception</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exception</span><span class="o">=</span><span class="n">e</span><span class="p">)</span>
-        <span class="n">handler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_error_handler</span><span class="p">(</span><span class="n">InternalServerError</span><span class="p">())</span>
-
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">propagate_exceptions</span><span class="p">:</span>
-            <span class="c1"># if we want to repropagate the exception, we can attempt to</span>
-            <span class="c1"># raise it with the whole traceback in case we can do that</span>
-            <span class="c1"># (the function was actually called from the except part)</span>
-            <span class="c1"># otherwise, we just raise the error again</span>
-            <span class="k">if</span> <span class="n">exc_value</span> <span class="ow">is</span> <span class="n">e</span><span class="p">:</span>
-                <span class="n">reraise</span><span class="p">(</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="n">e</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">log_exception</span><span class="p">((</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">))</span>
-        <span class="k">if</span> <span class="n">handler</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">InternalServerError</span><span class="p">()</span>
-        <span class="k">return</span> <span class="n">handler</span><span class="p">(</span><span class="n">e</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.log_exception"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.log_exception">[docs]</a>    <span class="k">def</span> <span class="nf">log_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Logs an exception.  This is called by :meth:`handle_exception`</span>
-<span class="sd">        if debugging is disabled and right before the handler is called.</span>
-<span class="sd">        The default implementation logs the exception as error on the</span>
-<span class="sd">        :attr:`logger`.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s1">&#39;Exception on </span><span class="si">%s</span><span class="s1"> [</span><span class="si">%s</span><span class="s1">]&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="n">request</span><span class="o">.</span><span class="n">path</span><span class="p">,</span>
-            <span class="n">request</span><span class="o">.</span><span class="n">method</span>
-        <span class="p">),</span> <span class="n">exc_info</span><span class="o">=</span><span class="n">exc_info</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.raise_routing_exception"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.raise_routing_exception">[docs]</a>    <span class="k">def</span> <span class="nf">raise_routing_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Exceptions that are recording during routing are reraised with</span>
-<span class="sd">        this method.  During debug we are not reraising redirect requests</span>
-<span class="sd">        for non ``GET``, ``HEAD``, or ``OPTIONS`` requests and we&#39;re raising</span>
-<span class="sd">        a different error instead to help debug situations.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">debug</span> \
-           <span class="ow">or</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">routing_exception</span><span class="p">,</span> <span class="n">RequestRedirect</span><span class="p">)</span> \
-           <span class="ow">or</span> <span class="n">request</span><span class="o">.</span><span class="n">method</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;GET&#39;</span><span class="p">,</span> <span class="s1">&#39;HEAD&#39;</span><span class="p">,</span> <span class="s1">&#39;OPTIONS&#39;</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="n">request</span><span class="o">.</span><span class="n">routing_exception</span>
-
-        <span class="kn">from</span> <span class="nn">.debughelpers</span> <span class="k">import</span> <span class="n">FormDataRoutingRedirect</span>
-        <span class="k">raise</span> <span class="n">FormDataRoutingRedirect</span><span class="p">(</span><span class="n">request</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.dispatch_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.dispatch_request">[docs]</a>    <span class="k">def</span> <span class="nf">dispatch_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Does the request dispatching.  Matches the URL and returns the</span>
-<span class="sd">        return value of the view or error handler.  This does not have to</span>
-<span class="sd">        be a response object.  In order to convert the return value to a</span>
-<span class="sd">        proper response object, call :func:`make_response`.</span>
-
-<span class="sd">        .. versionchanged:: 0.7</span>
-<span class="sd">           This no longer does the exception handling, this code was</span>
-<span class="sd">           moved to the new :meth:`full_dispatch_request`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">req</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">request</span>
-        <span class="k">if</span> <span class="n">req</span><span class="o">.</span><span class="n">routing_exception</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">raise_routing_exception</span><span class="p">(</span><span class="n">req</span><span class="p">)</span>
-        <span class="n">rule</span> <span class="o">=</span> <span class="n">req</span><span class="o">.</span><span class="n">url_rule</span>
-        <span class="c1"># if we provide automatic options for this URL and the</span>
-        <span class="c1"># request came with the OPTIONS method, reply automatically</span>
-        <span class="k">if</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="s1">&#39;provide_automatic_options&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span> \
-           <span class="ow">and</span> <span class="n">req</span><span class="o">.</span><span class="n">method</span> <span class="o">==</span> <span class="s1">&#39;OPTIONS&#39;</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_default_options_response</span><span class="p">()</span>
-        <span class="c1"># otherwise dispatch to the handler for that endpoint</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">view_functions</span><span class="p">[</span><span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">](</span><span class="o">**</span><span class="n">req</span><span class="o">.</span><span class="n">view_args</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.full_dispatch_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.full_dispatch_request">[docs]</a>    <span class="k">def</span> <span class="nf">full_dispatch_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Dispatches the request and on top of that performs request</span>
-<span class="sd">        pre and postprocessing as well as HTTP exception catching and</span>
-<span class="sd">        error handling.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">try_trigger_before_first_request_functions</span><span class="p">()</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">request_started</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">preprocess_request</span><span class="p">()</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dispatch_request</span><span class="p">()</span>
-        <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">handle_user_exception</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
-        <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_response</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-        <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">process_response</span><span class="p">(</span><span class="n">response</span><span class="p">)</span>
-        <span class="n">request_finished</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="o">=</span><span class="n">response</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">response</span></div>
-
-<div class="viewcode-block" id="Flask.try_trigger_before_first_request_functions"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.try_trigger_before_first_request_functions">[docs]</a>    <span class="k">def</span> <span class="nf">try_trigger_before_first_request_functions</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called before each request and will ensure that it triggers</span>
-<span class="sd">        the :attr:`before_first_request_funcs` and only exactly once per</span>
-<span class="sd">        application instance (which means process usually).</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span><span class="p">:</span>
-            <span class="k">return</span>
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_before_request_lock</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span><span class="p">:</span>
-                <span class="k">return</span>
-            <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">before_first_request_funcs</span><span class="p">:</span>
-                <span class="n">func</span><span class="p">()</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_got_first_request</span> <span class="o">=</span> <span class="kc">True</span></div>
-
-<div class="viewcode-block" id="Flask.make_default_options_response"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.make_default_options_response">[docs]</a>    <span class="k">def</span> <span class="nf">make_default_options_response</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This method is called to create the default ``OPTIONS`` response.</span>
-<span class="sd">        This can be changed through subclassing to change the default</span>
-<span class="sd">        behavior of ``OPTIONS`` responses.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">adapter</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">url_adapter</span>
-        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">adapter</span><span class="p">,</span> <span class="s1">&#39;allowed_methods&#39;</span><span class="p">):</span>
-            <span class="n">methods</span> <span class="o">=</span> <span class="n">adapter</span><span class="o">.</span><span class="n">allowed_methods</span><span class="p">()</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="c1"># fallback for Werkzeug &lt; 0.7</span>
-            <span class="n">methods</span> <span class="o">=</span> <span class="p">[]</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">adapter</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s1">&#39;--&#39;</span><span class="p">)</span>
-            <span class="k">except</span> <span class="n">MethodNotAllowed</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-                <span class="n">methods</span> <span class="o">=</span> <span class="n">e</span><span class="o">.</span><span class="n">valid_methods</span>
-            <span class="k">except</span> <span class="n">HTTPException</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-                <span class="k">pass</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">response_class</span><span class="p">()</span>
-        <span class="n">rv</span><span class="o">.</span><span class="n">allow</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">methods</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="Flask.should_ignore_error"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.should_ignore_error">[docs]</a>    <span class="k">def</span> <span class="nf">should_ignore_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">error</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This is called to figure out if an error should be ignored</span>
-<span class="sd">        or not as far as the teardown system is concerned.  If this</span>
-<span class="sd">        function returns ``True`` then the teardown handlers will not be</span>
-<span class="sd">        passed the error.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="kc">False</span></div>
-
-<div class="viewcode-block" id="Flask.make_response"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.make_response">[docs]</a>    <span class="k">def</span> <span class="nf">make_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rv</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Converts the return value from a view function to a real</span>
-<span class="sd">        response object that is an instance of :attr:`response_class`.</span>
-
-<span class="sd">        The following types are allowed for `rv`:</span>
-
-<span class="sd">        .. tabularcolumns:: |p{3.5cm}|p{9.5cm}|</span>
-
-<span class="sd">        ======================= ===========================================</span>
-<span class="sd">        :attr:`response_class`  the object is returned unchanged</span>
-<span class="sd">        :class:`str`            a response object is created with the</span>
-<span class="sd">                                string as body</span>
-<span class="sd">        :class:`unicode`        a response object is created with the</span>
-<span class="sd">                                string encoded to utf-8 as body</span>
-<span class="sd">        a WSGI function         the function is called as WSGI application</span>
-<span class="sd">                                and buffered as response object</span>
-<span class="sd">        :class:`tuple`          A tuple in the form ``(response, status,</span>
-<span class="sd">                                headers)`` or ``(response, headers)``</span>
-<span class="sd">                                where `response` is any of the</span>
-<span class="sd">                                types defined here, `status` is a string</span>
-<span class="sd">                                or an integer and `headers` is a list or</span>
-<span class="sd">                                a dictionary with header values.</span>
-<span class="sd">        ======================= ===========================================</span>
-
-<span class="sd">        :param rv: the return value from the view function</span>
-
-<span class="sd">        .. versionchanged:: 0.9</span>
-<span class="sd">           Previously a tuple was interpreted as the arguments for the</span>
-<span class="sd">           response object.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">status_or_headers</span> <span class="o">=</span> <span class="n">headers</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">):</span>
-            <span class="n">rv</span><span class="p">,</span> <span class="n">status_or_headers</span><span class="p">,</span> <span class="n">headers</span> <span class="o">=</span> <span class="n">rv</span> <span class="o">+</span> <span class="p">(</span><span class="kc">None</span><span class="p">,)</span> <span class="o">*</span> <span class="p">(</span><span class="mi">3</span> <span class="o">-</span> <span class="nb">len</span><span class="p">(</span><span class="n">rv</span><span class="p">))</span>
-
-        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;View function did not return a response&#39;</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">status_or_headers</span><span class="p">,</span> <span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="nb">list</span><span class="p">)):</span>
-            <span class="n">headers</span><span class="p">,</span> <span class="n">status_or_headers</span> <span class="o">=</span> <span class="n">status_or_headers</span><span class="p">,</span> <span class="kc">None</span>
-
-        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">response_class</span><span class="p">):</span>
-            <span class="c1"># When we create a response object directly, we let the constructor</span>
-            <span class="c1"># set the headers and status.  We do this because there can be</span>
-            <span class="c1"># some extra logic involved when creating these objects with</span>
-            <span class="c1"># specific values (like default content type selection).</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="p">(</span><span class="n">text_type</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">,</span> <span class="nb">bytearray</span><span class="p">)):</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">response_class</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
-                                         <span class="n">status</span><span class="o">=</span><span class="n">status_or_headers</span><span class="p">)</span>
-                <span class="n">headers</span> <span class="o">=</span> <span class="n">status_or_headers</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">response_class</span><span class="o">.</span><span class="n">force_type</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">status_or_headers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">status_or_headers</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-                <span class="n">rv</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status_or_headers</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">rv</span><span class="o">.</span><span class="n">status_code</span> <span class="o">=</span> <span class="n">status_or_headers</span>
-        <span class="k">if</span> <span class="n">headers</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">headers</span><span class="p">)</span>
-
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="Flask.create_url_adapter"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.create_url_adapter">[docs]</a>    <span class="k">def</span> <span class="nf">create_url_adapter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a URL adapter for the given request.  The URL adapter</span>
-<span class="sd">        is created at a point where the request context is not yet set up</span>
-<span class="sd">        so the request is passed explicitly.</span>
-
-<span class="sd">        .. versionadded:: 0.6</span>
-
-<span class="sd">        .. versionchanged:: 0.9</span>
-<span class="sd">           This can now also be called without a request object when the</span>
-<span class="sd">           URL adapter is created for the application context.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">request</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_map</span><span class="o">.</span><span class="n">bind_to_environ</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">,</span>
-                <span class="n">server_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">])</span>
-        <span class="c1"># We need at the very least the server name to be set for this</span>
-        <span class="c1"># to work.</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_map</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">],</span>
-                <span class="n">script_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;APPLICATION_ROOT&#39;</span><span class="p">]</span> <span class="ow">or</span> <span class="s1">&#39;/&#39;</span><span class="p">,</span>
-                <span class="n">url_scheme</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;PREFERRED_URL_SCHEME&#39;</span><span class="p">])</span></div>
-
-<div class="viewcode-block" id="Flask.inject_url_defaults"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.inject_url_defaults">[docs]</a>    <span class="k">def</span> <span class="nf">inject_url_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Injects the URL defaults for the given endpoint directly into</span>
-<span class="sd">        the values dictionary passed.  This is used internally and</span>
-<span class="sd">        automatically called on URL building.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">funcs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_default_functions</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">())</span>
-        <span class="k">if</span> <span class="s1">&#39;.&#39;</span> <span class="ow">in</span> <span class="n">endpoint</span><span class="p">:</span>
-            <span class="n">bp</span> <span class="o">=</span> <span class="n">endpoint</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-            <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_default_functions</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">bp</span><span class="p">,</span> <span class="p">()))</span>
-        <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="n">funcs</span><span class="p">:</span>
-            <span class="n">func</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.handle_url_build_error"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.handle_url_build_error">[docs]</a>    <span class="k">def</span> <span class="nf">handle_url_build_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">error</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Handle :class:`~werkzeug.routing.BuildError` on :meth:`url_for`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">handler</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_build_error_handlers</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="n">handler</span><span class="p">(</span><span class="n">error</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="k">return</span> <span class="n">rv</span>
-            <span class="k">except</span> <span class="n">BuildError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-                <span class="c1"># make error available outside except block (py3)</span>
-                <span class="n">error</span> <span class="o">=</span> <span class="n">e</span>
-
-        <span class="c1"># At this point we want to reraise the exception.  If the error is</span>
-        <span class="c1"># still the same one we can reraise it with the original traceback,</span>
-        <span class="c1"># otherwise we raise it from here.</span>
-        <span class="k">if</span> <span class="n">error</span> <span class="ow">is</span> <span class="n">exc_value</span><span class="p">:</span>
-            <span class="n">reraise</span><span class="p">(</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
-        <span class="k">raise</span> <span class="n">error</span></div>
-
-<div class="viewcode-block" id="Flask.preprocess_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.preprocess_request">[docs]</a>    <span class="k">def</span> <span class="nf">preprocess_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called before the actual request dispatching and will</span>
-<span class="sd">        call each :meth:`before_request` decorated function, passing no</span>
-<span class="sd">        arguments.</span>
-<span class="sd">        If any of these functions returns a value, it&#39;s handled as</span>
-<span class="sd">        if it was the return value from the view and further</span>
-<span class="sd">        request handling is stopped.</span>
-
-<span class="sd">        This also triggers the :meth:`url_value_processor` functions before</span>
-<span class="sd">        the actual :meth:`before_request` functions are called.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">bp</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span>
-
-        <span class="n">funcs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_value_preprocessors</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">())</span>
-        <span class="k">if</span> <span class="n">bp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">bp</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_value_preprocessors</span><span class="p">:</span>
-            <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_value_preprocessors</span><span class="p">[</span><span class="n">bp</span><span class="p">])</span>
-        <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="n">funcs</span><span class="p">:</span>
-            <span class="n">func</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">request</span><span class="o">.</span><span class="n">view_args</span><span class="p">)</span>
-
-        <span class="n">funcs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">before_request_funcs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">())</span>
-        <span class="k">if</span> <span class="n">bp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">bp</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">before_request_funcs</span><span class="p">:</span>
-            <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">before_request_funcs</span><span class="p">[</span><span class="n">bp</span><span class="p">])</span>
-        <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="n">funcs</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">func</span><span class="p">()</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="Flask.process_response"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.process_response">[docs]</a>    <span class="k">def</span> <span class="nf">process_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Can be overridden in order to modify the response object</span>
-<span class="sd">        before it&#39;s sent to the WSGI server.  By default this will</span>
-<span class="sd">        call all the :meth:`after_request` decorated functions.</span>
-
-<span class="sd">        .. versionchanged:: 0.5</span>
-<span class="sd">           As of Flask 0.5 the functions registered for after request</span>
-<span class="sd">           execution are called in reverse order of registration.</span>
-
-<span class="sd">        :param response: a :attr:`response_class` object.</span>
-<span class="sd">        :return: a new response object or the same, has to be an</span>
-<span class="sd">                 instance of :attr:`response_class`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">ctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="n">bp</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span>
-        <span class="n">funcs</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">_after_request_functions</span>
-        <span class="k">if</span> <span class="n">bp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">bp</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">after_request_funcs</span><span class="p">:</span>
-            <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">after_request_funcs</span><span class="p">[</span><span class="n">bp</span><span class="p">]))</span>
-        <span class="k">if</span> <span class="kc">None</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">after_request_funcs</span><span class="p">:</span>
-            <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">after_request_funcs</span><span class="p">[</span><span class="kc">None</span><span class="p">]))</span>
-        <span class="k">for</span> <span class="n">handler</span> <span class="ow">in</span> <span class="n">funcs</span><span class="p">:</span>
-            <span class="n">response</span> <span class="o">=</span> <span class="n">handler</span><span class="p">(</span><span class="n">response</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_interface</span><span class="o">.</span><span class="n">is_null_session</span><span class="p">(</span><span class="n">ctx</span><span class="o">.</span><span class="n">session</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">save_session</span><span class="p">(</span><span class="n">ctx</span><span class="o">.</span><span class="n">session</span><span class="p">,</span> <span class="n">response</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">response</span></div>
-
-<div class="viewcode-block" id="Flask.do_teardown_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.do_teardown_request">[docs]</a>    <span class="k">def</span> <span class="nf">do_teardown_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="o">=</span><span class="n">_sentinel</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called after the actual request dispatching and will</span>
-<span class="sd">        call every as :meth:`teardown_request` decorated function.  This is</span>
-<span class="sd">        not actually called by the :class:`Flask` object itself but is always</span>
-<span class="sd">        triggered when the request context is popped.  That way we have a</span>
-<span class="sd">        tighter control over certain resources under testing environments.</span>
-
-<span class="sd">        .. versionchanged:: 0.9</span>
-<span class="sd">           Added the `exc` argument.  Previously this was always using the</span>
-<span class="sd">           current exception information.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">exc</span> <span class="ow">is</span> <span class="n">_sentinel</span><span class="p">:</span>
-            <span class="n">exc</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()[</span><span class="mi">1</span><span class="p">]</span>
-        <span class="n">funcs</span> <span class="o">=</span> <span class="nb">reversed</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">teardown_request_funcs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">()))</span>
-        <span class="n">bp</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span>
-        <span class="k">if</span> <span class="n">bp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">bp</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">teardown_request_funcs</span><span class="p">:</span>
-            <span class="n">funcs</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">teardown_request_funcs</span><span class="p">[</span><span class="n">bp</span><span class="p">]))</span>
-        <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="n">funcs</span><span class="p">:</span>
-            <span class="n">func</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span>
-        <span class="n">request_tearing_down</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="o">=</span><span class="n">exc</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.do_teardown_appcontext"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.do_teardown_appcontext">[docs]</a>    <span class="k">def</span> <span class="nf">do_teardown_appcontext</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="o">=</span><span class="n">_sentinel</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called when an application context is popped.  This works pretty</span>
-<span class="sd">        much the same as :meth:`do_teardown_request` but for the application</span>
-<span class="sd">        context.</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">exc</span> <span class="ow">is</span> <span class="n">_sentinel</span><span class="p">:</span>
-            <span class="n">exc</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()[</span><span class="mi">1</span><span class="p">]</span>
-        <span class="k">for</span> <span class="n">func</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">teardown_appcontext_funcs</span><span class="p">):</span>
-            <span class="n">func</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span>
-        <span class="n">appcontext_tearing_down</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="o">=</span><span class="n">exc</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.app_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.app_context">[docs]</a>    <span class="k">def</span> <span class="nf">app_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Binds the application only.  For as long as the application is bound</span>
-<span class="sd">        to the current context the :data:`flask.current_app` points to that</span>
-<span class="sd">        application.  An application context is automatically created when a</span>
-<span class="sd">        request context is pushed if necessary.</span>
-
-<span class="sd">        Example usage::</span>
-
-<span class="sd">            with app.app_context():</span>
-<span class="sd">                ...</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">AppContext</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.request_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.request_context">[docs]</a>    <span class="k">def</span> <span class="nf">request_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a :class:`~flask.ctx.RequestContext` from the given</span>
-<span class="sd">        environment and binds it to the current context.  This must be used in</span>
-<span class="sd">        combination with the ``with`` statement because the request is only bound</span>
-<span class="sd">        to the current context for the duration of the ``with`` block.</span>
-
-<span class="sd">        Example usage::</span>
-
-<span class="sd">            with app.request_context(environ):</span>
-<span class="sd">                do_something_with(request)</span>
-
-<span class="sd">        The object returned can also be used without the ``with`` statement</span>
-<span class="sd">        which is useful for working in the shell.  The example above is</span>
-<span class="sd">        doing exactly the same as this code::</span>
-
-<span class="sd">            ctx = app.request_context(environ)</span>
-<span class="sd">            ctx.push()</span>
-<span class="sd">            try:</span>
-<span class="sd">                do_something_with(request)</span>
-<span class="sd">            finally:</span>
-<span class="sd">                ctx.pop()</span>
-
-<span class="sd">        .. versionchanged:: 0.3</span>
-<span class="sd">           Added support for non-with statement usage and ``with`` statement</span>
-<span class="sd">           is now passed the ctx object.</span>
-
-<span class="sd">        :param environ: a WSGI environment</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">RequestContext</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Flask.test_request_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.test_request_context">[docs]</a>    <span class="k">def</span> <span class="nf">test_request_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a WSGI environment from the given values (see</span>
-<span class="sd">        :class:`werkzeug.test.EnvironBuilder` for more information, this</span>
-<span class="sd">        function accepts the same arguments).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="kn">from</span> <span class="nn">flask.testing</span> <span class="k">import</span> <span class="n">make_test_environ_builder</span>
-        <span class="n">builder</span> <span class="o">=</span> <span class="n">make_test_environ_builder</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">request_context</span><span class="p">(</span><span class="n">builder</span><span class="o">.</span><span class="n">get_environ</span><span class="p">())</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="n">builder</span><span class="o">.</span><span class="n">close</span><span class="p">()</span></div>
-
-<div class="viewcode-block" id="Flask.wsgi_app"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Flask.wsgi_app">[docs]</a>    <span class="k">def</span> <span class="nf">wsgi_app</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The actual WSGI application.  This is not implemented in</span>
-<span class="sd">        `__call__` so that middlewares can be applied without losing a</span>
-<span class="sd">        reference to the class.  So instead of doing this::</span>
-
-<span class="sd">            app = MyMiddleware(app)</span>
-
-<span class="sd">        It&#39;s a better idea to do this instead::</span>
-
-<span class="sd">            app.wsgi_app = MyMiddleware(app.wsgi_app)</span>
-
-<span class="sd">        Then you still have the original application object around and</span>
-<span class="sd">        can continue to call methods on it.</span>
-
-<span class="sd">        .. versionchanged:: 0.7</span>
-<span class="sd">           The behavior of the before and after request callbacks was changed</span>
-<span class="sd">           under error conditions and a new callback was added that will</span>
-<span class="sd">           always execute at the end of the request, independent on if an</span>
-<span class="sd">           error occurred or not.  See :ref:`callbacks-and-errors`.</span>
-
-<span class="sd">        :param environ: a WSGI environment</span>
-<span class="sd">        :param start_response: a callable accepting a status code,</span>
-<span class="sd">                               a list of headers and an optional</span>
-<span class="sd">                               exception context to start the response</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">ctx</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">request_context</span><span class="p">(</span><span class="n">environ</span><span class="p">)</span>
-        <span class="n">ctx</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-        <span class="n">error</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">full_dispatch_request</span><span class="p">()</span>
-            <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-                <span class="n">error</span> <span class="o">=</span> <span class="n">e</span>
-                <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_response</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">handle_exception</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-            <span class="k">return</span> <span class="n">response</span><span class="p">(</span><span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">)</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">should_ignore_error</span><span class="p">(</span><span class="n">error</span><span class="p">):</span>
-                <span class="n">error</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="n">ctx</span><span class="o">.</span><span class="n">auto_pop</span><span class="p">(</span><span class="n">error</span><span class="p">)</span></div>
-
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Shortcut for :attr:`wsgi_app`.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">wsgi_app</span><span class="p">(</span><span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-        <span class="p">)</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/blueprints.html

@@ -1,501 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.blueprints &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.blueprints</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.blueprints</span>
-<span class="sd">    ~~~~~~~~~~~~~~~~</span>
-
-<span class="sd">    Blueprints are the recommended way to implement larger or more</span>
-<span class="sd">    pluggable applications in Flask 0.7 and later.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">from</span> <span class="nn">functools</span> <span class="k">import</span> <span class="n">update_wrapper</span>
-
-<span class="kn">from</span> <span class="nn">.helpers</span> <span class="k">import</span> <span class="n">_PackageBoundObject</span><span class="p">,</span> <span class="n">_endpoint_from_view_func</span>
-
-
-<div class="viewcode-block" id="BlueprintSetupState"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.BlueprintSetupState">[docs]</a><span class="k">class</span> <span class="nc">BlueprintSetupState</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Temporary holder object for registering a blueprint with the</span>
-<span class="sd">    application.  An instance of this class is created by the</span>
-<span class="sd">    :meth:`~flask.Blueprint.make_setup_state` method and later passed</span>
-<span class="sd">    to all register callback functions.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">blueprint</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">first_registration</span><span class="p">):</span>
-        <span class="c1">#: a reference to the current application</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app</span> <span class="o">=</span> <span class="n">app</span>
-
-        <span class="c1">#: a reference to the blueprint that created this setup state.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">blueprint</span> <span class="o">=</span> <span class="n">blueprint</span>
-
-        <span class="c1">#: a dictionary with all options that were passed to the</span>
-        <span class="c1">#: :meth:`~flask.Flask.register_blueprint` method.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">options</span>
-
-        <span class="c1">#: as blueprints can be registered multiple times with the</span>
-        <span class="c1">#: application and not everything wants to be registered</span>
-        <span class="c1">#: multiple times on it, this attribute can be used to figure</span>
-        <span class="c1">#: out if the blueprint was registered in the past already.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">first_registration</span> <span class="o">=</span> <span class="n">first_registration</span>
-
-        <span class="n">subdomain</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;subdomain&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">subdomain</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">subdomain</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">blueprint</span><span class="o">.</span><span class="n">subdomain</span>
-
-        <span class="c1">#: The subdomain that the blueprint should be active for, ``None``</span>
-        <span class="c1">#: otherwise.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="n">subdomain</span>
-
-        <span class="n">url_prefix</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;url_prefix&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">url_prefix</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">url_prefix</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">blueprint</span><span class="o">.</span><span class="n">url_prefix</span>
-
-        <span class="c1">#: The prefix that should be used for all URLs defined on the</span>
-        <span class="c1">#: blueprint.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_prefix</span> <span class="o">=</span> <span class="n">url_prefix</span>
-
-        <span class="c1">#: A dictionary with URL defaults that is added to each and every</span>
-        <span class="c1">#: URL that was defined with the blueprint.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_defaults</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">blueprint</span><span class="o">.</span><span class="n">url_values_defaults</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_defaults</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;url_defaults&#39;</span><span class="p">,</span> <span class="p">()))</span>
-
-<div class="viewcode-block" id="BlueprintSetupState.add_url_rule"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.BlueprintSetupState.add_url_rule">[docs]</a>    <span class="k">def</span> <span class="nf">add_url_rule</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">,</span> <span class="n">endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">view_func</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A helper method to register a rule (and optionally a view function)</span>
-<span class="sd">        to the application.  The endpoint is automatically prefixed with the</span>
-<span class="sd">        blueprint&#39;s name.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_prefix</span><span class="p">:</span>
-            <span class="n">rule</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_prefix</span> <span class="o">+</span> <span class="n">rule</span>
-        <span class="n">options</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;subdomain&#39;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">endpoint</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">endpoint</span> <span class="o">=</span> <span class="n">_endpoint_from_view_func</span><span class="p">(</span><span class="n">view_func</span><span class="p">)</span>
-        <span class="n">defaults</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_defaults</span>
-        <span class="k">if</span> <span class="s1">&#39;defaults&#39;</span> <span class="ow">in</span> <span class="n">options</span><span class="p">:</span>
-            <span class="n">defaults</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">defaults</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;defaults&#39;</span><span class="p">))</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">.</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">blueprint</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">),</span>
-                              <span class="n">view_func</span><span class="p">,</span> <span class="n">defaults</span><span class="o">=</span><span class="n">defaults</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span></div></div>
-
-
-<div class="viewcode-block" id="Blueprint"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint">[docs]</a><span class="k">class</span> <span class="nc">Blueprint</span><span class="p">(</span><span class="n">_PackageBoundObject</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Represents a blueprint.  A blueprint is an object that records</span>
-<span class="sd">    functions that will be called with the</span>
-<span class="sd">    :class:`~flask.blueprints.BlueprintSetupState` later to register functions</span>
-<span class="sd">    or other things on the main application.  See :ref:`blueprints` for more</span>
-<span class="sd">    information.</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">warn_on_modifications</span> <span class="o">=</span> <span class="kc">False</span>
-    <span class="n">_got_registered_once</span> <span class="o">=</span> <span class="kc">False</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">import_name</span><span class="p">,</span> <span class="n">static_folder</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">static_url_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">template_folder</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">url_prefix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">subdomain</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url_defaults</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">root_path</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">_PackageBoundObject</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">import_name</span><span class="p">,</span> <span class="n">template_folder</span><span class="p">,</span>
-                                     <span class="n">root_path</span><span class="o">=</span><span class="n">root_path</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_prefix</span> <span class="o">=</span> <span class="n">url_prefix</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="n">subdomain</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">static_folder</span> <span class="o">=</span> <span class="n">static_folder</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">static_url_path</span> <span class="o">=</span> <span class="n">static_url_path</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">deferred_functions</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">if</span> <span class="n">url_defaults</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">url_defaults</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_values_defaults</span> <span class="o">=</span> <span class="n">url_defaults</span>
-
-<div class="viewcode-block" id="Blueprint.record"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.record">[docs]</a>    <span class="k">def</span> <span class="nf">record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">func</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a function that is called when the blueprint is</span>
-<span class="sd">        registered on the application.  This function is called with the</span>
-<span class="sd">        state as argument as returned by the :meth:`make_setup_state`</span>
-<span class="sd">        method.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_got_registered_once</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">warn_on_modifications</span><span class="p">:</span>
-            <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-            <span class="n">warn</span><span class="p">(</span><span class="ne">Warning</span><span class="p">(</span><span class="s1">&#39;The blueprint was already registered once &#39;</span>
-                         <span class="s1">&#39;but is getting modified now.  These changes &#39;</span>
-                         <span class="s1">&#39;will not show up.&#39;</span><span class="p">))</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">deferred_functions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">func</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Blueprint.record_once"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.record_once">[docs]</a>    <span class="k">def</span> <span class="nf">record_once</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">func</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Works like :meth:`record` but wraps the function in another</span>
-<span class="sd">        function that will ensure the function is only called once.  If the</span>
-<span class="sd">        blueprint is registered a second time on the application, the</span>
-<span class="sd">        function passed is not called.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">wrapper</span><span class="p">(</span><span class="n">state</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">state</span><span class="o">.</span><span class="n">first_registration</span><span class="p">:</span>
-                <span class="n">func</span><span class="p">(</span><span class="n">state</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">record</span><span class="p">(</span><span class="n">update_wrapper</span><span class="p">(</span><span class="n">wrapper</span><span class="p">,</span> <span class="n">func</span><span class="p">))</span></div>
-
-<div class="viewcode-block" id="Blueprint.make_setup_state"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.make_setup_state">[docs]</a>    <span class="k">def</span> <span class="nf">make_setup_state</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">first_registration</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates an instance of :meth:`~flask.blueprints.BlueprintSetupState`</span>
-<span class="sd">        object that is later passed to the register callback functions.</span>
-<span class="sd">        Subclasses can override this to return a subclass of the setup state.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">BlueprintSetupState</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">first_registration</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Blueprint.register"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.register">[docs]</a>    <span class="k">def</span> <span class="nf">register</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">first_registration</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called by :meth:`Flask.register_blueprint` to register a blueprint</span>
-<span class="sd">        on the application.  This can be overridden to customize the register</span>
-<span class="sd">        behavior.  Keyword arguments from</span>
-<span class="sd">        :func:`~flask.Flask.register_blueprint` are directly forwarded to this</span>
-<span class="sd">        method in the `options` dictionary.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_got_registered_once</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="n">state</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_setup_state</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">first_registration</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">has_static_folder</span><span class="p">:</span>
-            <span class="n">state</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">static_url_path</span> <span class="o">+</span> <span class="s1">&#39;/&lt;path:filename&gt;&#39;</span><span class="p">,</span>
-                               <span class="n">view_func</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">send_static_file</span><span class="p">,</span>
-                               <span class="n">endpoint</span><span class="o">=</span><span class="s1">&#39;static&#39;</span><span class="p">)</span>
-
-        <span class="k">for</span> <span class="n">deferred</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">deferred_functions</span><span class="p">:</span>
-            <span class="n">deferred</span><span class="p">(</span><span class="n">state</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Blueprint.route"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.route">[docs]</a>    <span class="k">def</span> <span class="nf">route</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.route` but for a blueprint.  The endpoint for the</span>
-<span class="sd">        :func:`url_for` function is prefixed with the name of the blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="n">endpoint</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;endpoint&quot;</span><span class="p">,</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.add_url_rule"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.add_url_rule">[docs]</a>    <span class="k">def</span> <span class="nf">add_url_rule</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">,</span> <span class="n">endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">view_func</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.add_url_rule` but for a blueprint.  The endpoint for</span>
-<span class="sd">        the :func:`url_for` function is prefixed with the name of the blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">endpoint</span><span class="p">:</span>
-            <span class="k">assert</span> <span class="s1">&#39;.&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">endpoint</span><span class="p">,</span> <span class="s2">&quot;Blueprint endpoints should not contain dots&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span>
-            <span class="n">s</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">view_func</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">))</span></div>
-
-<div class="viewcode-block" id="Blueprint.endpoint"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.endpoint">[docs]</a>    <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.endpoint` but for a blueprint.  This does not</span>
-<span class="sd">        prefix the endpoint with the blueprint name, this has to be done</span>
-<span class="sd">        explicitly by the user of this method.  If the endpoint is prefixed</span>
-<span class="sd">        with a `.` it will be registered to the current blueprint, otherwise</span>
-<span class="sd">        it&#39;s an application independent endpoint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="k">def</span> <span class="nf">register_endpoint</span><span class="p">(</span><span class="n">state</span><span class="p">):</span>
-                <span class="n">state</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">view_functions</span><span class="p">[</span><span class="n">endpoint</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="n">register_endpoint</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_template_filter"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_template_filter">[docs]</a>    <span class="k">def</span> <span class="nf">app_template_filter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template filter, available application wide.  Like</span>
-<span class="sd">        :meth:`Flask.template_filter` but for a blueprint.</span>
-
-<span class="sd">        :param name: the optional name of the filter, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_app_template_filter</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.add_app_template_filter"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.add_app_template_filter">[docs]</a>    <span class="k">def</span> <span class="nf">add_app_template_filter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template filter, available application wide.  Like</span>
-<span class="sd">        :meth:`Flask.add_template_filter` but for a blueprint.  Works exactly</span>
-<span class="sd">        like the :meth:`app_template_filter` decorator.</span>
-
-<span class="sd">        :param name: the optional name of the filter, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">register_template</span><span class="p">(</span><span class="n">state</span><span class="p">):</span>
-            <span class="n">state</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">filters</span><span class="p">[</span><span class="n">name</span> <span class="ow">or</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="n">register_template</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_template_test"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_template_test">[docs]</a>    <span class="k">def</span> <span class="nf">app_template_test</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template test, available application wide.  Like</span>
-<span class="sd">        :meth:`Flask.template_test` but for a blueprint.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the test, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_app_template_test</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.add_app_template_test"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.add_app_template_test">[docs]</a>    <span class="k">def</span> <span class="nf">add_app_template_test</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template test, available application wide.  Like</span>
-<span class="sd">        :meth:`Flask.add_template_test` but for a blueprint.  Works exactly</span>
-<span class="sd">        like the :meth:`app_template_test` decorator.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the test, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">register_template</span><span class="p">(</span><span class="n">state</span><span class="p">):</span>
-            <span class="n">state</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">tests</span><span class="p">[</span><span class="n">name</span> <span class="ow">or</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="n">register_template</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_template_global"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_template_global">[docs]</a>    <span class="k">def</span> <span class="nf">app_template_global</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template global, available application wide.  Like</span>
-<span class="sd">        :meth:`Flask.template_global` but for a blueprint.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the global, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_app_template_global</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.add_app_template_global"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.add_app_template_global">[docs]</a>    <span class="k">def</span> <span class="nf">add_app_template_global</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Register a custom template global, available application wide.  Like</span>
-<span class="sd">        :meth:`Flask.add_template_global` but for a blueprint.  Works exactly</span>
-<span class="sd">        like the :meth:`app_template_global` decorator.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-
-<span class="sd">        :param name: the optional name of the global, otherwise the</span>
-<span class="sd">                     function name will be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">register_template</span><span class="p">(</span><span class="n">state</span><span class="p">):</span>
-            <span class="n">state</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">globals</span><span class="p">[</span><span class="n">name</span> <span class="ow">or</span> <span class="n">f</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">f</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="n">register_template</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Blueprint.before_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.before_request">[docs]</a>    <span class="k">def</span> <span class="nf">before_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.before_request` but for a blueprint.  This function</span>
-<span class="sd">        is only executed before each request that is handled by a function of</span>
-<span class="sd">        that blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">before_request_funcs</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.before_app_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.before_app_request">[docs]</a>    <span class="k">def</span> <span class="nf">before_app_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.before_request`.  Such a function is executed</span>
-<span class="sd">        before each request, even if outside of a blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">before_request_funcs</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.before_app_first_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.before_app_first_request">[docs]</a>    <span class="k">def</span> <span class="nf">before_app_first_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.before_first_request`.  Such a function is</span>
-<span class="sd">        executed before the first request to the application.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">before_first_request_funcs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.after_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.after_request">[docs]</a>    <span class="k">def</span> <span class="nf">after_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.after_request` but for a blueprint.  This function</span>
-<span class="sd">        is only executed after each request that is handled by a function of</span>
-<span class="sd">        that blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">after_request_funcs</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.after_app_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.after_app_request">[docs]</a>    <span class="k">def</span> <span class="nf">after_app_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.after_request` but for a blueprint.  Such a function</span>
-<span class="sd">        is executed after each request, even if outside of the blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">after_request_funcs</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.teardown_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.teardown_request">[docs]</a>    <span class="k">def</span> <span class="nf">teardown_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.teardown_request` but for a blueprint.  This</span>
-<span class="sd">        function is only executed when tearing down requests handled by a</span>
-<span class="sd">        function of that blueprint.  Teardown request functions are executed</span>
-<span class="sd">        when the request context is popped, even when no actual request was</span>
-<span class="sd">        performed.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">teardown_request_funcs</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.teardown_app_request"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.teardown_app_request">[docs]</a>    <span class="k">def</span> <span class="nf">teardown_app_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.teardown_request` but for a blueprint.  Such a</span>
-<span class="sd">        function is executed when tearing down each request, even if outside of</span>
-<span class="sd">        the blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">teardown_request_funcs</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.context_processor"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.context_processor">[docs]</a>    <span class="k">def</span> <span class="nf">context_processor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.context_processor` but for a blueprint.  This</span>
-<span class="sd">        function is only executed for requests handled by a blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">template_context_processors</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_context_processor"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_context_processor">[docs]</a>    <span class="k">def</span> <span class="nf">app_context_processor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.context_processor` but for a blueprint.  Such a</span>
-<span class="sd">        function is executed each request, even if outside of the blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">template_context_processors</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_errorhandler"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_errorhandler">[docs]</a>    <span class="k">def</span> <span class="nf">app_errorhandler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`Flask.errorhandler` but for a blueprint.  This</span>
-<span class="sd">        handler is used for all requests, even if outside of the blueprint.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">errorhandler</span><span class="p">(</span><span class="n">code</span><span class="p">)(</span><span class="n">f</span><span class="p">))</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.url_value_preprocessor"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.url_value_preprocessor">[docs]</a>    <span class="k">def</span> <span class="nf">url_value_preprocessor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers a function as URL value preprocessor for this</span>
-<span class="sd">        blueprint.  It&#39;s called before the view functions are called and</span>
-<span class="sd">        can modify the url values provided.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">url_value_preprocessors</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.url_defaults"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.url_defaults">[docs]</a>    <span class="k">def</span> <span class="nf">url_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Callback function for URL defaults for this blueprint.  It&#39;s called</span>
-<span class="sd">        with the endpoint and values and should update the values passed</span>
-<span class="sd">        in place.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">url_default_functions</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_url_value_preprocessor"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_url_value_preprocessor">[docs]</a>    <span class="k">def</span> <span class="nf">app_url_value_preprocessor</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Same as :meth:`url_value_preprocessor` but application wide.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">url_value_preprocessors</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.app_url_defaults"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.app_url_defaults">[docs]</a>    <span class="k">def</span> <span class="nf">app_url_defaults</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Same as :meth:`url_defaults` but application wide.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">url_default_functions</span>
-            <span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">f</span></div>
-
-<div class="viewcode-block" id="Blueprint.errorhandler"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.errorhandler">[docs]</a>    <span class="k">def</span> <span class="nf">errorhandler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Registers an error handler that becomes active for this blueprint</span>
-<span class="sd">        only.  Please be aware that routing does not happen local to a</span>
-<span class="sd">        blueprint so an error handler for 404 usually is not handled by</span>
-<span class="sd">        a blueprint unless it is caused inside a view function.  Another</span>
-<span class="sd">        special case is the 500 internal server error which is always looked</span>
-<span class="sd">        up from the application.</span>
-
-<span class="sd">        Otherwise works as the :meth:`~flask.Flask.errorhandler` decorator</span>
-<span class="sd">        of the :class:`~flask.Flask` object.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">_register_error_handler</span><span class="p">(</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">))</span>
-            <span class="k">return</span> <span class="n">f</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="Blueprint.register_error_handler"><a class="viewcode-back" href="../../flask/flask.html#flask.blueprints.Blueprint.register_error_handler">[docs]</a>    <span class="k">def</span> <span class="nf">register_error_handler</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Non-decorator version of the :meth:`errorhandler` error attach</span>
-<span class="sd">        function, akin to the :meth:`~flask.Flask.register_error_handler`</span>
-<span class="sd">        application-wide function of the :class:`~flask.Flask` object but</span>
-<span class="sd">        for error handlers limited to this blueprint.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">record_once</span><span class="p">(</span><span class="k">lambda</span> <span class="n">s</span><span class="p">:</span> <span class="n">s</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">_register_error_handler</span><span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">code_or_exception</span><span class="p">,</span> <span class="n">f</span><span class="p">))</span></div></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/cli.html

@@ -1,570 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.cli &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.cli</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.cli</span>
-<span class="sd">    ~~~~~~~~~</span>
-
-<span class="sd">    A simple command line application to run flask apps.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">import</span> <span class="nn">sys</span>
-<span class="kn">from</span> <span class="nn">threading</span> <span class="k">import</span> <span class="n">Lock</span><span class="p">,</span> <span class="n">Thread</span>
-<span class="kn">from</span> <span class="nn">functools</span> <span class="k">import</span> <span class="n">update_wrapper</span>
-
-<span class="kn">import</span> <span class="nn">click</span>
-
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">iteritems</span><span class="p">,</span> <span class="n">reraise</span>
-<span class="kn">from</span> <span class="nn">.helpers</span> <span class="k">import</span> <span class="n">get_debug_flag</span>
-
-
-<div class="viewcode-block" id="NoAppException"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.NoAppException">[docs]</a><span class="k">class</span> <span class="nc">NoAppException</span><span class="p">(</span><span class="n">click</span><span class="o">.</span><span class="n">UsageError</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Raised if an application cannot be found or loaded.&quot;&quot;&quot;</span></div>
-
-
-<div class="viewcode-block" id="find_best_app"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.find_best_app">[docs]</a><span class="k">def</span> <span class="nf">find_best_app</span><span class="p">(</span><span class="n">module</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Given a module instance this tries to find the best possible</span>
-<span class="sd">    application in the module or raises an exception.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="kn">from</span> <span class="nn">.</span> <span class="k">import</span> <span class="n">Flask</span>
-
-    <span class="c1"># Search for the most common names first.</span>
-    <span class="k">for</span> <span class="n">attr_name</span> <span class="ow">in</span> <span class="s1">&#39;app&#39;</span><span class="p">,</span> <span class="s1">&#39;application&#39;</span><span class="p">:</span>
-        <span class="n">app</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">module</span><span class="p">,</span> <span class="n">attr_name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">app</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">Flask</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">app</span>
-
-    <span class="c1"># Otherwise find the only object that is a Flask instance.</span>
-    <span class="n">matches</span> <span class="o">=</span> <span class="p">[</span><span class="n">v</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">module</span><span class="o">.</span><span class="n">__dict__</span><span class="p">)</span>
-               <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">v</span><span class="p">,</span> <span class="n">Flask</span><span class="p">)]</span>
-
-    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">matches</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">matches</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-    <span class="k">raise</span> <span class="n">NoAppException</span><span class="p">(</span><span class="s1">&#39;Failed to find application in module &quot;</span><span class="si">%s</span><span class="s1">&quot;.  Are &#39;</span>
-                         <span class="s1">&#39;you sure it contains a Flask application?  Maybe &#39;</span>
-                         <span class="s1">&#39;you wrapped it in a WSGI middleware or you are &#39;</span>
-                         <span class="s1">&#39;using a factory function.&#39;</span> <span class="o">%</span> <span class="n">module</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="prepare_exec_for_file"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.prepare_exec_for_file">[docs]</a><span class="k">def</span> <span class="nf">prepare_exec_for_file</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Given a filename this will try to calculate the python path, add it</span>
-<span class="sd">    to the search path and return the actual module name that is expected.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">module</span> <span class="o">=</span> <span class="p">[]</span>
-
-    <span class="c1"># Chop off file extensions or package markers</span>
-    <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">filename</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;__init__.py&#39;</span><span class="p">:</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-    <span class="k">elif</span> <span class="n">filename</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">&#39;.py&#39;</span><span class="p">):</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">filename</span><span class="p">[:</span><span class="o">-</span><span class="mi">3</span><span class="p">]</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="k">raise</span> <span class="n">NoAppException</span><span class="p">(</span><span class="s1">&#39;The file provided (</span><span class="si">%s</span><span class="s1">) does exist but is not a &#39;</span>
-                             <span class="s1">&#39;valid Python file.  This means that it cannot &#39;</span>
-                             <span class="s1">&#39;be used as application.  Please change the &#39;</span>
-                             <span class="s1">&#39;extension to .py&#39;</span> <span class="o">%</span> <span class="n">filename</span><span class="p">)</span>
-    <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">realpath</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-
-    <span class="n">dirpath</span> <span class="o">=</span> <span class="n">filename</span>
-    <span class="k">while</span> <span class="mi">1</span><span class="p">:</span>
-        <span class="n">dirpath</span><span class="p">,</span> <span class="n">extra</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">dirpath</span><span class="p">)</span>
-        <span class="n">module</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">extra</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">dirpath</span><span class="p">,</span> <span class="s1">&#39;__init__.py&#39;</span><span class="p">)):</span>
-            <span class="k">break</span>
-
-    <span class="n">sys</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">dirpath</span><span class="p">)</span>
-    <span class="k">return</span> <span class="s1">&#39;.&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">module</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">])</span></div>
-
-
-<div class="viewcode-block" id="locate_app"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.locate_app">[docs]</a><span class="k">def</span> <span class="nf">locate_app</span><span class="p">(</span><span class="n">app_id</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Attempts to locate the application.&quot;&quot;&quot;</span>
-    <span class="n">__traceback_hide__</span> <span class="o">=</span> <span class="kc">True</span>
-    <span class="k">if</span> <span class="s1">&#39;:&#39;</span> <span class="ow">in</span> <span class="n">app_id</span><span class="p">:</span>
-        <span class="n">module</span><span class="p">,</span> <span class="n">app_obj</span> <span class="o">=</span> <span class="n">app_id</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;:&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">module</span> <span class="o">=</span> <span class="n">app_id</span>
-        <span class="n">app_obj</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="nb">__import__</span><span class="p">(</span><span class="n">module</span><span class="p">)</span>
-    <span class="n">mod</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="n">module</span><span class="p">]</span>
-    <span class="k">if</span> <span class="n">app_obj</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">app</span> <span class="o">=</span> <span class="n">find_best_app</span><span class="p">(</span><span class="n">mod</span><span class="p">)</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">app</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">mod</span><span class="p">,</span> <span class="n">app_obj</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">app</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Failed to find application in module &quot;</span><span class="si">%s</span><span class="s1">&quot;&#39;</span>
-                               <span class="o">%</span> <span class="n">module</span><span class="p">)</span>
-
-    <span class="k">return</span> <span class="n">app</span></div>
-
-
-<div class="viewcode-block" id="find_default_import_path"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.find_default_import_path">[docs]</a><span class="k">def</span> <span class="nf">find_default_import_path</span><span class="p">():</span>
-    <span class="n">app</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;FLASK_APP&#39;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">app</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">return</span>
-    <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">app</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">prepare_exec_for_file</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">app</span></div>
-
-
-<div class="viewcode-block" id="DispatchingApp"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.DispatchingApp">[docs]</a><span class="k">class</span> <span class="nc">DispatchingApp</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Special application that dispatches to a flask application which</span>
-<span class="sd">    is imported by name in a background thread.  If an error happens</span>
-<span class="sd">    it is is recorded and shows as part of the WSGI handling which in case</span>
-<span class="sd">    of the Werkzeug debugger means that it shows up in the browser.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">loader</span><span class="p">,</span> <span class="n">use_eager_loading</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">loader</span> <span class="o">=</span> <span class="n">loader</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_app</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span> <span class="o">=</span> <span class="n">Lock</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_bg_loading_exc_info</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">if</span> <span class="n">use_eager_loading</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_load_unlocked</span><span class="p">()</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_load_in_background</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">_load_in_background</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">_load_app</span><span class="p">():</span>
-            <span class="n">__traceback_hide__</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span><span class="p">:</span>
-                <span class="k">try</span><span class="p">:</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_load_unlocked</span><span class="p">()</span>
-                <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_bg_loading_exc_info</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-        <span class="n">t</span> <span class="o">=</span> <span class="n">Thread</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="n">_load_app</span><span class="p">,</span> <span class="n">args</span><span class="o">=</span><span class="p">())</span>
-        <span class="n">t</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">_flush_bg_loading_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">__traceback_hide__</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="n">exc_info</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_bg_loading_exc_info</span>
-        <span class="k">if</span> <span class="n">exc_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_bg_loading_exc_info</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="n">reraise</span><span class="p">(</span><span class="o">*</span><span class="n">exc_info</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_load_unlocked</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">__traceback_hide__</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_app</span> <span class="o">=</span> <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">loader</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_bg_loading_exc_info</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">):</span>
-        <span class="n">__traceback_hide__</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_app</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_app</span><span class="p">(</span><span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_flush_bg_loading_exception</span><span class="p">()</span>
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lock</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_app</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_app</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_load_unlocked</span><span class="p">()</span>
-            <span class="k">return</span> <span class="n">rv</span><span class="p">(</span><span class="n">environ</span><span class="p">,</span> <span class="n">start_response</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="ScriptInfo"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.ScriptInfo">[docs]</a><span class="k">class</span> <span class="nc">ScriptInfo</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Help object to deal with Flask applications.  This is usually not</span>
-<span class="sd">    necessary to interface with as it&#39;s used internally in the dispatching</span>
-<span class="sd">    to click.  In future versions of Flask this object will most likely play</span>
-<span class="sd">    a bigger role.  Typically it&#39;s created automatically by the</span>
-<span class="sd">    :class:`FlaskGroup` but you can also manually create it and pass it</span>
-<span class="sd">    onwards as click object.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app_import_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">create_app</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">create_app</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">app_import_path</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">app_import_path</span> <span class="o">=</span> <span class="n">find_default_import_path</span><span class="p">()</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">app_import_path</span> <span class="o">=</span> <span class="n">app_import_path</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">app_import_path</span> <span class="o">=</span> <span class="kc">None</span>
-
-        <span class="c1">#: Optionally the import path for the Flask application.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app_import_path</span> <span class="o">=</span> <span class="n">app_import_path</span>
-        <span class="c1">#: Optionally a function that is passed the script info to create</span>
-        <span class="c1">#: the instance of the application.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">create_app</span> <span class="o">=</span> <span class="n">create_app</span>
-        <span class="c1">#: A dictionary with arbitrary data that can be associated with</span>
-        <span class="c1">#: this script info.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">data</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_app</span> <span class="o">=</span> <span class="kc">None</span>
-
-<div class="viewcode-block" id="ScriptInfo.load_app"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.ScriptInfo.load_app">[docs]</a>    <span class="k">def</span> <span class="nf">load_app</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Loads the Flask app (if not yet loaded) and returns it.  Calling</span>
-<span class="sd">        this multiple times will just result in the already loaded app to</span>
-<span class="sd">        be returned.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">__traceback_hide__</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_app</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_app</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_app</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_app</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">app_import_path</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="n">NoAppException</span><span class="p">(</span>
-                    <span class="s1">&#39;Could not locate Flask application. You did not provide &#39;</span>
-                    <span class="s1">&#39;the FLASK_APP environment variable.</span><span class="se">\n\n</span><span class="s1">For more &#39;</span>
-                    <span class="s1">&#39;information see &#39;</span>
-                    <span class="s1">&#39;http://flask.pocoo.org/docs/latest/quickstart/&#39;</span><span class="p">)</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">locate_app</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">app_import_path</span><span class="p">)</span>
-        <span class="n">debug</span> <span class="o">=</span> <span class="n">get_debug_flag</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">debug</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">debug</span> <span class="o">=</span> <span class="n">debug</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_app</span> <span class="o">=</span> <span class="n">rv</span>
-        <span class="k">return</span> <span class="n">rv</span></div></div>
-
-
-<span class="n">pass_script_info</span> <span class="o">=</span> <span class="n">click</span><span class="o">.</span><span class="n">make_pass_decorator</span><span class="p">(</span><span class="n">ScriptInfo</span><span class="p">,</span> <span class="n">ensure</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="with_appcontext"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.with_appcontext">[docs]</a><span class="k">def</span> <span class="nf">with_appcontext</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Wraps a callback so that it&#39;s guaranteed to be executed with the</span>
-<span class="sd">    script&#39;s application context.  If callbacks are registered directly</span>
-<span class="sd">    to the ``app.cli`` object then they are wrapped with this function</span>
-<span class="sd">    by default unless it&#39;s disabled.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="nd">@click</span><span class="o">.</span><span class="n">pass_context</span>
-    <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">__ctx</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="k">with</span> <span class="n">__ctx</span><span class="o">.</span><span class="n">ensure_object</span><span class="p">(</span><span class="n">ScriptInfo</span><span class="p">)</span><span class="o">.</span><span class="n">load_app</span><span class="p">()</span><span class="o">.</span><span class="n">app_context</span><span class="p">():</span>
-            <span class="k">return</span> <span class="n">__ctx</span><span class="o">.</span><span class="n">invoke</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">update_wrapper</span><span class="p">(</span><span class="n">decorator</span><span class="p">,</span> <span class="n">f</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="AppGroup"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.AppGroup">[docs]</a><span class="k">class</span> <span class="nc">AppGroup</span><span class="p">(</span><span class="n">click</span><span class="o">.</span><span class="n">Group</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;This works similar to a regular click :class:`~click.Group` but it</span>
-<span class="sd">    changes the behavior of the :meth:`command` decorator so that it</span>
-<span class="sd">    automatically wraps the functions in :func:`with_appcontext`.</span>
-
-<span class="sd">    Not to be confused with :class:`FlaskGroup`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-<div class="viewcode-block" id="AppGroup.command"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.AppGroup.command">[docs]</a>    <span class="k">def</span> <span class="nf">command</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This works exactly like the method of the same name on a regular</span>
-<span class="sd">        :class:`click.Group` but it wraps callbacks in :func:`with_appcontext`</span>
-<span class="sd">        unless it&#39;s disabled by passing ``with_appcontext=False``.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">wrap_for_ctx</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;with_appcontext&#39;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">wrap_for_ctx</span><span class="p">:</span>
-                <span class="n">f</span> <span class="o">=</span> <span class="n">with_appcontext</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">click</span><span class="o">.</span><span class="n">Group</span><span class="o">.</span><span class="n">command</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)(</span><span class="n">f</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">decorator</span></div>
-
-<div class="viewcode-block" id="AppGroup.group"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.AppGroup.group">[docs]</a>    <span class="k">def</span> <span class="nf">group</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This works exactly like the method of the same name on a regular</span>
-<span class="sd">        :class:`click.Group` but it defaults the group class to</span>
-<span class="sd">        :class:`AppGroup`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;cls&#39;</span><span class="p">,</span> <span class="n">AppGroup</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">click</span><span class="o">.</span><span class="n">Group</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div></div>
-
-
-<div class="viewcode-block" id="FlaskGroup"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.FlaskGroup">[docs]</a><span class="k">class</span> <span class="nc">FlaskGroup</span><span class="p">(</span><span class="n">AppGroup</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Special subclass of the :class:`AppGroup` group that supports</span>
-<span class="sd">    loading more commands from the configured Flask app.  Normally a</span>
-<span class="sd">    developer does not have to interface with this class but there are</span>
-<span class="sd">    some very advanced use cases for which it makes sense to create an</span>
-<span class="sd">    instance of this.</span>
-
-<span class="sd">    For information as of why this is useful see :ref:`custom-scripts`.</span>
-
-<span class="sd">    :param add_default_commands: if this is True then the default run and</span>
-<span class="sd">                                 shell commands wil be added.</span>
-<span class="sd">    :param create_app: an optional callback that is passed the script info</span>
-<span class="sd">                       and returns the loaded app.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">add_default_commands</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">create_app</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">extra</span><span class="p">):</span>
-        <span class="n">AppGroup</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">extra</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">create_app</span> <span class="o">=</span> <span class="n">create_app</span>
-
-        <span class="k">if</span> <span class="n">add_default_commands</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_command</span><span class="p">(</span><span class="n">run_command</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_command</span><span class="p">(</span><span class="n">shell_command</span><span class="p">)</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_plugin_commands</span> <span class="o">=</span> <span class="kc">False</span>
-
-    <span class="k">def</span> <span class="nf">_load_plugin_commands</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_plugin_commands</span><span class="p">:</span>
-            <span class="k">return</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="kn">import</span> <span class="nn">pkg_resources</span>
-        <span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_plugin_commands</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="k">return</span>
-
-        <span class="k">for</span> <span class="n">ep</span> <span class="ow">in</span> <span class="n">pkg_resources</span><span class="o">.</span><span class="n">iter_entry_points</span><span class="p">(</span><span class="s1">&#39;flask.commands&#39;</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add_command</span><span class="p">(</span><span class="n">ep</span><span class="o">.</span><span class="n">load</span><span class="p">(),</span> <span class="n">ep</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_loaded_plugin_commands</span> <span class="o">=</span> <span class="kc">True</span>
-
-<div class="viewcode-block" id="FlaskGroup.get_command"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.FlaskGroup.get_command">[docs]</a>    <span class="k">def</span> <span class="nf">get_command</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ctx</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_load_plugin_commands</span><span class="p">()</span>
-
-        <span class="c1"># We load built-in commands first as these should always be the</span>
-        <span class="c1"># same no matter what the app does.  If the app does want to</span>
-        <span class="c1"># override this it needs to make a custom instance of this group</span>
-        <span class="c1"># and not attach the default commands.</span>
-        <span class="c1">#</span>
-        <span class="c1"># This also means that the script stays functional in case the</span>
-        <span class="c1"># application completely fails.</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="n">AppGroup</span><span class="o">.</span><span class="n">get_command</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ctx</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">rv</span>
-
-        <span class="n">info</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">ensure_object</span><span class="p">(</span><span class="n">ScriptInfo</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">info</span><span class="o">.</span><span class="n">load_app</span><span class="p">()</span><span class="o">.</span><span class="n">cli</span><span class="o">.</span><span class="n">get_command</span><span class="p">(</span><span class="n">ctx</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">rv</span>
-        <span class="k">except</span> <span class="n">NoAppException</span><span class="p">:</span>
-            <span class="k">pass</span></div>
-
-<div class="viewcode-block" id="FlaskGroup.list_commands"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.FlaskGroup.list_commands">[docs]</a>    <span class="k">def</span> <span class="nf">list_commands</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ctx</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_load_plugin_commands</span><span class="p">()</span>
-
-        <span class="c1"># The commands available is the list of both the application (if</span>
-        <span class="c1"># available) plus the builtin commands.</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">click</span><span class="o">.</span><span class="n">Group</span><span class="o">.</span><span class="n">list_commands</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ctx</span><span class="p">))</span>
-        <span class="n">info</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">ensure_object</span><span class="p">(</span><span class="n">ScriptInfo</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">info</span><span class="o">.</span><span class="n">load_app</span><span class="p">()</span><span class="o">.</span><span class="n">cli</span><span class="o">.</span><span class="n">list_commands</span><span class="p">(</span><span class="n">ctx</span><span class="p">))</span>
-        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-            <span class="c1"># Here we intentionally swallow all exceptions as we don&#39;t</span>
-            <span class="c1"># want the help page to break if the app does not exist.</span>
-            <span class="c1"># If someone attempts to use the command we try to create</span>
-            <span class="c1"># the app again and this will give us the error.</span>
-            <span class="k">pass</span>
-        <span class="k">return</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="FlaskGroup.main"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.FlaskGroup.main">[docs]</a>    <span class="k">def</span> <span class="nf">main</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="n">obj</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;obj&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">obj</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">obj</span> <span class="o">=</span> <span class="n">ScriptInfo</span><span class="p">(</span><span class="n">create_app</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">create_app</span><span class="p">)</span>
-        <span class="n">kwargs</span><span class="p">[</span><span class="s1">&#39;obj&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">obj</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;auto_envvar_prefix&#39;</span><span class="p">,</span> <span class="s1">&#39;FLASK&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">AppGroup</span><span class="o">.</span><span class="n">main</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div></div>
-
-
-<span class="nd">@click</span><span class="o">.</span><span class="n">command</span><span class="p">(</span><span class="s1">&#39;run&#39;</span><span class="p">,</span> <span class="n">short_help</span><span class="o">=</span><span class="s1">&#39;Runs a development server.&#39;</span><span class="p">)</span>
-<span class="nd">@click</span><span class="o">.</span><span class="n">option</span><span class="p">(</span><span class="s1">&#39;--host&#39;</span><span class="p">,</span> <span class="s1">&#39;-h&#39;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s1">&#39;127.0.0.1&#39;</span><span class="p">,</span>
-              <span class="n">help</span><span class="o">=</span><span class="s1">&#39;The interface to bind to.&#39;</span><span class="p">)</span>
-<span class="nd">@click</span><span class="o">.</span><span class="n">option</span><span class="p">(</span><span class="s1">&#39;--port&#39;</span><span class="p">,</span> <span class="s1">&#39;-p&#39;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="mi">5000</span><span class="p">,</span>
-              <span class="n">help</span><span class="o">=</span><span class="s1">&#39;The port to bind to.&#39;</span><span class="p">)</span>
-<span class="nd">@click</span><span class="o">.</span><span class="n">option</span><span class="p">(</span><span class="s1">&#39;--reload/--no-reload&#39;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-              <span class="n">help</span><span class="o">=</span><span class="s1">&#39;Enable or disable the reloader.  By default the reloader &#39;</span>
-              <span class="s1">&#39;is active if debug is enabled.&#39;</span><span class="p">)</span>
-<span class="nd">@click</span><span class="o">.</span><span class="n">option</span><span class="p">(</span><span class="s1">&#39;--debugger/--no-debugger&#39;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-              <span class="n">help</span><span class="o">=</span><span class="s1">&#39;Enable or disable the debugger.  By default the debugger &#39;</span>
-              <span class="s1">&#39;is active if debug is enabled.&#39;</span><span class="p">)</span>
-<span class="nd">@click</span><span class="o">.</span><span class="n">option</span><span class="p">(</span><span class="s1">&#39;--eager-loading/--lazy-loader&#39;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-              <span class="n">help</span><span class="o">=</span><span class="s1">&#39;Enable or disable eager loading.  By default eager &#39;</span>
-              <span class="s1">&#39;loading is enabled if the reloader is disabled.&#39;</span><span class="p">)</span>
-<span class="nd">@click</span><span class="o">.</span><span class="n">option</span><span class="p">(</span><span class="s1">&#39;--with-threads/--without-threads&#39;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-              <span class="n">help</span><span class="o">=</span><span class="s1">&#39;Enable or disable multithreading.&#39;</span><span class="p">)</span>
-<span class="nd">@pass_script_info</span>
-<span class="k">def</span> <span class="nf">run_command</span><span class="p">(</span><span class="n">info</span><span class="p">,</span> <span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">,</span> <span class="n">reload</span><span class="p">,</span> <span class="n">debugger</span><span class="p">,</span> <span class="n">eager_loading</span><span class="p">,</span>
-                <span class="n">with_threads</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Runs a local development server for the Flask application.</span>
-
-<span class="sd">    This local server is recommended for development purposes only but it</span>
-<span class="sd">    can also be used for simple intranet deployments.  By default it will</span>
-<span class="sd">    not support any sort of concurrency at all to simplify debugging.  This</span>
-<span class="sd">    can be changed with the --with-threads option which will enable basic</span>
-<span class="sd">    multithreading.</span>
-
-<span class="sd">    The reloader and debugger are by default enabled if the debug flag of</span>
-<span class="sd">    Flask is enabled and disabled otherwise.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="kn">from</span> <span class="nn">werkzeug.serving</span> <span class="k">import</span> <span class="n">run_simple</span>
-
-    <span class="n">debug</span> <span class="o">=</span> <span class="n">get_debug_flag</span><span class="p">()</span>
-    <span class="k">if</span> <span class="n">reload</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">reload</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="n">debug</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">debugger</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">debugger</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="n">debug</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">eager_loading</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">eager_loading</span> <span class="o">=</span> <span class="ow">not</span> <span class="n">reload</span>
-
-    <span class="n">app</span> <span class="o">=</span> <span class="n">DispatchingApp</span><span class="p">(</span><span class="n">info</span><span class="o">.</span><span class="n">load_app</span><span class="p">,</span> <span class="n">use_eager_loading</span><span class="o">=</span><span class="n">eager_loading</span><span class="p">)</span>
-
-    <span class="c1"># Extra startup messages.  This depends a but on Werkzeug internals to</span>
-    <span class="c1"># not double execute when the reloader kicks in.</span>
-    <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;WERKZEUG_RUN_MAIN&#39;</span><span class="p">)</span> <span class="o">!=</span> <span class="s1">&#39;true&#39;</span><span class="p">:</span>
-        <span class="c1"># If we have an import path we can print it out now which can help</span>
-        <span class="c1"># people understand what&#39;s being served.  If we do not have an</span>
-        <span class="c1"># import path because the app was loaded through a callback then</span>
-        <span class="c1"># we won&#39;t print anything.</span>
-        <span class="k">if</span> <span class="n">info</span><span class="o">.</span><span class="n">app_import_path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s1">&#39; * Serving Flask app &quot;</span><span class="si">%s</span><span class="s1">&quot;&#39;</span> <span class="o">%</span> <span class="n">info</span><span class="o">.</span><span class="n">app_import_path</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">debug</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="nb">print</span><span class="p">(</span><span class="s1">&#39; * Forcing debug mode </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">debug</span> <span class="ow">and</span> <span class="s1">&#39;on&#39;</span> <span class="ow">or</span> <span class="s1">&#39;off&#39;</span><span class="p">))</span>
-
-    <span class="n">run_simple</span><span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">use_reloader</span><span class="o">=</span><span class="n">reload</span><span class="p">,</span>
-               <span class="n">use_debugger</span><span class="o">=</span><span class="n">debugger</span><span class="p">,</span> <span class="n">threaded</span><span class="o">=</span><span class="n">with_threads</span><span class="p">)</span>
-
-
-<span class="nd">@click</span><span class="o">.</span><span class="n">command</span><span class="p">(</span><span class="s1">&#39;shell&#39;</span><span class="p">,</span> <span class="n">short_help</span><span class="o">=</span><span class="s1">&#39;Runs a shell in the app context.&#39;</span><span class="p">)</span>
-<span class="nd">@with_appcontext</span>
-<span class="k">def</span> <span class="nf">shell_command</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;Runs an interactive Python shell in the context of a given</span>
-<span class="sd">    Flask application.  The application will populate the default</span>
-<span class="sd">    namespace of this shell according to it&#39;s configuration.</span>
-
-<span class="sd">    This is useful for executing small snippets of management code</span>
-<span class="sd">    without having to manually configuring the application.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="kn">import</span> <span class="nn">code</span>
-    <span class="kn">from</span> <span class="nn">flask.globals</span> <span class="k">import</span> <span class="n">_app_ctx_stack</span>
-    <span class="n">app</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">app</span>
-    <span class="n">banner</span> <span class="o">=</span> <span class="s1">&#39;Python </span><span class="si">%s</span><span class="s1"> on </span><span class="si">%s</span><span class="se">\n</span><span class="s1">App: </span><span class="si">%s%s</span><span class="se">\n</span><span class="s1">Instance: </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-        <span class="n">sys</span><span class="o">.</span><span class="n">version</span><span class="p">,</span>
-        <span class="n">sys</span><span class="o">.</span><span class="n">platform</span><span class="p">,</span>
-        <span class="n">app</span><span class="o">.</span><span class="n">import_name</span><span class="p">,</span>
-        <span class="n">app</span><span class="o">.</span><span class="n">debug</span> <span class="ow">and</span> <span class="s1">&#39; [debug]&#39;</span> <span class="ow">or</span> <span class="s1">&#39;&#39;</span><span class="p">,</span>
-        <span class="n">app</span><span class="o">.</span><span class="n">instance_path</span><span class="p">,</span>
-    <span class="p">)</span>
-    <span class="n">ctx</span> <span class="o">=</span> <span class="p">{}</span>
-
-    <span class="c1"># Support the regular Python interpreter startup script if someone</span>
-    <span class="c1"># is using it.</span>
-    <span class="n">startup</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;PYTHONSTARTUP&#39;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">startup</span> <span class="ow">and</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">startup</span><span class="p">):</span>
-        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">startup</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-            <span class="nb">eval</span><span class="p">(</span><span class="nb">compile</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">(),</span> <span class="n">startup</span><span class="p">,</span> <span class="s1">&#39;exec&#39;</span><span class="p">),</span> <span class="n">ctx</span><span class="p">)</span>
-
-    <span class="n">ctx</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">make_shell_context</span><span class="p">())</span>
-
-    <span class="n">code</span><span class="o">.</span><span class="n">interact</span><span class="p">(</span><span class="n">banner</span><span class="o">=</span><span class="n">banner</span><span class="p">,</span> <span class="n">local</span><span class="o">=</span><span class="n">ctx</span><span class="p">)</span>
-
-
-<span class="n">cli</span> <span class="o">=</span> <span class="n">FlaskGroup</span><span class="p">(</span><span class="n">help</span><span class="o">=</span><span class="s2">&quot;&quot;&quot;</span><span class="se">\</span>
-<span class="s2">This shell command acts as general utility script for Flask applications.</span>
-
-<span class="s2">It loads the application configured (either through the FLASK_APP environment</span>
-<span class="s2">variable) and then provides commands either provided by the application or</span>
-<span class="s2">Flask itself.</span>
-
-<span class="s2">The most useful commands are the &quot;run&quot; and &quot;shell&quot; command.</span>
-
-<span class="s2">Example usage:</span>
-
-<span class="se">\b</span><span class="s2"></span>
-<span class="s2">  </span><span class="si">%(prefix)s%(cmd)s</span><span class="s2"> FLASK_APP=hello</span>
-<span class="s2">  </span><span class="si">%(prefix)s%(cmd)s</span><span class="s2"> FLASK_DEBUG=1</span>
-<span class="s2">  </span><span class="si">%(prefix)s</span><span class="s2">flask run</span>
-<span class="s2">&quot;&quot;&quot;</span> <span class="o">%</span> <span class="p">{</span>
-    <span class="s1">&#39;cmd&#39;</span><span class="p">:</span> <span class="n">os</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s1">&#39;posix&#39;</span> <span class="ow">and</span> <span class="s1">&#39;export&#39;</span> <span class="ow">or</span> <span class="s1">&#39;set&#39;</span><span class="p">,</span>
-    <span class="s1">&#39;prefix&#39;</span><span class="p">:</span> <span class="n">os</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s1">&#39;posix&#39;</span> <span class="ow">and</span> <span class="s1">&#39;$ &#39;</span> <span class="ow">or</span> <span class="s1">&#39;&#39;</span><span class="p">,</span>
-<span class="p">})</span>
-
-
-<div class="viewcode-block" id="main"><a class="viewcode-back" href="../../flask/flask.html#flask.cli.main">[docs]</a><span class="k">def</span> <span class="nf">main</span><span class="p">(</span><span class="n">as_module</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-    <span class="n">this_module</span> <span class="o">=</span> <span class="n">__package__</span> <span class="o">+</span> <span class="s1">&#39;.cli&#39;</span>
-    <span class="n">args</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">:]</span>
-
-    <span class="k">if</span> <span class="n">as_module</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">sys</span><span class="o">.</span><span class="n">version_info</span> <span class="o">&gt;=</span> <span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">7</span><span class="p">):</span>
-            <span class="n">name</span> <span class="o">=</span> <span class="s1">&#39;python -m &#39;</span> <span class="o">+</span> <span class="n">this_module</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">name</span> <span class="o">=</span> <span class="s1">&#39;python -m &#39;</span> <span class="o">+</span> <span class="n">this_module</span>
-
-        <span class="c1"># This module is always executed as &quot;python -m flask.run&quot; and as such</span>
-        <span class="c1"># we need to ensure that we restore the actual command line so that</span>
-        <span class="c1"># the reloader can properly operate.</span>
-        <span class="n">sys</span><span class="o">.</span><span class="n">argv</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;-m&#39;</span><span class="p">,</span> <span class="n">this_module</span><span class="p">]</span> <span class="o">+</span> <span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">:]</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">name</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="n">cli</span><span class="o">.</span><span class="n">main</span><span class="p">(</span><span class="n">args</span><span class="o">=</span><span class="n">args</span><span class="p">,</span> <span class="n">prog_name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span></div>
-
-
-<span class="k">if</span> <span class="n">__name__</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>
-    <span class="n">main</span><span class="p">(</span><span class="n">as_module</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/config.html

@@ -1,346 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.config &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.config</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.config</span>
-<span class="sd">    ~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements the configuration related objects.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">import</span> <span class="nn">types</span>
-<span class="kn">import</span> <span class="nn">errno</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.utils</span> <span class="k">import</span> <span class="n">import_string</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">string_types</span><span class="p">,</span> <span class="n">iteritems</span>
-<span class="kn">from</span> <span class="nn">.</span> <span class="k">import</span> <span class="n">json</span>
-
-
-<div class="viewcode-block" id="ConfigAttribute"><a class="viewcode-back" href="../../flask/flask.html#flask.app.ConfigAttribute">[docs]</a><span class="k">class</span> <span class="nc">ConfigAttribute</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Makes an attribute forward to the config&quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">get_converter</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__name__</span> <span class="o">=</span> <span class="n">name</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">get_converter</span> <span class="o">=</span> <span class="n">get_converter</span>
-
-    <span class="k">def</span> <span class="nf">__get__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">obj</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_converter</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_converter</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">__set__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">obj</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
-
-
-<div class="viewcode-block" id="Config"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config">[docs]</a><span class="k">class</span> <span class="nc">Config</span><span class="p">(</span><span class="nb">dict</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Works exactly like a dict but provides ways to fill it from files</span>
-<span class="sd">    or special dictionaries.  There are two common patterns to populate the</span>
-<span class="sd">    config.</span>
-
-<span class="sd">    Either you can fill the config from a config file::</span>
-
-<span class="sd">        app.config.from_pyfile(&#39;yourconfig.cfg&#39;)</span>
-
-<span class="sd">    Or alternatively you can define the configuration options in the</span>
-<span class="sd">    module that calls :meth:`from_object` or provide an import path to</span>
-<span class="sd">    a module that should be loaded.  It is also possible to tell it to</span>
-<span class="sd">    use the same module and with that provide the configuration values</span>
-<span class="sd">    just before the call::</span>
-
-<span class="sd">        DEBUG = True</span>
-<span class="sd">        SECRET_KEY = &#39;development key&#39;</span>
-<span class="sd">        app.config.from_object(__name__)</span>
-
-<span class="sd">    In both cases (loading from any Python file or loading from modules),</span>
-<span class="sd">    only uppercase keys are added to the config.  This makes it possible to use</span>
-<span class="sd">    lowercase values in the config file for temporary values that are not added</span>
-<span class="sd">    to the config or to define the config keys in the same file that implements</span>
-<span class="sd">    the application.</span>
-
-<span class="sd">    Probably the most interesting way to load configurations is from an</span>
-<span class="sd">    environment variable pointing to a file::</span>
-
-<span class="sd">        app.config.from_envvar(&#39;YOURAPPLICATION_SETTINGS&#39;)</span>
-
-<span class="sd">    In this case before launching the application you have to set this</span>
-<span class="sd">    environment variable to the file you want to use.  On Linux and OS X</span>
-<span class="sd">    use the export statement::</span>
-
-<span class="sd">        export YOURAPPLICATION_SETTINGS=&#39;/path/to/config/file&#39;</span>
-
-<span class="sd">    On windows use `set` instead.</span>
-
-<span class="sd">    :param root_path: path to which files are read relative from.  When the</span>
-<span class="sd">                      config object is created by the application, this is</span>
-<span class="sd">                      the application&#39;s :attr:`~flask.Flask.root_path`.</span>
-<span class="sd">    :param defaults: an optional dictionary of default values</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">root_path</span><span class="p">,</span> <span class="n">defaults</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">defaults</span> <span class="ow">or</span> <span class="p">{})</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">root_path</span> <span class="o">=</span> <span class="n">root_path</span>
-
-<div class="viewcode-block" id="Config.from_envvar"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config.from_envvar">[docs]</a>    <span class="k">def</span> <span class="nf">from_envvar</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">variable_name</span><span class="p">,</span> <span class="n">silent</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Loads a configuration from an environment variable pointing to</span>
-<span class="sd">        a configuration file.  This is basically just a shortcut with nicer</span>
-<span class="sd">        error messages for this line of code::</span>
-
-<span class="sd">            app.config.from_pyfile(os.environ[&#39;YOURAPPLICATION_SETTINGS&#39;])</span>
-
-<span class="sd">        :param variable_name: name of the environment variable</span>
-<span class="sd">        :param silent: set to ``True`` if you want silent failure for missing</span>
-<span class="sd">                       files.</span>
-<span class="sd">        :return: bool. ``True`` if able to load config, ``False`` otherwise.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">variable_name</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">rv</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">silent</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">False</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;The environment variable </span><span class="si">%r</span><span class="s1"> is not set &#39;</span>
-                               <span class="s1">&#39;and as such configuration could not be &#39;</span>
-                               <span class="s1">&#39;loaded.  Set this variable and make it &#39;</span>
-                               <span class="s1">&#39;point to a configuration file&#39;</span> <span class="o">%</span>
-                               <span class="n">variable_name</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">from_pyfile</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="n">silent</span><span class="o">=</span><span class="n">silent</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Config.from_pyfile"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config.from_pyfile">[docs]</a>    <span class="k">def</span> <span class="nf">from_pyfile</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filename</span><span class="p">,</span> <span class="n">silent</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Updates the values in the config from a Python file.  This function</span>
-<span class="sd">        behaves as if the file was imported as module with the</span>
-<span class="sd">        :meth:`from_object` function.</span>
-
-<span class="sd">        :param filename: the filename of the config.  This can either be an</span>
-<span class="sd">                         absolute filename or a filename relative to the</span>
-<span class="sd">                         root path.</span>
-<span class="sd">        :param silent: set to ``True`` if you want silent failure for missing</span>
-<span class="sd">                       files.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">           `silent` parameter.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span>
-        <span class="n">d</span> <span class="o">=</span> <span class="n">types</span><span class="o">.</span><span class="n">ModuleType</span><span class="p">(</span><span class="s1">&#39;config&#39;</span><span class="p">)</span>
-        <span class="n">d</span><span class="o">.</span><span class="n">__file__</span> <span class="o">=</span> <span class="n">filename</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span> <span class="k">as</span> <span class="n">config_file</span><span class="p">:</span>
-                <span class="n">exec</span><span class="p">(</span><span class="nb">compile</span><span class="p">(</span><span class="n">config_file</span><span class="o">.</span><span class="n">read</span><span class="p">(),</span> <span class="n">filename</span><span class="p">,</span> <span class="s1">&#39;exec&#39;</span><span class="p">),</span> <span class="n">d</span><span class="o">.</span><span class="n">__dict__</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">IOError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">silent</span> <span class="ow">and</span> <span class="n">e</span><span class="o">.</span><span class="n">errno</span> <span class="ow">in</span> <span class="p">(</span><span class="n">errno</span><span class="o">.</span><span class="n">ENOENT</span><span class="p">,</span> <span class="n">errno</span><span class="o">.</span><span class="n">EISDIR</span><span class="p">):</span>
-                <span class="k">return</span> <span class="kc">False</span>
-            <span class="n">e</span><span class="o">.</span><span class="n">strerror</span> <span class="o">=</span> <span class="s1">&#39;Unable to load configuration file (</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="n">e</span><span class="o">.</span><span class="n">strerror</span>
-            <span class="k">raise</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">from_object</span><span class="p">(</span><span class="n">d</span><span class="p">)</span>
-        <span class="k">return</span> <span class="kc">True</span></div>
-
-<div class="viewcode-block" id="Config.from_object"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config.from_object">[docs]</a>    <span class="k">def</span> <span class="nf">from_object</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Updates the values from the given object.  An object can be of one</span>
-<span class="sd">        of the following two types:</span>
-
-<span class="sd">        -   a string: in this case the object with that name will be imported</span>
-<span class="sd">        -   an actual object reference: that object is used directly</span>
-
-<span class="sd">        Objects are usually either modules or classes.</span>
-
-<span class="sd">        Just the uppercase variables in that object are stored in the config.</span>
-<span class="sd">        Example usage::</span>
-
-<span class="sd">            app.config.from_object(&#39;yourapplication.default_config&#39;)</span>
-<span class="sd">            from yourapplication import default_config</span>
-<span class="sd">            app.config.from_object(default_config)</span>
-
-<span class="sd">        You should not use this function to load the actual configuration but</span>
-<span class="sd">        rather configuration defaults.  The actual config should be loaded</span>
-<span class="sd">        with :meth:`from_pyfile` and ideally from a location not within the</span>
-<span class="sd">        package because the package might be installed system wide.</span>
-
-<span class="sd">        :param obj: an import name or object</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="n">obj</span> <span class="o">=</span> <span class="n">import_string</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="nb">dir</span><span class="p">(</span><span class="n">obj</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">key</span><span class="o">.</span><span class="n">isupper</span><span class="p">():</span>
-                <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Config.from_json"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config.from_json">[docs]</a>    <span class="k">def</span> <span class="nf">from_json</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filename</span><span class="p">,</span> <span class="n">silent</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Updates the values in the config from a JSON file. This function</span>
-<span class="sd">        behaves as if the JSON object was a dictionary and passed to the</span>
-<span class="sd">        :meth:`from_mapping` function.</span>
-
-<span class="sd">        :param filename: the filename of the JSON file.  This can either be an</span>
-<span class="sd">                         absolute filename or a filename relative to the</span>
-<span class="sd">                         root path.</span>
-<span class="sd">        :param silent: set to ``True`` if you want silent failure for missing</span>
-<span class="sd">                       files.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span>
-
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span> <span class="k">as</span> <span class="n">json_file</span><span class="p">:</span>
-                <span class="n">obj</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">json_file</span><span class="o">.</span><span class="n">read</span><span class="p">())</span>
-        <span class="k">except</span> <span class="ne">IOError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">silent</span> <span class="ow">and</span> <span class="n">e</span><span class="o">.</span><span class="n">errno</span> <span class="ow">in</span> <span class="p">(</span><span class="n">errno</span><span class="o">.</span><span class="n">ENOENT</span><span class="p">,</span> <span class="n">errno</span><span class="o">.</span><span class="n">EISDIR</span><span class="p">):</span>
-                <span class="k">return</span> <span class="kc">False</span>
-            <span class="n">e</span><span class="o">.</span><span class="n">strerror</span> <span class="o">=</span> <span class="s1">&#39;Unable to load configuration file (</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="n">e</span><span class="o">.</span><span class="n">strerror</span>
-            <span class="k">raise</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">from_mapping</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Config.from_mapping"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config.from_mapping">[docs]</a>    <span class="k">def</span> <span class="nf">from_mapping</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">mapping</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Updates the config like :meth:`update` ignoring items with non-upper</span>
-<span class="sd">        keys.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">mappings</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">mapping</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="s1">&#39;items&#39;</span><span class="p">):</span>
-                <span class="n">mappings</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">mapping</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">())</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">mappings</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">mapping</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
-        <span class="k">elif</span> <span class="nb">len</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
-                <span class="s1">&#39;expected at most 1 positional argument, got </span><span class="si">%d</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="nb">len</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span>
-            <span class="p">)</span>
-        <span class="n">mappings</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">kwargs</span><span class="o">.</span><span class="n">items</span><span class="p">())</span>
-        <span class="k">for</span> <span class="n">mapping</span> <span class="ow">in</span> <span class="n">mappings</span><span class="p">:</span>
-            <span class="k">for</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">key</span><span class="o">.</span><span class="n">isupper</span><span class="p">():</span>
-                    <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-        <span class="k">return</span> <span class="kc">True</span></div>
-
-<div class="viewcode-block" id="Config.get_namespace"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Config.get_namespace">[docs]</a>    <span class="k">def</span> <span class="nf">get_namespace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">namespace</span><span class="p">,</span> <span class="n">lowercase</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">trim_namespace</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns a dictionary containing a subset of configuration options</span>
-<span class="sd">        that match the specified namespace/prefix. Example usage::</span>
-
-<span class="sd">            app.config[&#39;IMAGE_STORE_TYPE&#39;] = &#39;fs&#39;</span>
-<span class="sd">            app.config[&#39;IMAGE_STORE_PATH&#39;] = &#39;/var/app/images&#39;</span>
-<span class="sd">            app.config[&#39;IMAGE_STORE_BASE_URL&#39;] = &#39;http://img.website.com&#39;</span>
-<span class="sd">            image_store_config = app.config.get_namespace(&#39;IMAGE_STORE_&#39;)</span>
-
-<span class="sd">        The resulting dictionary `image_store_config` would look like::</span>
-
-<span class="sd">            {</span>
-<span class="sd">                &#39;type&#39;: &#39;fs&#39;,</span>
-<span class="sd">                &#39;path&#39;: &#39;/var/app/images&#39;,</span>
-<span class="sd">                &#39;base_url&#39;: &#39;http://img.website.com&#39;</span>
-<span class="sd">            }</span>
-
-<span class="sd">        This is often useful when configuration options map directly to</span>
-<span class="sd">        keyword arguments in functions or class constructors.</span>
-
-<span class="sd">        :param namespace: a configuration namespace</span>
-<span class="sd">        :param lowercase: a flag indicating if the keys of the resulting</span>
-<span class="sd">                          dictionary should be lowercase</span>
-<span class="sd">        :param trim_namespace: a flag indicating if the keys of the resulting</span>
-<span class="sd">                          dictionary should not include the namespace</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">k</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="n">namespace</span><span class="p">):</span>
-                <span class="k">continue</span>
-            <span class="k">if</span> <span class="n">trim_namespace</span><span class="p">:</span>
-                <span class="n">key</span> <span class="o">=</span> <span class="n">k</span><span class="p">[</span><span class="nb">len</span><span class="p">(</span><span class="n">namespace</span><span class="p">):]</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">key</span> <span class="o">=</span> <span class="n">k</span>
-            <span class="k">if</span> <span class="n">lowercase</span><span class="p">:</span>
-                <span class="n">key</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-            <span class="n">rv</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">v</span>
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%s</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/ctx.html

@@ -1,498 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.ctx &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.ctx</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.ctx</span>
-<span class="sd">    ~~~~~~~~~</span>
-
-<span class="sd">    Implements the objects required to keep the context.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">import</span> <span class="nn">sys</span>
-<span class="kn">from</span> <span class="nn">functools</span> <span class="k">import</span> <span class="n">update_wrapper</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.exceptions</span> <span class="k">import</span> <span class="n">HTTPException</span>
-
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span><span class="p">,</span> <span class="n">_app_ctx_stack</span>
-<span class="kn">from</span> <span class="nn">.signals</span> <span class="k">import</span> <span class="n">appcontext_pushed</span><span class="p">,</span> <span class="n">appcontext_popped</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">BROKEN_PYPY_CTXMGR_EXIT</span><span class="p">,</span> <span class="n">reraise</span>
-
-
-<span class="c1"># a singleton sentinel value for parameter defaults</span>
-<span class="n">_sentinel</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span>
-
-
-<span class="k">class</span> <span class="nc">_AppCtxGlobals</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;A plain object.&quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__dict__</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">_sentinel</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">default</span> <span class="ow">is</span> <span class="n">_sentinel</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__dict__</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__dict__</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__dict__</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__contains__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">__dict__</span>
-
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__dict__</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">top</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">top</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="s1">&#39;&lt;flask.g of </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="n">top</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">name</span>
-        <span class="k">return</span> <span class="nb">object</span><span class="o">.</span><span class="n">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="after_this_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.after_this_request">[docs]</a><span class="k">def</span> <span class="nf">after_this_request</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Executes a function after this request.  This is useful to modify</span>
-<span class="sd">    response objects.  The function is passed the response object and has</span>
-<span class="sd">    to return the same or a new one.</span>
-
-<span class="sd">    Example::</span>
-
-<span class="sd">        @app.route(&#39;/&#39;)</span>
-<span class="sd">        def index():</span>
-<span class="sd">            @after_this_request</span>
-<span class="sd">            def add_header(response):</span>
-<span class="sd">                response.headers[&#39;X-Foo&#39;] = &#39;Parachute&#39;</span>
-<span class="sd">                return response</span>
-<span class="sd">            return &#39;Hello World!&#39;</span>
-
-<span class="sd">    This is more useful if a function other than the view function wants to</span>
-<span class="sd">    modify a response.  For instance think of a decorator that wants to add</span>
-<span class="sd">    some headers without converting the return value into a response object.</span>
-
-<span class="sd">    .. versionadded:: 0.9</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">_after_request_functions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">f</span></div>
-
-
-<div class="viewcode-block" id="copy_current_request_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.copy_current_request_context">[docs]</a><span class="k">def</span> <span class="nf">copy_current_request_context</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;A helper function that decorates a function to retain the current</span>
-<span class="sd">    request context.  This is useful when working with greenlets.  The moment</span>
-<span class="sd">    the function is decorated a copy of the request context is created and</span>
-<span class="sd">    then pushed when the function is called.</span>
-
-<span class="sd">    Example::</span>
-
-<span class="sd">        import gevent</span>
-<span class="sd">        from flask import copy_current_request_context</span>
-
-<span class="sd">        @app.route(&#39;/&#39;)</span>
-<span class="sd">        def index():</span>
-<span class="sd">            @copy_current_request_context</span>
-<span class="sd">            def do_some_work():</span>
-<span class="sd">                # do some work here, it can access flask.request like you</span>
-<span class="sd">                # would otherwise in the view function.</span>
-<span class="sd">                ...</span>
-<span class="sd">            gevent.spawn(do_some_work)</span>
-<span class="sd">            return &#39;Regular response&#39;</span>
-
-<span class="sd">    .. versionadded:: 0.10</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">top</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="k">if</span> <span class="n">top</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;This decorator can only be used at local scopes &#39;</span>
-            <span class="s1">&#39;when a request context is on the stack.  For instance within &#39;</span>
-            <span class="s1">&#39;view functions.&#39;</span><span class="p">)</span>
-    <span class="n">reqctx</span> <span class="o">=</span> <span class="n">top</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-    <span class="k">def</span> <span class="nf">wrapper</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="k">with</span> <span class="n">reqctx</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">f</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">update_wrapper</span><span class="p">(</span><span class="n">wrapper</span><span class="p">,</span> <span class="n">f</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="has_request_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.has_request_context">[docs]</a><span class="k">def</span> <span class="nf">has_request_context</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;If you have code that wants to test if a request context is there or</span>
-<span class="sd">    not this function can be used.  For instance, you may want to take advantage</span>
-<span class="sd">    of request information if the request object is available, but fail</span>
-<span class="sd">    silently if it is unavailable.</span>
-
-<span class="sd">    ::</span>
-
-<span class="sd">        class User(db.Model):</span>
-
-<span class="sd">            def __init__(self, username, remote_addr=None):</span>
-<span class="sd">                self.username = username</span>
-<span class="sd">                if remote_addr is None and has_request_context():</span>
-<span class="sd">                    remote_addr = request.remote_addr</span>
-<span class="sd">                self.remote_addr = remote_addr</span>
-
-<span class="sd">    Alternatively you can also just test any of the context bound objects</span>
-<span class="sd">    (such as :class:`request` or :class:`g` for truthness)::</span>
-
-<span class="sd">        class User(db.Model):</span>
-
-<span class="sd">            def __init__(self, username, remote_addr=None):</span>
-<span class="sd">                self.username = username</span>
-<span class="sd">                if remote_addr is None and request:</span>
-<span class="sd">                    remote_addr = request.remote_addr</span>
-<span class="sd">                self.remote_addr = remote_addr</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span></div>
-
-
-<div class="viewcode-block" id="has_app_context"><a class="viewcode-back" href="../../flask/flask.html#flask.app.has_app_context">[docs]</a><span class="k">def</span> <span class="nf">has_app_context</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;Works like :func:`has_request_context` but for the application</span>
-<span class="sd">    context.  You can also just do a boolean check on the</span>
-<span class="sd">    :data:`current_app` object instead.</span>
-
-<span class="sd">    .. versionadded:: 0.9</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span></div>
-
-
-<div class="viewcode-block" id="AppContext"><a class="viewcode-back" href="../../flask/flask.html#flask.app.AppContext">[docs]</a><span class="k">class</span> <span class="nc">AppContext</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The application context binds an application object implicitly</span>
-<span class="sd">    to the current thread or greenlet, similar to how the</span>
-<span class="sd">    :class:`RequestContext` binds request information.  The application</span>
-<span class="sd">    context is also implicitly created if a request context is created</span>
-<span class="sd">    but the application is not on top of the individual application</span>
-<span class="sd">    context.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app</span> <span class="o">=</span> <span class="n">app</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_adapter</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">create_url_adapter</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">g</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">app_ctx_globals_class</span><span class="p">()</span>
-
-        <span class="c1"># Like request context, app contexts can be pushed multiple times</span>
-        <span class="c1"># but there a basic &quot;refcount&quot; is enough to track them.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_refcnt</span> <span class="o">=</span> <span class="mi">0</span>
-
-<div class="viewcode-block" id="AppContext.push"><a class="viewcode-back" href="../../flask/flask.html#flask.app.AppContext.push">[docs]</a>    <span class="k">def</span> <span class="nf">push</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Binds the app context to the current context.&quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_refcnt</span> <span class="o">+=</span> <span class="mi">1</span>
-        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">sys</span><span class="p">,</span> <span class="s1">&#39;exc_clear&#39;</span><span class="p">):</span>
-            <span class="n">sys</span><span class="o">.</span><span class="n">exc_clear</span><span class="p">()</span>
-        <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">push</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="n">appcontext_pushed</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="AppContext.pop"><a class="viewcode-back" href="../../flask/flask.html#flask.app.AppContext.pop">[docs]</a>    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="o">=</span><span class="n">_sentinel</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Pops the app context.&quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_refcnt</span> <span class="o">-=</span> <span class="mi">1</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_refcnt</span> <span class="o">&lt;=</span> <span class="mi">0</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">exc</span> <span class="ow">is</span> <span class="n">_sentinel</span><span class="p">:</span>
-                    <span class="n">exc</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()[</span><span class="mi">1</span><span class="p">]</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">do_teardown_appcontext</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-        <span class="k">assert</span> <span class="n">rv</span> <span class="ow">is</span> <span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;Popped wrong app context.  (</span><span class="si">%r</span><span class="s1"> instead of </span><span class="si">%r</span><span class="s1">)&#39;</span> \
-            <span class="o">%</span> <span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
-        <span class="n">appcontext_popped</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="p">)</span></div>
-
-    <span class="k">def</span> <span class="nf">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-    <span class="k">def</span> <span class="nf">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">exc_value</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">BROKEN_PYPY_CTXMGR_EXIT</span> <span class="ow">and</span> <span class="n">exc_type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">reraise</span><span class="p">(</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="RequestContext"><a class="viewcode-back" href="../../flask/flask.html#flask.app.RequestContext">[docs]</a><span class="k">class</span> <span class="nc">RequestContext</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The request context contains all request relevant information.  It is</span>
-<span class="sd">    created at the beginning of the request and pushed to the</span>
-<span class="sd">    `_request_ctx_stack` and removed at the end of it.  It will create the</span>
-<span class="sd">    URL adapter and request object for the WSGI environment provided.</span>
-
-<span class="sd">    Do not attempt to use this class directly, instead use</span>
-<span class="sd">    :meth:`~flask.Flask.test_request_context` and</span>
-<span class="sd">    :meth:`~flask.Flask.request_context` to create this object.</span>
-
-<span class="sd">    When the request context is popped, it will evaluate all the</span>
-<span class="sd">    functions registered on the application for teardown execution</span>
-<span class="sd">    (:meth:`~flask.Flask.teardown_request`).</span>
-
-<span class="sd">    The request context is automatically popped at the end of the request</span>
-<span class="sd">    for you.  In debug mode the request context is kept around if</span>
-<span class="sd">    exceptions happen so that interactive debuggers have a chance to</span>
-<span class="sd">    introspect the data.  With 0.4 this can also be forced for requests</span>
-<span class="sd">    that did not fail and outside of ``DEBUG`` mode.  By setting</span>
-<span class="sd">    ``&#39;flask._preserve_context&#39;`` to ``True`` on the WSGI environment the</span>
-<span class="sd">    context will not pop itself at the end of the request.  This is used by</span>
-<span class="sd">    the :meth:`~flask.Flask.test_client` for example to implement the</span>
-<span class="sd">    deferred cleanup functionality.</span>
-
-<span class="sd">    You might find this helpful for unittests where you need the</span>
-<span class="sd">    information from the context local around for a little longer.  Make</span>
-<span class="sd">    sure to properly :meth:`~werkzeug.LocalStack.pop` the stack yourself in</span>
-<span class="sd">    that situation, otherwise your unittests will leak memory.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">environ</span><span class="p">,</span> <span class="n">request</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app</span> <span class="o">=</span> <span class="n">app</span>
-        <span class="k">if</span> <span class="n">request</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">request</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">request_class</span><span class="p">(</span><span class="n">environ</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">request</span> <span class="o">=</span> <span class="n">request</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_adapter</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">create_url_adapter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">flashes</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="kc">None</span>
-
-        <span class="c1"># Request contexts can be pushed multiple times and interleaved with</span>
-        <span class="c1"># other request contexts.  Now only if the last level is popped we</span>
-        <span class="c1"># get rid of them.  Additionally if an application context is missing</span>
-        <span class="c1"># one is created implicitly so for each level we add this information</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_implicit_app_ctx_stack</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="c1"># indicator if the context was preserved.  Next time another context</span>
-        <span class="c1"># is pushed the preserved context is popped.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">preserved</span> <span class="o">=</span> <span class="kc">False</span>
-
-        <span class="c1"># remembers the exception for pop if there is one in case the context</span>
-        <span class="c1"># preservation kicks in.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_preserved_exc</span> <span class="o">=</span> <span class="kc">None</span>
-
-        <span class="c1"># Functions that should be executed after the request on the response</span>
-        <span class="c1"># object.  These will be called before the regular &quot;after_request&quot;</span>
-        <span class="c1"># functions.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_after_request_functions</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">match_request</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">_get_g</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">g</span>
-    <span class="k">def</span> <span class="nf">_set_g</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">g</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="n">g</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_g</span><span class="p">,</span> <span class="n">_set_g</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_g</span><span class="p">,</span> <span class="n">_set_g</span>
-
-<div class="viewcode-block" id="RequestContext.copy"><a class="viewcode-back" href="../../flask/flask.html#flask.app.RequestContext.copy">[docs]</a>    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a copy of this request context with the same request object.</span>
-<span class="sd">        This can be used to move a request context to a different greenlet.</span>
-<span class="sd">        Because the actual request object is the same this cannot be used to</span>
-<span class="sd">        move a request context to a different thread unless access to the</span>
-<span class="sd">        request object is locked.</span>
-
-<span class="sd">        .. versionadded:: 0.10</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="p">,</span>
-            <span class="n">environ</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">,</span>
-            <span class="n">request</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">request</span>
-        <span class="p">)</span></div>
-
-<div class="viewcode-block" id="RequestContext.match_request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.RequestContext.match_request">[docs]</a>    <span class="k">def</span> <span class="nf">match_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Can be overridden by a subclass to hook into the matching</span>
-<span class="sd">        of the request.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">url_rule</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">view_args</span> <span class="o">=</span> \
-                <span class="bp">self</span><span class="o">.</span><span class="n">url_adapter</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">return_rule</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">url_rule</span> <span class="o">=</span> <span class="n">url_rule</span>
-        <span class="k">except</span> <span class="n">HTTPException</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">routing_exception</span> <span class="o">=</span> <span class="n">e</span></div>
-
-<div class="viewcode-block" id="RequestContext.push"><a class="viewcode-back" href="../../flask/flask.html#flask.app.RequestContext.push">[docs]</a>    <span class="k">def</span> <span class="nf">push</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Binds the request context to the current context.&quot;&quot;&quot;</span>
-        <span class="c1"># If an exception occurs in debug mode or if context preservation is</span>
-        <span class="c1"># activated under exception situations exactly one context stays</span>
-        <span class="c1"># on the stack.  The rationale is that you want to access that</span>
-        <span class="c1"># information under debug situations.  However if someone forgets to</span>
-        <span class="c1"># pop that context again we want to make sure that on the next push</span>
-        <span class="c1"># it&#39;s invalidated, otherwise we run at risk that something leaks</span>
-        <span class="c1"># memory.  This is usually only a problem in test suite since this</span>
-        <span class="c1"># functionality is not active in production environments.</span>
-        <span class="n">top</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">top</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">top</span><span class="o">.</span><span class="n">preserved</span><span class="p">:</span>
-            <span class="n">top</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">top</span><span class="o">.</span><span class="n">_preserved_exc</span><span class="p">)</span>
-
-        <span class="c1"># Before we push the request context we have to ensure that there</span>
-        <span class="c1"># is an application context.</span>
-        <span class="n">app_ctx</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">app_ctx</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">or</span> <span class="n">app_ctx</span><span class="o">.</span><span class="n">app</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="p">:</span>
-            <span class="n">app_ctx</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">app_context</span><span class="p">()</span>
-            <span class="n">app_ctx</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_implicit_app_ctx_stack</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">app_ctx</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_implicit_app_ctx_stack</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">sys</span><span class="p">,</span> <span class="s1">&#39;exc_clear&#39;</span><span class="p">):</span>
-            <span class="n">sys</span><span class="o">.</span><span class="n">exc_clear</span><span class="p">()</span>
-
-        <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">push</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-        <span class="c1"># Open the session at the moment that the request context is</span>
-        <span class="c1"># available. This allows a custom open_session method to use the</span>
-        <span class="c1"># request context (e.g. code that access database information</span>
-        <span class="c1"># stored on `g` instead of the appcontext).</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">open_session</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">make_null_session</span><span class="p">()</span></div>
-
-<div class="viewcode-block" id="RequestContext.pop"><a class="viewcode-back" href="../../flask/flask.html#flask.app.RequestContext.pop">[docs]</a>    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="o">=</span><span class="n">_sentinel</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Pops the request context and unbinds it by doing that.  This will</span>
-<span class="sd">        also trigger the execution of functions registered by the</span>
-<span class="sd">        :meth:`~flask.Flask.teardown_request` decorator.</span>
-
-<span class="sd">        .. versionchanged:: 0.9</span>
-<span class="sd">           Added the `exc` argument.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">app_ctx</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_implicit_app_ctx_stack</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">clear_request</span> <span class="o">=</span> <span class="kc">False</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_implicit_app_ctx_stack</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">preserved</span> <span class="o">=</span> <span class="kc">False</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_preserved_exc</span> <span class="o">=</span> <span class="kc">None</span>
-                <span class="k">if</span> <span class="n">exc</span> <span class="ow">is</span> <span class="n">_sentinel</span><span class="p">:</span>
-                    <span class="n">exc</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()[</span><span class="mi">1</span><span class="p">]</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">do_teardown_request</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span>
-
-                <span class="c1"># If this interpreter supports clearing the exception information</span>
-                <span class="c1"># we do that now.  This will only go into effect on Python 2.x,</span>
-                <span class="c1"># on 3.x it disappears automatically at the end of the exception</span>
-                <span class="c1"># stack.</span>
-                <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">sys</span><span class="p">,</span> <span class="s1">&#39;exc_clear&#39;</span><span class="p">):</span>
-                    <span class="n">sys</span><span class="o">.</span><span class="n">exc_clear</span><span class="p">()</span>
-
-                <span class="n">request_close</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="p">,</span> <span class="s1">&#39;close&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">request_close</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">request_close</span><span class="p">()</span>
-                <span class="n">clear_request</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-
-            <span class="c1"># get rid of circular dependencies at the end of the request</span>
-            <span class="c1"># so that we don&#39;t require the GC to be active.</span>
-            <span class="k">if</span> <span class="n">clear_request</span><span class="p">:</span>
-                <span class="n">rv</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;werkzeug.request&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
-
-            <span class="c1"># Get rid of the app as well if necessary.</span>
-            <span class="k">if</span> <span class="n">app_ctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">app_ctx</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span>
-
-            <span class="k">assert</span> <span class="n">rv</span> <span class="ow">is</span> <span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;Popped wrong request context.  &#39;</span> \
-                <span class="s1">&#39;(</span><span class="si">%r</span><span class="s1"> instead of </span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="RequestContext.auto_pop"><a class="viewcode-back" href="../../flask/flask.html#flask.app.RequestContext.auto_pop">[docs]</a>    <span class="k">def</span> <span class="nf">auto_pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;flask._preserve_context&#39;</span><span class="p">)</span> <span class="ow">or</span> \
-           <span class="p">(</span><span class="n">exc</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">preserve_context_on_exception</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">preserved</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_preserved_exc</span> <span class="o">=</span> <span class="n">exc</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span></div>
-
-    <span class="k">def</span> <span class="nf">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-    <span class="k">def</span> <span class="nf">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-        <span class="c1"># do not pop the request stack if we are in debug mode and an</span>
-        <span class="c1"># exception happened.  This will allow the debugger to still</span>
-        <span class="c1"># access the request object in the interactive shell.  Furthermore</span>
-        <span class="c1"># the context can be force kept alive for the test client.</span>
-        <span class="c1"># See flask.testing for how this works.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">auto_pop</span><span class="p">(</span><span class="n">exc_value</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">BROKEN_PYPY_CTXMGR_EXIT</span> <span class="ow">and</span> <span class="n">exc_type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">reraise</span><span class="p">(</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="se">\&#39;</span><span class="si">%s</span><span class="se">\&#39;</span><span class="s1"> [</span><span class="si">%s</span><span class="s1">] of </span><span class="si">%s</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">url</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">method</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-        <span class="p">)</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/debughelpers.html

@@ -1,243 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.debughelpers &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.debughelpers</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.debughelpers</span>
-<span class="sd">    ~~~~~~~~~~~~~~~~~~</span>
-
-<span class="sd">    Various helpers to make the development experience better.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">implements_to_string</span><span class="p">,</span> <span class="n">text_type</span>
-<span class="kn">from</span> <span class="nn">.app</span> <span class="k">import</span> <span class="n">Flask</span>
-<span class="kn">from</span> <span class="nn">.blueprints</span> <span class="k">import</span> <span class="n">Blueprint</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span>
-
-
-<div class="viewcode-block" id="UnexpectedUnicodeError"><a class="viewcode-back" href="../../flask/flask.html#flask.debughelpers.UnexpectedUnicodeError">[docs]</a><span class="k">class</span> <span class="nc">UnexpectedUnicodeError</span><span class="p">(</span><span class="ne">AssertionError</span><span class="p">,</span> <span class="ne">UnicodeError</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Raised in places where we want some better error reporting for</span>
-<span class="sd">    unexpected unicode or binary data.</span>
-<span class="sd">    &quot;&quot;&quot;</span></div>
-
-
-<span class="nd">@implements_to_string</span>
-<div class="viewcode-block" id="DebugFilesKeyError"><a class="viewcode-back" href="../../flask/flask.html#flask.debughelpers.DebugFilesKeyError">[docs]</a><span class="k">class</span> <span class="nc">DebugFilesKeyError</span><span class="p">(</span><span class="ne">KeyError</span><span class="p">,</span> <span class="ne">AssertionError</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Raised from request.files during debugging.  The idea is that it can</span>
-<span class="sd">    provide a better error message than just a generic KeyError/BadRequest.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="n">form_matches</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">form</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="n">buf</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;You tried to access the file &quot;</span><span class="si">%s</span><span class="s1">&quot; in the request.files &#39;</span>
-               <span class="s1">&#39;dictionary but it does not exist.  The mimetype for the request &#39;</span>
-               <span class="s1">&#39;is &quot;</span><span class="si">%s</span><span class="s1">&quot; instead of &quot;multipart/form-data&quot; which means that no &#39;</span>
-               <span class="s1">&#39;file contents were transmitted.  To fix this error you should &#39;</span>
-               <span class="s1">&#39;provide enctype=&quot;multipart/form-data&quot; in your form.&#39;</span> <span class="o">%</span>
-               <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">request</span><span class="o">.</span><span class="n">mimetype</span><span class="p">)]</span>
-        <span class="k">if</span> <span class="n">form_matches</span><span class="p">:</span>
-            <span class="n">buf</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n\n</span><span class="s1">The browser instead transmitted some file names. &#39;</span>
-                       <span class="s1">&#39;This was submitted: </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s1">&#39;&quot;</span><span class="si">%s</span><span class="s1">&quot;&#39;</span> <span class="o">%</span> <span class="n">x</span>
-                            <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">form_matches</span><span class="p">))</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">msg</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buf</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">msg</span></div>
-
-
-<div class="viewcode-block" id="FormDataRoutingRedirect"><a class="viewcode-back" href="../../flask/flask.html#flask.debughelpers.FormDataRoutingRedirect">[docs]</a><span class="k">class</span> <span class="nc">FormDataRoutingRedirect</span><span class="p">(</span><span class="ne">AssertionError</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;This exception is raised by Flask in debug mode if it detects a</span>
-<span class="sd">    redirect caused by the routing system when the request method is not</span>
-<span class="sd">    GET, HEAD or OPTIONS.  Reasoning: form data will be dropped.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
-        <span class="n">exc</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">routing_exception</span>
-        <span class="n">buf</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;A request was sent to this URL (</span><span class="si">%s</span><span class="s1">) but a redirect was &#39;</span>
-               <span class="s1">&#39;issued automatically by the routing system to &quot;</span><span class="si">%s</span><span class="s1">&quot;.&#39;</span>
-               <span class="o">%</span> <span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">url</span><span class="p">,</span> <span class="n">exc</span><span class="o">.</span><span class="n">new_url</span><span class="p">)]</span>
-
-        <span class="c1"># In case just a slash was appended we can be extra helpful</span>
-        <span class="k">if</span> <span class="n">request</span><span class="o">.</span><span class="n">base_url</span> <span class="o">+</span> <span class="s1">&#39;/&#39;</span> <span class="o">==</span> <span class="n">exc</span><span class="o">.</span><span class="n">new_url</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;?&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]:</span>
-            <span class="n">buf</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;  The URL was defined with a trailing slash so &#39;</span>
-                       <span class="s1">&#39;Flask will automatically redirect to the URL &#39;</span>
-                       <span class="s1">&#39;with the trailing slash if it was accessed &#39;</span>
-                       <span class="s1">&#39;without one.&#39;</span><span class="p">)</span>
-
-        <span class="n">buf</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;  Make sure to directly send your </span><span class="si">%s</span><span class="s1">-request to this URL &#39;</span>
-                   <span class="s1">&#39;since we can</span><span class="se">\&#39;</span><span class="s1">t make browsers or HTTP clients redirect &#39;</span>
-                   <span class="s1">&#39;with form data reliably or without user interaction.&#39;</span> <span class="o">%</span>
-                   <span class="n">request</span><span class="o">.</span><span class="n">method</span><span class="p">)</span>
-        <span class="n">buf</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n\n</span><span class="s1">Note: this exception is only raised in debug mode&#39;</span><span class="p">)</span>
-        <span class="ne">AssertionError</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">buf</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;utf-8&#39;</span><span class="p">))</span></div>
-
-
-<div class="viewcode-block" id="attach_enctype_error_multidict"><a class="viewcode-back" href="../../flask/flask.html#flask.debughelpers.attach_enctype_error_multidict">[docs]</a><span class="k">def</span> <span class="nf">attach_enctype_error_multidict</span><span class="p">(</span><span class="n">request</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Since Flask 0.8 we&#39;re monkeypatching the files object in case a</span>
-<span class="sd">    request is detected that does not use multipart form data but the files</span>
-<span class="sd">    object is accessed.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">oldcls</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">files</span><span class="o">.</span><span class="n">__class__</span>
-    <span class="k">class</span> <span class="nc">newcls</span><span class="p">(</span><span class="n">oldcls</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">oldcls</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-            <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">request</span><span class="o">.</span><span class="n">form</span><span class="p">:</span>
-                    <span class="k">raise</span>
-                <span class="k">raise</span> <span class="n">DebugFilesKeyError</span><span class="p">(</span><span class="n">request</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-    <span class="n">newcls</span><span class="o">.</span><span class="n">__name__</span> <span class="o">=</span> <span class="n">oldcls</span><span class="o">.</span><span class="n">__name__</span>
-    <span class="n">newcls</span><span class="o">.</span><span class="n">__module__</span> <span class="o">=</span> <span class="n">oldcls</span><span class="o">.</span><span class="n">__module__</span>
-    <span class="n">request</span><span class="o">.</span><span class="n">files</span><span class="o">.</span><span class="n">__class__</span> <span class="o">=</span> <span class="n">newcls</span></div>
-
-
-<span class="k">def</span> <span class="nf">_dump_loader_info</span><span class="p">(</span><span class="n">loader</span><span class="p">):</span>
-    <span class="k">yield</span> <span class="s1">&#39;class: </span><span class="si">%s</span><span class="s1">.</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="nb">type</span><span class="p">(</span><span class="n">loader</span><span class="p">)</span><span class="o">.</span><span class="n">__module__</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="n">loader</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
-    <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">loader</span><span class="o">.</span><span class="n">__dict__</span><span class="o">.</span><span class="n">items</span><span class="p">()):</span>
-        <span class="k">if</span> <span class="n">key</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;_&#39;</span><span class="p">):</span>
-            <span class="k">continue</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">)):</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="nb">all</span><span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">text_type</span><span class="p">))</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">value</span><span class="p">):</span>
-                <span class="k">continue</span>
-            <span class="k">yield</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">:&#39;</span> <span class="o">%</span> <span class="n">key</span>
-            <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="s1">&#39;  - </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">item</span>
-            <span class="k">continue</span>
-        <span class="k">elif</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">text_type</span><span class="p">,</span> <span class="nb">int</span><span class="p">,</span> <span class="nb">float</span><span class="p">,</span> <span class="nb">bool</span><span class="p">)):</span>
-            <span class="k">continue</span>
-        <span class="k">yield</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">: </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="explain_template_loading_attempts"><a class="viewcode-back" href="../../flask/flask.html#flask.debughelpers.explain_template_loading_attempts">[docs]</a><span class="k">def</span> <span class="nf">explain_template_loading_attempts</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">template</span><span class="p">,</span> <span class="n">attempts</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;This should help developers understand what failed&quot;&quot;&quot;</span>
-    <span class="n">info</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;Locating template &quot;</span><span class="si">%s</span><span class="s1">&quot;:&#39;</span> <span class="o">%</span> <span class="n">template</span><span class="p">]</span>
-    <span class="n">total_found</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="n">blueprint</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="n">reqctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="k">if</span> <span class="n">reqctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">blueprint</span> <span class="o">=</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">blueprint</span>
-
-    <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="p">(</span><span class="n">loader</span><span class="p">,</span> <span class="n">srcobj</span><span class="p">,</span> <span class="n">triple</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">attempts</span><span class="p">):</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">srcobj</span><span class="p">,</span> <span class="n">Flask</span><span class="p">):</span>
-            <span class="n">src_info</span> <span class="o">=</span> <span class="s1">&#39;application &quot;</span><span class="si">%s</span><span class="s1">&quot;&#39;</span> <span class="o">%</span> <span class="n">srcobj</span><span class="o">.</span><span class="n">import_name</span>
-        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">srcobj</span><span class="p">,</span> <span class="n">Blueprint</span><span class="p">):</span>
-            <span class="n">src_info</span> <span class="o">=</span> <span class="s1">&#39;blueprint &quot;</span><span class="si">%s</span><span class="s1">&quot; (</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">srcobj</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-                                                <span class="n">srcobj</span><span class="o">.</span><span class="n">import_name</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">src_info</span> <span class="o">=</span> <span class="nb">repr</span><span class="p">(</span><span class="n">srcobj</span><span class="p">)</span>
-
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">% 5d</span><span class="s1">: trying loader of </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="n">idx</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">src_info</span><span class="p">))</span>
-
-        <span class="k">for</span> <span class="n">line</span> <span class="ow">in</span> <span class="n">_dump_loader_info</span><span class="p">(</span><span class="n">loader</span><span class="p">):</span>
-            <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;       </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">line</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">triple</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">detail</span> <span class="o">=</span> <span class="s1">&#39;no match&#39;</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">detail</span> <span class="o">=</span> <span class="s1">&#39;found (</span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">triple</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="ow">or</span> <span class="s1">&#39;&lt;string&gt;&#39;</span><span class="p">)</span>
-            <span class="n">total_found</span> <span class="o">+=</span> <span class="mi">1</span>
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;       -&gt; </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">detail</span><span class="p">)</span>
-
-    <span class="n">seems_fishy</span> <span class="o">=</span> <span class="kc">False</span>
-    <span class="k">if</span> <span class="n">total_found</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;Error: the template could not be found.&#39;</span><span class="p">)</span>
-        <span class="n">seems_fishy</span> <span class="o">=</span> <span class="kc">True</span>
-    <span class="k">elif</span> <span class="n">total_found</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;Warning: multiple loaders returned a match for the template.&#39;</span><span class="p">)</span>
-        <span class="n">seems_fishy</span> <span class="o">=</span> <span class="kc">True</span>
-
-    <span class="k">if</span> <span class="n">blueprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">seems_fishy</span><span class="p">:</span>
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;  The template was looked up from an endpoint that &#39;</span>
-                    <span class="s1">&#39;belongs to the blueprint &quot;</span><span class="si">%s</span><span class="s1">&quot;.&#39;</span> <span class="o">%</span> <span class="n">blueprint</span><span class="p">)</span>
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;  Maybe you did not place a template in the right folder?&#39;</span><span class="p">)</span>
-        <span class="n">info</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;  See http://flask.pocoo.org/docs/blueprints/#templates&#39;</span><span class="p">)</span>
-
-    <span class="n">app</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">info</span><span class="p">))</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/exthook.html

@@ -1,231 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.exthook &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.exthook</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.exthook</span>
-<span class="sd">    ~~~~~~~~~~~~~</span>
-
-<span class="sd">    Redirect imports for extensions.  This module basically makes it possible</span>
-<span class="sd">    for us to transition from flaskext.foo to flask_foo without having to</span>
-<span class="sd">    force all extensions to upgrade at the same time.</span>
-
-<span class="sd">    When a user does ``from flask.ext.foo import bar`` it will attempt to</span>
-<span class="sd">    import ``from flask_foo import bar`` first and when that fails it will</span>
-<span class="sd">    try to import ``from flaskext.foo import bar``.</span>
-
-<span class="sd">    We&#39;re switching from namespace packages because it was just too painful for</span>
-<span class="sd">    everybody involved.</span>
-
-<span class="sd">    This is used by `flask.ext`.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">sys</span>
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">import</span> <span class="nn">warnings</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">reraise</span>
-
-
-<div class="viewcode-block" id="ExtDeprecationWarning"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtDeprecationWarning">[docs]</a><span class="k">class</span> <span class="nc">ExtDeprecationWarning</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">):</span>
-    <span class="k">pass</span></div>
-
-<span class="n">warnings</span><span class="o">.</span><span class="n">simplefilter</span><span class="p">(</span><span class="s1">&#39;always&#39;</span><span class="p">,</span> <span class="n">ExtDeprecationWarning</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="ExtensionImporter"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtensionImporter">[docs]</a><span class="k">class</span> <span class="nc">ExtensionImporter</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;This importer redirects imports from this submodule to other locations.</span>
-<span class="sd">    This makes it possible to transition from the old flaskext.name to the</span>
-<span class="sd">    newer flask_name without people having a hard time.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">module_choices</span><span class="p">,</span> <span class="n">wrapper_module</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">module_choices</span> <span class="o">=</span> <span class="n">module_choices</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">wrapper_module</span> <span class="o">=</span> <span class="n">wrapper_module</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">prefix</span> <span class="o">=</span> <span class="n">wrapper_module</span> <span class="o">+</span> <span class="s1">&#39;.&#39;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">prefix_cutoff</span> <span class="o">=</span> <span class="n">wrapper_module</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span>
-
-    <span class="k">def</span> <span class="nf">__eq__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__module__</span> <span class="o">==</span> <span class="n">other</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__module__</span> <span class="ow">and</span> \
-               <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="n">other</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span> <span class="ow">and</span> \
-               <span class="bp">self</span><span class="o">.</span><span class="n">wrapper_module</span> <span class="o">==</span> <span class="n">other</span><span class="o">.</span><span class="n">wrapper_module</span> <span class="ow">and</span> \
-               <span class="bp">self</span><span class="o">.</span><span class="n">module_choices</span> <span class="o">==</span> <span class="n">other</span><span class="o">.</span><span class="n">module_choices</span>
-
-    <span class="k">def</span> <span class="nf">__ne__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">__eq__</span><span class="p">(</span><span class="n">other</span><span class="p">)</span>
-
-<div class="viewcode-block" id="ExtensionImporter.install"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtensionImporter.install">[docs]</a>    <span class="k">def</span> <span class="nf">install</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">sys</span><span class="o">.</span><span class="n">meta_path</span><span class="p">[:]</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">sys</span><span class="o">.</span><span class="n">meta_path</span> <span class="k">if</span> <span class="bp">self</span> <span class="o">!=</span> <span class="n">x</span><span class="p">]</span> <span class="o">+</span> <span class="p">[</span><span class="bp">self</span><span class="p">]</span></div>
-
-<div class="viewcode-block" id="ExtensionImporter.find_module"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtensionImporter.find_module">[docs]</a>    <span class="k">def</span> <span class="nf">find_module</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fullname</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">fullname</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">prefix</span><span class="p">)</span> <span class="ow">and</span> \
-           <span class="n">fullname</span> <span class="o">!=</span> <span class="s1">&#39;flask.ext.ExtDeprecationWarning&#39;</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span></div>
-
-<div class="viewcode-block" id="ExtensionImporter.load_module"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtensionImporter.load_module">[docs]</a>    <span class="k">def</span> <span class="nf">load_module</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fullname</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">fullname</span> <span class="ow">in</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="n">fullname</span><span class="p">]</span>
-
-        <span class="n">modname</span> <span class="o">=</span> <span class="n">fullname</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">prefix_cutoff</span><span class="p">)[</span><span class="bp">self</span><span class="o">.</span><span class="n">prefix_cutoff</span><span class="p">]</span>
-
-        <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span>
-            <span class="s2">&quot;Importing flask.ext.</span><span class="si">{x}</span><span class="s2"> is deprecated, use flask_</span><span class="si">{x}</span><span class="s2"> instead.&quot;</span>
-            <span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">modname</span><span class="p">),</span> <span class="n">ExtDeprecationWarning</span>
-        <span class="p">)</span>
-
-        <span class="k">for</span> <span class="n">path</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">module_choices</span><span class="p">:</span>
-            <span class="n">realname</span> <span class="o">=</span> <span class="n">path</span> <span class="o">%</span> <span class="n">modname</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="nb">__import__</span><span class="p">(</span><span class="n">realname</span><span class="p">)</span>
-            <span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-                <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-                <span class="c1"># since we only establish the entry in sys.modules at the</span>
-                <span class="c1"># very this seems to be redundant, but if recursive imports</span>
-                <span class="c1"># happen we will call into the move import a second time.</span>
-                <span class="c1"># On the second invocation we still don&#39;t have an entry for</span>
-                <span class="c1"># fullname in sys.modules, but we will end up with the same</span>
-                <span class="c1"># fake module name and that import will succeed since this</span>
-                <span class="c1"># one already has a temporary entry in the modules dict.</span>
-                <span class="c1"># Since this one &quot;succeeded&quot; temporarily that second</span>
-                <span class="c1"># invocation now will have created a fullname entry in</span>
-                <span class="c1"># sys.modules which we have to kill.</span>
-                <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">fullname</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-                <span class="c1"># If it&#39;s an important traceback we reraise it, otherwise</span>
-                <span class="c1"># we swallow it and try the next choice.  The skipped frame</span>
-                <span class="c1"># is the one from __import__ above which we don&#39;t care about</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_important_traceback</span><span class="p">(</span><span class="n">realname</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-                    <span class="n">reraise</span><span class="p">(</span><span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="o">.</span><span class="n">tb_next</span><span class="p">)</span>
-                <span class="k">continue</span>
-            <span class="n">module</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="n">fullname</span><span class="p">]</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="n">realname</span><span class="p">]</span>
-            <span class="k">if</span> <span class="s1">&#39;.&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">modname</span><span class="p">:</span>
-                <span class="nb">setattr</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">wrapper_module</span><span class="p">],</span> <span class="n">modname</span><span class="p">,</span> <span class="n">module</span><span class="p">)</span>
-
-            <span class="k">if</span> <span class="n">realname</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;flaskext.&#39;</span><span class="p">):</span>
-                <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span>
-                    <span class="s2">&quot;Detected extension named flaskext.</span><span class="si">{x}</span><span class="s2">, please rename it &quot;</span>
-                    <span class="s2">&quot;to flask_</span><span class="si">{x}</span><span class="s2">. The old form is deprecated.&quot;</span>
-                    <span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">modname</span><span class="p">),</span> <span class="n">ExtDeprecationWarning</span>
-                <span class="p">)</span>
-
-            <span class="k">return</span> <span class="n">module</span>
-        <span class="k">raise</span> <span class="ne">ImportError</span><span class="p">(</span><span class="s1">&#39;No module named </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">fullname</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="ExtensionImporter.is_important_traceback"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtensionImporter.is_important_traceback">[docs]</a>    <span class="k">def</span> <span class="nf">is_important_traceback</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">important_module</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Walks a traceback&#39;s frames and checks if any of the frames</span>
-<span class="sd">        originated in the given important module.  If that is the case then we</span>
-<span class="sd">        were able to import the module itself but apparently something went</span>
-<span class="sd">        wrong when the module was imported.  (Eg: import of an import failed).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">while</span> <span class="n">tb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_important_frame</span><span class="p">(</span><span class="n">important_module</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-                <span class="k">return</span> <span class="kc">True</span>
-            <span class="n">tb</span> <span class="o">=</span> <span class="n">tb</span><span class="o">.</span><span class="n">tb_next</span>
-        <span class="k">return</span> <span class="kc">False</span></div>
-
-<div class="viewcode-block" id="ExtensionImporter.is_important_frame"><a class="viewcode-back" href="../../flask/flask.html#flask.exthook.ExtensionImporter.is_important_frame">[docs]</a>    <span class="k">def</span> <span class="nf">is_important_frame</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">important_module</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Checks a single frame if it&#39;s important.&quot;&quot;&quot;</span>
-        <span class="n">g</span> <span class="o">=</span> <span class="n">tb</span><span class="o">.</span><span class="n">tb_frame</span><span class="o">.</span><span class="n">f_globals</span>
-        <span class="k">if</span> <span class="s1">&#39;__name__&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">g</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-
-        <span class="n">module_name</span> <span class="o">=</span> <span class="n">g</span><span class="p">[</span><span class="s1">&#39;__name__&#39;</span><span class="p">]</span>
-
-        <span class="c1"># Python 2.7 Behavior.  Modules are cleaned up late so the</span>
-        <span class="c1"># name shows up properly here.  Success!</span>
-        <span class="k">if</span> <span class="n">module_name</span> <span class="o">==</span> <span class="n">important_module</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-
-        <span class="c1"># Some python versions will clean up modules so early that the</span>
-        <span class="c1"># module name at that point is no longer set.  Try guessing from</span>
-        <span class="c1"># the filename then.</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">tb</span><span class="o">.</span><span class="n">tb_frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_filename</span><span class="p">)</span>
-        <span class="n">test_string</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">sep</span> <span class="o">+</span> <span class="n">important_module</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">sep</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">test_string</span> <span class="o">+</span> <span class="s1">&#39;.py&#39;</span> <span class="ow">in</span> <span class="n">filename</span> <span class="ow">or</span> \
-               <span class="n">test_string</span> <span class="o">+</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">sep</span> <span class="o">+</span> <span class="s1">&#39;__init__.py&#39;</span> <span class="ow">in</span> <span class="n">filename</span></div></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/helpers.html

@@ -1,1018 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.helpers &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.helpers</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.helpers</span>
-<span class="sd">    ~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements various helpers.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">import</span> <span class="nn">os</span>
-<span class="kn">import</span> <span class="nn">sys</span>
-<span class="kn">import</span> <span class="nn">pkgutil</span>
-<span class="kn">import</span> <span class="nn">posixpath</span>
-<span class="kn">import</span> <span class="nn">mimetypes</span>
-<span class="kn">from</span> <span class="nn">time</span> <span class="k">import</span> <span class="n">time</span>
-<span class="kn">from</span> <span class="nn">zlib</span> <span class="k">import</span> <span class="n">adler32</span>
-<span class="kn">from</span> <span class="nn">threading</span> <span class="k">import</span> <span class="n">RLock</span>
-<span class="kn">from</span> <span class="nn">werkzeug.routing</span> <span class="k">import</span> <span class="n">BuildError</span>
-<span class="kn">from</span> <span class="nn">functools</span> <span class="k">import</span> <span class="n">update_wrapper</span>
-
-<span class="k">try</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">werkzeug.urls</span> <span class="k">import</span> <span class="n">url_quote</span>
-<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">urlparse</span> <span class="k">import</span> <span class="n">quote</span> <span class="k">as</span> <span class="n">url_quote</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.datastructures</span> <span class="k">import</span> <span class="n">Headers</span>
-<span class="kn">from</span> <span class="nn">werkzeug.exceptions</span> <span class="k">import</span> <span class="n">BadRequest</span><span class="p">,</span> <span class="n">NotFound</span>
-
-<span class="c1"># this was moved in 0.7</span>
-<span class="k">try</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">werkzeug.wsgi</span> <span class="k">import</span> <span class="n">wrap_file</span>
-<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">werkzeug.utils</span> <span class="k">import</span> <span class="n">wrap_file</span>
-
-<span class="kn">from</span> <span class="nn">jinja2</span> <span class="k">import</span> <span class="n">FileSystemLoader</span>
-
-<span class="kn">from</span> <span class="nn">.signals</span> <span class="k">import</span> <span class="n">message_flashed</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">session</span><span class="p">,</span> <span class="n">_request_ctx_stack</span><span class="p">,</span> <span class="n">_app_ctx_stack</span><span class="p">,</span> \
-     <span class="n">current_app</span><span class="p">,</span> <span class="n">request</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">string_types</span><span class="p">,</span> <span class="n">text_type</span>
-
-
-<span class="c1"># sentinel</span>
-<span class="n">_missing</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span>
-
-
-<span class="c1"># what separators does this operating system provide that are not a slash?</span>
-<span class="c1"># this is used by the send_from_directory function to ensure that nobody is</span>
-<span class="c1"># able to access files from outside the filesystem.</span>
-<span class="n">_os_alt_seps</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">sep</span> <span class="k">for</span> <span class="n">sep</span> <span class="ow">in</span> <span class="p">[</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">sep</span><span class="p">,</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">altsep</span><span class="p">]</span>
-                    <span class="k">if</span> <span class="n">sep</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="s1">&#39;/&#39;</span><span class="p">))</span>
-
-
-<div class="viewcode-block" id="get_debug_flag"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.get_debug_flag">[docs]</a><span class="k">def</span> <span class="nf">get_debug_flag</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-    <span class="n">val</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;FLASK_DEBUG&#39;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">val</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">default</span>
-    <span class="k">return</span> <span class="n">val</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;0&#39;</span><span class="p">,</span> <span class="s1">&#39;false&#39;</span><span class="p">,</span> <span class="s1">&#39;no&#39;</span><span class="p">)</span></div>
-
-
-<span class="k">def</span> <span class="nf">_endpoint_from_view_func</span><span class="p">(</span><span class="n">view_func</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Internal helper that returns the default endpoint for a given</span>
-<span class="sd">    function.  This always is the function name.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">assert</span> <span class="n">view_func</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">,</span> <span class="s1">&#39;expected view func if endpoint &#39;</span> \
-                                  <span class="s1">&#39;is not provided.&#39;</span>
-    <span class="k">return</span> <span class="n">view_func</span><span class="o">.</span><span class="n">__name__</span>
-
-
-<div class="viewcode-block" id="stream_with_context"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.stream_with_context">[docs]</a><span class="k">def</span> <span class="nf">stream_with_context</span><span class="p">(</span><span class="n">generator_or_function</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Request contexts disappear when the response is started on the server.</span>
-<span class="sd">    This is done for efficiency reasons and to make it less likely to encounter</span>
-<span class="sd">    memory leaks with badly written WSGI middlewares.  The downside is that if</span>
-<span class="sd">    you are using streamed responses, the generator cannot access request bound</span>
-<span class="sd">    information any more.</span>
-
-<span class="sd">    This function however can help you keep the context around for longer::</span>
-
-<span class="sd">        from flask import stream_with_context, request, Response</span>
-
-<span class="sd">        @app.route(&#39;/stream&#39;)</span>
-<span class="sd">        def streamed_response():</span>
-<span class="sd">            @stream_with_context</span>
-<span class="sd">            def generate():</span>
-<span class="sd">                yield &#39;Hello &#39;</span>
-<span class="sd">                yield request.args[&#39;name&#39;]</span>
-<span class="sd">                yield &#39;!&#39;</span>
-<span class="sd">            return Response(generate())</span>
-
-<span class="sd">    Alternatively it can also be used around a specific generator::</span>
-
-<span class="sd">        from flask import stream_with_context, request, Response</span>
-
-<span class="sd">        @app.route(&#39;/stream&#39;)</span>
-<span class="sd">        def streamed_response():</span>
-<span class="sd">            def generate():</span>
-<span class="sd">                yield &#39;Hello &#39;</span>
-<span class="sd">                yield request.args[&#39;name&#39;]</span>
-<span class="sd">                yield &#39;!&#39;</span>
-<span class="sd">            return Response(stream_with_context(generate()))</span>
-
-<span class="sd">    .. versionadded:: 0.9</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">try</span><span class="p">:</span>
-        <span class="n">gen</span> <span class="o">=</span> <span class="nb">iter</span><span class="p">(</span><span class="n">generator_or_function</span><span class="p">)</span>
-    <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span>
-        <span class="k">def</span> <span class="nf">decorator</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-            <span class="n">gen</span> <span class="o">=</span> <span class="n">generator_or_function</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">stream_with_context</span><span class="p">(</span><span class="n">gen</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">update_wrapper</span><span class="p">(</span><span class="n">decorator</span><span class="p">,</span> <span class="n">generator_or_function</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">generator</span><span class="p">():</span>
-        <span class="n">ctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">ctx</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Attempted to stream with context but &#39;</span>
-                <span class="s1">&#39;there was no context in the first place to keep around.&#39;</span><span class="p">)</span>
-        <span class="k">with</span> <span class="n">ctx</span><span class="p">:</span>
-            <span class="c1"># Dummy sentinel.  Has to be inside the context block or we&#39;re</span>
-            <span class="c1"># not actually keeping the context around.</span>
-            <span class="k">yield</span> <span class="kc">None</span>
-
-            <span class="c1"># The try/finally is here so that if someone passes a WSGI level</span>
-            <span class="c1"># iterator in we&#39;re still running the cleanup logic.  Generators</span>
-            <span class="c1"># don&#39;t need that because they are closed on their destruction</span>
-            <span class="c1"># automatically.</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">gen</span><span class="p">:</span>
-                    <span class="k">yield</span> <span class="n">item</span>
-            <span class="k">finally</span><span class="p">:</span>
-                <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">gen</span><span class="p">,</span> <span class="s1">&#39;close&#39;</span><span class="p">):</span>
-                    <span class="n">gen</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-
-    <span class="c1"># The trick is to start the generator.  Then the code execution runs until</span>
-    <span class="c1"># the first dummy None is yielded at which point the context was already</span>
-    <span class="c1"># pushed.  This item is discarded.  Then when the iteration continues the</span>
-    <span class="c1"># real generator is executed.</span>
-    <span class="n">wrapped_g</span> <span class="o">=</span> <span class="n">generator</span><span class="p">()</span>
-    <span class="nb">next</span><span class="p">(</span><span class="n">wrapped_g</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">wrapped_g</span></div>
-
-
-<div class="viewcode-block" id="make_response"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.make_response">[docs]</a><span class="k">def</span> <span class="nf">make_response</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Sometimes it is necessary to set additional headers in a view.  Because</span>
-<span class="sd">    views do not have to return response objects but can return a value that</span>
-<span class="sd">    is converted into a response object by Flask itself, it becomes tricky to</span>
-<span class="sd">    add headers to it.  This function can be called instead of using a return</span>
-<span class="sd">    and you will get a response object which you can use to attach headers.</span>
-
-<span class="sd">    If view looked like this and you want to add a new header::</span>
-
-<span class="sd">        def index():</span>
-<span class="sd">            return render_template(&#39;index.html&#39;, foo=42)</span>
-
-<span class="sd">    You can now do something like this::</span>
-
-<span class="sd">        def index():</span>
-<span class="sd">            response = make_response(render_template(&#39;index.html&#39;, foo=42))</span>
-<span class="sd">            response.headers[&#39;X-Parachutes&#39;] = &#39;parachutes are cool&#39;</span>
-<span class="sd">            return response</span>
-
-<span class="sd">    This function accepts the very same arguments you can return from a</span>
-<span class="sd">    view function.  This for example creates a response with a 404 error</span>
-<span class="sd">    code::</span>
-
-<span class="sd">        response = make_response(render_template(&#39;not_found.html&#39;), 404)</span>
-
-<span class="sd">    The other use case of this function is to force the return value of a</span>
-<span class="sd">    view function into a response which is helpful with view</span>
-<span class="sd">    decorators::</span>
-
-<span class="sd">        response = make_response(view_function())</span>
-<span class="sd">        response.headers[&#39;X-Parachutes&#39;] = &#39;parachutes are cool&#39;</span>
-
-<span class="sd">    Internally this function does the following things:</span>
-
-<span class="sd">    -   if no arguments are passed, it creates a new response argument</span>
-<span class="sd">    -   if one argument is passed, :meth:`flask.Flask.make_response`</span>
-<span class="sd">        is invoked with it.</span>
-<span class="sd">    -   if more than one argument is passed, the arguments are passed</span>
-<span class="sd">        to the :meth:`flask.Flask.make_response` function as tuple.</span>
-
-<span class="sd">    .. versionadded:: 0.6</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">args</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">current_app</span><span class="o">.</span><span class="n">response_class</span><span class="p">()</span>
-    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">args</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-        <span class="n">args</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-    <span class="k">return</span> <span class="n">current_app</span><span class="o">.</span><span class="n">make_response</span><span class="p">(</span><span class="n">args</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="url_for"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.url_for">[docs]</a><span class="k">def</span> <span class="nf">url_for</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="o">**</span><span class="n">values</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Generates a URL to the given endpoint with the method provided.</span>
-
-<span class="sd">    Variable arguments that are unknown to the target endpoint are appended</span>
-<span class="sd">    to the generated URL as query arguments.  If the value of a query argument</span>
-<span class="sd">    is ``None``, the whole pair is skipped.  In case blueprints are active</span>
-<span class="sd">    you can shortcut references to the same blueprint by prefixing the</span>
-<span class="sd">    local endpoint with a dot (``.``).</span>
-
-<span class="sd">    This will reference the index function local to the current blueprint::</span>
-
-<span class="sd">        url_for(&#39;.index&#39;)</span>
-
-<span class="sd">    For more information, head over to the :ref:`Quickstart &lt;url-building&gt;`.</span>
-
-<span class="sd">    To integrate applications, :class:`Flask` has a hook to intercept URL build</span>
-<span class="sd">    errors through :attr:`Flask.url_build_error_handlers`.  The `url_for`</span>
-<span class="sd">    function results in a :exc:`~werkzeug.routing.BuildError` when the current</span>
-<span class="sd">    app does not have a URL for the given endpoint and values.  When it does, the</span>
-<span class="sd">    :data:`~flask.current_app` calls its :attr:`~Flask.url_build_error_handlers` if</span>
-<span class="sd">    it is not ``None``, which can return a string to use as the result of</span>
-<span class="sd">    `url_for` (instead of `url_for`&#39;s default to raise the</span>
-<span class="sd">    :exc:`~werkzeug.routing.BuildError` exception) or re-raise the exception.</span>
-<span class="sd">    An example::</span>
-
-<span class="sd">        def external_url_handler(error, endpoint, values):</span>
-<span class="sd">            &quot;Looks up an external URL when `url_for` cannot build a URL.&quot;</span>
-<span class="sd">            # This is an example of hooking the build_error_handler.</span>
-<span class="sd">            # Here, lookup_url is some utility function you&#39;ve built</span>
-<span class="sd">            # which looks up the endpoint in some external URL registry.</span>
-<span class="sd">            url = lookup_url(endpoint, **values)</span>
-<span class="sd">            if url is None:</span>
-<span class="sd">                # External lookup did not have a URL.</span>
-<span class="sd">                # Re-raise the BuildError, in context of original traceback.</span>
-<span class="sd">                exc_type, exc_value, tb = sys.exc_info()</span>
-<span class="sd">                if exc_value is error:</span>
-<span class="sd">                    raise exc_type, exc_value, tb</span>
-<span class="sd">                else:</span>
-<span class="sd">                    raise error</span>
-<span class="sd">            # url_for will use this result, instead of raising BuildError.</span>
-<span class="sd">            return url</span>
-
-<span class="sd">        app.url_build_error_handlers.append(external_url_handler)</span>
-
-<span class="sd">    Here, `error` is the instance of :exc:`~werkzeug.routing.BuildError`, and</span>
-<span class="sd">    `endpoint` and `values` are the arguments passed into `url_for`.  Note</span>
-<span class="sd">    that this is for building URLs outside the current application, and not for</span>
-<span class="sd">    handling 404 NotFound errors.</span>
-
-<span class="sd">    .. versionadded:: 0.10</span>
-<span class="sd">       The `_scheme` parameter was added.</span>
-
-<span class="sd">    .. versionadded:: 0.9</span>
-<span class="sd">       The `_anchor` and `_method` parameters were added.</span>
-
-<span class="sd">    .. versionadded:: 0.9</span>
-<span class="sd">       Calls :meth:`Flask.handle_build_error` on</span>
-<span class="sd">       :exc:`~werkzeug.routing.BuildError`.</span>
-
-<span class="sd">    :param endpoint: the endpoint of the URL (name of the function)</span>
-<span class="sd">    :param values: the variable arguments of the URL rule</span>
-<span class="sd">    :param _external: if set to ``True``, an absolute URL is generated. Server</span>
-<span class="sd">      address can be changed via ``SERVER_NAME`` configuration variable which</span>
-<span class="sd">      defaults to `localhost`.</span>
-<span class="sd">    :param _scheme: a string specifying the desired URL scheme. The `_external`</span>
-<span class="sd">      parameter must be set to ``True`` or a :exc:`ValueError` is raised. The default</span>
-<span class="sd">      behavior uses the same scheme as the current request, or</span>
-<span class="sd">      ``PREFERRED_URL_SCHEME`` from the :ref:`app configuration &lt;config&gt;` if no</span>
-<span class="sd">      request context is available. As of Werkzeug 0.10, this also can be set</span>
-<span class="sd">      to an empty string to build protocol-relative URLs.</span>
-<span class="sd">    :param _anchor: if provided this is added as anchor to the URL.</span>
-<span class="sd">    :param _method: if provided this explicitly specifies an HTTP method.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">appctx</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="n">reqctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="k">if</span> <span class="n">appctx</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Attempted to generate a URL without the &#39;</span>
-                           <span class="s1">&#39;application context being pushed. This has to be &#39;</span>
-                           <span class="s1">&#39;executed when application context is available.&#39;</span><span class="p">)</span>
-
-    <span class="c1"># If request specific information is available we have some extra</span>
-    <span class="c1"># features that support &quot;relative&quot; URLs.</span>
-    <span class="k">if</span> <span class="n">reqctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">url_adapter</span> <span class="o">=</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">url_adapter</span>
-        <span class="n">blueprint_name</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">blueprint</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">_is_old_module</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">endpoint</span><span class="p">[:</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;.&#39;</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">blueprint_name</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">endpoint</span> <span class="o">=</span> <span class="n">blueprint_name</span> <span class="o">+</span> <span class="n">endpoint</span>
-                <span class="k">else</span><span class="p">:</span>
-                    <span class="n">endpoint</span> <span class="o">=</span> <span class="n">endpoint</span><span class="p">[</span><span class="mi">1</span><span class="p">:]</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="c1"># TODO: get rid of this deprecated functionality in 1.0</span>
-            <span class="k">if</span> <span class="s1">&#39;.&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">endpoint</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">blueprint_name</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">endpoint</span> <span class="o">=</span> <span class="n">blueprint_name</span> <span class="o">+</span> <span class="s1">&#39;.&#39;</span> <span class="o">+</span> <span class="n">endpoint</span>
-            <span class="k">elif</span> <span class="n">endpoint</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">):</span>
-                <span class="n">endpoint</span> <span class="o">=</span> <span class="n">endpoint</span><span class="p">[</span><span class="mi">1</span><span class="p">:]</span>
-        <span class="n">external</span> <span class="o">=</span> <span class="n">values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;_external&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
-
-    <span class="c1"># Otherwise go with the url adapter from the appctx and make</span>
-    <span class="c1"># the URLs external by default.</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">url_adapter</span> <span class="o">=</span> <span class="n">appctx</span><span class="o">.</span><span class="n">url_adapter</span>
-        <span class="k">if</span> <span class="n">url_adapter</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Application was not able to create a URL &#39;</span>
-                               <span class="s1">&#39;adapter for request independent URL generation. &#39;</span>
-                               <span class="s1">&#39;You might be able to fix this by setting &#39;</span>
-                               <span class="s1">&#39;the SERVER_NAME config variable.&#39;</span><span class="p">)</span>
-        <span class="n">external</span> <span class="o">=</span> <span class="n">values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;_external&#39;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-
-    <span class="n">anchor</span> <span class="o">=</span> <span class="n">values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;_anchor&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">method</span> <span class="o">=</span> <span class="n">values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;_method&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">scheme</span> <span class="o">=</span> <span class="n">values</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;_scheme&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">appctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">inject_url_defaults</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">)</span>
-
-    <span class="c1"># This is not the best way to deal with this but currently the</span>
-    <span class="c1"># underlying Werkzeug router does not support overriding the scheme on</span>
-    <span class="c1"># a per build call basis.</span>
-    <span class="n">old_scheme</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="k">if</span> <span class="n">scheme</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">external</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;When specifying _scheme, _external must be True&#39;</span><span class="p">)</span>
-        <span class="n">old_scheme</span> <span class="o">=</span> <span class="n">url_adapter</span><span class="o">.</span><span class="n">url_scheme</span>
-        <span class="n">url_adapter</span><span class="o">.</span><span class="n">url_scheme</span> <span class="o">=</span> <span class="n">scheme</span>
-
-    <span class="k">try</span><span class="p">:</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">url_adapter</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="n">method</span><span class="p">,</span>
-                                   <span class="n">force_external</span><span class="o">=</span><span class="n">external</span><span class="p">)</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">old_scheme</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">url_adapter</span><span class="o">.</span><span class="n">url_scheme</span> <span class="o">=</span> <span class="n">old_scheme</span>
-    <span class="k">except</span> <span class="n">BuildError</span> <span class="k">as</span> <span class="n">error</span><span class="p">:</span>
-        <span class="c1"># We need to inject the values again so that the app callback can</span>
-        <span class="c1"># deal with that sort of stuff.</span>
-        <span class="n">values</span><span class="p">[</span><span class="s1">&#39;_external&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">external</span>
-        <span class="n">values</span><span class="p">[</span><span class="s1">&#39;_anchor&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">anchor</span>
-        <span class="n">values</span><span class="p">[</span><span class="s1">&#39;_method&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">method</span>
-        <span class="k">return</span> <span class="n">appctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">handle_url_build_error</span><span class="p">(</span><span class="n">error</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">anchor</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">rv</span> <span class="o">+=</span> <span class="s1">&#39;#&#39;</span> <span class="o">+</span> <span class="n">url_quote</span><span class="p">(</span><span class="n">anchor</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">rv</span></div>
-
-
-<div class="viewcode-block" id="get_template_attribute"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.get_template_attribute">[docs]</a><span class="k">def</span> <span class="nf">get_template_attribute</span><span class="p">(</span><span class="n">template_name</span><span class="p">,</span> <span class="n">attribute</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Loads a macro (or variable) a template exports.  This can be used to</span>
-<span class="sd">    invoke a macro from within Python code.  If you for example have a</span>
-<span class="sd">    template named :file:`_cider.html` with the following contents:</span>
-
-<span class="sd">    .. sourcecode:: html+jinja</span>
-
-<span class="sd">       {% macro hello(name) %}Hello {{ name }}!{% endmacro %}</span>
-
-<span class="sd">    You can access this from Python code like this::</span>
-
-<span class="sd">        hello = get_template_attribute(&#39;_cider.html&#39;, &#39;hello&#39;)</span>
-<span class="sd">        return hello(&#39;World&#39;)</span>
-
-<span class="sd">    .. versionadded:: 0.2</span>
-
-<span class="sd">    :param template_name: the name of the template</span>
-<span class="sd">    :param attribute: the name of the variable of macro to access</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">current_app</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">get_template</span><span class="p">(</span><span class="n">template_name</span><span class="p">)</span><span class="o">.</span><span class="n">module</span><span class="p">,</span>
-                   <span class="n">attribute</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="flash"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.flash">[docs]</a><span class="k">def</span> <span class="nf">flash</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="n">category</span><span class="o">=</span><span class="s1">&#39;message&#39;</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Flashes a message to the next request.  In order to remove the</span>
-<span class="sd">    flashed message from the session and to display it to the user,</span>
-<span class="sd">    the template has to call :func:`get_flashed_messages`.</span>
-
-<span class="sd">    .. versionchanged:: 0.3</span>
-<span class="sd">       `category` parameter added.</span>
-
-<span class="sd">    :param message: the message to be flashed.</span>
-<span class="sd">    :param category: the category for the message.  The following values</span>
-<span class="sd">                     are recommended: ``&#39;message&#39;`` for any kind of message,</span>
-<span class="sd">                     ``&#39;error&#39;`` for errors, ``&#39;info&#39;`` for information</span>
-<span class="sd">                     messages and ``&#39;warning&#39;`` for warnings.  However any</span>
-<span class="sd">                     kind of string can be used as category.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="c1"># Original implementation:</span>
-    <span class="c1">#</span>
-    <span class="c1">#     session.setdefault(&#39;_flashes&#39;, []).append((category, message))</span>
-    <span class="c1">#</span>
-    <span class="c1"># This assumed that changes made to mutable structures in the session are</span>
-    <span class="c1"># are always in sync with the session object, which is not true for session</span>
-    <span class="c1"># implementations that use external storage for keeping their keys/values.</span>
-    <span class="n">flashes</span> <span class="o">=</span> <span class="n">session</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;_flashes&#39;</span><span class="p">,</span> <span class="p">[])</span>
-    <span class="n">flashes</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">category</span><span class="p">,</span> <span class="n">message</span><span class="p">))</span>
-    <span class="n">session</span><span class="p">[</span><span class="s1">&#39;_flashes&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">flashes</span>
-    <span class="n">message_flashed</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="n">current_app</span><span class="o">.</span><span class="n">_get_current_object</span><span class="p">(),</span>
-                         <span class="n">message</span><span class="o">=</span><span class="n">message</span><span class="p">,</span> <span class="n">category</span><span class="o">=</span><span class="n">category</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="get_flashed_messages"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.get_flashed_messages">[docs]</a><span class="k">def</span> <span class="nf">get_flashed_messages</span><span class="p">(</span><span class="n">with_categories</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">category_filter</span><span class="o">=</span><span class="p">[]):</span>
-    <span class="sd">&quot;&quot;&quot;Pulls all flashed messages from the session and returns them.</span>
-<span class="sd">    Further calls in the same request to the function will return</span>
-<span class="sd">    the same messages.  By default just the messages are returned,</span>
-<span class="sd">    but when `with_categories` is set to ``True``, the return value will</span>
-<span class="sd">    be a list of tuples in the form ``(category, message)`` instead.</span>
-
-<span class="sd">    Filter the flashed messages to one or more categories by providing those</span>
-<span class="sd">    categories in `category_filter`.  This allows rendering categories in</span>
-<span class="sd">    separate html blocks.  The `with_categories` and `category_filter`</span>
-<span class="sd">    arguments are distinct:</span>
-
-<span class="sd">    * `with_categories` controls whether categories are returned with message</span>
-<span class="sd">      text (``True`` gives a tuple, where ``False`` gives just the message text).</span>
-<span class="sd">    * `category_filter` filters the messages down to only those matching the</span>
-<span class="sd">      provided categories.</span>
-
-<span class="sd">    See :ref:`message-flashing-pattern` for examples.</span>
-
-<span class="sd">    .. versionchanged:: 0.3</span>
-<span class="sd">       `with_categories` parameter added.</span>
-
-<span class="sd">    .. versionchanged:: 0.9</span>
-<span class="sd">        `category_filter` parameter added.</span>
-
-<span class="sd">    :param with_categories: set to ``True`` to also receive categories.</span>
-<span class="sd">    :param category_filter: whitelist of categories to limit return values</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">flashes</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">flashes</span>
-    <span class="k">if</span> <span class="n">flashes</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span><span class="o">.</span><span class="n">flashes</span> <span class="o">=</span> <span class="n">flashes</span> <span class="o">=</span> <span class="n">session</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;_flashes&#39;</span><span class="p">)</span> \
-            <span class="k">if</span> <span class="s1">&#39;_flashes&#39;</span> <span class="ow">in</span> <span class="n">session</span> <span class="k">else</span> <span class="p">[]</span>
-    <span class="k">if</span> <span class="n">category_filter</span><span class="p">:</span>
-        <span class="n">flashes</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">filter</span><span class="p">(</span><span class="k">lambda</span> <span class="n">f</span><span class="p">:</span> <span class="n">f</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">in</span> <span class="n">category_filter</span><span class="p">,</span> <span class="n">flashes</span><span class="p">))</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">with_categories</span><span class="p">:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="n">x</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">flashes</span><span class="p">]</span>
-    <span class="k">return</span> <span class="n">flashes</span></div>
-
-
-<div class="viewcode-block" id="send_file"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.send_file">[docs]</a><span class="k">def</span> <span class="nf">send_file</span><span class="p">(</span><span class="n">filename_or_fp</span><span class="p">,</span> <span class="n">mimetype</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">as_attachment</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-              <span class="n">attachment_filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">add_etags</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
-              <span class="n">cache_timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">conditional</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Sends the contents of a file to the client.  This will use the</span>
-<span class="sd">    most efficient method available and configured.  By default it will</span>
-<span class="sd">    try to use the WSGI server&#39;s file_wrapper support.  Alternatively</span>
-<span class="sd">    you can set the application&#39;s :attr:`~Flask.use_x_sendfile` attribute</span>
-<span class="sd">    to ``True`` to directly emit an ``X-Sendfile`` header.  This however</span>
-<span class="sd">    requires support of the underlying webserver for ``X-Sendfile``.</span>
-
-<span class="sd">    By default it will try to guess the mimetype for you, but you can</span>
-<span class="sd">    also explicitly provide one.  For extra security you probably want</span>
-<span class="sd">    to send certain files as attachment (HTML for instance).  The mimetype</span>
-<span class="sd">    guessing requires a `filename` or an `attachment_filename` to be</span>
-<span class="sd">    provided.</span>
-
-<span class="sd">    Please never pass filenames to this function from user sources;</span>
-<span class="sd">    you should use :func:`send_from_directory` instead.</span>
-
-<span class="sd">    .. versionadded:: 0.2</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">       The `add_etags`, `cache_timeout` and `conditional` parameters were</span>
-<span class="sd">       added.  The default behavior is now to attach etags.</span>
-
-<span class="sd">    .. versionchanged:: 0.7</span>
-<span class="sd">       mimetype guessing and etag support for file objects was</span>
-<span class="sd">       deprecated because it was unreliable.  Pass a filename if you are</span>
-<span class="sd">       able to, otherwise attach an etag yourself.  This functionality</span>
-<span class="sd">       will be removed in Flask 1.0</span>
-
-<span class="sd">    .. versionchanged:: 0.9</span>
-<span class="sd">       cache_timeout pulls its default from application config, when None.</span>
-
-<span class="sd">    :param filename_or_fp: the filename of the file to send in `latin-1`.</span>
-<span class="sd">                           This is relative to the :attr:`~Flask.root_path`</span>
-<span class="sd">                           if a relative path is specified.</span>
-<span class="sd">                           Alternatively a file object might be provided in</span>
-<span class="sd">                           which case ``X-Sendfile`` might not work and fall</span>
-<span class="sd">                           back to the traditional method.  Make sure that the</span>
-<span class="sd">                           file pointer is positioned at the start of data to</span>
-<span class="sd">                           send before calling :func:`send_file`.</span>
-<span class="sd">    :param mimetype: the mimetype of the file if provided, otherwise</span>
-<span class="sd">                     auto detection happens.</span>
-<span class="sd">    :param as_attachment: set to ``True`` if you want to send this file with</span>
-<span class="sd">                          a ``Content-Disposition: attachment`` header.</span>
-<span class="sd">    :param attachment_filename: the filename for the attachment if it</span>
-<span class="sd">                                differs from the file&#39;s filename.</span>
-<span class="sd">    :param add_etags: set to ``False`` to disable attaching of etags.</span>
-<span class="sd">    :param conditional: set to ``True`` to enable conditional responses.</span>
-
-<span class="sd">    :param cache_timeout: the timeout in seconds for the headers. When ``None``</span>
-<span class="sd">                          (default), this value is set by</span>
-<span class="sd">                          :meth:`~Flask.get_send_file_max_age` of</span>
-<span class="sd">                          :data:`~flask.current_app`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">mtime</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">filename_or_fp</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">filename_or_fp</span>
-        <span class="n">file</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-        <span class="n">file</span> <span class="o">=</span> <span class="n">filename_or_fp</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="s1">&#39;name&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-        <span class="c1"># XXX: this behavior is now deprecated because it was unreliable.</span>
-        <span class="c1"># removed in Flask 1.0</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">attachment_filename</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">mimetype</span> \
-           <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;The filename support for file objects &#39;</span>
-                <span class="s1">&#39;passed to send_file is now deprecated.  Pass an &#39;</span>
-                <span class="s1">&#39;attach_filename if you want mimetypes to be guessed.&#39;</span><span class="p">),</span>
-                <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">add_etags</span><span class="p">:</span>
-            <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;In future flask releases etags will no &#39;</span>
-                <span class="s1">&#39;longer be generated for file objects passed to the send_file &#39;</span>
-                <span class="s1">&#39;function because this behavior was unreliable.  Pass &#39;</span>
-                <span class="s1">&#39;filenames instead if possible, otherwise attach an etag &#39;</span>
-                <span class="s1">&#39;yourself based on another value&#39;</span><span class="p">),</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
-            <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">current_app</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">mimetype</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="p">(</span><span class="n">filename</span> <span class="ow">or</span> <span class="n">attachment_filename</span><span class="p">):</span>
-        <span class="n">mimetype</span> <span class="o">=</span> <span class="n">mimetypes</span><span class="o">.</span><span class="n">guess_type</span><span class="p">(</span><span class="n">filename</span> <span class="ow">or</span> <span class="n">attachment_filename</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-    <span class="k">if</span> <span class="n">mimetype</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">mimetype</span> <span class="o">=</span> <span class="s1">&#39;application/octet-stream&#39;</span>
-
-    <span class="n">headers</span> <span class="o">=</span> <span class="n">Headers</span><span class="p">()</span>
-    <span class="k">if</span> <span class="n">as_attachment</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">attachment_filename</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;filename unavailable, required for &#39;</span>
-                                <span class="s1">&#39;sending as attachment&#39;</span><span class="p">)</span>
-            <span class="n">attachment_filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">basename</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-        <span class="n">headers</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="s1">&#39;Content-Disposition&#39;</span><span class="p">,</span> <span class="s1">&#39;attachment&#39;</span><span class="p">,</span>
-                    <span class="n">filename</span><span class="o">=</span><span class="n">attachment_filename</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">current_app</span><span class="o">.</span><span class="n">use_x_sendfile</span> <span class="ow">and</span> <span class="n">filename</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">file</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">file</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-        <span class="n">headers</span><span class="p">[</span><span class="s1">&#39;X-Sendfile&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">filename</span>
-        <span class="n">headers</span><span class="p">[</span><span class="s1">&#39;Content-Length&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">getsize</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-        <span class="n">data</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">file</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="s1">&#39;rb&#39;</span><span class="p">)</span>
-            <span class="n">mtime</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">getmtime</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-            <span class="n">headers</span><span class="p">[</span><span class="s1">&#39;Content-Length&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">getsize</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-        <span class="n">data</span> <span class="o">=</span> <span class="n">wrap_file</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">,</span> <span class="n">file</span><span class="p">)</span>
-
-    <span class="n">rv</span> <span class="o">=</span> <span class="n">current_app</span><span class="o">.</span><span class="n">response_class</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">mimetype</span><span class="o">=</span><span class="n">mimetype</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
-                                    <span class="n">direct_passthrough</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-
-    <span class="c1"># if we know the file modification date, we can store it as</span>
-    <span class="c1"># the time of the last modification.</span>
-    <span class="k">if</span> <span class="n">mtime</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">rv</span><span class="o">.</span><span class="n">last_modified</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">mtime</span><span class="p">)</span>
-
-    <span class="n">rv</span><span class="o">.</span><span class="n">cache_control</span><span class="o">.</span><span class="n">public</span> <span class="o">=</span> <span class="kc">True</span>
-    <span class="k">if</span> <span class="n">cache_timeout</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">cache_timeout</span> <span class="o">=</span> <span class="n">current_app</span><span class="o">.</span><span class="n">get_send_file_max_age</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">cache_timeout</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">rv</span><span class="o">.</span><span class="n">cache_control</span><span class="o">.</span><span class="n">max_age</span> <span class="o">=</span> <span class="n">cache_timeout</span>
-        <span class="n">rv</span><span class="o">.</span><span class="n">expires</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">time</span><span class="p">()</span> <span class="o">+</span> <span class="n">cache_timeout</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">add_etags</span> <span class="ow">and</span> <span class="n">filename</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">set_etag</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">-</span><span class="si">%s</span><span class="s1">-</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-                <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">getmtime</span><span class="p">(</span><span class="n">filename</span><span class="p">),</span>
-                <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">getsize</span><span class="p">(</span><span class="n">filename</span><span class="p">),</span>
-                <span class="n">adler32</span><span class="p">(</span>
-                    <span class="n">filename</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;utf-8&#39;</span><span class="p">)</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="n">text_type</span><span class="p">)</span>
-                    <span class="k">else</span> <span class="n">filename</span>
-                <span class="p">)</span> <span class="o">&amp;</span> <span class="mh">0xffffffff</span>
-            <span class="p">))</span>
-        <span class="k">except</span> <span class="ne">OSError</span><span class="p">:</span>
-            <span class="n">warn</span><span class="p">(</span><span class="s1">&#39;Access </span><span class="si">%s</span><span class="s1"> failed, maybe it does not exist, so ignore etags in &#39;</span>
-                 <span class="s1">&#39;headers&#39;</span> <span class="o">%</span> <span class="n">filename</span><span class="p">,</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">conditional</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">rv</span><span class="o">.</span><span class="n">make_conditional</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
-            <span class="c1"># make sure we don&#39;t send x-sendfile for servers that</span>
-            <span class="c1"># ignore the 304 status code for x-sendfile.</span>
-            <span class="k">if</span> <span class="n">rv</span><span class="o">.</span><span class="n">status_code</span> <span class="o">==</span> <span class="mi">304</span><span class="p">:</span>
-                <span class="n">rv</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;x-sendfile&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">rv</span></div>
-
-
-<div class="viewcode-block" id="safe_join"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.safe_join">[docs]</a><span class="k">def</span> <span class="nf">safe_join</span><span class="p">(</span><span class="n">directory</span><span class="p">,</span> <span class="n">filename</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Safely join `directory` and `filename`.</span>
-
-<span class="sd">    Example usage::</span>
-
-<span class="sd">        @app.route(&#39;/wiki/&lt;path:filename&gt;&#39;)</span>
-<span class="sd">        def wiki_page(filename):</span>
-<span class="sd">            filename = safe_join(app.config[&#39;WIKI_FOLDER&#39;], filename)</span>
-<span class="sd">            with open(filename, &#39;rb&#39;) as fd:</span>
-<span class="sd">                content = fd.read()  # Read and process the file content...</span>
-
-<span class="sd">    :param directory: the base directory.</span>
-<span class="sd">    :param filename: the untrusted filename relative to that directory.</span>
-<span class="sd">    :raises: :class:`~werkzeug.exceptions.NotFound` if the resulting path</span>
-<span class="sd">             would fall out of `directory`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">filename</span> <span class="o">=</span> <span class="n">posixpath</span><span class="o">.</span><span class="n">normpath</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-    <span class="k">for</span> <span class="n">sep</span> <span class="ow">in</span> <span class="n">_os_alt_seps</span><span class="p">:</span>
-        <span class="k">if</span> <span class="n">sep</span> <span class="ow">in</span> <span class="n">filename</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">NotFound</span><span class="p">()</span>
-    <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span> <span class="ow">or</span> \
-       <span class="n">filename</span> <span class="o">==</span> <span class="s1">&#39;..&#39;</span> <span class="ow">or</span> \
-       <span class="n">filename</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;../&#39;</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="n">NotFound</span><span class="p">()</span>
-    <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">directory</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="send_from_directory"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.send_from_directory">[docs]</a><span class="k">def</span> <span class="nf">send_from_directory</span><span class="p">(</span><span class="n">directory</span><span class="p">,</span> <span class="n">filename</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Send a file from a given directory with :func:`send_file`.  This</span>
-<span class="sd">    is a secure way to quickly expose static files from an upload folder</span>
-<span class="sd">    or something similar.</span>
-
-<span class="sd">    Example usage::</span>
-
-<span class="sd">        @app.route(&#39;/uploads/&lt;path:filename&gt;&#39;)</span>
-<span class="sd">        def download_file(filename):</span>
-<span class="sd">            return send_from_directory(app.config[&#39;UPLOAD_FOLDER&#39;],</span>
-<span class="sd">                                       filename, as_attachment=True)</span>
-
-<span class="sd">    .. admonition:: Sending files and Performance</span>
-
-<span class="sd">       It is strongly recommended to activate either ``X-Sendfile`` support in</span>
-<span class="sd">       your webserver or (if no authentication happens) to tell the webserver</span>
-<span class="sd">       to serve files for the given path on its own without calling into the</span>
-<span class="sd">       web application for improved performance.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :param directory: the directory where all the files are stored.</span>
-<span class="sd">    :param filename: the filename relative to that directory to</span>
-<span class="sd">                     download.</span>
-<span class="sd">    :param options: optional keyword arguments that are directly</span>
-<span class="sd">                    forwarded to :func:`send_file`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">filename</span> <span class="o">=</span> <span class="n">safe_join</span><span class="p">(</span><span class="n">directory</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
-        <span class="n">filename</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">current_app</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span>
-    <span class="k">try</span><span class="p">:</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="n">NotFound</span><span class="p">()</span>
-    <span class="k">except</span> <span class="p">(</span><span class="ne">TypeError</span><span class="p">,</span> <span class="ne">ValueError</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="n">BadRequest</span><span class="p">()</span>
-    <span class="n">options</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;conditional&#39;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">send_file</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="get_root_path"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.get_root_path">[docs]</a><span class="k">def</span> <span class="nf">get_root_path</span><span class="p">(</span><span class="n">import_name</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Returns the path to a package or cwd if that cannot be found.  This</span>
-<span class="sd">    returns the path of a package or the folder that contains a module.</span>
-
-<span class="sd">    Not to be confused with the package path returned by :func:`find_package`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="c1"># Module already imported and has a file attribute.  Use that first.</span>
-    <span class="n">mod</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">import_name</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">mod</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">mod</span><span class="p">,</span> <span class="s1">&#39;__file__&#39;</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">mod</span><span class="o">.</span><span class="n">__file__</span><span class="p">))</span>
-
-    <span class="c1"># Next attempt: check the loader.</span>
-    <span class="n">loader</span> <span class="o">=</span> <span class="n">pkgutil</span><span class="o">.</span><span class="n">get_loader</span><span class="p">(</span><span class="n">import_name</span><span class="p">)</span>
-
-    <span class="c1"># Loader does not exist or we&#39;re referring to an unloaded main module</span>
-    <span class="c1"># or a main module without path (interactive sessions), go with the</span>
-    <span class="c1"># current working directory.</span>
-    <span class="k">if</span> <span class="n">loader</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">or</span> <span class="n">import_name</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">()</span>
-
-    <span class="c1"># For .egg, zipimporter does not have get_filename until Python 2.7.</span>
-    <span class="c1"># Some other loaders might exhibit the same behavior.</span>
-    <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">loader</span><span class="p">,</span> <span class="s1">&#39;get_filename&#39;</span><span class="p">):</span>
-        <span class="n">filepath</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">get_filename</span><span class="p">(</span><span class="n">import_name</span><span class="p">)</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="c1"># Fall back to imports.</span>
-        <span class="nb">__import__</span><span class="p">(</span><span class="n">import_name</span><span class="p">)</span>
-        <span class="n">mod</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="n">import_name</span><span class="p">]</span>
-        <span class="n">filepath</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">mod</span><span class="p">,</span> <span class="s1">&#39;__file__&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-        <span class="c1"># If we don&#39;t have a filepath it might be because we are a</span>
-        <span class="c1"># namespace package.  In this case we pick the root path from the</span>
-        <span class="c1"># first module that is contained in our package.</span>
-        <span class="k">if</span> <span class="n">filepath</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;No root path can be found for the provided &#39;</span>
-                               <span class="s1">&#39;module &quot;</span><span class="si">%s</span><span class="s1">&quot;.  This can happen because the &#39;</span>
-                               <span class="s1">&#39;module came from an import hook that does &#39;</span>
-                               <span class="s1">&#39;not provide file name information or because &#39;</span>
-                               <span class="s1">&#39;it</span><span class="se">\&#39;</span><span class="s1">s a namespace package.  In this case &#39;</span>
-                               <span class="s1">&#39;the root path needs to be explicitly &#39;</span>
-                               <span class="s1">&#39;provided.&#39;</span> <span class="o">%</span> <span class="n">import_name</span><span class="p">)</span>
-
-    <span class="c1"># filepath is import_name.py for a module, or __init__.py for a package.</span>
-    <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">filepath</span><span class="p">))</span></div>
-
-
-<span class="k">def</span> <span class="nf">_matching_loader_thinks_module_is_package</span><span class="p">(</span><span class="n">loader</span><span class="p">,</span> <span class="n">mod_name</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Given the loader that loaded a module and the module this function</span>
-<span class="sd">    attempts to figure out if the given module is actually a package.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="c1"># If the loader can tell us if something is a package, we can</span>
-    <span class="c1"># directly ask the loader.</span>
-    <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">loader</span><span class="p">,</span> <span class="s1">&#39;is_package&#39;</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">loader</span><span class="o">.</span><span class="n">is_package</span><span class="p">(</span><span class="n">mod_name</span><span class="p">)</span>
-    <span class="c1"># importlib&#39;s namespace loaders do not have this functionality but</span>
-    <span class="c1"># all the modules it loads are packages, so we can take advantage of</span>
-    <span class="c1"># this information.</span>
-    <span class="k">elif</span> <span class="p">(</span><span class="n">loader</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__module__</span> <span class="o">==</span> <span class="s1">&#39;_frozen_importlib&#39;</span> <span class="ow">and</span>
-          <span class="n">loader</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="s1">&#39;NamespaceLoader&#39;</span><span class="p">):</span>
-        <span class="k">return</span> <span class="kc">True</span>
-    <span class="c1"># Otherwise we need to fail with an error that explains what went</span>
-    <span class="c1"># wrong.</span>
-    <span class="k">raise</span> <span class="ne">AttributeError</span><span class="p">(</span>
-        <span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">.is_package() method is missing but is required by Flask of &#39;</span>
-         <span class="s1">&#39;PEP 302 import hooks.  If you do not use import hooks and &#39;</span>
-         <span class="s1">&#39;you encounter this error please file a bug against Flask.&#39;</span><span class="p">)</span> <span class="o">%</span>
-        <span class="n">loader</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="find_package"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.find_package">[docs]</a><span class="k">def</span> <span class="nf">find_package</span><span class="p">(</span><span class="n">import_name</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Finds a package and returns the prefix (or None if the package is</span>
-<span class="sd">    not installed) as well as the folder that contains the package or</span>
-<span class="sd">    module as a tuple.  The package path returned is the module that would</span>
-<span class="sd">    have to be added to the pythonpath in order to make it possible to</span>
-<span class="sd">    import the module.  The prefix is the path below which a UNIX like</span>
-<span class="sd">    folder structure exists (lib, share etc.).</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">root_mod_name</span> <span class="o">=</span> <span class="n">import_name</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-    <span class="n">loader</span> <span class="o">=</span> <span class="n">pkgutil</span><span class="o">.</span><span class="n">get_loader</span><span class="p">(</span><span class="n">root_mod_name</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">loader</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">or</span> <span class="n">import_name</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>
-        <span class="c1"># import name is not found, or interactive/main module</span>
-        <span class="n">package_path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">()</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="c1"># For .egg, zipimporter does not have get_filename until Python 2.7.</span>
-        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">loader</span><span class="p">,</span> <span class="s1">&#39;get_filename&#39;</span><span class="p">):</span>
-            <span class="n">filename</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">get_filename</span><span class="p">(</span><span class="n">root_mod_name</span><span class="p">)</span>
-        <span class="k">elif</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">loader</span><span class="p">,</span> <span class="s1">&#39;archive&#39;</span><span class="p">):</span>
-            <span class="c1"># zipimporter&#39;s loader.archive points to the .egg or .zip</span>
-            <span class="c1"># archive filename is dropped in call to dirname below.</span>
-            <span class="n">filename</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">archive</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="c1"># At least one loader is missing both get_filename and archive:</span>
-            <span class="c1"># Google App Engine&#39;s HardenedModulesHook</span>
-            <span class="c1">#</span>
-            <span class="c1"># Fall back to imports.</span>
-            <span class="nb">__import__</span><span class="p">(</span><span class="n">import_name</span><span class="p">)</span>
-            <span class="n">filename</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">modules</span><span class="p">[</span><span class="n">import_name</span><span class="p">]</span><span class="o">.</span><span class="n">__file__</span>
-        <span class="n">package_path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">filename</span><span class="p">))</span>
-
-        <span class="c1"># In case the root module is a package we need to chop of the</span>
-        <span class="c1"># rightmost part.  This needs to go through a helper function</span>
-        <span class="c1"># because of python 3.3 namespace packages.</span>
-        <span class="k">if</span> <span class="n">_matching_loader_thinks_module_is_package</span><span class="p">(</span>
-                <span class="n">loader</span><span class="p">,</span> <span class="n">root_mod_name</span><span class="p">):</span>
-            <span class="n">package_path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">package_path</span><span class="p">)</span>
-
-    <span class="n">site_parent</span><span class="p">,</span> <span class="n">site_folder</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">package_path</span><span class="p">)</span>
-    <span class="n">py_prefix</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">prefix</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">package_path</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="n">py_prefix</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">py_prefix</span><span class="p">,</span> <span class="n">package_path</span>
-    <span class="k">elif</span> <span class="n">site_folder</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s1">&#39;site-packages&#39;</span><span class="p">:</span>
-        <span class="n">parent</span><span class="p">,</span> <span class="n">folder</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">site_parent</span><span class="p">)</span>
-        <span class="c1"># Windows like installations</span>
-        <span class="k">if</span> <span class="n">folder</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s1">&#39;lib&#39;</span><span class="p">:</span>
-            <span class="n">base_dir</span> <span class="o">=</span> <span class="n">parent</span>
-        <span class="c1"># UNIX like installations</span>
-        <span class="k">elif</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">basename</span><span class="p">(</span><span class="n">parent</span><span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s1">&#39;lib&#39;</span><span class="p">:</span>
-            <span class="n">base_dir</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">parent</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">base_dir</span> <span class="o">=</span> <span class="n">site_parent</span>
-        <span class="k">return</span> <span class="n">base_dir</span><span class="p">,</span> <span class="n">package_path</span>
-    <span class="k">return</span> <span class="kc">None</span><span class="p">,</span> <span class="n">package_path</span></div>
-
-
-<div class="viewcode-block" id="locked_cached_property"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.locked_cached_property">[docs]</a><span class="k">class</span> <span class="nc">locked_cached_property</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;A decorator that converts a function into a lazy property.  The</span>
-<span class="sd">    function wrapped is called the first time to retrieve the result</span>
-<span class="sd">    and then that calculated result is used the next time you access</span>
-<span class="sd">    the value.  Works like the one in Werkzeug but has a lock for</span>
-<span class="sd">    thread safety.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">func</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__name__</span> <span class="o">=</span> <span class="n">name</span> <span class="ow">or</span> <span class="n">func</span><span class="o">.</span><span class="n">__name__</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__module__</span> <span class="o">=</span> <span class="n">func</span><span class="o">.</span><span class="n">__module__</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__doc__</span> <span class="o">=</span> <span class="n">doc</span> <span class="ow">or</span> <span class="n">func</span><span class="o">.</span><span class="n">__doc__</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">func</span> <span class="o">=</span> <span class="n">func</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">lock</span> <span class="o">=</span> <span class="n">RLock</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__get__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">obj</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span>
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">lock</span><span class="p">:</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">__dict__</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="n">_missing</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="n">_missing</span><span class="p">:</span>
-                <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">func</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
-                <span class="n">obj</span><span class="o">.</span><span class="n">__dict__</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">__name__</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-            <span class="k">return</span> <span class="n">value</span></div>
-
-
-<span class="k">class</span> <span class="nc">_PackageBoundObject</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">import_name</span><span class="p">,</span> <span class="n">template_folder</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">root_path</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="c1">#: The name of the package or module.  Do not change this once</span>
-        <span class="c1">#: it was set by the constructor.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">import_name</span> <span class="o">=</span> <span class="n">import_name</span>
-
-        <span class="c1">#: location of the templates.  ``None`` if templates should not be</span>
-        <span class="c1">#: exposed.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">template_folder</span> <span class="o">=</span> <span class="n">template_folder</span>
-
-        <span class="k">if</span> <span class="n">root_path</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">root_path</span> <span class="o">=</span> <span class="n">get_root_path</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">import_name</span><span class="p">)</span>
-
-        <span class="c1">#: Where is the app root located?</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">root_path</span> <span class="o">=</span> <span class="n">root_path</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">_static_folder</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_static_url_path</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="k">def</span> <span class="nf">_get_static_folder</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_static_folder</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_static_folder</span><span class="p">)</span>
-    <span class="k">def</span> <span class="nf">_set_static_folder</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_static_folder</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="n">static_folder</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_static_folder</span><span class="p">,</span> <span class="n">_set_static_folder</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">    The absolute path to the configured static folder.</span>
-<span class="s1">    &#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_static_folder</span><span class="p">,</span> <span class="n">_set_static_folder</span>
-
-    <span class="k">def</span> <span class="nf">_get_static_url_path</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_static_url_path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_static_url_path</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">static_folder</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="s1">&#39;/&#39;</span> <span class="o">+</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">basename</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">static_folder</span><span class="p">)</span>
-    <span class="k">def</span> <span class="nf">_set_static_url_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_static_url_path</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="n">static_url_path</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_static_url_path</span><span class="p">,</span> <span class="n">_set_static_url_path</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_static_url_path</span><span class="p">,</span> <span class="n">_set_static_url_path</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">has_static_folder</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This is ``True`` if the package bound object&#39;s container has a</span>
-<span class="sd">        folder for static files.</span>
-
-<span class="sd">        .. versionadded:: 0.5</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">static_folder</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-
-    <span class="nd">@locked_cached_property</span>
-    <span class="k">def</span> <span class="nf">jinja_loader</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The Jinja loader for this package bound object.</span>
-
-<span class="sd">        .. versionadded:: 0.5</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">template_folder</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">FileSystemLoader</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span>
-                                                 <span class="bp">self</span><span class="o">.</span><span class="n">template_folder</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">get_send_file_max_age</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filename</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Provides default cache_timeout for the :func:`send_file` functions.</span>
-
-<span class="sd">        By default, this function returns ``SEND_FILE_MAX_AGE_DEFAULT`` from</span>
-<span class="sd">        the configuration of :data:`~flask.current_app`.</span>
-
-<span class="sd">        Static file functions such as :func:`send_from_directory` use this</span>
-<span class="sd">        function, and :func:`send_file` calls this function on</span>
-<span class="sd">        :data:`~flask.current_app` when the given cache_timeout is ``None``. If a</span>
-<span class="sd">        cache_timeout is given in :func:`send_file`, that timeout is used;</span>
-<span class="sd">        otherwise, this method is called.</span>
-
-<span class="sd">        This allows subclasses to change the behavior when sending files based</span>
-<span class="sd">        on the filename.  For example, to set the cache timeout for .js files</span>
-<span class="sd">        to 60 seconds::</span>
-
-<span class="sd">            class MyFlask(flask.Flask):</span>
-<span class="sd">                def get_send_file_max_age(self, name):</span>
-<span class="sd">                    if name.lower().endswith(&#39;.js&#39;):</span>
-<span class="sd">                        return 60</span>
-<span class="sd">                    return flask.Flask.get_send_file_max_age(self, name)</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">total_seconds</span><span class="p">(</span><span class="n">current_app</span><span class="o">.</span><span class="n">send_file_max_age_default</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">send_static_file</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filename</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Function used internally to send static files from the static</span>
-<span class="sd">        folder to the browser.</span>
-
-<span class="sd">        .. versionadded:: 0.5</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">has_static_folder</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;No static folder for this object&#39;</span><span class="p">)</span>
-        <span class="c1"># Ensure get_send_file_max_age is called in all cases.</span>
-        <span class="c1"># Here, we ensure get_send_file_max_age is called for Blueprints.</span>
-        <span class="n">cache_timeout</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_send_file_max_age</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">send_from_directory</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">static_folder</span><span class="p">,</span> <span class="n">filename</span><span class="p">,</span>
-                                   <span class="n">cache_timeout</span><span class="o">=</span><span class="n">cache_timeout</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">open_resource</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">resource</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s1">&#39;rb&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Opens a resource from the application&#39;s resource folder.  To see</span>
-<span class="sd">        how this works, consider the following folder structure::</span>
-
-<span class="sd">            /myapplication.py</span>
-<span class="sd">            /schema.sql</span>
-<span class="sd">            /static</span>
-<span class="sd">                /style.css</span>
-<span class="sd">            /templates</span>
-<span class="sd">                /layout.html</span>
-<span class="sd">                /index.html</span>
-
-<span class="sd">        If you want to open the :file:`schema.sql` file you would do the</span>
-<span class="sd">        following::</span>
-
-<span class="sd">            with app.open_resource(&#39;schema.sql&#39;) as f:</span>
-<span class="sd">                contents = f.read()</span>
-<span class="sd">                do_something_with(contents)</span>
-
-<span class="sd">        :param resource: the name of the resource.  To access resources within</span>
-<span class="sd">                         subfolders use forward slashes as separator.</span>
-<span class="sd">        :param mode: resource file opening mode, default is &#39;rb&#39;.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">mode</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;r&#39;</span><span class="p">,</span> <span class="s1">&#39;rb&#39;</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;Resources can only be opened for reading&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">open</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">root_path</span><span class="p">,</span> <span class="n">resource</span><span class="p">),</span> <span class="n">mode</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="total_seconds"><a class="viewcode-back" href="../../flask/flask.html#flask.helpers.total_seconds">[docs]</a><span class="k">def</span> <span class="nf">total_seconds</span><span class="p">(</span><span class="n">td</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Returns the total seconds from a timedelta object.</span>
-
-<span class="sd">    :param timedelta td: the timedelta to be converted in seconds</span>
-
-<span class="sd">    :returns: number of seconds</span>
-<span class="sd">    :rtype: int</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="n">td</span><span class="o">.</span><span class="n">days</span> <span class="o">*</span> <span class="mi">60</span> <span class="o">*</span> <span class="mi">60</span> <span class="o">*</span> <span class="mi">24</span> <span class="o">+</span> <span class="n">td</span><span class="o">.</span><span class="n">seconds</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/json.html

@@ -1,360 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.json &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.json</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.jsonimpl</span>
-<span class="sd">    ~~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implementation helpers for the JSON support in Flask.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">io</span>
-<span class="kn">import</span> <span class="nn">uuid</span>
-<span class="kn">from</span> <span class="nn">datetime</span> <span class="k">import</span> <span class="n">date</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">current_app</span><span class="p">,</span> <span class="n">request</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">text_type</span><span class="p">,</span> <span class="n">PY2</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.http</span> <span class="k">import</span> <span class="n">http_date</span>
-<span class="kn">from</span> <span class="nn">jinja2</span> <span class="k">import</span> <span class="n">Markup</span>
-
-<span class="c1"># Use the same json implementation as itsdangerous on which we</span>
-<span class="c1"># depend anyways.</span>
-<span class="k">try</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">itsdangerous</span> <span class="k">import</span> <span class="n">simplejson</span> <span class="k">as</span> <span class="n">_json</span>
-<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">itsdangerous</span> <span class="k">import</span> <span class="n">json</span> <span class="k">as</span> <span class="n">_json</span>
-
-
-<span class="c1"># Figure out if simplejson escapes slashes.  This behavior was changed</span>
-<span class="c1"># from one version to another without reason.</span>
-<span class="n">_slash_escape</span> <span class="o">=</span> <span class="s1">&#39;</span><span class="se">\\</span><span class="s1">/&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">_json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-
-
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;dump&#39;</span><span class="p">,</span> <span class="s1">&#39;dumps&#39;</span><span class="p">,</span> <span class="s1">&#39;load&#39;</span><span class="p">,</span> <span class="s1">&#39;loads&#39;</span><span class="p">,</span> <span class="s1">&#39;htmlsafe_dump&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;htmlsafe_dumps&#39;</span><span class="p">,</span> <span class="s1">&#39;JSONDecoder&#39;</span><span class="p">,</span> <span class="s1">&#39;JSONEncoder&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;jsonify&#39;</span><span class="p">]</span>
-
-
-<span class="k">def</span> <span class="nf">_wrap_reader_for_text</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="n">encoding</span><span class="p">):</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">fp</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">0</span><span class="p">),</span> <span class="nb">bytes</span><span class="p">):</span>
-        <span class="n">fp</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">TextIOWrapper</span><span class="p">(</span><span class="n">io</span><span class="o">.</span><span class="n">BufferedReader</span><span class="p">(</span><span class="n">fp</span><span class="p">),</span> <span class="n">encoding</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">fp</span>
-
-
-<span class="k">def</span> <span class="nf">_wrap_writer_for_text</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="n">encoding</span><span class="p">):</span>
-    <span class="k">try</span><span class="p">:</span>
-        <span class="n">fp</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="s1">&#39;&#39;</span><span class="p">)</span>
-    <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span>
-        <span class="n">fp</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">TextIOWrapper</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="n">encoding</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">fp</span>
-
-
-<div class="viewcode-block" id="JSONEncoder"><a class="viewcode-back" href="../../flask/flask.html#flask.app.JSONEncoder">[docs]</a><span class="k">class</span> <span class="nc">JSONEncoder</span><span class="p">(</span><span class="n">_json</span><span class="o">.</span><span class="n">JSONEncoder</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The default Flask JSON encoder.  This one extends the default simplejson</span>
-<span class="sd">    encoder by also supporting ``datetime`` objects, ``UUID`` as well as</span>
-<span class="sd">    ``Markup`` objects which are serialized as RFC 822 datetime strings (same</span>
-<span class="sd">    as the HTTP date format).  In order to support more data types override the</span>
-<span class="sd">    :meth:`default` method.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-<div class="viewcode-block" id="JSONEncoder.default"><a class="viewcode-back" href="../../flask/flask.html#flask.app.JSONEncoder.default">[docs]</a>    <span class="k">def</span> <span class="nf">default</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">o</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Implement this method in a subclass such that it returns a</span>
-<span class="sd">        serializable object for ``o``, or calls the base implementation (to</span>
-<span class="sd">        raise a :exc:`TypeError`).</span>
-
-<span class="sd">        For example, to support arbitrary iterators, you could implement</span>
-<span class="sd">        default like this::</span>
-
-<span class="sd">            def default(self, o):</span>
-<span class="sd">                try:</span>
-<span class="sd">                    iterable = iter(o)</span>
-<span class="sd">                except TypeError:</span>
-<span class="sd">                    pass</span>
-<span class="sd">                else:</span>
-<span class="sd">                    return list(iterable)</span>
-<span class="sd">                return JSONEncoder.default(self, o)</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">o</span><span class="p">,</span> <span class="n">date</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">http_date</span><span class="p">(</span><span class="n">o</span><span class="o">.</span><span class="n">timetuple</span><span class="p">())</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">o</span><span class="p">,</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">):</span>
-            <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">o</span><span class="p">)</span>
-        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">o</span><span class="p">,</span> <span class="s1">&#39;__html__&#39;</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">text_type</span><span class="p">(</span><span class="n">o</span><span class="o">.</span><span class="n">__html__</span><span class="p">())</span>
-        <span class="k">return</span> <span class="n">_json</span><span class="o">.</span><span class="n">JSONEncoder</span><span class="o">.</span><span class="n">default</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">o</span><span class="p">)</span></div></div>
-
-
-<div class="viewcode-block" id="JSONDecoder"><a class="viewcode-back" href="../../flask/flask.html#flask.app.JSONDecoder">[docs]</a><span class="k">class</span> <span class="nc">JSONDecoder</span><span class="p">(</span><span class="n">_json</span><span class="o">.</span><span class="n">JSONDecoder</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The default JSON decoder.  This one does not change the behavior from</span>
-<span class="sd">    the default simplejson decoder.  Consult the :mod:`json` documentation</span>
-<span class="sd">    for more information.  This decoder is not only used for the load</span>
-<span class="sd">    functions of this module but also :attr:`~flask.Request`.</span>
-<span class="sd">    &quot;&quot;&quot;</span></div>
-
-
-<span class="k">def</span> <span class="nf">_dump_arg_defaults</span><span class="p">(</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Inject default arguments for dump functions.&quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="n">current_app</span><span class="p">:</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;cls&#39;</span><span class="p">,</span> <span class="n">current_app</span><span class="o">.</span><span class="n">json_encoder</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">current_app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;JSON_AS_ASCII&#39;</span><span class="p">]:</span>
-            <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;ensure_ascii&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;sort_keys&#39;</span><span class="p">,</span> <span class="n">current_app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;JSON_SORT_KEYS&#39;</span><span class="p">])</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;sort_keys&#39;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;cls&#39;</span><span class="p">,</span> <span class="n">JSONEncoder</span><span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">_load_arg_defaults</span><span class="p">(</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Inject default arguments for load functions.&quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="n">current_app</span><span class="p">:</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;cls&#39;</span><span class="p">,</span> <span class="n">current_app</span><span class="o">.</span><span class="n">json_decoder</span><span class="p">)</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;cls&#39;</span><span class="p">,</span> <span class="n">JSONDecoder</span><span class="p">)</span>
-
-
-<div class="viewcode-block" id="dumps"><a class="viewcode-back" href="../../flask/flask.html#flask.app.dumps">[docs]</a><span class="k">def</span> <span class="nf">dumps</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Serialize ``obj`` to a JSON formatted ``str`` by using the application&#39;s</span>
-<span class="sd">    configured encoder (:attr:`~flask.Flask.json_encoder`) if there is an</span>
-<span class="sd">    application on the stack.</span>
-
-<span class="sd">    This function can return ``unicode`` strings or ascii-only bytestrings by</span>
-<span class="sd">    default which coerce into unicode strings automatically.  That behavior by</span>
-<span class="sd">    default is controlled by the ``JSON_AS_ASCII`` configuration variable</span>
-<span class="sd">    and can be overridden by the simplejson ``ensure_ascii`` parameter.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">_dump_arg_defaults</span><span class="p">(</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="n">encoding</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;encoding&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">rv</span> <span class="o">=</span> <span class="n">_json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">encoding</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rv</span><span class="p">,</span> <span class="n">text_type</span><span class="p">):</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="n">rv</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">encoding</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">rv</span></div>
-
-
-<div class="viewcode-block" id="dump"><a class="viewcode-back" href="../../flask/flask.html#flask.app.dump">[docs]</a><span class="k">def</span> <span class="nf">dump</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">fp</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Like :func:`dumps` but writes into a file object.&quot;&quot;&quot;</span>
-    <span class="n">_dump_arg_defaults</span><span class="p">(</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="n">encoding</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;encoding&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">encoding</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">fp</span> <span class="o">=</span> <span class="n">_wrap_writer_for_text</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="n">encoding</span><span class="p">)</span>
-    <span class="n">_json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">fp</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="loads"><a class="viewcode-back" href="../../flask/flask.html#flask.app.loads">[docs]</a><span class="k">def</span> <span class="nf">loads</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Unserialize a JSON object from a string ``s`` by using the application&#39;s</span>
-<span class="sd">    configured decoder (:attr:`~flask.Flask.json_decoder`) if there is an</span>
-<span class="sd">    application on the stack.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">_load_arg_defaults</span><span class="p">(</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-        <span class="n">s</span> <span class="o">=</span> <span class="n">s</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;encoding&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">or</span> <span class="s1">&#39;utf-8&#39;</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">_json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="load"><a class="viewcode-back" href="../../flask/flask.html#flask.app.load">[docs]</a><span class="k">def</span> <span class="nf">load</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Like :func:`loads` but reads from a file object.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">_load_arg_defaults</span><span class="p">(</span><span class="n">kwargs</span><span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">PY2</span><span class="p">:</span>
-        <span class="n">fp</span> <span class="o">=</span> <span class="n">_wrap_reader_for_text</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;encoding&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">or</span> <span class="s1">&#39;utf-8&#39;</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">_json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="htmlsafe_dumps"><a class="viewcode-back" href="../../flask/flask.html#flask.app.htmlsafe_dumps">[docs]</a><span class="k">def</span> <span class="nf">htmlsafe_dumps</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Works exactly like :func:`dumps` but is safe for use in ``&lt;script&gt;``</span>
-<span class="sd">    tags.  It accepts the same arguments and returns a JSON string.  Note that</span>
-<span class="sd">    this is available in templates through the ``|tojson`` filter which will</span>
-<span class="sd">    also mark the result as safe.  Due to how this function escapes certain</span>
-<span class="sd">    characters this is safe even if used outside of ``&lt;script&gt;`` tags.</span>
-
-<span class="sd">    The following characters are escaped in strings:</span>
-
-<span class="sd">    -   ``&lt;``</span>
-<span class="sd">    -   ``&gt;``</span>
-<span class="sd">    -   ``&amp;``</span>
-<span class="sd">    -   ``&#39;``</span>
-
-<span class="sd">    This makes it safe to embed such strings in any place in HTML with the</span>
-<span class="sd">    notable exception of double quoted attributes.  In that case single</span>
-<span class="sd">    quote your attributes or HTML escape it in addition.</span>
-
-<span class="sd">    .. versionchanged:: 0.10</span>
-<span class="sd">       This function&#39;s return value is now always safe for HTML usage, even</span>
-<span class="sd">       if outside of script tags or if used in XHTML.  This rule does not</span>
-<span class="sd">       hold true when using this function in HTML attributes that are double</span>
-<span class="sd">       quoted.  Always single quote attributes if you use the ``|tojson``</span>
-<span class="sd">       filter.  Alternatively use ``|tojson|forceescape``.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">rv</span> <span class="o">=</span> <span class="n">dumps</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> \
-        <span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">u&#39;&lt;&#39;</span><span class="p">,</span> <span class="s1">u&#39;</span><span class="se">\\</span><span class="s1">u003c&#39;</span><span class="p">)</span> \
-        <span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">u&#39;&gt;&#39;</span><span class="p">,</span> <span class="s1">u&#39;</span><span class="se">\\</span><span class="s1">u003e&#39;</span><span class="p">)</span> \
-        <span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">u&#39;&amp;&#39;</span><span class="p">,</span> <span class="s1">u&#39;</span><span class="se">\\</span><span class="s1">u0026&#39;</span><span class="p">)</span> \
-        <span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">u&quot;&#39;&quot;</span><span class="p">,</span> <span class="s1">u&#39;</span><span class="se">\\</span><span class="s1">u0027&#39;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">_slash_escape</span><span class="p">:</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="n">rv</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\\</span><span class="s1">/&#39;</span><span class="p">,</span> <span class="s1">&#39;/&#39;</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">rv</span></div>
-
-
-<div class="viewcode-block" id="htmlsafe_dump"><a class="viewcode-back" href="../../flask/flask.html#flask.app.htmlsafe_dump">[docs]</a><span class="k">def</span> <span class="nf">htmlsafe_dump</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">fp</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Like :func:`htmlsafe_dumps` but writes into a file object.&quot;&quot;&quot;</span>
-    <span class="n">fp</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">text_type</span><span class="p">(</span><span class="n">htmlsafe_dumps</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)))</span></div>
-
-
-<div class="viewcode-block" id="jsonify"><a class="viewcode-back" href="../../flask/flask.html#flask.app.jsonify">[docs]</a><span class="k">def</span> <span class="nf">jsonify</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;This function wraps :func:`dumps` to add a few enhancements that make</span>
-<span class="sd">    life easier.  It turns the JSON output into a :class:`~flask.Response`</span>
-<span class="sd">    object with the :mimetype:`application/json` mimetype.  For convenience, it</span>
-<span class="sd">    also converts multiple arguments into an array or multiple keyword arguments</span>
-<span class="sd">    into a dict.  This means that both ``jsonify(1,2,3)`` and</span>
-<span class="sd">    ``jsonify([1,2,3])`` serialize to ``[1,2,3]``.</span>
-
-<span class="sd">    For clarity, the JSON serialization behavior has the following differences</span>
-<span class="sd">    from :func:`dumps`:</span>
-
-<span class="sd">    1. Single argument: Passed straight through to :func:`dumps`.</span>
-<span class="sd">    2. Multiple arguments: Converted to an array before being passed to</span>
-<span class="sd">       :func:`dumps`.</span>
-<span class="sd">    3. Multiple keyword arguments: Converted to a dict before being passed to</span>
-<span class="sd">       :func:`dumps`.</span>
-<span class="sd">    4. Both args and kwargs: Behavior undefined and will throw an exception.</span>
-
-<span class="sd">    Example usage::</span>
-
-<span class="sd">        from flask import jsonify</span>
-
-<span class="sd">        @app.route(&#39;/_get_current_user&#39;)</span>
-<span class="sd">        def get_current_user():</span>
-<span class="sd">            return jsonify(username=g.user.username,</span>
-<span class="sd">                           email=g.user.email,</span>
-<span class="sd">                           id=g.user.id)</span>
-
-<span class="sd">    This will send a JSON response like this to the browser::</span>
-
-<span class="sd">        {</span>
-<span class="sd">            &quot;username&quot;: &quot;admin&quot;,</span>
-<span class="sd">            &quot;email&quot;: &quot;admin@localhost&quot;,</span>
-<span class="sd">            &quot;id&quot;: 42</span>
-<span class="sd">        }</span>
-
-
-<span class="sd">    .. versionchanged:: 0.11</span>
-<span class="sd">       Added support for serializing top-level arrays. This introduces a</span>
-<span class="sd">       security risk in ancient browsers. See :ref:`json-security` for details.</span>
-
-<span class="sd">    This function&#39;s response will be pretty printed if it was not requested</span>
-<span class="sd">    with ``X-Requested-With: XMLHttpRequest`` to simplify debugging unless</span>
-<span class="sd">    the ``JSONIFY_PRETTYPRINT_REGULAR`` config parameter is set to false.</span>
-<span class="sd">    Compressed (not pretty) formatting currently means no indents and no</span>
-<span class="sd">    spaces after separators.</span>
-
-<span class="sd">    .. versionadded:: 0.2</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">indent</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="n">separators</span> <span class="o">=</span> <span class="p">(</span><span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="s1">&#39;:&#39;</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">current_app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;JSONIFY_PRETTYPRINT_REGULAR&#39;</span><span class="p">]</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">request</span><span class="o">.</span><span class="n">is_xhr</span><span class="p">:</span>
-        <span class="n">indent</span> <span class="o">=</span> <span class="mi">2</span>
-        <span class="n">separators</span> <span class="o">=</span> <span class="p">(</span><span class="s1">&#39;, &#39;</span><span class="p">,</span> <span class="s1">&#39;: &#39;</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">args</span> <span class="ow">and</span> <span class="n">kwargs</span><span class="p">:</span>
-        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;jsonify() behavior undefined when passed both args and kwargs&#39;</span><span class="p">)</span>
-    <span class="k">elif</span> <span class="nb">len</span><span class="p">(</span><span class="n">args</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>  <span class="c1"># single args are passed directly to dumps()</span>
-        <span class="n">data</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">data</span> <span class="o">=</span> <span class="n">args</span> <span class="ow">or</span> <span class="n">kwargs</span>
-
-    <span class="k">return</span> <span class="n">current_app</span><span class="o">.</span><span class="n">response_class</span><span class="p">(</span>
-        <span class="p">(</span><span class="n">dumps</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">indent</span><span class="o">=</span><span class="n">indent</span><span class="p">,</span> <span class="n">separators</span><span class="o">=</span><span class="n">separators</span><span class="p">),</span> <span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="p">),</span>
-        <span class="n">mimetype</span><span class="o">=</span><span class="n">current_app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;JSONIFY_MIMETYPE&#39;</span><span class="p">]</span>
-    <span class="p">)</span></div>
-
-
-<span class="k">def</span> <span class="nf">tojson_filter</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="k">return</span> <span class="n">Markup</span><span class="p">(</span><span class="n">htmlsafe_dumps</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/logging.html

@@ -1,178 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.logging &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.logging</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.logging</span>
-<span class="sd">    ~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements the logging support for Flask.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">from</span> <span class="nn">__future__</span> <span class="k">import</span> <span class="n">absolute_import</span>
-
-<span class="kn">import</span> <span class="nn">sys</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.local</span> <span class="k">import</span> <span class="n">LocalProxy</span>
-<span class="kn">from</span> <span class="nn">logging</span> <span class="k">import</span> <span class="n">getLogger</span><span class="p">,</span> <span class="n">StreamHandler</span><span class="p">,</span> <span class="n">Formatter</span><span class="p">,</span> <span class="n">getLoggerClass</span><span class="p">,</span> \
-     <span class="n">DEBUG</span><span class="p">,</span> <span class="n">ERROR</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span>
-
-
-<span class="n">PROD_LOG_FORMAT</span> <span class="o">=</span> <span class="s1">&#39;[</span><span class="si">%(asctime)s</span><span class="s1">] </span><span class="si">%(levelname)s</span><span class="s1"> in </span><span class="si">%(module)s</span><span class="s1">: </span><span class="si">%(message)s</span><span class="s1">&#39;</span>
-<span class="n">DEBUG_LOG_FORMAT</span> <span class="o">=</span> <span class="p">(</span>
-    <span class="s1">&#39;-&#39;</span> <span class="o">*</span> <span class="mi">80</span> <span class="o">+</span> <span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span> <span class="o">+</span>
-    <span class="s1">&#39;</span><span class="si">%(levelname)s</span><span class="s1"> in </span><span class="si">%(module)s</span><span class="s1"> [</span><span class="si">%(pathname)s</span><span class="s1">:</span><span class="si">%(lineno)d</span><span class="s1">]:</span><span class="se">\n</span><span class="s1">&#39;</span> <span class="o">+</span>
-    <span class="s1">&#39;</span><span class="si">%(message)s</span><span class="se">\n</span><span class="s1">&#39;</span> <span class="o">+</span>
-    <span class="s1">&#39;-&#39;</span> <span class="o">*</span> <span class="mi">80</span>
-<span class="p">)</span>
-
-
-<span class="nd">@LocalProxy</span>
-<span class="k">def</span> <span class="nf">_proxy_stream</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;Finds the most appropriate error stream for the application.  If a</span>
-<span class="sd">    WSGI request is in flight we log to wsgi.errors, otherwise this resolves</span>
-<span class="sd">    to sys.stderr.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">ctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="k">if</span> <span class="n">ctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">ctx</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;wsgi.errors&#39;</span><span class="p">]</span>
-    <span class="k">return</span> <span class="n">sys</span><span class="o">.</span><span class="n">stderr</span>
-
-
-<span class="k">def</span> <span class="nf">_should_log_for</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">mode</span><span class="p">):</span>
-    <span class="n">policy</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;LOGGER_HANDLER_POLICY&#39;</span><span class="p">]</span>
-    <span class="k">if</span> <span class="n">policy</span> <span class="o">==</span> <span class="n">mode</span> <span class="ow">or</span> <span class="n">policy</span> <span class="o">==</span> <span class="s1">&#39;always&#39;</span><span class="p">:</span>
-        <span class="k">return</span> <span class="kc">True</span>
-    <span class="k">return</span> <span class="kc">False</span>
-
-
-<div class="viewcode-block" id="create_logger"><a class="viewcode-back" href="../../flask/flask.html#flask.logging.create_logger">[docs]</a><span class="k">def</span> <span class="nf">create_logger</span><span class="p">(</span><span class="n">app</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Creates a logger for the given application.  This logger works</span>
-<span class="sd">    similar to a regular Python logger but changes the effective logging</span>
-<span class="sd">    level based on the application&#39;s debug flag.  Furthermore this</span>
-<span class="sd">    function also removes all attached handlers in case there was a</span>
-<span class="sd">    logger with the log name before.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">Logger</span> <span class="o">=</span> <span class="n">getLoggerClass</span><span class="p">()</span>
-
-    <span class="k">class</span> <span class="nc">DebugLogger</span><span class="p">(</span><span class="n">Logger</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">getEffectiveLevel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">level</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">app</span><span class="o">.</span><span class="n">debug</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">DEBUG</span>
-            <span class="k">return</span> <span class="n">Logger</span><span class="o">.</span><span class="n">getEffectiveLevel</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">class</span> <span class="nc">DebugHandler</span><span class="p">(</span><span class="n">StreamHandler</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">app</span><span class="o">.</span><span class="n">debug</span> <span class="ow">and</span> <span class="n">_should_log_for</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="s1">&#39;debug&#39;</span><span class="p">):</span>
-                <span class="n">StreamHandler</span><span class="o">.</span><span class="n">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">)</span>
-
-    <span class="k">class</span> <span class="nc">ProductionHandler</span><span class="p">(</span><span class="n">StreamHandler</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">app</span><span class="o">.</span><span class="n">debug</span> <span class="ow">and</span> <span class="n">_should_log_for</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="s1">&#39;production&#39;</span><span class="p">):</span>
-                <span class="n">StreamHandler</span><span class="o">.</span><span class="n">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">)</span>
-
-    <span class="n">debug_handler</span> <span class="o">=</span> <span class="n">DebugHandler</span><span class="p">()</span>
-    <span class="n">debug_handler</span><span class="o">.</span><span class="n">setLevel</span><span class="p">(</span><span class="n">DEBUG</span><span class="p">)</span>
-    <span class="n">debug_handler</span><span class="o">.</span><span class="n">setFormatter</span><span class="p">(</span><span class="n">Formatter</span><span class="p">(</span><span class="n">DEBUG_LOG_FORMAT</span><span class="p">))</span>
-
-    <span class="n">prod_handler</span> <span class="o">=</span> <span class="n">ProductionHandler</span><span class="p">(</span><span class="n">_proxy_stream</span><span class="p">)</span>
-    <span class="n">prod_handler</span><span class="o">.</span><span class="n">setLevel</span><span class="p">(</span><span class="n">ERROR</span><span class="p">)</span>
-    <span class="n">prod_handler</span><span class="o">.</span><span class="n">setFormatter</span><span class="p">(</span><span class="n">Formatter</span><span class="p">(</span><span class="n">PROD_LOG_FORMAT</span><span class="p">))</span>
-
-    <span class="n">logger</span> <span class="o">=</span> <span class="n">getLogger</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">logger_name</span><span class="p">)</span>
-    <span class="c1"># just in case that was not a new logger, get rid of all the handlers</span>
-    <span class="c1"># already attached to it.</span>
-    <span class="k">del</span> <span class="n">logger</span><span class="o">.</span><span class="n">handlers</span><span class="p">[:]</span>
-    <span class="n">logger</span><span class="o">.</span><span class="n">__class__</span> <span class="o">=</span> <span class="n">DebugLogger</span>
-    <span class="n">logger</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">debug_handler</span><span class="p">)</span>
-    <span class="n">logger</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">prod_handler</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">logger</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/sessions.html

@@ -1,450 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.sessions &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.sessions</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.sessions</span>
-<span class="sd">    ~~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements cookie based sessions based on itsdangerous.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">import</span> <span class="nn">uuid</span>
-<span class="kn">import</span> <span class="nn">hashlib</span>
-<span class="kn">from</span> <span class="nn">base64</span> <span class="k">import</span> <span class="n">b64encode</span><span class="p">,</span> <span class="n">b64decode</span>
-<span class="kn">from</span> <span class="nn">datetime</span> <span class="k">import</span> <span class="n">datetime</span>
-<span class="kn">from</span> <span class="nn">werkzeug.http</span> <span class="k">import</span> <span class="n">http_date</span><span class="p">,</span> <span class="n">parse_date</span>
-<span class="kn">from</span> <span class="nn">werkzeug.datastructures</span> <span class="k">import</span> <span class="n">CallbackDict</span>
-<span class="kn">from</span> <span class="nn">.</span> <span class="k">import</span> <span class="n">Markup</span><span class="p">,</span> <span class="n">json</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">iteritems</span><span class="p">,</span> <span class="n">text_type</span>
-<span class="kn">from</span> <span class="nn">.helpers</span> <span class="k">import</span> <span class="n">total_seconds</span>
-
-<span class="kn">from</span> <span class="nn">itsdangerous</span> <span class="k">import</span> <span class="n">URLSafeTimedSerializer</span><span class="p">,</span> <span class="n">BadSignature</span>
-
-
-<div class="viewcode-block" id="SessionMixin"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionMixin">[docs]</a><span class="k">class</span> <span class="nc">SessionMixin</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Expands a basic dictionary with an accessors that are expected</span>
-<span class="sd">    by Flask extensions and users for the session.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">_get_permanent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;_permanent&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_set_permanent</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="bp">self</span><span class="p">[</span><span class="s1">&#39;_permanent&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-
-    <span class="c1">#: this reflects the ``&#39;_permanent&#39;`` key in the dict.</span>
-    <span class="n">permanent</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_permanent</span><span class="p">,</span> <span class="n">_set_permanent</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_permanent</span><span class="p">,</span> <span class="n">_set_permanent</span>
-
-    <span class="c1">#: some session backends can tell you if a session is new, but that is</span>
-    <span class="c1">#: not necessarily guaranteed.  Use with caution.  The default mixin</span>
-    <span class="c1">#: implementation just hardcodes ``False`` in.</span>
-    <span class="n">new</span> <span class="o">=</span> <span class="kc">False</span>
-
-    <span class="c1">#: for some backends this will always be ``True``, but some backends will</span>
-    <span class="c1">#: default this to false and detect changes in the dictionary for as</span>
-    <span class="c1">#: long as changes do not happen on mutable structures in the session.</span>
-    <span class="c1">#: The default mixin implementation just hardcodes ``True`` in.</span>
-    <span class="n">modified</span> <span class="o">=</span> <span class="kc">True</span></div>
-
-
-<span class="k">def</span> <span class="nf">_tag</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s1">&#39; t&#39;</span><span class="p">:</span> <span class="p">[</span><span class="n">_tag</span><span class="p">(</span><span class="n">x</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">value</span><span class="p">]}</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s1">&#39; u&#39;</span><span class="p">:</span> <span class="n">value</span><span class="o">.</span><span class="n">hex</span><span class="p">}</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s1">&#39; b&#39;</span><span class="p">:</span> <span class="n">b64encode</span><span class="p">(</span><span class="n">value</span><span class="p">)</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s1">&#39;ascii&#39;</span><span class="p">)}</span>
-    <span class="k">elif</span> <span class="n">callable</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="s1">&#39;__html__&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)):</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s1">&#39; m&#39;</span><span class="p">:</span> <span class="n">text_type</span><span class="p">(</span><span class="n">value</span><span class="o">.</span><span class="n">__html__</span><span class="p">())}</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">[</span><span class="n">_tag</span><span class="p">(</span><span class="n">x</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">value</span><span class="p">]</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">datetime</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">{</span><span class="s1">&#39; d&#39;</span><span class="p">:</span> <span class="n">http_date</span><span class="p">(</span><span class="n">value</span><span class="p">)}</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">dict</span><span class="p">((</span><span class="n">k</span><span class="p">,</span> <span class="n">_tag</span><span class="p">(</span><span class="n">v</span><span class="p">))</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">value</span><span class="p">))</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">text_type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">UnicodeError</span><span class="p">:</span>
-            <span class="kn">from</span> <span class="nn">flask.debughelpers</span> <span class="k">import</span> <span class="n">UnexpectedUnicodeError</span>
-            <span class="k">raise</span> <span class="n">UnexpectedUnicodeError</span><span class="p">(</span><span class="s1">u&#39;A byte string with &#39;</span>
-                <span class="s1">u&#39;non-ASCII data was passed to the session system &#39;</span>
-                <span class="s1">u&#39;which can only store unicode strings.  Consider &#39;</span>
-                <span class="s1">u&#39;base64 encoding your string (String was </span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="n">value</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">value</span>
-
-
-<div class="viewcode-block" id="TaggedJSONSerializer"><a class="viewcode-back" href="../../flask/flask.html#flask.app.TaggedJSONSerializer">[docs]</a><span class="k">class</span> <span class="nc">TaggedJSONSerializer</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;A customized JSON serializer that supports a few extra types that</span>
-<span class="sd">    we take for granted when serializing (tuples, markup objects, datetime).</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-<div class="viewcode-block" id="TaggedJSONSerializer.dumps"><a class="viewcode-back" href="../../flask/flask.html#flask.app.TaggedJSONSerializer.dumps">[docs]</a>    <span class="k">def</span> <span class="nf">dumps</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">_tag</span><span class="p">(</span><span class="n">value</span><span class="p">),</span> <span class="n">separators</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="s1">&#39;:&#39;</span><span class="p">))</span></div>
-
-<div class="viewcode-block" id="TaggedJSONSerializer.loads"><a class="viewcode-back" href="../../flask/flask.html#flask.app.TaggedJSONSerializer.loads">[docs]</a>    <span class="k">def</span> <span class="nf">loads</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">object_hook</span><span class="p">(</span><span class="n">obj</span><span class="p">):</span>
-            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">obj</span>
-            <span class="n">the_key</span><span class="p">,</span> <span class="n">the_value</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="n">obj</span><span class="p">))</span>
-            <span class="k">if</span> <span class="n">the_key</span> <span class="o">==</span> <span class="s1">&#39; t&#39;</span><span class="p">:</span>
-                <span class="k">return</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">the_value</span><span class="p">)</span>
-            <span class="k">elif</span> <span class="n">the_key</span> <span class="o">==</span> <span class="s1">&#39; u&#39;</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">(</span><span class="n">the_value</span><span class="p">)</span>
-            <span class="k">elif</span> <span class="n">the_key</span> <span class="o">==</span> <span class="s1">&#39; b&#39;</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">b64decode</span><span class="p">(</span><span class="n">the_value</span><span class="p">)</span>
-            <span class="k">elif</span> <span class="n">the_key</span> <span class="o">==</span> <span class="s1">&#39; m&#39;</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">Markup</span><span class="p">(</span><span class="n">the_value</span><span class="p">)</span>
-            <span class="k">elif</span> <span class="n">the_key</span> <span class="o">==</span> <span class="s1">&#39; d&#39;</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">parse_date</span><span class="p">(</span><span class="n">the_value</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">obj</span>
-        <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">object_hook</span><span class="o">=</span><span class="n">object_hook</span><span class="p">)</span></div></div>
-
-
-<span class="n">session_json_serializer</span> <span class="o">=</span> <span class="n">TaggedJSONSerializer</span><span class="p">()</span>
-
-
-<div class="viewcode-block" id="SecureCookieSession"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SecureCookieSession">[docs]</a><span class="k">class</span> <span class="nc">SecureCookieSession</span><span class="p">(</span><span class="n">CallbackDict</span><span class="p">,</span> <span class="n">SessionMixin</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Base class for sessions based on signed cookies.&quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">initial</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">modified</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="n">CallbackDict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">initial</span><span class="p">,</span> <span class="n">on_update</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">modified</span> <span class="o">=</span> <span class="kc">False</span></div>
-
-
-<div class="viewcode-block" id="NullSession"><a class="viewcode-back" href="../../flask/flask.html#flask.app.NullSession">[docs]</a><span class="k">class</span> <span class="nc">NullSession</span><span class="p">(</span><span class="n">SecureCookieSession</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Class used to generate nicer error messages if sessions are not</span>
-<span class="sd">    available.  Will still allow read-only access to the empty session</span>
-<span class="sd">    but fail on setting.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">_fail</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;The session is unavailable because no secret &#39;</span>
-                           <span class="s1">&#39;key was set.  Set the secret_key on the &#39;</span>
-                           <span class="s1">&#39;application to something unique and secret.&#39;</span><span class="p">)</span>
-    <span class="n">__setitem__</span> <span class="o">=</span> <span class="n">__delitem__</span> <span class="o">=</span> <span class="n">clear</span> <span class="o">=</span> <span class="n">pop</span> <span class="o">=</span> <span class="n">popitem</span> <span class="o">=</span> \
-        <span class="n">update</span> <span class="o">=</span> <span class="n">setdefault</span> <span class="o">=</span> <span class="n">_fail</span>
-    <span class="k">del</span> <span class="n">_fail</span></div>
-
-
-<div class="viewcode-block" id="SessionInterface"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface">[docs]</a><span class="k">class</span> <span class="nc">SessionInterface</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The basic interface you have to implement in order to replace the</span>
-<span class="sd">    default session interface which uses werkzeug&#39;s securecookie</span>
-<span class="sd">    implementation.  The only methods you have to implement are</span>
-<span class="sd">    :meth:`open_session` and :meth:`save_session`, the others have</span>
-<span class="sd">    useful defaults which you don&#39;t need to change.</span>
-
-<span class="sd">    The session object returned by the :meth:`open_session` method has to</span>
-<span class="sd">    provide a dictionary like interface plus the properties and methods</span>
-<span class="sd">    from the :class:`SessionMixin`.  We recommend just subclassing a dict</span>
-<span class="sd">    and adding that mixin::</span>
-
-<span class="sd">        class Session(dict, SessionMixin):</span>
-<span class="sd">            pass</span>
-
-<span class="sd">    If :meth:`open_session` returns ``None`` Flask will call into</span>
-<span class="sd">    :meth:`make_null_session` to create a session that acts as replacement</span>
-<span class="sd">    if the session support cannot work because some requirement is not</span>
-<span class="sd">    fulfilled.  The default :class:`NullSession` class that is created</span>
-<span class="sd">    will complain that the secret key was not set.</span>
-
-<span class="sd">    To replace the session interface on an application all you have to do</span>
-<span class="sd">    is to assign :attr:`flask.Flask.session_interface`::</span>
-
-<span class="sd">        app = Flask(__name__)</span>
-<span class="sd">        app.session_interface = MySessionInterface()</span>
-
-<span class="sd">    .. versionadded:: 0.8</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="c1">#: :meth:`make_null_session` will look here for the class that should</span>
-    <span class="c1">#: be created when a null session is requested.  Likewise the</span>
-    <span class="c1">#: :meth:`is_null_session` method will perform a typecheck against</span>
-    <span class="c1">#: this type.</span>
-    <span class="n">null_session_class</span> <span class="o">=</span> <span class="n">NullSession</span>
-
-    <span class="c1">#: A flag that indicates if the session interface is pickle based.</span>
-    <span class="c1">#: This can be used by flask extensions to make a decision in regards</span>
-    <span class="c1">#: to how to deal with the session object.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.10</span>
-    <span class="n">pickle_based</span> <span class="o">=</span> <span class="kc">False</span>
-
-<div class="viewcode-block" id="SessionInterface.make_null_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.make_null_session">[docs]</a>    <span class="k">def</span> <span class="nf">make_null_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a null session which acts as a replacement object if the</span>
-<span class="sd">        real session support could not be loaded due to a configuration</span>
-<span class="sd">        error.  This mainly aids the user experience because the job of the</span>
-<span class="sd">        null session is to still support lookup without complaining but</span>
-<span class="sd">        modifications are answered with a helpful error message of what</span>
-<span class="sd">        failed.</span>
-
-<span class="sd">        This creates an instance of :attr:`null_session_class` by default.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">null_session_class</span><span class="p">()</span></div>
-
-<div class="viewcode-block" id="SessionInterface.is_null_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.is_null_session">[docs]</a>    <span class="k">def</span> <span class="nf">is_null_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Checks if a given object is a null session.  Null sessions are</span>
-<span class="sd">        not asked to be saved.</span>
-
-<span class="sd">        This checks if the object is an instance of :attr:`null_session_class`</span>
-<span class="sd">        by default.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">null_session_class</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="SessionInterface.get_cookie_domain"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.get_cookie_domain">[docs]</a>    <span class="k">def</span> <span class="nf">get_cookie_domain</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Helpful helper method that returns the cookie domain that should</span>
-<span class="sd">        be used for the session cookie if session cookies are used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SESSION_COOKIE_DOMAIN&#39;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SESSION_COOKIE_DOMAIN&#39;</span><span class="p">]</span>
-        <span class="k">if</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="c1"># chop off the port which is usually not supported by browsers</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="s1">&#39;.&#39;</span> <span class="o">+</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s1">&#39;:&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-
-            <span class="c1"># Google chrome does not like cookies set to .localhost, so</span>
-            <span class="c1"># we just go with no domain then.  Flask documents anyways that</span>
-            <span class="c1"># cross domain cookies need a fully qualified domain name</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="o">==</span> <span class="s1">&#39;.localhost&#39;</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="kc">None</span>
-
-            <span class="c1"># If we infer the cookie domain from the server name we need</span>
-            <span class="c1"># to check if we are in a subpath.  In that case we can&#39;t</span>
-            <span class="c1"># set a cross domain cookie.</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cookie_path</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">path</span> <span class="o">!=</span> <span class="s1">&#39;/&#39;</span><span class="p">:</span>
-                    <span class="n">rv</span> <span class="o">=</span> <span class="n">rv</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">)</span>
-
-            <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="SessionInterface.get_cookie_path"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.get_cookie_path">[docs]</a>    <span class="k">def</span> <span class="nf">get_cookie_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the path for which the cookie should be valid.  The</span>
-<span class="sd">        default implementation uses the value from the ``SESSION_COOKIE_PATH``</span>
-<span class="sd">        config var if it&#39;s set, and falls back to ``APPLICATION_ROOT`` or</span>
-<span class="sd">        uses ``/`` if it&#39;s ``None``.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SESSION_COOKIE_PATH&#39;</span><span class="p">]</span> <span class="ow">or</span> \
-               <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;APPLICATION_ROOT&#39;</span><span class="p">]</span> <span class="ow">or</span> <span class="s1">&#39;/&#39;</span></div>
-
-<div class="viewcode-block" id="SessionInterface.get_cookie_httponly"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.get_cookie_httponly">[docs]</a>    <span class="k">def</span> <span class="nf">get_cookie_httponly</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns True if the session cookie should be httponly.  This</span>
-<span class="sd">        currently just returns the value of the ``SESSION_COOKIE_HTTPONLY``</span>
-<span class="sd">        config var.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SESSION_COOKIE_HTTPONLY&#39;</span><span class="p">]</span></div>
-
-<div class="viewcode-block" id="SessionInterface.get_cookie_secure"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.get_cookie_secure">[docs]</a>    <span class="k">def</span> <span class="nf">get_cookie_secure</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns True if the cookie should be secure.  This currently</span>
-<span class="sd">        just returns the value of the ``SESSION_COOKIE_SECURE`` setting.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SESSION_COOKIE_SECURE&#39;</span><span class="p">]</span></div>
-
-<div class="viewcode-block" id="SessionInterface.get_expiration_time"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.get_expiration_time">[docs]</a>    <span class="k">def</span> <span class="nf">get_expiration_time</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">session</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A helper method that returns an expiration date for the session</span>
-<span class="sd">        or ``None`` if the session is linked to the browser session.  The</span>
-<span class="sd">        default implementation returns now + the permanent session</span>
-<span class="sd">        lifetime configured on the application.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">session</span><span class="o">.</span><span class="n">permanent</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">datetime</span><span class="o">.</span><span class="n">utcnow</span><span class="p">()</span> <span class="o">+</span> <span class="n">app</span><span class="o">.</span><span class="n">permanent_session_lifetime</span></div>
-
-<div class="viewcode-block" id="SessionInterface.should_set_cookie"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.should_set_cookie">[docs]</a>    <span class="k">def</span> <span class="nf">should_set_cookie</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">session</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Indicates whether a cookie should be set now or not.  This is</span>
-<span class="sd">        used by session backends to figure out if they should emit a</span>
-<span class="sd">        set-cookie header or not.  The default behavior is controlled by</span>
-<span class="sd">        the ``SESSION_REFRESH_EACH_REQUEST`` config variable.  If</span>
-<span class="sd">        it&#39;s set to ``False`` then a cookie is only set if the session is</span>
-<span class="sd">        modified, if set to ``True`` it&#39;s always set if the session is</span>
-<span class="sd">        permanent.</span>
-
-<span class="sd">        This check is usually skipped if sessions get deleted.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">session</span><span class="o">.</span><span class="n">modified</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="n">save_each</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;SESSION_REFRESH_EACH_REQUEST&#39;</span><span class="p">]</span>
-        <span class="k">return</span> <span class="n">save_each</span> <span class="ow">and</span> <span class="n">session</span><span class="o">.</span><span class="n">permanent</span></div>
-
-<div class="viewcode-block" id="SessionInterface.open_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.open_session">[docs]</a>    <span class="k">def</span> <span class="nf">open_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This method has to be implemented and must either return ``None``</span>
-<span class="sd">        in case the loading failed because of a configuration error or an</span>
-<span class="sd">        instance of a session object which implements a dictionary like</span>
-<span class="sd">        interface + the methods and attributes on :class:`SessionMixin`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
-
-<div class="viewcode-block" id="SessionInterface.save_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SessionInterface.save_session">[docs]</a>    <span class="k">def</span> <span class="nf">save_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">session</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This is called for actual sessions returned by :meth:`open_session`</span>
-<span class="sd">        at the end of the request.  This is still called during a request</span>
-<span class="sd">        context so if you absolutely need access to the request you can do</span>
-<span class="sd">        that.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div></div>
-
-
-<div class="viewcode-block" id="SecureCookieSessionInterface"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SecureCookieSessionInterface">[docs]</a><span class="k">class</span> <span class="nc">SecureCookieSessionInterface</span><span class="p">(</span><span class="n">SessionInterface</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The default session interface that stores sessions in signed cookies</span>
-<span class="sd">    through the :mod:`itsdangerous` module.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="c1">#: the salt that should be applied on top of the secret key for the</span>
-    <span class="c1">#: signing of cookie based sessions.</span>
-    <span class="n">salt</span> <span class="o">=</span> <span class="s1">&#39;cookie-session&#39;</span>
-    <span class="c1">#: the hash function to use for the signature.  The default is sha1</span>
-    <span class="n">digest_method</span> <span class="o">=</span> <span class="nb">staticmethod</span><span class="p">(</span><span class="n">hashlib</span><span class="o">.</span><span class="n">sha1</span><span class="p">)</span>
-    <span class="c1">#: the name of the itsdangerous supported key derivation.  The default</span>
-    <span class="c1">#: is hmac.</span>
-    <span class="n">key_derivation</span> <span class="o">=</span> <span class="s1">&#39;hmac&#39;</span>
-    <span class="c1">#: A python serializer for the payload.  The default is a compact</span>
-    <span class="c1">#: JSON derived serializer with support for some extra Python types</span>
-    <span class="c1">#: such as datetime objects or tuples.</span>
-    <span class="n">serializer</span> <span class="o">=</span> <span class="n">session_json_serializer</span>
-    <span class="n">session_class</span> <span class="o">=</span> <span class="n">SecureCookieSession</span>
-
-<div class="viewcode-block" id="SecureCookieSessionInterface.get_signing_serializer"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SecureCookieSessionInterface.get_signing_serializer">[docs]</a>    <span class="k">def</span> <span class="nf">get_signing_serializer</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">app</span><span class="o">.</span><span class="n">secret_key</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">None</span>
-        <span class="n">signer_kwargs</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span>
-            <span class="n">key_derivation</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">key_derivation</span><span class="p">,</span>
-            <span class="n">digest_method</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">digest_method</span>
-        <span class="p">)</span>
-        <span class="k">return</span> <span class="n">URLSafeTimedSerializer</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">secret_key</span><span class="p">,</span> <span class="n">salt</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">salt</span><span class="p">,</span>
-                                      <span class="n">serializer</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">serializer</span><span class="p">,</span>
-                                      <span class="n">signer_kwargs</span><span class="o">=</span><span class="n">signer_kwargs</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="SecureCookieSessionInterface.open_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SecureCookieSessionInterface.open_session">[docs]</a>    <span class="k">def</span> <span class="nf">open_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">request</span><span class="p">):</span>
-        <span class="n">s</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_signing_serializer</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">s</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">None</span>
-        <span class="n">val</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">cookies</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">session_cookie_name</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">val</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_class</span><span class="p">()</span>
-        <span class="n">max_age</span> <span class="o">=</span> <span class="n">total_seconds</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">permanent_session_lifetime</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">data</span> <span class="o">=</span> <span class="n">s</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="n">max_age</span><span class="o">=</span><span class="n">max_age</span><span class="p">)</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_class</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
-        <span class="k">except</span> <span class="n">BadSignature</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">session_class</span><span class="p">()</span></div>
-
-<div class="viewcode-block" id="SecureCookieSessionInterface.save_session"><a class="viewcode-back" href="../../flask/flask.html#flask.app.SecureCookieSessionInterface.save_session">[docs]</a>    <span class="k">def</span> <span class="nf">save_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">session</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
-        <span class="n">domain</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cookie_domain</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-        <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cookie_path</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-
-        <span class="c1"># Delete case.  If there is no session we bail early.</span>
-        <span class="c1"># If the session was modified to be empty we remove the</span>
-        <span class="c1"># whole cookie.</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">session</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">session</span><span class="o">.</span><span class="n">modified</span><span class="p">:</span>
-                <span class="n">response</span><span class="o">.</span><span class="n">delete_cookie</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">session_cookie_name</span><span class="p">,</span>
-                                       <span class="n">domain</span><span class="o">=</span><span class="n">domain</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="n">path</span><span class="p">)</span>
-            <span class="k">return</span>
-
-        <span class="c1"># Modification case.  There are upsides and downsides to</span>
-        <span class="c1"># emitting a set-cookie header each request.  The behavior</span>
-        <span class="c1"># is controlled by the :meth:`should_set_cookie` method</span>
-        <span class="c1"># which performs a quick check to figure out if the cookie</span>
-        <span class="c1"># should be set or not.  This is controlled by the</span>
-        <span class="c1"># SESSION_REFRESH_EACH_REQUEST config flag as well as</span>
-        <span class="c1"># the permanent flag on the session itself.</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">should_set_cookie</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">session</span><span class="p">):</span>
-            <span class="k">return</span>
-
-        <span class="n">httponly</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cookie_httponly</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-        <span class="n">secure</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cookie_secure</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-        <span class="n">expires</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_expiration_time</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">session</span><span class="p">)</span>
-        <span class="n">val</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_signing_serializer</span><span class="p">(</span><span class="n">app</span><span class="p">)</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="nb">dict</span><span class="p">(</span><span class="n">session</span><span class="p">))</span>
-        <span class="n">response</span><span class="o">.</span><span class="n">set_cookie</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">session_cookie_name</span><span class="p">,</span> <span class="n">val</span><span class="p">,</span>
-                            <span class="n">expires</span><span class="o">=</span><span class="n">expires</span><span class="p">,</span> <span class="n">httponly</span><span class="o">=</span><span class="n">httponly</span><span class="p">,</span>
-                            <span class="n">domain</span><span class="o">=</span><span class="n">domain</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="n">path</span><span class="p">,</span> <span class="n">secure</span><span class="o">=</span><span class="n">secure</span><span class="p">)</span></div></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/signals.html

@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.signals &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.signals</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.signals</span>
-<span class="sd">    ~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements signals based on blinker if available, otherwise</span>
-<span class="sd">    falls silently back to a noop.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="n">signals_available</span> <span class="o">=</span> <span class="kc">False</span>
-<span class="k">try</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">blinker</span> <span class="k">import</span> <span class="n">Namespace</span>
-    <span class="n">signals_available</span> <span class="o">=</span> <span class="kc">True</span>
-<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-<div class="viewcode-block" id="Namespace"><a class="viewcode-back" href="../../flask/flask.html#flask.signals.Namespace">[docs]</a>    <span class="k">class</span> <span class="nc">Namespace</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-<div class="viewcode-block" id="Namespace.signal"><a class="viewcode-back" href="../../flask/flask.html#flask.signals.Namespace.signal">[docs]</a>        <span class="k">def</span> <span class="nf">signal</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">_FakeSignal</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">doc</span><span class="p">)</span></div></div>
-
-    <span class="k">class</span> <span class="nc">_FakeSignal</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;If blinker is unavailable, create a fake class with the same</span>
-<span class="sd">        interface that allows sending of signals but will fail with an</span>
-<span class="sd">        error on anything else.  Instead of doing anything on send, it</span>
-<span class="sd">        will just ignore the arguments and do nothing instead.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-
-        <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__doc__</span> <span class="o">=</span> <span class="n">doc</span>
-        <span class="k">def</span> <span class="nf">_fail</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;signalling support is unavailable &#39;</span>
-                               <span class="s1">&#39;because the blinker library is &#39;</span>
-                               <span class="s1">&#39;not installed.&#39;</span><span class="p">)</span>
-        <span class="n">send</span> <span class="o">=</span> <span class="k">lambda</span> <span class="o">*</span><span class="n">a</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">:</span> <span class="kc">None</span>
-        <span class="n">connect</span> <span class="o">=</span> <span class="n">disconnect</span> <span class="o">=</span> <span class="n">has_receivers_for</span> <span class="o">=</span> <span class="n">receivers_for</span> <span class="o">=</span> \
-            <span class="n">temporarily_connected_to</span> <span class="o">=</span> <span class="n">connected_to</span> <span class="o">=</span> <span class="n">_fail</span>
-        <span class="k">del</span> <span class="n">_fail</span>
-
-<span class="c1"># The namespace for code signals.  If you are not flask code, do</span>
-<span class="c1"># not put signals in here.  Create your own namespace instead.</span>
-<span class="n">_signals</span> <span class="o">=</span> <span class="n">Namespace</span><span class="p">()</span>
-
-
-<span class="c1"># Core signals.  For usage examples grep the source code or consult</span>
-<span class="c1"># the API documentation in docs/api.rst as well as docs/signals.rst</span>
-<span class="n">template_rendered</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;template-rendered&#39;</span><span class="p">)</span>
-<span class="n">before_render_template</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;before-render-template&#39;</span><span class="p">)</span>
-<span class="n">request_started</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;request-started&#39;</span><span class="p">)</span>
-<span class="n">request_finished</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;request-finished&#39;</span><span class="p">)</span>
-<span class="n">request_tearing_down</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;request-tearing-down&#39;</span><span class="p">)</span>
-<span class="n">got_request_exception</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;got-request-exception&#39;</span><span class="p">)</span>
-<span class="n">appcontext_tearing_down</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;appcontext-tearing-down&#39;</span><span class="p">)</span>
-<span class="n">appcontext_pushed</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;appcontext-pushed&#39;</span><span class="p">)</span>
-<span class="n">appcontext_popped</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;appcontext-popped&#39;</span><span class="p">)</span>
-<span class="n">message_flashed</span> <span class="o">=</span> <span class="n">_signals</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="s1">&#39;message-flashed&#39;</span><span class="p">)</span>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/templating.html

@@ -1,237 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.templating &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.templating</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.templating</span>
-<span class="sd">    ~~~~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements the bridge to Jinja2.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">from</span> <span class="nn">jinja2</span> <span class="k">import</span> <span class="n">BaseLoader</span><span class="p">,</span> <span class="n">Environment</span> <span class="k">as</span> <span class="n">BaseEnvironment</span><span class="p">,</span> \
-     <span class="n">TemplateNotFound</span>
-
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span><span class="p">,</span> <span class="n">_app_ctx_stack</span>
-<span class="kn">from</span> <span class="nn">.signals</span> <span class="k">import</span> <span class="n">template_rendered</span><span class="p">,</span> <span class="n">before_render_template</span>
-
-
-<span class="k">def</span> <span class="nf">_default_template_ctx_processor</span><span class="p">():</span>
-    <span class="sd">&quot;&quot;&quot;Default template context processor.  Injects `request`,</span>
-<span class="sd">    `session` and `g`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">reqctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="n">appctx</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="n">rv</span> <span class="o">=</span> <span class="p">{}</span>
-    <span class="k">if</span> <span class="n">appctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">rv</span><span class="p">[</span><span class="s1">&#39;g&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">appctx</span><span class="o">.</span><span class="n">g</span>
-    <span class="k">if</span> <span class="n">reqctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">rv</span><span class="p">[</span><span class="s1">&#39;request&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">request</span>
-        <span class="n">rv</span><span class="p">[</span><span class="s1">&#39;session&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">reqctx</span><span class="o">.</span><span class="n">session</span>
-    <span class="k">return</span> <span class="n">rv</span>
-
-
-<div class="viewcode-block" id="Environment"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Environment">[docs]</a><span class="k">class</span> <span class="nc">Environment</span><span class="p">(</span><span class="n">BaseEnvironment</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Works like a regular Jinja2 environment but has some additional</span>
-<span class="sd">    knowledge of how Flask&#39;s blueprint works so that it can prepend the</span>
-<span class="sd">    name of the blueprint to referenced templates if necessary.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">):</span>
-        <span class="k">if</span> <span class="s1">&#39;loader&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">options</span><span class="p">:</span>
-            <span class="n">options</span><span class="p">[</span><span class="s1">&#39;loader&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">create_global_jinja_loader</span><span class="p">()</span>
-        <span class="n">BaseEnvironment</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">options</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app</span> <span class="o">=</span> <span class="n">app</span></div>
-
-
-<div class="viewcode-block" id="DispatchingJinjaLoader"><a class="viewcode-back" href="../../flask/flask.html#flask.app.DispatchingJinjaLoader">[docs]</a><span class="k">class</span> <span class="nc">DispatchingJinjaLoader</span><span class="p">(</span><span class="n">BaseLoader</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;A loader that looks for templates in the application and all</span>
-<span class="sd">    the blueprint folders.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">app</span> <span class="o">=</span> <span class="n">app</span>
-
-<div class="viewcode-block" id="DispatchingJinjaLoader.get_source"><a class="viewcode-back" href="../../flask/flask.html#flask.app.DispatchingJinjaLoader.get_source">[docs]</a>    <span class="k">def</span> <span class="nf">get_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;EXPLAIN_TEMPLATE_LOADING&#39;</span><span class="p">]:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_source_explained</span><span class="p">(</span><span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_source_fast</span><span class="p">(</span><span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">)</span></div>
-
-    <span class="k">def</span> <span class="nf">_get_source_explained</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">):</span>
-        <span class="n">attempts</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="n">trv</span> <span class="o">=</span> <span class="kc">None</span>
-
-        <span class="k">for</span> <span class="n">srcobj</span><span class="p">,</span> <span class="n">loader</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_iter_loaders</span><span class="p">(</span><span class="n">template</span><span class="p">):</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">get_source</span><span class="p">(</span><span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">trv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">trv</span> <span class="o">=</span> <span class="n">rv</span>
-            <span class="k">except</span> <span class="n">TemplateNotFound</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="n">attempts</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">loader</span><span class="p">,</span> <span class="n">srcobj</span><span class="p">,</span> <span class="n">rv</span><span class="p">))</span>
-
-        <span class="kn">from</span> <span class="nn">.debughelpers</span> <span class="k">import</span> <span class="n">explain_template_loading_attempts</span>
-        <span class="n">explain_template_loading_attempts</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="p">,</span> <span class="n">template</span><span class="p">,</span> <span class="n">attempts</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">trv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">trv</span>
-        <span class="k">raise</span> <span class="n">TemplateNotFound</span><span class="p">(</span><span class="n">template</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_get_source_fast</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">srcobj</span><span class="p">,</span> <span class="n">loader</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_iter_loaders</span><span class="p">(</span><span class="n">template</span><span class="p">):</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">loader</span><span class="o">.</span><span class="n">get_source</span><span class="p">(</span><span class="n">environment</span><span class="p">,</span> <span class="n">template</span><span class="p">)</span>
-            <span class="k">except</span> <span class="n">TemplateNotFound</span><span class="p">:</span>
-                <span class="k">continue</span>
-        <span class="k">raise</span> <span class="n">TemplateNotFound</span><span class="p">(</span><span class="n">template</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_iter_loaders</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">template</span><span class="p">):</span>
-        <span class="n">loader</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_loader</span>
-        <span class="k">if</span> <span class="n">loader</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="p">,</span> <span class="n">loader</span>
-
-        <span class="k">for</span> <span class="n">blueprint</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">iter_blueprints</span><span class="p">():</span>
-            <span class="n">loader</span> <span class="o">=</span> <span class="n">blueprint</span><span class="o">.</span><span class="n">jinja_loader</span>
-            <span class="k">if</span> <span class="n">loader</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="n">blueprint</span><span class="p">,</span> <span class="n">loader</span>
-
-<div class="viewcode-block" id="DispatchingJinjaLoader.list_templates"><a class="viewcode-back" href="../../flask/flask.html#flask.app.DispatchingJinjaLoader.list_templates">[docs]</a>    <span class="k">def</span> <span class="nf">list_templates</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="n">loader</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_loader</span>
-        <span class="k">if</span> <span class="n">loader</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">result</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">loader</span><span class="o">.</span><span class="n">list_templates</span><span class="p">())</span>
-
-        <span class="k">for</span> <span class="n">blueprint</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">iter_blueprints</span><span class="p">():</span>
-            <span class="n">loader</span> <span class="o">=</span> <span class="n">blueprint</span><span class="o">.</span><span class="n">jinja_loader</span>
-            <span class="k">if</span> <span class="n">loader</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">for</span> <span class="n">template</span> <span class="ow">in</span> <span class="n">loader</span><span class="o">.</span><span class="n">list_templates</span><span class="p">():</span>
-                    <span class="n">result</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">template</span><span class="p">)</span>
-
-        <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">result</span><span class="p">)</span></div></div>
-
-
-<span class="k">def</span> <span class="nf">_render</span><span class="p">(</span><span class="n">template</span><span class="p">,</span> <span class="n">context</span><span class="p">,</span> <span class="n">app</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Renders the template and fires the signal&quot;&quot;&quot;</span>
-
-    <span class="n">before_render_template</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">template</span><span class="o">=</span><span class="n">template</span><span class="p">,</span> <span class="n">context</span><span class="o">=</span><span class="n">context</span><span class="p">)</span>
-    <span class="n">rv</span> <span class="o">=</span> <span class="n">template</span><span class="o">.</span><span class="n">render</span><span class="p">(</span><span class="n">context</span><span class="p">)</span>
-    <span class="n">template_rendered</span><span class="o">.</span><span class="n">send</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">template</span><span class="o">=</span><span class="n">template</span><span class="p">,</span> <span class="n">context</span><span class="o">=</span><span class="n">context</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">rv</span>
-
-
-<div class="viewcode-block" id="render_template"><a class="viewcode-back" href="../../flask/flask.html#flask.app.render_template">[docs]</a><span class="k">def</span> <span class="nf">render_template</span><span class="p">(</span><span class="n">template_name_or_list</span><span class="p">,</span> <span class="o">**</span><span class="n">context</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Renders a template from the template folder with the given</span>
-<span class="sd">    context.</span>
-
-<span class="sd">    :param template_name_or_list: the name of the template to be</span>
-<span class="sd">                                  rendered, or an iterable with template names</span>
-<span class="sd">                                  the first one existing will be rendered</span>
-<span class="sd">    :param context: the variables that should be available in the</span>
-<span class="sd">                    context of the template.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">ctx</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">update_template_context</span><span class="p">(</span><span class="n">context</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">_render</span><span class="p">(</span><span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">get_or_select_template</span><span class="p">(</span><span class="n">template_name_or_list</span><span class="p">),</span>
-                   <span class="n">context</span><span class="p">,</span> <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="render_template_string"><a class="viewcode-back" href="../../flask/flask.html#flask.app.render_template_string">[docs]</a><span class="k">def</span> <span class="nf">render_template_string</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="o">**</span><span class="n">context</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Renders a template from the given template source string</span>
-<span class="sd">    with the given context. Template variables will be autoescaped.</span>
-
-<span class="sd">    :param source: the source code of the template to be</span>
-<span class="sd">                   rendered</span>
-<span class="sd">    :param context: the variables that should be available in the</span>
-<span class="sd">                    context of the template.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">ctx</span> <span class="o">=</span> <span class="n">_app_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-    <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">update_template_context</span><span class="p">(</span><span class="n">context</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">_render</span><span class="p">(</span><span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">jinja_env</span><span class="o">.</span><span class="n">from_string</span><span class="p">(</span><span class="n">source</span><span class="p">),</span>
-                   <span class="n">context</span><span class="p">,</span> <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="p">)</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/testing.html

@@ -1,217 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.testing &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.testing</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.testing</span>
-<span class="sd">    ~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements test support helpers.  This module is lazily imported</span>
-<span class="sd">    and usually not used in production environments.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">from</span> <span class="nn">contextlib</span> <span class="k">import</span> <span class="n">contextmanager</span>
-<span class="kn">from</span> <span class="nn">werkzeug.test</span> <span class="k">import</span> <span class="n">Client</span><span class="p">,</span> <span class="n">EnvironBuilder</span>
-<span class="kn">from</span> <span class="nn">flask</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span>
-
-<span class="k">try</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">werkzeug.urls</span> <span class="k">import</span> <span class="n">url_parse</span>
-<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-    <span class="kn">from</span> <span class="nn">urlparse</span> <span class="k">import</span> <span class="n">urlsplit</span> <span class="k">as</span> <span class="n">url_parse</span>
-
-
-<div class="viewcode-block" id="make_test_environ_builder"><a class="viewcode-back" href="../../flask/flask.html#flask.testing.make_test_environ_builder">[docs]</a><span class="k">def</span> <span class="nf">make_test_environ_builder</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="s1">&#39;/&#39;</span><span class="p">,</span> <span class="n">base_url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Creates a new test builder with some application defaults thrown in.&quot;&quot;&quot;</span>
-    <span class="n">http_host</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">)</span>
-    <span class="n">app_root</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;APPLICATION_ROOT&#39;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">base_url</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">url</span> <span class="o">=</span> <span class="n">url_parse</span><span class="p">(</span><span class="n">path</span><span class="p">)</span>
-        <span class="n">base_url</span> <span class="o">=</span> <span class="s1">&#39;http://</span><span class="si">%s</span><span class="s1">/&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">url</span><span class="o">.</span><span class="n">netloc</span> <span class="ow">or</span> <span class="n">http_host</span> <span class="ow">or</span> <span class="s1">&#39;localhost&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">app_root</span><span class="p">:</span>
-            <span class="n">base_url</span> <span class="o">+=</span> <span class="n">app_root</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">url</span><span class="o">.</span><span class="n">netloc</span><span class="p">:</span>
-            <span class="n">path</span> <span class="o">=</span> <span class="n">url</span><span class="o">.</span><span class="n">path</span>
-            <span class="k">if</span> <span class="n">url</span><span class="o">.</span><span class="n">query</span><span class="p">:</span>
-                <span class="n">path</span> <span class="o">+=</span> <span class="s1">&#39;?&#39;</span> <span class="o">+</span> <span class="n">url</span><span class="o">.</span><span class="n">query</span>
-    <span class="k">return</span> <span class="n">EnvironBuilder</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">base_url</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="FlaskClient"><a class="viewcode-back" href="../../flask/flask.html#flask.testing.FlaskClient">[docs]</a><span class="k">class</span> <span class="nc">FlaskClient</span><span class="p">(</span><span class="n">Client</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Works like a regular Werkzeug test client but has some knowledge about</span>
-<span class="sd">    how Flask works to defer the cleanup of the request context stack to the</span>
-<span class="sd">    end of a ``with`` body when used in a ``with`` statement.  For general</span>
-<span class="sd">    information about how to use this class refer to</span>
-<span class="sd">    :class:`werkzeug.test.Client`.</span>
-
-<span class="sd">    Basic usage is outlined in the :ref:`testing` chapter.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">preserve_context</span> <span class="o">=</span> <span class="kc">False</span>
-
-    <span class="nd">@contextmanager</span>
-<div class="viewcode-block" id="FlaskClient.session_transaction"><a class="viewcode-back" href="../../flask/flask.html#flask.testing.FlaskClient.session_transaction">[docs]</a>    <span class="k">def</span> <span class="nf">session_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;When used in combination with a ``with`` statement this opens a</span>
-<span class="sd">        session transaction.  This can be used to modify the session that</span>
-<span class="sd">        the test client uses.  Once the ``with`` block is left the session is</span>
-<span class="sd">        stored back.</span>
-
-<span class="sd">        ::</span>
-
-<span class="sd">            with client.session_transaction() as session:</span>
-<span class="sd">                session[&#39;value&#39;] = 42</span>
-
-<span class="sd">        Internally this is implemented by going through a temporary test</span>
-<span class="sd">        request context and since session handling could depend on</span>
-<span class="sd">        request variables this function accepts the same arguments as</span>
-<span class="sd">        :meth:`~flask.Flask.test_request_context` which are directly</span>
-<span class="sd">        passed through.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">cookie_jar</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Session transactions only make sense &#39;</span>
-                               <span class="s1">&#39;with cookies enabled.&#39;</span><span class="p">)</span>
-        <span class="n">app</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">application</span>
-        <span class="n">environ_overrides</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;environ_overrides&#39;</span><span class="p">,</span> <span class="p">{})</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">cookie_jar</span><span class="o">.</span><span class="n">inject_wsgi</span><span class="p">(</span><span class="n">environ_overrides</span><span class="p">)</span>
-        <span class="n">outer_reqctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">with</span> <span class="n">app</span><span class="o">.</span><span class="n">test_request_context</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="k">as</span> <span class="n">c</span><span class="p">:</span>
-            <span class="n">sess</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">open_session</span><span class="p">(</span><span class="n">c</span><span class="o">.</span><span class="n">request</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">sess</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Session backend did not open a session. &#39;</span>
-                                   <span class="s1">&#39;Check the configuration&#39;</span><span class="p">)</span>
-
-            <span class="c1"># Since we have to open a new request context for the session</span>
-            <span class="c1"># handling we want to make sure that we hide out own context</span>
-            <span class="c1"># from the caller.  By pushing the original request context</span>
-            <span class="c1"># (or None) on top of this and popping it we get exactly that</span>
-            <span class="c1"># behavior.  It&#39;s important to not use the push and pop</span>
-            <span class="c1"># methods of the actual request context object since that would</span>
-            <span class="c1"># mean that cleanup handlers are called</span>
-            <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">push</span><span class="p">(</span><span class="n">outer_reqctx</span><span class="p">)</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="n">sess</span>
-            <span class="k">finally</span><span class="p">:</span>
-                <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-
-            <span class="n">resp</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">response_class</span><span class="p">()</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">app</span><span class="o">.</span><span class="n">session_interface</span><span class="o">.</span><span class="n">is_null_session</span><span class="p">(</span><span class="n">sess</span><span class="p">):</span>
-                <span class="n">app</span><span class="o">.</span><span class="n">save_session</span><span class="p">(</span><span class="n">sess</span><span class="p">,</span> <span class="n">resp</span><span class="p">)</span>
-            <span class="n">headers</span> <span class="o">=</span> <span class="n">resp</span><span class="o">.</span><span class="n">get_wsgi_headers</span><span class="p">(</span><span class="n">c</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">cookie_jar</span><span class="o">.</span><span class="n">extract_wsgi</span><span class="p">(</span><span class="n">c</span><span class="o">.</span><span class="n">request</span><span class="o">.</span><span class="n">environ</span><span class="p">,</span> <span class="n">headers</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="FlaskClient.open"><a class="viewcode-back" href="../../flask/flask.html#flask.testing.FlaskClient.open">[docs]</a>    <span class="k">def</span> <span class="nf">open</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s1">&#39;environ_overrides&#39;</span><span class="p">,</span> <span class="p">{})</span> \
-            <span class="p">[</span><span class="s1">&#39;flask._preserve_context&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">preserve_context</span>
-
-        <span class="n">as_tuple</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;as_tuple&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
-        <span class="n">buffered</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;buffered&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
-        <span class="n">follow_redirects</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;follow_redirects&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
-        <span class="n">builder</span> <span class="o">=</span> <span class="n">make_test_environ_builder</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">application</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-
-        <span class="k">return</span> <span class="n">Client</span><span class="o">.</span><span class="n">open</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">builder</span><span class="p">,</span>
-                           <span class="n">as_tuple</span><span class="o">=</span><span class="n">as_tuple</span><span class="p">,</span>
-                           <span class="n">buffered</span><span class="o">=</span><span class="n">buffered</span><span class="p">,</span>
-                           <span class="n">follow_redirects</span><span class="o">=</span><span class="n">follow_redirects</span><span class="p">)</span></div>
-
-    <span class="k">def</span> <span class="nf">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">preserve_context</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;Cannot nest client invocations&#39;</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">preserve_context</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-    <span class="k">def</span> <span class="nf">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">preserve_context</span> <span class="o">=</span> <span class="kc">False</span>
-
-        <span class="c1"># on exit we want to clean up earlier.  Normally the request context</span>
-        <span class="c1"># stays preserved until the next request in the same thread comes</span>
-        <span class="c1"># in.  See RequestGlobals.push() for the general behavior.</span>
-        <span class="n">top</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">top</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">top</span><span class="o">.</span><span class="n">preserved</span><span class="p">:</span>
-            <span class="n">top</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/views.html

@@ -1,237 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.views &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.views</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.views</span>
-<span class="sd">    ~~~~~~~~~~~</span>
-
-<span class="sd">    This module provides class-based views inspired by the ones in Django.</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">request</span>
-<span class="kn">from</span> <span class="nn">._compat</span> <span class="k">import</span> <span class="n">with_metaclass</span>
-
-
-<span class="n">http_method_funcs</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s1">&#39;get&#39;</span><span class="p">,</span> <span class="s1">&#39;post&#39;</span><span class="p">,</span> <span class="s1">&#39;head&#39;</span><span class="p">,</span> <span class="s1">&#39;options&#39;</span><span class="p">,</span>
-                               <span class="s1">&#39;delete&#39;</span><span class="p">,</span> <span class="s1">&#39;put&#39;</span><span class="p">,</span> <span class="s1">&#39;trace&#39;</span><span class="p">,</span> <span class="s1">&#39;patch&#39;</span><span class="p">])</span>
-
-
-<div class="viewcode-block" id="View"><a class="viewcode-back" href="../../flask/flask.html#flask.views.View">[docs]</a><span class="k">class</span> <span class="nc">View</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Alternative way to use view functions.  A subclass has to implement</span>
-<span class="sd">    :meth:`dispatch_request` which is called with the view arguments from</span>
-<span class="sd">    the URL routing system.  If :attr:`methods` is provided the methods</span>
-<span class="sd">    do not have to be passed to the :meth:`~flask.Flask.add_url_rule`</span>
-<span class="sd">    method explicitly::</span>
-
-<span class="sd">        class MyView(View):</span>
-<span class="sd">            methods = [&#39;GET&#39;]</span>
-
-<span class="sd">            def dispatch_request(self, name):</span>
-<span class="sd">                return &#39;Hello %s!&#39; % name</span>
-
-<span class="sd">        app.add_url_rule(&#39;/hello/&lt;name&gt;&#39;, view_func=MyView.as_view(&#39;myview&#39;))</span>
-
-<span class="sd">    When you want to decorate a pluggable view you will have to either do that</span>
-<span class="sd">    when the view function is created (by wrapping the return value of</span>
-<span class="sd">    :meth:`as_view`) or you can use the :attr:`decorators` attribute::</span>
-
-<span class="sd">        class SecretView(View):</span>
-<span class="sd">            methods = [&#39;GET&#39;]</span>
-<span class="sd">            decorators = [superuser_required]</span>
-
-<span class="sd">            def dispatch_request(self):</span>
-<span class="sd">                ...</span>
-
-<span class="sd">    The decorators stored in the decorators list are applied one after another</span>
-<span class="sd">    when the view function is created.  Note that you can *not* use the class</span>
-<span class="sd">    based decorators since those would decorate the view class and not the</span>
-<span class="sd">    generated view function!</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="c1">#: A list of methods this view can handle.</span>
-    <span class="n">methods</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="c1">#: The canonical way to decorate class-based views is to decorate the</span>
-    <span class="c1">#: return value of as_view().  However since this moves parts of the</span>
-    <span class="c1">#: logic from the class declaration to the place where it&#39;s hooked</span>
-    <span class="c1">#: into the routing system.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: You can place one or more decorators in this list and whenever the</span>
-    <span class="c1">#: view function is created the result is automatically decorated.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.8</span>
-    <span class="n">decorators</span> <span class="o">=</span> <span class="p">()</span>
-
-<div class="viewcode-block" id="View.dispatch_request"><a class="viewcode-back" href="../../flask/flask.html#flask.views.View.dispatch_request">[docs]</a>    <span class="k">def</span> <span class="nf">dispatch_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Subclasses have to override this method to implement the</span>
-<span class="sd">        actual view function code.  This method is called with all</span>
-<span class="sd">        the arguments from the URL rule.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
-
-    <span class="nd">@classmethod</span>
-<div class="viewcode-block" id="View.as_view"><a class="viewcode-back" href="../../flask/flask.html#flask.views.View.as_view">[docs]</a>    <span class="k">def</span> <span class="nf">as_view</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="o">*</span><span class="n">class_args</span><span class="p">,</span> <span class="o">**</span><span class="n">class_kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Converts the class into an actual view function that can be used</span>
-<span class="sd">        with the routing system.  Internally this generates a function on the</span>
-<span class="sd">        fly which will instantiate the :class:`View` on each request and call</span>
-<span class="sd">        the :meth:`dispatch_request` method on it.</span>
-
-<span class="sd">        The arguments passed to :meth:`as_view` are forwarded to the</span>
-<span class="sd">        constructor of the class.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">view</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-            <span class="bp">self</span> <span class="o">=</span> <span class="n">view</span><span class="o">.</span><span class="n">view_class</span><span class="p">(</span><span class="o">*</span><span class="n">class_args</span><span class="p">,</span> <span class="o">**</span><span class="n">class_kwargs</span><span class="p">)</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">dispatch_request</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">cls</span><span class="o">.</span><span class="n">decorators</span><span class="p">:</span>
-            <span class="n">view</span><span class="o">.</span><span class="n">__name__</span> <span class="o">=</span> <span class="n">name</span>
-            <span class="n">view</span><span class="o">.</span><span class="n">__module__</span> <span class="o">=</span> <span class="n">cls</span><span class="o">.</span><span class="n">__module__</span>
-            <span class="k">for</span> <span class="n">decorator</span> <span class="ow">in</span> <span class="n">cls</span><span class="o">.</span><span class="n">decorators</span><span class="p">:</span>
-                <span class="n">view</span> <span class="o">=</span> <span class="n">decorator</span><span class="p">(</span><span class="n">view</span><span class="p">)</span>
-
-        <span class="c1"># We attach the view class to the view function for two reasons:</span>
-        <span class="c1"># first of all it allows us to easily figure out what class-based</span>
-        <span class="c1"># view this thing came from, secondly it&#39;s also used for instantiating</span>
-        <span class="c1"># the view class so you can actually replace it with something else</span>
-        <span class="c1"># for testing purposes and debugging.</span>
-        <span class="n">view</span><span class="o">.</span><span class="n">view_class</span> <span class="o">=</span> <span class="n">cls</span>
-        <span class="n">view</span><span class="o">.</span><span class="n">__name__</span> <span class="o">=</span> <span class="n">name</span>
-        <span class="n">view</span><span class="o">.</span><span class="n">__doc__</span> <span class="o">=</span> <span class="n">cls</span><span class="o">.</span><span class="n">__doc__</span>
-        <span class="n">view</span><span class="o">.</span><span class="n">__module__</span> <span class="o">=</span> <span class="n">cls</span><span class="o">.</span><span class="n">__module__</span>
-        <span class="n">view</span><span class="o">.</span><span class="n">methods</span> <span class="o">=</span> <span class="n">cls</span><span class="o">.</span><span class="n">methods</span>
-        <span class="k">return</span> <span class="n">view</span></div></div>
-
-
-<div class="viewcode-block" id="MethodViewType"><a class="viewcode-back" href="../../flask/flask.html#flask.views.MethodViewType">[docs]</a><span class="k">class</span> <span class="nc">MethodViewType</span><span class="p">(</span><span class="nb">type</span><span class="p">):</span>
-
-    <span class="k">def</span> <span class="nf">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">bases</span><span class="p">,</span> <span class="n">d</span><span class="p">):</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="nb">type</span><span class="o">.</span><span class="n">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">bases</span><span class="p">,</span> <span class="n">d</span><span class="p">)</span>
-        <span class="k">if</span> <span class="s1">&#39;methods&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">d</span><span class="p">:</span>
-            <span class="n">methods</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">rv</span><span class="o">.</span><span class="n">methods</span> <span class="ow">or</span> <span class="p">[])</span>
-            <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">d</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">http_method_funcs</span><span class="p">:</span>
-                    <span class="n">methods</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="o">.</span><span class="n">upper</span><span class="p">())</span>
-            <span class="c1"># If we have no method at all in there we don&#39;t want to</span>
-            <span class="c1"># add a method list.  (This is for instance the case for</span>
-            <span class="c1"># the base class or another subclass of a base method view</span>
-            <span class="c1"># that does not introduce new methods).</span>
-            <span class="k">if</span> <span class="n">methods</span><span class="p">:</span>
-                <span class="n">rv</span><span class="o">.</span><span class="n">methods</span> <span class="o">=</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">methods</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-
-<div class="viewcode-block" id="MethodView"><a class="viewcode-back" href="../../flask/flask.html#flask.views.MethodView">[docs]</a><span class="k">class</span> <span class="nc">MethodView</span><span class="p">(</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">MethodViewType</span><span class="p">,</span> <span class="n">View</span><span class="p">)):</span>
-    <span class="sd">&quot;&quot;&quot;Like a regular class-based view but that dispatches requests to</span>
-<span class="sd">    particular methods.  For instance if you implement a method called</span>
-<span class="sd">    :meth:`get` it means you will response to ``&#39;GET&#39;`` requests and</span>
-<span class="sd">    the :meth:`dispatch_request` implementation will automatically</span>
-<span class="sd">    forward your request to that.  Also :attr:`options` is set for you</span>
-<span class="sd">    automatically::</span>
-
-<span class="sd">        class CounterAPI(MethodView):</span>
-
-<span class="sd">            def get(self):</span>
-<span class="sd">                return session.get(&#39;counter&#39;, 0)</span>
-
-<span class="sd">            def post(self):</span>
-<span class="sd">                session[&#39;counter&#39;] = session.get(&#39;counter&#39;, 0) + 1</span>
-<span class="sd">                return &#39;OK&#39;</span>
-
-<span class="sd">        app.add_url_rule(&#39;/counter&#39;, view_func=CounterAPI.as_view(&#39;counter&#39;))</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-<div class="viewcode-block" id="MethodView.dispatch_request"><a class="viewcode-back" href="../../flask/flask.html#flask.views.MethodView.dispatch_request">[docs]</a>    <span class="k">def</span> <span class="nf">dispatch_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="n">meth</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="o">.</span><span class="n">method</span><span class="o">.</span><span class="n">lower</span><span class="p">(),</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="c1"># If the request method is HEAD and we don&#39;t have a handler for it</span>
-        <span class="c1"># retry with GET.</span>
-        <span class="k">if</span> <span class="n">meth</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">request</span><span class="o">.</span><span class="n">method</span> <span class="o">==</span> <span class="s1">&#39;HEAD&#39;</span><span class="p">:</span>
-            <span class="n">meth</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;get&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="k">assert</span> <span class="n">meth</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">,</span> <span class="s1">&#39;Unimplemented method </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">request</span><span class="o">.</span><span class="n">method</span>
-        <span class="k">return</span> <span class="n">meth</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/flask/wrappers.html

@@ -1,292 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.wrappers &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for flask.wrappers</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    flask.wrappers</span>
-<span class="sd">    ~~~~~~~~~~~~~~</span>
-
-<span class="sd">    Implements the WSGI wrappers (request and response).</span>
-
-<span class="sd">    :copyright: (c) 2015 by Armin Ronacher.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.wrappers</span> <span class="k">import</span> <span class="n">Request</span> <span class="k">as</span> <span class="n">RequestBase</span><span class="p">,</span> <span class="n">Response</span> <span class="k">as</span> <span class="n">ResponseBase</span>
-<span class="kn">from</span> <span class="nn">werkzeug.exceptions</span> <span class="k">import</span> <span class="n">BadRequest</span>
-
-<span class="kn">from</span> <span class="nn">.</span> <span class="k">import</span> <span class="n">json</span>
-<span class="kn">from</span> <span class="nn">.globals</span> <span class="k">import</span> <span class="n">_request_ctx_stack</span>
-
-<span class="n">_missing</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span>
-
-
-<span class="k">def</span> <span class="nf">_get_data</span><span class="p">(</span><span class="n">req</span><span class="p">,</span> <span class="n">cache</span><span class="p">):</span>
-    <span class="n">getter</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">req</span><span class="p">,</span> <span class="s1">&#39;get_data&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">getter</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">getter</span><span class="p">(</span><span class="n">cache</span><span class="o">=</span><span class="n">cache</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">req</span><span class="o">.</span><span class="n">data</span>
-
-
-<div class="viewcode-block" id="Request"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Request">[docs]</a><span class="k">class</span> <span class="nc">Request</span><span class="p">(</span><span class="n">RequestBase</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The request object used by default in Flask.  Remembers the</span>
-<span class="sd">    matched endpoint and view arguments.</span>
-
-<span class="sd">    It is what ends up as :class:`~flask.request`.  If you want to replace</span>
-<span class="sd">    the request object used you can subclass this and set</span>
-<span class="sd">    :attr:`~flask.Flask.request_class` to your subclass.</span>
-
-<span class="sd">    The request object is a :class:`~werkzeug.wrappers.Request` subclass and</span>
-<span class="sd">    provides all of the attributes Werkzeug defines plus a few Flask</span>
-<span class="sd">    specific ones.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="c1">#: The internal URL rule that matched the request.  This can be</span>
-    <span class="c1">#: useful to inspect which methods are allowed for the URL from</span>
-    <span class="c1">#: a before/after handler (``request.url_rule.methods``) etc.</span>
-    <span class="c1">#:</span>
-    <span class="c1">#: .. versionadded:: 0.6</span>
-    <span class="n">url_rule</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="c1">#: A dict of view arguments that matched the request.  If an exception</span>
-    <span class="c1">#: happened when matching, this will be ``None``.</span>
-    <span class="n">view_args</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="c1">#: If matching the URL failed, this is the exception that will be</span>
-    <span class="c1">#: raised / was raised as part of the request handling.  This is</span>
-    <span class="c1">#: usually a :exc:`~werkzeug.exceptions.NotFound` exception or</span>
-    <span class="c1">#: something similar.</span>
-    <span class="n">routing_exception</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="c1"># Switched by the request context until 1.0 to opt in deprecated</span>
-    <span class="c1"># module functionality.</span>
-    <span class="n">_is_old_module</span> <span class="o">=</span> <span class="kc">False</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">max_content_length</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Read-only view of the ``MAX_CONTENT_LENGTH`` config key.&quot;&quot;&quot;</span>
-        <span class="n">ctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">ctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;MAX_CONTENT_LENGTH&#39;</span><span class="p">]</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The endpoint that matched the request.  This in combination with</span>
-<span class="sd">        :attr:`view_args` can be used to reconstruct the same or a</span>
-<span class="sd">        modified URL.  If an exception happened when matching, this will</span>
-<span class="sd">        be ``None``.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_rule</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_rule</span><span class="o">.</span><span class="n">endpoint</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">module</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The name of the current module if the request was dispatched</span>
-<span class="sd">        to an actual module.  This is deprecated functionality, use blueprints</span>
-<span class="sd">        instead.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-        <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;modules were deprecated in favor of &#39;</span>
-                                <span class="s1">&#39;blueprints.  Use request.blueprint &#39;</span>
-                                <span class="s1">&#39;instead.&#39;</span><span class="p">),</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_is_old_module</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">blueprint</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">blueprint</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The name of the current blueprint&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_rule</span> <span class="ow">and</span> <span class="s1">&#39;.&#39;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_rule</span><span class="o">.</span><span class="n">endpoint</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;If the mimetype is :mimetype:`application/json` this will contain the</span>
-<span class="sd">        parsed JSON data.  Otherwise this will be ``None``.</span>
-
-<span class="sd">        The :meth:`get_json` method should be used instead.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-        <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;json is deprecated.  &#39;</span>
-                                <span class="s1">&#39;Use get_json() instead.&#39;</span><span class="p">),</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_json</span><span class="p">()</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">is_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Indicates if this request is JSON or not.  By default a request</span>
-<span class="sd">        is considered to include JSON data if the mimetype is</span>
-<span class="sd">        :mimetype:`application/json` or :mimetype:`application/*+json`.</span>
-
-<span class="sd">        .. versionadded:: 0.11</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">mt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">mimetype</span>
-        <span class="k">if</span> <span class="n">mt</span> <span class="o">==</span> <span class="s1">&#39;application/json&#39;</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">if</span> <span class="n">mt</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;application/&#39;</span><span class="p">)</span> <span class="ow">and</span> <span class="n">mt</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">&#39;+json&#39;</span><span class="p">):</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="kc">False</span>
-
-<div class="viewcode-block" id="Request.get_json"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Request.get_json">[docs]</a>    <span class="k">def</span> <span class="nf">get_json</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">force</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">silent</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">cache</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Parses the incoming JSON request data and returns it.  By default</span>
-<span class="sd">        this function will return ``None`` if the mimetype is not</span>
-<span class="sd">        :mimetype:`application/json` but this can be overridden by the</span>
-<span class="sd">        ``force`` parameter. If parsing fails the</span>
-<span class="sd">        :meth:`on_json_loading_failed` method on the request object will be</span>
-<span class="sd">        invoked.</span>
-
-<span class="sd">        :param force: if set to ``True`` the mimetype is ignored.</span>
-<span class="sd">        :param silent: if set to ``True`` this method will fail silently</span>
-<span class="sd">                       and return ``None``.</span>
-<span class="sd">        :param cache: if set to ``True`` the parsed JSON data is remembered</span>
-<span class="sd">                      on the request.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;_cached_json&#39;</span><span class="p">,</span> <span class="n">_missing</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">_missing</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">rv</span>
-
-        <span class="k">if</span> <span class="ow">not</span> <span class="p">(</span><span class="n">force</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_json</span><span class="p">):</span>
-            <span class="k">return</span> <span class="kc">None</span>
-
-        <span class="c1"># We accept a request charset against the specification as</span>
-        <span class="c1"># certain clients have been using this in the past.  This</span>
-        <span class="c1"># fits our general approach of being nice in what we accept</span>
-        <span class="c1"># and strict in what we send out.</span>
-        <span class="n">request_charset</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">mimetype_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;charset&#39;</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">data</span> <span class="o">=</span> <span class="n">_get_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">cache</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">request_charset</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">encoding</span><span class="o">=</span><span class="n">request_charset</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">ValueError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">silent</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_json_loading_failed</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">cache</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_cached_json</span> <span class="o">=</span> <span class="n">rv</span>
-        <span class="k">return</span> <span class="n">rv</span></div>
-
-<div class="viewcode-block" id="Request.on_json_loading_failed"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Request.on_json_loading_failed">[docs]</a>    <span class="k">def</span> <span class="nf">on_json_loading_failed</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">e</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called if decoding of the JSON data failed.  The return value of</span>
-<span class="sd">        this method is used by :meth:`get_json` when an error occurred.  The</span>
-<span class="sd">        default implementation just raises a :class:`BadRequest` exception.</span>
-
-<span class="sd">        .. versionchanged:: 0.10</span>
-<span class="sd">           Removed buggy previous behavior of generating a random JSON</span>
-<span class="sd">           response.  If you want that behavior back you can trivially</span>
-<span class="sd">           add it by subclassing.</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">ctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">ctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;DEBUG&#39;</span><span class="p">,</span> <span class="kc">False</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="n">BadRequest</span><span class="p">(</span><span class="s1">&#39;Failed to decode JSON object: </span><span class="si">{0}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-        <span class="k">raise</span> <span class="n">BadRequest</span><span class="p">()</span></div>
-
-    <span class="k">def</span> <span class="nf">_load_form_data</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">RequestBase</span><span class="o">.</span><span class="n">_load_form_data</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-        <span class="c1"># In debug mode we&#39;re replacing the files multidict with an ad-hoc</span>
-        <span class="c1"># subclass that raises a different error for key errors.</span>
-        <span class="n">ctx</span> <span class="o">=</span> <span class="n">_request_ctx_stack</span><span class="o">.</span><span class="n">top</span>
-        <span class="k">if</span> <span class="n">ctx</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">ctx</span><span class="o">.</span><span class="n">app</span><span class="o">.</span><span class="n">debug</span> <span class="ow">and</span> \
-           <span class="bp">self</span><span class="o">.</span><span class="n">mimetype</span> <span class="o">!=</span> <span class="s1">&#39;multipart/form-data&#39;</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">files</span><span class="p">:</span>
-            <span class="kn">from</span> <span class="nn">.debughelpers</span> <span class="k">import</span> <span class="n">attach_enctype_error_multidict</span>
-            <span class="n">attach_enctype_error_multidict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="Response"><a class="viewcode-back" href="../../flask/flask.html#flask.app.Response">[docs]</a><span class="k">class</span> <span class="nc">Response</span><span class="p">(</span><span class="n">ResponseBase</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;The response object that is used by default in Flask.  Works like the</span>
-<span class="sd">    response object from Werkzeug but is set to have an HTML mimetype by</span>
-<span class="sd">    default.  Quite often you don&#39;t have to create this object yourself because</span>
-<span class="sd">    :meth:`~flask.Flask.make_response` will take care of that for you.</span>
-
-<span class="sd">    If you want to replace the response object used you can subclass this and</span>
-<span class="sd">    set :attr:`~flask.Flask.response_class` to your subclass.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">default_mimetype</span> <span class="o">=</span> <span class="s1">&#39;text/html&#39;</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/index.html

@@ -1,109 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>Overview: module code &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../_static/jquery.js"></script>
-    <script type="text/javascript" src="../_static/underscore.js"></script>
-    <script type="text/javascript" src="../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../genindex.html" />
-    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../index.html" />
-   
-  <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>All modules for which code is available</h1>
-<ul><li><a href="_hashlib.html">_hashlib</a></li>
-<li><a href="flask/app.html">flask.app</a></li>
-<li><a href="flask/blueprints.html">flask.blueprints</a></li>
-<li><a href="flask/cli.html">flask.cli</a></li>
-<li><a href="flask/config.html">flask.config</a></li>
-<li><a href="flask/ctx.html">flask.ctx</a></li>
-<li><a href="flask/debughelpers.html">flask.debughelpers</a></li>
-<li><a href="flask/exthook.html">flask.exthook</a></li>
-<li><a href="flask/helpers.html">flask.helpers</a></li>
-<li><a href="flask/json.html">flask.json</a></li>
-<li><a href="flask/logging.html">flask.logging</a></li>
-<li><a href="flask/sessions.html">flask.sessions</a></li>
-<li><a href="flask/signals.html">flask.signals</a></li>
-<li><a href="flask/templating.html">flask.templating</a></li>
-<li><a href="flask/testing.html">flask.testing</a></li>
-<li><a href="flask/views.html">flask.views</a></li>
-<li><a href="flask/wrappers.html">flask.wrappers</a></li>
-<li><a href="proxypool/db.html">proxypool.db</a></li>
-<li><a href="proxypool/error.html">proxypool.error</a></li>
-<li><a href="proxypool/proxyGetter.html">proxypool.proxyGetter</a></li>
-<li><a href="proxypool/schedule.html">proxypool.schedule</a></li>
-<li><a href="proxypool/utils.html">proxypool.utils</a></li>
-<li><a href="werkzeug/datastructures.html">werkzeug.datastructures</a></li>
-<li><a href="werkzeug/routing.html">werkzeug.routing</a></li>
-</ul>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/proxypool/db.html

@@ -1,151 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>proxypool.db &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for proxypool.db</h1><div class="highlight"><pre>
-<span></span><span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">    File Name:     db.py</span>
-<span class="sd">    Description:   数据库操作模块，负责对象与底层数据库</span>
-<span class="sd">                   的交互。</span>
-<span class="sd">    Author:        Liu</span>
-<span class="sd">    Date:          2016/12/9</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">redis</span>
-
-<span class="kn">from</span> <span class="nn">.error</span> <span class="k">import</span> <span class="n">PoolEmptyError</span>
-<span class="kn">from</span> <span class="nn">.setting</span> <span class="k">import</span> <span class="n">HOST</span><span class="p">,</span> <span class="n">PORT</span>
-
-
-<div class="viewcode-block" id="RedisClient"><a class="viewcode-back" href="../../proxypool.html#proxypool.db.RedisClient">[docs]</a><span class="k">class</span> <span class="nc">RedisClient</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    Redis数据库操作类。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="n">HOST</span><span class="p">,</span> <span class="n">port</span><span class="o">=</span><span class="n">PORT</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__db</span> <span class="o">=</span> <span class="n">redis</span><span class="o">.</span><span class="n">Redis</span><span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">port</span><span class="p">)</span>
-
-<div class="viewcode-block" id="RedisClient.get"><a class="viewcode-back" href="../../proxypool.html#proxypool.db.RedisClient.get">[docs]</a>    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">count</span><span class="o">=</span><span class="mi">1</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;从Pool中获取一定量数据。&quot;&quot;&quot;</span>
-        <span class="n">proxies</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">lrange</span><span class="p">(</span><span class="s2">&quot;proxies&quot;</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">count</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">ltrim</span><span class="p">(</span><span class="s2">&quot;proxies&quot;</span><span class="p">,</span> <span class="n">count</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">proxies</span></div>
-
-<div class="viewcode-block" id="RedisClient.put"><a class="viewcode-back" href="../../proxypool.html#proxypool.db.RedisClient.put">[docs]</a>    <span class="k">def</span> <span class="nf">put</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proxy</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;将代理压入Pool中。</span>
-<span class="sd">        用Redis的set容器来负责去重，如果proxy能被压入proxy_set，</span>
-<span class="sd">        就将其放入proxy pool中，否则不压入。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">sadd</span><span class="p">(</span><span class="s2">&quot;proxy_set&quot;</span><span class="p">,</span> <span class="n">proxy</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">rpush</span><span class="p">(</span><span class="s2">&quot;proxies&quot;</span><span class="p">,</span> <span class="n">proxy</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">pass</span></div>
-
-<div class="viewcode-block" id="RedisClient.put_many"><a class="viewcode-back" href="../../proxypool.html#proxypool.db.RedisClient.put_many">[docs]</a>    <span class="k">def</span> <span class="nf">put_many</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proxies</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;将一定量的代理压入Pool。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">for</span> <span class="n">proxy</span> <span class="ow">in</span> <span class="n">proxies</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">proxy</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="RedisClient.pop"><a class="viewcode-back" href="../../proxypool.html#proxypool.db.RedisClient.pop">[docs]</a>    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;弹出一个可用代理。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">blpop</span><span class="p">(</span><span class="s2">&quot;proxies&quot;</span><span class="p">,</span> <span class="mi">30</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s1">&#39;utf-8&#39;</span><span class="p">)</span>
-        <span class="k">except</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">PoolEmptyError</span></div>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">queue_len</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;获取proxy pool的大小。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">llen</span><span class="p">(</span><span class="s2">&quot;proxies&quot;</span><span class="p">)</span>
-
-<div class="viewcode-block" id="RedisClient.flush"><a class="viewcode-back" href="../../proxypool.html#proxypool.db.RedisClient.flush">[docs]</a>    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;刷新Redis中的全部内容，测试用。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">__db</span><span class="o">.</span><span class="n">flushall</span><span class="p">()</span></div></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/proxypool/error.html

@@ -1,121 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>proxypool.error &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for proxypool.error</h1><div class="highlight"><pre>
-<span></span><span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">    File Name:     error.py</span>
-<span class="sd">    Description:   异常模块</span>
-<span class="sd">    Author:        Liu</span>
-<span class="sd">    Date:          2016/12/9</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-
-<div class="viewcode-block" id="ResourceDepletionError"><a class="viewcode-back" href="../../proxypool.html#proxypool.error.ResourceDepletionError">[docs]</a><span class="k">class</span> <span class="nc">ResourceDepletionError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    资源枯竭异常，如果从所有抓取网站都抓不到可用的代理资源，</span>
-<span class="sd">    则抛出此异常。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="ne">Exception</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">repr</span><span class="p">(</span><span class="s1">&#39;The proxy source is exhausted&#39;</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="PoolEmptyError"><a class="viewcode-back" href="../../proxypool.html#proxypool.error.PoolEmptyError">[docs]</a><span class="k">class</span> <span class="nc">PoolEmptyError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    代理池空异常，如果代理池长时间为空，则抛出此异常。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="ne">Exception</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">repr</span><span class="p">(</span><span class="s1">&#39;The proxy pool is empty&#39;</span><span class="p">)</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/proxypool/proxyGetter.html

@@ -1,205 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>proxypool.proxyGetter &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for proxypool.proxyGetter</h1><div class="highlight"><pre>
-<span></span><span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">    File Name:     proxyGetter.py</span>
-<span class="sd">    Description:   代理抓取模块，负责与网络的交互。</span>
-<span class="sd">    Author:        Liu</span>
-<span class="sd">    Date:          2016/12/9</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">&quot;&quot;&quot;</span>
-
-<span class="kn">import</span> <span class="nn">time</span>
-
-<span class="kn">from</span> <span class="nn">.utils</span> <span class="k">import</span> <span class="n">get_page</span>
-
-<div class="viewcode-block" id="ProxyMetaclass"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.ProxyMetaclass">[docs]</a><span class="k">class</span> <span class="nc">ProxyMetaclass</span><span class="p">(</span><span class="nb">type</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    爬虫的元类，在FreeProxyGetter类中加入</span>
-<span class="sd">    __CrawlFunc__和__CrawlFuncCount__</span>
-<span class="sd">    两个参数，分别表示爬虫函数，和爬虫函数的数量。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">def</span> <span class="nf">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">bases</span><span class="p">,</span> <span class="n">attrs</span><span class="p">):</span>
-        <span class="n">count</span> <span class="o">=</span> <span class="mi">0</span>
-        <span class="n">attrs</span><span class="p">[</span><span class="s1">&#39;__CrawlFunc__&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">attrs</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-            <span class="k">if</span> <span class="s1">&#39;crawl_&#39;</span> <span class="ow">in</span> <span class="n">k</span><span class="p">:</span>
-                <span class="n">attrs</span><span class="p">[</span><span class="s1">&#39;__CrawlFunc__&#39;</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">k</span><span class="p">)</span>
-                <span class="n">count</span> <span class="o">+=</span> <span class="mi">1</span>
-        <span class="n">attrs</span><span class="p">[</span><span class="s1">&#39;__CrawlFuncCount__&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">count</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="o">.</span><span class="n">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">bases</span><span class="p">,</span> <span class="n">attrs</span><span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="FreeProxyGetter"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.FreeProxyGetter">[docs]</a><span class="k">class</span> <span class="nc">FreeProxyGetter</span><span class="p">(</span><span class="nb">object</span><span class="p">,</span> <span class="n">metaclass</span><span class="o">=</span><span class="n">ProxyMetaclass</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    代理爬虫，负责扫描各大代理网站，抓取代理。</span>
-<span class="sd">    该类有可扩展性，可根据需要自己添加新站点的代理抓取函数，</span>
-<span class="sd">    但是函数名必须以crawl_开头，返回值必须以&quot;host:port&quot;的形式返回，</span>
-<span class="sd">    添加器会自动识别并调用此类函数。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    
-<div class="viewcode-block" id="FreeProxyGetter.get_raw_proxies"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.FreeProxyGetter.get_raw_proxies">[docs]</a>    <span class="k">def</span> <span class="nf">get_raw_proxies</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="p">,</span> <span class="n">count</span><span class="o">=</span><span class="mi">40</span><span class="p">):</span>
-        <span class="n">proxies</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">proxy</span> <span class="ow">in</span> <span class="nb">eval</span><span class="p">(</span><span class="s2">&quot;self.</span><span class="si">{}</span><span class="s2">()&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">callback</span><span class="p">)):</span>
-            <span class="n">proxies</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">proxy</span><span class="p">)</span>
-            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">proxies</span><span class="p">)</span> <span class="o">&gt;=</span> <span class="n">count</span><span class="p">:</span>
-                <span class="k">break</span>
-        <span class="k">return</span> <span class="n">proxies</span></div>
-
-<div class="viewcode-block" id="FreeProxyGetter.crawl_kuaidaili"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_kuaidaili">[docs]</a>    <span class="k">def</span> <span class="nf">crawl_kuaidaili</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">page_count</span><span class="o">=</span><span class="mi">8</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        抓取快代理网的数据</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">start_url</span> <span class="o">=</span> <span class="s1">&#39;http://www.kuaidaili.com/proxylist/</span><span class="si">{}</span><span class="s1">/&#39;</span>
-        <span class="n">urls</span> <span class="o">=</span> <span class="p">[</span><span class="n">start_url</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">page</span><span class="p">)</span> <span class="k">for</span> <span class="n">page</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">page_count</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)]</span>
-        <span class="k">for</span> <span class="n">url</span> <span class="ow">in</span> <span class="n">urls</span><span class="p">:</span>
-            <span class="n">soup</span> <span class="o">=</span> <span class="n">get_page</span><span class="p">(</span><span class="n">url</span><span class="p">)</span> 
-      
-            <span class="n">proxy_list</span> <span class="o">=</span> <span class="n">soup</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s1">&#39;div&#39;</span><span class="p">,</span> <span class="p">{</span><span class="s1">&#39;id&#39;</span><span class="p">:</span> <span class="s1">&#39;index_free_list&#39;</span><span class="p">})</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s1">&#39;tbody&#39;</span><span class="p">)</span>
-            <span class="k">for</span> <span class="n">proxy</span> <span class="ow">in</span> <span class="n">proxy_list</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;tr&#39;</span><span class="p">):</span>
-                <span class="n">ip</span> <span class="o">=</span> <span class="n">proxy</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;td&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span>
-                <span class="n">port</span> <span class="o">=</span> <span class="n">proxy</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;td&#39;</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span>
-                <span class="k">yield</span> <span class="s1">&#39;:&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">ip</span><span class="p">,</span> <span class="n">port</span><span class="p">])</span></div>
-
-
-<div class="viewcode-block" id="FreeProxyGetter.crawl_daili66"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_daili66">[docs]</a>    <span class="k">def</span> <span class="nf">crawl_daili66</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">page_count</span><span class="o">=</span><span class="mi">4</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        抓取代理66网的数据。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">start_url</span> <span class="o">=</span> <span class="s1">&#39;http://www.66ip.cn/</span><span class="si">{}</span><span class="s1">.html&#39;</span>
-        <span class="n">urls</span> <span class="o">=</span> <span class="p">[</span><span class="n">start_url</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">page</span><span class="p">)</span> <span class="k">for</span> <span class="n">page</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">page_count</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)]</span>
-        <span class="k">for</span> <span class="n">url</span> <span class="ow">in</span> <span class="n">urls</span><span class="p">:</span>
-            <span class="n">soup</span> <span class="o">=</span> <span class="n">get_page</span><span class="p">(</span><span class="n">url</span><span class="p">)</span> 
-            <span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
-            <span class="n">proxy_list</span> <span class="o">=</span> <span class="n">soup</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s1">&#39;table&#39;</span><span class="p">,</span> <span class="p">{</span><span class="s2">&quot;border&quot;</span><span class="p">:</span> <span class="s2">&quot;2px&quot;</span><span class="p">})</span> 
-            <span class="k">for</span> <span class="n">proxy</span> <span class="ow">in</span> <span class="n">proxy_list</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;tr&#39;</span><span class="p">)[</span><span class="mi">1</span><span class="p">:]:</span>
-                <span class="n">ip</span> <span class="o">=</span> <span class="n">proxy</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;td&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span>
-                <span class="n">port</span> <span class="o">=</span> <span class="n">proxy</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;td&#39;</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span>
-                <span class="k">yield</span> <span class="s1">&#39;:&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">ip</span><span class="p">,</span> <span class="n">port</span><span class="p">])</span></div>
-
-<div class="viewcode-block" id="FreeProxyGetter.crawl_xici"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_xici">[docs]</a>    <span class="k">def</span> <span class="nf">crawl_xici</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        抓取xici代理网的数据。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">start_url</span> <span class="o">=</span> <span class="s1">&#39;http://api.xicidaili.com/free2016.txt&#39;</span>
-        <span class="n">soup</span> <span class="o">=</span> <span class="n">get_page</span><span class="p">(</span><span class="n">start_url</span><span class="p">)</span>
-        <span class="n">proxy_list</span> <span class="o">=</span> <span class="n">soup</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s1">&#39;p&#39;</span><span class="p">)</span> 
-        <span class="k">return</span> <span class="n">proxy_list</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\r\n</span><span class="s1">&#39;</span><span class="p">)</span></div>
-    
-<div class="viewcode-block" id="FreeProxyGetter.crawl_proxy360"><a class="viewcode-back" href="../../proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_proxy360">[docs]</a>    <span class="k">def</span> <span class="nf">crawl_proxy360</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        抓取proxy360网的数据。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">start_url</span> <span class="o">=</span> <span class="s1">&#39;http://www.proxy360.cn/default.aspx&#39;</span>
-        <span class="n">soup</span> <span class="o">=</span> <span class="n">get_page</span><span class="p">(</span><span class="n">start_url</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">proxy</span> <span class="ow">in</span> <span class="n">soup</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;div&#39;</span><span class="p">,</span> <span class="p">{</span><span class="s2">&quot;class&quot;</span><span class="p">:</span> <span class="s2">&quot;proxylistitem&quot;</span><span class="p">}):</span>
-            <span class="n">item</span> <span class="o">=</span> <span class="n">proxy</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="s1">&#39;span&#39;</span><span class="p">,</span> <span class="p">{</span><span class="s2">&quot;class&quot;</span><span class="p">:</span> <span class="s2">&quot;tbBottomLine&quot;</span><span class="p">})</span>
-            <span class="n">ip</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\r\n</span><span class="s1">&#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39; &#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span>
-            <span class="n">port</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">get_text</span><span class="p">()</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\r\n</span><span class="s1">&#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39; &#39;</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span>
-            <span class="k">yield</span> <span class="s1">&#39;:&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">ip</span><span class="p">,</span> <span class="n">port</span><span class="p">])</span></div></div>
-    
-    <span class="c1"># def crawl_goubanjia(self):</span>
-    <span class="c1">#     start_url = &#39;http://www.goubanjia.com/free/gngn/index.shtml&#39;</span>
-    <span class="c1">#     soup = get_page(start_url)</span>
-    <span class="c1">#     proxy_list = soup.find(&#39;table&#39;, {&quot;class&quot;: &quot;table&quot;}).find(&#39;tbody&#39;)</span>
-    <span class="c1">#     for tr in proxy_list.find_all(&#39;tr&#39;):</span>
-    <span class="c1">#         _proxy = tr.find(&#39;td&#39;).find_all(&#39;span&#39;)</span>
-    <span class="c1">#         proxy = [i.get_text() for i in _proxy]</span>
-    <span class="c1">#         yield &#39;&#39;.join(proxy)</span>
-
-
-<span class="k">if</span> <span class="n">__name__</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>
-    <span class="kn">import</span> <span class="nn">time</span>
-    <span class="n">a</span> <span class="o">=</span> <span class="n">FreeProxyGetter</span><span class="p">()</span>
-    <span class="n">start</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">clock</span><span class="p">()</span>
-    <span class="nb">print</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">a</span><span class="o">.</span><span class="n">crawl_goubanjia</span><span class="p">()))</span>
-
-    
-    <span class="nb">print</span><span class="p">(</span><span class="n">time</span><span class="o">.</span><span class="n">clock</span><span class="p">()</span><span class="o">-</span><span class="n">start</span><span class="p">)</span>
-    
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/proxypool/schedule.html

@@ -1,238 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>proxypool.schedule &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for proxypool.schedule</h1><div class="highlight"><pre>
-<span></span><span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">    File Name:     schedule.py</span>
-<span class="sd">    Description:   调度器模块，</span>
-<span class="sd">                   包含ValidityTester，PoolAdder，</span>
-<span class="sd">                   Schedule三个类，负责维护代理池。</span>
-<span class="sd">    Author:        Liu</span>
-<span class="sd">    Date:          2016/12/9</span>
-<span class="sd">-------------------------------------------------</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">time</span>
-<span class="kn">from</span> <span class="nn">multiprocessing</span> <span class="k">import</span> <span class="n">Process</span>
-<span class="kn">import</span> <span class="nn">asyncio</span>
-<span class="kn">import</span> <span class="nn">aiohttp</span>
-
-<span class="kn">from</span> <span class="nn">.db</span> <span class="k">import</span> <span class="n">RedisClient</span>
-<span class="kn">from</span> <span class="nn">.error</span> <span class="k">import</span> <span class="n">ResourceDepletionError</span>
-<span class="kn">from</span> <span class="nn">.proxyGetter</span> <span class="k">import</span> <span class="n">FreeProxyGetter</span>
-<span class="kn">from</span> <span class="nn">.setting</span> <span class="k">import</span> <span class="o">*</span>
-
-
-<div class="viewcode-block" id="ValidityTester"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.ValidityTester">[docs]</a><span class="k">class</span> <span class="nc">ValidityTester</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    检验器，负责对未知的代理进行异步检测。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="c1"># 用百度的首页来检验</span>
-    <span class="n">test_api</span> <span class="o">=</span> <span class="s1">&#39;https://www.baidu.com&#39;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_raw_proxies</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_usable_proxies</span> <span class="o">=</span> <span class="p">[]</span>
-
-<div class="viewcode-block" id="ValidityTester.set_raw_proxies"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.ValidityTester.set_raw_proxies">[docs]</a>    <span class="k">def</span> <span class="nf">set_raw_proxies</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proxies</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;设置待检测的代理。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_raw_proxies</span> <span class="o">=</span> <span class="n">proxies</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_usable_proxies</span> <span class="o">=</span> <span class="p">[]</span></div>
-
-<div class="viewcode-block" id="ValidityTester.test_single_proxy"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.ValidityTester.test_single_proxy">[docs]</a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">test_single_proxy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proxy</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;检测单个代理，如果可用，则将其加入_usable_proxies</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">async</span> <span class="k">with</span> <span class="n">aiohttp</span><span class="o">.</span><span class="n">ClientSession</span><span class="p">()</span> <span class="k">as</span> <span class="n">session</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">real_proxy</span> <span class="o">=</span> <span class="s1">&#39;http://&#39;</span> <span class="o">+</span> <span class="n">proxy</span>
-                <span class="k">async</span> <span class="k">with</span> <span class="n">session</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_api</span><span class="p">,</span> <span class="n">proxy</span><span class="o">=</span><span class="n">real_proxy</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="mi">15</span><span class="p">)</span> <span class="k">as</span> <span class="n">resp</span><span class="p">:</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_usable_proxies</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">proxy</span><span class="p">)</span>
-            <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-                <span class="k">pass</span></div>
-
-<div class="viewcode-block" id="ValidityTester.test"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.ValidityTester.test">[docs]</a>    <span class="k">def</span> <span class="nf">test</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;异步检测_raw_proxies中的全部代理。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;ValidityTester is working&#39;</span><span class="p">)</span>
-        <span class="n">loop</span> <span class="o">=</span> <span class="n">asyncio</span><span class="o">.</span><span class="n">get_event_loop</span><span class="p">()</span>
-        <span class="n">tasks</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">test_single_proxy</span><span class="p">(</span><span class="n">proxy</span><span class="p">)</span> <span class="k">for</span> <span class="n">proxy</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_proxies</span><span class="p">]</span>
-        <span class="n">loop</span><span class="o">.</span><span class="n">run_until_complete</span><span class="p">(</span><span class="n">asyncio</span><span class="o">.</span><span class="n">wait</span><span class="p">(</span><span class="n">tasks</span><span class="p">))</span></div>
-
-<div class="viewcode-block" id="ValidityTester.get_usable_proxies"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.ValidityTester.get_usable_proxies">[docs]</a>    <span class="k">def</span> <span class="nf">get_usable_proxies</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_usable_proxies</span></div></div>
-
-
-<div class="viewcode-block" id="PoolAdder"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.PoolAdder">[docs]</a><span class="k">class</span> <span class="nc">PoolAdder</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    添加器，负责向池中补充代理</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">threshold</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_threshold</span> <span class="o">=</span> <span class="n">threshold</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_conn</span> <span class="o">=</span> <span class="n">RedisClient</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_tester</span> <span class="o">=</span> <span class="n">ValidityTester</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_crawler</span> <span class="o">=</span> <span class="n">FreeProxyGetter</span><span class="p">()</span>
-
-<div class="viewcode-block" id="PoolAdder.is_over_threshold"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.PoolAdder.is_over_threshold">[docs]</a>    <span class="k">def</span> <span class="nf">is_over_threshold</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        判断代理池中的数据量是否达到阈值。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="o">.</span><span class="n">queue_len</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_threshold</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span></div>
-
-<div class="viewcode-block" id="PoolAdder.add_to_queue"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.PoolAdder.add_to_queue">[docs]</a>    <span class="k">def</span> <span class="nf">add_to_queue</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">flag</span><span class="o">=</span><span class="mi">40</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        命令爬虫抓取一定量未检测的代理，然后检测，将通过检测的代理</span>
-<span class="sd">        加入到代理池中。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;PoolAdder is working&#39;</span><span class="p">)</span>
-        <span class="k">while</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_over_threshold</span><span class="p">():</span>
-            <span class="k">for</span> <span class="n">callback_label</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_crawler</span><span class="o">.</span><span class="n">__CrawlFuncCount__</span><span class="p">):</span>
-                <span class="n">callback</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_crawler</span><span class="o">.</span><span class="n">__CrawlFunc__</span><span class="p">[</span><span class="n">callback_label</span><span class="p">]</span>
-                <span class="n">raw_proxies</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_crawler</span><span class="o">.</span><span class="n">get_raw_proxies</span><span class="p">(</span><span class="n">callback</span><span class="p">,</span> <span class="n">flag</span><span class="p">)</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_tester</span><span class="o">.</span><span class="n">set_raw_proxies</span><span class="p">(</span><span class="n">raw_proxies</span><span class="p">)</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_tester</span><span class="o">.</span><span class="n">test</span><span class="p">()</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="o">.</span><span class="n">put_many</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_tester</span><span class="o">.</span><span class="n">get_usable_proxies</span><span class="p">())</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_over_threshold</span><span class="p">():</span>
-                    <span class="k">break</span>
-
-            <span class="n">flag</span> <span class="o">+=</span> <span class="n">flag</span>
-            <span class="k">if</span> <span class="n">flag</span> <span class="o">&gt;=</span> <span class="mi">10</span> <span class="o">*</span> <span class="n">flag</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="n">ResourceDepletionError</span></div></div>
-
-
-<div class="viewcode-block" id="Schedule"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.Schedule">[docs]</a><span class="k">class</span> <span class="nc">Schedule</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    总调度器，用于协调各调度器模块</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="nd">@staticmethod</span>
-<div class="viewcode-block" id="Schedule.valid_proxy"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.Schedule.valid_proxy">[docs]</a>    <span class="k">def</span> <span class="nf">valid_proxy</span><span class="p">(</span><span class="n">cycle</span><span class="o">=</span><span class="n">VALID_CHECK_CYCLE</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        对已经如池的代理进行检测，防止池中的代理因长期</span>
-<span class="sd">        不使用而过期。</span>
-<span class="sd">        抽出代理池队列中前1/4的代理，检测，合格者压入队列尾。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">conn</span> <span class="o">=</span> <span class="n">RedisClient</span><span class="p">()</span>
-        <span class="n">tester</span> <span class="o">=</span> <span class="n">ValidityTester</span><span class="p">()</span>
-        <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-            <span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="n">cycle</span><span class="p">)</span>
-            <span class="n">count</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="mf">0.25</span> <span class="o">*</span> <span class="n">conn</span><span class="o">.</span><span class="n">queue_len</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-                <span class="k">continue</span>
-            <span class="n">raw_proxies</span> <span class="o">=</span> <span class="n">conn</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">count</span><span class="p">)</span>
-            <span class="n">tester</span><span class="o">.</span><span class="n">set_raw_proxies</span><span class="p">(</span><span class="n">raw_proxies</span><span class="p">)</span>
-            <span class="n">tester</span><span class="o">.</span><span class="n">test</span><span class="p">()</span>
-            <span class="n">proxies</span> <span class="o">=</span> <span class="n">tester</span><span class="o">.</span><span class="n">get_usable_proxies</span><span class="p">()</span>
-            <span class="n">conn</span><span class="o">.</span><span class="n">put_many</span><span class="p">(</span><span class="n">proxies</span><span class="p">)</span></div>
-
-    <span class="nd">@staticmethod</span>
-<div class="viewcode-block" id="Schedule.check_pool"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.Schedule.check_pool">[docs]</a>    <span class="k">def</span> <span class="nf">check_pool</span><span class="p">(</span><span class="n">lower_threshold</span><span class="o">=</span><span class="n">POOL_LOWER_THRESHOLD</span><span class="p">,</span>
-                   <span class="n">upper_threshold</span><span class="o">=</span><span class="n">POOL_UPPER_THRESHOLD</span><span class="p">,</span>
-                   <span class="n">cycle</span><span class="o">=</span><span class="n">POOL_LEN_CHECK_CYCLE</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        协调添加器，当代理池中可用代理的数量低于下阈值时，触发添加器，启动爬虫</span>
-<span class="sd">        补充代理，当代理达到上阈值时，添加器停止工作。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">conn</span> <span class="o">=</span> <span class="n">RedisClient</span><span class="p">()</span>
-        <span class="n">adder</span> <span class="o">=</span> <span class="n">PoolAdder</span><span class="p">(</span><span class="n">upper_threshold</span><span class="p">)</span>
-        <span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">conn</span><span class="o">.</span><span class="n">queue_len</span> <span class="o">&lt;</span> <span class="n">lower_threshold</span><span class="p">:</span>
-                <span class="n">adder</span><span class="o">.</span><span class="n">add_to_queue</span><span class="p">()</span>
-            <span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="n">cycle</span><span class="p">)</span></div>
-
-<div class="viewcode-block" id="Schedule.run"><a class="viewcode-back" href="../../proxypool.html#proxypool.schedule.Schedule.run">[docs]</a>    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        运行调度器，创建两个进程，对代理池进行维护。</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">valid_process</span> <span class="o">=</span> <span class="n">Process</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="n">Schedule</span><span class="o">.</span><span class="n">valid_proxy</span><span class="p">)</span>
-        <span class="n">check_process</span> <span class="o">=</span> <span class="n">Process</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="n">Schedule</span><span class="o">.</span><span class="n">check_pool</span><span class="p">)</span>
-        <span class="n">valid_process</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
-        <span class="n">check_process</span><span class="o">.</span><span class="n">start</span><span class="p">()</span></div></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/proxypool/utils.html

@@ -1,134 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>proxypool.utils &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for proxypool.utils</h1><div class="highlight"><pre>
-<span></span><span class="kn">import</span> <span class="nn">requests</span>
-<span class="kn">import</span> <span class="nn">lxml</span>
-<span class="kn">import</span> <span class="nn">asyncio</span>
-<span class="kn">import</span> <span class="nn">time</span>
-<span class="kn">import</span> <span class="nn">aiohttp</span>
-<span class="kn">from</span> <span class="nn">bs4</span> <span class="k">import</span> <span class="n">BeautifulSoup</span>
-
-<span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
-    <span class="s1">&#39;User-Agent&#39;</span><span class="p">:</span> <span class="s1">&#39;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 </span><span class="se">\</span>
-<span class="s1">    (KHTML, like Gecko) Chrome/54.0.2840.71 Safari/537.36&#39;</span><span class="p">,</span>
-    <span class="s1">&#39;Accept-Encoding&#39;</span><span class="p">:</span> <span class="s1">&#39;gzip, deflate, sdch&#39;</span><span class="p">,</span>
-    <span class="s1">&#39;Accept-Language&#39;</span><span class="p">:</span> <span class="s1">&#39;zh-CN,zh;q=0.8&#39;</span>
-<span class="p">}</span>
-
-
-<div class="viewcode-block" id="get_page"><a class="viewcode-back" href="../../proxypool.html#proxypool.utils.get_page">[docs]</a><span class="k">def</span> <span class="nf">get_page</span><span class="p">(</span><span class="n">url</span><span class="p">):</span>
-    <span class="n">r</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">url</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">)</span>
-    <span class="k">try</span><span class="p">:</span>
-        <span class="n">soup</span> <span class="o">=</span> <span class="n">BeautifulSoup</span><span class="p">(</span><span class="n">r</span><span class="o">.</span><span class="n">content</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">),</span> <span class="s1">&#39;lxml&#39;</span><span class="p">)</span>
-    <span class="k">except</span> <span class="ne">UnicodeDecodeError</span><span class="p">:</span>
-        <span class="n">soup</span> <span class="o">=</span> <span class="n">BeautifulSoup</span><span class="p">(</span><span class="n">r</span><span class="o">.</span><span class="n">text</span><span class="p">,</span> <span class="s1">&#39;lxml&#39;</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">soup</span></div>
-
-
-<div class="viewcode-block" id="Downloader"><a class="viewcode-back" href="../../proxypool.html#proxypool.utils.Downloader">[docs]</a><span class="k">class</span> <span class="nc">Downloader</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    一个异步下载器，可以对代理源异步抓取，但是容易被BAN。</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">urls</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">urls</span> <span class="o">=</span> <span class="n">urls</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_htmls</span> <span class="o">=</span> <span class="p">[]</span>
-
-<div class="viewcode-block" id="Downloader.download_single_page"><a class="viewcode-back" href="../../proxypool.html#proxypool.utils.Downloader.download_single_page">[docs]</a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">download_single_page</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">url</span><span class="p">):</span>
-        <span class="k">async</span> <span class="k">with</span> <span class="n">aiohttp</span><span class="o">.</span><span class="n">ClientSession</span><span class="p">()</span> <span class="k">as</span> <span class="n">session</span><span class="p">:</span>
-            <span class="k">async</span> <span class="k">with</span> <span class="n">session</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">url</span><span class="p">)</span> <span class="k">as</span> <span class="n">resp</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_htmls</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">await</span> <span class="n">resp</span><span class="o">.</span><span class="n">text</span><span class="p">())</span></div>
-
-<div class="viewcode-block" id="Downloader.download"><a class="viewcode-back" href="../../proxypool.html#proxypool.utils.Downloader.download">[docs]</a>    <span class="k">def</span> <span class="nf">download</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">loop</span> <span class="o">=</span> <span class="n">asyncio</span><span class="o">.</span><span class="n">get_event_loop</span><span class="p">()</span>
-        <span class="n">tasks</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">download_single_page</span><span class="p">(</span><span class="n">url</span><span class="p">)</span> <span class="k">for</span> <span class="n">url</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">urls</span><span class="p">]</span>
-        <span class="n">loop</span><span class="o">.</span><span class="n">run_until_complete</span><span class="p">(</span><span class="n">asyncio</span><span class="o">.</span><span class="n">wait</span><span class="p">(</span><span class="n">tasks</span><span class="p">))</span></div>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">htmls</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">download</span><span class="p">()</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_htmls</span></div>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/werkzeug/datastructures.html

@@ -1,2782 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>werkzeug.datastructures &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for werkzeug.datastructures</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    werkzeug.datastructures</span>
-<span class="sd">    ~~~~~~~~~~~~~~~~~~~~~~~</span>
-
-<span class="sd">    This module provides mixins and classes with an immutable interface.</span>
-
-<span class="sd">    :copyright: (c) 2014 by the Werkzeug Team, see AUTHORS for more details.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">re</span>
-<span class="kn">import</span> <span class="nn">codecs</span>
-<span class="kn">import</span> <span class="nn">mimetypes</span>
-<span class="kn">from</span> <span class="nn">copy</span> <span class="k">import</span> <span class="n">deepcopy</span>
-<span class="kn">from</span> <span class="nn">itertools</span> <span class="k">import</span> <span class="n">repeat</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug._internal</span> <span class="k">import</span> <span class="n">_missing</span><span class="p">,</span> <span class="n">_empty_stream</span>
-<span class="kn">from</span> <span class="nn">werkzeug._compat</span> <span class="k">import</span> <span class="n">iterkeys</span><span class="p">,</span> <span class="n">itervalues</span><span class="p">,</span> <span class="n">iteritems</span><span class="p">,</span> <span class="n">iterlists</span><span class="p">,</span> \
-    <span class="n">PY2</span><span class="p">,</span> <span class="n">text_type</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">,</span> <span class="n">string_types</span><span class="p">,</span> <span class="n">make_literal_wrapper</span><span class="p">,</span> \
-    <span class="n">to_native</span>
-<span class="kn">from</span> <span class="nn">werkzeug.filesystem</span> <span class="k">import</span> <span class="n">get_filesystem_encoding</span>
-
-
-<span class="n">_locale_delim_re</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s1">r&#39;[_-]&#39;</span><span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%r</span><span class="s1"> objects are immutable&#39;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">iter_multi_items</span><span class="p">(</span><span class="n">mapping</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Iterates over the items of a mapping yielding keys and values</span>
-<span class="sd">    without dropping any from more complex structures.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="n">MultiDict</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">item</span>
-    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">mapping</span><span class="p">):</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">)):</span>
-                <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
-                    <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">:</span>
-            <span class="k">yield</span> <span class="n">item</span>
-
-
-<span class="k">def</span> <span class="nf">native_itermethods</span><span class="p">(</span><span class="n">names</span><span class="p">):</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">PY2</span><span class="p">:</span>
-        <span class="k">return</span> <span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span>
-
-    <span class="k">def</span> <span class="nf">setmethod</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span>
-        <span class="n">itermethod</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-        <span class="nb">setattr</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="s1">&#39;iter</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">name</span><span class="p">,</span> <span class="n">itermethod</span><span class="p">)</span>
-        <span class="n">listmethod</span> <span class="o">=</span> <span class="k">lambda</span> <span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">a</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">:</span> <span class="nb">list</span><span class="p">(</span><span class="n">itermethod</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">a</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">))</span>
-        <span class="n">listmethod</span><span class="o">.</span><span class="n">__doc__</span> <span class="o">=</span> \
-            <span class="s1">&#39;Like :py:meth:`iter</span><span class="si">%s</span><span class="s1">`, but returns a list.&#39;</span> <span class="o">%</span> <span class="n">name</span>
-        <span class="nb">setattr</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">listmethod</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">wrap</span><span class="p">(</span><span class="n">cls</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">names</span><span class="p">:</span>
-            <span class="n">setmethod</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">cls</span>
-    <span class="k">return</span> <span class="n">wrap</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableListMixin</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Makes a :class:`list` immutable.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :private:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">_hash_cache</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="k">def</span> <span class="nf">__hash__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hash_cache</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hash_cache</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hash_cache</span> <span class="o">=</span> <span class="nb">hash</span><span class="p">(</span><span class="nb">tuple</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">__reduce_ex__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">protocol</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span> <span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="p">),)</span>
-
-    <span class="k">def</span> <span class="nf">__delitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__delslice__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__iadd__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-    <span class="n">__imul__</span> <span class="o">=</span> <span class="n">__iadd__</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__setslice__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">append</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-    <span class="n">remove</span> <span class="o">=</span> <span class="n">append</span>
-
-    <span class="k">def</span> <span class="nf">extend</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">iterable</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">insert</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">pos</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">index</span><span class="o">=-</span><span class="mi">1</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">reverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">sort</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">cmp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">reverse</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableList</span><span class="p">(</span><span class="n">ImmutableListMixin</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;An immutable :class:`list`.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :private:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="nb">list</span><span class="o">.</span><span class="n">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span>
-        <span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableDictMixin</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Makes a :class:`dict` immutable.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :private:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">_hash_cache</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="nd">@classmethod</span>
-    <span class="k">def</span> <span class="nf">fromkeys</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">instance</span> <span class="o">=</span> <span class="nb">super</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">cls</span><span class="p">)</span><span class="o">.</span><span class="n">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">)</span>
-        <span class="n">instance</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="n">repeat</span><span class="p">(</span><span class="n">value</span><span class="p">)))</span>
-        <span class="k">return</span> <span class="n">instance</span>
-
-    <span class="k">def</span> <span class="nf">__reduce_ex__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">protocol</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span> <span class="p">(</span><span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="p">),)</span>
-
-    <span class="k">def</span> <span class="nf">_iter_hashitems</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__hash__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hash_cache</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hash_cache</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hash_cache</span> <span class="o">=</span> <span class="nb">hash</span><span class="p">(</span><span class="nb">frozenset</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_iter_hashitems</span><span class="p">()))</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__delitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableMultiDictMixin</span><span class="p">(</span><span class="n">ImmutableDictMixin</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Makes a :class:`MultiDict` immutable.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :private:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__reduce_ex__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">protocol</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span> <span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)),)</span>
-
-    <span class="k">def</span> <span class="nf">_iter_hashitems</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">popitemlist</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">poplist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">setlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">new_list</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">setlistdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default_list</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">UpdateDictMixin</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Makes dicts call `self.on_update` on modifications.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :private:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">on_update</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="k">def</span> <span class="nf">calls_update</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">oncall</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">):</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="nb">super</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="bp">self</span><span class="p">),</span> <span class="n">name</span><span class="p">)(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">)</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-            <span class="k">return</span> <span class="n">rv</span>
-        <span class="n">oncall</span><span class="o">.</span><span class="n">__name__</span> <span class="o">=</span> <span class="n">name</span>
-        <span class="k">return</span> <span class="n">oncall</span>
-
-    <span class="k">def</span> <span class="nf">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">modified</span> <span class="o">=</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="nb">super</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">modified</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">_missing</span><span class="p">):</span>
-        <span class="n">modified</span> <span class="o">=</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span>
-        <span class="k">if</span> <span class="n">default</span> <span class="ow">is</span> <span class="n">_missing</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="nb">super</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="nb">super</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">modified</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="n">__setitem__</span> <span class="o">=</span> <span class="n">calls_update</span><span class="p">(</span><span class="s1">&#39;__setitem__&#39;</span><span class="p">)</span>
-    <span class="n">__delitem__</span> <span class="o">=</span> <span class="n">calls_update</span><span class="p">(</span><span class="s1">&#39;__delitem__&#39;</span><span class="p">)</span>
-    <span class="n">clear</span> <span class="o">=</span> <span class="n">calls_update</span><span class="p">(</span><span class="s1">&#39;clear&#39;</span><span class="p">)</span>
-    <span class="n">popitem</span> <span class="o">=</span> <span class="n">calls_update</span><span class="p">(</span><span class="s1">&#39;popitem&#39;</span><span class="p">)</span>
-    <span class="n">update</span> <span class="o">=</span> <span class="n">calls_update</span><span class="p">(</span><span class="s1">&#39;update&#39;</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">calls_update</span>
-
-
-<span class="k">class</span> <span class="nc">TypeConversionDict</span><span class="p">(</span><span class="nb">dict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Works like a regular dict but the :meth:`get` method can perform</span>
-<span class="sd">    type conversions.  :class:`MultiDict` and :class:`CombinedMultiDict`</span>
-<span class="sd">    are subclasses of this class and provide the same feature.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the default value if the requested data doesn&#39;t exist.</span>
-<span class="sd">        If `type` is provided and is a callable it should convert the value,</span>
-<span class="sd">        return it or raise a :exc:`ValueError` if that is not possible.  In</span>
-<span class="sd">        this case the function will return the default as if the value was not</span>
-<span class="sd">        found:</span>
-
-<span class="sd">        &gt;&gt;&gt; d = TypeConversionDict(foo=&#39;42&#39;, bar=&#39;blub&#39;)</span>
-<span class="sd">        &gt;&gt;&gt; d.get(&#39;foo&#39;, type=int)</span>
-<span class="sd">        42</span>
-<span class="sd">        &gt;&gt;&gt; d.get(&#39;bar&#39;, -1, type=int)</span>
-<span class="sd">        -1</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param default: The default value to be returned if the key can&#39;t</span>
-<span class="sd">                        be looked up.  If not further specified `None` is</span>
-<span class="sd">                        returned.</span>
-<span class="sd">        :param type: A callable that is used to cast the value in the</span>
-<span class="sd">                     :class:`MultiDict`.  If a :exc:`ValueError` is raised</span>
-<span class="sd">                     by this callable the default value is returned.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-            <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-        <span class="k">except</span> <span class="p">(</span><span class="ne">KeyError</span><span class="p">,</span> <span class="ne">ValueError</span><span class="p">):</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">default</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableTypeConversionDict</span><span class="p">(</span><span class="n">ImmutableDictMixin</span><span class="p">,</span> <span class="n">TypeConversionDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Works like a :class:`TypeConversionDict` but does not support</span>
-<span class="sd">    modifications.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a shallow mutable copy of this object.  Keep in mind that</span>
-<span class="sd">        the standard library&#39;s :func:`copy` function is a no-op for this class</span>
-<span class="sd">        like for any other python immutable type (eg: :class:`tuple`).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">TypeConversionDict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-
-<span class="nd">@native_itermethods</span><span class="p">([</span><span class="s1">&#39;keys&#39;</span><span class="p">,</span> <span class="s1">&#39;values&#39;</span><span class="p">,</span> <span class="s1">&#39;items&#39;</span><span class="p">,</span> <span class="s1">&#39;lists&#39;</span><span class="p">,</span> <span class="s1">&#39;listvalues&#39;</span><span class="p">])</span>
-<span class="k">class</span> <span class="nc">MultiDict</span><span class="p">(</span><span class="n">TypeConversionDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A :class:`MultiDict` is a dictionary subclass customized to deal with</span>
-<span class="sd">    multiple values for the same key which is for example used by the parsing</span>
-<span class="sd">    functions in the wrappers.  This is necessary because some HTML form</span>
-<span class="sd">    elements pass multiple values for the same key.</span>
-
-<span class="sd">    :class:`MultiDict` implements all standard dictionary methods.</span>
-<span class="sd">    Internally, it saves all values for a key as a list, but the standard dict</span>
-<span class="sd">    access methods will only return the first value for a key. If you want to</span>
-<span class="sd">    gain access to the other values, too, you have to use the `list` methods as</span>
-<span class="sd">    explained below.</span>
-
-<span class="sd">    Basic Usage:</span>
-
-<span class="sd">    &gt;&gt;&gt; d = MultiDict([(&#39;a&#39;, &#39;b&#39;), (&#39;a&#39;, &#39;c&#39;)])</span>
-<span class="sd">    &gt;&gt;&gt; d</span>
-<span class="sd">    MultiDict([(&#39;a&#39;, &#39;b&#39;), (&#39;a&#39;, &#39;c&#39;)])</span>
-<span class="sd">    &gt;&gt;&gt; d[&#39;a&#39;]</span>
-<span class="sd">    &#39;b&#39;</span>
-<span class="sd">    &gt;&gt;&gt; d.getlist(&#39;a&#39;)</span>
-<span class="sd">    [&#39;b&#39;, &#39;c&#39;]</span>
-<span class="sd">    &gt;&gt;&gt; &#39;a&#39; in d</span>
-<span class="sd">    True</span>
-
-<span class="sd">    It behaves like a normal dict thus all dict functions will only return the</span>
-<span class="sd">    first value when multiple values for one key are found.</span>
-
-<span class="sd">    From Werkzeug 0.3 onwards, the `KeyError` raised by this class is also a</span>
-<span class="sd">    subclass of the :exc:`~exceptions.BadRequest` HTTP exception and will</span>
-<span class="sd">    render a page for a ``400 BAD REQUEST`` if caught in a catch-all for HTTP</span>
-<span class="sd">    exceptions.</span>
-
-<span class="sd">    A :class:`MultiDict` can be constructed from an iterable of</span>
-<span class="sd">    ``(key, value)`` tuples, a dict, a :class:`MultiDict` or from Werkzeug 0.2</span>
-<span class="sd">    onwards some keyword parameters.</span>
-
-<span class="sd">    :param mapping: the initial value for the :class:`MultiDict`.  Either a</span>
-<span class="sd">                    regular dict, an iterable of ``(key, value)`` tuples</span>
-<span class="sd">                    or `None`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">mapping</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="n">MultiDict</span><span class="p">):</span>
-            <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="p">((</span><span class="n">k</span><span class="p">,</span> <span class="n">l</span><span class="p">[:])</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">l</span> <span class="ow">in</span> <span class="n">iterlists</span><span class="p">(</span><span class="n">mapping</span><span class="p">)))</span>
-        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-            <span class="n">tmp</span> <span class="o">=</span> <span class="p">{}</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">mapping</span><span class="p">):</span>
-                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">)):</span>
-                    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-                        <span class="k">continue</span>
-                    <span class="n">value</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-                <span class="k">else</span><span class="p">:</span>
-                    <span class="n">value</span> <span class="o">=</span> <span class="p">[</span><span class="n">value</span><span class="p">]</span>
-                <span class="n">tmp</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-            <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">tmp</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">tmp</span> <span class="o">=</span> <span class="p">{}</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">():</span>
-                <span class="n">tmp</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-            <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">tmp</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__getstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lists</span><span class="p">())</span>
-
-    <span class="k">def</span> <span class="nf">__setstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the first data value for this key;</span>
-<span class="sd">        raises KeyError if not found.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :raise KeyError: if the key does not exist.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="n">lst</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">lst</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">lst</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-        <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`add` but removes an existing key first.</span>
-
-<span class="sd">        :param key: the key for the value.</span>
-<span class="sd">        :param value: the value to set.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="p">[</span><span class="n">value</span><span class="p">])</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Adds a new value for the key.</span>
-
-<span class="sd">        .. versionadded:: 0.6</span>
-
-<span class="sd">        :param key: the key for the value.</span>
-<span class="sd">        :param value: the value to add.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">getlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the list of items for a given key. If that key is not in the</span>
-<span class="sd">        `MultiDict`, the return value will be an empty list.  Just as `get`</span>
-<span class="sd">        `getlist` accepts a `type` parameter.  All items will be converted</span>
-<span class="sd">        with the callable defined there.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param type: A callable that is used to cast the value in the</span>
-<span class="sd">                     :class:`MultiDict`.  If a :exc:`ValueError` is raised</span>
-<span class="sd">                     by this callable the value will be removed from the list.</span>
-<span class="sd">        :return: a :class:`list` of all the values for the key.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-            <span class="k">return</span> <span class="p">[]</span>
-        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">rv</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">type</span><span class="p">(</span><span class="n">item</span><span class="p">))</span>
-            <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-                <span class="k">pass</span>
-        <span class="k">return</span> <span class="n">result</span>
-
-    <span class="k">def</span> <span class="nf">setlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">new_list</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Remove the old values for a key and add new ones.  Note that the list</span>
-<span class="sd">        you pass the values in will be shallow-copied before it is inserted in</span>
-<span class="sd">        the dictionary.</span>
-
-<span class="sd">        &gt;&gt;&gt; d = MultiDict()</span>
-<span class="sd">        &gt;&gt;&gt; d.setlist(&#39;foo&#39;, [&#39;1&#39;, &#39;2&#39;])</span>
-<span class="sd">        &gt;&gt;&gt; d[&#39;foo&#39;]</span>
-<span class="sd">        &#39;1&#39;</span>
-<span class="sd">        &gt;&gt;&gt; d.getlist(&#39;foo&#39;)</span>
-<span class="sd">        [&#39;1&#39;, &#39;2&#39;]</span>
-
-<span class="sd">        :param key: The key for which the values are set.</span>
-<span class="sd">        :param new_list: An iterable with the new values for the key.  Old values</span>
-<span class="sd">                         are removed first.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="nb">list</span><span class="p">(</span><span class="n">new_list</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the value for the key if it is in the dict, otherwise it</span>
-<span class="sd">        returns `default` and sets that value for `key`.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param default: The default value to be returned if the key is not</span>
-<span class="sd">                        in the dict.  If not further specified it&#39;s `None`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">default</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">default</span> <span class="o">=</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-        <span class="k">return</span> <span class="n">default</span>
-
-    <span class="k">def</span> <span class="nf">setlistdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default_list</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like `setdefault` but sets multiple values.  The list returned</span>
-<span class="sd">        is not a copy, but the list that is actually used internally.  This</span>
-<span class="sd">        means that you can put new values into the dict by appending items</span>
-<span class="sd">        to the list:</span>
-
-<span class="sd">        &gt;&gt;&gt; d = MultiDict({&quot;foo&quot;: 1})</span>
-<span class="sd">        &gt;&gt;&gt; d.setlistdefault(&quot;foo&quot;).extend([2, 3])</span>
-<span class="sd">        &gt;&gt;&gt; d.getlist(&quot;foo&quot;)</span>
-<span class="sd">        [1, 2, 3]</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param default: An iterable of default values.  It is either copied</span>
-<span class="sd">                        (in case it was a list) or converted into a list</span>
-<span class="sd">                        before returned.</span>
-<span class="sd">        :return: a :class:`list`</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="n">default_list</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">default_list</span> <span class="ow">or</span> <span class="p">())</span>
-            <span class="nb">dict</span><span class="o">.</span><span class="n">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default_list</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">default_list</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">default_list</span>
-
-    <span class="k">def</span> <span class="nf">items</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return an iterator of ``(key, value)`` pairs.</span>
-
-<span class="sd">        :param multi: If set to `True` the iterator returned will have a pair</span>
-<span class="sd">                      for each value of each key.  Otherwise it will only</span>
-<span class="sd">                      contain pairs for the first value of each key.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">values</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="bp">self</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">multi</span><span class="p">:</span>
-                <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">values</span><span class="p">:</span>
-                    <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">values</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">lists</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a list of ``(key, values)`` pairs, where values is the list</span>
-<span class="sd">        of all values associated with the key.&quot;&quot;&quot;</span>
-
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">values</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="bp">self</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="nb">list</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">keys</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">iterkeys</span><span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
-
-    <span class="n">__iter__</span> <span class="o">=</span> <span class="n">keys</span>
-
-    <span class="k">def</span> <span class="nf">values</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns an iterator of the first value on every key&#39;s value list.&quot;&quot;&quot;</span>
-        <span class="k">for</span> <span class="n">values</span> <span class="ow">in</span> <span class="n">itervalues</span><span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="bp">self</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">values</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">listvalues</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return an iterator of all values associated with a key.  Zipping</span>
-<span class="sd">        :meth:`keys` and this is the same as calling :meth:`lists`:</span>
-
-<span class="sd">        &gt;&gt;&gt; d = MultiDict({&quot;foo&quot;: [1, 2, 3]})</span>
-<span class="sd">        &gt;&gt;&gt; zip(d.keys(), d.listvalues()) == d.lists()</span>
-<span class="sd">        True</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-
-        <span class="k">return</span> <span class="n">itervalues</span><span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a shallow copy of this object.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">deepcopy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">memo</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a deep copy of this object.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="p">(</span><span class="n">deepcopy</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">to_dict</span><span class="p">(</span><span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">),</span> <span class="n">memo</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">to_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the contents as regular dict.  If `flat` is `True` the</span>
-<span class="sd">        returned dict will only have the first item present, if `flat` is</span>
-<span class="sd">        `False` all values will be returned as lists.</span>
-
-<span class="sd">        :param flat: If set to `False` the dict returned will have lists</span>
-<span class="sd">                     with all the values in it.  Otherwise it will only</span>
-<span class="sd">                     contain the first value for each key.</span>
-<span class="sd">        :return: a :class:`dict`</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">flat</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-        <span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lists</span><span class="p">())</span>
-
-    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other_dict</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;update() extends rather than replaces existing key lists:</span>
-
-<span class="sd">        &gt;&gt;&gt; a = MultiDict({&#39;x&#39;: 1})</span>
-<span class="sd">        &gt;&gt;&gt; b = MultiDict({&#39;x&#39;: 2, &#39;y&#39;: 3})</span>
-<span class="sd">        &gt;&gt;&gt; a.update(b)</span>
-<span class="sd">        &gt;&gt;&gt; a</span>
-<span class="sd">        MultiDict([(&#39;y&#39;, 3), (&#39;x&#39;, 1), (&#39;x&#39;, 2)])</span>
-
-<span class="sd">        If the value list for a key in ``other_dict`` is empty, no new values</span>
-<span class="sd">        will be added to the dict and the key will not be created:</span>
-
-<span class="sd">        &gt;&gt;&gt; x = {&#39;empty_list&#39;: []}</span>
-<span class="sd">        &gt;&gt;&gt; y = MultiDict()</span>
-<span class="sd">        &gt;&gt;&gt; y.update(x)</span>
-<span class="sd">        &gt;&gt;&gt; y</span>
-<span class="sd">        MultiDict([])</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iter_multi_items</span><span class="p">(</span><span class="n">other_dict</span><span class="p">):</span>
-            <span class="n">MultiDict</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">_missing</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Pop the first item for a list on the dict.  Afterwards the</span>
-<span class="sd">        key is removed from the dict, so additional values are discarded:</span>
-
-<span class="sd">        &gt;&gt;&gt; d = MultiDict({&quot;foo&quot;: [1, 2, 3]})</span>
-<span class="sd">        &gt;&gt;&gt; d.pop(&quot;foo&quot;)</span>
-<span class="sd">        1</span>
-<span class="sd">        &gt;&gt;&gt; &quot;foo&quot; in d</span>
-<span class="sd">        False</span>
-
-<span class="sd">        :param key: the key to pop.</span>
-<span class="sd">        :param default: if provided the value to return if the key was</span>
-<span class="sd">                        not in the dictionary.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">dict</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-        <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">default</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">_missing</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">default</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Pop an item from the dict.&quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">item</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-            <span class="k">return</span> <span class="p">(</span><span class="n">item</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">item</span><span class="p">[</span><span class="mi">1</span><span class="p">][</span><span class="mi">0</span><span class="p">])</span>
-        <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">poplist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Pop the list for a key from the dict.  If the key is not in the dict</span>
-<span class="sd">        an empty list is returned.</span>
-
-<span class="sd">        .. versionchanged:: 0.5</span>
-<span class="sd">           If the key does no longer exist a list is returned instead of</span>
-<span class="sd">           raising an error.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">dict</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="p">[])</span>
-
-    <span class="k">def</span> <span class="nf">popitemlist</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Pop a ``(key, list)`` tuple from the dict.&quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">dict</span><span class="o">.</span><span class="n">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__deepcopy__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">memo</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">deepcopy</span><span class="p">(</span><span class="n">memo</span><span class="o">=</span><span class="n">memo</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">list</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)))</span>
-
-
-<span class="k">class</span> <span class="nc">_omd_bucket</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Wraps values in the :class:`OrderedMultiDict`.  This makes it</span>
-<span class="sd">    possible to keep an order over multiple different keys.  It requires</span>
-<span class="sd">    a lot of extra memory and slows down access a lot, but makes it</span>
-<span class="sd">    possible to access elements in O(1) and iterate in O(n).</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">__slots__</span> <span class="o">=</span> <span class="p">(</span><span class="s1">&#39;prev&#39;</span><span class="p">,</span> <span class="s1">&#39;key&#39;</span><span class="p">,</span> <span class="s1">&#39;value&#39;</span><span class="p">,</span> <span class="s1">&#39;next&#39;</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">omd</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">prev</span> <span class="o">=</span> <span class="n">omd</span><span class="o">.</span><span class="n">_last_bucket</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">key</span> <span class="o">=</span> <span class="n">key</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="n">value</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">next</span> <span class="o">=</span> <span class="kc">None</span>
-
-        <span class="k">if</span> <span class="n">omd</span><span class="o">.</span><span class="n">_first_bucket</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">omd</span><span class="o">.</span><span class="n">_first_bucket</span> <span class="o">=</span> <span class="bp">self</span>
-        <span class="k">if</span> <span class="n">omd</span><span class="o">.</span><span class="n">_last_bucket</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">omd</span><span class="o">.</span><span class="n">_last_bucket</span><span class="o">.</span><span class="n">next</span> <span class="o">=</span> <span class="bp">self</span>
-        <span class="n">omd</span><span class="o">.</span><span class="n">_last_bucket</span> <span class="o">=</span> <span class="bp">self</span>
-
-    <span class="k">def</span> <span class="nf">unlink</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">omd</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">prev</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">prev</span><span class="o">.</span><span class="n">next</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">next</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">next</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">next</span><span class="o">.</span><span class="n">prev</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">prev</span>
-        <span class="k">if</span> <span class="n">omd</span><span class="o">.</span><span class="n">_first_bucket</span> <span class="ow">is</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="n">omd</span><span class="o">.</span><span class="n">_first_bucket</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">next</span>
-        <span class="k">if</span> <span class="n">omd</span><span class="o">.</span><span class="n">_last_bucket</span> <span class="ow">is</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="n">omd</span><span class="o">.</span><span class="n">_last_bucket</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">prev</span>
-
-
-<span class="nd">@native_itermethods</span><span class="p">([</span><span class="s1">&#39;keys&#39;</span><span class="p">,</span> <span class="s1">&#39;values&#39;</span><span class="p">,</span> <span class="s1">&#39;items&#39;</span><span class="p">,</span> <span class="s1">&#39;lists&#39;</span><span class="p">,</span> <span class="s1">&#39;listvalues&#39;</span><span class="p">])</span>
-<span class="k">class</span> <span class="nc">OrderedMultiDict</span><span class="p">(</span><span class="n">MultiDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Works like a regular :class:`MultiDict` but preserves the</span>
-<span class="sd">    order of the fields.  To convert the ordered multi dict into a</span>
-<span class="sd">    list you can use the :meth:`items` method and pass it ``multi=True``.</span>
-
-<span class="sd">    In general an :class:`OrderedMultiDict` is an order of magnitude</span>
-<span class="sd">    slower than a :class:`MultiDict`.</span>
-
-<span class="sd">    .. admonition:: note</span>
-
-<span class="sd">       Due to a limitation in Python you cannot convert an ordered</span>
-<span class="sd">       multi dict into a regular dict by using ``dict(multidict)``.</span>
-<span class="sd">       Instead you have to use the :meth:`to_dict` method, otherwise</span>
-<span class="sd">       the internal bucket objects are exposed.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">mapping</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_first_bucket</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_last_bucket</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">if</span> <span class="n">mapping</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">OrderedMultiDict</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">mapping</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__eq__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">other</span><span class="p">,</span> <span class="n">MultiDict</span><span class="p">):</span>
-            <span class="k">return</span> <span class="bp">NotImplemented</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">other</span><span class="p">,</span> <span class="n">OrderedMultiDict</span><span class="p">):</span>
-            <span class="n">iter1</span> <span class="o">=</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-            <span class="n">iter2</span> <span class="o">=</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">other</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="k">for</span> <span class="n">k1</span><span class="p">,</span> <span class="n">v1</span> <span class="ow">in</span> <span class="n">iter1</span><span class="p">:</span>
-                    <span class="n">k2</span><span class="p">,</span> <span class="n">v2</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">iter2</span><span class="p">)</span>
-                    <span class="k">if</span> <span class="n">k1</span> <span class="o">!=</span> <span class="n">k2</span> <span class="ow">or</span> <span class="n">v1</span> <span class="o">!=</span> <span class="n">v2</span><span class="p">:</span>
-                        <span class="k">return</span> <span class="kc">False</span>
-            <span class="k">except</span> <span class="ne">StopIteration</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">False</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="nb">next</span><span class="p">(</span><span class="n">iter2</span><span class="p">)</span>
-            <span class="k">except</span> <span class="ne">StopIteration</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">True</span>
-            <span class="k">return</span> <span class="kc">False</span>
-        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">other</span><span class="p">):</span>
-            <span class="k">return</span> <span class="kc">False</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">values</span> <span class="ow">in</span> <span class="n">iterlists</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">other</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="o">!=</span> <span class="n">values</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">False</span>
-        <span class="k">return</span> <span class="kc">True</span>
-
-    <span class="k">def</span> <span class="nf">__ne__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">__eq__</span><span class="p">(</span><span class="n">other</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__reduce_ex__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">protocol</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span> <span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)),)</span>
-
-    <span class="k">def</span> <span class="nf">__getstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">__setstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">values</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">value</span>
-        <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">poplist</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__delitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">keys</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">(</span><span class="n">key</span> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-
-    <span class="n">__iter__</span> <span class="o">=</span> <span class="n">keys</span>
-
-    <span class="k">def</span> <span class="nf">values</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">(</span><span class="n">value</span> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">items</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="n">ptr</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_first_bucket</span>
-        <span class="k">if</span> <span class="n">multi</span><span class="p">:</span>
-            <span class="k">while</span> <span class="n">ptr</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="n">ptr</span><span class="o">.</span><span class="n">key</span><span class="p">,</span> <span class="n">ptr</span><span class="o">.</span><span class="n">value</span>
-                <span class="n">ptr</span> <span class="o">=</span> <span class="n">ptr</span><span class="o">.</span><span class="n">next</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">returned_keys</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-            <span class="k">while</span> <span class="n">ptr</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">ptr</span><span class="o">.</span><span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">returned_keys</span><span class="p">:</span>
-                    <span class="n">returned_keys</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">ptr</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
-                    <span class="k">yield</span> <span class="n">ptr</span><span class="o">.</span><span class="n">key</span><span class="p">,</span> <span class="n">ptr</span><span class="o">.</span><span class="n">value</span>
-                <span class="n">ptr</span> <span class="o">=</span> <span class="n">ptr</span><span class="o">.</span><span class="n">next</span>
-
-    <span class="k">def</span> <span class="nf">lists</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">returned_keys</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="n">ptr</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_first_bucket</span>
-        <span class="k">while</span> <span class="n">ptr</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">ptr</span><span class="o">.</span><span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">returned_keys</span><span class="p">:</span>
-                <span class="k">yield</span> <span class="n">ptr</span><span class="o">.</span><span class="n">key</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">ptr</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
-                <span class="n">returned_keys</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">ptr</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
-            <span class="n">ptr</span> <span class="o">=</span> <span class="n">ptr</span><span class="o">.</span><span class="n">next</span>
-
-    <span class="k">def</span> <span class="nf">listvalues</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">values</span> <span class="ow">in</span> <span class="n">iterlists</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">values</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">_omd_bucket</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">getlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-            <span class="k">return</span> <span class="p">[]</span>
-        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">value</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">rv</span><span class="p">]</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">rv</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">type</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">value</span><span class="p">))</span>
-            <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-                <span class="k">pass</span>
-        <span class="k">return</span> <span class="n">result</span>
-
-    <span class="k">def</span> <span class="nf">setlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">new_list</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">poplist</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">new_list</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">setlistdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default_list</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;setlistdefault is unsupported for &#39;</span>
-                        <span class="s1">&#39;ordered multi dicts&#39;</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">mapping</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iter_multi_items</span><span class="p">(</span><span class="n">mapping</span><span class="p">):</span>
-            <span class="n">OrderedMultiDict</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">poplist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="n">buckets</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="p">())</span>
-        <span class="k">for</span> <span class="n">bucket</span> <span class="ow">in</span> <span class="n">buckets</span><span class="p">:</span>
-            <span class="n">bucket</span><span class="o">.</span><span class="n">unlink</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">value</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">buckets</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">_missing</span><span class="p">):</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">buckets</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">default</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">_missing</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">default</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-        <span class="k">for</span> <span class="n">bucket</span> <span class="ow">in</span> <span class="n">buckets</span><span class="p">:</span>
-            <span class="n">bucket</span><span class="o">.</span><span class="n">unlink</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">buckets</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">key</span><span class="p">,</span> <span class="n">buckets</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-        <span class="k">for</span> <span class="n">bucket</span> <span class="ow">in</span> <span class="n">buckets</span><span class="p">:</span>
-            <span class="n">bucket</span><span class="o">.</span><span class="n">unlink</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">key</span><span class="p">,</span> <span class="n">buckets</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">popitemlist</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">key</span><span class="p">,</span> <span class="n">buckets</span> <span class="o">=</span> <span class="nb">dict</span><span class="o">.</span><span class="n">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
-        <span class="k">for</span> <span class="n">bucket</span> <span class="ow">in</span> <span class="n">buckets</span><span class="p">:</span>
-            <span class="n">bucket</span><span class="o">.</span><span class="n">unlink</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">key</span><span class="p">,</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">value</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">buckets</span><span class="p">]</span>
-
-
-<span class="k">def</span> <span class="nf">_options_header_vkw</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">kw</span><span class="p">):</span>
-    <span class="k">return</span> <span class="n">dump_options_header</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">dict</span><span class="p">((</span><span class="n">k</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;_&#39;</span><span class="p">,</span> <span class="s1">&#39;-&#39;</span><span class="p">),</span> <span class="n">v</span><span class="p">)</span>
-                                           <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">kw</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span>
-
-
-<span class="k">def</span> <span class="nf">_unicodify_header_value</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s1">&#39;latin-1&#39;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">text_type</span><span class="p">):</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="n">text_type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">value</span>
-
-
-<span class="nd">@native_itermethods</span><span class="p">([</span><span class="s1">&#39;keys&#39;</span><span class="p">,</span> <span class="s1">&#39;values&#39;</span><span class="p">,</span> <span class="s1">&#39;items&#39;</span><span class="p">])</span>
-<span class="k">class</span> <span class="nc">Headers</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;An object that stores some headers.  It has a dict-like interface</span>
-<span class="sd">    but is ordered and can store the same keys multiple times.</span>
-
-<span class="sd">    This data structure is useful if you want a nicer way to handle WSGI</span>
-<span class="sd">    headers which are stored as tuples in a list.</span>
-
-<span class="sd">    From Werkzeug 0.3 onwards, the :exc:`KeyError` raised by this class is</span>
-<span class="sd">    also a subclass of the :class:`~exceptions.BadRequest` HTTP exception</span>
-<span class="sd">    and will render a page for a ``400 BAD REQUEST`` if caught in a</span>
-<span class="sd">    catch-all for HTTP exceptions.</span>
-
-<span class="sd">    Headers is mostly compatible with the Python :class:`wsgiref.headers.Headers`</span>
-<span class="sd">    class, with the exception of `__getitem__`.  :mod:`wsgiref` will return</span>
-<span class="sd">    `None` for ``headers[&#39;missing&#39;]``, whereas :class:`Headers` will raise</span>
-<span class="sd">    a :class:`KeyError`.</span>
-
-<span class="sd">    To create a new :class:`Headers` object pass it a list or dict of headers</span>
-<span class="sd">    which are used as default values.  This does not reuse the list passed</span>
-<span class="sd">    to the constructor for internal usage.</span>
-
-<span class="sd">    :param defaults: The list of default values for the :class:`Headers`.</span>
-
-<span class="sd">    .. versionchanged:: 0.9</span>
-<span class="sd">       This data structure now stores unicode values similar to how the</span>
-<span class="sd">       multi dicts do it.  The main difference is that bytes can be set as</span>
-<span class="sd">       well which will automatically be latin1 decoded.</span>
-
-<span class="sd">    .. versionchanged:: 0.9</span>
-<span class="sd">       The :meth:`linked` function was removed without replacement as it</span>
-<span class="sd">       was an API that does not support the changes to the encoding model.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">defaults</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_list</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">if</span> <span class="n">defaults</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">defaults</span><span class="p">,</span> <span class="p">(</span><span class="nb">list</span><span class="p">,</span> <span class="n">Headers</span><span class="p">)):</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">defaults</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">defaults</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">_get_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">_get_mode</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">):</span>
-                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-            <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="nb">slice</span><span class="p">):</span>
-                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">key</span><span class="p">])</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="n">ikey</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">k</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="n">ikey</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">v</span>
-        <span class="c1"># micro optimization: if we are in get mode we will catch that</span>
-        <span class="c1"># exception one stack level down so we can raise a standard</span>
-        <span class="c1"># key error instead of our special one.</span>
-        <span class="k">if</span> <span class="n">_get_mode</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">KeyError</span><span class="p">()</span>
-        <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__eq__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">other</span><span class="o">.</span><span class="n">__class__</span> <span class="ow">is</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span> <span class="ow">and</span> \
-            <span class="nb">set</span><span class="p">(</span><span class="n">other</span><span class="o">.</span><span class="n">_list</span><span class="p">)</span> <span class="o">==</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__ne__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">__eq__</span><span class="p">(</span><span class="n">other</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">as_bytes</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the default value if the requested data doesn&#39;t exist.</span>
-<span class="sd">        If `type` is provided and is a callable it should convert the value,</span>
-<span class="sd">        return it or raise a :exc:`ValueError` if that is not possible.  In</span>
-<span class="sd">        this case the function will return the default as if the value was not</span>
-<span class="sd">        found:</span>
-
-<span class="sd">        &gt;&gt;&gt; d = Headers([(&#39;Content-Length&#39;, &#39;42&#39;)])</span>
-<span class="sd">        &gt;&gt;&gt; d.get(&#39;Content-Length&#39;, type=int)</span>
-<span class="sd">        42</span>
-
-<span class="sd">        If a headers object is bound you must not add unicode strings</span>
-<span class="sd">        because no encoding takes place.</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">           Added support for `as_bytes`.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param default: The default value to be returned if the key can&#39;t</span>
-<span class="sd">                        be looked up.  If not further specified `None` is</span>
-<span class="sd">                        returned.</span>
-<span class="sd">        :param type: A callable that is used to cast the value in the</span>
-<span class="sd">                     :class:`Headers`.  If a :exc:`ValueError` is raised</span>
-<span class="sd">                     by this callable the default value is returned.</span>
-<span class="sd">        :param as_bytes: return bytes instead of unicode strings.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">_get_mode</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">default</span>
-        <span class="k">if</span> <span class="n">as_bytes</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="n">rv</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;latin1&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">rv</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">default</span>
-
-    <span class="k">def</span> <span class="nf">getlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">as_bytes</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the list of items for a given key. If that key is not in the</span>
-<span class="sd">        :class:`Headers`, the return value will be an empty list.  Just as</span>
-<span class="sd">        :meth:`get` :meth:`getlist` accepts a `type` parameter.  All items will</span>
-<span class="sd">        be converted with the callable defined there.</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">           Added support for `as_bytes`.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param type: A callable that is used to cast the value in the</span>
-<span class="sd">                     :class:`Headers`.  If a :exc:`ValueError` is raised</span>
-<span class="sd">                     by this callable the value will be removed from the list.</span>
-<span class="sd">        :return: a :class:`list` of all the values for the key.</span>
-<span class="sd">        :param as_bytes: return bytes instead of unicode strings.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">ikey</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">k</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="n">ikey</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">as_bytes</span><span class="p">:</span>
-                    <span class="n">v</span> <span class="o">=</span> <span class="n">v</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;latin1&#39;</span><span class="p">)</span>
-                <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="k">try</span><span class="p">:</span>
-                        <span class="n">v</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>
-                    <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-                        <span class="k">continue</span>
-                <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">result</span>
-
-    <span class="k">def</span> <span class="nf">get_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a list of all the values for the named field.</span>
-
-<span class="sd">        This method is compatible with the :mod:`wsgiref`</span>
-<span class="sd">        :meth:`~wsgiref.headers.Headers.get_all` method.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">items</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">lower</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">lower</span><span class="p">:</span>
-                <span class="n">key</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-            <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">keys</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">lower</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">lower</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">key</span>
-
-    <span class="k">def</span> <span class="nf">values</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">extend</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">iterable</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Extend the headers with a dict or an iterable yielding keys and</span>
-<span class="sd">        values.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">iterable</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">iterable</span><span class="p">):</span>
-                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">)):</span>
-                    <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
-                        <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span>
-                <span class="k">else</span><span class="p">:</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iterable</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__delitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">_index_operation</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">_index_operation</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">(</span><span class="n">integer_types</span><span class="p">,</span> <span class="nb">slice</span><span class="p">)):</span>
-            <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-            <span class="k">return</span>
-        <span class="n">key</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="n">new</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">k</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">!=</span> <span class="n">key</span><span class="p">:</span>
-                <span class="n">new</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">k</span><span class="p">,</span> <span class="n">v</span><span class="p">))</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[:]</span> <span class="o">=</span> <span class="n">new</span>
-
-    <span class="k">def</span> <span class="nf">remove</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Remove a key.</span>
-
-<span class="sd">        :param key: The key to be removed.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__delitem__</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">_index_operation</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">_missing</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Removes and returns a key or index.</span>
-
-<span class="sd">        :param key: The key to be popped.  If this is an integer the item at</span>
-<span class="sd">                    that position is removed, if it&#39;s a string the value for</span>
-<span class="sd">                    that key is.  If the key is omitted or `None` the last</span>
-<span class="sd">                    item is removed.</span>
-<span class="sd">        :return: an item.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">):</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">default</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">_missing</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">default</span>
-            <span class="k">raise</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Removes a key or index and returns a (key, value) item.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__contains__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if a key is present.&quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">_get_mode</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-        <span class="k">return</span> <span class="kc">True</span>
-
-    <span class="n">has_key</span> <span class="o">=</span> <span class="n">__contains__</span>
-
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Yield ``(key, value)`` tuples.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__len__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Add a new header tuple to the list.</span>
-
-<span class="sd">        Keyword arguments can specify additional parameters for the header</span>
-<span class="sd">        value, with underscores converted to dashes::</span>
-
-<span class="sd">        &gt;&gt;&gt; d = Headers()</span>
-<span class="sd">        &gt;&gt;&gt; d.add(&#39;Content-Type&#39;, &#39;text/plain&#39;)</span>
-<span class="sd">        &gt;&gt;&gt; d.add(&#39;Content-Disposition&#39;, &#39;attachment&#39;, filename=&#39;foo.png&#39;)</span>
-
-<span class="sd">        The keyword argument dumping uses :func:`dump_options_header`</span>
-<span class="sd">        behind the scenes.</span>
-
-<span class="sd">        .. versionadded:: 0.4.1</span>
-<span class="sd">            keyword arguments were added for :mod:`wsgiref` compatibility.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">kw</span><span class="p">:</span>
-            <span class="n">_value</span> <span class="o">=</span> <span class="n">_options_header_vkw</span><span class="p">(</span><span class="n">_value</span><span class="p">,</span> <span class="n">kw</span><span class="p">)</span>
-        <span class="n">_value</span> <span class="o">=</span> <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="n">_value</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_validate_value</span><span class="p">(</span><span class="n">_value</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">_validate_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">text_type</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;Value should be unicode.&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="s1">u&#39;</span><span class="se">\n</span><span class="s1">&#39;</span> <span class="ow">in</span> <span class="n">value</span> <span class="ow">or</span> <span class="s1">u&#39;</span><span class="se">\r</span><span class="s1">&#39;</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;Detected newline in header value.  This is &#39;</span>
-                             <span class="s1">&#39;a potential security problem&#39;</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">add_header</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">,</span> <span class="o">**</span><span class="n">_kw</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Add a new header tuple to the list.</span>
-
-<span class="sd">        An alias for :meth:`add` for compatibility with the :mod:`wsgiref`</span>
-<span class="sd">        :meth:`~wsgiref.headers.Headers.add_header` method.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">,</span> <span class="o">**</span><span class="n">_kw</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Clears all headers.&quot;&quot;&quot;</span>
-        <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[:]</span>
-
-    <span class="k">def</span> <span class="nf">set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Remove all header tuples for `key` and add a new one.  The newly</span>
-<span class="sd">        added key either appears at the end of the list if there was no</span>
-<span class="sd">        entry or replaces the first one.</span>
-
-<span class="sd">        Keyword arguments can specify additional parameters for the header</span>
-<span class="sd">        value, with underscores converted to dashes.  See :meth:`add` for</span>
-<span class="sd">        more information.</span>
-
-<span class="sd">        .. versionchanged:: 0.6.1</span>
-<span class="sd">           :meth:`set` now accepts the same arguments as :meth:`add`.</span>
-
-<span class="sd">        :param key: The key to be inserted.</span>
-<span class="sd">        :param value: The value to be inserted.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">kw</span><span class="p">:</span>
-            <span class="n">_value</span> <span class="o">=</span> <span class="n">_options_header_vkw</span><span class="p">(</span><span class="n">_value</span><span class="p">,</span> <span class="n">kw</span><span class="p">)</span>
-        <span class="n">_value</span> <span class="o">=</span> <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="n">_value</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_validate_value</span><span class="p">(</span><span class="n">_value</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">))</span>
-            <span class="k">return</span>
-        <span class="n">listiter</span> <span class="o">=</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">)</span>
-        <span class="n">ikey</span> <span class="o">=</span> <span class="n">_key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="p">(</span><span class="n">old_key</span><span class="p">,</span> <span class="n">old_value</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">listiter</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">old_key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="n">ikey</span><span class="p">:</span>
-                <span class="c1"># replace first ocurrence</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">)</span>
-                <span class="k">break</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">_key</span><span class="p">,</span> <span class="n">_value</span><span class="p">))</span>
-            <span class="k">return</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">idx</span> <span class="o">+</span> <span class="mi">1</span><span class="p">:]</span> <span class="o">=</span> <span class="p">[</span><span class="n">t</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">listiter</span> <span class="k">if</span> <span class="n">t</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">!=</span> <span class="n">ikey</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the value for the key if it is in the dict, otherwise it</span>
-<span class="sd">        returns `default` and sets that value for `key`.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        :param default: The default value to be returned if the key is not</span>
-<span class="sd">                        in the dict.  If not further specified it&#39;s `None`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`set` but also supports index/slice based setting.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">(</span><span class="nb">slice</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">)):</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">):</span>
-                <span class="n">value</span> <span class="o">=</span> <span class="p">[</span><span class="n">value</span><span class="p">]</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="p">[(</span><span class="n">k</span><span class="p">,</span> <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="n">v</span><span class="p">))</span> <span class="k">for</span> <span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span> <span class="ow">in</span> <span class="n">value</span><span class="p">]</span>
-            <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_validate_value</span><span class="p">(</span><span class="n">v</span><span class="p">)</span> <span class="k">for</span> <span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span> <span class="ow">in</span> <span class="n">value</span><span class="p">]</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">integer_types</span><span class="p">):</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">charset</span><span class="o">=</span><span class="s1">&#39;iso-8859-1&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the headers into a list suitable for WSGI.&quot;&quot;&quot;</span>
-        <span class="kn">from</span> <span class="nn">warnings</span> <span class="k">import</span> <span class="n">warn</span>
-        <span class="n">warn</span><span class="p">(</span><span class="ne">DeprecationWarning</span><span class="p">(</span><span class="s1">&#39;Method removed, use to_wsgi_list instead&#39;</span><span class="p">),</span>
-             <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_wsgi_list</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">to_wsgi_list</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the headers into a list suitable for WSGI.</span>
-
-<span class="sd">        The values are byte strings in Python 2 converted to latin1 and unicode</span>
-<span class="sd">        strings in Python 3 for the WSGI server to encode.</span>
-
-<span class="sd">        :return: list</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">PY2</span><span class="p">:</span>
-            <span class="k">return</span> <span class="p">[(</span><span class="n">to_native</span><span class="p">(</span><span class="n">k</span><span class="p">),</span> <span class="n">v</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;latin1&#39;</span><span class="p">))</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">]</span>
-        <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_list</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns formatted headers suitable for HTTP transmission.&quot;&quot;&quot;</span>
-        <span class="n">strs</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_wsgi_list</span><span class="p">():</span>
-            <span class="n">strs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">: </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">))</span>
-        <span class="n">strs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\r\n</span><span class="s1">&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="se">\r\n</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">strs</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableHeadersMixin</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Makes a :class:`Headers` immutable.  We do not mark them as</span>
-<span class="sd">    hashable though since the only usecase for this datastructure</span>
-<span class="sd">    in Werkzeug is a view on a mutable structure.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-
-<span class="sd">    :private:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__delitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-    <span class="nb">set</span> <span class="o">=</span> <span class="n">__setitem__</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-    <span class="n">remove</span> <span class="o">=</span> <span class="n">add_header</span> <span class="o">=</span> <span class="n">add</span>
-
-    <span class="k">def</span> <span class="nf">extend</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">iterable</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">insert</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">pos</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">pop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">index</span><span class="o">=-</span><span class="mi">1</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">popitem</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">setdefault</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="p">):</span>
-        <span class="n">is_immutable</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">EnvironHeaders</span><span class="p">(</span><span class="n">ImmutableHeadersMixin</span><span class="p">,</span> <span class="n">Headers</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Read only version of the headers from a WSGI environment.  This</span>
-<span class="sd">    provides the same interface as `Headers` and is constructed from</span>
-<span class="sd">    a WSGI environment.</span>
-
-<span class="sd">    From Werkzeug 0.3 onwards, the `KeyError` raised by this class is also a</span>
-<span class="sd">    subclass of the :exc:`~exceptions.BadRequest` HTTP exception and will</span>
-<span class="sd">    render a page for a ``400 BAD REQUEST`` if caught in a catch-all for</span>
-<span class="sd">    HTTP exceptions.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">environ</span> <span class="o">=</span> <span class="n">environ</span>
-
-    <span class="k">def</span> <span class="nf">__eq__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">environ</span> <span class="ow">is</span> <span class="n">other</span><span class="o">.</span><span class="n">environ</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">_get_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="c1"># _get_mode is a no-op for this class as there is no index but</span>
-        <span class="c1"># used because get() calls it.</span>
-        <span class="n">key</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;-&#39;</span><span class="p">,</span> <span class="s1">&#39;_&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;CONTENT_TYPE&#39;</span><span class="p">,</span> <span class="s1">&#39;CONTENT_LENGTH&#39;</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="n">key</span><span class="p">])</span>
-        <span class="k">return</span> <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;HTTP_&#39;</span> <span class="o">+</span> <span class="n">key</span><span class="p">])</span>
-
-    <span class="k">def</span> <span class="nf">__len__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="c1"># the iter is necessary because otherwise list calls our</span>
-        <span class="c1"># len which would call list again and so forth.</span>
-        <span class="k">return</span> <span class="nb">len</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="p">)))</span>
-
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">environ</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">key</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;HTTP_&#39;</span><span class="p">)</span> <span class="ow">and</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> \
-               <span class="p">(</span><span class="s1">&#39;HTTP_CONTENT_TYPE&#39;</span><span class="p">,</span> <span class="s1">&#39;HTTP_CONTENT_LENGTH&#39;</span><span class="p">):</span>
-                <span class="k">yield</span> <span class="p">(</span><span class="n">key</span><span class="p">[</span><span class="mi">5</span><span class="p">:]</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;_&#39;</span><span class="p">,</span> <span class="s1">&#39;-&#39;</span><span class="p">)</span><span class="o">.</span><span class="n">title</span><span class="p">(),</span>
-                       <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="n">value</span><span class="p">))</span>
-            <span class="k">elif</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">&#39;CONTENT_TYPE&#39;</span><span class="p">,</span> <span class="s1">&#39;CONTENT_LENGTH&#39;</span><span class="p">):</span>
-                <span class="k">yield</span> <span class="p">(</span><span class="n">key</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">&#39;_&#39;</span><span class="p">,</span> <span class="s1">&#39;-&#39;</span><span class="p">)</span><span class="o">.</span><span class="n">title</span><span class="p">(),</span>
-                       <span class="n">_unicodify_header_value</span><span class="p">(</span><span class="n">value</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;cannot create </span><span class="si">%r</span><span class="s1"> copies&#39;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
-
-
-<span class="nd">@native_itermethods</span><span class="p">([</span><span class="s1">&#39;keys&#39;</span><span class="p">,</span> <span class="s1">&#39;values&#39;</span><span class="p">,</span> <span class="s1">&#39;items&#39;</span><span class="p">,</span> <span class="s1">&#39;lists&#39;</span><span class="p">,</span> <span class="s1">&#39;listvalues&#39;</span><span class="p">])</span>
-<span class="k">class</span> <span class="nc">CombinedMultiDict</span><span class="p">(</span><span class="n">ImmutableMultiDictMixin</span><span class="p">,</span> <span class="n">MultiDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A read only :class:`MultiDict` that you can pass multiple :class:`MultiDict`</span>
-<span class="sd">    instances as sequence and it will combine the return values of all wrapped</span>
-<span class="sd">    dicts:</span>
-
-<span class="sd">    &gt;&gt;&gt; from werkzeug.datastructures import CombinedMultiDict, MultiDict</span>
-<span class="sd">    &gt;&gt;&gt; post = MultiDict([(&#39;foo&#39;, &#39;bar&#39;)])</span>
-<span class="sd">    &gt;&gt;&gt; get = MultiDict([(&#39;blub&#39;, &#39;blah&#39;)])</span>
-<span class="sd">    &gt;&gt;&gt; combined = CombinedMultiDict([get, post])</span>
-<span class="sd">    &gt;&gt;&gt; combined[&#39;foo&#39;]</span>
-<span class="sd">    &#39;bar&#39;</span>
-<span class="sd">    &gt;&gt;&gt; combined[&#39;blub&#39;]</span>
-<span class="sd">    &#39;blah&#39;</span>
-
-<span class="sd">    This works for all read operations and will raise a `TypeError` for</span>
-<span class="sd">    methods that usually change data which isn&#39;t possible.</span>
-
-<span class="sd">    From Werkzeug 0.3 onwards, the `KeyError` raised by this class is also a</span>
-<span class="sd">    subclass of the :exc:`~exceptions.BadRequest` HTTP exception and will</span>
-<span class="sd">    render a page for a ``400 BAD REQUEST`` if caught in a catch-all for HTTP</span>
-<span class="sd">    exceptions.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__reduce_ex__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">protocol</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">,)</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dicts</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span> <span class="o">=</span> <span class="n">dicts</span> <span class="ow">or</span> <span class="p">[]</span>
-
-    <span class="nd">@classmethod</span>
-    <span class="k">def</span> <span class="nf">fromkeys</span><span class="p">(</span><span class="n">cls</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;cannot create </span><span class="si">%r</span><span class="s1"> instances by fromkeys&#39;</span> <span class="o">%</span>
-                        <span class="n">cls</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">d</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">d</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-        <span class="k">raise</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">BadRequestKeyError</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">d</span><span class="p">:</span>
-                <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="k">try</span><span class="p">:</span>
-                        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="n">d</span><span class="p">[</span><span class="n">key</span><span class="p">])</span>
-                    <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-                        <span class="k">continue</span>
-                <span class="k">return</span> <span class="n">d</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-        <span class="k">return</span> <span class="n">default</span>
-
-    <span class="k">def</span> <span class="nf">getlist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">d</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="nb">type</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">_keys_impl</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This function exists so __len__ can be implemented more efficiently,</span>
-<span class="sd">        saving one list creation from an iterator.</span>
-
-<span class="sd">        Using this for Python 2&#39;s ``dict.keys`` behavior would be useless since</span>
-<span class="sd">        `dict.keys` in Python 2 returns a list, while we have a set here.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">iterkeys</span><span class="p">(</span><span class="n">d</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">keys</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_keys_impl</span><span class="p">())</span>
-
-    <span class="n">__iter__</span> <span class="o">=</span> <span class="n">keys</span>
-
-    <span class="k">def</span> <span class="nf">items</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="n">found</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">d</span><span class="p">,</span> <span class="n">multi</span><span class="p">):</span>
-                <span class="k">if</span> <span class="n">multi</span><span class="p">:</span>
-                    <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span>
-                <span class="k">elif</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">found</span><span class="p">:</span>
-                    <span class="n">found</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-                    <span class="k">yield</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">values</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">yield</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">lists</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">values</span> <span class="ow">in</span> <span class="n">iterlists</span><span class="p">(</span><span class="n">d</span><span class="p">):</span>
-                <span class="n">rv</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">listvalues</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="p">(</span><span class="n">x</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">lists</span><span class="p">())</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a shallow copy of this object.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">[:])</span>
-
-    <span class="k">def</span> <span class="nf">to_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the contents as regular dict.  If `flat` is `True` the</span>
-<span class="sd">        returned dict will only have the first item present, if `flat` is</span>
-<span class="sd">        `False` all values will be returned as lists.</span>
-
-<span class="sd">        :param flat: If set to `False` the dict returned will have lists</span>
-<span class="sd">                     with all the values in it.  Otherwise it will only</span>
-<span class="sd">                     contain the first item for each key.</span>
-<span class="sd">        :return: a :class:`dict`</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">):</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">d</span><span class="o">.</span><span class="n">to_dict</span><span class="p">(</span><span class="n">flat</span><span class="p">))</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">__len__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_keys_impl</span><span class="p">())</span>
-
-    <span class="k">def</span> <span class="nf">__contains__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">d</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">d</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="kc">False</span>
-
-    <span class="n">has_key</span> <span class="o">=</span> <span class="n">__contains__</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">dicts</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">FileMultiDict</span><span class="p">(</span><span class="n">MultiDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A special :class:`MultiDict` that has convenience methods to add</span>
-<span class="sd">    files to it.  This is used for :class:`EnvironBuilder` and generally</span>
-<span class="sd">    useful for unittesting.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">add_file</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">file</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content_type</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Adds a new file to the dict.  `file` can be a file name or</span>
-<span class="sd">        a :class:`file`-like or a :class:`FileStorage` object.</span>
-
-<span class="sd">        :param name: the name of the field.</span>
-<span class="sd">        :param file: a filename or :class:`file`-like object</span>
-<span class="sd">        :param filename: an optional filename</span>
-<span class="sd">        :param content_type: an optional content type</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="n">FileStorage</span><span class="p">):</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="n">file</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-                <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">filename</span> <span class="o">=</span> <span class="n">file</span>
-                <span class="n">file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="s1">&#39;rb&#39;</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">filename</span> <span class="ow">and</span> <span class="n">content_type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">content_type</span> <span class="o">=</span> <span class="n">mimetypes</span><span class="o">.</span><span class="n">guess_type</span><span class="p">(</span><span class="n">filename</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">or</span> \
-                    <span class="s1">&#39;application/octet-stream&#39;</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="n">FileStorage</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="n">filename</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">content_type</span><span class="p">)</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableDict</span><span class="p">(</span><span class="n">ImmutableDictMixin</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;An immutable :class:`dict`.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="nb">dict</span><span class="o">.</span><span class="n">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">),</span>
-        <span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a shallow mutable copy of this object.  Keep in mind that</span>
-<span class="sd">        the standard library&#39;s :func:`copy` function is a no-op for this class</span>
-<span class="sd">        like for any other python immutable type (eg: :class:`tuple`).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableMultiDict</span><span class="p">(</span><span class="n">ImmutableMultiDictMixin</span><span class="p">,</span> <span class="n">MultiDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;An immutable :class:`MultiDict`.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a shallow mutable copy of this object.  Keep in mind that</span>
-<span class="sd">        the standard library&#39;s :func:`copy` function is a no-op for this class</span>
-<span class="sd">        like for any other python immutable type (eg: :class:`tuple`).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">MultiDict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-
-<span class="k">class</span> <span class="nc">ImmutableOrderedMultiDict</span><span class="p">(</span><span class="n">ImmutableMultiDictMixin</span><span class="p">,</span> <span class="n">OrderedMultiDict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;An immutable :class:`OrderedMultiDict`.</span>
-
-<span class="sd">    .. versionadded:: 0.6</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">_iter_hashitems</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">iteritems</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a shallow mutable copy of this object.  Keep in mind that</span>
-<span class="sd">        the standard library&#39;s :func:`copy` function is a no-op for this class</span>
-<span class="sd">        like for any other python immutable type (eg: :class:`tuple`).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">OrderedMultiDict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span>
-
-
-<span class="nd">@native_itermethods</span><span class="p">([</span><span class="s1">&#39;values&#39;</span><span class="p">])</span>
-<span class="k">class</span> <span class="nc">Accept</span><span class="p">(</span><span class="n">ImmutableList</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;An :class:`Accept` object is just a list subclass for lists of</span>
-<span class="sd">    ``(value, quality)`` tuples.  It is automatically sorted by quality.</span>
-
-<span class="sd">    All :class:`Accept` objects work similar to a list but provide extra</span>
-<span class="sd">    functionality for working with the data.  Containment checks are</span>
-<span class="sd">    normalized to the rules of that header:</span>
-
-<span class="sd">    &gt;&gt;&gt; a = CharsetAccept([(&#39;ISO-8859-1&#39;, 1), (&#39;utf-8&#39;, 0.7)])</span>
-<span class="sd">    &gt;&gt;&gt; a.best</span>
-<span class="sd">    &#39;ISO-8859-1&#39;</span>
-<span class="sd">    &gt;&gt;&gt; &#39;iso-8859-1&#39; in a</span>
-<span class="sd">    True</span>
-<span class="sd">    &gt;&gt;&gt; &#39;UTF8&#39; in a</span>
-<span class="sd">    True</span>
-<span class="sd">    &gt;&gt;&gt; &#39;utf7&#39; in a</span>
-<span class="sd">    False</span>
-
-<span class="sd">    To get the quality for an item you can use normal item lookup:</span>
-
-<span class="sd">    &gt;&gt;&gt; print a[&#39;utf-8&#39;]</span>
-<span class="sd">    0.7</span>
-<span class="sd">    &gt;&gt;&gt; a[&#39;utf7&#39;]</span>
-<span class="sd">    0</span>
-
-<span class="sd">    .. versionchanged:: 0.5</span>
-<span class="sd">       :class:`Accept` objects are forced immutable now.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="o">=</span><span class="p">()):</span>
-        <span class="k">if</span> <span class="n">values</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="nb">list</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">provided</span> <span class="o">=</span> <span class="kc">False</span>
-        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">Accept</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">provided</span> <span class="o">=</span> <span class="n">values</span><span class="o">.</span><span class="n">provided</span>
-            <span class="nb">list</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">provided</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="n">values</span> <span class="o">=</span> <span class="p">[(</span><span class="n">a</span><span class="p">,</span> <span class="n">b</span><span class="p">)</span> <span class="k">for</span> <span class="n">b</span><span class="p">,</span> <span class="n">a</span> <span class="ow">in</span> <span class="n">values</span><span class="p">]</span>
-            <span class="n">values</span><span class="o">.</span><span class="n">sort</span><span class="p">()</span>
-            <span class="n">values</span><span class="o">.</span><span class="n">reverse</span><span class="p">()</span>
-            <span class="nb">list</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="p">[(</span><span class="n">a</span><span class="p">,</span> <span class="n">b</span><span class="p">)</span> <span class="k">for</span> <span class="n">b</span><span class="p">,</span> <span class="n">a</span> <span class="ow">in</span> <span class="n">values</span><span class="p">])</span>
-
-    <span class="k">def</span> <span class="nf">_value_matches</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if a value matches a given accept item.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">item</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">or</span> <span class="n">item</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="n">value</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Besides index lookup (getting item n) you can also pass it a string</span>
-<span class="sd">        to get the quality for the item.  If the item is not in the list, the</span>
-<span class="sd">        returned quality is ``0``.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">quality</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">list</span><span class="o">.</span><span class="n">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">quality</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the quality of the key.</span>
-
-<span class="sd">        .. versionadded:: 0.6</span>
-<span class="sd">           In previous versions you had to use the item-lookup syntax</span>
-<span class="sd">           (eg: ``obj[key]`` instead of ``obj.quality(key)``)</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">for</span> <span class="n">item</span><span class="p">,</span> <span class="n">quality</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_value_matches</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-                <span class="k">return</span> <span class="n">quality</span>
-        <span class="k">return</span> <span class="mi">0</span>
-
-    <span class="k">def</span> <span class="nf">__contains__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">item</span><span class="p">,</span> <span class="n">quality</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_value_matches</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-                <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="kc">False</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">([</span><span class="si">%s</span><span class="s1">])&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s1">&#39;(</span><span class="si">%r</span><span class="s1">, </span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">)</span>
-        <span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">index</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Get the position of an entry or raise :exc:`ValueError`.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-
-<span class="sd">        .. versionchanged:: 0.5</span>
-<span class="sd">           This used to raise :exc:`IndexError`, which was inconsistent</span>
-<span class="sd">           with the list API.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="p">(</span><span class="n">item</span><span class="p">,</span> <span class="n">quality</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_value_matches</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-                    <span class="k">return</span> <span class="n">idx</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">list</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Get the position of an entry or return -1.</span>
-
-<span class="sd">        :param key: The key to be looked up.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-            <span class="k">return</span> <span class="o">-</span><span class="mi">1</span>
-
-    <span class="k">def</span> <span class="nf">values</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Iterate over all values.&quot;&quot;&quot;</span>
-        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">yield</span> <span class="n">item</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the header set into an HTTP header string.&quot;&quot;&quot;</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">value</span><span class="p">,</span> <span class="n">quality</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">quality</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
-                <span class="n">value</span> <span class="o">=</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">;q=</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">quality</span><span class="p">)</span>
-            <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">return</span> <span class="s1">&#39;,&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">best_match</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">matches</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the best match from a list of possible matches based</span>
-<span class="sd">        on the quality of the client.  If two items have the same quality,</span>
-<span class="sd">        the one is returned that comes first.</span>
-
-<span class="sd">        :param matches: a list of matches to check for</span>
-<span class="sd">        :param default: the value that is returned if none match</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">best_quality</span> <span class="o">=</span> <span class="o">-</span><span class="mi">1</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="n">default</span>
-        <span class="k">for</span> <span class="n">server_item</span> <span class="ow">in</span> <span class="n">matches</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">client_item</span><span class="p">,</span> <span class="n">quality</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">quality</span> <span class="o">&lt;=</span> <span class="n">best_quality</span><span class="p">:</span>
-                    <span class="k">break</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_value_matches</span><span class="p">(</span><span class="n">server_item</span><span class="p">,</span> <span class="n">client_item</span><span class="p">)</span> \
-                   <span class="ow">and</span> <span class="n">quality</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-                    <span class="n">best_quality</span> <span class="o">=</span> <span class="n">quality</span>
-                    <span class="n">result</span> <span class="o">=</span> <span class="n">server_item</span>
-        <span class="k">return</span> <span class="n">result</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">best</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The best match as value.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span>
-
-
-<span class="k">class</span> <span class="nc">MIMEAccept</span><span class="p">(</span><span class="n">Accept</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Like :class:`Accept` but with special methods and behavior for</span>
-<span class="sd">    mimetypes.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">_value_matches</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
-            <span class="n">x</span> <span class="o">=</span> <span class="n">x</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-            <span class="k">return</span> <span class="n">x</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">and</span> <span class="p">(</span><span class="s1">&#39;*&#39;</span><span class="p">,</span> <span class="s1">&#39;*&#39;</span><span class="p">)</span> <span class="ow">or</span> <span class="n">x</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
-
-        <span class="c1"># this is from the application which is trusted.  to avoid developer</span>
-        <span class="c1"># frustration we actually check these for valid values</span>
-        <span class="k">if</span> <span class="s1">&#39;/&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;invalid mimetype </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">value</span><span class="p">)</span>
-        <span class="n">value_type</span><span class="p">,</span> <span class="n">value_subtype</span> <span class="o">=</span> <span class="n">_normalize</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">value_type</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">and</span> <span class="n">value_subtype</span> <span class="o">!=</span> <span class="s1">&#39;*&#39;</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;invalid mimetype </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">value</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="s1">&#39;/&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">item</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-        <span class="n">item_type</span><span class="p">,</span> <span class="n">item_subtype</span> <span class="o">=</span> <span class="n">_normalize</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">item_type</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">and</span> <span class="n">item_subtype</span> <span class="o">!=</span> <span class="s1">&#39;*&#39;</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-        <span class="k">return</span> <span class="p">(</span>
-            <span class="p">(</span><span class="n">item_type</span> <span class="o">==</span> <span class="n">item_subtype</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">or</span>
-             <span class="n">value_type</span> <span class="o">==</span> <span class="n">value_subtype</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span><span class="p">)</span> <span class="ow">or</span>
-            <span class="p">(</span><span class="n">item_type</span> <span class="o">==</span> <span class="n">value_type</span> <span class="ow">and</span> <span class="p">(</span><span class="n">item_subtype</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">or</span>
-                                          <span class="n">value_subtype</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">or</span>
-                                          <span class="n">item_subtype</span> <span class="o">==</span> <span class="n">value_subtype</span><span class="p">))</span>
-        <span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">accept_html</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;True if this object accepts HTML.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="p">(</span>
-            <span class="s1">&#39;text/html&#39;</span> <span class="ow">in</span> <span class="bp">self</span> <span class="ow">or</span>
-            <span class="s1">&#39;application/xhtml+xml&#39;</span> <span class="ow">in</span> <span class="bp">self</span> <span class="ow">or</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">accept_xhtml</span>
-        <span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">accept_xhtml</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;True if this object accepts XHTML.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="p">(</span>
-            <span class="s1">&#39;application/xhtml+xml&#39;</span> <span class="ow">in</span> <span class="bp">self</span> <span class="ow">or</span>
-            <span class="s1">&#39;application/xml&#39;</span> <span class="ow">in</span> <span class="bp">self</span>
-        <span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">accept_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;True if this object accepts JSON.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="s1">&#39;application/json&#39;</span> <span class="ow">in</span> <span class="bp">self</span>
-
-
-<span class="k">class</span> <span class="nc">LanguageAccept</span><span class="p">(</span><span class="n">Accept</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Like :class:`Accept` but with normalization for languages.&quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">_value_matches</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="n">language</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">_locale_delim_re</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">language</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
-        <span class="k">return</span> <span class="n">item</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">or</span> <span class="n">_normalize</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="o">==</span> <span class="n">_normalize</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">CharsetAccept</span><span class="p">(</span><span class="n">Accept</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Like :class:`Accept` but with normalization for charsets.&quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">_value_matches</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">codecs</span><span class="o">.</span><span class="n">lookup</span><span class="p">(</span><span class="n">name</span><span class="p">)</span><span class="o">.</span><span class="n">name</span>
-            <span class="k">except</span> <span class="ne">LookupError</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">name</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="k">return</span> <span class="n">item</span> <span class="o">==</span> <span class="s1">&#39;*&#39;</span> <span class="ow">or</span> <span class="n">_normalize</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="o">==</span> <span class="n">_normalize</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">cache_property</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">empty</span><span class="p">,</span> <span class="nb">type</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Return a new property object for a cache header.  Useful if you</span>
-<span class="sd">    want to add support for a cache extension in a subclass.&quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">_get_cache_value</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">empty</span><span class="p">,</span> <span class="nb">type</span><span class="p">),</span>
-                    <span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">v</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">_set_cache_value</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">v</span><span class="p">,</span> <span class="nb">type</span><span class="p">),</span>
-                    <span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">_del_cache_value</span><span class="p">(</span><span class="n">key</span><span class="p">),</span>
-                    <span class="s1">&#39;accessor for </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">_CacheControl</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Subclass of a dict that stores values for a Cache-Control header.  It</span>
-<span class="sd">    has accessors for all the cache-control directives specified in RFC 2616.</span>
-<span class="sd">    The class does not differentiate between request and response directives.</span>
-
-<span class="sd">    Because the cache-control directives in the HTTP header use dashes the</span>
-<span class="sd">    python descriptors use underscores for that.</span>
-
-<span class="sd">    To get a header of the :class:`CacheControl` object again you can convert</span>
-<span class="sd">    the object into a string or call the :meth:`to_header` method.  If you plan</span>
-<span class="sd">    to subclass it and add your own items have a look at the sourcecode for</span>
-<span class="sd">    that class.</span>
-
-<span class="sd">    .. versionchanged:: 0.4</span>
-
-<span class="sd">       Setting `no_cache` or `private` to boolean `True` will set the implicit</span>
-<span class="sd">       none-value which is ``*``:</span>
-
-<span class="sd">       &gt;&gt;&gt; cc = ResponseCacheControl()</span>
-<span class="sd">       &gt;&gt;&gt; cc.no_cache = True</span>
-<span class="sd">       &gt;&gt;&gt; cc</span>
-<span class="sd">       &lt;ResponseCacheControl &#39;no-cache&#39;&gt;</span>
-<span class="sd">       &gt;&gt;&gt; cc.no_cache</span>
-<span class="sd">       &#39;*&#39;</span>
-<span class="sd">       &gt;&gt;&gt; cc.no_cache = None</span>
-<span class="sd">       &gt;&gt;&gt; cc</span>
-<span class="sd">       &lt;ResponseCacheControl &#39;&#39;&gt;</span>
-
-<span class="sd">       In versions before 0.5 the behavior documented here affected the now</span>
-<span class="sd">       no longer existing `CacheControl` class.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">no_cache</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;no-cache&#39;</span><span class="p">,</span> <span class="s1">&#39;*&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">no_store</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;no-store&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="nb">bool</span><span class="p">)</span>
-    <span class="n">max_age</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;max-age&#39;</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="nb">int</span><span class="p">)</span>
-    <span class="n">no_transform</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;no-transform&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="o">=</span><span class="p">(),</span> <span class="n">on_update</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span> <span class="ow">or</span> <span class="p">())</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="o">=</span> <span class="n">on_update</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">provided</span> <span class="o">=</span> <span class="n">values</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-
-    <span class="k">def</span> <span class="nf">_get_cache_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">empty</span><span class="p">,</span> <span class="nb">type</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Used internally by the accessor properties.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="nb">bool</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-            <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">empty</span>
-            <span class="k">elif</span> <span class="nb">type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">try</span><span class="p">:</span>
-                    <span class="n">value</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-                <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-                    <span class="k">pass</span>
-            <span class="k">return</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">_set_cache_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="nb">type</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Used internally by the accessor properties.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="nb">bool</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">value</span><span class="p">:</span>
-                <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-            <span class="k">elif</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">True</span><span class="p">:</span>
-                <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">_del_cache_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Used internally by the accessor properties.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-            <span class="k">del</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the stored values into a cache control header.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">dump_header</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%s</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
-                <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">=</span><span class="si">%r</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">())</span>
-            <span class="p">),</span>
-        <span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">RequestCacheControl</span><span class="p">(</span><span class="n">ImmutableDictMixin</span><span class="p">,</span> <span class="n">_CacheControl</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A cache control for requests.  This is immutable and gives access</span>
-<span class="sd">    to all the request-relevant cache control headers.</span>
-
-<span class="sd">    To get a header of the :class:`RequestCacheControl` object again you can</span>
-<span class="sd">    convert the object into a string or call the :meth:`to_header` method.  If</span>
-<span class="sd">    you plan to subclass it and add your own items have a look at the sourcecode</span>
-<span class="sd">    for that class.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">       In previous versions a `CacheControl` class existed that was used</span>
-<span class="sd">       both for request and response.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">max_stale</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;max-stale&#39;</span><span class="p">,</span> <span class="s1">&#39;*&#39;</span><span class="p">,</span> <span class="nb">int</span><span class="p">)</span>
-    <span class="n">min_fresh</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;min-fresh&#39;</span><span class="p">,</span> <span class="s1">&#39;*&#39;</span><span class="p">,</span> <span class="nb">int</span><span class="p">)</span>
-    <span class="n">no_transform</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;no-transform&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">only_if_cached</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;only-if-cached&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="nb">bool</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ResponseCacheControl</span><span class="p">(</span><span class="n">_CacheControl</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A cache control for responses.  Unlike :class:`RequestCacheControl`</span>
-<span class="sd">    this is mutable and gives access to response-relevant cache control</span>
-<span class="sd">    headers.</span>
-
-<span class="sd">    To get a header of the :class:`ResponseCacheControl` object again you can</span>
-<span class="sd">    convert the object into a string or call the :meth:`to_header` method.  If</span>
-<span class="sd">    you plan to subclass it and add your own items have a look at the sourcecode</span>
-<span class="sd">    for that class.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">       In previous versions a `CacheControl` class existed that was used</span>
-<span class="sd">       both for request and response.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">public</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;public&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="nb">bool</span><span class="p">)</span>
-    <span class="n">private</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;private&#39;</span><span class="p">,</span> <span class="s1">&#39;*&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-    <span class="n">must_revalidate</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;must-revalidate&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="nb">bool</span><span class="p">)</span>
-    <span class="n">proxy_revalidate</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;proxy-revalidate&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="nb">bool</span><span class="p">)</span>
-    <span class="n">s_maxage</span> <span class="o">=</span> <span class="n">cache_property</span><span class="p">(</span><span class="s1">&#39;s-maxage&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-
-
-<span class="c1"># attach cache_property to the _CacheControl as staticmethod</span>
-<span class="c1"># so that others can reuse it.</span>
-<span class="n">_CacheControl</span><span class="o">.</span><span class="n">cache_property</span> <span class="o">=</span> <span class="nb">staticmethod</span><span class="p">(</span><span class="n">cache_property</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">CallbackDict</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A dict that calls a function passed every time something is changed.</span>
-<span class="sd">    The function is passed the dict instance.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">initial</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">on_update</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">initial</span> <span class="ow">or</span> <span class="p">())</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="o">=</span> <span class="n">on_update</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%s</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="nb">dict</span><span class="o">.</span><span class="n">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">HeaderSet</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Similar to the :class:`ETags` class this implements a set-like structure.</span>
-<span class="sd">    Unlike :class:`ETags` this is case insensitive and used for vary, allow, and</span>
-<span class="sd">    content-language headers.</span>
-
-<span class="sd">    If not constructed using the :func:`parse_set_header` function the</span>
-<span class="sd">    instantiation works like this:</span>
-
-<span class="sd">    &gt;&gt;&gt; hs = HeaderSet([&#39;foo&#39;, &#39;bar&#39;, &#39;baz&#39;])</span>
-<span class="sd">    &gt;&gt;&gt; hs</span>
-<span class="sd">    HeaderSet([&#39;foo&#39;, &#39;bar&#39;, &#39;baz&#39;])</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">on_update</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">headers</span> <span class="ow">or</span> <span class="p">())</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_set</span> <span class="o">=</span> <span class="nb">set</span><span class="p">([</span><span class="n">x</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">])</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="o">=</span> <span class="n">on_update</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">header</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Add a new header to the set.&quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">((</span><span class="n">header</span><span class="p">,))</span>
-
-    <span class="k">def</span> <span class="nf">remove</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">header</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Remove a header from the set.  This raises an :exc:`KeyError` if the</span>
-<span class="sd">        header is not in the set.</span>
-
-<span class="sd">        .. versionchanged:: 0.5</span>
-<span class="sd">            In older versions a :exc:`IndexError` was raised instead of a</span>
-<span class="sd">            :exc:`KeyError` if the object was missing.</span>
-
-<span class="sd">        :param header: the header to be removed.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">key</span> <span class="o">=</span> <span class="n">header</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">KeyError</span><span class="p">(</span><span class="n">header</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">key</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="n">header</span><span class="p">:</span>
-                <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
-                <span class="k">break</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">iterable</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Add all the headers from the iterable to the set.</span>
-
-<span class="sd">        :param iterable: updates the set with the items from the iterable.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">inserted_any</span> <span class="o">=</span> <span class="kc">False</span>
-        <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="n">iterable</span><span class="p">:</span>
-            <span class="n">key</span> <span class="o">=</span> <span class="n">header</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-            <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">header</span><span class="p">)</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-                <span class="n">inserted_any</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="k">if</span> <span class="n">inserted_any</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">discard</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">header</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`remove` but ignores errors.</span>
-
-<span class="sd">        :param header: the header to be discarded.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">header</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
-            <span class="k">pass</span>
-
-    <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">header</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the index of the header in the set or return -1 if not found.</span>
-
-<span class="sd">        :param header: the header to be looked up.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">header</span> <span class="o">=</span> <span class="n">header</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">item</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">item</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="n">header</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">idx</span>
-        <span class="k">return</span> <span class="o">-</span><span class="mi">1</span>
-
-    <span class="k">def</span> <span class="nf">index</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">header</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the index of the header in the set or raise an</span>
-<span class="sd">        :exc:`IndexError`.</span>
-
-<span class="sd">        :param header: the header to be looked up.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">header</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">rv</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">IndexError</span><span class="p">(</span><span class="n">header</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Clear the set.&quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="o">.</span><span class="n">clear</span><span class="p">()</span>
-        <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">[:]</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">as_set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">preserve_casing</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return the set as real python set type.  When calling this, all</span>
-<span class="sd">        the items are converted to lowercase and the ordering is lost.</span>
-
-<span class="sd">        :param preserve_casing: if set to `True` the items in the set returned</span>
-<span class="sd">                                will have the original case like in the</span>
-<span class="sd">                                :class:`HeaderSet`, otherwise they will</span>
-<span class="sd">                                be lowercase.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">preserve_casing</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the header set into an HTTP header string.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">map</span><span class="p">(</span><span class="n">quote_header_value</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">__getitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">idx</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">__delitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">idx</span><span class="p">):</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">rv</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__setitem__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">idx</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">old</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">old</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">value</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__contains__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">header</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">header</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_set</span>
-
-    <span class="k">def</span> <span class="nf">__len__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_headers</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_set</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%r</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_headers</span>
-        <span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ETags</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A set that can be used to check if one etag is present in a collection</span>
-<span class="sd">    of etags.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">strong_etags</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">weak_etags</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">star_tag</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_strong</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">(</span><span class="ow">not</span> <span class="n">star_tag</span> <span class="ow">and</span> <span class="n">strong_etags</span> <span class="ow">or</span> <span class="p">())</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_weak</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">(</span><span class="n">weak_etags</span> <span class="ow">or</span> <span class="p">())</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">star_tag</span> <span class="o">=</span> <span class="n">star_tag</span>
-
-    <span class="k">def</span> <span class="nf">as_set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">include_weak</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the `ETags` object into a python set.  Per default all the</span>
-<span class="sd">        weak etags are not part of this set.&quot;&quot;&quot;</span>
-        <span class="n">rv</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_strong</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">include_weak</span><span class="p">:</span>
-            <span class="n">rv</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_weak</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">is_weak</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if an etag is weak.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">etag</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_weak</span>
-
-    <span class="k">def</span> <span class="nf">contains_weak</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if an etag is part of the set including weak and strong tags.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_weak</span><span class="p">(</span><span class="n">etag</span><span class="p">)</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">contains</span><span class="p">(</span><span class="n">etag</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">contains</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if an etag is part of the set ignoring weak tags.</span>
-<span class="sd">        It is also possible to use the ``in`` operator.</span>
-
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">star_tag</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="n">etag</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_strong</span>
-
-    <span class="k">def</span> <span class="nf">contains_raw</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;When passed a quoted tag it will check if this tag is part of the</span>
-<span class="sd">        set.  If the tag is weak it is checked against weak and strong tags,</span>
-<span class="sd">        otherwise strong only.&quot;&quot;&quot;</span>
-        <span class="n">etag</span><span class="p">,</span> <span class="n">weak</span> <span class="o">=</span> <span class="n">unquote_etag</span><span class="p">(</span><span class="n">etag</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">weak</span><span class="p">:</span>
-            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">contains_weak</span><span class="p">(</span><span class="n">etag</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">contains</span><span class="p">(</span><span class="n">etag</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the etags set into a HTTP header string.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">star_tag</span><span class="p">:</span>
-            <span class="k">return</span> <span class="s1">&#39;*&#39;</span>
-        <span class="k">return</span> <span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
-            <span class="p">[</span><span class="s1">&#39;&quot;</span><span class="si">%s</span><span class="s1">&quot;&#39;</span> <span class="o">%</span> <span class="n">x</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_strong</span><span class="p">]</span> <span class="o">+</span>
-            <span class="p">[</span><span class="s1">&#39;W/&quot;</span><span class="si">%s</span><span class="s1">&quot;&#39;</span> <span class="o">%</span> <span class="n">x</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_weak</span><span class="p">]</span>
-        <span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">data</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">include_weak</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="k">if</span> <span class="p">[</span><span class="n">etag</span><span class="p">,</span> <span class="n">data</span><span class="p">]</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s1">&#39;either tag or data required, but at least one&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">etag</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">etag</span> <span class="o">=</span> <span class="n">generate_etag</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">include_weak</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">etag</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_weak</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="n">etag</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_strong</span>
-
-    <span class="k">def</span> <span class="nf">__bool__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">star_tag</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_strong</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_weak</span><span class="p">)</span>
-
-    <span class="n">__nonzero__</span> <span class="o">=</span> <span class="n">__bool__</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_strong</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__contains__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">contains</span><span class="p">(</span><span class="n">etag</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-
-
-<span class="k">class</span> <span class="nc">IfRange</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Very simple object that represents the `If-Range` header in parsed</span>
-<span class="sd">    form.  It will either have neither a etag or date or one of either but</span>
-<span class="sd">    never both.</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">etag</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="c1">#: The etag parsed and unquoted.  Ranges always operate on strong</span>
-        <span class="c1">#: etags so the weakness information is not necessary.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">etag</span> <span class="o">=</span> <span class="n">etag</span>
-        <span class="c1">#: The date in parsed format or `None`.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">date</span> <span class="o">=</span> <span class="n">date</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Converts the object back into an HTTP header.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">date</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">http_date</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">date</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">etag</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">quote_etag</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">etag</span><span class="p">)</span>
-        <span class="k">return</span> <span class="s1">&#39;&#39;</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-
-
-<span class="k">class</span> <span class="nc">Range</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Represents a range header.  All the methods are only supporting bytes</span>
-<span class="sd">    as unit.  It does store multiple ranges but :meth:`range_for_length` will</span>
-<span class="sd">    only work if only one range is provided.</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">units</span><span class="p">,</span> <span class="n">ranges</span><span class="p">):</span>
-        <span class="c1">#: The units of this range.  Usually &quot;bytes&quot;.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="n">units</span>
-        <span class="c1">#: A list of ``(begin, end)`` tuples for the range header provided.</span>
-        <span class="c1">#: The ranges are non-inclusive.</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">ranges</span> <span class="o">=</span> <span class="n">ranges</span>
-
-    <span class="k">def</span> <span class="nf">range_for_length</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">length</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;If the range is for bytes, the length is not None and there is</span>
-<span class="sd">        exactly one range and it is satisfiable it returns a ``(start, stop)``</span>
-<span class="sd">        tuple, otherwise `None`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">!=</span> <span class="s1">&#39;bytes&#39;</span> <span class="ow">or</span> <span class="n">length</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">or</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">ranges</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">None</span>
-        <span class="n">start</span><span class="p">,</span> <span class="n">end</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">ranges</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-        <span class="k">if</span> <span class="n">end</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">end</span> <span class="o">=</span> <span class="n">length</span>
-            <span class="k">if</span> <span class="n">start</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
-                <span class="n">start</span> <span class="o">+=</span> <span class="n">length</span>
-        <span class="k">if</span> <span class="n">is_byte_range_valid</span><span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">end</span><span class="p">,</span> <span class="n">length</span><span class="p">):</span>
-            <span class="k">return</span> <span class="n">start</span><span class="p">,</span> <span class="nb">min</span><span class="p">(</span><span class="n">end</span><span class="p">,</span> <span class="n">length</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">make_content_range</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">length</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a :class:`~werkzeug.datastructures.ContentRange` object</span>
-<span class="sd">        from the current range and given content length.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">rng</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">range_for_length</span><span class="p">(</span><span class="n">length</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">rng</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">ContentRange</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">,</span> <span class="n">rng</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">rng</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">length</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Converts the object back into an HTTP header.&quot;&quot;&quot;</span>
-        <span class="n">ranges</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">begin</span><span class="p">,</span> <span class="n">end</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">ranges</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">end</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">ranges</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">begin</span> <span class="o">&gt;=</span> <span class="mi">0</span> <span class="ow">and</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">-&#39;</span> <span class="o">%</span> <span class="n">begin</span> <span class="ow">or</span> <span class="nb">str</span><span class="p">(</span><span class="n">begin</span><span class="p">))</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">ranges</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">-</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">begin</span><span class="p">,</span> <span class="n">end</span> <span class="o">-</span> <span class="mi">1</span><span class="p">))</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">=</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">ranges</span><span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-
-
-<span class="k">class</span> <span class="nc">ContentRange</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Represents the content range header.</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">units</span><span class="p">,</span> <span class="n">start</span><span class="p">,</span> <span class="n">stop</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">on_update</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">assert</span> <span class="n">is_byte_range_valid</span><span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">stop</span><span class="p">,</span> <span class="n">length</span><span class="p">),</span> \
-            <span class="s1">&#39;Bad range provided&#39;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="o">=</span> <span class="n">on_update</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">stop</span><span class="p">,</span> <span class="n">length</span><span class="p">,</span> <span class="n">units</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_callback_property</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">fget</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">return</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-
-        <span class="k">def</span> <span class="nf">fset</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-            <span class="nb">setattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">property</span><span class="p">(</span><span class="n">fget</span><span class="p">,</span> <span class="n">fset</span><span class="p">)</span>
-
-    <span class="c1">#: The units to use, usually &quot;bytes&quot;</span>
-    <span class="n">units</span> <span class="o">=</span> <span class="n">_callback_property</span><span class="p">(</span><span class="s1">&#39;_units&#39;</span><span class="p">)</span>
-    <span class="c1">#: The start point of the range or `None`.</span>
-    <span class="n">start</span> <span class="o">=</span> <span class="n">_callback_property</span><span class="p">(</span><span class="s1">&#39;_start&#39;</span><span class="p">)</span>
-    <span class="c1">#: The stop point of the range (non-inclusive) or `None`.  Can only be</span>
-    <span class="c1">#: `None` if also start is `None`.</span>
-    <span class="n">stop</span> <span class="o">=</span> <span class="n">_callback_property</span><span class="p">(</span><span class="s1">&#39;_stop&#39;</span><span class="p">)</span>
-    <span class="c1">#: The length of the range or `None`.</span>
-    <span class="n">length</span> <span class="o">=</span> <span class="n">_callback_property</span><span class="p">(</span><span class="s1">&#39;_length&#39;</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">start</span><span class="p">,</span> <span class="n">stop</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">units</span><span class="o">=</span><span class="s1">&#39;bytes&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Simple method to update the ranges.&quot;&quot;&quot;</span>
-        <span class="k">assert</span> <span class="n">is_byte_range_valid</span><span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">stop</span><span class="p">,</span> <span class="n">length</span><span class="p">),</span> \
-            <span class="s1">&#39;Bad range provided&#39;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_units</span> <span class="o">=</span> <span class="n">units</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_start</span> <span class="o">=</span> <span class="n">start</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_stop</span> <span class="o">=</span> <span class="n">stop</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_length</span> <span class="o">=</span> <span class="n">length</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">unset</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Sets the units to `None` which indicates that the header should</span>
-<span class="sd">        no longer be used.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">units</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="s1">&#39;&#39;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">length</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">length</span> <span class="o">=</span> <span class="s1">&#39;*&#39;</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">length</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">length</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">start</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1"> */</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">,</span> <span class="n">length</span><span class="p">)</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%s</span><span class="s1">-</span><span class="si">%s</span><span class="s1">/</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">start</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">stop</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span>
-            <span class="n">length</span>
-        <span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-
-    <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="p">))</span>
-
-
-<span class="k">class</span> <span class="nc">Authorization</span><span class="p">(</span><span class="n">ImmutableDictMixin</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Represents an `Authorization` header sent by the client.  You should</span>
-<span class="sd">    not create this kind of object yourself but use it when it&#39;s returned by</span>
-<span class="sd">    the `parse_authorization_header` function.</span>
-
-<span class="sd">    This object is a dict subclass and can be altered by setting dict items</span>
-<span class="sd">    but it should be considered immutable as it&#39;s returned by the client and</span>
-<span class="sd">    not meant for modifications.</span>
-
-<span class="sd">    .. versionchanged:: 0.5</span>
-<span class="sd">       This object became immutable.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">auth_type</span><span class="p">,</span> <span class="n">data</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span> <span class="ow">or</span> <span class="p">{})</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="n">auth_type</span>
-
-    <span class="n">username</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;username&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        The username transmitted.  This is set for both basic and digest</span>
-<span class="s1">        auth all the time.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">password</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;password&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        When the authentication type is basic this is the password</span>
-<span class="s1">        transmitted by the client, else `None`.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">realm</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;realm&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        This is the server realm sent back for HTTP digest auth.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">nonce</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;nonce&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        The nonce the server sent for digest auth, sent back by the client.</span>
-<span class="s1">        A nonce should be unique for every 401 response for HTTP digest</span>
-<span class="s1">        auth.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">uri</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;uri&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        The URI from Request-URI of the Request-Line; duplicated because</span>
-<span class="s1">        proxies are allowed to change the Request-Line in transit.  HTTP</span>
-<span class="s1">        digest auth only.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">nc</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;nc&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        The nonce count value transmitted by clients if a qop-header is</span>
-<span class="s1">        also transmitted.  HTTP digest auth only.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">cnonce</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;cnonce&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        If the server sent a qop-header in the ``WWW-Authenticate``</span>
-<span class="s1">        header, the client has to provide this value for HTTP digest auth.</span>
-<span class="s1">        See the RFC for more details.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">response</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;response&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A string of 32 hex digits computed as defined in RFC 2617, which</span>
-<span class="s1">        proves that the user knows a password.  Digest auth only.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">opaque</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;opaque&#39;</span><span class="p">),</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        The opaque header from the server returned unchanged by the client.</span>
-<span class="s1">        It is recommended that this string be base64 or hexadecimal data.</span>
-<span class="s1">        Digest auth only.&#39;&#39;&#39;</span><span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">qop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Indicates what &quot;quality of protection&quot; the client has applied to</span>
-<span class="sd">        the message for HTTP digest auth.&quot;&quot;&quot;</span>
-        <span class="k">def</span> <span class="nf">on_update</span><span class="p">(</span><span class="n">header_set</span><span class="p">):</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">header_set</span> <span class="ow">and</span> <span class="s1">&#39;qop&#39;</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-                <span class="k">del</span> <span class="bp">self</span><span class="p">[</span><span class="s1">&#39;qop&#39;</span><span class="p">]</span>
-            <span class="k">elif</span> <span class="n">header_set</span><span class="p">:</span>
-                <span class="bp">self</span><span class="p">[</span><span class="s1">&#39;qop&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">header_set</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-        <span class="k">return</span> <span class="n">parse_set_header</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;qop&#39;</span><span class="p">),</span> <span class="n">on_update</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">WWWAuthenticate</span><span class="p">(</span><span class="n">UpdateDictMixin</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Provides simple access to `WWW-Authenticate` headers.&quot;&quot;&quot;</span>
-
-    <span class="c1">#: list of keys that require quoting in the generated header</span>
-    <span class="n">_require_quoting</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s1">&#39;domain&#39;</span><span class="p">,</span> <span class="s1">&#39;nonce&#39;</span><span class="p">,</span> <span class="s1">&#39;opaque&#39;</span><span class="p">,</span> <span class="s1">&#39;realm&#39;</span><span class="p">,</span> <span class="s1">&#39;qop&#39;</span><span class="p">])</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">auth_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">values</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">on_update</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span> <span class="ow">or</span> <span class="p">())</span>
-        <span class="k">if</span> <span class="n">auth_type</span><span class="p">:</span>
-            <span class="bp">self</span><span class="p">[</span><span class="s1">&#39;__auth_type__&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">auth_type</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span> <span class="o">=</span> <span class="n">on_update</span>
-
-    <span class="k">def</span> <span class="nf">set_basic</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">realm</span><span class="o">=</span><span class="s1">&#39;authentication required&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Clear the auth info and enable basic auth.&quot;&quot;&quot;</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="p">{</span><span class="s1">&#39;__auth_type__&#39;</span><span class="p">:</span> <span class="s1">&#39;basic&#39;</span><span class="p">,</span> <span class="s1">&#39;realm&#39;</span><span class="p">:</span> <span class="n">realm</span><span class="p">})</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">set_digest</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">realm</span><span class="p">,</span> <span class="n">nonce</span><span class="p">,</span> <span class="n">qop</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;auth&#39;</span><span class="p">,),</span> <span class="n">opaque</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                   <span class="n">algorithm</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">stale</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Clear the auth info and enable digest auth.&quot;&quot;&quot;</span>
-        <span class="n">d</span> <span class="o">=</span> <span class="p">{</span>
-            <span class="s1">&#39;__auth_type__&#39;</span><span class="p">:</span>    <span class="s1">&#39;digest&#39;</span><span class="p">,</span>
-            <span class="s1">&#39;realm&#39;</span><span class="p">:</span>            <span class="n">realm</span><span class="p">,</span>
-            <span class="s1">&#39;nonce&#39;</span><span class="p">:</span>            <span class="n">nonce</span><span class="p">,</span>
-            <span class="s1">&#39;qop&#39;</span><span class="p">:</span>              <span class="n">dump_header</span><span class="p">(</span><span class="n">qop</span><span class="p">)</span>
-        <span class="p">}</span>
-        <span class="k">if</span> <span class="n">stale</span><span class="p">:</span>
-            <span class="n">d</span><span class="p">[</span><span class="s1">&#39;stale&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;TRUE&#39;</span>
-        <span class="k">if</span> <span class="n">opaque</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">d</span><span class="p">[</span><span class="s1">&#39;opaque&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">opaque</span>
-        <span class="k">if</span> <span class="n">algorithm</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">d</span><span class="p">[</span><span class="s1">&#39;algorithm&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">algorithm</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="nb">dict</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">d</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">on_update</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_header</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Convert the stored values into a WWW-Authenticate header.&quot;&quot;&quot;</span>
-        <span class="n">d</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-        <span class="n">auth_type</span> <span class="o">=</span> <span class="n">d</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;__auth_type__&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">or</span> <span class="s1">&#39;basic&#39;</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">auth_type</span><span class="o">.</span><span class="n">title</span><span class="p">(),</span> <span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span>
-            <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">=</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">quote_header_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span>
-                                               <span class="n">allow_token</span><span class="o">=</span><span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_require_quoting</span><span class="p">))</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">d</span><span class="p">)</span>
-        <span class="p">]))</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%r</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-        <span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">auth_property</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A static helper function for subclasses to add extra authentication</span>
-<span class="sd">        system properties onto a class::</span>
-
-<span class="sd">            class FooAuthenticate(WWWAuthenticate):</span>
-<span class="sd">                special_realm = auth_property(&#39;special_realm&#39;)</span>
-
-<span class="sd">        For more information have a look at the sourcecode to see how the</span>
-<span class="sd">        regular properties (:attr:`realm` etc.) are implemented.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-
-        <span class="k">def</span> <span class="nf">_set_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-            <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="bp">self</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">property</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">),</span> <span class="n">_set_value</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="n">doc</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_set_property</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">fget</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="k">def</span> <span class="nf">on_update</span><span class="p">(</span><span class="n">header_set</span><span class="p">):</span>
-                <span class="k">if</span> <span class="ow">not</span> <span class="n">header_set</span> <span class="ow">and</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="p">:</span>
-                    <span class="k">del</span> <span class="bp">self</span><span class="p">[</span><span class="n">name</span><span class="p">]</span>
-                <span class="k">elif</span> <span class="n">header_set</span><span class="p">:</span>
-                    <span class="bp">self</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">header_set</span><span class="o">.</span><span class="n">to_header</span><span class="p">()</span>
-            <span class="k">return</span> <span class="n">parse_set_header</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">),</span> <span class="n">on_update</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">property</span><span class="p">(</span><span class="n">fget</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="n">doc</span><span class="p">)</span>
-
-    <span class="nb">type</span> <span class="o">=</span> <span class="n">auth_property</span><span class="p">(</span><span class="s1">&#39;__auth_type__&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        The type of the auth mechanism.  HTTP currently specifies</span>
-<span class="s1">        `Basic` and `Digest`.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">realm</span> <span class="o">=</span> <span class="n">auth_property</span><span class="p">(</span><span class="s1">&#39;realm&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A string to be displayed to users so they know which username and</span>
-<span class="s1">        password to use.  This string should contain at least the name of</span>
-<span class="s1">        the host performing the authentication and might additionally</span>
-<span class="s1">        indicate the collection of users who might have access.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">domain</span> <span class="o">=</span> <span class="n">_set_property</span><span class="p">(</span><span class="s1">&#39;domain&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A list of URIs that define the protection space.  If a URI is an</span>
-<span class="s1">        absolute path, it is relative to the canonical root URL of the</span>
-<span class="s1">        server being accessed.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">nonce</span> <span class="o">=</span> <span class="n">auth_property</span><span class="p">(</span><span class="s1">&#39;nonce&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A server-specified data string which should be uniquely generated</span>
-<span class="s1">        each time a 401 response is made.  It is recommended that this</span>
-<span class="s1">        string be base64 or hexadecimal data.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">opaque</span> <span class="o">=</span> <span class="n">auth_property</span><span class="p">(</span><span class="s1">&#39;opaque&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A string of data, specified by the server, which should be returned</span>
-<span class="s1">        by the client unchanged in the Authorization header of subsequent</span>
-<span class="s1">        requests with URIs in the same protection space.  It is recommended</span>
-<span class="s1">        that this string be base64 or hexadecimal data.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">algorithm</span> <span class="o">=</span> <span class="n">auth_property</span><span class="p">(</span><span class="s1">&#39;algorithm&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A string indicating a pair of algorithms used to produce the digest</span>
-<span class="s1">        and a checksum.  If this is not present it is assumed to be &quot;MD5&quot;.</span>
-<span class="s1">        If the algorithm is not understood, the challenge should be ignored</span>
-<span class="s1">        (and a different one used, if there is more than one).&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="n">qop</span> <span class="o">=</span> <span class="n">_set_property</span><span class="p">(</span><span class="s1">&#39;qop&#39;</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A set of quality-of-privacy directives such as auth and auth-int.&#39;&#39;&#39;</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_get_stale</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">val</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;stale&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">val</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">val</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s1">&#39;true&#39;</span>
-
-    <span class="k">def</span> <span class="nf">_set_stale</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;stale&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="p">[</span><span class="s1">&#39;stale&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span> <span class="ow">and</span> <span class="s1">&#39;TRUE&#39;</span> <span class="ow">or</span> <span class="s1">&#39;FALSE&#39;</span>
-    <span class="n">stale</span> <span class="o">=</span> <span class="nb">property</span><span class="p">(</span><span class="n">_get_stale</span><span class="p">,</span> <span class="n">_set_stale</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="s1">&#39;&#39;&#39;</span>
-<span class="s1">        A flag, indicating that the previous request from the client was</span>
-<span class="s1">        rejected because the nonce value was stale.&#39;&#39;&#39;</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_get_stale</span><span class="p">,</span> <span class="n">_set_stale</span>
-
-    <span class="c1"># make auth_property a staticmethod so that subclasses of</span>
-    <span class="c1"># `WWWAuthenticate` can use it for new properties.</span>
-    <span class="n">auth_property</span> <span class="o">=</span> <span class="nb">staticmethod</span><span class="p">(</span><span class="n">auth_property</span><span class="p">)</span>
-    <span class="k">del</span> <span class="n">_set_property</span>
-
-
-<span class="k">class</span> <span class="nc">FileStorage</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;The :class:`FileStorage` class is a thin wrapper over incoming files.</span>
-<span class="sd">    It is used by the request object to represent uploaded files.  All the</span>
-<span class="sd">    attributes of the wrapper stream are proxied by the file storage so</span>
-<span class="sd">    it&#39;s possible to do ``storage.read()`` instead of the long form</span>
-<span class="sd">    ``storage.stream.read()``.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">stream</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">content_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content_length</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">stream</span> <span class="o">=</span> <span class="n">stream</span> <span class="ow">or</span> <span class="n">_empty_stream</span>
-
-        <span class="c1"># if no filename is provided we can attempt to get the filename</span>
-        <span class="c1"># from the stream object passed.  There we have to be careful to</span>
-        <span class="c1"># skip things like &lt;fdopen&gt;, &lt;stderr&gt; etc.  Python marks these</span>
-        <span class="c1"># special filenames with angular brackets.</span>
-        <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">filename</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">stream</span><span class="p">,</span> <span class="s1">&#39;name&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-            <span class="n">s</span> <span class="o">=</span> <span class="n">make_literal_wrapper</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">filename</span> <span class="ow">and</span> <span class="n">filename</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="n">s</span><span class="p">(</span><span class="s1">&#39;&lt;&#39;</span><span class="p">)</span> <span class="ow">and</span> <span class="n">filename</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="n">s</span><span class="p">(</span><span class="s1">&#39;&gt;&#39;</span><span class="p">):</span>
-                <span class="n">filename</span> <span class="o">=</span> <span class="kc">None</span>
-
-            <span class="c1"># On Python 3 we want to make sure the filename is always unicode.</span>
-            <span class="c1"># This might not be if the name attribute is bytes due to the</span>
-            <span class="c1"># file being opened from the bytes API.</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="n">PY2</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-                <span class="n">filename</span> <span class="o">=</span> <span class="n">filename</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="n">get_filesystem_encoding</span><span class="p">(),</span>
-                                           <span class="s1">&#39;replace&#39;</span><span class="p">)</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">filename</span> <span class="o">=</span> <span class="n">filename</span>
-        <span class="k">if</span> <span class="n">headers</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">headers</span> <span class="o">=</span> <span class="n">Headers</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">headers</span> <span class="o">=</span> <span class="n">headers</span>
-        <span class="k">if</span> <span class="n">content_type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">headers</span><span class="p">[</span><span class="s1">&#39;Content-Type&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">content_type</span>
-        <span class="k">if</span> <span class="n">content_length</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">headers</span><span class="p">[</span><span class="s1">&#39;Content-Length&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">content_length</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">_parse_content_type</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;_parsed_content_type&#39;</span><span class="p">):</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_parsed_content_type</span> <span class="o">=</span> \
-                <span class="n">parse_options_header</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">content_type</span><span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">content_type</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The content-type sent in the header.  Usually not available&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;content-type&#39;</span><span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">content_length</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The content-length sent in the header.  Usually not available&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">int</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;content-length&#39;</span><span class="p">)</span> <span class="ow">or</span> <span class="mi">0</span><span class="p">)</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">mimetype</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :attr:`content_type`, but without parameters (eg, without</span>
-<span class="sd">        charset, type etc.) and always lowercase.  For example if the content</span>
-<span class="sd">        type is ``text/HTML; charset=utf-8`` the mimetype would be</span>
-<span class="sd">        ``&#39;text/html&#39;``.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_parse_content_type</span><span class="p">()</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parsed_content_type</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">mimetype_params</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The mimetype parameters as dict.  For example if the content</span>
-<span class="sd">        type is ``text/html; charset=utf-8`` the params would be</span>
-<span class="sd">        ``{&#39;charset&#39;: &#39;utf-8&#39;}``.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_parse_content_type</span><span class="p">()</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parsed_content_type</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">save</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dst</span><span class="p">,</span> <span class="n">buffer_size</span><span class="o">=</span><span class="mi">16384</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Save the file to a destination path or file object.  If the</span>
-<span class="sd">        destination is a file object you have to close it yourself after the</span>
-<span class="sd">        call.  The buffer size is the number of bytes held in memory during</span>
-<span class="sd">        the copy process.  It defaults to 16KB.</span>
-
-<span class="sd">        For secure file saving also have a look at :func:`secure_filename`.</span>
-
-<span class="sd">        :param dst: a filename or open file object the uploaded file</span>
-<span class="sd">                    is saved to.</span>
-<span class="sd">        :param buffer_size: the size of the buffer.  This works the same as</span>
-<span class="sd">                            the `length` parameter of</span>
-<span class="sd">                            :func:`shutil.copyfileobj`.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="kn">from</span> <span class="nn">shutil</span> <span class="k">import</span> <span class="n">copyfileobj</span>
-        <span class="n">close_dst</span> <span class="o">=</span> <span class="kc">False</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">dst</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="n">dst</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="n">dst</span><span class="p">,</span> <span class="s1">&#39;wb&#39;</span><span class="p">)</span>
-            <span class="n">close_dst</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">copyfileobj</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">stream</span><span class="p">,</span> <span class="n">dst</span><span class="p">,</span> <span class="n">buffer_size</span><span class="p">)</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">close_dst</span><span class="p">:</span>
-                <span class="n">dst</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">close</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Close the underlying file if possible.&quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">stream</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-            <span class="k">pass</span>
-
-    <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">filename</span><span class="p">)</span>
-    <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span>
-
-    <span class="k">def</span> <span class="nf">__getattr__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">stream</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">readline</span><span class="p">,</span> <span class="s1">&#39;&#39;</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;&lt;</span><span class="si">%s</span><span class="s1">: </span><span class="si">%r</span><span class="s1"> (</span><span class="si">%r</span><span class="s1">)&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">filename</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">content_type</span>
-        <span class="p">)</span>
-
-
-<span class="c1"># circular dependencies</span>
-<span class="kn">from</span> <span class="nn">werkzeug.http</span> <span class="k">import</span> <span class="n">dump_options_header</span><span class="p">,</span> <span class="n">dump_header</span><span class="p">,</span> <span class="n">generate_etag</span><span class="p">,</span> \
-    <span class="n">quote_header_value</span><span class="p">,</span> <span class="n">parse_set_header</span><span class="p">,</span> <span class="n">unquote_etag</span><span class="p">,</span> <span class="n">quote_etag</span><span class="p">,</span> \
-    <span class="n">parse_options_header</span><span class="p">,</span> <span class="n">http_date</span><span class="p">,</span> <span class="n">is_byte_range_valid</span>
-<span class="kn">from</span> <span class="nn">werkzeug</span> <span class="k">import</span> <span class="n">exceptions</span>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_modules/werkzeug/routing.html

@@ -1,1862 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>werkzeug.routing &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../../_static/jquery.js"></script>
-    <script type="text/javascript" src="../../_static/underscore.js"></script>
-    <script type="text/javascript" src="../../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../../genindex.html" />
-    <link rel="search" title="Search" href="../../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../../index.html" />
-    <link rel="up" title="Module code" href="../index.html" />
-   
-  <link rel="stylesheet" href="../../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1>Source code for werkzeug.routing</h1><div class="highlight"><pre>
-<span></span><span class="c1"># -*- coding: utf-8 -*-</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    werkzeug.routing</span>
-<span class="sd">    ~~~~~~~~~~~~~~~~</span>
-
-<span class="sd">    When it comes to combining multiple controller or view functions (however</span>
-<span class="sd">    you want to call them) you need a dispatcher.  A simple way would be</span>
-<span class="sd">    applying regular expression tests on the ``PATH_INFO`` and calling</span>
-<span class="sd">    registered callback functions that return the value then.</span>
-
-<span class="sd">    This module implements a much more powerful system than simple regular</span>
-<span class="sd">    expression matching because it can also convert values in the URLs and</span>
-<span class="sd">    build URLs.</span>
-
-<span class="sd">    Here a simple example that creates an URL map for an application with</span>
-<span class="sd">    two subdomains (www and kb) and some URL rules:</span>
-
-<span class="sd">    &gt;&gt;&gt; m = Map([</span>
-<span class="sd">    ...     # Static URLs</span>
-<span class="sd">    ...     Rule(&#39;/&#39;, endpoint=&#39;static/index&#39;),</span>
-<span class="sd">    ...     Rule(&#39;/about&#39;, endpoint=&#39;static/about&#39;),</span>
-<span class="sd">    ...     Rule(&#39;/help&#39;, endpoint=&#39;static/help&#39;),</span>
-<span class="sd">    ...     # Knowledge Base</span>
-<span class="sd">    ...     Subdomain(&#39;kb&#39;, [</span>
-<span class="sd">    ...         Rule(&#39;/&#39;, endpoint=&#39;kb/index&#39;),</span>
-<span class="sd">    ...         Rule(&#39;/browse/&#39;, endpoint=&#39;kb/browse&#39;),</span>
-<span class="sd">    ...         Rule(&#39;/browse/&lt;int:id&gt;/&#39;, endpoint=&#39;kb/browse&#39;),</span>
-<span class="sd">    ...         Rule(&#39;/browse/&lt;int:id&gt;/&lt;int:page&gt;&#39;, endpoint=&#39;kb/browse&#39;)</span>
-<span class="sd">    ...     ])</span>
-<span class="sd">    ... ], default_subdomain=&#39;www&#39;)</span>
-
-<span class="sd">    If the application doesn&#39;t use subdomains it&#39;s perfectly fine to not set</span>
-<span class="sd">    the default subdomain and not use the `Subdomain` rule factory.  The endpoint</span>
-<span class="sd">    in the rules can be anything, for example import paths or unique</span>
-<span class="sd">    identifiers.  The WSGI application can use those endpoints to get the</span>
-<span class="sd">    handler for that URL.  It doesn&#39;t have to be a string at all but it&#39;s</span>
-<span class="sd">    recommended.</span>
-
-<span class="sd">    Now it&#39;s possible to create a URL adapter for one of the subdomains and</span>
-<span class="sd">    build URLs:</span>
-
-<span class="sd">    &gt;&gt;&gt; c = m.bind(&#39;example.com&#39;)</span>
-<span class="sd">    &gt;&gt;&gt; c.build(&quot;kb/browse&quot;, dict(id=42))</span>
-<span class="sd">    &#39;http://kb.example.com/browse/42/&#39;</span>
-<span class="sd">    &gt;&gt;&gt; c.build(&quot;kb/browse&quot;, dict())</span>
-<span class="sd">    &#39;http://kb.example.com/browse/&#39;</span>
-<span class="sd">    &gt;&gt;&gt; c.build(&quot;kb/browse&quot;, dict(id=42, page=3))</span>
-<span class="sd">    &#39;http://kb.example.com/browse/42/3&#39;</span>
-<span class="sd">    &gt;&gt;&gt; c.build(&quot;static/about&quot;)</span>
-<span class="sd">    &#39;/about&#39;</span>
-<span class="sd">    &gt;&gt;&gt; c.build(&quot;static/index&quot;, force_external=True)</span>
-<span class="sd">    &#39;http://www.example.com/&#39;</span>
-
-<span class="sd">    &gt;&gt;&gt; c = m.bind(&#39;example.com&#39;, subdomain=&#39;kb&#39;)</span>
-<span class="sd">    &gt;&gt;&gt; c.build(&quot;static/about&quot;)</span>
-<span class="sd">    &#39;http://www.example.com/about&#39;</span>
-
-<span class="sd">    The first argument to bind is the server name *without* the subdomain.</span>
-<span class="sd">    Per default it will assume that the script is mounted on the root, but</span>
-<span class="sd">    often that&#39;s not the case so you can provide the real mount point as</span>
-<span class="sd">    second argument:</span>
-
-<span class="sd">    &gt;&gt;&gt; c = m.bind(&#39;example.com&#39;, &#39;/applications/example&#39;)</span>
-
-<span class="sd">    The third argument can be the subdomain, if not given the default</span>
-<span class="sd">    subdomain is used.  For more details about binding have a look at the</span>
-<span class="sd">    documentation of the `MapAdapter`.</span>
-
-<span class="sd">    And here is how you can match URLs:</span>
-
-<span class="sd">    &gt;&gt;&gt; c = m.bind(&#39;example.com&#39;)</span>
-<span class="sd">    &gt;&gt;&gt; c.match(&quot;/&quot;)</span>
-<span class="sd">    (&#39;static/index&#39;, {})</span>
-<span class="sd">    &gt;&gt;&gt; c.match(&quot;/about&quot;)</span>
-<span class="sd">    (&#39;static/about&#39;, {})</span>
-<span class="sd">    &gt;&gt;&gt; c = m.bind(&#39;example.com&#39;, &#39;/&#39;, &#39;kb&#39;)</span>
-<span class="sd">    &gt;&gt;&gt; c.match(&quot;/&quot;)</span>
-<span class="sd">    (&#39;kb/index&#39;, {})</span>
-<span class="sd">    &gt;&gt;&gt; c.match(&quot;/browse/42/23&quot;)</span>
-<span class="sd">    (&#39;kb/browse&#39;, {&#39;id&#39;: 42, &#39;page&#39;: 23})</span>
-
-<span class="sd">    If matching fails you get a `NotFound` exception, if the rule thinks</span>
-<span class="sd">    it&#39;s a good idea to redirect (for example because the URL was defined</span>
-<span class="sd">    to have a slash at the end but the request was missing that slash) it</span>
-<span class="sd">    will raise a `RequestRedirect` exception.  Both are subclasses of the</span>
-<span class="sd">    `HTTPException` so you can use those errors as responses in the</span>
-<span class="sd">    application.</span>
-
-<span class="sd">    If matching succeeded but the URL rule was incompatible to the given</span>
-<span class="sd">    method (for example there were only rules for `GET` and `HEAD` and</span>
-<span class="sd">    routing system tried to match a `POST` request) a `MethodNotAllowed`</span>
-<span class="sd">    method is raised.</span>
-
-
-<span class="sd">    :copyright: (c) 2014 by the Werkzeug Team, see AUTHORS for more details.</span>
-<span class="sd">    :license: BSD, see LICENSE for more details.</span>
-<span class="sd">&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">difflib</span>
-<span class="kn">import</span> <span class="nn">re</span>
-<span class="kn">import</span> <span class="nn">uuid</span>
-<span class="kn">import</span> <span class="nn">posixpath</span>
-
-<span class="kn">from</span> <span class="nn">pprint</span> <span class="k">import</span> <span class="n">pformat</span>
-<span class="kn">from</span> <span class="nn">threading</span> <span class="k">import</span> <span class="n">Lock</span>
-
-<span class="kn">from</span> <span class="nn">werkzeug.urls</span> <span class="k">import</span> <span class="n">url_encode</span><span class="p">,</span> <span class="n">url_quote</span><span class="p">,</span> <span class="n">url_join</span>
-<span class="kn">from</span> <span class="nn">werkzeug.utils</span> <span class="k">import</span> <span class="n">redirect</span><span class="p">,</span> <span class="n">format_string</span>
-<span class="kn">from</span> <span class="nn">werkzeug.exceptions</span> <span class="k">import</span> <span class="n">HTTPException</span><span class="p">,</span> <span class="n">NotFound</span><span class="p">,</span> <span class="n">MethodNotAllowed</span><span class="p">,</span> \
-     <span class="n">BadHost</span>
-<span class="kn">from</span> <span class="nn">werkzeug._internal</span> <span class="k">import</span> <span class="n">_get_environ</span><span class="p">,</span> <span class="n">_encode_idna</span>
-<span class="kn">from</span> <span class="nn">werkzeug._compat</span> <span class="k">import</span> <span class="n">itervalues</span><span class="p">,</span> <span class="n">iteritems</span><span class="p">,</span> <span class="n">to_unicode</span><span class="p">,</span> <span class="n">to_bytes</span><span class="p">,</span> \
-    <span class="n">text_type</span><span class="p">,</span> <span class="n">string_types</span><span class="p">,</span> <span class="n">native_string_result</span><span class="p">,</span> \
-    <span class="n">implements_to_string</span><span class="p">,</span> <span class="n">wsgi_decoding_dance</span>
-<span class="kn">from</span> <span class="nn">werkzeug.datastructures</span> <span class="k">import</span> <span class="n">ImmutableDict</span><span class="p">,</span> <span class="n">MultiDict</span>
-
-
-<span class="n">_rule_re</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s1">r&#39;&#39;&#39;</span>
-<span class="s1">    (?P&lt;static&gt;[^&lt;]*)                           # static rule data</span>
-<span class="s1">    &lt;</span>
-<span class="s1">    (?:</span>
-<span class="s1">        (?P&lt;converter&gt;[a-zA-Z_][a-zA-Z0-9_]*)   # converter name</span>
-<span class="s1">        (?:\((?P&lt;args&gt;.*?)\))?                  # converter arguments</span>
-<span class="s1">        \:                                      # variable delimiter</span>
-<span class="s1">    )?</span>
-<span class="s1">    (?P&lt;variable&gt;[a-zA-Z_][a-zA-Z0-9_]*)        # variable name</span>
-<span class="s1">    &gt;</span>
-<span class="s1">&#39;&#39;&#39;</span><span class="p">,</span> <span class="n">re</span><span class="o">.</span><span class="n">VERBOSE</span><span class="p">)</span>
-<span class="n">_simple_rule_re</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s1">r&#39;&lt;([^&gt;]+)&gt;&#39;</span><span class="p">)</span>
-<span class="n">_converter_args_re</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s1">r&#39;&#39;&#39;</span>
-<span class="s1">    ((?P&lt;name&gt;\w+)\s*=\s*)?</span>
-<span class="s1">    (?P&lt;value&gt;</span>
-<span class="s1">        True|False|</span>
-<span class="s1">        \d+.\d+|</span>
-<span class="s1">        \d+.|</span>
-<span class="s1">        \d+|</span>
-<span class="s1">        \w+|</span>
-<span class="s1">        [urUR]?(?P&lt;stringval&gt;&quot;[^&quot;]*?&quot;|&#39;[^&#39;]*&#39;)</span>
-<span class="s1">    )\s*,</span>
-<span class="s1">&#39;&#39;&#39;</span><span class="p">,</span> <span class="n">re</span><span class="o">.</span><span class="n">VERBOSE</span> <span class="o">|</span> <span class="n">re</span><span class="o">.</span><span class="n">UNICODE</span><span class="p">)</span>
-
-
-<span class="n">_PYTHON_CONSTANTS</span> <span class="o">=</span> <span class="p">{</span>
-    <span class="s1">&#39;None&#39;</span><span class="p">:</span>     <span class="kc">None</span><span class="p">,</span>
-    <span class="s1">&#39;True&#39;</span><span class="p">:</span>     <span class="kc">True</span><span class="p">,</span>
-    <span class="s1">&#39;False&#39;</span><span class="p">:</span>    <span class="kc">False</span>
-<span class="p">}</span>
-
-
-<span class="k">def</span> <span class="nf">_pythonize</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">_PYTHON_CONSTANTS</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">_PYTHON_CONSTANTS</span><span class="p">[</span><span class="n">value</span><span class="p">]</span>
-    <span class="k">for</span> <span class="n">convert</span> <span class="ow">in</span> <span class="nb">int</span><span class="p">,</span> <span class="nb">float</span><span class="p">:</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">convert</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-            <span class="k">pass</span>
-    <span class="k">if</span> <span class="n">value</span><span class="p">[:</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="n">value</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">:]</span> <span class="ow">and</span> <span class="n">value</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">in</span> <span class="s1">&#39;&quot;</span><span class="se">\&#39;</span><span class="s1">&#39;</span><span class="p">:</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="n">value</span><span class="p">[</span><span class="mi">1</span><span class="p">:</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-    <span class="k">return</span> <span class="n">text_type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">parse_converter_args</span><span class="p">(</span><span class="n">argstr</span><span class="p">):</span>
-    <span class="n">argstr</span> <span class="o">+=</span> <span class="s1">&#39;,&#39;</span>
-    <span class="n">args</span> <span class="o">=</span> <span class="p">[]</span>
-    <span class="n">kwargs</span> <span class="o">=</span> <span class="p">{}</span>
-
-    <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">_converter_args_re</span><span class="o">.</span><span class="n">finditer</span><span class="p">(</span><span class="n">argstr</span><span class="p">):</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="s1">&#39;stringval&#39;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="s1">&#39;value&#39;</span><span class="p">)</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="n">_pythonize</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">item</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="s1">&#39;name&#39;</span><span class="p">):</span>
-            <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">name</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="s1">&#39;name&#39;</span><span class="p">)</span>
-            <span class="n">kwargs</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-
-    <span class="k">return</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">args</span><span class="p">),</span> <span class="n">kwargs</span>
-
-
-<span class="k">def</span> <span class="nf">parse_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Parse a rule and return it as generator. Each iteration yields tuples</span>
-<span class="sd">    in the form ``(converter, arguments, variable)``. If the converter is</span>
-<span class="sd">    `None` it&#39;s a static url part, otherwise it&#39;s a dynamic one.</span>
-
-<span class="sd">    :internal:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">pos</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="n">end</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">rule</span><span class="p">)</span>
-    <span class="n">do_match</span> <span class="o">=</span> <span class="n">_rule_re</span><span class="o">.</span><span class="n">match</span>
-    <span class="n">used_names</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-    <span class="k">while</span> <span class="n">pos</span> <span class="o">&lt;</span> <span class="n">end</span><span class="p">:</span>
-        <span class="n">m</span> <span class="o">=</span> <span class="n">do_match</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="n">pos</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">m</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">break</span>
-        <span class="n">data</span> <span class="o">=</span> <span class="n">m</span><span class="o">.</span><span class="n">groupdict</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;static&#39;</span><span class="p">]:</span>
-            <span class="k">yield</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;static&#39;</span><span class="p">]</span>
-        <span class="n">variable</span> <span class="o">=</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;variable&#39;</span><span class="p">]</span>
-        <span class="n">converter</span> <span class="o">=</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;converter&#39;</span><span class="p">]</span> <span class="ow">or</span> <span class="s1">&#39;default&#39;</span>
-        <span class="k">if</span> <span class="n">variable</span> <span class="ow">in</span> <span class="n">used_names</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;variable name </span><span class="si">%r</span><span class="s1"> used twice.&#39;</span> <span class="o">%</span> <span class="n">variable</span><span class="p">)</span>
-        <span class="n">used_names</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">variable</span><span class="p">)</span>
-        <span class="k">yield</span> <span class="n">converter</span><span class="p">,</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;args&#39;</span><span class="p">]</span> <span class="ow">or</span> <span class="kc">None</span><span class="p">,</span> <span class="n">variable</span>
-        <span class="n">pos</span> <span class="o">=</span> <span class="n">m</span><span class="o">.</span><span class="n">end</span><span class="p">()</span>
-    <span class="k">if</span> <span class="n">pos</span> <span class="o">&lt;</span> <span class="n">end</span><span class="p">:</span>
-        <span class="n">remaining</span> <span class="o">=</span> <span class="n">rule</span><span class="p">[</span><span class="n">pos</span><span class="p">:]</span>
-        <span class="k">if</span> <span class="s1">&#39;&gt;&#39;</span> <span class="ow">in</span> <span class="n">remaining</span> <span class="ow">or</span> <span class="s1">&#39;&lt;&#39;</span> <span class="ow">in</span> <span class="n">remaining</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;malformed url rule: </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">rule</span><span class="p">)</span>
-        <span class="k">yield</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n">remaining</span>
-
-
-<span class="k">class</span> <span class="nc">RoutingException</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Special exceptions that require the application to redirect, notifying</span>
-<span class="sd">    about missing urls, etc.</span>
-
-<span class="sd">    :internal:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-
-<span class="k">class</span> <span class="nc">RequestRedirect</span><span class="p">(</span><span class="n">HTTPException</span><span class="p">,</span> <span class="n">RoutingException</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Raise if the map requests a redirect. This is for example the case if</span>
-<span class="sd">    `strict_slashes` are activated and an url that requires a trailing slash.</span>
-
-<span class="sd">    The attribute `new_url` contains the absolute destination url.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">code</span> <span class="o">=</span> <span class="mi">301</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">new_url</span><span class="p">):</span>
-        <span class="n">RoutingException</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">new_url</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">new_url</span> <span class="o">=</span> <span class="n">new_url</span>
-
-    <span class="k">def</span> <span class="nf">get_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">redirect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_url</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">code</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">RequestSlash</span><span class="p">(</span><span class="n">RoutingException</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Internal exception.&quot;&quot;&quot;</span>
-
-
-<span class="k">class</span> <span class="nc">RequestAliasRedirect</span><span class="p">(</span><span class="n">RoutingException</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;This rule is an alias and wants to redirect to the canonical URL.&quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">matched_values</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">matched_values</span> <span class="o">=</span> <span class="n">matched_values</span>
-
-
-<span class="k">class</span> <span class="nc">BuildError</span><span class="p">(</span><span class="n">RoutingException</span><span class="p">,</span> <span class="ne">LookupError</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Raised if the build system cannot find a URL for an endpoint with the</span>
-<span class="sd">    values provided.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">adapter</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="ne">LookupError</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span> <span class="o">=</span> <span class="n">endpoint</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">values</span> <span class="o">=</span> <span class="n">values</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">method</span> <span class="o">=</span> <span class="n">method</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">closest_rule</span><span class="p">(</span><span class="n">adapter</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">closest_rule</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">adapter</span><span class="p">):</span>
-        <span class="k">def</span> <span class="nf">score_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">):</span>
-            <span class="k">return</span> <span class="nb">sum</span><span class="p">([</span>
-                <span class="mf">0.98</span> <span class="o">*</span> <span class="n">difflib</span><span class="o">.</span><span class="n">SequenceMatcher</span><span class="p">(</span>
-                    <span class="kc">None</span><span class="p">,</span> <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span>
-                <span class="p">)</span><span class="o">.</span><span class="n">ratio</span><span class="p">(),</span>
-                <span class="mf">0.01</span> <span class="o">*</span> <span class="nb">bool</span><span class="p">(</span><span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">values</span> <span class="ow">or</span> <span class="p">())</span><span class="o">.</span><span class="n">issubset</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">arguments</span><span class="p">)),</span>
-                <span class="mf">0.01</span> <span class="o">*</span> <span class="nb">bool</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">methods</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">method</span> <span class="ow">in</span> <span class="n">rule</span><span class="o">.</span><span class="n">methods</span><span class="p">)</span>
-            <span class="p">])</span>
-
-        <span class="k">if</span> <span class="n">adapter</span> <span class="ow">and</span> <span class="n">adapter</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">_rules</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">max</span><span class="p">(</span><span class="n">adapter</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">_rules</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="n">score_rule</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">None</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">message</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;Could not build url for endpoint </span><span class="si">%r</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">method</span><span class="p">:</span>
-            <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot; (</span><span class="si">%r</span><span class="s2">)&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">method</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">values</span><span class="p">:</span>
-            <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot; with values </span><span class="si">%r</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="nb">sorted</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">values</span><span class="o">.</span><span class="n">keys</span><span class="p">()))</span>
-        <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="p">:</span>
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="o">.</span><span class="n">endpoint</span><span class="p">:</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">method</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">method</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="o">.</span><span class="n">methods</span><span class="p">:</span>
-                    <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot; Did you mean to use methods </span><span class="si">%r</span><span class="s2">?&quot;</span> <span class="o">%</span> <span class="nb">sorted</span><span class="p">(</span>
-                        <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="o">.</span><span class="n">methods</span>
-                    <span class="p">))</span>
-                <span class="n">missing_values</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="o">.</span><span class="n">arguments</span><span class="o">.</span><span class="n">union</span><span class="p">(</span>
-                    <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="o">.</span><span class="n">defaults</span> <span class="ow">or</span> <span class="p">())</span>
-                <span class="p">)</span> <span class="o">-</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">values</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
-                <span class="k">if</span> <span class="n">missing_values</span><span class="p">:</span>
-                    <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-                        <span class="s2">&quot; Did you forget to specify values </span><span class="si">%r</span><span class="s2">?&quot;</span> <span class="o">%</span>
-                        <span class="nb">sorted</span><span class="p">(</span><span class="n">missing_values</span><span class="p">)</span>
-                    <span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">message</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-                    <span class="s2">&quot; Did you mean </span><span class="si">%r</span><span class="s2"> instead?&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">suggested</span><span class="o">.</span><span class="n">endpoint</span>
-                <span class="p">)</span>
-        <span class="k">return</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">message</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">ValidationError</span><span class="p">(</span><span class="ne">ValueError</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Validation error.  If a rule converter raises this exception the rule</span>
-<span class="sd">    does not match the current URL and the next URL is tried.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-
-<span class="k">class</span> <span class="nc">RuleFactory</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;As soon as you have more complex URL setups it&#39;s a good idea to use rule</span>
-<span class="sd">    factories to avoid repetitive tasks.  Some of them are builtin, others can</span>
-<span class="sd">    be added by subclassing `RuleFactory` and overriding `get_rules`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Subclasses of `RuleFactory` have to override this method and return</span>
-<span class="sd">        an iterable of rules.&quot;&quot;&quot;</span>
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span>
-
-
-<span class="k">class</span> <span class="nc">Subdomain</span><span class="p">(</span><span class="n">RuleFactory</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;All URLs provided by this factory have the subdomain set to a</span>
-<span class="sd">    specific domain. For example if you want to use the subdomain for</span>
-<span class="sd">    the current language this can be a good setup::</span>
-
-<span class="sd">        url_map = Map([</span>
-<span class="sd">            Rule(&#39;/&#39;, endpoint=&#39;#select_language&#39;),</span>
-<span class="sd">            Subdomain(&#39;&lt;string(length=2):lang_code&gt;&#39;, [</span>
-<span class="sd">                Rule(&#39;/&#39;, endpoint=&#39;index&#39;),</span>
-<span class="sd">                Rule(&#39;/about&#39;, endpoint=&#39;about&#39;),</span>
-<span class="sd">                Rule(&#39;/help&#39;, endpoint=&#39;help&#39;)</span>
-<span class="sd">            ])</span>
-<span class="sd">        ])</span>
-
-<span class="sd">    All the rules except for the ``&#39;#select_language&#39;`` endpoint will now</span>
-<span class="sd">    listen on a two letter long subdomain that holds the language code</span>
-<span class="sd">    for the current request.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">subdomain</span><span class="p">,</span> <span class="n">rules</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="n">subdomain</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">rules</span> <span class="o">=</span> <span class="n">rules</span>
-
-    <span class="k">def</span> <span class="nf">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">rulefactory</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rules</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="n">rulefactory</span><span class="o">.</span><span class="n">get_rules</span><span class="p">(</span><span class="nb">map</span><span class="p">):</span>
-                <span class="n">rule</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">empty</span><span class="p">()</span>
-                <span class="n">rule</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span>
-                <span class="k">yield</span> <span class="n">rule</span>
-
-
-<span class="k">class</span> <span class="nc">Submount</span><span class="p">(</span><span class="n">RuleFactory</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Like `Subdomain` but prefixes the URL rule with a given string::</span>
-
-<span class="sd">        url_map = Map([</span>
-<span class="sd">            Rule(&#39;/&#39;, endpoint=&#39;index&#39;),</span>
-<span class="sd">            Submount(&#39;/blog&#39;, [</span>
-<span class="sd">                Rule(&#39;/&#39;, endpoint=&#39;blog/index&#39;),</span>
-<span class="sd">                Rule(&#39;/entry/&lt;entry_slug&gt;&#39;, endpoint=&#39;blog/show&#39;)</span>
-<span class="sd">            ])</span>
-<span class="sd">        ])</span>
-
-<span class="sd">    Now the rule ``&#39;blog/show&#39;`` matches ``/blog/entry/&lt;entry_slug&gt;``.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">,</span> <span class="n">rules</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="o">=</span> <span class="n">path</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">rules</span> <span class="o">=</span> <span class="n">rules</span>
-
-    <span class="k">def</span> <span class="nf">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">rulefactory</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rules</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="n">rulefactory</span><span class="o">.</span><span class="n">get_rules</span><span class="p">(</span><span class="nb">map</span><span class="p">):</span>
-                <span class="n">rule</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">empty</span><span class="p">()</span>
-                <span class="n">rule</span><span class="o">.</span><span class="n">rule</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="o">+</span> <span class="n">rule</span><span class="o">.</span><span class="n">rule</span>
-                <span class="k">yield</span> <span class="n">rule</span>
-
-
-<span class="k">class</span> <span class="nc">EndpointPrefix</span><span class="p">(</span><span class="n">RuleFactory</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Prefixes all endpoints (which must be strings for this factory) with</span>
-<span class="sd">    another string. This can be useful for sub applications::</span>
-
-<span class="sd">        url_map = Map([</span>
-<span class="sd">            Rule(&#39;/&#39;, endpoint=&#39;index&#39;),</span>
-<span class="sd">            EndpointPrefix(&#39;blog/&#39;, [Submount(&#39;/blog&#39;, [</span>
-<span class="sd">                Rule(&#39;/&#39;, endpoint=&#39;index&#39;),</span>
-<span class="sd">                Rule(&#39;/entry/&lt;entry_slug&gt;&#39;, endpoint=&#39;show&#39;)</span>
-<span class="sd">            ])])</span>
-<span class="sd">        ])</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">prefix</span><span class="p">,</span> <span class="n">rules</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">prefix</span> <span class="o">=</span> <span class="n">prefix</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">rules</span> <span class="o">=</span> <span class="n">rules</span>
-
-    <span class="k">def</span> <span class="nf">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">rulefactory</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rules</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="n">rulefactory</span><span class="o">.</span><span class="n">get_rules</span><span class="p">(</span><span class="nb">map</span><span class="p">):</span>
-                <span class="n">rule</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">empty</span><span class="p">()</span>
-                <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">prefix</span> <span class="o">+</span> <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span>
-                <span class="k">yield</span> <span class="n">rule</span>
-
-
-<span class="k">class</span> <span class="nc">RuleTemplate</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Returns copies of the rules wrapped and expands string templates in</span>
-<span class="sd">    the endpoint, rule, defaults or subdomain sections.</span>
-
-<span class="sd">    Here a small example for such a rule template::</span>
-
-<span class="sd">        from werkzeug.routing import Map, Rule, RuleTemplate</span>
-
-<span class="sd">        resource = RuleTemplate([</span>
-<span class="sd">            Rule(&#39;/$name/&#39;, endpoint=&#39;$name.list&#39;),</span>
-<span class="sd">            Rule(&#39;/$name/&lt;int:id&gt;&#39;, endpoint=&#39;$name.show&#39;)</span>
-<span class="sd">        ])</span>
-
-<span class="sd">        url_map = Map([resource(name=&#39;user&#39;), resource(name=&#39;page&#39;)])</span>
-
-<span class="sd">    When a rule template is called the keyword arguments are used to</span>
-<span class="sd">    replace the placeholders in all the string parameters.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rules</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">rules</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">rules</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__call__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">RuleTemplateFactory</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">rules</span><span class="p">,</span> <span class="nb">dict</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span>
-
-
-<span class="k">class</span> <span class="nc">RuleTemplateFactory</span><span class="p">(</span><span class="n">RuleFactory</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A factory that fills in template variables into rules.  Used by</span>
-<span class="sd">    `RuleTemplate` internally.</span>
-
-<span class="sd">    :internal:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rules</span><span class="p">,</span> <span class="n">context</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">rules</span> <span class="o">=</span> <span class="n">rules</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">context</span> <span class="o">=</span> <span class="n">context</span>
-
-    <span class="k">def</span> <span class="nf">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="k">for</span> <span class="n">rulefactory</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rules</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="n">rulefactory</span><span class="o">.</span><span class="n">get_rules</span><span class="p">(</span><span class="nb">map</span><span class="p">):</span>
-                <span class="n">new_defaults</span> <span class="o">=</span> <span class="n">subdomain</span> <span class="o">=</span> <span class="kc">None</span>
-                <span class="k">if</span> <span class="n">rule</span><span class="o">.</span><span class="n">defaults</span><span class="p">:</span>
-                    <span class="n">new_defaults</span> <span class="o">=</span> <span class="p">{}</span>
-                    <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">defaults</span><span class="p">):</span>
-                        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-                            <span class="n">value</span> <span class="o">=</span> <span class="n">format_string</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">context</span><span class="p">)</span>
-                        <span class="n">new_defaults</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-                <span class="k">if</span> <span class="n">rule</span><span class="o">.</span><span class="n">subdomain</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">subdomain</span> <span class="o">=</span> <span class="n">format_string</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">subdomain</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">context</span><span class="p">)</span>
-                <span class="n">new_endpoint</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span>
-                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">new_endpoint</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-                    <span class="n">new_endpoint</span> <span class="o">=</span> <span class="n">format_string</span><span class="p">(</span><span class="n">new_endpoint</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">context</span><span class="p">)</span>
-                <span class="k">yield</span> <span class="n">Rule</span><span class="p">(</span>
-                    <span class="n">format_string</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">rule</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">context</span><span class="p">),</span>
-                    <span class="n">new_defaults</span><span class="p">,</span>
-                    <span class="n">subdomain</span><span class="p">,</span>
-                    <span class="n">rule</span><span class="o">.</span><span class="n">methods</span><span class="p">,</span>
-                    <span class="n">rule</span><span class="o">.</span><span class="n">build_only</span><span class="p">,</span>
-                    <span class="n">new_endpoint</span><span class="p">,</span>
-                    <span class="n">rule</span><span class="o">.</span><span class="n">strict_slashes</span>
-                <span class="p">)</span>
-
-
-<span class="nd">@implements_to_string</span>
-<span class="k">class</span> <span class="nc">Rule</span><span class="p">(</span><span class="n">RuleFactory</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;A Rule represents one URL pattern.  There are some options for `Rule`</span>
-<span class="sd">    that change the way it behaves and are passed to the `Rule` constructor.</span>
-<span class="sd">    Note that besides the rule-string all arguments *must* be keyword arguments</span>
-<span class="sd">    in order to not break the application on Werkzeug upgrades.</span>
-
-<span class="sd">    `string`</span>
-<span class="sd">        Rule strings basically are just normal URL paths with placeholders in</span>
-<span class="sd">        the format ``&lt;converter(arguments):name&gt;`` where the converter and the</span>
-<span class="sd">        arguments are optional.  If no converter is defined the `default`</span>
-<span class="sd">        converter is used which means `string` in the normal configuration.</span>
-
-<span class="sd">        URL rules that end with a slash are branch URLs, others are leaves.</span>
-<span class="sd">        If you have `strict_slashes` enabled (which is the default), all</span>
-<span class="sd">        branch URLs that are matched without a trailing slash will trigger a</span>
-<span class="sd">        redirect to the same URL with the missing slash appended.</span>
-
-<span class="sd">        The converters are defined on the `Map`.</span>
-
-<span class="sd">    `endpoint`</span>
-<span class="sd">        The endpoint for this rule. This can be anything. A reference to a</span>
-<span class="sd">        function, a string, a number etc.  The preferred way is using a string</span>
-<span class="sd">        because the endpoint is used for URL generation.</span>
-
-<span class="sd">    `defaults`</span>
-<span class="sd">        An optional dict with defaults for other rules with the same endpoint.</span>
-<span class="sd">        This is a bit tricky but useful if you want to have unique URLs::</span>
-
-<span class="sd">            url_map = Map([</span>
-<span class="sd">                Rule(&#39;/all/&#39;, defaults={&#39;page&#39;: 1}, endpoint=&#39;all_entries&#39;),</span>
-<span class="sd">                Rule(&#39;/all/page/&lt;int:page&gt;&#39;, endpoint=&#39;all_entries&#39;)</span>
-<span class="sd">            ])</span>
-
-<span class="sd">        If a user now visits ``http://example.com/all/page/1`` he will be</span>
-<span class="sd">        redirected to ``http://example.com/all/``.  If `redirect_defaults` is</span>
-<span class="sd">        disabled on the `Map` instance this will only affect the URL</span>
-<span class="sd">        generation.</span>
-
-<span class="sd">    `subdomain`</span>
-<span class="sd">        The subdomain rule string for this rule. If not specified the rule</span>
-<span class="sd">        only matches for the `default_subdomain` of the map.  If the map is</span>
-<span class="sd">        not bound to a subdomain this feature is disabled.</span>
-
-<span class="sd">        Can be useful if you want to have user profiles on different subdomains</span>
-<span class="sd">        and all subdomains are forwarded to your application::</span>
-
-<span class="sd">            url_map = Map([</span>
-<span class="sd">                Rule(&#39;/&#39;, subdomain=&#39;&lt;username&gt;&#39;, endpoint=&#39;user/homepage&#39;),</span>
-<span class="sd">                Rule(&#39;/stats&#39;, subdomain=&#39;&lt;username&gt;&#39;, endpoint=&#39;user/stats&#39;)</span>
-<span class="sd">            ])</span>
-
-<span class="sd">    `methods`</span>
-<span class="sd">        A sequence of http methods this rule applies to.  If not specified, all</span>
-<span class="sd">        methods are allowed. For example this can be useful if you want different</span>
-<span class="sd">        endpoints for `POST` and `GET`.  If methods are defined and the path</span>
-<span class="sd">        matches but the method matched against is not in this list or in the</span>
-<span class="sd">        list of another rule for that path the error raised is of the type</span>
-<span class="sd">        `MethodNotAllowed` rather than `NotFound`.  If `GET` is present in the</span>
-<span class="sd">        list of methods and `HEAD` is not, `HEAD` is added automatically.</span>
-
-<span class="sd">        .. versionchanged:: 0.6.1</span>
-<span class="sd">           `HEAD` is now automatically added to the methods if `GET` is</span>
-<span class="sd">           present.  The reason for this is that existing code often did not</span>
-<span class="sd">           work properly in servers not rewriting `HEAD` to `GET`</span>
-<span class="sd">           automatically and it was not documented how `HEAD` should be</span>
-<span class="sd">           treated.  This was considered a bug in Werkzeug because of that.</span>
-
-<span class="sd">    `strict_slashes`</span>
-<span class="sd">        Override the `Map` setting for `strict_slashes` only for this rule. If</span>
-<span class="sd">        not specified the `Map` setting is used.</span>
-
-<span class="sd">    `build_only`</span>
-<span class="sd">        Set this to True and the rule will never match but will create a URL</span>
-<span class="sd">        that can be build. This is useful if you have resources on a subdomain</span>
-<span class="sd">        or folder that are not handled by the WSGI application (like static data)</span>
-
-<span class="sd">    `redirect_to`</span>
-<span class="sd">        If given this must be either a string or callable.  In case of a</span>
-<span class="sd">        callable it&#39;s called with the url adapter that triggered the match and</span>
-<span class="sd">        the values of the URL as keyword arguments and has to return the target</span>
-<span class="sd">        for the redirect, otherwise it has to be a string with placeholders in</span>
-<span class="sd">        rule syntax::</span>
-
-<span class="sd">            def foo_with_slug(adapter, id):</span>
-<span class="sd">                # ask the database for the slug for the old id.  this of</span>
-<span class="sd">                # course has nothing to do with werkzeug.</span>
-<span class="sd">                return &#39;foo/&#39; + Foo.get_slug_for_id(id)</span>
-
-<span class="sd">            url_map = Map([</span>
-<span class="sd">                Rule(&#39;/foo/&lt;slug&gt;&#39;, endpoint=&#39;foo&#39;),</span>
-<span class="sd">                Rule(&#39;/some/old/url/&lt;slug&gt;&#39;, redirect_to=&#39;foo/&lt;slug&gt;&#39;),</span>
-<span class="sd">                Rule(&#39;/other/old/url/&lt;int:id&gt;&#39;, redirect_to=foo_with_slug)</span>
-<span class="sd">            ])</span>
-
-<span class="sd">        When the rule is matched the routing system will raise a</span>
-<span class="sd">        `RequestRedirect` exception with the target for the redirect.</span>
-
-<span class="sd">        Keep in mind that the URL will be joined against the URL root of the</span>
-<span class="sd">        script so don&#39;t use a leading slash on the target URL unless you</span>
-<span class="sd">        really mean root of that domain.</span>
-
-<span class="sd">    `alias`</span>
-<span class="sd">        If enabled this rule serves as an alias for another rule with the same</span>
-<span class="sd">        endpoint and arguments.</span>
-
-<span class="sd">    `host`</span>
-<span class="sd">        If provided and the URL map has host matching enabled this can be</span>
-<span class="sd">        used to provide a match rule for the whole host.  This also means</span>
-<span class="sd">        that the subdomain feature is disabled.</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">       The `alias` and `host` parameters were added.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">string</span><span class="p">,</span> <span class="n">defaults</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">subdomain</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">methods</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">build_only</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">strict_slashes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">redirect_to</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">string</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;urls must start with a leading slash&#39;</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">rule</span> <span class="o">=</span> <span class="n">string</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">is_leaf</span> <span class="o">=</span> <span class="ow">not</span> <span class="n">string</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span> <span class="o">=</span> <span class="n">strict_slashes</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="n">subdomain</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">host</span> <span class="o">=</span> <span class="n">host</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span> <span class="o">=</span> <span class="n">defaults</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">build_only</span> <span class="o">=</span> <span class="n">build_only</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">alias</span> <span class="o">=</span> <span class="n">alias</span>
-        <span class="k">if</span> <span class="n">methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">methods</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">methods</span> <span class="o">=</span> <span class="nb">set</span><span class="p">([</span><span class="n">x</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">methods</span><span class="p">])</span>
-            <span class="k">if</span> <span class="s1">&#39;HEAD&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">methods</span> <span class="ow">and</span> <span class="s1">&#39;GET&#39;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">methods</span><span class="p">:</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">methods</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="s1">&#39;HEAD&#39;</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span> <span class="o">=</span> <span class="n">endpoint</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">redirect_to</span> <span class="o">=</span> <span class="n">redirect_to</span>
-
-        <span class="k">if</span> <span class="n">defaults</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">arguments</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="nb">map</span><span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">defaults</span><span class="p">))</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">arguments</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_converters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_regex</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_weights</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        Return an unbound copy of this rule.</span>
-
-<span class="sd">        This can be useful if want to reuse an already bound URL for another</span>
-<span class="sd">        map.  See ``get_empty_kwargs`` to override what keyword arguments are</span>
-<span class="sd">        provided to the new copy.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="p">)(</span><span class="bp">self</span><span class="o">.</span><span class="n">rule</span><span class="p">,</span> <span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">get_empty_kwargs</span><span class="p">())</span>
-
-    <span class="k">def</span> <span class="nf">get_empty_kwargs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        Provides kwargs for instantiating empty copy with empty()</span>
-
-<span class="sd">        Use this method to provide custom keyword arguments to the subclass of</span>
-<span class="sd">        ``Rule`` when calling ``some_rule.empty()``.  Helpful when the subclass</span>
-<span class="sd">        has custom keyword arguments that are needed at instantiation.</span>
-
-<span class="sd">        Must return a ``dict`` that will be provided as kwargs to the new</span>
-<span class="sd">        instance of ``Rule``, following the initial ``self.rule`` value which</span>
-<span class="sd">        is always provided as the first, required positional argument.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">defaults</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span><span class="p">:</span>
-            <span class="n">defaults</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">defaults</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="n">defaults</span><span class="o">=</span><span class="n">defaults</span><span class="p">,</span> <span class="n">subdomain</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span><span class="p">,</span>
-                    <span class="n">methods</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">methods</span><span class="p">,</span> <span class="n">build_only</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">build_only</span><span class="p">,</span>
-                    <span class="n">endpoint</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">strict_slashes</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span><span class="p">,</span>
-                    <span class="n">redirect_to</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">redirect_to</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span>
-                    <span class="n">host</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">host</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="k">yield</span> <span class="bp">self</span>
-
-    <span class="k">def</span> <span class="nf">refresh</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Rebinds and refreshes the URL.  Call this if you modified the</span>
-<span class="sd">        rule in place.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="p">,</span> <span class="n">rebind</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">bind</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="n">rebind</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Bind the url to a map and create a regular expression based on</span>
-<span class="sd">        the information from the rule itself and the defaults from the map.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">rebind</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;url rule </span><span class="si">%r</span><span class="s1"> already bound to map </span><span class="si">%r</span><span class="s1">&#39;</span> <span class="o">%</span>
-                               <span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="p">))</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">=</span> <span class="nb">map</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span> <span class="o">=</span> <span class="nb">map</span><span class="o">.</span><span class="n">strict_slashes</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="nb">map</span><span class="o">.</span><span class="n">default_subdomain</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">compile</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">get_converter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">variable_name</span><span class="p">,</span> <span class="n">converter_name</span><span class="p">,</span> <span class="n">args</span><span class="p">,</span> <span class="n">kwargs</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Looks up the converter for the given parameter.</span>
-
-<span class="sd">        .. versionadded:: 0.9</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="n">converter_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">converters</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">LookupError</span><span class="p">(</span><span class="s1">&#39;the converter </span><span class="si">%r</span><span class="s1"> does not exist&#39;</span> <span class="o">%</span> <span class="n">converter_name</span><span class="p">)</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">converters</span><span class="p">[</span><span class="n">converter_name</span><span class="p">](</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">compile</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compiles the regular expression and stores it.&quot;&quot;&quot;</span>
-        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">,</span> <span class="s1">&#39;rule not bound&#39;</span>
-
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">host_matching</span><span class="p">:</span>
-            <span class="n">domain_rule</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">host</span> <span class="ow">or</span> <span class="s1">&#39;&#39;</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">domain_rule</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="ow">or</span> <span class="s1">&#39;&#39;</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_converters</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_weights</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="n">regex_parts</span> <span class="o">=</span> <span class="p">[]</span>
-
-        <span class="k">def</span> <span class="nf">_build_regex</span><span class="p">(</span><span class="n">rule</span><span class="p">):</span>
-            <span class="k">for</span> <span class="n">converter</span><span class="p">,</span> <span class="n">arguments</span><span class="p">,</span> <span class="n">variable</span> <span class="ow">in</span> <span class="n">parse_rule</span><span class="p">(</span><span class="n">rule</span><span class="p">):</span>
-                <span class="k">if</span> <span class="n">converter</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">regex_parts</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">re</span><span class="o">.</span><span class="n">escape</span><span class="p">(</span><span class="n">variable</span><span class="p">))</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="kc">False</span><span class="p">,</span> <span class="n">variable</span><span class="p">))</span>
-                    <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">variable</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">):</span>
-                        <span class="k">if</span> <span class="n">part</span><span class="p">:</span>
-                            <span class="bp">self</span><span class="o">.</span><span class="n">_weights</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="mi">0</span><span class="p">,</span> <span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="n">part</span><span class="p">)))</span>
-                <span class="k">else</span><span class="p">:</span>
-                    <span class="k">if</span> <span class="n">arguments</span><span class="p">:</span>
-                        <span class="n">c_args</span><span class="p">,</span> <span class="n">c_kwargs</span> <span class="o">=</span> <span class="n">parse_converter_args</span><span class="p">(</span><span class="n">arguments</span><span class="p">)</span>
-                    <span class="k">else</span><span class="p">:</span>
-                        <span class="n">c_args</span> <span class="o">=</span> <span class="p">()</span>
-                        <span class="n">c_kwargs</span> <span class="o">=</span> <span class="p">{}</span>
-                    <span class="n">convobj</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_converter</span><span class="p">(</span>
-                        <span class="n">variable</span><span class="p">,</span> <span class="n">converter</span><span class="p">,</span> <span class="n">c_args</span><span class="p">,</span> <span class="n">c_kwargs</span><span class="p">)</span>
-                    <span class="n">regex_parts</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;(?P&lt;</span><span class="si">%s</span><span class="s1">&gt;</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">variable</span><span class="p">,</span> <span class="n">convobj</span><span class="o">.</span><span class="n">regex</span><span class="p">))</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_converters</span><span class="p">[</span><span class="n">variable</span><span class="p">]</span> <span class="o">=</span> <span class="n">convobj</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="kc">True</span><span class="p">,</span> <span class="n">variable</span><span class="p">))</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">_weights</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="mi">1</span><span class="p">,</span> <span class="n">convobj</span><span class="o">.</span><span class="n">weight</span><span class="p">))</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">arguments</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">variable</span><span class="p">))</span>
-
-        <span class="n">_build_regex</span><span class="p">(</span><span class="n">domain_rule</span><span class="p">)</span>
-        <span class="n">regex_parts</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\\</span><span class="s1">|&#39;</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="kc">False</span><span class="p">,</span> <span class="s1">&#39;|&#39;</span><span class="p">))</span>
-        <span class="n">_build_regex</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">is_leaf</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">rule</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">rule</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">))</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_leaf</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="kc">False</span><span class="p">,</span> <span class="s1">&#39;/&#39;</span><span class="p">))</span>
-
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">build_only</span><span class="p">:</span>
-            <span class="k">return</span>
-        <span class="n">regex</span> <span class="o">=</span> <span class="s1">r&#39;^</span><span class="si">%s%s</span><span class="s1">$&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="s1">u&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">regex_parts</span><span class="p">),</span>
-            <span class="p">(</span><span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_leaf</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span><span class="p">)</span> <span class="ow">and</span>
-            <span class="s1">&#39;(?&lt;!/)(?P&lt;__suffix__&gt;/?)&#39;</span> <span class="ow">or</span> <span class="s1">&#39;&#39;</span>
-        <span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_regex</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="n">regex</span><span class="p">,</span> <span class="n">re</span><span class="o">.</span><span class="n">UNICODE</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">match</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if the rule matches a given path. Path is a string in the</span>
-<span class="sd">        form ``&quot;subdomain|/path(method)&quot;`` and is assembled by the map.  If</span>
-<span class="sd">        the map is doing host matching the subdomain part will be the host</span>
-<span class="sd">        instead.</span>
-
-<span class="sd">        If the rule matches a dict with the converted values is returned,</span>
-<span class="sd">        otherwise the return value is `None`.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">build_only</span><span class="p">:</span>
-            <span class="n">m</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_regex</span><span class="o">.</span><span class="n">search</span><span class="p">(</span><span class="n">path</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">m</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">groups</span> <span class="o">=</span> <span class="n">m</span><span class="o">.</span><span class="n">groupdict</span><span class="p">()</span>
-                <span class="c1"># we have a folder like part of the url without a trailing</span>
-                <span class="c1"># slash and strict slashes enabled. raise an exception that</span>
-                <span class="c1"># tells the map to redirect to the same url but with a</span>
-                <span class="c1"># trailing slash</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_leaf</span> <span class="ow">and</span> \
-                   <span class="ow">not</span> <span class="n">groups</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s1">&#39;__suffix__&#39;</span><span class="p">):</span>
-                    <span class="k">raise</span> <span class="n">RequestSlash</span><span class="p">()</span>
-                <span class="c1"># if we are not in strict slashes mode we have to remove</span>
-                <span class="c1"># a __suffix__</span>
-                <span class="k">elif</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span><span class="p">:</span>
-                    <span class="k">del</span> <span class="n">groups</span><span class="p">[</span><span class="s1">&#39;__suffix__&#39;</span><span class="p">]</span>
-
-                <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span>
-                <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">groups</span><span class="p">):</span>
-                    <span class="k">try</span><span class="p">:</span>
-                        <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_converters</span><span class="p">[</span><span class="n">name</span><span class="p">]</span><span class="o">.</span><span class="n">to_python</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-                    <span class="k">except</span> <span class="n">ValidationError</span><span class="p">:</span>
-                        <span class="k">return</span>
-                    <span class="n">result</span><span class="p">[</span><span class="nb">str</span><span class="p">(</span><span class="n">name</span><span class="p">)]</span> <span class="o">=</span> <span class="n">value</span>
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span><span class="p">:</span>
-                    <span class="n">result</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">defaults</span><span class="p">)</span>
-
-                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">alias</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">redirect_defaults</span><span class="p">:</span>
-                    <span class="k">raise</span> <span class="n">RequestAliasRedirect</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
-
-                <span class="k">return</span> <span class="n">result</span>
-
-    <span class="k">def</span> <span class="nf">build</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">append_unknown</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Assembles the relative url for that rule and the subdomain.</span>
-<span class="sd">        If building doesn&#39;t work for some reasons `None` is returned.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">tmp</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="n">add</span> <span class="o">=</span> <span class="n">tmp</span><span class="o">.</span><span class="n">append</span>
-        <span class="n">processed</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">arguments</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">is_dynamic</span><span class="p">,</span> <span class="n">data</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">is_dynamic</span><span class="p">:</span>
-                <span class="k">try</span><span class="p">:</span>
-                    <span class="n">add</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_converters</span><span class="p">[</span><span class="n">data</span><span class="p">]</span><span class="o">.</span><span class="n">to_url</span><span class="p">(</span><span class="n">values</span><span class="p">[</span><span class="n">data</span><span class="p">]))</span>
-                <span class="k">except</span> <span class="n">ValidationError</span><span class="p">:</span>
-                    <span class="k">return</span>
-                <span class="n">processed</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">add</span><span class="p">(</span><span class="n">url_quote</span><span class="p">(</span><span class="n">to_bytes</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">charset</span><span class="p">),</span> <span class="n">safe</span><span class="o">=</span><span class="s1">&#39;/:|+&#39;</span><span class="p">))</span>
-        <span class="n">domain_part</span><span class="p">,</span> <span class="n">url</span> <span class="o">=</span> <span class="p">(</span><span class="s1">u&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">tmp</span><span class="p">))</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">u&#39;|&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="n">append_unknown</span><span class="p">:</span>
-            <span class="n">query_vars</span> <span class="o">=</span> <span class="n">MultiDict</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-            <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">processed</span><span class="p">:</span>
-                <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">query_vars</span><span class="p">:</span>
-                    <span class="k">del</span> <span class="n">query_vars</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
-
-            <span class="k">if</span> <span class="n">query_vars</span><span class="p">:</span>
-                <span class="n">url</span> <span class="o">+=</span> <span class="s1">u&#39;?&#39;</span> <span class="o">+</span> <span class="n">url_encode</span><span class="p">(</span><span class="n">query_vars</span><span class="p">,</span> <span class="n">charset</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">charset</span><span class="p">,</span>
-                                         <span class="n">sort</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">sort_parameters</span><span class="p">,</span>
-                                         <span class="n">key</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">sort_key</span><span class="p">)</span>
-
-        <span class="k">return</span> <span class="n">domain_part</span><span class="p">,</span> <span class="n">url</span>
-
-    <span class="k">def</span> <span class="nf">provides_defaults_for</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if this rule has defaults for a given rule.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">build_only</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span> <span class="ow">and</span> \
-            <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span> <span class="o">==</span> <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span> <span class="ow">and</span> <span class="bp">self</span> <span class="o">!=</span> <span class="n">rule</span> <span class="ow">and</span> \
-            <span class="bp">self</span><span class="o">.</span><span class="n">arguments</span> <span class="o">==</span> <span class="n">rule</span><span class="o">.</span><span class="n">arguments</span>
-
-    <span class="k">def</span> <span class="nf">suitable_for</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Check if the dict of values has enough data for url generation.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="c1"># if a method was given explicitly and that method is not supported</span>
-        <span class="c1"># by this rule, this rule is not suitable.</span>
-        <span class="k">if</span> <span class="n">method</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> \
-           <span class="ow">and</span> <span class="n">method</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">methods</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-
-        <span class="n">defaults</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">defaults</span> <span class="ow">or</span> <span class="p">()</span>
-
-        <span class="c1"># all arguments required must be either in the defaults dict or</span>
-        <span class="c1"># the value dictionary otherwise it&#39;s not suitable</span>
-        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">arguments</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">defaults</span> <span class="ow">and</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">values</span><span class="p">:</span>
-                <span class="k">return</span> <span class="kc">False</span>
-
-        <span class="c1"># in case defaults are given we ensure taht either the value was</span>
-        <span class="c1"># skipped or the value is the same as the default value.</span>
-        <span class="k">if</span> <span class="n">defaults</span><span class="p">:</span>
-            <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">defaults</span><span class="p">):</span>
-                <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">values</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">!=</span> <span class="n">values</span><span class="p">[</span><span class="n">key</span><span class="p">]:</span>
-                    <span class="k">return</span> <span class="kc">False</span>
-
-        <span class="k">return</span> <span class="kc">True</span>
-
-    <span class="k">def</span> <span class="nf">match_compare_key</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The match compare key for sorting.</span>
-
-<span class="sd">        Current implementation:</span>
-
-<span class="sd">        1.  rules without any arguments come first for performance</span>
-<span class="sd">            reasons only as we expect them to match faster and some</span>
-<span class="sd">            common ones usually don&#39;t have any arguments (index pages etc.)</span>
-<span class="sd">        2.  The more complex rules come first so the second argument is the</span>
-<span class="sd">            negative length of the number of weights.</span>
-<span class="sd">        3.  lastly we order by the actual weights.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">arguments</span><span class="p">),</span> <span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_weights</span><span class="p">),</span> <span class="bp">self</span><span class="o">.</span><span class="n">_weights</span>
-
-    <span class="k">def</span> <span class="nf">build_compare_key</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The build compare key for sorting.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">alias</span> <span class="ow">and</span> <span class="mi">1</span> <span class="ow">or</span> <span class="mi">0</span><span class="p">,</span> <span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">arguments</span><span class="p">),</span> \
-            <span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">defaults</span> <span class="ow">or</span> <span class="p">())</span>
-
-    <span class="k">def</span> <span class="nf">__eq__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span> <span class="ow">is</span> <span class="n">other</span><span class="o">.</span><span class="n">__class__</span> <span class="ow">and</span> \
-            <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span> <span class="o">==</span> <span class="n">other</span><span class="o">.</span><span class="n">_trace</span>
-
-    <span class="k">def</span> <span class="nf">__ne__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span>
-        <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">__eq__</span><span class="p">(</span><span class="n">other</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">rule</span>
-
-    <span class="nd">@native_string_result</span>
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="s1">u&#39;&lt;</span><span class="si">%s</span><span class="s1"> (unbound)&gt;&#39;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span>
-        <span class="n">tmp</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="k">for</span> <span class="n">is_dynamic</span><span class="p">,</span> <span class="n">data</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_trace</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">is_dynamic</span><span class="p">:</span>
-                <span class="n">tmp</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s1">u&#39;&lt;</span><span class="si">%s</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="n">data</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">tmp</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
-        <span class="k">return</span> <span class="s1">u&#39;&lt;</span><span class="si">%s</span><span class="s1"> </span><span class="si">%s%s</span><span class="s1"> -&gt; </span><span class="si">%s</span><span class="s1">&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span>
-            <span class="nb">repr</span><span class="p">((</span><span class="s1">u&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">tmp</span><span class="p">))</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">u&#39;|&#39;</span><span class="p">))</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">u&#39;u&#39;</span><span class="p">),</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-            <span class="ow">and</span> <span class="s1">u&#39; (</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="s1">u&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">methods</span><span class="p">)</span>
-            <span class="ow">or</span> <span class="s1">u&#39;&#39;</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">endpoint</span>
-        <span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">BaseConverter</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Base class for all converters.&quot;&quot;&quot;</span>
-    <span class="n">regex</span> <span class="o">=</span> <span class="s1">&#39;[^/]+&#39;</span>
-    <span class="n">weight</span> <span class="o">=</span> <span class="mi">100</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">=</span> <span class="nb">map</span>
-
-    <span class="k">def</span> <span class="nf">to_python</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">to_url</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">url_quote</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">charset</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">charset</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">UnicodeConverter</span><span class="p">(</span><span class="n">BaseConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;This converter is the default converter and accepts any string but</span>
-<span class="sd">    only one path segment.  Thus the string can not include a slash.</span>
-
-<span class="sd">    This is the default validator.</span>
-
-<span class="sd">    Example::</span>
-
-<span class="sd">        Rule(&#39;/pages/&lt;page&gt;&#39;),</span>
-<span class="sd">        Rule(&#39;/&lt;string(length=2):lang_code&gt;&#39;)</span>
-
-<span class="sd">    :param map: the :class:`Map`.</span>
-<span class="sd">    :param minlength: the minimum length of the string.  Must be greater</span>
-<span class="sd">                      or equal 1.</span>
-<span class="sd">    :param maxlength: the maximum length of the string.</span>
-<span class="sd">    :param length: the exact length of the string.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="n">minlength</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">maxlength</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">BaseConverter</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">length</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">length</span> <span class="o">=</span> <span class="s1">&#39;{</span><span class="si">%d</span><span class="s1">}&#39;</span> <span class="o">%</span> <span class="nb">int</span><span class="p">(</span><span class="n">length</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">maxlength</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">maxlength</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">maxlength</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">maxlength</span><span class="p">)</span>
-            <span class="n">length</span> <span class="o">=</span> <span class="s1">&#39;{</span><span class="si">%s</span><span class="s1">,</span><span class="si">%s</span><span class="s1">}&#39;</span> <span class="o">%</span> <span class="p">(</span>
-                <span class="nb">int</span><span class="p">(</span><span class="n">minlength</span><span class="p">),</span>
-                <span class="n">maxlength</span>
-            <span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">regex</span> <span class="o">=</span> <span class="s1">&#39;[^/]&#39;</span> <span class="o">+</span> <span class="n">length</span>
-
-
-<span class="k">class</span> <span class="nc">AnyConverter</span><span class="p">(</span><span class="n">BaseConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Matches one of the items provided.  Items can either be Python</span>
-<span class="sd">    identifiers or strings::</span>
-
-<span class="sd">        Rule(&#39;/&lt;any(about, help, imprint, class, &quot;foo,bar&quot;):page_name&gt;&#39;)</span>
-
-<span class="sd">    :param map: the :class:`Map`.</span>
-<span class="sd">    :param items: this function accepts the possible items as positional</span>
-<span class="sd">                  arguments.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="o">*</span><span class="n">items</span><span class="p">):</span>
-        <span class="n">BaseConverter</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">regex</span> <span class="o">=</span> <span class="s1">&#39;(?:</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="s1">&#39;|&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">re</span><span class="o">.</span><span class="n">escape</span><span class="p">(</span><span class="n">x</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">items</span><span class="p">])</span>
-
-
-<span class="k">class</span> <span class="nc">PathConverter</span><span class="p">(</span><span class="n">BaseConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Like the default :class:`UnicodeConverter`, but it also matches</span>
-<span class="sd">    slashes.  This is useful for wikis and similar applications::</span>
-
-<span class="sd">        Rule(&#39;/&lt;path:wikipage&gt;&#39;)</span>
-<span class="sd">        Rule(&#39;/&lt;path:wikipage&gt;/edit&#39;)</span>
-
-<span class="sd">    :param map: the :class:`Map`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">regex</span> <span class="o">=</span> <span class="s1">&#39;[^/].*?&#39;</span>
-    <span class="n">weight</span> <span class="o">=</span> <span class="mi">200</span>
-
-
-<span class="k">class</span> <span class="nc">NumberConverter</span><span class="p">(</span><span class="n">BaseConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Baseclass for `IntegerConverter` and `FloatConverter`.</span>
-
-<span class="sd">    :internal:</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">weight</span> <span class="o">=</span> <span class="mi">50</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="n">fixed_digits</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">min</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">BaseConverter</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">fixed_digits</span> <span class="o">=</span> <span class="n">fixed_digits</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">min</span> <span class="o">=</span> <span class="nb">min</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">max</span> <span class="o">=</span> <span class="nb">max</span>
-
-    <span class="k">def</span> <span class="nf">to_python</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">if</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fixed_digits</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fixed_digits</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">()</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">num_convert</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">if</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">min</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">min</span><span class="p">)</span> <span class="ow">or</span> \
-           <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">max</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">max</span><span class="p">):</span>
-            <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">()</span>
-        <span class="k">return</span> <span class="n">value</span>
-
-    <span class="k">def</span> <span class="nf">to_url</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">num_convert</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fixed_digits</span><span class="p">:</span>
-            <span class="n">value</span> <span class="o">=</span> <span class="p">(</span><span class="s1">&#39;</span><span class="si">%%</span><span class="s1">0</span><span class="si">%s</span><span class="s1">d&#39;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">fixed_digits</span><span class="p">)</span> <span class="o">%</span> <span class="n">value</span>
-        <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">IntegerConverter</span><span class="p">(</span><span class="n">NumberConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;This converter only accepts integer values::</span>
-
-<span class="sd">        Rule(&#39;/page/&lt;int:page&gt;&#39;)</span>
-
-<span class="sd">    This converter does not support negative values.</span>
-
-<span class="sd">    :param map: the :class:`Map`.</span>
-<span class="sd">    :param fixed_digits: the number of fixed digits in the URL.  If you set</span>
-<span class="sd">                         this to ``4`` for example, the application will</span>
-<span class="sd">                         only match if the url looks like ``/0001/``.  The</span>
-<span class="sd">                         default is variable length.</span>
-<span class="sd">    :param min: the minimal value.</span>
-<span class="sd">    :param max: the maximal value.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">regex</span> <span class="o">=</span> <span class="s1">r&#39;\d+&#39;</span>
-    <span class="n">num_convert</span> <span class="o">=</span> <span class="nb">int</span>
-
-
-<span class="k">class</span> <span class="nc">FloatConverter</span><span class="p">(</span><span class="n">NumberConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;This converter only accepts floating point values::</span>
-
-<span class="sd">        Rule(&#39;/probability/&lt;float:probability&gt;&#39;)</span>
-
-<span class="sd">    This converter does not support negative values.</span>
-
-<span class="sd">    :param map: the :class:`Map`.</span>
-<span class="sd">    :param min: the minimal value.</span>
-<span class="sd">    :param max: the maximal value.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">regex</span> <span class="o">=</span> <span class="s1">r&#39;\d+\.\d+&#39;</span>
-    <span class="n">num_convert</span> <span class="o">=</span> <span class="nb">float</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="nb">min</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="n">NumberConverter</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nb">min</span><span class="p">,</span> <span class="nb">max</span><span class="p">)</span>
-
-
-<span class="k">class</span> <span class="nc">UUIDConverter</span><span class="p">(</span><span class="n">BaseConverter</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;This converter only accepts UUID strings::</span>
-
-<span class="sd">        Rule(&#39;/object/&lt;uuid:identifier&gt;&#39;)</span>
-
-<span class="sd">    .. versionadded:: 0.10</span>
-
-<span class="sd">    :param map: the :class:`Map`.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">regex</span> <span class="o">=</span> <span class="s1">r&#39;[A-Fa-f0-9]</span><span class="si">{8}</span><span class="s1">-[A-Fa-f0-9]</span><span class="si">{4}</span><span class="s1">-&#39;</span> \
-            <span class="s1">r&#39;[A-Fa-f0-9]</span><span class="si">{4}</span><span class="s1">-[A-Fa-f0-9]</span><span class="si">{4}</span><span class="s1">-[A-Fa-f0-9]</span><span class="si">{12}</span><span class="s1">&#39;</span>
-
-    <span class="k">def</span> <span class="nf">to_python</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">to_url</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-
-
-<span class="c1">#: the default converter mapping for the map.</span>
-<span class="n">DEFAULT_CONVERTERS</span> <span class="o">=</span> <span class="p">{</span>
-    <span class="s1">&#39;default&#39;</span><span class="p">:</span>          <span class="n">UnicodeConverter</span><span class="p">,</span>
-    <span class="s1">&#39;string&#39;</span><span class="p">:</span>           <span class="n">UnicodeConverter</span><span class="p">,</span>
-    <span class="s1">&#39;any&#39;</span><span class="p">:</span>              <span class="n">AnyConverter</span><span class="p">,</span>
-    <span class="s1">&#39;path&#39;</span><span class="p">:</span>             <span class="n">PathConverter</span><span class="p">,</span>
-    <span class="s1">&#39;int&#39;</span><span class="p">:</span>              <span class="n">IntegerConverter</span><span class="p">,</span>
-    <span class="s1">&#39;float&#39;</span><span class="p">:</span>            <span class="n">FloatConverter</span><span class="p">,</span>
-    <span class="s1">&#39;uuid&#39;</span><span class="p">:</span>             <span class="n">UUIDConverter</span><span class="p">,</span>
-<span class="p">}</span>
-
-
-<span class="k">class</span> <span class="nc">Map</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;The map class stores all the URL rules and some configuration</span>
-<span class="sd">    parameters.  Some of the configuration values are only stored on the</span>
-<span class="sd">    `Map` instance since those affect all rules, others are just defaults</span>
-<span class="sd">    and can be overridden for each rule.  Note that you have to specify all</span>
-<span class="sd">    arguments besides the `rules` as keyword arguments!</span>
-
-<span class="sd">    :param rules: sequence of url rules for this map.</span>
-<span class="sd">    :param default_subdomain: The default subdomain for rules without a</span>
-<span class="sd">                              subdomain defined.</span>
-<span class="sd">    :param charset: charset of the url. defaults to ``&quot;utf-8&quot;``</span>
-<span class="sd">    :param strict_slashes: Take care of trailing slashes.</span>
-<span class="sd">    :param redirect_defaults: This will redirect to the default rule if it</span>
-<span class="sd">                              wasn&#39;t visited that way. This helps creating</span>
-<span class="sd">                              unique URLs.</span>
-<span class="sd">    :param converters: A dict of converters that adds additional converters</span>
-<span class="sd">                       to the list of converters. If you redefine one</span>
-<span class="sd">                       converter this will override the original one.</span>
-<span class="sd">    :param sort_parameters: If set to `True` the url parameters are sorted.</span>
-<span class="sd">                            See `url_encode` for more details.</span>
-<span class="sd">    :param sort_key: The sort key function for `url_encode`.</span>
-<span class="sd">    :param encoding_errors: the error method to use for decoding</span>
-<span class="sd">    :param host_matching: if set to `True` it enables the host matching</span>
-<span class="sd">                          feature and disables the subdomain one.  If</span>
-<span class="sd">                          enabled the `host` parameter to rules is used</span>
-<span class="sd">                          instead of the `subdomain` one.</span>
-
-<span class="sd">    .. versionadded:: 0.5</span>
-<span class="sd">        `sort_parameters` and `sort_key` was added.</span>
-
-<span class="sd">    .. versionadded:: 0.7</span>
-<span class="sd">        `encoding_errors` and `host_matching` was added.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="c1">#: .. versionadded:: 0.6</span>
-    <span class="c1">#:    a dict of default converters to be used.</span>
-    <span class="n">default_converters</span> <span class="o">=</span> <span class="n">ImmutableDict</span><span class="p">(</span><span class="n">DEFAULT_CONVERTERS</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rules</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">default_subdomain</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">charset</span><span class="o">=</span><span class="s1">&#39;utf-8&#39;</span><span class="p">,</span>
-                 <span class="n">strict_slashes</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">redirect_defaults</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
-                 <span class="n">converters</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">sort_parameters</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">sort_key</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">encoding_errors</span><span class="o">=</span><span class="s1">&#39;replace&#39;</span><span class="p">,</span> <span class="n">host_matching</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_rules</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_rules_by_endpoint</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_remap</span> <span class="o">=</span> <span class="kc">True</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_remap_lock</span> <span class="o">=</span> <span class="n">Lock</span><span class="p">()</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">default_subdomain</span> <span class="o">=</span> <span class="n">default_subdomain</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">charset</span> <span class="o">=</span> <span class="n">charset</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">encoding_errors</span> <span class="o">=</span> <span class="n">encoding_errors</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">strict_slashes</span> <span class="o">=</span> <span class="n">strict_slashes</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">redirect_defaults</span> <span class="o">=</span> <span class="n">redirect_defaults</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">host_matching</span> <span class="o">=</span> <span class="n">host_matching</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">converters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_converters</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">converters</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">converters</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">converters</span><span class="p">)</span>
-
-        <span class="bp">self</span><span class="o">.</span><span class="n">sort_parameters</span> <span class="o">=</span> <span class="n">sort_parameters</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">sort_key</span> <span class="o">=</span> <span class="n">sort_key</span>
-
-        <span class="k">for</span> <span class="n">rulefactory</span> <span class="ow">in</span> <span class="n">rules</span> <span class="ow">or</span> <span class="p">():</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">rulefactory</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">is_endpoint_expecting</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="o">*</span><span class="n">arguments</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Iterate over all rules and check if the endpoint expects</span>
-<span class="sd">        the arguments provided.  This is for example useful if you have</span>
-<span class="sd">        some URLs that expect a language code and others that do not and</span>
-<span class="sd">        you want to wrap the builder a bit so that the current language</span>
-<span class="sd">        code is automatically added if not provided but endpoints expect</span>
-<span class="sd">        it.</span>
-
-<span class="sd">        :param endpoint: the endpoint to check.</span>
-<span class="sd">        :param arguments: this function accepts one or more arguments</span>
-<span class="sd">                          as positional arguments.  Each one of them is</span>
-<span class="sd">                          checked.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">()</span>
-        <span class="n">arguments</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">arguments</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_rules_by_endpoint</span><span class="p">[</span><span class="n">endpoint</span><span class="p">]:</span>
-            <span class="k">if</span> <span class="n">arguments</span><span class="o">.</span><span class="n">issubset</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">arguments</span><span class="p">):</span>
-                <span class="k">return</span> <span class="kc">True</span>
-        <span class="k">return</span> <span class="kc">False</span>
-
-    <span class="k">def</span> <span class="nf">iter_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Iterate over all rules or the rules of an endpoint.</span>
-
-<span class="sd">        :param endpoint: if provided only the rules for that endpoint</span>
-<span class="sd">                         are returned.</span>
-<span class="sd">        :return: an iterator</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">endpoint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_rules_by_endpoint</span><span class="p">[</span><span class="n">endpoint</span><span class="p">])</span>
-        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_rules</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rulefactory</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Add a new rule or factory to the map and bind it.  Requires that the</span>
-<span class="sd">        rule is not bound to another map.</span>
-
-<span class="sd">        :param rulefactory: a :class:`Rule` or :class:`RuleFactory`</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="n">rulefactory</span><span class="o">.</span><span class="n">get_rules</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-            <span class="n">rule</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_rules</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">rule</span><span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_rules_by_endpoint</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">rule</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_remap</span> <span class="o">=</span> <span class="kc">True</span>
-
-    <span class="k">def</span> <span class="nf">bind</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">server_name</span><span class="p">,</span> <span class="n">script_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">subdomain</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-             <span class="n">url_scheme</span><span class="o">=</span><span class="s1">&#39;http&#39;</span><span class="p">,</span> <span class="n">default_method</span><span class="o">=</span><span class="s1">&#39;GET&#39;</span><span class="p">,</span> <span class="n">path_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-             <span class="n">query_args</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Return a new :class:`MapAdapter` with the details specified to the</span>
-<span class="sd">        call.  Note that `script_name` will default to ``&#39;/&#39;`` if not further</span>
-<span class="sd">        specified or `None`.  The `server_name` at least is a requirement</span>
-<span class="sd">        because the HTTP RFC requires absolute URLs for redirects and so all</span>
-<span class="sd">        redirect exceptions raised by Werkzeug will contain the full canonical</span>
-<span class="sd">        URL.</span>
-
-<span class="sd">        If no path_info is passed to :meth:`match` it will use the default path</span>
-<span class="sd">        info passed to bind.  While this doesn&#39;t really make sense for</span>
-<span class="sd">        manual bind calls, it&#39;s useful if you bind a map to a WSGI</span>
-<span class="sd">        environment which already contains the path info.</span>
-
-<span class="sd">        `subdomain` will default to the `default_subdomain` for this map if</span>
-<span class="sd">        no defined. If there is no `default_subdomain` you cannot use the</span>
-<span class="sd">        subdomain feature.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">           `query_args` added</span>
-
-<span class="sd">        .. versionadded:: 0.8</span>
-<span class="sd">           `query_args` can now also be a string.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">server_name</span> <span class="o">=</span> <span class="n">server_name</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">host_matching</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">subdomain</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s1">&#39;host matching enabled and a &#39;</span>
-                                   <span class="s1">&#39;subdomain was provided&#39;</span><span class="p">)</span>
-        <span class="k">elif</span> <span class="n">subdomain</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">subdomain</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_subdomain</span>
-        <span class="k">if</span> <span class="n">script_name</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">script_name</span> <span class="o">=</span> <span class="s1">&#39;/&#39;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="n">server_name</span> <span class="o">=</span> <span class="n">_encode_idna</span><span class="p">(</span><span class="n">server_name</span><span class="p">)</span>
-        <span class="k">except</span> <span class="ne">UnicodeError</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">BadHost</span><span class="p">()</span>
-        <span class="k">return</span> <span class="n">MapAdapter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">server_name</span><span class="p">,</span> <span class="n">script_name</span><span class="p">,</span> <span class="n">subdomain</span><span class="p">,</span>
-                          <span class="n">url_scheme</span><span class="p">,</span> <span class="n">path_info</span><span class="p">,</span> <span class="n">default_method</span><span class="p">,</span> <span class="n">query_args</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">bind_to_environ</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ</span><span class="p">,</span> <span class="n">server_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">subdomain</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Like :meth:`bind` but you can pass it an WSGI environment and it</span>
-<span class="sd">        will fetch the information from that dictionary.  Note that because of</span>
-<span class="sd">        limitations in the protocol there is no way to get the current</span>
-<span class="sd">        subdomain and real `server_name` from the environment.  If you don&#39;t</span>
-<span class="sd">        provide it, Werkzeug will use `SERVER_NAME` and `SERVER_PORT` (or</span>
-<span class="sd">        `HTTP_HOST` if provided) as used `server_name` with disabled subdomain</span>
-<span class="sd">        feature.</span>
-
-<span class="sd">        If `subdomain` is `None` but an environment and a server name is</span>
-<span class="sd">        provided it will calculate the current subdomain automatically.</span>
-<span class="sd">        Example: `server_name` is ``&#39;example.com&#39;`` and the `SERVER_NAME`</span>
-<span class="sd">        in the wsgi `environ` is ``&#39;staging.dev.example.com&#39;`` the calculated</span>
-<span class="sd">        subdomain will be ``&#39;staging.dev&#39;``.</span>
-
-<span class="sd">        If the object passed as environ has an environ attribute, the value of</span>
-<span class="sd">        this attribute is used instead.  This allows you to pass request</span>
-<span class="sd">        objects.  Additionally `PATH_INFO` added as a default of the</span>
-<span class="sd">        :class:`MapAdapter` so that you don&#39;t have to pass the path info to</span>
-<span class="sd">        the match method.</span>
-
-<span class="sd">        .. versionchanged:: 0.5</span>
-<span class="sd">            previously this method accepted a bogus `calculate_subdomain`</span>
-<span class="sd">            parameter that did not have any effect.  It was removed because</span>
-<span class="sd">            of that.</span>
-
-<span class="sd">        .. versionchanged:: 0.8</span>
-<span class="sd">           This will no longer raise a ValueError when an unexpected server</span>
-<span class="sd">           name was passed.</span>
-
-<span class="sd">        :param environ: a WSGI environment.</span>
-<span class="sd">        :param server_name: an optional server name hint (see above).</span>
-<span class="sd">        :param subdomain: optionally the current subdomain (see above).</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">environ</span> <span class="o">=</span> <span class="n">_get_environ</span><span class="p">(</span><span class="n">environ</span><span class="p">)</span>
-
-        <span class="k">if</span> <span class="s1">&#39;HTTP_HOST&#39;</span> <span class="ow">in</span> <span class="n">environ</span><span class="p">:</span>
-            <span class="n">wsgi_server_name</span> <span class="o">=</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;HTTP_HOST&#39;</span><span class="p">]</span>
-
-            <span class="k">if</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;wsgi.url_scheme&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;http&#39;</span> \
-                    <span class="ow">and</span> <span class="n">wsgi_server_name</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">&#39;:80&#39;</span><span class="p">):</span>
-                <span class="n">wsgi_server_name</span> <span class="o">=</span> <span class="n">wsgi_server_name</span><span class="p">[:</span><span class="o">-</span><span class="mi">3</span><span class="p">]</span>
-            <span class="k">elif</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;wsgi.url_scheme&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;https&#39;</span> \
-                    <span class="ow">and</span> <span class="n">wsgi_server_name</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">&#39;:443&#39;</span><span class="p">):</span>
-                <span class="n">wsgi_server_name</span> <span class="o">=</span> <span class="n">wsgi_server_name</span><span class="p">[:</span><span class="o">-</span><span class="mi">4</span><span class="p">]</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">wsgi_server_name</span> <span class="o">=</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;SERVER_NAME&#39;</span><span class="p">]</span>
-
-            <span class="k">if</span> <span class="p">(</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;wsgi.url_scheme&#39;</span><span class="p">],</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;SERVER_PORT&#39;</span><span class="p">])</span> <span class="ow">not</span> \
-               <span class="ow">in</span> <span class="p">((</span><span class="s1">&#39;https&#39;</span><span class="p">,</span> <span class="s1">&#39;443&#39;</span><span class="p">),</span> <span class="p">(</span><span class="s1">&#39;http&#39;</span><span class="p">,</span> <span class="s1">&#39;80&#39;</span><span class="p">)):</span>
-                <span class="n">wsgi_server_name</span> <span class="o">+=</span> <span class="s1">&#39;:&#39;</span> <span class="o">+</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;SERVER_PORT&#39;</span><span class="p">]</span>
-
-        <span class="n">wsgi_server_name</span> <span class="o">=</span> <span class="n">wsgi_server_name</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-
-        <span class="k">if</span> <span class="n">server_name</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">server_name</span> <span class="o">=</span> <span class="n">wsgi_server_name</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">server_name</span> <span class="o">=</span> <span class="n">server_name</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-
-        <span class="k">if</span> <span class="n">subdomain</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">host_matching</span><span class="p">:</span>
-            <span class="n">cur_server_name</span> <span class="o">=</span> <span class="n">wsgi_server_name</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">)</span>
-            <span class="n">real_server_name</span> <span class="o">=</span> <span class="n">server_name</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">)</span>
-            <span class="n">offset</span> <span class="o">=</span> <span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="n">real_server_name</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">cur_server_name</span><span class="p">[</span><span class="n">offset</span><span class="p">:]</span> <span class="o">!=</span> <span class="n">real_server_name</span><span class="p">:</span>
-                <span class="c1"># This can happen even with valid configs if the server was</span>
-                <span class="c1"># accesssed directly by IP address under some situations.</span>
-                <span class="c1"># Instead of raising an exception like in Werkzeug 0.7 or</span>
-                <span class="c1"># earlier we go by an invalid subdomain which will result</span>
-                <span class="c1"># in a 404 error on matching.</span>
-                <span class="n">subdomain</span> <span class="o">=</span> <span class="s1">&#39;&lt;invalid&gt;&#39;</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">subdomain</span> <span class="o">=</span> <span class="s1">&#39;.&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">filter</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">cur_server_name</span><span class="p">[:</span><span class="n">offset</span><span class="p">]))</span>
-
-        <span class="k">def</span> <span class="nf">_get_wsgi_string</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>
-            <span class="n">val</span> <span class="o">=</span> <span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">val</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">wsgi_decoding_dance</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">charset</span><span class="p">)</span>
-
-        <span class="n">script_name</span> <span class="o">=</span> <span class="n">_get_wsgi_string</span><span class="p">(</span><span class="s1">&#39;SCRIPT_NAME&#39;</span><span class="p">)</span>
-        <span class="n">path_info</span> <span class="o">=</span> <span class="n">_get_wsgi_string</span><span class="p">(</span><span class="s1">&#39;PATH_INFO&#39;</span><span class="p">)</span>
-        <span class="n">query_args</span> <span class="o">=</span> <span class="n">_get_wsgi_string</span><span class="p">(</span><span class="s1">&#39;QUERY_STRING&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">Map</span><span class="o">.</span><span class="n">bind</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">server_name</span><span class="p">,</span> <span class="n">script_name</span><span class="p">,</span>
-                        <span class="n">subdomain</span><span class="p">,</span> <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;wsgi.url_scheme&#39;</span><span class="p">],</span>
-                        <span class="n">environ</span><span class="p">[</span><span class="s1">&#39;REQUEST_METHOD&#39;</span><span class="p">],</span> <span class="n">path_info</span><span class="p">,</span>
-                        <span class="n">query_args</span><span class="o">=</span><span class="n">query_args</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Called before matching and building to keep the compiled rules</span>
-<span class="sd">        in the correct order after things changed.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_remap</span><span class="p">:</span>
-            <span class="k">return</span>
-
-        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">_remap_lock</span><span class="p">:</span>
-            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_remap</span><span class="p">:</span>
-                <span class="k">return</span>
-
-            <span class="bp">self</span><span class="o">.</span><span class="n">_rules</span><span class="o">.</span><span class="n">sort</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">match_compare_key</span><span class="p">())</span>
-            <span class="k">for</span> <span class="n">rules</span> <span class="ow">in</span> <span class="n">itervalues</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_rules_by_endpoint</span><span class="p">):</span>
-                <span class="n">rules</span><span class="o">.</span><span class="n">sort</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">build_compare_key</span><span class="p">())</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_remap</span> <span class="o">=</span> <span class="kc">False</span>
-
-    <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">rules</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">iter_rules</span><span class="p">()</span>
-        <span class="k">return</span> <span class="s1">&#39;</span><span class="si">%s</span><span class="s1">(</span><span class="si">%s</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="n">pformat</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">rules</span><span class="p">)))</span>
-
-
-<span class="k">class</span> <span class="nc">MapAdapter</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-
-    <span class="sd">&quot;&quot;&quot;Returned by :meth:`Map.bind` or :meth:`Map.bind_to_environ` and does</span>
-<span class="sd">    the URL matching and building based on runtime information.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">map</span><span class="p">,</span> <span class="n">server_name</span><span class="p">,</span> <span class="n">script_name</span><span class="p">,</span> <span class="n">subdomain</span><span class="p">,</span>
-                 <span class="n">url_scheme</span><span class="p">,</span> <span class="n">path_info</span><span class="p">,</span> <span class="n">default_method</span><span class="p">,</span> <span class="n">query_args</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">=</span> <span class="nb">map</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">server_name</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">server_name</span><span class="p">)</span>
-        <span class="n">script_name</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">script_name</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">script_name</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">u&#39;/&#39;</span><span class="p">):</span>
-            <span class="n">script_name</span> <span class="o">+=</span> <span class="s1">u&#39;/&#39;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">script_name</span> <span class="o">=</span> <span class="n">script_name</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">subdomain</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">url_scheme</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">url_scheme</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">path_info</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">path_info</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">default_method</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">default_method</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">query_args</span> <span class="o">=</span> <span class="n">query_args</span>
-
-    <span class="k">def</span> <span class="nf">dispatch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">view_func</span><span class="p">,</span> <span class="n">path_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-                 <span class="n">catch_http_exceptions</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Does the complete dispatching process.  `view_func` is called with</span>
-<span class="sd">        the endpoint and a dict with the values for the view.  It should</span>
-<span class="sd">        look up the view function, call it, and return a response object</span>
-<span class="sd">        or WSGI application.  http exceptions are not caught by default</span>
-<span class="sd">        so that applications can display nicer error messages by just</span>
-<span class="sd">        catching them by hand.  If you want to stick with the default</span>
-<span class="sd">        error messages you can pass it ``catch_http_exceptions=True`` and</span>
-<span class="sd">        it will catch the http exceptions.</span>
-
-<span class="sd">        Here a small example for the dispatch usage::</span>
-
-<span class="sd">            from werkzeug.wrappers import Request, Response</span>
-<span class="sd">            from werkzeug.wsgi import responder</span>
-<span class="sd">            from werkzeug.routing import Map, Rule</span>
-
-<span class="sd">            def on_index(request):</span>
-<span class="sd">                return Response(&#39;Hello from the index&#39;)</span>
-
-<span class="sd">            url_map = Map([Rule(&#39;/&#39;, endpoint=&#39;index&#39;)])</span>
-<span class="sd">            views = {&#39;index&#39;: on_index}</span>
-
-<span class="sd">            @responder</span>
-<span class="sd">            def application(environ, start_response):</span>
-<span class="sd">                request = Request(environ)</span>
-<span class="sd">                urls = url_map.bind_to_environ(environ)</span>
-<span class="sd">                return urls.dispatch(lambda e, v: views[e](request, **v),</span>
-<span class="sd">                                     catch_http_exceptions=True)</span>
-
-<span class="sd">        Keep in mind that this method might return exception objects, too, so</span>
-<span class="sd">        use :class:`Response.force_type` to get a response object.</span>
-
-<span class="sd">        :param view_func: a function that is called with the endpoint as</span>
-<span class="sd">                          first argument and the value dict as second.  Has</span>
-<span class="sd">                          to dispatch to the actual view function with this</span>
-<span class="sd">                          information.  (see above)</span>
-<span class="sd">        :param path_info: the path info to use for matching.  Overrides the</span>
-<span class="sd">                          path info specified on binding.</span>
-<span class="sd">        :param method: the HTTP method used for matching.  Overrides the</span>
-<span class="sd">                       method specified on binding.</span>
-<span class="sd">        :param catch_http_exceptions: set to `True` to catch any of the</span>
-<span class="sd">                                      werkzeug :class:`HTTPException`\s.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">endpoint</span><span class="p">,</span> <span class="n">args</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">path_info</span><span class="p">,</span> <span class="n">method</span><span class="p">)</span>
-            <span class="k">except</span> <span class="n">RequestRedirect</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">e</span>
-            <span class="k">return</span> <span class="n">view_func</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">args</span><span class="p">)</span>
-        <span class="k">except</span> <span class="n">HTTPException</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">catch_http_exceptions</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">e</span>
-            <span class="k">raise</span>
-
-    <span class="k">def</span> <span class="nf">match</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">return_rule</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-              <span class="n">query_args</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;The usage is simple: you just pass the match method the current</span>
-<span class="sd">        path info as well as the method (which defaults to `GET`).  The</span>
-<span class="sd">        following things can then happen:</span>
-
-<span class="sd">        - you receive a `NotFound` exception that indicates that no URL is</span>
-<span class="sd">          matching.  A `NotFound` exception is also a WSGI application you</span>
-<span class="sd">          can call to get a default page not found page (happens to be the</span>
-<span class="sd">          same object as `werkzeug.exceptions.NotFound`)</span>
-
-<span class="sd">        - you receive a `MethodNotAllowed` exception that indicates that there</span>
-<span class="sd">          is a match for this URL but not for the current request method.</span>
-<span class="sd">          This is useful for RESTful applications.</span>
-
-<span class="sd">        - you receive a `RequestRedirect` exception with a `new_url`</span>
-<span class="sd">          attribute.  This exception is used to notify you about a request</span>
-<span class="sd">          Werkzeug requests from your WSGI application.  This is for example the</span>
-<span class="sd">          case if you request ``/foo`` although the correct URL is ``/foo/``</span>
-<span class="sd">          You can use the `RequestRedirect` instance as response-like object</span>
-<span class="sd">          similar to all other subclasses of `HTTPException`.</span>
-
-<span class="sd">        - you get a tuple in the form ``(endpoint, arguments)`` if there is</span>
-<span class="sd">          a match (unless `return_rule` is True, in which case you get a tuple</span>
-<span class="sd">          in the form ``(rule, arguments)``)</span>
-
-<span class="sd">        If the path info is not passed to the match method the default path</span>
-<span class="sd">        info of the map is used (defaults to the root URL if not defined</span>
-<span class="sd">        explicitly).</span>
-
-<span class="sd">        All of the exceptions raised are subclasses of `HTTPException` so they</span>
-<span class="sd">        can be used as WSGI responses.  The will all render generic error or</span>
-<span class="sd">        redirect pages.</span>
-
-<span class="sd">        Here is a small example for matching:</span>
-
-<span class="sd">        &gt;&gt;&gt; m = Map([</span>
-<span class="sd">        ...     Rule(&#39;/&#39;, endpoint=&#39;index&#39;),</span>
-<span class="sd">        ...     Rule(&#39;/downloads/&#39;, endpoint=&#39;downloads/index&#39;),</span>
-<span class="sd">        ...     Rule(&#39;/downloads/&lt;int:id&gt;&#39;, endpoint=&#39;downloads/show&#39;)</span>
-<span class="sd">        ... ])</span>
-<span class="sd">        &gt;&gt;&gt; urls = m.bind(&quot;example.com&quot;, &quot;/&quot;)</span>
-<span class="sd">        &gt;&gt;&gt; urls.match(&quot;/&quot;, &quot;GET&quot;)</span>
-<span class="sd">        (&#39;index&#39;, {})</span>
-<span class="sd">        &gt;&gt;&gt; urls.match(&quot;/downloads/42&quot;)</span>
-<span class="sd">        (&#39;downloads/show&#39;, {&#39;id&#39;: 42})</span>
-
-<span class="sd">        And here is what happens on redirect and missing URLs:</span>
-
-<span class="sd">        &gt;&gt;&gt; urls.match(&quot;/downloads&quot;)</span>
-<span class="sd">        Traceback (most recent call last):</span>
-<span class="sd">          ...</span>
-<span class="sd">        RequestRedirect: http://example.com/downloads/</span>
-<span class="sd">        &gt;&gt;&gt; urls.match(&quot;/missing&quot;)</span>
-<span class="sd">        Traceback (most recent call last):</span>
-<span class="sd">          ...</span>
-<span class="sd">        NotFound: 404 Not Found</span>
-
-<span class="sd">        :param path_info: the path info to use for matching.  Overrides the</span>
-<span class="sd">                          path info specified on binding.</span>
-<span class="sd">        :param method: the HTTP method used for matching.  Overrides the</span>
-<span class="sd">                       method specified on binding.</span>
-<span class="sd">        :param return_rule: return the rule that matched instead of just the</span>
-<span class="sd">                            endpoint (defaults to `False`).</span>
-<span class="sd">        :param query_args: optional query arguments that are used for</span>
-<span class="sd">                           automatic redirects as string or dictionary.  It&#39;s</span>
-<span class="sd">                           currently not possible to use the query arguments</span>
-<span class="sd">                           for URL matching.</span>
-
-<span class="sd">        .. versionadded:: 0.6</span>
-<span class="sd">           `return_rule` was added.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">           `query_args` was added.</span>
-
-<span class="sd">        .. versionchanged:: 0.8</span>
-<span class="sd">           `query_args` can now also be a string.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">update</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">path_info</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">path_info</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">path_info</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">path_info</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">path_info</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">charset</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">query_args</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">query_args</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">query_args</span>
-        <span class="n">method</span> <span class="o">=</span> <span class="p">(</span><span class="n">method</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_method</span><span class="p">)</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span>
-
-        <span class="n">path</span> <span class="o">=</span> <span class="s1">u&#39;</span><span class="si">%s</span><span class="s1">|</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">host_matching</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">server_name</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span><span class="p">,</span>
-            <span class="n">path_info</span> <span class="ow">and</span> <span class="s1">&#39;/</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">path_info</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-        <span class="p">)</span>
-
-        <span class="n">have_match_for</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">_rules</span><span class="p">:</span>
-            <span class="k">try</span><span class="p">:</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">path</span><span class="p">)</span>
-            <span class="k">except</span> <span class="n">RequestSlash</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="n">RequestRedirect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">make_redirect_url</span><span class="p">(</span>
-                    <span class="n">url_quote</span><span class="p">(</span><span class="n">path_info</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">charset</span><span class="p">,</span>
-                              <span class="n">safe</span><span class="o">=</span><span class="s1">&#39;/:|+&#39;</span><span class="p">)</span> <span class="o">+</span> <span class="s1">&#39;/&#39;</span><span class="p">,</span> <span class="n">query_args</span><span class="p">))</span>
-            <span class="k">except</span> <span class="n">RequestAliasRedirect</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="n">RequestRedirect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">make_alias_redirect_url</span><span class="p">(</span>
-                    <span class="n">path</span><span class="p">,</span> <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">e</span><span class="o">.</span><span class="n">matched_values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">query_args</span><span class="p">))</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">continue</span>
-            <span class="k">if</span> <span class="n">rule</span><span class="o">.</span><span class="n">methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">method</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">rule</span><span class="o">.</span><span class="n">methods</span><span class="p">:</span>
-                <span class="n">have_match_for</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">methods</span><span class="p">)</span>
-                <span class="k">continue</span>
-
-            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">redirect_defaults</span><span class="p">:</span>
-                <span class="n">redirect_url</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_default_redirect</span><span class="p">(</span><span class="n">rule</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">rv</span><span class="p">,</span>
-                                                         <span class="n">query_args</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">redirect_url</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="k">raise</span> <span class="n">RequestRedirect</span><span class="p">(</span><span class="n">redirect_url</span><span class="p">)</span>
-
-            <span class="k">if</span> <span class="n">rule</span><span class="o">.</span><span class="n">redirect_to</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rule</span><span class="o">.</span><span class="n">redirect_to</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-                    <span class="k">def</span> <span class="nf">_handle_match</span><span class="p">(</span><span class="n">match</span><span class="p">):</span>
-                        <span class="n">value</span> <span class="o">=</span> <span class="n">rv</span><span class="p">[</span><span class="n">match</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="mi">1</span><span class="p">)]</span>
-                        <span class="k">return</span> <span class="n">rule</span><span class="o">.</span><span class="n">_converters</span><span class="p">[</span><span class="n">match</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="mi">1</span><span class="p">)]</span><span class="o">.</span><span class="n">to_url</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-                    <span class="n">redirect_url</span> <span class="o">=</span> <span class="n">_simple_rule_re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="n">_handle_match</span><span class="p">,</span>
-                                                       <span class="n">rule</span><span class="o">.</span><span class="n">redirect_to</span><span class="p">)</span>
-                <span class="k">else</span><span class="p">:</span>
-                    <span class="n">redirect_url</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">redirect_to</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">rv</span><span class="p">)</span>
-                <span class="k">raise</span> <span class="n">RequestRedirect</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">url_join</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">://</span><span class="si">%s%s%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">url_scheme</span> <span class="ow">or</span> <span class="s1">&#39;http&#39;</span><span class="p">,</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span> <span class="o">+</span> <span class="s1">&#39;.&#39;</span> <span class="ow">or</span> <span class="s1">&#39;&#39;</span><span class="p">,</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">server_name</span><span class="p">,</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">script_name</span>
-                <span class="p">),</span> <span class="n">redirect_url</span><span class="p">)))</span>
-
-            <span class="k">if</span> <span class="n">return_rule</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">rule</span><span class="p">,</span> <span class="n">rv</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">rv</span>
-
-        <span class="k">if</span> <span class="n">have_match_for</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">MethodNotAllowed</span><span class="p">(</span><span class="n">valid_methods</span><span class="o">=</span><span class="nb">list</span><span class="p">(</span><span class="n">have_match_for</span><span class="p">))</span>
-        <span class="k">raise</span> <span class="n">NotFound</span><span class="p">()</span>
-
-    <span class="k">def</span> <span class="nf">test</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Test if a rule would match.  Works like `match` but returns `True`</span>
-<span class="sd">        if the URL matches, or `False` if it does not exist.</span>
-
-<span class="sd">        :param path_info: the path info to use for matching.  Overrides the</span>
-<span class="sd">                          path info specified on binding.</span>
-<span class="sd">        :param method: the HTTP method used for matching.  Overrides the</span>
-<span class="sd">                       method specified on binding.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">path_info</span><span class="p">,</span> <span class="n">method</span><span class="p">)</span>
-        <span class="k">except</span> <span class="n">RequestRedirect</span><span class="p">:</span>
-            <span class="k">pass</span>
-        <span class="k">except</span> <span class="n">HTTPException</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-        <span class="k">return</span> <span class="kc">True</span>
-
-    <span class="k">def</span> <span class="nf">allowed_methods</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path_info</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Returns the valid methods that match for a given path.</span>
-
-<span class="sd">        .. versionadded:: 0.7</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">path_info</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s1">&#39;--&#39;</span><span class="p">)</span>
-        <span class="k">except</span> <span class="n">MethodNotAllowed</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">e</span><span class="o">.</span><span class="n">valid_methods</span>
-        <span class="k">except</span> <span class="n">HTTPException</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-            <span class="k">pass</span>
-        <span class="k">return</span> <span class="p">[]</span>
-
-    <span class="k">def</span> <span class="nf">get_host</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">domain_part</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Figures out the full host name for the given domain part.  The</span>
-<span class="sd">        domain part is a subdomain in case host matching is disabled or</span>
-<span class="sd">        a full host name.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">host_matching</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">domain_part</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">server_name</span>
-            <span class="k">return</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">domain_part</span><span class="p">,</span> <span class="s1">&#39;ascii&#39;</span><span class="p">)</span>
-        <span class="n">subdomain</span> <span class="o">=</span> <span class="n">domain_part</span>
-        <span class="k">if</span> <span class="n">subdomain</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">subdomain</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">subdomain</span> <span class="o">=</span> <span class="n">to_unicode</span><span class="p">(</span><span class="n">subdomain</span><span class="p">,</span> <span class="s1">&#39;ascii&#39;</span><span class="p">)</span>
-        <span class="k">return</span> <span class="p">(</span><span class="n">subdomain</span> <span class="ow">and</span> <span class="n">subdomain</span> <span class="o">+</span> <span class="s1">u&#39;.&#39;</span> <span class="ow">or</span> <span class="s1">u&#39;&#39;</span><span class="p">)</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">server_name</span>
-
-    <span class="k">def</span> <span class="nf">get_default_redirect</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">rule</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">query_args</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;A helper that returns the URL to redirect to if it finds one.</span>
-<span class="sd">        This is used for default redirecting only.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">redirect_defaults</span>
-        <span class="k">for</span> <span class="n">r</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">_rules_by_endpoint</span><span class="p">[</span><span class="n">rule</span><span class="o">.</span><span class="n">endpoint</span><span class="p">]:</span>
-            <span class="c1"># every rule that comes after this one, including ourself</span>
-            <span class="c1"># has a lower priority for the defaults.  We order the ones</span>
-            <span class="c1"># with the highest priority up for building.</span>
-            <span class="k">if</span> <span class="n">r</span> <span class="ow">is</span> <span class="n">rule</span><span class="p">:</span>
-                <span class="k">break</span>
-            <span class="k">if</span> <span class="n">r</span><span class="o">.</span><span class="n">provides_defaults_for</span><span class="p">(</span><span class="n">rule</span><span class="p">)</span> <span class="ow">and</span> \
-               <span class="n">r</span><span class="o">.</span><span class="n">suitable_for</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
-                <span class="n">values</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">r</span><span class="o">.</span><span class="n">defaults</span><span class="p">)</span>
-                <span class="n">domain_part</span><span class="p">,</span> <span class="n">path</span> <span class="o">=</span> <span class="n">r</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_redirect_url</span><span class="p">(</span>
-                    <span class="n">path</span><span class="p">,</span> <span class="n">query_args</span><span class="p">,</span> <span class="n">domain_part</span><span class="o">=</span><span class="n">domain_part</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">encode_query_args</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_args</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_args</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-            <span class="n">query_args</span> <span class="o">=</span> <span class="n">url_encode</span><span class="p">(</span><span class="n">query_args</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">charset</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">query_args</span>
-
-    <span class="k">def</span> <span class="nf">make_redirect_url</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path_info</span><span class="p">,</span> <span class="n">query_args</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">domain_part</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Creates a redirect URL.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">suffix</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span>
-        <span class="k">if</span> <span class="n">query_args</span><span class="p">:</span>
-            <span class="n">suffix</span> <span class="o">=</span> <span class="s1">&#39;?&#39;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">encode_query_args</span><span class="p">(</span><span class="n">query_args</span><span class="p">)</span>
-        <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">://</span><span class="si">%s</span><span class="s1">/</span><span class="si">%s%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">url_scheme</span> <span class="ow">or</span> <span class="s1">&#39;http&#39;</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">get_host</span><span class="p">(</span><span class="n">domain_part</span><span class="p">),</span>
-            <span class="n">posixpath</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">script_name</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">),</span>
-                           <span class="n">path_info</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)),</span>
-            <span class="n">suffix</span>
-        <span class="p">))</span>
-
-    <span class="k">def</span> <span class="nf">make_alias_redirect_url</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">query_args</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Internally called to make an alias redirect URL.&quot;&quot;&quot;</span>
-        <span class="n">url</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">append_unknown</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-                         <span class="n">force_external</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">query_args</span><span class="p">:</span>
-            <span class="n">url</span> <span class="o">+=</span> <span class="s1">&#39;?&#39;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">encode_query_args</span><span class="p">(</span><span class="n">query_args</span><span class="p">)</span>
-        <span class="k">assert</span> <span class="n">url</span> <span class="o">!=</span> <span class="n">path</span><span class="p">,</span> <span class="s1">&#39;detected invalid alias setting.  No canonical &#39;</span> \
-            <span class="s1">&#39;URL found&#39;</span>
-        <span class="k">return</span> <span class="n">url</span>
-
-    <span class="k">def</span> <span class="nf">_partial_build</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">append_unknown</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Helper for :meth:`build`.  Returns subdomain and path for the</span>
-<span class="sd">        rule that accepts this endpoint, values and method.</span>
-
-<span class="sd">        :internal:</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="c1"># in case the method is none, try with the default method first</span>
-        <span class="k">if</span> <span class="n">method</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_partial_build</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_method</span><span class="p">,</span>
-                                     <span class="n">append_unknown</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">return</span> <span class="n">rv</span>
-
-        <span class="c1"># default method did not match or a specific method is passed,</span>
-        <span class="c1"># check all and go with first result.</span>
-        <span class="k">for</span> <span class="n">rule</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">_rules_by_endpoint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="p">()):</span>
-            <span class="k">if</span> <span class="n">rule</span><span class="o">.</span><span class="n">suitable_for</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
-                <span class="n">rv</span> <span class="o">=</span> <span class="n">rule</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">append_unknown</span><span class="p">)</span>
-                <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="k">return</span> <span class="n">rv</span>
-
-    <span class="k">def</span> <span class="nf">build</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">force_external</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-              <span class="n">append_unknown</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Building URLs works pretty much the other way round.  Instead of</span>
-<span class="sd">        `match` you call `build` and pass it the endpoint and a dict of</span>
-<span class="sd">        arguments for the placeholders.</span>
-
-<span class="sd">        The `build` function also accepts an argument called `force_external`</span>
-<span class="sd">        which, if you set it to `True` will force external URLs. Per default</span>
-<span class="sd">        external URLs (include the server name) will only be used if the</span>
-<span class="sd">        target URL is on a different subdomain.</span>
-
-<span class="sd">        &gt;&gt;&gt; m = Map([</span>
-<span class="sd">        ...     Rule(&#39;/&#39;, endpoint=&#39;index&#39;),</span>
-<span class="sd">        ...     Rule(&#39;/downloads/&#39;, endpoint=&#39;downloads/index&#39;),</span>
-<span class="sd">        ...     Rule(&#39;/downloads/&lt;int:id&gt;&#39;, endpoint=&#39;downloads/show&#39;)</span>
-<span class="sd">        ... ])</span>
-<span class="sd">        &gt;&gt;&gt; urls = m.bind(&quot;example.com&quot;, &quot;/&quot;)</span>
-<span class="sd">        &gt;&gt;&gt; urls.build(&quot;index&quot;, {})</span>
-<span class="sd">        &#39;/&#39;</span>
-<span class="sd">        &gt;&gt;&gt; urls.build(&quot;downloads/show&quot;, {&#39;id&#39;: 42})</span>
-<span class="sd">        &#39;/downloads/42&#39;</span>
-<span class="sd">        &gt;&gt;&gt; urls.build(&quot;downloads/show&quot;, {&#39;id&#39;: 42}, force_external=True)</span>
-<span class="sd">        &#39;http://example.com/downloads/42&#39;</span>
-
-<span class="sd">        Because URLs cannot contain non ASCII data you will always get</span>
-<span class="sd">        bytestrings back.  Non ASCII characters are urlencoded with the</span>
-<span class="sd">        charset defined on the map instance.</span>
-
-<span class="sd">        Additional values are converted to unicode and appended to the URL as</span>
-<span class="sd">        URL querystring parameters:</span>
-
-<span class="sd">        &gt;&gt;&gt; urls.build(&quot;index&quot;, {&#39;q&#39;: &#39;My Searchstring&#39;})</span>
-<span class="sd">        &#39;/?q=My+Searchstring&#39;</span>
-
-<span class="sd">        When processing those additional values, lists are furthermore</span>
-<span class="sd">        interpreted as multiple values (as per</span>
-<span class="sd">        :py:class:`werkzeug.datastructures.MultiDict`):</span>
-
-<span class="sd">        &gt;&gt;&gt; urls.build(&quot;index&quot;, {&#39;q&#39;: [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;]})</span>
-<span class="sd">        &#39;/?q=a&amp;q=b&amp;q=c&#39;</span>
-
-<span class="sd">        If a rule does not exist when building a `BuildError` exception is</span>
-<span class="sd">        raised.</span>
-
-<span class="sd">        The build method accepts an argument called `method` which allows you</span>
-<span class="sd">        to specify the method you want to have an URL built for if you have</span>
-<span class="sd">        different methods for the same endpoint specified.</span>
-
-<span class="sd">        .. versionadded:: 0.6</span>
-<span class="sd">           the `append_unknown` parameter was added.</span>
-
-<span class="sd">        :param endpoint: the endpoint of the URL to build.</span>
-<span class="sd">        :param values: the values for the URL to build.  Unhandled values are</span>
-<span class="sd">                       appended to the URL as query parameters.</span>
-<span class="sd">        :param method: the HTTP method for the rule if there are different</span>
-<span class="sd">                       URLs for different methods on the same endpoint.</span>
-<span class="sd">        :param force_external: enforce full canonical external URLs. If the URL</span>
-<span class="sd">                               scheme is not provided, this will generate</span>
-<span class="sd">                               a protocol-relative URL.</span>
-<span class="sd">        :param append_unknown: unknown parameters are appended to the generated</span>
-<span class="sd">                               URL as query string argument.  Disable this</span>
-<span class="sd">                               if you want the builder to ignore those.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">update</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">values</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">MultiDict</span><span class="p">):</span>
-                <span class="n">valueiter</span> <span class="o">=</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">valueiter</span> <span class="o">=</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
-            <span class="n">values</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">((</span><span class="n">k</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">valueiter</span> <span class="k">if</span> <span class="n">v</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">values</span> <span class="o">=</span> <span class="p">{}</span>
-
-        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_partial_build</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="n">append_unknown</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">BuildError</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">method</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
-        <span class="n">domain_part</span><span class="p">,</span> <span class="n">path</span> <span class="o">=</span> <span class="n">rv</span>
-
-        <span class="n">host</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_host</span><span class="p">(</span><span class="n">domain_part</span><span class="p">)</span>
-
-        <span class="c1"># shortcut this.</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">force_external</span> <span class="ow">and</span> <span class="p">(</span>
-            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">host_matching</span> <span class="ow">and</span> <span class="n">host</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">server_name</span><span class="p">)</span> <span class="ow">or</span>
-            <span class="p">(</span><span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">host_matching</span> <span class="ow">and</span> <span class="n">domain_part</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">subdomain</span><span class="p">)</span>
-        <span class="p">):</span>
-            <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">url_join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">script_name</span><span class="p">,</span> <span class="s1">&#39;./&#39;</span> <span class="o">+</span> <span class="n">path</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)))</span>
-        <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">%s</span><span class="s1">//</span><span class="si">%s%s</span><span class="s1">/</span><span class="si">%s</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">url_scheme</span> <span class="o">+</span> <span class="s1">&#39;:&#39;</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">url_scheme</span> <span class="k">else</span> <span class="s1">&#39;&#39;</span><span class="p">,</span>
-            <span class="n">host</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">script_name</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">],</span>
-            <span class="n">path</span><span class="o">.</span><span class="n">lstrip</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-        <span class="p">))</span>
-</pre></div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../../index.html">Documentation overview</a><ul>
-  <li><a href="../index.html">Module code</a><ul>
-  </ul></li>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/_sources/flask/flask.ext.txt

@@ -1,10 +0,0 @@
-flask.ext package
-=================
-
-Module contents
----------------
-
-.. automodule:: flask.ext
-    :members:
-    :undoc-members:
-    :show-inheritance:

docs/_build/html/_sources/flask/flask.txt

@@ -1,157 +0,0 @@
-flask package
-=============
-
-Subpackages
------------
-
-.. toctree::
-
-    flask.ext
-
-Submodules
-----------
-
-flask.app module
-----------------
-
-.. automodule:: flask.app
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.blueprints module
------------------------
-
-.. automodule:: flask.blueprints
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.cli module
-----------------
-
-.. automodule:: flask.cli
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.config module
--------------------
-
-.. automodule:: flask.config
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.ctx module
-----------------
-
-.. automodule:: flask.ctx
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.debughelpers module
--------------------------
-
-.. automodule:: flask.debughelpers
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.exthook module
---------------------
-
-.. automodule:: flask.exthook
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.globals module
---------------------
-
-.. automodule:: flask.globals
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.helpers module
---------------------
-
-.. automodule:: flask.helpers
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.json module
------------------
-
-.. automodule:: flask.json
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.logging module
---------------------
-
-.. automodule:: flask.logging
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.sessions module
----------------------
-
-.. automodule:: flask.sessions
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.signals module
---------------------
-
-.. automodule:: flask.signals
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.templating module
------------------------
-
-.. automodule:: flask.templating
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.testing module
---------------------
-
-.. automodule:: flask.testing
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.views module
-------------------
-
-.. automodule:: flask.views
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-flask.wrappers module
----------------------
-
-.. automodule:: flask.wrappers
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: flask
-    :members:
-    :undoc-members:
-    :show-inheritance:

docs/_build/html/_sources/flask/index.txt

@@ -1,23 +0,0 @@
-.. flask documentation master file, created by
-   sphinx-quickstart on Sun Dec 18 11:30:09 2016.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to flask's documentation!
-=================================
-
-Contents:
-
-.. toctree::
-   :maxdepth: 4
-
-   flask
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-

docs/_build/html/_sources/index.txt

@@ -1,23 +0,0 @@
-.. proxypool documentation master file, created by
-   sphinx-quickstart on Sun Dec 18 11:44:51 2016.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to proxypool's documentation!
-=====================================
-
-Contents:
-
-.. toctree::
-   :maxdepth: 4
-
-   proxypool
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-

docs/_build/html/_sources/proxypool.txt

@@ -1,70 +0,0 @@
-proxypool package
-=================
-
-Submodules
-----------
-
-proxypool.api module
---------------------
-
-.. automodule:: proxypool.api
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.db module
--------------------
-
-.. automodule:: proxypool.db
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.error module
-----------------------
-
-.. automodule:: proxypool.error
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.proxyGetter module
-----------------------------
-
-.. automodule:: proxypool.proxyGetter
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.schedule module
--------------------------
-
-.. automodule:: proxypool.schedule
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.setting module
-------------------------
-
-.. automodule:: proxypool.setting
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.utils module
-----------------------
-
-.. automodule:: proxypool.utils
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: proxypool
-    :members:
-    :undoc-members:
-    :show-inheritance:

docs/_build/html/_static/alabaster.css

@@ -1,693 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-@import url("basic.css");
-
-/* -- page layout ----------------------------------------------------------- */
-
-body {
-    font-family: 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif;
-    font-size: 17px;
-    background-color: #fff;
-    color: #000;
-    margin: 0;
-    padding: 0;
-}
-
-
-div.document {
-    width: 940px;
-    margin: 30px auto 0 auto;
-}
-
-div.documentwrapper {
-    float: left;
-    width: 100%;
-}
-
-div.bodywrapper {
-    margin: 0 0 0 220px;
-}
-
-div.sphinxsidebar {
-    width: 220px;
-    font-size: 14px;
-    line-height: 1.5;
-}
-
-hr {
-    border: 1px solid #B1B4B6;
-}
-
-div.body {
-    background-color: #fff;
-    color: #3E4349;
-    padding: 0 30px 0 30px;
-}
-
-div.body > .section {
-    text-align: left;
-}
-
-div.footer {
-    width: 940px;
-    margin: 20px auto 30px auto;
-    font-size: 14px;
-    color: #888;
-    text-align: right;
-}
-
-div.footer a {
-    color: #888;
-}
-
-p.caption {
-    font-family: inherit;
-    font-size: inherit;
-}
-
-
-div.relations {
-    display: none;
-}
-
-
-div.sphinxsidebar a {
-    color: #444;
-    text-decoration: none;
-    border-bottom: 1px dotted #999;
-}
-
-div.sphinxsidebar a:hover {
-    border-bottom: 1px solid #999;
-}
-
-div.sphinxsidebarwrapper {
-    padding: 18px 10px;
-}
-
-div.sphinxsidebarwrapper p.logo {
-    padding: 0;
-    margin: -10px 0 0 0px;
-    text-align: center;
-}
-
-div.sphinxsidebarwrapper h1.logo {
-    margin-top: -10px;
-    text-align: center;
-    margin-bottom: 5px;
-    text-align: left;
-}
-
-div.sphinxsidebarwrapper h1.logo-name {
-    margin-top: 0px;
-}
-
-div.sphinxsidebarwrapper p.blurb {
-    margin-top: 0;
-    font-style: normal;
-}
-
-div.sphinxsidebar h3,
-div.sphinxsidebar h4 {
-    font-family: 'Garamond', 'Georgia', serif;
-    color: #444;
-    font-size: 24px;
-    font-weight: normal;
-    margin: 0 0 5px 0;
-    padding: 0;
-}
-
-div.sphinxsidebar h4 {
-    font-size: 20px;
-}
-
-div.sphinxsidebar h3 a {
-    color: #444;
-}
-
-div.sphinxsidebar p.logo a,
-div.sphinxsidebar h3 a,
-div.sphinxsidebar p.logo a:hover,
-div.sphinxsidebar h3 a:hover {
-    border: none;
-}
-
-div.sphinxsidebar p {
-    color: #555;
-    margin: 10px 0;
-}
-
-div.sphinxsidebar ul {
-    margin: 10px 0;
-    padding: 0;
-    color: #000;
-}
-
-div.sphinxsidebar ul li.toctree-l1 > a {
-    font-size: 120%;
-}
-
-div.sphinxsidebar ul li.toctree-l2 > a {
-    font-size: 110%;
-}
-
-div.sphinxsidebar input {
-    border: 1px solid #CCC;
-    font-family: 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif;
-    font-size: 1em;
-}
-
-div.sphinxsidebar hr {
-    border: none;
-    height: 1px;
-    color: #AAA;
-    background: #AAA;
-
-    text-align: left;
-    margin-left: 0;
-    width: 50%;
-}
-
-/* -- body styles ----------------------------------------------------------- */
-
-a {
-    color: #004B6B;
-    text-decoration: underline;
-}
-
-a:hover {
-    color: #6D4100;
-    text-decoration: underline;
-}
-
-div.body h1,
-div.body h2,
-div.body h3,
-div.body h4,
-div.body h5,
-div.body h6 {
-    font-family: 'Garamond', 'Georgia', serif;
-    font-weight: normal;
-    margin: 30px 0px 10px 0px;
-    padding: 0;
-}
-
-div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; }
-div.body h2 { font-size: 180%; }
-div.body h3 { font-size: 150%; }
-div.body h4 { font-size: 130%; }
-div.body h5 { font-size: 100%; }
-div.body h6 { font-size: 100%; }
-
-a.headerlink {
-    color: #DDD;
-    padding: 0 4px;
-    text-decoration: none;
-}
-
-a.headerlink:hover {
-    color: #444;
-    background: #EAEAEA;
-}
-
-div.body p, div.body dd, div.body li {
-    line-height: 1.4em;
-}
-
-div.admonition {
-    margin: 20px 0px;
-    padding: 10px 30px;
-    background-color: #EEE;
-    border: 1px solid #CCC;
-}
-
-div.admonition tt.xref, div.admonition code.xref, div.admonition a tt {
-    background-color: ;
-    border-bottom: 1px solid #fafafa;
-}
-
-dd div.admonition {
-    margin-left: -60px;
-    padding-left: 60px;
-}
-
-div.admonition p.admonition-title {
-    font-family: 'Garamond', 'Georgia', serif;
-    font-weight: normal;
-    font-size: 24px;
-    margin: 0 0 10px 0;
-    padding: 0;
-    line-height: 1;
-}
-
-div.admonition p.last {
-    margin-bottom: 0;
-}
-
-div.highlight {
-    background-color: #fff;
-}
-
-dt:target, .highlight {
-    background: #FAF3E8;
-}
-
-div.warning {
-    background-color: #FCC;
-    border: 1px solid #FAA;
-}
-
-div.danger {
-    background-color: #FCC;
-    border: 1px solid #FAA;
-    -moz-box-shadow: 2px 2px 4px #D52C2C;
-    -webkit-box-shadow: 2px 2px 4px #D52C2C;
-    box-shadow: 2px 2px 4px #D52C2C;
-}
-
-div.error {
-    background-color: #FCC;
-    border: 1px solid #FAA;
-    -moz-box-shadow: 2px 2px 4px #D52C2C;
-    -webkit-box-shadow: 2px 2px 4px #D52C2C;
-    box-shadow: 2px 2px 4px #D52C2C;
-}
-
-div.caution {
-    background-color: #FCC;
-    border: 1px solid #FAA;
-}
-
-div.attention {
-    background-color: #FCC;
-    border: 1px solid #FAA;
-}
-
-div.important {
-    background-color: #EEE;
-    border: 1px solid #CCC;
-}
-
-div.note {
-    background-color: #EEE;
-    border: 1px solid #CCC;
-}
-
-div.tip {
-    background-color: #EEE;
-    border: 1px solid #CCC;
-}
-
-div.hint {
-    background-color: #EEE;
-    border: 1px solid #CCC;
-}
-
-div.seealso {
-    background-color: #EEE;
-    border: 1px solid #CCC;
-}
-
-div.topic {
-    background-color: #EEE;
-}
-
-p.admonition-title {
-    display: inline;
-}
-
-p.admonition-title:after {
-    content: ":";
-}
-
-pre, tt, code {
-    font-family: 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
-    font-size: 0.9em;
-}
-
-.hll {
-    background-color: #FFC;
-    margin: 0 -12px;
-    padding: 0 12px;
-    display: block;
-}
-
-img.screenshot {
-}
-
-tt.descname, tt.descclassname, code.descname, code.descclassname {
-    font-size: 0.95em;
-}
-
-tt.descname, code.descname {
-    padding-right: 0.08em;
-}
-
-img.screenshot {
-    -moz-box-shadow: 2px 2px 4px #EEE;
-    -webkit-box-shadow: 2px 2px 4px #EEE;
-    box-shadow: 2px 2px 4px #EEE;
-}
-
-table.docutils {
-    border: 1px solid #888;
-    -moz-box-shadow: 2px 2px 4px #EEE;
-    -webkit-box-shadow: 2px 2px 4px #EEE;
-    box-shadow: 2px 2px 4px #EEE;
-}
-
-table.docutils td, table.docutils th {
-    border: 1px solid #888;
-    padding: 0.25em 0.7em;
-}
-
-table.field-list, table.footnote {
-    border: none;
-    -moz-box-shadow: none;
-    -webkit-box-shadow: none;
-    box-shadow: none;
-}
-
-table.footnote {
-    margin: 15px 0;
-    width: 100%;
-    border: 1px solid #EEE;
-    background: #FDFDFD;
-    font-size: 0.9em;
-}
-
-table.footnote + table.footnote {
-    margin-top: -15px;
-    border-top: none;
-}
-
-table.field-list th {
-    padding: 0 0.8em 0 0;
-}
-
-table.field-list td {
-    padding: 0;
-}
-
-table.field-list p {
-    margin-bottom: 0.8em;
-}
-
-table.footnote td.label {
-    width: .1px;
-    padding: 0.3em 0 0.3em 0.5em;
-}
-
-table.footnote td {
-    padding: 0.3em 0.5em;
-}
-
-dl {
-    margin: 0;
-    padding: 0;
-}
-
-dl dd {
-    margin-left: 30px;
-}
-
-blockquote {
-    margin: 0 0 0 30px;
-    padding: 0;
-}
-
-ul, ol {
-    /* Matches the 30px from the narrow-screen "li > ul" selector below */
-    margin: 10px 0 10px 30px;
-    padding: 0;
-}
-
-pre {
-    background: #EEE;
-    padding: 7px 30px;
-    margin: 15px 0px;
-    line-height: 1.3em;
-}
-
-div.viewcode-block:target {
-    background: #ffd;
-}
-
-dl pre, blockquote pre, li pre {
-    margin-left: 0;
-    padding-left: 30px;
-}
-
-dl dl pre {
-    margin-left: -90px;
-    padding-left: 90px;
-}
-
-tt, code {
-    background-color: #ecf0f3;
-    color: #222;
-    /* padding: 1px 2px; */
-}
-
-tt.xref, code.xref, a tt {
-    background-color: #FBFBFB;
-    border-bottom: 1px solid #fff;
-}
-
-a.reference {
-    text-decoration: none;
-    border-bottom: 1px dotted #004B6B;
-}
-
-/* Don't put an underline on images */
-a.image-reference, a.image-reference:hover {
-    border-bottom: none;
-}
-
-a.reference:hover {
-    border-bottom: 1px solid #6D4100;
-}
-
-a.footnote-reference {
-    text-decoration: none;
-    font-size: 0.7em;
-    vertical-align: top;
-    border-bottom: 1px dotted #004B6B;
-}
-
-a.footnote-reference:hover {
-    border-bottom: 1px solid #6D4100;
-}
-
-a:hover tt, a:hover code {
-    background: #EEE;
-}
-
-
-@media screen and (max-width: 870px) {
-
-    div.sphinxsidebar {
-    	display: none;
-    }
-
-    div.document {
-       width: 100%;
-
-    }
-
-    div.documentwrapper {
-    	margin-left: 0;
-    	margin-top: 0;
-    	margin-right: 0;
-    	margin-bottom: 0;
-    }
-
-    div.bodywrapper {
-    	margin-top: 0;
-    	margin-right: 0;
-    	margin-bottom: 0;
-    	margin-left: 0;
-    }
-
-    ul {
-    	margin-left: 0;
-    }
-
-	li > ul {
-        /* Matches the 30px from the "ul, ol" selector above */
-		margin-left: 30px;
-	}
-
-    .document {
-    	width: auto;
-    }
-
-    .footer {
-    	width: auto;
-    }
-
-    .bodywrapper {
-    	margin: 0;
-    }
-
-    .footer {
-    	width: auto;
-    }
-
-    .github {
-        display: none;
-    }
-
-
-
-}
-
-
-
-@media screen and (max-width: 875px) {
-
-    body {
-        margin: 0;
-        padding: 20px 30px;
-    }
-
-    div.documentwrapper {
-        float: none;
-        background: #fff;
-    }
-
-    div.sphinxsidebar {
-        display: block;
-        float: none;
-        width: 102.5%;
-        margin: 50px -30px -20px -30px;
-        padding: 10px 20px;
-        background: #333;
-        color: #FFF;
-    }
-
-    div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p,
-    div.sphinxsidebar h3 a {
-        color: #fff;
-    }
-
-    div.sphinxsidebar a {
-        color: #AAA;
-    }
-
-    div.sphinxsidebar p.logo {
-        display: none;
-    }
-
-    div.document {
-        width: 100%;
-        margin: 0;
-    }
-
-    div.footer {
-        display: none;
-    }
-
-    div.bodywrapper {
-        margin: 0;
-    }
-
-    div.body {
-        min-height: 0;
-        padding: 0;
-    }
-
-    .rtd_doc_footer {
-        display: none;
-    }
-
-    .document {
-        width: auto;
-    }
-
-    .footer {
-        width: auto;
-    }
-
-    .footer {
-        width: auto;
-    }
-
-    .github {
-        display: none;
-    }
-}
-
-
-/* misc. */
-
-.revsys-inline {
-    display: none!important;
-}
-
-/* Make nested-list/multi-paragraph items look better in Releases changelog
- * pages. Without this, docutils' magical list fuckery causes inconsistent
- * formatting between different release sub-lists.
- */
-div#changelog > div.section > ul > li > p:only-child {
-    margin-bottom: 0;
-}
-
-/* Hide fugly table cell borders in ..bibliography:: directive output */
-table.docutils.citation, table.docutils.citation td, table.docutils.citation th {
-  border: none;
-  /* Below needed in some edge cases; if not applied, bottom shadows appear */
-  -moz-box-shadow: none;
-  -webkit-box-shadow: none;
-  box-shadow: none;
-}

docs/_build/html/_static/basic.css

@@ -1,611 +0,0 @@
-/*
- * basic.css
- * ~~~~~~~~~
- *
- * Sphinx stylesheet -- basic theme.
- *
- * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/* -- main layout ----------------------------------------------------------- */
-
-div.clearer {
-    clear: both;
-}
-
-/* -- relbar ---------------------------------------------------------------- */
-
-div.related {
-    width: 100%;
-    font-size: 90%;
-}
-
-div.related h3 {
-    display: none;
-}
-
-div.related ul {
-    margin: 0;
-    padding: 0 0 0 10px;
-    list-style: none;
-}
-
-div.related li {
-    display: inline;
-}
-
-div.related li.right {
-    float: right;
-    margin-right: 5px;
-}
-
-/* -- sidebar --------------------------------------------------------------- */
-
-div.sphinxsidebarwrapper {
-    padding: 10px 5px 0 10px;
-}
-
-div.sphinxsidebar {
-    float: left;
-    width: 230px;
-    margin-left: -100%;
-    font-size: 90%;
-    word-wrap: break-word;
-    overflow-wrap : break-word;
-}
-
-div.sphinxsidebar ul {
-    list-style: none;
-}
-
-div.sphinxsidebar ul ul,
-div.sphinxsidebar ul.want-points {
-    margin-left: 20px;
-    list-style: square;
-}
-
-div.sphinxsidebar ul ul {
-    margin-top: 0;
-    margin-bottom: 0;
-}
-
-div.sphinxsidebar form {
-    margin-top: 10px;
-}
-
-div.sphinxsidebar input {
-    border: 1px solid #98dbcc;
-    font-family: sans-serif;
-    font-size: 1em;
-}
-
-div.sphinxsidebar #searchbox input[type="text"] {
-    width: 170px;
-}
-
-img {
-    border: 0;
-    max-width: 100%;
-}
-
-/* -- search page ----------------------------------------------------------- */
-
-ul.search {
-    margin: 10px 0 0 20px;
-    padding: 0;
-}
-
-ul.search li {
-    padding: 5px 0 5px 20px;
-    background-image: url(file.png);
-    background-repeat: no-repeat;
-    background-position: 0 7px;
-}
-
-ul.search li a {
-    font-weight: bold;
-}
-
-ul.search li div.context {
-    color: #888;
-    margin: 2px 0 0 30px;
-    text-align: left;
-}
-
-ul.keywordmatches li.goodmatch a {
-    font-weight: bold;
-}
-
-/* -- index page ------------------------------------------------------------ */
-
-table.contentstable {
-    width: 90%;
-}
-
-table.contentstable p.biglink {
-    line-height: 150%;
-}
-
-a.biglink {
-    font-size: 1.3em;
-}
-
-span.linkdescr {
-    font-style: italic;
-    padding-top: 5px;
-    font-size: 90%;
-}
-
-/* -- general index --------------------------------------------------------- */
-
-table.indextable {
-    width: 100%;
-}
-
-table.indextable td {
-    text-align: left;
-    vertical-align: top;
-}
-
-table.indextable dl, table.indextable dd {
-    margin-top: 0;
-    margin-bottom: 0;
-}
-
-table.indextable tr.pcap {
-    height: 10px;
-}
-
-table.indextable tr.cap {
-    margin-top: 10px;
-    background-color: #f2f2f2;
-}
-
-img.toggler {
-    margin-right: 3px;
-    margin-top: 3px;
-    cursor: pointer;
-}
-
-div.modindex-jumpbox {
-    border-top: 1px solid #ddd;
-    border-bottom: 1px solid #ddd;
-    margin: 1em 0 1em 0;
-    padding: 0.4em;
-}
-
-div.genindex-jumpbox {
-    border-top: 1px solid #ddd;
-    border-bottom: 1px solid #ddd;
-    margin: 1em 0 1em 0;
-    padding: 0.4em;
-}
-
-/* -- general body styles --------------------------------------------------- */
-
-div.body p, div.body dd, div.body li, div.body blockquote {
-    -moz-hyphens: auto;
-    -ms-hyphens: auto;
-    -webkit-hyphens: auto;
-    hyphens: auto;
-}
-
-a.headerlink {
-    visibility: hidden;
-}
-
-h1:hover > a.headerlink,
-h2:hover > a.headerlink,
-h3:hover > a.headerlink,
-h4:hover > a.headerlink,
-h5:hover > a.headerlink,
-h6:hover > a.headerlink,
-dt:hover > a.headerlink,
-caption:hover > a.headerlink,
-p.caption:hover > a.headerlink,
-div.code-block-caption:hover > a.headerlink {
-    visibility: visible;
-}
-
-div.body p.caption {
-    text-align: inherit;
-}
-
-div.body td {
-    text-align: left;
-}
-
-.field-list ul {
-    padding-left: 1em;
-}
-
-.first {
-    margin-top: 0 !important;
-}
-
-p.rubric {
-    margin-top: 30px;
-    font-weight: bold;
-}
-
-img.align-left, .figure.align-left, object.align-left {
-    clear: left;
-    float: left;
-    margin-right: 1em;
-}
-
-img.align-right, .figure.align-right, object.align-right {
-    clear: right;
-    float: right;
-    margin-left: 1em;
-}
-
-img.align-center, .figure.align-center, object.align-center {
-  display: block;
-  margin-left: auto;
-  margin-right: auto;
-}
-
-.align-left {
-    text-align: left;
-}
-
-.align-center {
-    text-align: center;
-}
-
-.align-right {
-    text-align: right;
-}
-
-/* -- sidebars -------------------------------------------------------------- */
-
-div.sidebar {
-    margin: 0 0 0.5em 1em;
-    border: 1px solid #ddb;
-    padding: 7px 7px 0 7px;
-    background-color: #ffe;
-    width: 40%;
-    float: right;
-}
-
-p.sidebar-title {
-    font-weight: bold;
-}
-
-/* -- topics ---------------------------------------------------------------- */
-
-div.topic {
-    border: 1px solid #ccc;
-    padding: 7px 7px 0 7px;
-    margin: 10px 0 10px 0;
-}
-
-p.topic-title {
-    font-size: 1.1em;
-    font-weight: bold;
-    margin-top: 10px;
-}
-
-/* -- admonitions ----------------------------------------------------------- */
-
-div.admonition {
-    margin-top: 10px;
-    margin-bottom: 10px;
-    padding: 7px;
-}
-
-div.admonition dt {
-    font-weight: bold;
-}
-
-div.admonition dl {
-    margin-bottom: 0;
-}
-
-p.admonition-title {
-    margin: 0px 10px 5px 0px;
-    font-weight: bold;
-}
-
-div.body p.centered {
-    text-align: center;
-    margin-top: 25px;
-}
-
-/* -- tables ---------------------------------------------------------------- */
-
-table.docutils {
-    border: 0;
-    border-collapse: collapse;
-}
-
-table caption span.caption-number {
-    font-style: italic;
-}
-
-table caption span.caption-text {
-}
-
-table.docutils td, table.docutils th {
-    padding: 1px 8px 1px 5px;
-    border-top: 0;
-    border-left: 0;
-    border-right: 0;
-    border-bottom: 1px solid #aaa;
-}
-
-table.field-list td, table.field-list th {
-    border: 0 !important;
-}
-
-table.footnote td, table.footnote th {
-    border: 0 !important;
-}
-
-th {
-    text-align: left;
-    padding-right: 5px;
-}
-
-table.citation {
-    border-left: solid 1px gray;
-    margin-left: 1px;
-}
-
-table.citation td {
-    border-bottom: none;
-}
-
-/* -- figures --------------------------------------------------------------- */
-
-div.figure {
-    margin: 0.5em;
-    padding: 0.5em;
-}
-
-div.figure p.caption {
-    padding: 0.3em;
-}
-
-div.figure p.caption span.caption-number {
-    font-style: italic;
-}
-
-div.figure p.caption span.caption-text {
-}
-
-
-/* -- other body styles ----------------------------------------------------- */
-
-ol.arabic {
-    list-style: decimal;
-}
-
-ol.loweralpha {
-    list-style: lower-alpha;
-}
-
-ol.upperalpha {
-    list-style: upper-alpha;
-}
-
-ol.lowerroman {
-    list-style: lower-roman;
-}
-
-ol.upperroman {
-    list-style: upper-roman;
-}
-
-dl {
-    margin-bottom: 15px;
-}
-
-dd p {
-    margin-top: 0px;
-}
-
-dd ul, dd table {
-    margin-bottom: 10px;
-}
-
-dd {
-    margin-top: 3px;
-    margin-bottom: 10px;
-    margin-left: 30px;
-}
-
-dt:target, .highlighted {
-    background-color: #fbe54e;
-}
-
-dl.glossary dt {
-    font-weight: bold;
-    font-size: 1.1em;
-}
-
-.field-list ul {
-    margin: 0;
-    padding-left: 1em;
-}
-
-.field-list p {
-    margin: 0;
-}
-
-.optional {
-    font-size: 1.3em;
-}
-
-.sig-paren {
-    font-size: larger;
-}
-
-.versionmodified {
-    font-style: italic;
-}
-
-.system-message {
-    background-color: #fda;
-    padding: 5px;
-    border: 3px solid red;
-}
-
-.footnote:target  {
-    background-color: #ffa;
-}
-
-.line-block {
-    display: block;
-    margin-top: 1em;
-    margin-bottom: 1em;
-}
-
-.line-block .line-block {
-    margin-top: 0;
-    margin-bottom: 0;
-    margin-left: 1.5em;
-}
-
-.guilabel, .menuselection {
-    font-family: sans-serif;
-}
-
-.accelerator {
-    text-decoration: underline;
-}
-
-.classifier {
-    font-style: oblique;
-}
-
-abbr, acronym {
-    border-bottom: dotted 1px;
-    cursor: help;
-}
-
-/* -- code displays --------------------------------------------------------- */
-
-pre {
-    overflow: auto;
-    overflow-y: hidden;  /* fixes display issues on Chrome browsers */
-}
-
-span.pre {
-    -moz-hyphens: none;
-    -ms-hyphens: none;
-    -webkit-hyphens: none;
-    hyphens: none;
-}
-
-td.linenos pre {
-    padding: 5px 0px;
-    border: 0;
-    background-color: transparent;
-    color: #aaa;
-}
-
-table.highlighttable {
-    margin-left: 0.5em;
-}
-
-table.highlighttable td {
-    padding: 0 0.5em 0 0.5em;
-}
-
-div.code-block-caption {
-    padding: 2px 5px;
-    font-size: small;
-}
-
-div.code-block-caption code {
-    background-color: transparent;
-}
-
-div.code-block-caption + div > div.highlight > pre {
-    margin-top: 0;
-}
-
-div.code-block-caption span.caption-number {
-    padding: 0.1em 0.3em;
-    font-style: italic;
-}
-
-div.code-block-caption span.caption-text {
-}
-
-div.literal-block-wrapper {
-    padding: 1em 1em 0;
-}
-
-div.literal-block-wrapper div.highlight {
-    margin: 0;
-}
-
-code.descname {
-    background-color: transparent;
-    font-weight: bold;
-    font-size: 1.2em;
-}
-
-code.descclassname {
-    background-color: transparent;
-}
-
-code.xref, a code {
-    background-color: transparent;
-    font-weight: bold;
-}
-
-h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
-    background-color: transparent;
-}
-
-.viewcode-link {
-    float: right;
-}
-
-.viewcode-back {
-    float: right;
-    font-family: sans-serif;
-}
-
-div.viewcode-block:target {
-    margin: -1px -10px;
-    padding: 0 10px;
-}
-
-/* -- math display ---------------------------------------------------------- */
-
-img.math {
-    vertical-align: middle;
-}
-
-div.body div.math p {
-    text-align: center;
-}
-
-span.eqno {
-    float: right;
-}
-
-/* -- printout stylesheet --------------------------------------------------- */
-
-@media print {
-    div.document,
-    div.documentwrapper,
-    div.bodywrapper {
-        margin: 0 !important;
-        width: 100%;
-    }
-
-    div.sphinxsidebar,
-    div.related,
-    div.footer,
-    #top-link {
-        display: none;
-    }
-}

docs/_build/html/_static/custom.css

@@ -1 +0,0 @@
-/* This file intentionally left blank. */

docs/_build/html/_static/doctools.js

@@ -1,287 +0,0 @@
-/*
- * doctools.js
- * ~~~~~~~~~~~
- *
- * Sphinx JavaScript utilities for all documentation.
- *
- * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/**
- * select a different prefix for underscore
- */
-$u = _.noConflict();
-
-/**
- * make the code below compatible with browsers without
- * an installed firebug like debugger
-if (!window.console || !console.firebug) {
-  var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
-    "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
-    "profile", "profileEnd"];
-  window.console = {};
-  for (var i = 0; i < names.length; ++i)
-    window.console[names[i]] = function() {};
-}
- */
-
-/**
- * small helper function to urldecode strings
- */
-jQuery.urldecode = function(x) {
-  return decodeURIComponent(x).replace(/\+/g, ' ');
-};
-
-/**
- * small helper function to urlencode strings
- */
-jQuery.urlencode = encodeURIComponent;
-
-/**
- * This function returns the parsed url parameters of the
- * current request. Multiple values per key are supported,
- * it will always return arrays of strings for the value parts.
- */
-jQuery.getQueryParameters = function(s) {
-  if (typeof s == 'undefined')
-    s = document.location.search;
-  var parts = s.substr(s.indexOf('?') + 1).split('&');
-  var result = {};
-  for (var i = 0; i < parts.length; i++) {
-    var tmp = parts[i].split('=', 2);
-    var key = jQuery.urldecode(tmp[0]);
-    var value = jQuery.urldecode(tmp[1]);
-    if (key in result)
-      result[key].push(value);
-    else
-      result[key] = [value];
-  }
-  return result;
-};
-
-/**
- * highlight a given string on a jquery object by wrapping it in
- * span elements with the given class name.
- */
-jQuery.fn.highlightText = function(text, className) {
-  function highlight(node) {
-    if (node.nodeType == 3) {
-      var val = node.nodeValue;
-      var pos = val.toLowerCase().indexOf(text);
-      if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
-        var span = document.createElement("span");
-        span.className = className;
-        span.appendChild(document.createTextNode(val.substr(pos, text.length)));
-        node.parentNode.insertBefore(span, node.parentNode.insertBefore(
-          document.createTextNode(val.substr(pos + text.length)),
-          node.nextSibling));
-        node.nodeValue = val.substr(0, pos);
-      }
-    }
-    else if (!jQuery(node).is("button, select, textarea")) {
-      jQuery.each(node.childNodes, function() {
-        highlight(this);
-      });
-    }
-  }
-  return this.each(function() {
-    highlight(this);
-  });
-};
-
-/*
- * backward compatibility for jQuery.browser
- * This will be supported until firefox bug is fixed.
- */
-if (!jQuery.browser) {
-  jQuery.uaMatch = function(ua) {
-    ua = ua.toLowerCase();
-
-    var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
-      /(webkit)[ \/]([\w.]+)/.exec(ua) ||
-      /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
-      /(msie) ([\w.]+)/.exec(ua) ||
-      ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
-      [];
-
-    return {
-      browser: match[ 1 ] || "",
-      version: match[ 2 ] || "0"
-    };
-  };
-  jQuery.browser = {};
-  jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
-}
-
-/**
- * Small JavaScript module for the documentation.
- */
-var Documentation = {
-
-  init : function() {
-    this.fixFirefoxAnchorBug();
-    this.highlightSearchWords();
-    this.initIndexTable();
-    
-  },
-
-  /**
-   * i18n support
-   */
-  TRANSLATIONS : {},
-  PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; },
-  LOCALE : 'unknown',
-
-  // gettext and ngettext don't access this so that the functions
-  // can safely bound to a different name (_ = Documentation.gettext)
-  gettext : function(string) {
-    var translated = Documentation.TRANSLATIONS[string];
-    if (typeof translated == 'undefined')
-      return string;
-    return (typeof translated == 'string') ? translated : translated[0];
-  },
-
-  ngettext : function(singular, plural, n) {
-    var translated = Documentation.TRANSLATIONS[singular];
-    if (typeof translated == 'undefined')
-      return (n == 1) ? singular : plural;
-    return translated[Documentation.PLURALEXPR(n)];
-  },
-
-  addTranslations : function(catalog) {
-    for (var key in catalog.messages)
-      this.TRANSLATIONS[key] = catalog.messages[key];
-    this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
-    this.LOCALE = catalog.locale;
-  },
-
-  /**
-   * add context elements like header anchor links
-   */
-  addContextElements : function() {
-    $('div[id] > :header:first').each(function() {
-      $('<a class="headerlink">\u00B6</a>').
-      attr('href', '#' + this.id).
-      attr('title', _('Permalink to this headline')).
-      appendTo(this);
-    });
-    $('dt[id]').each(function() {
-      $('<a class="headerlink">\u00B6</a>').
-      attr('href', '#' + this.id).
-      attr('title', _('Permalink to this definition')).
-      appendTo(this);
-    });
-  },
-
-  /**
-   * workaround a firefox stupidity
-   * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
-   */
-  fixFirefoxAnchorBug : function() {
-    if (document.location.hash)
-      window.setTimeout(function() {
-        document.location.href += '';
-      }, 10);
-  },
-
-  /**
-   * highlight the search words provided in the url in the text
-   */
-  highlightSearchWords : function() {
-    var params = $.getQueryParameters();
-    var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
-    if (terms.length) {
-      var body = $('div.body');
-      if (!body.length) {
-        body = $('body');
-      }
-      window.setTimeout(function() {
-        $.each(terms, function() {
-          body.highlightText(this.toLowerCase(), 'highlighted');
-        });
-      }, 10);
-      $('<p class="highlight-link"><a href="javascript:Documentation.' +
-        'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
-          .appendTo($('#searchbox'));
-    }
-  },
-
-  /**
-   * init the domain index toggle buttons
-   */
-  initIndexTable : function() {
-    var togglers = $('img.toggler').click(function() {
-      var src = $(this).attr('src');
-      var idnum = $(this).attr('id').substr(7);
-      $('tr.cg-' + idnum).toggle();
-      if (src.substr(-9) == 'minus.png')
-        $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
-      else
-        $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
-    }).css('display', '');
-    if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
-        togglers.click();
-    }
-  },
-
-  /**
-   * helper function to hide the search marks again
-   */
-  hideSearchWords : function() {
-    $('#searchbox .highlight-link').fadeOut(300);
-    $('span.highlighted').removeClass('highlighted');
-  },
-
-  /**
-   * make the url absolute
-   */
-  makeURL : function(relativeURL) {
-    return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
-  },
-
-  /**
-   * get the current relative url
-   */
-  getCurrentURL : function() {
-    var path = document.location.pathname;
-    var parts = path.split(/\//);
-    $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
-      if (this == '..')
-        parts.pop();
-    });
-    var url = parts.join('/');
-    return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
-  },
-
-  initOnKeyListeners: function() {
-    $(document).keyup(function(event) {
-      var activeElementType = document.activeElement.tagName;
-      // don't navigate when in search box or textarea
-      if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') {
-        switch (event.keyCode) {
-          case 37: // left
-            var prevHref = $('link[rel="prev"]').prop('href');
-            if (prevHref) {
-              window.location.href = prevHref;
-              return false;
-            }
-          case 39: // right
-            var nextHref = $('link[rel="next"]').prop('href');
-            if (nextHref) {
-              window.location.href = nextHref;
-              return false;
-            }
-        }
-      }
-    });
-  }
-};
-
-// quick alias for translations
-_ = Documentation.gettext;
-
-$(document).ready(function() {
-  Documentation.init();
-});

docs/_build/html/_static/jquery-1.11.1.js

@@ -1,10308 +0,0 @@
-/*!
- * jQuery JavaScript Library v1.11.1
- * http://jquery.com/
- *
- * Includes Sizzle.js
- * http://sizzlejs.com/
- *
- * Copyright 2005, 2014 jQuery Foundation, Inc. and other contributors
- * Released under the MIT license
- * http://jquery.org/license
- *
- * Date: 2014-05-01T17:42Z
- */
-
-(function( global, factory ) {
-
-	if ( typeof module === "object" && typeof module.exports === "object" ) {
-		// For CommonJS and CommonJS-like environments where a proper window is present,
-		// execute the factory and get jQuery
-		// For environments that do not inherently posses a window with a document
-		// (such as Node.js), expose a jQuery-making factory as module.exports
-		// This accentuates the need for the creation of a real window
-		// e.g. var jQuery = require("jquery")(window);
-		// See ticket #14549 for more info
-		module.exports = global.document ?
-			factory( global, true ) :
-			function( w ) {
-				if ( !w.document ) {
-					throw new Error( "jQuery requires a window with a document" );
-				}
-				return factory( w );
-			};
-	} else {
-		factory( global );
-	}
-
-// Pass this if window is not defined yet
-}(typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
-
-// Can't do this because several apps including ASP.NET trace
-// the stack via arguments.caller.callee and Firefox dies if
-// you try to trace through "use strict" call chains. (#13335)
-// Support: Firefox 18+
-//
-
-var deletedIds = [];
-
-var slice = deletedIds.slice;
-
-var concat = deletedIds.concat;
-
-var push = deletedIds.push;
-
-var indexOf = deletedIds.indexOf;
-
-var class2type = {};
-
-var toString = class2type.toString;
-
-var hasOwn = class2type.hasOwnProperty;
-
-var support = {};
-
-
-
-var
-	version = "1.11.1",
-
-	// Define a local copy of jQuery
-	jQuery = function( selector, context ) {
-		// The jQuery object is actually just the init constructor 'enhanced'
-		// Need init if jQuery is called (just allow error to be thrown if not included)
-		return new jQuery.fn.init( selector, context );
-	},
-
-	// Support: Android<4.1, IE<9
-	// Make sure we trim BOM and NBSP
-	rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,
-
-	// Matches dashed string for camelizing
-	rmsPrefix = /^-ms-/,
-	rdashAlpha = /-([\da-z])/gi,
-
-	// Used by jQuery.camelCase as callback to replace()
-	fcamelCase = function( all, letter ) {
-		return letter.toUpperCase();
-	};
-
-jQuery.fn = jQuery.prototype = {
-	// The current version of jQuery being used
-	jquery: version,
-
-	constructor: jQuery,
-
-	// Start with an empty selector
-	selector: "",
-
-	// The default length of a jQuery object is 0
-	length: 0,
-
-	toArray: function() {
-		return slice.call( this );
-	},
-
-	// Get the Nth element in the matched element set OR
-	// Get the whole matched element set as a clean array
-	get: function( num ) {
-		return num != null ?
-
-			// Return just the one element from the set
-			( num < 0 ? this[ num + this.length ] : this[ num ] ) :
-
-			// Return all the elements in a clean array
-			slice.call( this );
-	},
-
-	// Take an array of elements and push it onto the stack
-	// (returning the new matched element set)
-	pushStack: function( elems ) {
-
-		// Build a new jQuery matched element set
-		var ret = jQuery.merge( this.constructor(), elems );
-
-		// Add the old object onto the stack (as a reference)
-		ret.prevObject = this;
-		ret.context = this.context;
-
-		// Return the newly-formed element set
-		return ret;
-	},
-
-	// Execute a callback for every element in the matched set.
-	// (You can seed the arguments with an array of args, but this is
-	// only used internally.)
-	each: function( callback, args ) {
-		return jQuery.each( this, callback, args );
-	},
-
-	map: function( callback ) {
-		return this.pushStack( jQuery.map(this, function( elem, i ) {
-			return callback.call( elem, i, elem );
-		}));
-	},
-
-	slice: function() {
-		return this.pushStack( slice.apply( this, arguments ) );
-	},
-
-	first: function() {
-		return this.eq( 0 );
-	},
-
-	last: function() {
-		return this.eq( -1 );
-	},
-
-	eq: function( i ) {
-		var len = this.length,
-			j = +i + ( i < 0 ? len : 0 );
-		return this.pushStack( j >= 0 && j < len ? [ this[j] ] : [] );
-	},
-
-	end: function() {
-		return this.prevObject || this.constructor(null);
-	},
-
-	// For internal use only.
-	// Behaves like an Array's method, not like a jQuery method.
-	push: push,
-	sort: deletedIds.sort,
-	splice: deletedIds.splice
-};
-
-jQuery.extend = jQuery.fn.extend = function() {
-	var src, copyIsArray, copy, name, options, clone,
-		target = arguments[0] || {},
-		i = 1,
-		length = arguments.length,
-		deep = false;
-
-	// Handle a deep copy situation
-	if ( typeof target === "boolean" ) {
-		deep = target;
-
-		// skip the boolean and the target
-		target = arguments[ i ] || {};
-		i++;
-	}
-
-	// Handle case when target is a string or something (possible in deep copy)
-	if ( typeof target !== "object" && !jQuery.isFunction(target) ) {
-		target = {};
-	}
-
-	// extend jQuery itself if only one argument is passed
-	if ( i === length ) {
-		target = this;
-		i--;
-	}
-
-	for ( ; i < length; i++ ) {
-		// Only deal with non-null/undefined values
-		if ( (options = arguments[ i ]) != null ) {
-			// Extend the base object
-			for ( name in options ) {
-				src = target[ name ];
-				copy = options[ name ];
-
-				// Prevent never-ending loop
-				if ( target === copy ) {
-					continue;
-				}
-
-				// Recurse if we're merging plain objects or arrays
-				if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) {
-					if ( copyIsArray ) {
-						copyIsArray = false;
-						clone = src && jQuery.isArray(src) ? src : [];
-
-					} else {
-						clone = src && jQuery.isPlainObject(src) ? src : {};
-					}
-
-					// Never move original objects, clone them
-					target[ name ] = jQuery.extend( deep, clone, copy );
-
-				// Don't bring in undefined values
-				} else if ( copy !== undefined ) {
-					target[ name ] = copy;
-				}
-			}
-		}
-	}
-
-	// Return the modified object
-	return target;
-};
-
-jQuery.extend({
-	// Unique for each copy of jQuery on the page
-	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),
-
-	// Assume jQuery is ready without the ready module
-	isReady: true,
-
-	error: function( msg ) {
-		throw new Error( msg );
-	},
-
-	noop: function() {},
-
-	// See test/unit/core.js for details concerning isFunction.
-	// Since version 1.3, DOM methods and functions like alert
-	// aren't supported. They return false on IE (#2968).
-	isFunction: function( obj ) {
-		return jQuery.type(obj) === "function";
-	},
-
-	isArray: Array.isArray || function( obj ) {
-		return jQuery.type(obj) === "array";
-	},
-
-	isWindow: function( obj ) {
-		/* jshint eqeqeq: false */
-		return obj != null && obj == obj.window;
-	},
-
-	isNumeric: function( obj ) {
-		// parseFloat NaNs numeric-cast false positives (null|true|false|"")
-		// ...but misinterprets leading-number strings, particularly hex literals ("0x...")
-		// subtraction forces infinities to NaN
-		return !jQuery.isArray( obj ) && obj - parseFloat( obj ) >= 0;
-	},
-
-	isEmptyObject: function( obj ) {
-		var name;
-		for ( name in obj ) {
-			return false;
-		}
-		return true;
-	},
-
-	isPlainObject: function( obj ) {
-		var key;
-
-		// Must be an Object.
-		// Because of IE, we also have to check the presence of the constructor property.
-		// Make sure that DOM nodes and window objects don't pass through, as well
-		if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) {
-			return false;
-		}
-
-		try {
-			// Not own constructor property must be Object
-			if ( obj.constructor &&
-				!hasOwn.call(obj, "constructor") &&
-				!hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) {
-				return false;
-			}
-		} catch ( e ) {
-			// IE8,9 Will throw exceptions on certain host objects #9897
-			return false;
-		}
-
-		// Support: IE<9
-		// Handle iteration over inherited properties before own properties.
-		if ( support.ownLast ) {
-			for ( key in obj ) {
-				return hasOwn.call( obj, key );
-			}
-		}
-
-		// Own properties are enumerated firstly, so to speed up,
-		// if last one is own, then all properties are own.
-		for ( key in obj ) {}
-
-		return key === undefined || hasOwn.call( obj, key );
-	},
-
-	type: function( obj ) {
-		if ( obj == null ) {
-			return obj + "";
-		}
-		return typeof obj === "object" || typeof obj === "function" ?
-			class2type[ toString.call(obj) ] || "object" :
-			typeof obj;
-	},
-
-	// Evaluates a script in a global context
-	// Workarounds based on findings by Jim Driscoll
-	// http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context
-	globalEval: function( data ) {
-		if ( data && jQuery.trim( data ) ) {
-			// We use execScript on Internet Explorer
-			// We use an anonymous function so that context is window
-			// rather than jQuery in Firefox
-			( window.execScript || function( data ) {
-				window[ "eval" ].call( window, data );
-			} )( data );
-		}
-	},
-
-	// Convert dashed to camelCase; used by the css and data modules
-	// Microsoft forgot to hump their vendor prefix (#9572)
-	camelCase: function( string ) {
-		return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
-	},
-
-	nodeName: function( elem, name ) {
-		return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
-	},
-
-	// args is for internal usage only
-	each: function( obj, callback, args ) {
-		var value,
-			i = 0,
-			length = obj.length,
-			isArray = isArraylike( obj );
-
-		if ( args ) {
-			if ( isArray ) {
-				for ( ; i < length; i++ ) {
-					value = callback.apply( obj[ i ], args );
-
-					if ( value === false ) {
-						break;
-					}
-				}
-			} else {
-				for ( i in obj ) {
-					value = callback.apply( obj[ i ], args );
-
-					if ( value === false ) {
-						break;
-					}
-				}
-			}
-
-		// A special, fast, case for the most common use of each
-		} else {
-			if ( isArray ) {
-				for ( ; i < length; i++ ) {
-					value = callback.call( obj[ i ], i, obj[ i ] );
-
-					if ( value === false ) {
-						break;
-					}
-				}
-			} else {
-				for ( i in obj ) {
-					value = callback.call( obj[ i ], i, obj[ i ] );
-
-					if ( value === false ) {
-						break;
-					}
-				}
-			}
-		}
-
-		return obj;
-	},
-
-	// Support: Android<4.1, IE<9
-	trim: function( text ) {
-		return text == null ?
-			"" :
-			( text + "" ).replace( rtrim, "" );
-	},
-
-	// results is for internal usage only
-	makeArray: function( arr, results ) {
-		var ret = results || [];
-
-		if ( arr != null ) {
-			if ( isArraylike( Object(arr) ) ) {
-				jQuery.merge( ret,
-					typeof arr === "string" ?
-					[ arr ] : arr
-				);
-			} else {
-				push.call( ret, arr );
-			}
-		}
-
-		return ret;
-	},
-
-	inArray: function( elem, arr, i ) {
-		var len;
-
-		if ( arr ) {
-			if ( indexOf ) {
-				return indexOf.call( arr, elem, i );
-			}
-
-			len = arr.length;
-			i = i ? i < 0 ? Math.max( 0, len + i ) : i : 0;
-
-			for ( ; i < len; i++ ) {
-				// Skip accessing in sparse arrays
-				if ( i in arr && arr[ i ] === elem ) {
-					return i;
-				}
-			}
-		}
-
-		return -1;
-	},
-
-	merge: function( first, second ) {
-		var len = +second.length,
-			j = 0,
-			i = first.length;
-
-		while ( j < len ) {
-			first[ i++ ] = second[ j++ ];
-		}
-
-		// Support: IE<9
-		// Workaround casting of .length to NaN on otherwise arraylike objects (e.g., NodeLists)
-		if ( len !== len ) {
-			while ( second[j] !== undefined ) {
-				first[ i++ ] = second[ j++ ];
-			}
-		}
-
-		first.length = i;
-
-		return first;
-	},
-
-	grep: function( elems, callback, invert ) {
-		var callbackInverse,
-			matches = [],
-			i = 0,
-			length = elems.length,
-			callbackExpect = !invert;
-
-		// Go through the array, only saving the items
-		// that pass the validator function
-		for ( ; i < length; i++ ) {
-			callbackInverse = !callback( elems[ i ], i );
-			if ( callbackInverse !== callbackExpect ) {
-				matches.push( elems[ i ] );
-			}
-		}
-
-		return matches;
-	},
-
-	// arg is for internal usage only
-	map: function( elems, callback, arg ) {
-		var value,
-			i = 0,
-			length = elems.length,
-			isArray = isArraylike( elems ),
-			ret = [];
-
-		// Go through the array, translating each of the items to their new values
-		if ( isArray ) {
-			for ( ; i < length; i++ ) {
-				value = callback( elems[ i ], i, arg );
-
-				if ( value != null ) {
-					ret.push( value );
-				}
-			}
-
-		// Go through every key on the object,
-		} else {
-			for ( i in elems ) {
-				value = callback( elems[ i ], i, arg );
-
-				if ( value != null ) {
-					ret.push( value );
-				}
-			}
-		}
-
-		// Flatten any nested arrays
-		return concat.apply( [], ret );
-	},
-
-	// A global GUID counter for objects
-	guid: 1,
-
-	// Bind a function to a context, optionally partially applying any
-	// arguments.
-	proxy: function( fn, context ) {
-		var args, proxy, tmp;
-
-		if ( typeof context === "string" ) {
-			tmp = fn[ context ];
-			context = fn;
-			fn = tmp;
-		}
-
-		// Quick check to determine if target is callable, in the spec
-		// this throws a TypeError, but we will just return undefined.
-		if ( !jQuery.isFunction( fn ) ) {
-			return undefined;
-		}
-
-		// Simulated bind
-		args = slice.call( arguments, 2 );
-		proxy = function() {
-			return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
-		};
-
-		// Set the guid of unique handler to the same of original handler, so it can be removed
-		proxy.guid = fn.guid = fn.guid || jQuery.guid++;
-
-		return proxy;
-	},
-
-	now: function() {
-		return +( new Date() );
-	},
-
-	// jQuery.support is not used in Core but other projects attach their
-	// properties to it so it needs to exist.
-	support: support
-});
-
-// Populate the class2type map
-jQuery.each("Boolean Number String Function Array Date RegExp Object Error".split(" "), function(i, name) {
-	class2type[ "[object " + name + "]" ] = name.toLowerCase();
-});
-
-function isArraylike( obj ) {
-	var length = obj.length,
-		type = jQuery.type( obj );
-
-	if ( type === "function" || jQuery.isWindow( obj ) ) {
-		return false;
-	}
-
-	if ( obj.nodeType === 1 && length ) {
-		return true;
-	}
-
-	return type === "array" || length === 0 ||
-		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
-}
-var Sizzle =
-/*!
- * Sizzle CSS Selector Engine v1.10.19
- * http://sizzlejs.com/
- *
- * Copyright 2013 jQuery Foundation, Inc. and other contributors
- * Released under the MIT license
- * http://jquery.org/license
- *
- * Date: 2014-04-18
- */
-(function( window ) {
-
-var i,
-	support,
-	Expr,
-	getText,
-	isXML,
-	tokenize,
-	compile,
-	select,
-	outermostContext,
-	sortInput,
-	hasDuplicate,
-
-	// Local document vars
-	setDocument,
-	document,
-	docElem,
-	documentIsHTML,
-	rbuggyQSA,
-	rbuggyMatches,
-	matches,
-	contains,
-
-	// Instance-specific data
-	expando = "sizzle" + -(new Date()),
-	preferredDoc = window.document,
-	dirruns = 0,
-	done = 0,
-	classCache = createCache(),
-	tokenCache = createCache(),
-	compilerCache = createCache(),
-	sortOrder = function( a, b ) {
-		if ( a === b ) {
-			hasDuplicate = true;
-		}
-		return 0;
-	},
-
-	// General-purpose constants
-	strundefined = typeof undefined,
-	MAX_NEGATIVE = 1 << 31,
-
-	// Instance methods
-	hasOwn = ({}).hasOwnProperty,
-	arr = [],
-	pop = arr.pop,
-	push_native = arr.push,
-	push = arr.push,
-	slice = arr.slice,
-	// Use a stripped-down indexOf if we can't use a native one
-	indexOf = arr.indexOf || function( elem ) {
-		var i = 0,
-			len = this.length;
-		for ( ; i < len; i++ ) {
-			if ( this[i] === elem ) {
-				return i;
-			}
-		}
-		return -1;
-	},
-
-	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",
-
-	// Regular expressions
-
-	// Whitespace characters http://www.w3.org/TR/css3-selectors/#whitespace
-	whitespace = "[\\x20\\t\\r\\n\\f]",
-	// http://www.w3.org/TR/css3-syntax/#characters
-	characterEncoding = "(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",
-
-	// Loosely modeled on CSS identifier characters
-	// An unquoted value should be a CSS identifier http://www.w3.org/TR/css3-selectors/#attribute-selectors
-	// Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier
-	identifier = characterEncoding.replace( "w", "w#" ),
-
-	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
-	attributes = "\\[" + whitespace + "*(" + characterEncoding + ")(?:" + whitespace +
-		// Operator (capture 2)
-		"*([*^$|!~]?=)" + whitespace +
-		// "Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]"
-		"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace +
-		"*\\]",
-
-	pseudos = ":(" + characterEncoding + ")(?:\\((" +
-		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
-		// 1. quoted (capture 3; capture 4 or capture 5)
-		"('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" +
-		// 2. simple (capture 6)
-		"((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" +
-		// 3. anything else (capture 2)
-		".*" +
-		")\\)|)",
-
-	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
-	rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ),
-
-	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
-	rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ),
-
-	rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*?)" + whitespace + "*\\]", "g" ),
-
-	rpseudo = new RegExp( pseudos ),
-	ridentifier = new RegExp( "^" + identifier + "$" ),
-
-	matchExpr = {
-		"ID": new RegExp( "^#(" + characterEncoding + ")" ),
-		"CLASS": new RegExp( "^\\.(" + characterEncoding + ")" ),
-		"TAG": new RegExp( "^(" + characterEncoding.replace( "w", "w*" ) + ")" ),
-		"ATTR": new RegExp( "^" + attributes ),
-		"PSEUDO": new RegExp( "^" + pseudos ),
-		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace +
-			"*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace +
-			"*(\\d+)|))" + whitespace + "*\\)|)", "i" ),
-		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),
-		// For use in libraries implementing .is()
-		// We use this for POS matching in `select`
-		"needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" +
-			whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" )
-	},
-
-	rinputs = /^(?:input|select|textarea|button)$/i,
-	rheader = /^h\d$/i,
-
-	rnative = /^[^{]+\{\s*\[native \w/,
-
-	// Easily-parseable/retrievable ID or TAG or CLASS selectors
-	rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,
-
-	rsibling = /[+~]/,
-	rescape = /'|\\/g,
-
-	// CSS escapes http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
-	runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ),
-	funescape = function( _, escaped, escapedWhitespace ) {
-		var high = "0x" + escaped - 0x10000;
-		// NaN means non-codepoint
-		// Support: Firefox<24
-		// Workaround erroneous numeric interpretation of +"0x"
-		return high !== high || escapedWhitespace ?
-			escaped :
-			high < 0 ?
-				// BMP codepoint
-				String.fromCharCode( high + 0x10000 ) :
-				// Supplemental Plane codepoint (surrogate pair)
-				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
-	};
-
-// Optimize for push.apply( _, NodeList )
-try {
-	push.apply(
-		(arr = slice.call( preferredDoc.childNodes )),
-		preferredDoc.childNodes
-	);
-	// Support: Android<4.0
-	// Detect silently failing push.apply
-	arr[ preferredDoc.childNodes.length ].nodeType;
-} catch ( e ) {
-	push = { apply: arr.length ?
-
-		// Leverage slice if possible
-		function( target, els ) {
-			push_native.apply( target, slice.call(els) );
-		} :
-
-		// Support: IE<9
-		// Otherwise append directly
-		function( target, els ) {
-			var j = target.length,
-				i = 0;
-			// Can't trust NodeList.length
-			while ( (target[j++] = els[i++]) ) {}
-			target.length = j - 1;
-		}
-	};
-}
-
-function Sizzle( selector, context, results, seed ) {
-	var match, elem, m, nodeType,
-		// QSA vars
-		i, groups, old, nid, newContext, newSelector;
-
-	if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) {
-		setDocument( context );
-	}
-
-	context = context || document;
-	results = results || [];
-
-	if ( !selector || typeof selector !== "string" ) {
-		return results;
-	}
-
-	if ( (nodeType = context.nodeType) !== 1 && nodeType !== 9 ) {
-		return [];
-	}
-
-	if ( documentIsHTML && !seed ) {
-
-		// Shortcuts
-		if ( (match = rquickExpr.exec( selector )) ) {
-			// Speed-up: Sizzle("#ID")
-			if ( (m = match[1]) ) {
-				if ( nodeType === 9 ) {
-					elem = context.getElementById( m );
-					// Check parentNode to catch when Blackberry 4.6 returns
-					// nodes that are no longer in the document (jQuery #6963)
-					if ( elem && elem.parentNode ) {
-						// Handle the case where IE, Opera, and Webkit return items
-						// by name instead of ID
-						if ( elem.id === m ) {
-							results.push( elem );
-							return results;
-						}
-					} else {
-						return results;
-					}
-				} else {
-					// Context is not a document
-					if ( context.ownerDocument && (elem = context.ownerDocument.getElementById( m )) &&
-						contains( context, elem ) && elem.id === m ) {
-						results.push( elem );
-						return results;
-					}
-				}
-
-			// Speed-up: Sizzle("TAG")
-			} else if ( match[2] ) {
-				push.apply( results, context.getElementsByTagName( selector ) );
-				return results;
-
-			// Speed-up: Sizzle(".CLASS")
-			} else if ( (m = match[3]) && support.getElementsByClassName && context.getElementsByClassName ) {
-				push.apply( results, context.getElementsByClassName( m ) );
-				return results;
-			}
-		}
-
-		// QSA path
-		if ( support.qsa && (!rbuggyQSA || !rbuggyQSA.test( selector )) ) {
-			nid = old = expando;
-			newContext = context;
-			newSelector = nodeType === 9 && selector;
-
-			// qSA works strangely on Element-rooted queries
-			// We can work around this by specifying an extra ID on the root
-			// and working up from there (Thanks to Andrew Dupont for the technique)
-			// IE 8 doesn't work on object elements
-			if ( nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) {
-				groups = tokenize( selector );
-
-				if ( (old = context.getAttribute("id")) ) {
-					nid = old.replace( rescape, "\\$&" );
-				} else {
-					context.setAttribute( "id", nid );
-				}
-				nid = "[id='" + nid + "'] ";
-
-				i = groups.length;
-				while ( i-- ) {
-					groups[i] = nid + toSelector( groups[i] );
-				}
-				newContext = rsibling.test( selector ) && testContext( context.parentNode ) || context;
-				newSelector = groups.join(",");
-			}
-
-			if ( newSelector ) {
-				try {
-					push.apply( results,
-						newContext.querySelectorAll( newSelector )
-					);
-					return results;
-				} catch(qsaError) {
-				} finally {
-					if ( !old ) {
-						context.removeAttribute("id");
-					}
-				}
-			}
-		}
-	}
-
-	// All others
-	return select( selector.replace( rtrim, "$1" ), context, results, seed );
-}
-
-/**
- * Create key-value caches of limited size
- * @returns {Function(string, Object)} Returns the Object data after storing it on itself with
- *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
- *	deleting the oldest entry
- */
-function createCache() {
-	var keys = [];
-
-	function cache( key, value ) {
-		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
-		if ( keys.push( key + " " ) > Expr.cacheLength ) {
-			// Only keep the most recent entries
-			delete cache[ keys.shift() ];
-		}
-		return (cache[ key + " " ] = value);
-	}
-	return cache;
-}
-
-/**
- * Mark a function for special use by Sizzle
- * @param {Function} fn The function to mark
- */
-function markFunction( fn ) {
-	fn[ expando ] = true;
-	return fn;
-}
-
-/**
- * Support testing using an element
- * @param {Function} fn Passed the created div and expects a boolean result
- */
-function assert( fn ) {
-	var div = document.createElement("div");
-
-	try {
-		return !!fn( div );
-	} catch (e) {
-		return false;
-	} finally {
-		// Remove from its parent by default
-		if ( div.parentNode ) {
-			div.parentNode.removeChild( div );
-		}
-		// release memory in IE
-		div = null;
-	}
-}
-
-/**
- * Adds the same handler for all of the specified attrs
- * @param {String} attrs Pipe-separated list of attributes
- * @param {Function} handler The method that will be applied
- */
-function addHandle( attrs, handler ) {
-	var arr = attrs.split("|"),
-		i = attrs.length;
-
-	while ( i-- ) {
-		Expr.attrHandle[ arr[i] ] = handler;
-	}
-}
-
-/**
- * Checks document order of two siblings
- * @param {Element} a
- * @param {Element} b
- * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
- */
-function siblingCheck( a, b ) {
-	var cur = b && a,
-		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
-			( ~b.sourceIndex || MAX_NEGATIVE ) -
-			( ~a.sourceIndex || MAX_NEGATIVE );
-
-	// Use IE sourceIndex if available on both nodes
-	if ( diff ) {
-		return diff;
-	}
-
-	// Check if b follows a
-	if ( cur ) {
-		while ( (cur = cur.nextSibling) ) {
-			if ( cur === b ) {
-				return -1;
-			}
-		}
-	}
-
-	return a ? 1 : -1;
-}
-
-/**
- * Returns a function to use in pseudos for input types
- * @param {String} type
- */
-function createInputPseudo( type ) {
-	return function( elem ) {
-		var name = elem.nodeName.toLowerCase();
-		return name === "input" && elem.type === type;
-	};
-}
-
-/**
- * Returns a function to use in pseudos for buttons
- * @param {String} type
- */
-function createButtonPseudo( type ) {
-	return function( elem ) {
-		var name = elem.nodeName.toLowerCase();
-		return (name === "input" || name === "button") && elem.type === type;
-	};
-}
-
-/**
- * Returns a function to use in pseudos for positionals
- * @param {Function} fn
- */
-function createPositionalPseudo( fn ) {
-	return markFunction(function( argument ) {
-		argument = +argument;
-		return markFunction(function( seed, matches ) {
-			var j,
-				matchIndexes = fn( [], seed.length, argument ),
-				i = matchIndexes.length;
-
-			// Match elements found at the specified indexes
-			while ( i-- ) {
-				if ( seed[ (j = matchIndexes[i]) ] ) {
-					seed[j] = !(matches[j] = seed[j]);
-				}
-			}
-		});
-	});
-}
-
-/**
- * Checks a node for validity as a Sizzle context
- * @param {Element|Object=} context
- * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
- */
-function testContext( context ) {
-	return context && typeof context.getElementsByTagName !== strundefined && context;
-}
-
-// Expose support vars for convenience
-support = Sizzle.support = {};
-
-/**
- * Detects XML nodes
- * @param {Element|Object} elem An element or a document
- * @returns {Boolean} True iff elem is a non-HTML XML node
- */
-isXML = Sizzle.isXML = function( elem ) {
-	// documentElement is verified for cases where it doesn't yet exist
-	// (such as loading iframes in IE - #4833)
-	var documentElement = elem && (elem.ownerDocument || elem).documentElement;
-	return documentElement ? documentElement.nodeName !== "HTML" : false;
-};
-
-/**
- * Sets document-related variables once based on the current document
- * @param {Element|Object} [doc] An element or document object to use to set the document
- * @returns {Object} Returns the current document
- */
-setDocument = Sizzle.setDocument = function( node ) {
-	var hasCompare,
-		doc = node ? node.ownerDocument || node : preferredDoc,
-		parent = doc.defaultView;
-
-	// If no document and documentElement is available, return
-	if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) {
-		return document;
-	}
-
-	// Set our document
-	document = doc;
-	docElem = doc.documentElement;
-
-	// Support tests
-	documentIsHTML = !isXML( doc );
-
-	// Support: IE>8
-	// If iframe document is assigned to "document" variable and if iframe has been reloaded,
-	// IE will throw "permission denied" error when accessing "document" variable, see jQuery #13936
-	// IE6-8 do not support the defaultView property so parent will be undefined
-	if ( parent && parent !== parent.top ) {
-		// IE11 does not have attachEvent, so all must suffer
-		if ( parent.addEventListener ) {
-			parent.addEventListener( "unload", function() {
-				setDocument();
-			}, false );
-		} else if ( parent.attachEvent ) {
-			parent.attachEvent( "onunload", function() {
-				setDocument();
-			});
-		}
-	}
-
-	/* Attributes
-	---------------------------------------------------------------------- */
-
-	// Support: IE<8
-	// Verify that getAttribute really returns attributes and not properties (excepting IE8 booleans)
-	support.attributes = assert(function( div ) {
-		div.className = "i";
-		return !div.getAttribute("className");
-	});
-
-	/* getElement(s)By*
-	---------------------------------------------------------------------- */
-
-	// Check if getElementsByTagName("*") returns only elements
-	support.getElementsByTagName = assert(function( div ) {
-		div.appendChild( doc.createComment("") );
-		return !div.getElementsByTagName("*").length;
-	});
-
-	// Check if getElementsByClassName can be trusted
-	support.getElementsByClassName = rnative.test( doc.getElementsByClassName ) && assert(function( div ) {
-		div.innerHTML = "<div class='a'></div><div class='a i'></div>";
-
-		// Support: Safari<4
-		// Catch class over-caching
-		div.firstChild.className = "i";
-		// Support: Opera<10
-		// Catch gEBCN failure to find non-leading classes
-		return div.getElementsByClassName("i").length === 2;
-	});
-
-	// Support: IE<10
-	// Check if getElementById returns elements by name
-	// The broken getElementById methods don't pick up programatically-set names,
-	// so use a roundabout getElementsByName test
-	support.getById = assert(function( div ) {
-		docElem.appendChild( div ).id = expando;
-		return !doc.getElementsByName || !doc.getElementsByName( expando ).length;
-	});
-
-	// ID find and filter
-	if ( support.getById ) {
-		Expr.find["ID"] = function( id, context ) {
-			if ( typeof context.getElementById !== strundefined && documentIsHTML ) {
-				var m = context.getElementById( id );
-				// Check parentNode to catch when Blackberry 4.6 returns
-				// nodes that are no longer in the document #6963
-				return m && m.parentNode ? [ m ] : [];
-			}
-		};
-		Expr.filter["ID"] = function( id ) {
-			var attrId = id.replace( runescape, funescape );
-			return function( elem ) {
-				return elem.getAttribute("id") === attrId;
-			};
-		};
-	} else {
-		// Support: IE6/7
-		// getElementById is not reliable as a find shortcut
-		delete Expr.find["ID"];
-
-		Expr.filter["ID"] =  function( id ) {
-			var attrId = id.replace( runescape, funescape );
-			return function( elem ) {
-				var node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode("id");
-				return node && node.value === attrId;
-			};
-		};
-	}
-
-	// Tag
-	Expr.find["TAG"] = support.getElementsByTagName ?
-		function( tag, context ) {
-			if ( typeof context.getElementsByTagName !== strundefined ) {
-				return context.getElementsByTagName( tag );
-			}
-		} :
-		function( tag, context ) {
-			var elem,
-				tmp = [],
-				i = 0,
-				results = context.getElementsByTagName( tag );
-
-			// Filter out possible comments
-			if ( tag === "*" ) {
-				while ( (elem = results[i++]) ) {
-					if ( elem.nodeType === 1 ) {
-						tmp.push( elem );
-					}
-				}
-
-				return tmp;
-			}
-			return results;
-		};
-
-	// Class
-	Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) {
-		if ( typeof context.getElementsByClassName !== strundefined && documentIsHTML ) {
-			return context.getElementsByClassName( className );
-		}
-	};
-
-	/* QSA/matchesSelector
-	---------------------------------------------------------------------- */
-
-	// QSA and matchesSelector support
-
-	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
-	rbuggyMatches = [];
-
-	// qSa(:focus) reports false when true (Chrome 21)
-	// We allow this because of a bug in IE8/9 that throws an error
-	// whenever `document.activeElement` is accessed on an iframe
-	// So, we allow :focus to pass through QSA all the time to avoid the IE error
-	// See http://bugs.jquery.com/ticket/13378
-	rbuggyQSA = [];
-
-	if ( (support.qsa = rnative.test( doc.querySelectorAll )) ) {
-		// Build QSA regex
-		// Regex strategy adopted from Diego Perini
-		assert(function( div ) {
-			// Select is set to empty string on purpose
-			// This is to test IE's treatment of not explicitly
-			// setting a boolean content attribute,
-			// since its presence should be enough
-			// http://bugs.jquery.com/ticket/12359
-			div.innerHTML = "<select msallowclip=''><option selected=''></option></select>";
-
-			// Support: IE8, Opera 11-12.16
-			// Nothing should be selected when empty strings follow ^= or $= or *=
-			// The test attribute must be unknown in Opera but "safe" for WinRT
-			// http://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
-			if ( div.querySelectorAll("[msallowclip^='']").length ) {
-				rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" );
-			}
-
-			// Support: IE8
-			// Boolean attributes and "value" are not treated correctly
-			if ( !div.querySelectorAll("[selected]").length ) {
-				rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" );
-			}
-
-			// Webkit/Opera - :checked should return selected option elements
-			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
-			// IE8 throws error here and will not see later tests
-			if ( !div.querySelectorAll(":checked").length ) {
-				rbuggyQSA.push(":checked");
-			}
-		});
-
-		assert(function( div ) {
-			// Support: Windows 8 Native Apps
-			// The type and name attributes are restricted during .innerHTML assignment
-			var input = doc.createElement("input");
-			input.setAttribute( "type", "hidden" );
-			div.appendChild( input ).setAttribute( "name", "D" );
-
-			// Support: IE8
-			// Enforce case-sensitivity of name attribute
-			if ( div.querySelectorAll("[name=d]").length ) {
-				rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" );
-			}
-
-			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
-			// IE8 throws error here and will not see later tests
-			if ( !div.querySelectorAll(":enabled").length ) {
-				rbuggyQSA.push( ":enabled", ":disabled" );
-			}
-
-			// Opera 10-11 does not throw on post-comma invalid pseudos
-			div.querySelectorAll("*,:x");
-			rbuggyQSA.push(",.*:");
-		});
-	}
-
-	if ( (support.matchesSelector = rnative.test( (matches = docElem.matches ||
-		docElem.webkitMatchesSelector ||
-		docElem.mozMatchesSelector ||
-		docElem.oMatchesSelector ||
-		docElem.msMatchesSelector) )) ) {
-
-		assert(function( div ) {
-			// Check to see if it's possible to do matchesSelector
-			// on a disconnected node (IE 9)
-			support.disconnectedMatch = matches.call( div, "div" );
-
-			// This should fail with an exception
-			// Gecko does not error, returns false instead
-			matches.call( div, "[s!='']:x" );
-			rbuggyMatches.push( "!=", pseudos );
-		});
-	}
-
-	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") );
-	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") );
-
-	/* Contains
-	---------------------------------------------------------------------- */
-	hasCompare = rnative.test( docElem.compareDocumentPosition );
-
-	// Element contains another
-	// Purposefully does not implement inclusive descendent
-	// As in, an element does not contain itself
-	contains = hasCompare || rnative.test( docElem.contains ) ?
-		function( a, b ) {
-			var adown = a.nodeType === 9 ? a.documentElement : a,
-				bup = b && b.parentNode;
-			return a === bup || !!( bup && bup.nodeType === 1 && (
-				adown.contains ?
-					adown.contains( bup ) :
-					a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16
-			));
-		} :
-		function( a, b ) {
-			if ( b ) {
-				while ( (b = b.parentNode) ) {
-					if ( b === a ) {
-						return true;
-					}
-				}
-			}
-			return false;
-		};
-
-	/* Sorting
-	---------------------------------------------------------------------- */
-
-	// Document order sorting
-	sortOrder = hasCompare ?
-	function( a, b ) {
-
-		// Flag for duplicate removal
-		if ( a === b ) {
-			hasDuplicate = true;
-			return 0;
-		}
-
-		// Sort on method existence if only one input has compareDocumentPosition
-		var compare = !a.compareDocumentPosition - !b.compareDocumentPosition;
-		if ( compare ) {
-			return compare;
-		}
-
-		// Calculate position if both inputs belong to the same document
-		compare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ?
-			a.compareDocumentPosition( b ) :
-
-			// Otherwise we know they are disconnected
-			1;
-
-		// Disconnected nodes
-		if ( compare & 1 ||
-			(!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) {
-
-			// Choose the first element that is related to our preferred document
-			if ( a === doc || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) {
-				return -1;
-			}
-			if ( b === doc || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) {
-				return 1;
-			}
-
-			// Maintain original order
-			return sortInput ?
-				( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) :
-				0;
-		}
-
-		return compare & 4 ? -1 : 1;
-	} :
-	function( a, b ) {
-		// Exit early if the nodes are identical
-		if ( a === b ) {
-			hasDuplicate = true;
-			return 0;
-		}
-
-		var cur,
-			i = 0,
-			aup = a.parentNode,
-			bup = b.parentNode,
-			ap = [ a ],
-			bp = [ b ];
-
-		// Parentless nodes are either documents or disconnected
-		if ( !aup || !bup ) {
-			return a === doc ? -1 :
-				b === doc ? 1 :
-				aup ? -1 :
-				bup ? 1 :
-				sortInput ?
-				( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) :
-				0;
-
-		// If the nodes are siblings, we can do a quick check
-		} else if ( aup === bup ) {
-			return siblingCheck( a, b );
-		}
-
-		// Otherwise we need full lists of their ancestors for comparison
-		cur = a;
-		while ( (cur = cur.parentNode) ) {
-			ap.unshift( cur );
-		}
-		cur = b;
-		while ( (cur = cur.parentNode) ) {
-			bp.unshift( cur );
-		}
-
-		// Walk down the tree looking for a discrepancy
-		while ( ap[i] === bp[i] ) {
-			i++;
-		}
-
-		return i ?
-			// Do a sibling check if the nodes have a common ancestor
-			siblingCheck( ap[i], bp[i] ) :
-
-			// Otherwise nodes in our document sort first
-			ap[i] === preferredDoc ? -1 :
-			bp[i] === preferredDoc ? 1 :
-			0;
-	};
-
-	return doc;
-};
-
-Sizzle.matches = function( expr, elements ) {
-	return Sizzle( expr, null, null, elements );
-};
-
-Sizzle.matchesSelector = function( elem, expr ) {
-	// Set document vars if needed
-	if ( ( elem.ownerDocument || elem ) !== document ) {
-		setDocument( elem );
-	}
-
-	// Make sure that attribute selectors are quoted
-	expr = expr.replace( rattributeQuotes, "='$1']" );
-
-	if ( support.matchesSelector && documentIsHTML &&
-		( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&
-		( !rbuggyQSA     || !rbuggyQSA.test( expr ) ) ) {
-
-		try {
-			var ret = matches.call( elem, expr );
-
-			// IE 9's matchesSelector returns false on disconnected nodes
-			if ( ret || support.disconnectedMatch ||
-					// As well, disconnected nodes are said to be in a document
-					// fragment in IE 9
-					elem.document && elem.document.nodeType !== 11 ) {
-				return ret;
-			}
-		} catch(e) {}
-	}
-
-	return Sizzle( expr, document, null, [ elem ] ).length > 0;
-};
-
-Sizzle.contains = function( context, elem ) {
-	// Set document vars if needed
-	if ( ( context.ownerDocument || context ) !== document ) {
-		setDocument( context );
-	}
-	return contains( context, elem );
-};
-
-Sizzle.attr = function( elem, name ) {
-	// Set document vars if needed
-	if ( ( elem.ownerDocument || elem ) !== document ) {
-		setDocument( elem );
-	}
-
-	var fn = Expr.attrHandle[ name.toLowerCase() ],
-		// Don't get fooled by Object.prototype properties (jQuery #13807)
-		val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?
-			fn( elem, name, !documentIsHTML ) :
-			undefined;
-
-	return val !== undefined ?
-		val :
-		support.attributes || !documentIsHTML ?
-			elem.getAttribute( name ) :
-			(val = elem.getAttributeNode(name)) && val.specified ?
-				val.value :
-				null;
-};
-
-Sizzle.error = function( msg ) {
-	throw new Error( "Syntax error, unrecognized expression: " + msg );
-};
-
-/**
- * Document sorting and removing duplicates
- * @param {ArrayLike} results
- */
-Sizzle.uniqueSort = function( results ) {
-	var elem,
-		duplicates = [],
-		j = 0,
-		i = 0;
-
-	// Unless we *know* we can detect duplicates, assume their presence
-	hasDuplicate = !support.detectDuplicates;
-	sortInput = !support.sortStable && results.slice( 0 );
-	results.sort( sortOrder );
-
-	if ( hasDuplicate ) {
-		while ( (elem = results[i++]) ) {
-			if ( elem === results[ i ] ) {
-				j = duplicates.push( i );
-			}
-		}
-		while ( j-- ) {
-			results.splice( duplicates[ j ], 1 );
-		}
-	}
-
-	// Clear input after sorting to release objects
-	// See https://github.com/jquery/sizzle/pull/225
-	sortInput = null;
-
-	return results;
-};
-
-/**
- * Utility function for retrieving the text value of an array of DOM nodes
- * @param {Array|Element} elem
- */
-getText = Sizzle.getText = function( elem ) {
-	var node,
-		ret = "",
-		i = 0,
-		nodeType = elem.nodeType;
-
-	if ( !nodeType ) {
-		// If no nodeType, this is expected to be an array
-		while ( (node = elem[i++]) ) {
-			// Do not traverse comment nodes
-			ret += getText( node );
-		}
-	} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
-		// Use textContent for elements
-		// innerText usage removed for consistency of new lines (jQuery #11153)
-		if ( typeof elem.textContent === "string" ) {
-			return elem.textContent;
-		} else {
-			// Traverse its children
-			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
-				ret += getText( elem );
-			}
-		}
-	} else if ( nodeType === 3 || nodeType === 4 ) {
-		return elem.nodeValue;
-	}
-	// Do not include comment or processing instruction nodes
-
-	return ret;
-};
-
-Expr = Sizzle.selectors = {
-
-	// Can be adjusted by the user
-	cacheLength: 50,
-
-	createPseudo: markFunction,
-
-	match: matchExpr,
-
-	attrHandle: {},
-
-	find: {},
-
-	relative: {
-		">": { dir: "parentNode", first: true },
-		" ": { dir: "parentNode" },
-		"+": { dir: "previousSibling", first: true },
-		"~": { dir: "previousSibling" }
-	},
-
-	preFilter: {
-		"ATTR": function( match ) {
-			match[1] = match[1].replace( runescape, funescape );
-
-			// Move the given value to match[3] whether quoted or unquoted
-			match[3] = ( match[3] || match[4] || match[5] || "" ).replace( runescape, funescape );
-
-			if ( match[2] === "~=" ) {
-				match[3] = " " + match[3] + " ";
-			}
-
-			return match.slice( 0, 4 );
-		},
-
-		"CHILD": function( match ) {
-			/* matches from matchExpr["CHILD"]
-				1 type (only|nth|...)
-				2 what (child|of-type)
-				3 argument (even|odd|\d*|\d*n([+-]\d+)?|...)
-				4 xn-component of xn+y argument ([+-]?\d*n|)
-				5 sign of xn-component
-				6 x of xn-component
-				7 sign of y-component
-				8 y of y-component
-			*/
-			match[1] = match[1].toLowerCase();
-
-			if ( match[1].slice( 0, 3 ) === "nth" ) {
-				// nth-* requires argument
-				if ( !match[3] ) {
-					Sizzle.error( match[0] );
-				}
-
-				// numeric x and y parameters for Expr.filter.CHILD
-				// remember that false/true cast respectively to 0/1
-				match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) );
-				match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" );
-
-			// other types prohibit arguments
-			} else if ( match[3] ) {
-				Sizzle.error( match[0] );
-			}
-
-			return match;
-		},
-
-		"PSEUDO": function( match ) {
-			var excess,
-				unquoted = !match[6] && match[2];
-
-			if ( matchExpr["CHILD"].test( match[0] ) ) {
-				return null;
-			}
-
-			// Accept quoted arguments as-is
-			if ( match[3] ) {
-				match[2] = match[4] || match[5] || "";
-
-			// Strip excess characters from unquoted arguments
-			} else if ( unquoted && rpseudo.test( unquoted ) &&
-				// Get excess from tokenize (recursively)
-				(excess = tokenize( unquoted, true )) &&
-				// advance to the next closing parenthesis
-				(excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) {
-
-				// excess is a negative index
-				match[0] = match[0].slice( 0, excess );
-				match[2] = unquoted.slice( 0, excess );
-			}
-
-			// Return only captures needed by the pseudo filter method (type and argument)
-			return match.slice( 0, 3 );
-		}
-	},
-
-	filter: {
-
-		"TAG": function( nodeNameSelector ) {
-			var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();
-			return nodeNameSelector === "*" ?
-				function() { return true; } :
-				function( elem ) {
-					return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
-				};
-		},
-
-		"CLASS": function( className ) {
-			var pattern = classCache[ className + " " ];
-
-			return pattern ||
-				(pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) &&
-				classCache( className, function( elem ) {
-					return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== strundefined && elem.getAttribute("class") || "" );
-				});
-		},
-
-		"ATTR": function( name, operator, check ) {
-			return function( elem ) {
-				var result = Sizzle.attr( elem, name );
-
-				if ( result == null ) {
-					return operator === "!=";
-				}
-				if ( !operator ) {
-					return true;
-				}
-
-				result += "";
-
-				return operator === "=" ? result === check :
-					operator === "!=" ? result !== check :
-					operator === "^=" ? check && result.indexOf( check ) === 0 :
-					operator === "*=" ? check && result.indexOf( check ) > -1 :
-					operator === "$=" ? check && result.slice( -check.length ) === check :
-					operator === "~=" ? ( " " + result + " " ).indexOf( check ) > -1 :
-					operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" :
-					false;
-			};
-		},
-
-		"CHILD": function( type, what, argument, first, last ) {
-			var simple = type.slice( 0, 3 ) !== "nth",
-				forward = type.slice( -4 ) !== "last",
-				ofType = what === "of-type";
-
-			return first === 1 && last === 0 ?
-
-				// Shortcut for :nth-*(n)
-				function( elem ) {
-					return !!elem.parentNode;
-				} :
-
-				function( elem, context, xml ) {
-					var cache, outerCache, node, diff, nodeIndex, start,
-						dir = simple !== forward ? "nextSibling" : "previousSibling",
-						parent = elem.parentNode,
-						name = ofType && elem.nodeName.toLowerCase(),
-						useCache = !xml && !ofType;
-
-					if ( parent ) {
-
-						// :(first|last|only)-(child|of-type)
-						if ( simple ) {
-							while ( dir ) {
-								node = elem;
-								while ( (node = node[ dir ]) ) {
-									if ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) {
-										return false;
-									}
-								}
-								// Reverse direction for :only-* (if we haven't yet done so)
-								start = dir = type === "only" && !start && "nextSibling";
-							}
-							return true;
-						}
-
-						start = [ forward ? parent.firstChild : parent.lastChild ];
-
-						// non-xml :nth-child(...) stores cache data on `parent`
-						if ( forward && useCache ) {
-							// Seek `elem` from a previously-cached index
-							outerCache = parent[ expando ] || (parent[ expando ] = {});
-							cache = outerCache[ type ] || [];
-							nodeIndex = cache[0] === dirruns && cache[1];
-							diff = cache[0] === dirruns && cache[2];
-							node = nodeIndex && parent.childNodes[ nodeIndex ];
-
-							while ( (node = ++nodeIndex && node && node[ dir ] ||
-
-								// Fallback to seeking `elem` from the start
-								(diff = nodeIndex = 0) || start.pop()) ) {
-
-								// When found, cache indexes on `parent` and break
-								if ( node.nodeType === 1 && ++diff && node === elem ) {
-									outerCache[ type ] = [ dirruns, nodeIndex, diff ];
-									break;
-								}
-							}
-
-						// Use previously-cached element index if available
-						} else if ( useCache && (cache = (elem[ expando ] || (elem[ expando ] = {}))[ type ]) && cache[0] === dirruns ) {
-							diff = cache[1];
-
-						// xml :nth-child(...) or :nth-last-child(...) or :nth(-last)?-of-type(...)
-						} else {
-							// Use the same loop as above to seek `elem` from the start
-							while ( (node = ++nodeIndex && node && node[ dir ] ||
-								(diff = nodeIndex = 0) || start.pop()) ) {
-
-								if ( ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) && ++diff ) {
-									// Cache the index of each encountered element
-									if ( useCache ) {
-										(node[ expando ] || (node[ expando ] = {}))[ type ] = [ dirruns, diff ];
-									}
-
-									if ( node === elem ) {
-										break;
-									}
-								}
-							}
-						}
-
-						// Incorporate the offset, then check against cycle size
-						diff -= last;
-						return diff === first || ( diff % first === 0 && diff / first >= 0 );
-					}
-				};
-		},
-
-		"PSEUDO": function( pseudo, argument ) {
-			// pseudo-class names are case-insensitive
-			// http://www.w3.org/TR/selectors/#pseudo-classes
-			// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters
-			// Remember that setFilters inherits from pseudos
-			var args,
-				fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||
-					Sizzle.error( "unsupported pseudo: " + pseudo );
-
-			// The user may use createPseudo to indicate that
-			// arguments are needed to create the filter function
-			// just as Sizzle does
-			if ( fn[ expando ] ) {
-				return fn( argument );
-			}
-
-			// But maintain support for old signatures
-			if ( fn.length > 1 ) {
-				args = [ pseudo, pseudo, "", argument ];
-				return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?
-					markFunction(function( seed, matches ) {
-						var idx,
-							matched = fn( seed, argument ),
-							i = matched.length;
-						while ( i-- ) {
-							idx = indexOf.call( seed, matched[i] );
-							seed[ idx ] = !( matches[ idx ] = matched[i] );
-						}
-					}) :
-					function( elem ) {
-						return fn( elem, 0, args );
-					};
-			}
-
-			return fn;
-		}
-	},
-
-	pseudos: {
-		// Potentially complex pseudos
-		"not": markFunction(function( selector ) {
-			// Trim the selector passed to compile
-			// to avoid treating leading and trailing
-			// spaces as combinators
-			var input = [],
-				results = [],
-				matcher = compile( selector.replace( rtrim, "$1" ) );
-
-			return matcher[ expando ] ?
-				markFunction(function( seed, matches, context, xml ) {
-					var elem,
-						unmatched = matcher( seed, null, xml, [] ),
-						i = seed.length;
-
-					// Match elements unmatched by `matcher`
-					while ( i-- ) {
-						if ( (elem = unmatched[i]) ) {
-							seed[i] = !(matches[i] = elem);
-						}
-					}
-				}) :
-				function( elem, context, xml ) {
-					input[0] = elem;
-					matcher( input, null, xml, results );
-					return !results.pop();
-				};
-		}),
-
-		"has": markFunction(function( selector ) {
-			return function( elem ) {
-				return Sizzle( selector, elem ).length > 0;
-			};
-		}),
-
-		"contains": markFunction(function( text ) {
-			return function( elem ) {
-				return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1;
-			};
-		}),
-
-		// "Whether an element is represented by a :lang() selector
-		// is based solely on the element's language value
-		// being equal to the identifier C,
-		// or beginning with the identifier C immediately followed by "-".
-		// The matching of C against the element's language value is performed case-insensitively.
-		// The identifier C does not have to be a valid language name."
-		// http://www.w3.org/TR/selectors/#lang-pseudo
-		"lang": markFunction( function( lang ) {
-			// lang value must be a valid identifier
-			if ( !ridentifier.test(lang || "") ) {
-				Sizzle.error( "unsupported lang: " + lang );
-			}
-			lang = lang.replace( runescape, funescape ).toLowerCase();
-			return function( elem ) {
-				var elemLang;
-				do {
-					if ( (elemLang = documentIsHTML ?
-						elem.lang :
-						elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) {
-
-						elemLang = elemLang.toLowerCase();
-						return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0;
-					}
-				} while ( (elem = elem.parentNode) && elem.nodeType === 1 );
-				return false;
-			};
-		}),
-
-		// Miscellaneous
-		"target": function( elem ) {
-			var hash = window.location && window.location.hash;
-			return hash && hash.slice( 1 ) === elem.id;
-		},
-
-		"root": function( elem ) {
-			return elem === docElem;
-		},
-
-		"focus": function( elem ) {
-			return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex);
-		},
-
-		// Boolean properties
-		"enabled": function( elem ) {
-			return elem.disabled === false;
-		},
-
-		"disabled": function( elem ) {
-			return elem.disabled === true;
-		},
-
-		"checked": function( elem ) {
-			// In CSS3, :checked should return both checked and selected elements
-			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
-			var nodeName = elem.nodeName.toLowerCase();
-			return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected);
-		},
-
-		"selected": function( elem ) {
-			// Accessing this property makes selected-by-default
-			// options in Safari work properly
-			if ( elem.parentNode ) {
-				elem.parentNode.selectedIndex;
-			}
-
-			return elem.selected === true;
-		},
-
-		// Contents
-		"empty": function( elem ) {
-			// http://www.w3.org/TR/selectors/#empty-pseudo
-			// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),
-			//   but not by others (comment: 8; processing instruction: 7; etc.)
-			// nodeType < 6 works because attributes (2) do not appear as children
-			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
-				if ( elem.nodeType < 6 ) {
-					return false;
-				}
-			}
-			return true;
-		},
-
-		"parent": function( elem ) {
-			return !Expr.pseudos["empty"]( elem );
-		},
-
-		// Element/input types
-		"header": function( elem ) {
-			return rheader.test( elem.nodeName );
-		},
-
-		"input": function( elem ) {
-			return rinputs.test( elem.nodeName );
-		},
-
-		"button": function( elem ) {
-			var name = elem.nodeName.toLowerCase();
-			return name === "input" && elem.type === "button" || name === "button";
-		},
-
-		"text": function( elem ) {
-			var attr;
-			return elem.nodeName.toLowerCase() === "input" &&
-				elem.type === "text" &&
-
-				// Support: IE<8
-				// New HTML5 attribute values (e.g., "search") appear with elem.type === "text"
-				( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === "text" );
-		},
-
-		// Position-in-collection
-		"first": createPositionalPseudo(function() {
-			return [ 0 ];
-		}),
-
-		"last": createPositionalPseudo(function( matchIndexes, length ) {
-			return [ length - 1 ];
-		}),
-
-		"eq": createPositionalPseudo(function( matchIndexes, length, argument ) {
-			return [ argument < 0 ? argument + length : argument ];
-		}),
-
-		"even": createPositionalPseudo(function( matchIndexes, length ) {
-			var i = 0;
-			for ( ; i < length; i += 2 ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		}),
-
-		"odd": createPositionalPseudo(function( matchIndexes, length ) {
-			var i = 1;
-			for ( ; i < length; i += 2 ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		}),
-
-		"lt": createPositionalPseudo(function( matchIndexes, length, argument ) {
-			var i = argument < 0 ? argument + length : argument;
-			for ( ; --i >= 0; ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		}),
-
-		"gt": createPositionalPseudo(function( matchIndexes, length, argument ) {
-			var i = argument < 0 ? argument + length : argument;
-			for ( ; ++i < length; ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		})
-	}
-};
-
-Expr.pseudos["nth"] = Expr.pseudos["eq"];
-
-// Add button/input type pseudos
-for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {
-	Expr.pseudos[ i ] = createInputPseudo( i );
-}
-for ( i in { submit: true, reset: true } ) {
-	Expr.pseudos[ i ] = createButtonPseudo( i );
-}
-
-// Easy API for creating new setFilters
-function setFilters() {}
-setFilters.prototype = Expr.filters = Expr.pseudos;
-Expr.setFilters = new setFilters();
-
-tokenize = Sizzle.tokenize = function( selector, parseOnly ) {
-	var matched, match, tokens, type,
-		soFar, groups, preFilters,
-		cached = tokenCache[ selector + " " ];
-
-	if ( cached ) {
-		return parseOnly ? 0 : cached.slice( 0 );
-	}
-
-	soFar = selector;
-	groups = [];
-	preFilters = Expr.preFilter;
-
-	while ( soFar ) {
-
-		// Comma and first run
-		if ( !matched || (match = rcomma.exec( soFar )) ) {
-			if ( match ) {
-				// Don't consume trailing commas as valid
-				soFar = soFar.slice( match[0].length ) || soFar;
-			}
-			groups.push( (tokens = []) );
-		}
-
-		matched = false;
-
-		// Combinators
-		if ( (match = rcombinators.exec( soFar )) ) {
-			matched = match.shift();
-			tokens.push({
-				value: matched,
-				// Cast descendant combinators to space
-				type: match[0].replace( rtrim, " " )
-			});
-			soFar = soFar.slice( matched.length );
-		}
-
-		// Filters
-		for ( type in Expr.filter ) {
-			if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] ||
-				(match = preFilters[ type ]( match ))) ) {
-				matched = match.shift();
-				tokens.push({
-					value: matched,
-					type: type,
-					matches: match
-				});
-				soFar = soFar.slice( matched.length );
-			}
-		}
-
-		if ( !matched ) {
-			break;
-		}
-	}
-
-	// Return the length of the invalid excess
-	// if we're just parsing
-	// Otherwise, throw an error or return tokens
-	return parseOnly ?
-		soFar.length :
-		soFar ?
-			Sizzle.error( selector ) :
-			// Cache the tokens
-			tokenCache( selector, groups ).slice( 0 );
-};
-
-function toSelector( tokens ) {
-	var i = 0,
-		len = tokens.length,
-		selector = "";
-	for ( ; i < len; i++ ) {
-		selector += tokens[i].value;
-	}
-	return selector;
-}
-
-function addCombinator( matcher, combinator, base ) {
-	var dir = combinator.dir,
-		checkNonElements = base && dir === "parentNode",
-		doneName = done++;
-
-	return combinator.first ?
-		// Check against closest ancestor/preceding element
-		function( elem, context, xml ) {
-			while ( (elem = elem[ dir ]) ) {
-				if ( elem.nodeType === 1 || checkNonElements ) {
-					return matcher( elem, context, xml );
-				}
-			}
-		} :
-
-		// Check against all ancestor/preceding elements
-		function( elem, context, xml ) {
-			var oldCache, outerCache,
-				newCache = [ dirruns, doneName ];
-
-			// We can't set arbitrary data on XML nodes, so they don't benefit from dir caching
-			if ( xml ) {
-				while ( (elem = elem[ dir ]) ) {
-					if ( elem.nodeType === 1 || checkNonElements ) {
-						if ( matcher( elem, context, xml ) ) {
-							return true;
-						}
-					}
-				}
-			} else {
-				while ( (elem = elem[ dir ]) ) {
-					if ( elem.nodeType === 1 || checkNonElements ) {
-						outerCache = elem[ expando ] || (elem[ expando ] = {});
-						if ( (oldCache = outerCache[ dir ]) &&
-							oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {
-
-							// Assign to newCache so results back-propagate to previous elements
-							return (newCache[ 2 ] = oldCache[ 2 ]);
-						} else {
-							// Reuse newcache so results back-propagate to previous elements
-							outerCache[ dir ] = newCache;
-
-							// A match means we're done; a fail means we have to keep checking
-							if ( (newCache[ 2 ] = matcher( elem, context, xml )) ) {
-								return true;
-							}
-						}
-					}
-				}
-			}
-		};
-}
-
-function elementMatcher( matchers ) {
-	return matchers.length > 1 ?
-		function( elem, context, xml ) {
-			var i = matchers.length;
-			while ( i-- ) {
-				if ( !matchers[i]( elem, context, xml ) ) {
-					return false;
-				}
-			}
-			return true;
-		} :
-		matchers[0];
-}
-
-function multipleContexts( selector, contexts, results ) {
-	var i = 0,
-		len = contexts.length;
-	for ( ; i < len; i++ ) {
-		Sizzle( selector, contexts[i], results );
-	}
-	return results;
-}
-
-function condense( unmatched, map, filter, context, xml ) {
-	var elem,
-		newUnmatched = [],
-		i = 0,
-		len = unmatched.length,
-		mapped = map != null;
-
-	for ( ; i < len; i++ ) {
-		if ( (elem = unmatched[i]) ) {
-			if ( !filter || filter( elem, context, xml ) ) {
-				newUnmatched.push( elem );
-				if ( mapped ) {
-					map.push( i );
-				}
-			}
-		}
-	}
-
-	return newUnmatched;
-}
-
-function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {
-	if ( postFilter && !postFilter[ expando ] ) {
-		postFilter = setMatcher( postFilter );
-	}
-	if ( postFinder && !postFinder[ expando ] ) {
-		postFinder = setMatcher( postFinder, postSelector );
-	}
-	return markFunction(function( seed, results, context, xml ) {
-		var temp, i, elem,
-			preMap = [],
-			postMap = [],
-			preexisting = results.length,
-
-			// Get initial elements from seed or context
-			elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ),
-
-			// Prefilter to get matcher input, preserving a map for seed-results synchronization
-			matcherIn = preFilter && ( seed || !selector ) ?
-				condense( elems, preMap, preFilter, context, xml ) :
-				elems,
-
-			matcherOut = matcher ?
-				// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
-				postFinder || ( seed ? preFilter : preexisting || postFilter ) ?
-
-					// ...intermediate processing is necessary
-					[] :
-
-					// ...otherwise use results directly
-					results :
-				matcherIn;
-
-		// Find primary matches
-		if ( matcher ) {
-			matcher( matcherIn, matcherOut, context, xml );
-		}
-
-		// Apply postFilter
-		if ( postFilter ) {
-			temp = condense( matcherOut, postMap );
-			postFilter( temp, [], context, xml );
-
-			// Un-match failing elements by moving them back to matcherIn
-			i = temp.length;
-			while ( i-- ) {
-				if ( (elem = temp[i]) ) {
-					matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem);
-				}
-			}
-		}
-
-		if ( seed ) {
-			if ( postFinder || preFilter ) {
-				if ( postFinder ) {
-					// Get the final matcherOut by condensing this intermediate into postFinder contexts
-					temp = [];
-					i = matcherOut.length;
-					while ( i-- ) {
-						if ( (elem = matcherOut[i]) ) {
-							// Restore matcherIn since elem is not yet a final match
-							temp.push( (matcherIn[i] = elem) );
-						}
-					}
-					postFinder( null, (matcherOut = []), temp, xml );
-				}
-
-				// Move matched elements from seed to results to keep them synchronized
-				i = matcherOut.length;
-				while ( i-- ) {
-					if ( (elem = matcherOut[i]) &&
-						(temp = postFinder ? indexOf.call( seed, elem ) : preMap[i]) > -1 ) {
-
-						seed[temp] = !(results[temp] = elem);
-					}
-				}
-			}
-
-		// Add elements to results, through postFinder if defined
-		} else {
-			matcherOut = condense(
-				matcherOut === results ?
-					matcherOut.splice( preexisting, matcherOut.length ) :
-					matcherOut
-			);
-			if ( postFinder ) {
-				postFinder( null, results, matcherOut, xml );
-			} else {
-				push.apply( results, matcherOut );
-			}
-		}
-	});
-}
-
-function matcherFromTokens( tokens ) {
-	var checkContext, matcher, j,
-		len = tokens.length,
-		leadingRelative = Expr.relative[ tokens[0].type ],
-		implicitRelative = leadingRelative || Expr.relative[" "],
-		i = leadingRelative ? 1 : 0,
-
-		// The foundational matcher ensures that elements are reachable from top-level context(s)
-		matchContext = addCombinator( function( elem ) {
-			return elem === checkContext;
-		}, implicitRelative, true ),
-		matchAnyContext = addCombinator( function( elem ) {
-			return indexOf.call( checkContext, elem ) > -1;
-		}, implicitRelative, true ),
-		matchers = [ function( elem, context, xml ) {
-			return ( !leadingRelative && ( xml || context !== outermostContext ) ) || (
-				(checkContext = context).nodeType ?
-					matchContext( elem, context, xml ) :
-					matchAnyContext( elem, context, xml ) );
-		} ];
-
-	for ( ; i < len; i++ ) {
-		if ( (matcher = Expr.relative[ tokens[i].type ]) ) {
-			matchers = [ addCombinator(elementMatcher( matchers ), matcher) ];
-		} else {
-			matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches );
-
-			// Return special upon seeing a positional matcher
-			if ( matcher[ expando ] ) {
-				// Find the next relative operator (if any) for proper handling
-				j = ++i;
-				for ( ; j < len; j++ ) {
-					if ( Expr.relative[ tokens[j].type ] ) {
-						break;
-					}
-				}
-				return setMatcher(
-					i > 1 && elementMatcher( matchers ),
-					i > 1 && toSelector(
-						// If the preceding token was a descendant combinator, insert an implicit any-element `*`
-						tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" })
-					).replace( rtrim, "$1" ),
-					matcher,
-					i < j && matcherFromTokens( tokens.slice( i, j ) ),
-					j < len && matcherFromTokens( (tokens = tokens.slice( j )) ),
-					j < len && toSelector( tokens )
-				);
-			}
-			matchers.push( matcher );
-		}
-	}
-
-	return elementMatcher( matchers );
-}
-
-function matcherFromGroupMatchers( elementMatchers, setMatchers ) {
-	var bySet = setMatchers.length > 0,
-		byElement = elementMatchers.length > 0,
-		superMatcher = function( seed, context, xml, results, outermost ) {
-			var elem, j, matcher,
-				matchedCount = 0,
-				i = "0",
-				unmatched = seed && [],
-				setMatched = [],
-				contextBackup = outermostContext,
-				// We must always have either seed elements or outermost context
-				elems = seed || byElement && Expr.find["TAG"]( "*", outermost ),
-				// Use integer dirruns iff this is the outermost matcher
-				dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1),
-				len = elems.length;
-
-			if ( outermost ) {
-				outermostContext = context !== document && context;
-			}
-
-			// Add elements passing elementMatchers directly to results
-			// Keep `i` a string if there are no elements so `matchedCount` will be "00" below
-			// Support: IE<9, Safari
-			// Tolerate NodeList properties (IE: "length"; Safari: <number>) matching elements by id
-			for ( ; i !== len && (elem = elems[i]) != null; i++ ) {
-				if ( byElement && elem ) {
-					j = 0;
-					while ( (matcher = elementMatchers[j++]) ) {
-						if ( matcher( elem, context, xml ) ) {
-							results.push( elem );
-							break;
-						}
-					}
-					if ( outermost ) {
-						dirruns = dirrunsUnique;
-					}
-				}
-
-				// Track unmatched elements for set filters
-				if ( bySet ) {
-					// They will have gone through all possible matchers
-					if ( (elem = !matcher && elem) ) {
-						matchedCount--;
-					}
-
-					// Lengthen the array for every element, matched or not
-					if ( seed ) {
-						unmatched.push( elem );
-					}
-				}
-			}
-
-			// Apply set filters to unmatched elements
-			matchedCount += i;
-			if ( bySet && i !== matchedCount ) {
-				j = 0;
-				while ( (matcher = setMatchers[j++]) ) {
-					matcher( unmatched, setMatched, context, xml );
-				}
-
-				if ( seed ) {
-					// Reintegrate element matches to eliminate the need for sorting
-					if ( matchedCount > 0 ) {
-						while ( i-- ) {
-							if ( !(unmatched[i] || setMatched[i]) ) {
-								setMatched[i] = pop.call( results );
-							}
-						}
-					}
-
-					// Discard index placeholder values to get only actual matches
-					setMatched = condense( setMatched );
-				}
-
-				// Add matches to results
-				push.apply( results, setMatched );
-
-				// Seedless set matches succeeding multiple successful matchers stipulate sorting
-				if ( outermost && !seed && setMatched.length > 0 &&
-					( matchedCount + setMatchers.length ) > 1 ) {
-
-					Sizzle.uniqueSort( results );
-				}
-			}
-
-			// Override manipulation of globals by nested matchers
-			if ( outermost ) {
-				dirruns = dirrunsUnique;
-				outermostContext = contextBackup;
-			}
-
-			return unmatched;
-		};
-
-	return bySet ?
-		markFunction( superMatcher ) :
-		superMatcher;
-}
-
-compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {
-	var i,
-		setMatchers = [],
-		elementMatchers = [],
-		cached = compilerCache[ selector + " " ];
-
-	if ( !cached ) {
-		// Generate a function of recursive functions that can be used to check each element
-		if ( !match ) {
-			match = tokenize( selector );
-		}
-		i = match.length;
-		while ( i-- ) {
-			cached = matcherFromTokens( match[i] );
-			if ( cached[ expando ] ) {
-				setMatchers.push( cached );
-			} else {
-				elementMatchers.push( cached );
-			}
-		}
-
-		// Cache the compiled function
-		cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) );
-
-		// Save selector and tokenization
-		cached.selector = selector;
-	}
-	return cached;
-};
-
-/**
- * A low-level selection function that works with Sizzle's compiled
- *  selector functions
- * @param {String|Function} selector A selector or a pre-compiled
- *  selector function built with Sizzle.compile
- * @param {Element} context
- * @param {Array} [results]
- * @param {Array} [seed] A set of elements to match against
- */
-select = Sizzle.select = function( selector, context, results, seed ) {
-	var i, tokens, token, type, find,
-		compiled = typeof selector === "function" && selector,
-		match = !seed && tokenize( (selector = compiled.selector || selector) );
-
-	results = results || [];
-
-	// Try to minimize operations if there is no seed and only one group
-	if ( match.length === 1 ) {
-
-		// Take a shortcut and set the context if the root selector is an ID
-		tokens = match[0] = match[0].slice( 0 );
-		if ( tokens.length > 2 && (token = tokens[0]).type === "ID" &&
-				support.getById && context.nodeType === 9 && documentIsHTML &&
-				Expr.relative[ tokens[1].type ] ) {
-
-			context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0];
-			if ( !context ) {
-				return results;
-
-			// Precompiled matchers will still verify ancestry, so step up a level
-			} else if ( compiled ) {
-				context = context.parentNode;
-			}
-
-			selector = selector.slice( tokens.shift().value.length );
-		}
-
-		// Fetch a seed set for right-to-left matching
-		i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length;
-		while ( i-- ) {
-			token = tokens[i];
-
-			// Abort if we hit a combinator
-			if ( Expr.relative[ (type = token.type) ] ) {
-				break;
-			}
-			if ( (find = Expr.find[ type ]) ) {
-				// Search, expanding context for leading sibling combinators
-				if ( (seed = find(
-					token.matches[0].replace( runescape, funescape ),
-					rsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context
-				)) ) {
-
-					// If seed is empty or no tokens remain, we can return early
-					tokens.splice( i, 1 );
-					selector = seed.length && toSelector( tokens );
-					if ( !selector ) {
-						push.apply( results, seed );
-						return results;
-					}
-
-					break;
-				}
-			}
-		}
-	}
-
-	// Compile and execute a filtering function if one is not provided
-	// Provide `match` to avoid retokenization if we modified the selector above
-	( compiled || compile( selector, match ) )(
-		seed,
-		context,
-		!documentIsHTML,
-		results,
-		rsibling.test( selector ) && testContext( context.parentNode ) || context
-	);
-	return results;
-};
-
-// One-time assignments
-
-// Sort stability
-support.sortStable = expando.split("").sort( sortOrder ).join("") === expando;
-
-// Support: Chrome<14
-// Always assume duplicates if they aren't passed to the comparison function
-support.detectDuplicates = !!hasDuplicate;
-
-// Initialize against the default document
-setDocument();
-
-// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)
-// Detached nodes confoundingly follow *each other*
-support.sortDetached = assert(function( div1 ) {
-	// Should return 1, but returns 4 (following)
-	return div1.compareDocumentPosition( document.createElement("div") ) & 1;
-});
-
-// Support: IE<8
-// Prevent attribute/property "interpolation"
-// http://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
-if ( !assert(function( div ) {
-	div.innerHTML = "<a href='#'></a>";
-	return div.firstChild.getAttribute("href") === "#" ;
-}) ) {
-	addHandle( "type|href|height|width", function( elem, name, isXML ) {
-		if ( !isXML ) {
-			return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 );
-		}
-	});
-}
-
-// Support: IE<9
-// Use defaultValue in place of getAttribute("value")
-if ( !support.attributes || !assert(function( div ) {
-	div.innerHTML = "<input/>";
-	div.firstChild.setAttribute( "value", "" );
-	return div.firstChild.getAttribute( "value" ) === "";
-}) ) {
-	addHandle( "value", function( elem, name, isXML ) {
-		if ( !isXML && elem.nodeName.toLowerCase() === "input" ) {
-			return elem.defaultValue;
-		}
-	});
-}
-
-// Support: IE<9
-// Use getAttributeNode to fetch booleans when getAttribute lies
-if ( !assert(function( div ) {
-	return div.getAttribute("disabled") == null;
-}) ) {
-	addHandle( booleans, function( elem, name, isXML ) {
-		var val;
-		if ( !isXML ) {
-			return elem[ name ] === true ? name.toLowerCase() :
-					(val = elem.getAttributeNode( name )) && val.specified ?
-					val.value :
-				null;
-		}
-	});
-}
-
-return Sizzle;
-
-})( window );
-
-
-
-jQuery.find = Sizzle;
-jQuery.expr = Sizzle.selectors;
-jQuery.expr[":"] = jQuery.expr.pseudos;
-jQuery.unique = Sizzle.uniqueSort;
-jQuery.text = Sizzle.getText;
-jQuery.isXMLDoc = Sizzle.isXML;
-jQuery.contains = Sizzle.contains;
-
-
-
-var rneedsContext = jQuery.expr.match.needsContext;
-
-var rsingleTag = (/^<(\w+)\s*\/?>(?:<\/\1>|)$/);
-
-
-
-var risSimple = /^.[^:#\[\.,]*$/;
-
-// Implement the identical functionality for filter and not
-function winnow( elements, qualifier, not ) {
-	if ( jQuery.isFunction( qualifier ) ) {
-		return jQuery.grep( elements, function( elem, i ) {
-			/* jshint -W018 */
-			return !!qualifier.call( elem, i, elem ) !== not;
-		});
-
-	}
-
-	if ( qualifier.nodeType ) {
-		return jQuery.grep( elements, function( elem ) {
-			return ( elem === qualifier ) !== not;
-		});
-
-	}
-
-	if ( typeof qualifier === "string" ) {
-		if ( risSimple.test( qualifier ) ) {
-			return jQuery.filter( qualifier, elements, not );
-		}
-
-		qualifier = jQuery.filter( qualifier, elements );
-	}
-
-	return jQuery.grep( elements, function( elem ) {
-		return ( jQuery.inArray( elem, qualifier ) >= 0 ) !== not;
-	});
-}
-
-jQuery.filter = function( expr, elems, not ) {
-	var elem = elems[ 0 ];
-
-	if ( not ) {
-		expr = ":not(" + expr + ")";
-	}
-
-	return elems.length === 1 && elem.nodeType === 1 ?
-		jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [] :
-		jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {
-			return elem.nodeType === 1;
-		}));
-};
-
-jQuery.fn.extend({
-	find: function( selector ) {
-		var i,
-			ret = [],
-			self = this,
-			len = self.length;
-
-		if ( typeof selector !== "string" ) {
-			return this.pushStack( jQuery( selector ).filter(function() {
-				for ( i = 0; i < len; i++ ) {
-					if ( jQuery.contains( self[ i ], this ) ) {
-						return true;
-					}
-				}
-			}) );
-		}
-
-		for ( i = 0; i < len; i++ ) {
-			jQuery.find( selector, self[ i ], ret );
-		}
-
-		// Needed because $( selector, context ) becomes $( context ).find( selector )
-		ret = this.pushStack( len > 1 ? jQuery.unique( ret ) : ret );
-		ret.selector = this.selector ? this.selector + " " + selector : selector;
-		return ret;
-	},
-	filter: function( selector ) {
-		return this.pushStack( winnow(this, selector || [], false) );
-	},
-	not: function( selector ) {
-		return this.pushStack( winnow(this, selector || [], true) );
-	},
-	is: function( selector ) {
-		return !!winnow(
-			this,
-
-			// If this is a positional/relative selector, check membership in the returned set
-			// so $("p:first").is("p:last") won't return true for a doc with two "p".
-			typeof selector === "string" && rneedsContext.test( selector ) ?
-				jQuery( selector ) :
-				selector || [],
-			false
-		).length;
-	}
-});
-
-
-// Initialize a jQuery object
-
-
-// A central reference to the root jQuery(document)
-var rootjQuery,
-
-	// Use the correct document accordingly with window argument (sandbox)
-	document = window.document,
-
-	// A simple way to check for HTML strings
-	// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
-	// Strict HTML recognition (#11290: must start with <)
-	rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,
-
-	init = jQuery.fn.init = function( selector, context ) {
-		var match, elem;
-
-		// HANDLE: $(""), $(null), $(undefined), $(false)
-		if ( !selector ) {
-			return this;
-		}
-
-		// Handle HTML strings
-		if ( typeof selector === "string" ) {
-			if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) {
-				// Assume that strings that start and end with <> are HTML and skip the regex check
-				match = [ null, selector, null ];
-
-			} else {
-				match = rquickExpr.exec( selector );
-			}
-
-			// Match html or make sure no context is specified for #id
-			if ( match && (match[1] || !context) ) {
-
-				// HANDLE: $(html) -> $(array)
-				if ( match[1] ) {
-					context = context instanceof jQuery ? context[0] : context;
-
-					// scripts is true for back-compat
-					// Intentionally let the error be thrown if parseHTML is not present
-					jQuery.merge( this, jQuery.parseHTML(
-						match[1],
-						context && context.nodeType ? context.ownerDocument || context : document,
-						true
-					) );
-
-					// HANDLE: $(html, props)
-					if ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) {
-						for ( match in context ) {
-							// Properties of context are called as methods if possible
-							if ( jQuery.isFunction( this[ match ] ) ) {
-								this[ match ]( context[ match ] );
-
-							// ...and otherwise set as attributes
-							} else {
-								this.attr( match, context[ match ] );
-							}
-						}
-					}
-
-					return this;
-
-				// HANDLE: $(#id)
-				} else {
-					elem = document.getElementById( match[2] );
-
-					// Check parentNode to catch when Blackberry 4.6 returns
-					// nodes that are no longer in the document #6963
-					if ( elem && elem.parentNode ) {
-						// Handle the case where IE and Opera return items
-						// by name instead of ID
-						if ( elem.id !== match[2] ) {
-							return rootjQuery.find( selector );
-						}
-
-						// Otherwise, we inject the element directly into the jQuery object
-						this.length = 1;
-						this[0] = elem;
-					}
-
-					this.context = document;
-					this.selector = selector;
-					return this;
-				}
-
-			// HANDLE: $(expr, $(...))
-			} else if ( !context || context.jquery ) {
-				return ( context || rootjQuery ).find( selector );
-
-			// HANDLE: $(expr, context)
-			// (which is just equivalent to: $(context).find(expr)
-			} else {
-				return this.constructor( context ).find( selector );
-			}
-
-		// HANDLE: $(DOMElement)
-		} else if ( selector.nodeType ) {
-			this.context = this[0] = selector;
-			this.length = 1;
-			return this;
-
-		// HANDLE: $(function)
-		// Shortcut for document ready
-		} else if ( jQuery.isFunction( selector ) ) {
-			return typeof rootjQuery.ready !== "undefined" ?
-				rootjQuery.ready( selector ) :
-				// Execute immediately if ready is not present
-				selector( jQuery );
-		}
-
-		if ( selector.selector !== undefined ) {
-			this.selector = selector.selector;
-			this.context = selector.context;
-		}
-
-		return jQuery.makeArray( selector, this );
-	};
-
-// Give the init function the jQuery prototype for later instantiation
-init.prototype = jQuery.fn;
-
-// Initialize central reference
-rootjQuery = jQuery( document );
-
-
-var rparentsprev = /^(?:parents|prev(?:Until|All))/,
-	// methods guaranteed to produce a unique set when starting from a unique set
-	guaranteedUnique = {
-		children: true,
-		contents: true,
-		next: true,
-		prev: true
-	};
-
-jQuery.extend({
-	dir: function( elem, dir, until ) {
-		var matched = [],
-			cur = elem[ dir ];
-
-		while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) {
-			if ( cur.nodeType === 1 ) {
-				matched.push( cur );
-			}
-			cur = cur[dir];
-		}
-		return matched;
-	},
-
-	sibling: function( n, elem ) {
-		var r = [];
-
-		for ( ; n; n = n.nextSibling ) {
-			if ( n.nodeType === 1 && n !== elem ) {
-				r.push( n );
-			}
-		}
-
-		return r;
-	}
-});
-
-jQuery.fn.extend({
-	has: function( target ) {
-		var i,
-			targets = jQuery( target, this ),
-			len = targets.length;
-
-		return this.filter(function() {
-			for ( i = 0; i < len; i++ ) {
-				if ( jQuery.contains( this, targets[i] ) ) {
-					return true;
-				}
-			}
-		});
-	},
-
-	closest: function( selectors, context ) {
-		var cur,
-			i = 0,
-			l = this.length,
-			matched = [],
-			pos = rneedsContext.test( selectors ) || typeof selectors !== "string" ?
-				jQuery( selectors, context || this.context ) :
-				0;
-
-		for ( ; i < l; i++ ) {
-			for ( cur = this[i]; cur && cur !== context; cur = cur.parentNode ) {
-				// Always skip document fragments
-				if ( cur.nodeType < 11 && (pos ?
-					pos.index(cur) > -1 :
-
-					// Don't pass non-elements to Sizzle
-					cur.nodeType === 1 &&
-						jQuery.find.matchesSelector(cur, selectors)) ) {
-
-					matched.push( cur );
-					break;
-				}
-			}
-		}
-
-		return this.pushStack( matched.length > 1 ? jQuery.unique( matched ) : matched );
-	},
-
-	// Determine the position of an element within
-	// the matched set of elements
-	index: function( elem ) {
-
-		// No argument, return index in parent
-		if ( !elem ) {
-			return ( this[0] && this[0].parentNode ) ? this.first().prevAll().length : -1;
-		}
-
-		// index in selector
-		if ( typeof elem === "string" ) {
-			return jQuery.inArray( this[0], jQuery( elem ) );
-		}
-
-		// Locate the position of the desired element
-		return jQuery.inArray(
-			// If it receives a jQuery object, the first element is used
-			elem.jquery ? elem[0] : elem, this );
-	},
-
-	add: function( selector, context ) {
-		return this.pushStack(
-			jQuery.unique(
-				jQuery.merge( this.get(), jQuery( selector, context ) )
-			)
-		);
-	},
-
-	addBack: function( selector ) {
-		return this.add( selector == null ?
-			this.prevObject : this.prevObject.filter(selector)
-		);
-	}
-});
-
-function sibling( cur, dir ) {
-	do {
-		cur = cur[ dir ];
-	} while ( cur && cur.nodeType !== 1 );
-
-	return cur;
-}
-
-jQuery.each({
-	parent: function( elem ) {
-		var parent = elem.parentNode;
-		return parent && parent.nodeType !== 11 ? parent : null;
-	},
-	parents: function( elem ) {
-		return jQuery.dir( elem, "parentNode" );
-	},
-	parentsUntil: function( elem, i, until ) {
-		return jQuery.dir( elem, "parentNode", until );
-	},
-	next: function( elem ) {
-		return sibling( elem, "nextSibling" );
-	},
-	prev: function( elem ) {
-		return sibling( elem, "previousSibling" );
-	},
-	nextAll: function( elem ) {
-		return jQuery.dir( elem, "nextSibling" );
-	},
-	prevAll: function( elem ) {
-		return jQuery.dir( elem, "previousSibling" );
-	},
-	nextUntil: function( elem, i, until ) {
-		return jQuery.dir( elem, "nextSibling", until );
-	},
-	prevUntil: function( elem, i, until ) {
-		return jQuery.dir( elem, "previousSibling", until );
-	},
-	siblings: function( elem ) {
-		return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem );
-	},
-	children: function( elem ) {
-		return jQuery.sibling( elem.firstChild );
-	},
-	contents: function( elem ) {
-		return jQuery.nodeName( elem, "iframe" ) ?
-			elem.contentDocument || elem.contentWindow.document :
-			jQuery.merge( [], elem.childNodes );
-	}
-}, function( name, fn ) {
-	jQuery.fn[ name ] = function( until, selector ) {
-		var ret = jQuery.map( this, fn, until );
-
-		if ( name.slice( -5 ) !== "Until" ) {
-			selector = until;
-		}
-
-		if ( selector && typeof selector === "string" ) {
-			ret = jQuery.filter( selector, ret );
-		}
-
-		if ( this.length > 1 ) {
-			// Remove duplicates
-			if ( !guaranteedUnique[ name ] ) {
-				ret = jQuery.unique( ret );
-			}
-
-			// Reverse order for parents* and prev-derivatives
-			if ( rparentsprev.test( name ) ) {
-				ret = ret.reverse();
-			}
-		}
-
-		return this.pushStack( ret );
-	};
-});
-var rnotwhite = (/\S+/g);
-
-
-
-// String to Object options format cache
-var optionsCache = {};
-
-// Convert String-formatted options into Object-formatted ones and store in cache
-function createOptions( options ) {
-	var object = optionsCache[ options ] = {};
-	jQuery.each( options.match( rnotwhite ) || [], function( _, flag ) {
-		object[ flag ] = true;
-	});
-	return object;
-}
-
-/*
- * Create a callback list using the following parameters:
- *
- *	options: an optional list of space-separated options that will change how
- *			the callback list behaves or a more traditional option object
- *
- * By default a callback list will act like an event callback list and can be
- * "fired" multiple times.
- *
- * Possible options:
- *
- *	once:			will ensure the callback list can only be fired once (like a Deferred)
- *
- *	memory:			will keep track of previous values and will call any callback added
- *					after the list has been fired right away with the latest "memorized"
- *					values (like a Deferred)
- *
- *	unique:			will ensure a callback can only be added once (no duplicate in the list)
- *
- *	stopOnFalse:	interrupt callings when a callback returns false
- *
- */
-jQuery.Callbacks = function( options ) {
-
-	// Convert options from String-formatted to Object-formatted if needed
-	// (we check in cache first)
-	options = typeof options === "string" ?
-		( optionsCache[ options ] || createOptions( options ) ) :
-		jQuery.extend( {}, options );
-
-	var // Flag to know if list is currently firing
-		firing,
-		// Last fire value (for non-forgettable lists)
-		memory,
-		// Flag to know if list was already fired
-		fired,
-		// End of the loop when firing
-		firingLength,
-		// Index of currently firing callback (modified by remove if needed)
-		firingIndex,
-		// First callback to fire (used internally by add and fireWith)
-		firingStart,
-		// Actual callback list
-		list = [],
-		// Stack of fire calls for repeatable lists
-		stack = !options.once && [],
-		// Fire callbacks
-		fire = function( data ) {
-			memory = options.memory && data;
-			fired = true;
-			firingIndex = firingStart || 0;
-			firingStart = 0;
-			firingLength = list.length;
-			firing = true;
-			for ( ; list && firingIndex < firingLength; firingIndex++ ) {
-				if ( list[ firingIndex ].apply( data[ 0 ], data[ 1 ] ) === false && options.stopOnFalse ) {
-					memory = false; // To prevent further calls using add
-					break;
-				}
-			}
-			firing = false;
-			if ( list ) {
-				if ( stack ) {
-					if ( stack.length ) {
-						fire( stack.shift() );
-					}
-				} else if ( memory ) {
-					list = [];
-				} else {
-					self.disable();
-				}
-			}
-		},
-		// Actual Callbacks object
-		self = {
-			// Add a callback or a collection of callbacks to the list
-			add: function() {
-				if ( list ) {
-					// First, we save the current length
-					var start = list.length;
-					(function add( args ) {
-						jQuery.each( args, function( _, arg ) {
-							var type = jQuery.type( arg );
-							if ( type === "function" ) {
-								if ( !options.unique || !self.has( arg ) ) {
-									list.push( arg );
-								}
-							} else if ( arg && arg.length && type !== "string" ) {
-								// Inspect recursively
-								add( arg );
-							}
-						});
-					})( arguments );
-					// Do we need to add the callbacks to the
-					// current firing batch?
-					if ( firing ) {
-						firingLength = list.length;
-					// With memory, if we're not firing then
-					// we should call right away
-					} else if ( memory ) {
-						firingStart = start;
-						fire( memory );
-					}
-				}
-				return this;
-			},
-			// Remove a callback from the list
-			remove: function() {
-				if ( list ) {
-					jQuery.each( arguments, function( _, arg ) {
-						var index;
-						while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {
-							list.splice( index, 1 );
-							// Handle firing indexes
-							if ( firing ) {
-								if ( index <= firingLength ) {
-									firingLength--;
-								}
-								if ( index <= firingIndex ) {
-									firingIndex--;
-								}
-							}
-						}
-					});
-				}
-				return this;
-			},
-			// Check if a given callback is in the list.
-			// If no argument is given, return whether or not list has callbacks attached.
-			has: function( fn ) {
-				return fn ? jQuery.inArray( fn, list ) > -1 : !!( list && list.length );
-			},
-			// Remove all callbacks from the list
-			empty: function() {
-				list = [];
-				firingLength = 0;
-				return this;
-			},
-			// Have the list do nothing anymore
-			disable: function() {
-				list = stack = memory = undefined;
-				return this;
-			},
-			// Is it disabled?
-			disabled: function() {
-				return !list;
-			},
-			// Lock the list in its current state
-			lock: function() {
-				stack = undefined;
-				if ( !memory ) {
-					self.disable();
-				}
-				return this;
-			},
-			// Is it locked?
-			locked: function() {
-				return !stack;
-			},
-			// Call all callbacks with the given context and arguments
-			fireWith: function( context, args ) {
-				if ( list && ( !fired || stack ) ) {
-					args = args || [];
-					args = [ context, args.slice ? args.slice() : args ];
-					if ( firing ) {
-						stack.push( args );
-					} else {
-						fire( args );
-					}
-				}
-				return this;
-			},
-			// Call all the callbacks with the given arguments
-			fire: function() {
-				self.fireWith( this, arguments );
-				return this;
-			},
-			// To know if the callbacks have already been called at least once
-			fired: function() {
-				return !!fired;
-			}
-		};
-
-	return self;
-};
-
-
-jQuery.extend({
-
-	Deferred: function( func ) {
-		var tuples = [
-				// action, add listener, listener list, final state
-				[ "resolve", "done", jQuery.Callbacks("once memory"), "resolved" ],
-				[ "reject", "fail", jQuery.Callbacks("once memory"), "rejected" ],
-				[ "notify", "progress", jQuery.Callbacks("memory") ]
-			],
-			state = "pending",
-			promise = {
-				state: function() {
-					return state;
-				},
-				always: function() {
-					deferred.done( arguments ).fail( arguments );
-					return this;
-				},
-				then: function( /* fnDone, fnFail, fnProgress */ ) {
-					var fns = arguments;
-					return jQuery.Deferred(function( newDefer ) {
-						jQuery.each( tuples, function( i, tuple ) {
-							var fn = jQuery.isFunction( fns[ i ] ) && fns[ i ];
-							// deferred[ done | fail | progress ] for forwarding actions to newDefer
-							deferred[ tuple[1] ](function() {
-								var returned = fn && fn.apply( this, arguments );
-								if ( returned && jQuery.isFunction( returned.promise ) ) {
-									returned.promise()
-										.done( newDefer.resolve )
-										.fail( newDefer.reject )
-										.progress( newDefer.notify );
-								} else {
-									newDefer[ tuple[ 0 ] + "With" ]( this === promise ? newDefer.promise() : this, fn ? [ returned ] : arguments );
-								}
-							});
-						});
-						fns = null;
-					}).promise();
-				},
-				// Get a promise for this deferred
-				// If obj is provided, the promise aspect is added to the object
-				promise: function( obj ) {
-					return obj != null ? jQuery.extend( obj, promise ) : promise;
-				}
-			},
-			deferred = {};
-
-		// Keep pipe for back-compat
-		promise.pipe = promise.then;
-
-		// Add list-specific methods
-		jQuery.each( tuples, function( i, tuple ) {
-			var list = tuple[ 2 ],
-				stateString = tuple[ 3 ];
-
-			// promise[ done | fail | progress ] = list.add
-			promise[ tuple[1] ] = list.add;
-
-			// Handle state
-			if ( stateString ) {
-				list.add(function() {
-					// state = [ resolved | rejected ]
-					state = stateString;
-
-				// [ reject_list | resolve_list ].disable; progress_list.lock
-				}, tuples[ i ^ 1 ][ 2 ].disable, tuples[ 2 ][ 2 ].lock );
-			}
-
-			// deferred[ resolve | reject | notify ]
-			deferred[ tuple[0] ] = function() {
-				deferred[ tuple[0] + "With" ]( this === deferred ? promise : this, arguments );
-				return this;
-			};
-			deferred[ tuple[0] + "With" ] = list.fireWith;
-		});
-
-		// Make the deferred a promise
-		promise.promise( deferred );
-
-		// Call given func if any
-		if ( func ) {
-			func.call( deferred, deferred );
-		}
-
-		// All done!
-		return deferred;
-	},
-
-	// Deferred helper
-	when: function( subordinate /* , ..., subordinateN */ ) {
-		var i = 0,
-			resolveValues = slice.call( arguments ),
-			length = resolveValues.length,
-
-			// the count of uncompleted subordinates
-			remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0,
-
-			// the master Deferred. If resolveValues consist of only a single Deferred, just use that.
-			deferred = remaining === 1 ? subordinate : jQuery.Deferred(),
-
-			// Update function for both resolve and progress values
-			updateFunc = function( i, contexts, values ) {
-				return function( value ) {
-					contexts[ i ] = this;
-					values[ i ] = arguments.length > 1 ? slice.call( arguments ) : value;
-					if ( values === progressValues ) {
-						deferred.notifyWith( contexts, values );
-
-					} else if ( !(--remaining) ) {
-						deferred.resolveWith( contexts, values );
-					}
-				};
-			},
-
-			progressValues, progressContexts, resolveContexts;
-
-		// add listeners to Deferred subordinates; treat others as resolved
-		if ( length > 1 ) {
-			progressValues = new Array( length );
-			progressContexts = new Array( length );
-			resolveContexts = new Array( length );
-			for ( ; i < length; i++ ) {
-				if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) {
-					resolveValues[ i ].promise()
-						.done( updateFunc( i, resolveContexts, resolveValues ) )
-						.fail( deferred.reject )
-						.progress( updateFunc( i, progressContexts, progressValues ) );
-				} else {
-					--remaining;
-				}
-			}
-		}
-
-		// if we're not waiting on anything, resolve the master
-		if ( !remaining ) {
-			deferred.resolveWith( resolveContexts, resolveValues );
-		}
-
-		return deferred.promise();
-	}
-});
-
-
-// The deferred used on DOM ready
-var readyList;
-
-jQuery.fn.ready = function( fn ) {
-	// Add the callback
-	jQuery.ready.promise().done( fn );
-
-	return this;
-};
-
-jQuery.extend({
-	// Is the DOM ready to be used? Set to true once it occurs.
-	isReady: false,
-
-	// A counter to track how many items to wait for before
-	// the ready event fires. See #6781
-	readyWait: 1,
-
-	// Hold (or release) the ready event
-	holdReady: function( hold ) {
-		if ( hold ) {
-			jQuery.readyWait++;
-		} else {
-			jQuery.ready( true );
-		}
-	},
-
-	// Handle when the DOM is ready
-	ready: function( wait ) {
-
-		// Abort if there are pending holds or we're already ready
-		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
-			return;
-		}
-
-		// Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443).
-		if ( !document.body ) {
-			return setTimeout( jQuery.ready );
-		}
-
-		// Remember that the DOM is ready
-		jQuery.isReady = true;
-
-		// If a normal DOM Ready event fired, decrement, and wait if need be
-		if ( wait !== true && --jQuery.readyWait > 0 ) {
-			return;
-		}
-
-		// If there are functions bound, to execute
-		readyList.resolveWith( document, [ jQuery ] );
-
-		// Trigger any bound ready events
-		if ( jQuery.fn.triggerHandler ) {
-			jQuery( document ).triggerHandler( "ready" );
-			jQuery( document ).off( "ready" );
-		}
-	}
-});
-
-/**
- * Clean-up method for dom ready events
- */
-function detach() {
-	if ( document.addEventListener ) {
-		document.removeEventListener( "DOMContentLoaded", completed, false );
-		window.removeEventListener( "load", completed, false );
-
-	} else {
-		document.detachEvent( "onreadystatechange", completed );
-		window.detachEvent( "onload", completed );
-	}
-}
-
-/**
- * The ready event handler and self cleanup method
- */
-function completed() {
-	// readyState === "complete" is good enough for us to call the dom ready in oldIE
-	if ( document.addEventListener || event.type === "load" || document.readyState === "complete" ) {
-		detach();
-		jQuery.ready();
-	}
-}
-
-jQuery.ready.promise = function( obj ) {
-	if ( !readyList ) {
-
-		readyList = jQuery.Deferred();
-
-		// Catch cases where $(document).ready() is called after the browser event has already occurred.
-		// we once tried to use readyState "interactive" here, but it caused issues like the one
-		// discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15
-		if ( document.readyState === "complete" ) {
-			// Handle it asynchronously to allow scripts the opportunity to delay ready
-			setTimeout( jQuery.ready );
-
-		// Standards-based browsers support DOMContentLoaded
-		} else if ( document.addEventListener ) {
-			// Use the handy event callback
-			document.addEventListener( "DOMContentLoaded", completed, false );
-
-			// A fallback to window.onload, that will always work
-			window.addEventListener( "load", completed, false );
-
-		// If IE event model is used
-		} else {
-			// Ensure firing before onload, maybe late but safe also for iframes
-			document.attachEvent( "onreadystatechange", completed );
-
-			// A fallback to window.onload, that will always work
-			window.attachEvent( "onload", completed );
-
-			// If IE and not a frame
-			// continually check to see if the document is ready
-			var top = false;
-
-			try {
-				top = window.frameElement == null && document.documentElement;
-			} catch(e) {}
-
-			if ( top && top.doScroll ) {
-				(function doScrollCheck() {
-					if ( !jQuery.isReady ) {
-
-						try {
-							// Use the trick by Diego Perini
-							// http://javascript.nwbox.com/IEContentLoaded/
-							top.doScroll("left");
-						} catch(e) {
-							return setTimeout( doScrollCheck, 50 );
-						}
-
-						// detach all dom ready events
-						detach();
-
-						// and execute any waiting functions
-						jQuery.ready();
-					}
-				})();
-			}
-		}
-	}
-	return readyList.promise( obj );
-};
-
-
-var strundefined = typeof undefined;
-
-
-
-// Support: IE<9
-// Iteration over object's inherited properties before its own
-var i;
-for ( i in jQuery( support ) ) {
-	break;
-}
-support.ownLast = i !== "0";
-
-// Note: most support tests are defined in their respective modules.
-// false until the test is run
-support.inlineBlockNeedsLayout = false;
-
-// Execute ASAP in case we need to set body.style.zoom
-jQuery(function() {
-	// Minified: var a,b,c,d
-	var val, div, body, container;
-
-	body = document.getElementsByTagName( "body" )[ 0 ];
-	if ( !body || !body.style ) {
-		// Return for frameset docs that don't have a body
-		return;
-	}
-
-	// Setup
-	div = document.createElement( "div" );
-	container = document.createElement( "div" );
-	container.style.cssText = "position:absolute;border:0;width:0;height:0;top:0;left:-9999px";
-	body.appendChild( container ).appendChild( div );
-
-	if ( typeof div.style.zoom !== strundefined ) {
-		// Support: IE<8
-		// Check if natively block-level elements act like inline-block
-		// elements when setting their display to 'inline' and giving
-		// them layout
-		div.style.cssText = "display:inline;margin:0;border:0;padding:1px;width:1px;zoom:1";
-
-		support.inlineBlockNeedsLayout = val = div.offsetWidth === 3;
-		if ( val ) {
-			// Prevent IE 6 from affecting layout for positioned elements #11048
-			// Prevent IE from shrinking the body in IE 7 mode #12869
-			// Support: IE<8
-			body.style.zoom = 1;
-		}
-	}
-
-	body.removeChild( container );
-});
-
-
-
-
-(function() {
-	var div = document.createElement( "div" );
-
-	// Execute the test only if not already executed in another module.
-	if (support.deleteExpando == null) {
-		// Support: IE<9
-		support.deleteExpando = true;
-		try {
-			delete div.test;
-		} catch( e ) {
-			support.deleteExpando = false;
-		}
-	}
-
-	// Null elements to avoid leaks in IE.
-	div = null;
-})();
-
-
-/**
- * Determines whether an object can have data
- */
-jQuery.acceptData = function( elem ) {
-	var noData = jQuery.noData[ (elem.nodeName + " ").toLowerCase() ],
-		nodeType = +elem.nodeType || 1;
-
-	// Do not set data on non-element DOM nodes because it will not be cleared (#8335).
-	return nodeType !== 1 && nodeType !== 9 ?
-		false :
-
-		// Nodes accept data unless otherwise specified; rejection can be conditional
-		!noData || noData !== true && elem.getAttribute("classid") === noData;
-};
-
-
-var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,
-	rmultiDash = /([A-Z])/g;
-
-function dataAttr( elem, key, data ) {
-	// If nothing was found internally, try to fetch any
-	// data from the HTML5 data-* attribute
-	if ( data === undefined && elem.nodeType === 1 ) {
-
-		var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase();
-
-		data = elem.getAttribute( name );
-
-		if ( typeof data === "string" ) {
-			try {
-				data = data === "true" ? true :
-					data === "false" ? false :
-					data === "null" ? null :
-					// Only convert to a number if it doesn't change the string
-					+data + "" === data ? +data :
-					rbrace.test( data ) ? jQuery.parseJSON( data ) :
-					data;
-			} catch( e ) {}
-
-			// Make sure we set the data so it isn't changed later
-			jQuery.data( elem, key, data );
-
-		} else {
-			data = undefined;
-		}
-	}
-
-	return data;
-}
-
-// checks a cache object for emptiness
-function isEmptyDataObject( obj ) {
-	var name;
-	for ( name in obj ) {
-
-		// if the public data object is empty, the private is still empty
-		if ( name === "data" && jQuery.isEmptyObject( obj[name] ) ) {
-			continue;
-		}
-		if ( name !== "toJSON" ) {
-			return false;
-		}
-	}
-
-	return true;
-}
-
-function internalData( elem, name, data, pvt /* Internal Use Only */ ) {
-	if ( !jQuery.acceptData( elem ) ) {
-		return;
-	}
-
-	var ret, thisCache,
-		internalKey = jQuery.expando,
-
-		// We have to handle DOM nodes and JS objects differently because IE6-7
-		// can't GC object references properly across the DOM-JS boundary
-		isNode = elem.nodeType,
-
-		// Only DOM nodes need the global jQuery cache; JS object data is
-		// attached directly to the object so GC can occur automatically
-		cache = isNode ? jQuery.cache : elem,
-
-		// Only defining an ID for JS objects if its cache already exists allows
-		// the code to shortcut on the same path as a DOM node with no cache
-		id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey;
-
-	// Avoid doing any more work than we need to when trying to get data on an
-	// object that has no data at all
-	if ( (!id || !cache[id] || (!pvt && !cache[id].data)) && data === undefined && typeof name === "string" ) {
-		return;
-	}
-
-	if ( !id ) {
-		// Only DOM nodes need a new unique ID for each element since their data
-		// ends up in the global cache
-		if ( isNode ) {
-			id = elem[ internalKey ] = deletedIds.pop() || jQuery.guid++;
-		} else {
-			id = internalKey;
-		}
-	}
-
-	if ( !cache[ id ] ) {
-		// Avoid exposing jQuery metadata on plain JS objects when the object
-		// is serialized using JSON.stringify
-		cache[ id ] = isNode ? {} : { toJSON: jQuery.noop };
-	}
-
-	// An object can be passed to jQuery.data instead of a key/value pair; this gets
-	// shallow copied over onto the existing cache
-	if ( typeof name === "object" || typeof name === "function" ) {
-		if ( pvt ) {
-			cache[ id ] = jQuery.extend( cache[ id ], name );
-		} else {
-			cache[ id ].data = jQuery.extend( cache[ id ].data, name );
-		}
-	}
-
-	thisCache = cache[ id ];
-
-	// jQuery data() is stored in a separate object inside the object's internal data
-	// cache in order to avoid key collisions between internal data and user-defined
-	// data.
-	if ( !pvt ) {
-		if ( !thisCache.data ) {
-			thisCache.data = {};
-		}
-
-		thisCache = thisCache.data;
-	}
-
-	if ( data !== undefined ) {
-		thisCache[ jQuery.camelCase( name ) ] = data;
-	}
-
-	// Check for both converted-to-camel and non-converted data property names
-	// If a data property was specified
-	if ( typeof name === "string" ) {
-
-		// First Try to find as-is property data
-		ret = thisCache[ name ];
-
-		// Test for null|undefined property data
-		if ( ret == null ) {
-
-			// Try to find the camelCased property
-			ret = thisCache[ jQuery.camelCase( name ) ];
-		}
-	} else {
-		ret = thisCache;
-	}
-
-	return ret;
-}
-
-function internalRemoveData( elem, name, pvt ) {
-	if ( !jQuery.acceptData( elem ) ) {
-		return;
-	}
-
-	var thisCache, i,
-		isNode = elem.nodeType,
-
-		// See jQuery.data for more information
-		cache = isNode ? jQuery.cache : elem,
-		id = isNode ? elem[ jQuery.expando ] : jQuery.expando;
-
-	// If there is already no cache entry for this object, there is no
-	// purpose in continuing
-	if ( !cache[ id ] ) {
-		return;
-	}
-
-	if ( name ) {
-
-		thisCache = pvt ? cache[ id ] : cache[ id ].data;
-
-		if ( thisCache ) {
-
-			// Support array or space separated string names for data keys
-			if ( !jQuery.isArray( name ) ) {
-
-				// try the string as a key before any manipulation
-				if ( name in thisCache ) {
-					name = [ name ];
-				} else {
-
-					// split the camel cased version by spaces unless a key with the spaces exists
-					name = jQuery.camelCase( name );
-					if ( name in thisCache ) {
-						name = [ name ];
-					} else {
-						name = name.split(" ");
-					}
-				}
-			} else {
-				// If "name" is an array of keys...
-				// When data is initially created, via ("key", "val") signature,
-				// keys will be converted to camelCase.
-				// Since there is no way to tell _how_ a key was added, remove
-				// both plain key and camelCase key. #12786
-				// This will only penalize the array argument path.
-				name = name.concat( jQuery.map( name, jQuery.camelCase ) );
-			}
-
-			i = name.length;
-			while ( i-- ) {
-				delete thisCache[ name[i] ];
-			}
-
-			// If there is no data left in the cache, we want to continue
-			// and let the cache object itself get destroyed
-			if ( pvt ? !isEmptyDataObject(thisCache) : !jQuery.isEmptyObject(thisCache) ) {
-				return;
-			}
-		}
-	}
-
-	// See jQuery.data for more information
-	if ( !pvt ) {
-		delete cache[ id ].data;
-
-		// Don't destroy the parent cache unless the internal data object
-		// had been the only thing left in it
-		if ( !isEmptyDataObject( cache[ id ] ) ) {
-			return;
-		}
-	}
-
-	// Destroy the cache
-	if ( isNode ) {
-		jQuery.cleanData( [ elem ], true );
-
-	// Use delete when supported for expandos or `cache` is not a window per isWindow (#10080)
-	/* jshint eqeqeq: false */
-	} else if ( support.deleteExpando || cache != cache.window ) {
-		/* jshint eqeqeq: true */
-		delete cache[ id ];
-
-	// When all else fails, null
-	} else {
-		cache[ id ] = null;
-	}
-}
-
-jQuery.extend({
-	cache: {},
-
-	// The following elements (space-suffixed to avoid Object.prototype collisions)
-	// throw uncatchable exceptions if you attempt to set expando properties
-	noData: {
-		"applet ": true,
-		"embed ": true,
-		// ...but Flash objects (which have this classid) *can* handle expandos
-		"object ": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
-	},
-
-	hasData: function( elem ) {
-		elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ];
-		return !!elem && !isEmptyDataObject( elem );
-	},
-
-	data: function( elem, name, data ) {
-		return internalData( elem, name, data );
-	},
-
-	removeData: function( elem, name ) {
-		return internalRemoveData( elem, name );
-	},
-
-	// For internal use only.
-	_data: function( elem, name, data ) {
-		return internalData( elem, name, data, true );
-	},
-
-	_removeData: function( elem, name ) {
-		return internalRemoveData( elem, name, true );
-	}
-});
-
-jQuery.fn.extend({
-	data: function( key, value ) {
-		var i, name, data,
-			elem = this[0],
-			attrs = elem && elem.attributes;
-
-		// Special expections of .data basically thwart jQuery.access,
-		// so implement the relevant behavior ourselves
-
-		// Gets all values
-		if ( key === undefined ) {
-			if ( this.length ) {
-				data = jQuery.data( elem );
-
-				if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) {
-					i = attrs.length;
-					while ( i-- ) {
-
-						// Support: IE11+
-						// The attrs elements can be null (#14894)
-						if ( attrs[ i ] ) {
-							name = attrs[ i ].name;
-							if ( name.indexOf( "data-" ) === 0 ) {
-								name = jQuery.camelCase( name.slice(5) );
-								dataAttr( elem, name, data[ name ] );
-							}
-						}
-					}
-					jQuery._data( elem, "parsedAttrs", true );
-				}
-			}
-
-			return data;
-		}
-
-		// Sets multiple values
-		if ( typeof key === "object" ) {
-			return this.each(function() {
-				jQuery.data( this, key );
-			});
-		}
-
-		return arguments.length > 1 ?
-
-			// Sets one value
-			this.each(function() {
-				jQuery.data( this, key, value );
-			}) :
-
-			// Gets one value
-			// Try to fetch any internally stored data first
-			elem ? dataAttr( elem, key, jQuery.data( elem, key ) ) : undefined;
-	},
-
-	removeData: function( key ) {
-		return this.each(function() {
-			jQuery.removeData( this, key );
-		});
-	}
-});
-
-
-jQuery.extend({
-	queue: function( elem, type, data ) {
-		var queue;
-
-		if ( elem ) {
-			type = ( type || "fx" ) + "queue";
-			queue = jQuery._data( elem, type );
-
-			// Speed up dequeue by getting out quickly if this is just a lookup
-			if ( data ) {
-				if ( !queue || jQuery.isArray(data) ) {
-					queue = jQuery._data( elem, type, jQuery.makeArray(data) );
-				} else {
-					queue.push( data );
-				}
-			}
-			return queue || [];
-		}
-	},
-
-	dequeue: function( elem, type ) {
-		type = type || "fx";
-
-		var queue = jQuery.queue( elem, type ),
-			startLength = queue.length,
-			fn = queue.shift(),
-			hooks = jQuery._queueHooks( elem, type ),
-			next = function() {
-				jQuery.dequeue( elem, type );
-			};
-
-		// If the fx queue is dequeued, always remove the progress sentinel
-		if ( fn === "inprogress" ) {
-			fn = queue.shift();
-			startLength--;
-		}
-
-		if ( fn ) {
-
-			// Add a progress sentinel to prevent the fx queue from being
-			// automatically dequeued
-			if ( type === "fx" ) {
-				queue.unshift( "inprogress" );
-			}
-
-			// clear up the last queue stop function
-			delete hooks.stop;
-			fn.call( elem, next, hooks );
-		}
-
-		if ( !startLength && hooks ) {
-			hooks.empty.fire();
-		}
-	},
-
-	// not intended for public consumption - generates a queueHooks object, or returns the current one
-	_queueHooks: function( elem, type ) {
-		var key = type + "queueHooks";
-		return jQuery._data( elem, key ) || jQuery._data( elem, key, {
-			empty: jQuery.Callbacks("once memory").add(function() {
-				jQuery._removeData( elem, type + "queue" );
-				jQuery._removeData( elem, key );
-			})
-		});
-	}
-});
-
-jQuery.fn.extend({
-	queue: function( type, data ) {
-		var setter = 2;
-
-		if ( typeof type !== "string" ) {
-			data = type;
-			type = "fx";
-			setter--;
-		}
-
-		if ( arguments.length < setter ) {
-			return jQuery.queue( this[0], type );
-		}
-
-		return data === undefined ?
-			this :
-			this.each(function() {
-				var queue = jQuery.queue( this, type, data );
-
-				// ensure a hooks for this queue
-				jQuery._queueHooks( this, type );
-
-				if ( type === "fx" && queue[0] !== "inprogress" ) {
-					jQuery.dequeue( this, type );
-				}
-			});
-	},
-	dequeue: function( type ) {
-		return this.each(function() {
-			jQuery.dequeue( this, type );
-		});
-	},
-	clearQueue: function( type ) {
-		return this.queue( type || "fx", [] );
-	},
-	// Get a promise resolved when queues of a certain type
-	// are emptied (fx is the type by default)
-	promise: function( type, obj ) {
-		var tmp,
-			count = 1,
-			defer = jQuery.Deferred(),
-			elements = this,
-			i = this.length,
-			resolve = function() {
-				if ( !( --count ) ) {
-					defer.resolveWith( elements, [ elements ] );
-				}
-			};
-
-		if ( typeof type !== "string" ) {
-			obj = type;
-			type = undefined;
-		}
-		type = type || "fx";
-
-		while ( i-- ) {
-			tmp = jQuery._data( elements[ i ], type + "queueHooks" );
-			if ( tmp && tmp.empty ) {
-				count++;
-				tmp.empty.add( resolve );
-			}
-		}
-		resolve();
-		return defer.promise( obj );
-	}
-});
-var pnum = (/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/).source;
-
-var cssExpand = [ "Top", "Right", "Bottom", "Left" ];
-
-var isHidden = function( elem, el ) {
-		// isHidden might be called from jQuery#filter function;
-		// in that case, element will be second argument
-		elem = el || elem;
-		return jQuery.css( elem, "display" ) === "none" || !jQuery.contains( elem.ownerDocument, elem );
-	};
-
-
-
-// Multifunctional method to get and set values of a collection
-// The value/s can optionally be executed if it's a function
-var access = jQuery.access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
-	var i = 0,
-		length = elems.length,
-		bulk = key == null;
-
-	// Sets many values
-	if ( jQuery.type( key ) === "object" ) {
-		chainable = true;
-		for ( i in key ) {
-			jQuery.access( elems, fn, i, key[i], true, emptyGet, raw );
-		}
-
-	// Sets one value
-	} else if ( value !== undefined ) {
-		chainable = true;
-
-		if ( !jQuery.isFunction( value ) ) {
-			raw = true;
-		}
-
-		if ( bulk ) {
-			// Bulk operations run against the entire set
-			if ( raw ) {
-				fn.call( elems, value );
-				fn = null;
-
-			// ...except when executing function values
-			} else {
-				bulk = fn;
-				fn = function( elem, key, value ) {
-					return bulk.call( jQuery( elem ), value );
-				};
-			}
-		}
-
-		if ( fn ) {
-			for ( ; i < length; i++ ) {
-				fn( elems[i], key, raw ? value : value.call( elems[i], i, fn( elems[i], key ) ) );
-			}
-		}
-	}
-
-	return chainable ?
-		elems :
-
-		// Gets
-		bulk ?
-			fn.call( elems ) :
-			length ? fn( elems[0], key ) : emptyGet;
-};
-var rcheckableType = (/^(?:checkbox|radio)$/i);
-
-
-
-(function() {
-	// Minified: var a,b,c
-	var input = document.createElement( "input" ),
-		div = document.createElement( "div" ),
-		fragment = document.createDocumentFragment();
-
-	// Setup
-	div.innerHTML = "  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>";
-
-	// IE strips leading whitespace when .innerHTML is used
-	support.leadingWhitespace = div.firstChild.nodeType === 3;
-
-	// Make sure that tbody elements aren't automatically inserted
-	// IE will insert them into empty tables
-	support.tbody = !div.getElementsByTagName( "tbody" ).length;
-
-	// Make sure that link elements get serialized correctly by innerHTML
-	// This requires a wrapper element in IE
-	support.htmlSerialize = !!div.getElementsByTagName( "link" ).length;
-
-	// Makes sure cloning an html5 element does not cause problems
-	// Where outerHTML is undefined, this still works
-	support.html5Clone =
-		document.createElement( "nav" ).cloneNode( true ).outerHTML !== "<:nav></:nav>";
-
-	// Check if a disconnected checkbox will retain its checked
-	// value of true after appended to the DOM (IE6/7)
-	input.type = "checkbox";
-	input.checked = true;
-	fragment.appendChild( input );
-	support.appendChecked = input.checked;
-
-	// Make sure textarea (and checkbox) defaultValue is properly cloned
-	// Support: IE6-IE11+
-	div.innerHTML = "<textarea>x</textarea>";
-	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
-
-	// #11217 - WebKit loses check when the name is after the checked attribute
-	fragment.appendChild( div );
-	div.innerHTML = "<input type='radio' checked='checked' name='t'/>";
-
-	// Support: Safari 5.1, iOS 5.1, Android 4.x, Android 2.3
-	// old WebKit doesn't clone checked state correctly in fragments
-	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
-
-	// Support: IE<9
-	// Opera does not clone events (and typeof div.attachEvent === undefined).
-	// IE9-10 clones events bound via attachEvent, but they don't trigger with .click()
-	support.noCloneEvent = true;
-	if ( div.attachEvent ) {
-		div.attachEvent( "onclick", function() {
-			support.noCloneEvent = false;
-		});
-
-		div.cloneNode( true ).click();
-	}
-
-	// Execute the test only if not already executed in another module.
-	if (support.deleteExpando == null) {
-		// Support: IE<9
-		support.deleteExpando = true;
-		try {
-			delete div.test;
-		} catch( e ) {
-			support.deleteExpando = false;
-		}
-	}
-})();
-
-
-(function() {
-	var i, eventName,
-		div = document.createElement( "div" );
-
-	// Support: IE<9 (lack submit/change bubble), Firefox 23+ (lack focusin event)
-	for ( i in { submit: true, change: true, focusin: true }) {
-		eventName = "on" + i;
-
-		if ( !(support[ i + "Bubbles" ] = eventName in window) ) {
-			// Beware of CSP restrictions (https://developer.mozilla.org/en/Security/CSP)
-			div.setAttribute( eventName, "t" );
-			support[ i + "Bubbles" ] = div.attributes[ eventName ].expando === false;
-		}
-	}
-
-	// Null elements to avoid leaks in IE.
-	div = null;
-})();
-
-
-var rformElems = /^(?:input|select|textarea)$/i,
-	rkeyEvent = /^key/,
-	rmouseEvent = /^(?:mouse|pointer|contextmenu)|click/,
-	rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
-	rtypenamespace = /^([^.]*)(?:\.(.+)|)$/;
-
-function returnTrue() {
-	return true;
-}
-
-function returnFalse() {
-	return false;
-}
-
-function safeActiveElement() {
-	try {
-		return document.activeElement;
-	} catch ( err ) { }
-}
-
-/*
- * Helper functions for managing events -- not part of the public interface.
- * Props to Dean Edwards' addEvent library for many of the ideas.
- */
-jQuery.event = {
-
-	global: {},
-
-	add: function( elem, types, handler, data, selector ) {
-		var tmp, events, t, handleObjIn,
-			special, eventHandle, handleObj,
-			handlers, type, namespaces, origType,
-			elemData = jQuery._data( elem );
-
-		// Don't attach events to noData or text/comment nodes (but allow plain objects)
-		if ( !elemData ) {
-			return;
-		}
-
-		// Caller can pass in an object of custom data in lieu of the handler
-		if ( handler.handler ) {
-			handleObjIn = handler;
-			handler = handleObjIn.handler;
-			selector = handleObjIn.selector;
-		}
-
-		// Make sure that the handler has a unique ID, used to find/remove it later
-		if ( !handler.guid ) {
-			handler.guid = jQuery.guid++;
-		}
-
-		// Init the element's event structure and main handler, if this is the first
-		if ( !(events = elemData.events) ) {
-			events = elemData.events = {};
-		}
-		if ( !(eventHandle = elemData.handle) ) {
-			eventHandle = elemData.handle = function( e ) {
-				// Discard the second event of a jQuery.event.trigger() and
-				// when an event is called after a page has unloaded
-				return typeof jQuery !== strundefined && (!e || jQuery.event.triggered !== e.type) ?
-					jQuery.event.dispatch.apply( eventHandle.elem, arguments ) :
-					undefined;
-			};
-			// Add elem as a property of the handle fn to prevent a memory leak with IE non-native events
-			eventHandle.elem = elem;
-		}
-
-		// Handle multiple events separated by a space
-		types = ( types || "" ).match( rnotwhite ) || [ "" ];
-		t = types.length;
-		while ( t-- ) {
-			tmp = rtypenamespace.exec( types[t] ) || [];
-			type = origType = tmp[1];
-			namespaces = ( tmp[2] || "" ).split( "." ).sort();
-
-			// There *must* be a type, no attaching namespace-only handlers
-			if ( !type ) {
-				continue;
-			}
-
-			// If event changes its type, use the special event handlers for the changed type
-			special = jQuery.event.special[ type ] || {};
-
-			// If selector defined, determine special event api type, otherwise given type
-			type = ( selector ? special.delegateType : special.bindType ) || type;
-
-			// Update special based on newly reset type
-			special = jQuery.event.special[ type ] || {};
-
-			// handleObj is passed to all event handlers
-			handleObj = jQuery.extend({
-				type: type,
-				origType: origType,
-				data: data,
-				handler: handler,
-				guid: handler.guid,
-				selector: selector,
-				needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
-				namespace: namespaces.join(".")
-			}, handleObjIn );
-
-			// Init the event handler queue if we're the first
-			if ( !(handlers = events[ type ]) ) {
-				handlers = events[ type ] = [];
-				handlers.delegateCount = 0;
-
-				// Only use addEventListener/attachEvent if the special events handler returns false
-				if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
-					// Bind the global event handler to the element
-					if ( elem.addEventListener ) {
-						elem.addEventListener( type, eventHandle, false );
-
-					} else if ( elem.attachEvent ) {
-						elem.attachEvent( "on" + type, eventHandle );
-					}
-				}
-			}
-
-			if ( special.add ) {
-				special.add.call( elem, handleObj );
-
-				if ( !handleObj.handler.guid ) {
-					handleObj.handler.guid = handler.guid;
-				}
-			}
-
-			// Add to the element's handler list, delegates in front
-			if ( selector ) {
-				handlers.splice( handlers.delegateCount++, 0, handleObj );
-			} else {
-				handlers.push( handleObj );
-			}
-
-			// Keep track of which events have ever been used, for event optimization
-			jQuery.event.global[ type ] = true;
-		}
-
-		// Nullify elem to prevent memory leaks in IE
-		elem = null;
-	},
-
-	// Detach an event or set of events from an element
-	remove: function( elem, types, handler, selector, mappedTypes ) {
-		var j, handleObj, tmp,
-			origCount, t, events,
-			special, handlers, type,
-			namespaces, origType,
-			elemData = jQuery.hasData( elem ) && jQuery._data( elem );
-
-		if ( !elemData || !(events = elemData.events) ) {
-			return;
-		}
-
-		// Once for each type.namespace in types; type may be omitted
-		types = ( types || "" ).match( rnotwhite ) || [ "" ];
-		t = types.length;
-		while ( t-- ) {
-			tmp = rtypenamespace.exec( types[t] ) || [];
-			type = origType = tmp[1];
-			namespaces = ( tmp[2] || "" ).split( "." ).sort();
-
-			// Unbind all events (on this namespace, if provided) for the element
-			if ( !type ) {
-				for ( type in events ) {
-					jQuery.event.remove( elem, type + types[ t ], handler, selector, true );
-				}
-				continue;
-			}
-
-			special = jQuery.event.special[ type ] || {};
-			type = ( selector ? special.delegateType : special.bindType ) || type;
-			handlers = events[ type ] || [];
-			tmp = tmp[2] && new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" );
-
-			// Remove matching events
-			origCount = j = handlers.length;
-			while ( j-- ) {
-				handleObj = handlers[ j ];
-
-				if ( ( mappedTypes || origType === handleObj.origType ) &&
-					( !handler || handler.guid === handleObj.guid ) &&
-					( !tmp || tmp.test( handleObj.namespace ) ) &&
-					( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) {
-					handlers.splice( j, 1 );
-
-					if ( handleObj.selector ) {
-						handlers.delegateCount--;
-					}
-					if ( special.remove ) {
-						special.remove.call( elem, handleObj );
-					}
-				}
-			}
-
-			// Remove generic event handler if we removed something and no more handlers exist
-			// (avoids potential for endless recursion during removal of special event handlers)
-			if ( origCount && !handlers.length ) {
-				if ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) {
-					jQuery.removeEvent( elem, type, elemData.handle );
-				}
-
-				delete events[ type ];
-			}
-		}
-
-		// Remove the expando if it's no longer used
-		if ( jQuery.isEmptyObject( events ) ) {
-			delete elemData.handle;
-
-			// removeData also checks for emptiness and clears the expando if empty
-			// so use it instead of delete
-			jQuery._removeData( elem, "events" );
-		}
-	},
-
-	trigger: function( event, data, elem, onlyHandlers ) {
-		var handle, ontype, cur,
-			bubbleType, special, tmp, i,
-			eventPath = [ elem || document ],
-			type = hasOwn.call( event, "type" ) ? event.type : event,
-			namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split(".") : [];
-
-		cur = tmp = elem = elem || document;
-
-		// Don't do events on text and comment nodes
-		if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
-			return;
-		}
-
-		// focus/blur morphs to focusin/out; ensure we're not firing them right now
-		if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
-			return;
-		}
-
-		if ( type.indexOf(".") >= 0 ) {
-			// Namespaced trigger; create a regexp to match event type in handle()
-			namespaces = type.split(".");
-			type = namespaces.shift();
-			namespaces.sort();
-		}
-		ontype = type.indexOf(":") < 0 && "on" + type;
-
-		// Caller can pass in a jQuery.Event object, Object, or just an event type string
-		event = event[ jQuery.expando ] ?
-			event :
-			new jQuery.Event( type, typeof event === "object" && event );
-
-		// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
-		event.isTrigger = onlyHandlers ? 2 : 3;
-		event.namespace = namespaces.join(".");
-		event.namespace_re = event.namespace ?
-			new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ) :
-			null;
-
-		// Clean up the event in case it is being reused
-		event.result = undefined;
-		if ( !event.target ) {
-			event.target = elem;
-		}
-
-		// Clone any incoming data and prepend the event, creating the handler arg list
-		data = data == null ?
-			[ event ] :
-			jQuery.makeArray( data, [ event ] );
-
-		// Allow special events to draw outside the lines
-		special = jQuery.event.special[ type ] || {};
-		if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
-			return;
-		}
-
-		// Determine event propagation path in advance, per W3C events spec (#9951)
-		// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
-		if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) {
-
-			bubbleType = special.delegateType || type;
-			if ( !rfocusMorph.test( bubbleType + type ) ) {
-				cur = cur.parentNode;
-			}
-			for ( ; cur; cur = cur.parentNode ) {
-				eventPath.push( cur );
-				tmp = cur;
-			}
-
-			// Only add window if we got to document (e.g., not plain obj or detached DOM)
-			if ( tmp === (elem.ownerDocument || document) ) {
-				eventPath.push( tmp.defaultView || tmp.parentWindow || window );
-			}
-		}
-
-		// Fire handlers on the event path
-		i = 0;
-		while ( (cur = eventPath[i++]) && !event.isPropagationStopped() ) {
-
-			event.type = i > 1 ?
-				bubbleType :
-				special.bindType || type;
-
-			// jQuery handler
-			handle = ( jQuery._data( cur, "events" ) || {} )[ event.type ] && jQuery._data( cur, "handle" );
-			if ( handle ) {
-				handle.apply( cur, data );
-			}
-
-			// Native handler
-			handle = ontype && cur[ ontype ];
-			if ( handle && handle.apply && jQuery.acceptData( cur ) ) {
-				event.result = handle.apply( cur, data );
-				if ( event.result === false ) {
-					event.preventDefault();
-				}
-			}
-		}
-		event.type = type;
-
-		// If nobody prevented the default action, do it now
-		if ( !onlyHandlers && !event.isDefaultPrevented() ) {
-
-			if ( (!special._default || special._default.apply( eventPath.pop(), data ) === false) &&
-				jQuery.acceptData( elem ) ) {
-
-				// Call a native DOM method on the target with the same name name as the event.
-				// Can't use an .isFunction() check here because IE6/7 fails that test.
-				// Don't do default actions on window, that's where global variables be (#6170)
-				if ( ontype && elem[ type ] && !jQuery.isWindow( elem ) ) {
-
-					// Don't re-trigger an onFOO event when we call its FOO() method
-					tmp = elem[ ontype ];
-
-					if ( tmp ) {
-						elem[ ontype ] = null;
-					}
-
-					// Prevent re-triggering of the same event, since we already bubbled it above
-					jQuery.event.triggered = type;
-					try {
-						elem[ type ]();
-					} catch ( e ) {
-						// IE<9 dies on focus/blur to hidden element (#1486,#12518)
-						// only reproducible on winXP IE8 native, not IE9 in IE8 mode
-					}
-					jQuery.event.triggered = undefined;
-
-					if ( tmp ) {
-						elem[ ontype ] = tmp;
-					}
-				}
-			}
-		}
-
-		return event.result;
-	},
-
-	dispatch: function( event ) {
-
-		// Make a writable jQuery.Event from the native event object
-		event = jQuery.event.fix( event );
-
-		var i, ret, handleObj, matched, j,
-			handlerQueue = [],
-			args = slice.call( arguments ),
-			handlers = ( jQuery._data( this, "events" ) || {} )[ event.type ] || [],
-			special = jQuery.event.special[ event.type ] || {};
-
-		// Use the fix-ed jQuery.Event rather than the (read-only) native event
-		args[0] = event;
-		event.delegateTarget = this;
-
-		// Call the preDispatch hook for the mapped type, and let it bail if desired
-		if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {
-			return;
-		}
-
-		// Determine handlers
-		handlerQueue = jQuery.event.handlers.call( this, event, handlers );
-
-		// Run delegates first; they may want to stop propagation beneath us
-		i = 0;
-		while ( (matched = handlerQueue[ i++ ]) && !event.isPropagationStopped() ) {
-			event.currentTarget = matched.elem;
-
-			j = 0;
-			while ( (handleObj = matched.handlers[ j++ ]) && !event.isImmediatePropagationStopped() ) {
-
-				// Triggered event must either 1) have no namespace, or
-				// 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace).
-				if ( !event.namespace_re || event.namespace_re.test( handleObj.namespace ) ) {
-
-					event.handleObj = handleObj;
-					event.data = handleObj.data;
-
-					ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler )
-							.apply( matched.elem, args );
-
-					if ( ret !== undefined ) {
-						if ( (event.result = ret) === false ) {
-							event.preventDefault();
-							event.stopPropagation();
-						}
-					}
-				}
-			}
-		}
-
-		// Call the postDispatch hook for the mapped type
-		if ( special.postDispatch ) {
-			special.postDispatch.call( this, event );
-		}
-
-		return event.result;
-	},
-
-	handlers: function( event, handlers ) {
-		var sel, handleObj, matches, i,
-			handlerQueue = [],
-			delegateCount = handlers.delegateCount,
-			cur = event.target;
-
-		// Find delegate handlers
-		// Black-hole SVG <use> instance trees (#13180)
-		// Avoid non-left-click bubbling in Firefox (#3861)
-		if ( delegateCount && cur.nodeType && (!event.button || event.type !== "click") ) {
-
-			/* jshint eqeqeq: false */
-			for ( ; cur != this; cur = cur.parentNode || this ) {
-				/* jshint eqeqeq: true */
-
-				// Don't check non-elements (#13208)
-				// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)
-				if ( cur.nodeType === 1 && (cur.disabled !== true || event.type !== "click") ) {
-					matches = [];
-					for ( i = 0; i < delegateCount; i++ ) {
-						handleObj = handlers[ i ];
-
-						// Don't conflict with Object.prototype properties (#13203)
-						sel = handleObj.selector + " ";
-
-						if ( matches[ sel ] === undefined ) {
-							matches[ sel ] = handleObj.needsContext ?
-								jQuery( sel, this ).index( cur ) >= 0 :
-								jQuery.find( sel, this, null, [ cur ] ).length;
-						}
-						if ( matches[ sel ] ) {
-							matches.push( handleObj );
-						}
-					}
-					if ( matches.length ) {
-						handlerQueue.push({ elem: cur, handlers: matches });
-					}
-				}
-			}
-		}
-
-		// Add the remaining (directly-bound) handlers
-		if ( delegateCount < handlers.length ) {
-			handlerQueue.push({ elem: this, handlers: handlers.slice( delegateCount ) });
-		}
-
-		return handlerQueue;
-	},
-
-	fix: function( event ) {
-		if ( event[ jQuery.expando ] ) {
-			return event;
-		}
-
-		// Create a writable copy of the event object and normalize some properties
-		var i, prop, copy,
-			type = event.type,
-			originalEvent = event,
-			fixHook = this.fixHooks[ type ];
-
-		if ( !fixHook ) {
-			this.fixHooks[ type ] = fixHook =
-				rmouseEvent.test( type ) ? this.mouseHooks :
-				rkeyEvent.test( type ) ? this.keyHooks :
-				{};
-		}
-		copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props;
-
-		event = new jQuery.Event( originalEvent );
-
-		i = copy.length;
-		while ( i-- ) {
-			prop = copy[ i ];
-			event[ prop ] = originalEvent[ prop ];
-		}
-
-		// Support: IE<9
-		// Fix target property (#1925)
-		if ( !event.target ) {
-			event.target = originalEvent.srcElement || document;
-		}
-
-		// Support: Chrome 23+, Safari?
-		// Target should not be a text node (#504, #13143)
-		if ( event.target.nodeType === 3 ) {
-			event.target = event.target.parentNode;
-		}
-
-		// Support: IE<9
-		// For mouse/key events, metaKey==false if it's undefined (#3368, #11328)
-		event.metaKey = !!event.metaKey;
-
-		return fixHook.filter ? fixHook.filter( event, originalEvent ) : event;
-	},
-
-	// Includes some event props shared by KeyEvent and MouseEvent
-	props: "altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),
-
-	fixHooks: {},
-
-	keyHooks: {
-		props: "char charCode key keyCode".split(" "),
-		filter: function( event, original ) {
-
-			// Add which for key events
-			if ( event.which == null ) {
-				event.which = original.charCode != null ? original.charCode : original.keyCode;
-			}
-
-			return event;
-		}
-	},
-
-	mouseHooks: {
-		props: "button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),
-		filter: function( event, original ) {
-			var body, eventDoc, doc,
-				button = original.button,
-				fromElement = original.fromElement;
-
-			// Calculate pageX/Y if missing and clientX/Y available
-			if ( event.pageX == null && original.clientX != null ) {
-				eventDoc = event.target.ownerDocument || document;
-				doc = eventDoc.documentElement;
-				body = eventDoc.body;
-
-				event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 );
-				event.pageY = original.clientY + ( doc && doc.scrollTop  || body && body.scrollTop  || 0 ) - ( doc && doc.clientTop  || body && body.clientTop  || 0 );
-			}
-
-			// Add relatedTarget, if necessary
-			if ( !event.relatedTarget && fromElement ) {
-				event.relatedTarget = fromElement === event.target ? original.toElement : fromElement;
-			}
-
-			// Add which for click: 1 === left; 2 === middle; 3 === right
-			// Note: button is not normalized, so don't use it
-			if ( !event.which && button !== undefined ) {
-				event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) );
-			}
-
-			return event;
-		}
-	},
-
-	special: {
-		load: {
-			// Prevent triggered image.load events from bubbling to window.load
-			noBubble: true
-		},
-		focus: {
-			// Fire native event if possible so blur/focus sequence is correct
-			trigger: function() {
-				if ( this !== safeActiveElement() && this.focus ) {
-					try {
-						this.focus();
-						return false;
-					} catch ( e ) {
-						// Support: IE<9
-						// If we error on focus to hidden element (#1486, #12518),
-						// let .trigger() run the handlers
-					}
-				}
-			},
-			delegateType: "focusin"
-		},
-		blur: {
-			trigger: function() {
-				if ( this === safeActiveElement() && this.blur ) {
-					this.blur();
-					return false;
-				}
-			},
-			delegateType: "focusout"
-		},
-		click: {
-			// For checkbox, fire native event so checked state will be right
-			trigger: function() {
-				if ( jQuery.nodeName( this, "input" ) && this.type === "checkbox" && this.click ) {
-					this.click();
-					return false;
-				}
-			},
-
-			// For cross-browser consistency, don't fire native .click() on links
-			_default: function( event ) {
-				return jQuery.nodeName( event.target, "a" );
-			}
-		},
-
-		beforeunload: {
-			postDispatch: function( event ) {
-
-				// Support: Firefox 20+
-				// Firefox doesn't alert if the returnValue field is not set.
-				if ( event.result !== undefined && event.originalEvent ) {
-					event.originalEvent.returnValue = event.result;
-				}
-			}
-		}
-	},
-
-	simulate: function( type, elem, event, bubble ) {
-		// Piggyback on a donor event to simulate a different one.
-		// Fake originalEvent to avoid donor's stopPropagation, but if the
-		// simulated event prevents default then we do the same on the donor.
-		var e = jQuery.extend(
-			new jQuery.Event(),
-			event,
-			{
-				type: type,
-				isSimulated: true,
-				originalEvent: {}
-			}
-		);
-		if ( bubble ) {
-			jQuery.event.trigger( e, null, elem );
-		} else {
-			jQuery.event.dispatch.call( elem, e );
-		}
-		if ( e.isDefaultPrevented() ) {
-			event.preventDefault();
-		}
-	}
-};
-
-jQuery.removeEvent = document.removeEventListener ?
-	function( elem, type, handle ) {
-		if ( elem.removeEventListener ) {
-			elem.removeEventListener( type, handle, false );
-		}
-	} :
-	function( elem, type, handle ) {
-		var name = "on" + type;
-
-		if ( elem.detachEvent ) {
-
-			// #8545, #7054, preventing memory leaks for custom events in IE6-8
-			// detachEvent needed property on element, by name of that event, to properly expose it to GC
-			if ( typeof elem[ name ] === strundefined ) {
-				elem[ name ] = null;
-			}
-
-			elem.detachEvent( name, handle );
-		}
-	};
-
-jQuery.Event = function( src, props ) {
-	// Allow instantiation without the 'new' keyword
-	if ( !(this instanceof jQuery.Event) ) {
-		return new jQuery.Event( src, props );
-	}
-
-	// Event object
-	if ( src && src.type ) {
-		this.originalEvent = src;
-		this.type = src.type;
-
-		// Events bubbling up the document may have been marked as prevented
-		// by a handler lower down the tree; reflect the correct value.
-		this.isDefaultPrevented = src.defaultPrevented ||
-				src.defaultPrevented === undefined &&
-				// Support: IE < 9, Android < 4.0
-				src.returnValue === false ?
-			returnTrue :
-			returnFalse;
-
-	// Event type
-	} else {
-		this.type = src;
-	}
-
-	// Put explicitly provided properties onto the event object
-	if ( props ) {
-		jQuery.extend( this, props );
-	}
-
-	// Create a timestamp if incoming event doesn't have one
-	this.timeStamp = src && src.timeStamp || jQuery.now();
-
-	// Mark it as fixed
-	this[ jQuery.expando ] = true;
-};
-
-// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding
-// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html
-jQuery.Event.prototype = {
-	isDefaultPrevented: returnFalse,
-	isPropagationStopped: returnFalse,
-	isImmediatePropagationStopped: returnFalse,
-
-	preventDefault: function() {
-		var e = this.originalEvent;
-
-		this.isDefaultPrevented = returnTrue;
-		if ( !e ) {
-			return;
-		}
-
-		// If preventDefault exists, run it on the original event
-		if ( e.preventDefault ) {
-			e.preventDefault();
-
-		// Support: IE
-		// Otherwise set the returnValue property of the original event to false
-		} else {
-			e.returnValue = false;
-		}
-	},
-	stopPropagation: function() {
-		var e = this.originalEvent;
-
-		this.isPropagationStopped = returnTrue;
-		if ( !e ) {
-			return;
-		}
-		// If stopPropagation exists, run it on the original event
-		if ( e.stopPropagation ) {
-			e.stopPropagation();
-		}
-
-		// Support: IE
-		// Set the cancelBubble property of the original event to true
-		e.cancelBubble = true;
-	},
-	stopImmediatePropagation: function() {
-		var e = this.originalEvent;
-
-		this.isImmediatePropagationStopped = returnTrue;
-
-		if ( e && e.stopImmediatePropagation ) {
-			e.stopImmediatePropagation();
-		}
-
-		this.stopPropagation();
-	}
-};
-
-// Create mouseenter/leave events using mouseover/out and event-time checks
-jQuery.each({
-	mouseenter: "mouseover",
-	mouseleave: "mouseout",
-	pointerenter: "pointerover",
-	pointerleave: "pointerout"
-}, function( orig, fix ) {
-	jQuery.event.special[ orig ] = {
-		delegateType: fix,
-		bindType: fix,
-
-		handle: function( event ) {
-			var ret,
-				target = this,
-				related = event.relatedTarget,
-				handleObj = event.handleObj;
-
-			// For mousenter/leave call the handler if related is outside the target.
-			// NB: No relatedTarget if the mouse left/entered the browser window
-			if ( !related || (related !== target && !jQuery.contains( target, related )) ) {
-				event.type = handleObj.origType;
-				ret = handleObj.handler.apply( this, arguments );
-				event.type = fix;
-			}
-			return ret;
-		}
-	};
-});
-
-// IE submit delegation
-if ( !support.submitBubbles ) {
-
-	jQuery.event.special.submit = {
-		setup: function() {
-			// Only need this for delegated form submit events
-			if ( jQuery.nodeName( this, "form" ) ) {
-				return false;
-			}
-
-			// Lazy-add a submit handler when a descendant form may potentially be submitted
-			jQuery.event.add( this, "click._submit keypress._submit", function( e ) {
-				// Node name check avoids a VML-related crash in IE (#9807)
-				var elem = e.target,
-					form = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.form : undefined;
-				if ( form && !jQuery._data( form, "submitBubbles" ) ) {
-					jQuery.event.add( form, "submit._submit", function( event ) {
-						event._submit_bubble = true;
-					});
-					jQuery._data( form, "submitBubbles", true );
-				}
-			});
-			// return undefined since we don't need an event listener
-		},
-
-		postDispatch: function( event ) {
-			// If form was submitted by the user, bubble the event up the tree
-			if ( event._submit_bubble ) {
-				delete event._submit_bubble;
-				if ( this.parentNode && !event.isTrigger ) {
-					jQuery.event.simulate( "submit", this.parentNode, event, true );
-				}
-			}
-		},
-
-		teardown: function() {
-			// Only need this for delegated form submit events
-			if ( jQuery.nodeName( this, "form" ) ) {
-				return false;
-			}
-
-			// Remove delegated handlers; cleanData eventually reaps submit handlers attached above
-			jQuery.event.remove( this, "._submit" );
-		}
-	};
-}
-
-// IE change delegation and checkbox/radio fix
-if ( !support.changeBubbles ) {
-
-	jQuery.event.special.change = {
-
-		setup: function() {
-
-			if ( rformElems.test( this.nodeName ) ) {
-				// IE doesn't fire change on a check/radio until blur; trigger it on click
-				// after a propertychange. Eat the blur-change in special.change.handle.
-				// This still fires onchange a second time for check/radio after blur.
-				if ( this.type === "checkbox" || this.type === "radio" ) {
-					jQuery.event.add( this, "propertychange._change", function( event ) {
-						if ( event.originalEvent.propertyName === "checked" ) {
-							this._just_changed = true;
-						}
-					});
-					jQuery.event.add( this, "click._change", function( event ) {
-						if ( this._just_changed && !event.isTrigger ) {
-							this._just_changed = false;
-						}
-						// Allow triggered, simulated change events (#11500)
-						jQuery.event.simulate( "change", this, event, true );
-					});
-				}
-				return false;
-			}
-			// Delegated event; lazy-add a change handler on descendant inputs
-			jQuery.event.add( this, "beforeactivate._change", function( e ) {
-				var elem = e.target;
-
-				if ( rformElems.test( elem.nodeName ) && !jQuery._data( elem, "changeBubbles" ) ) {
-					jQuery.event.add( elem, "change._change", function( event ) {
-						if ( this.parentNode && !event.isSimulated && !event.isTrigger ) {
-							jQuery.event.simulate( "change", this.parentNode, event, true );
-						}
-					});
-					jQuery._data( elem, "changeBubbles", true );
-				}
-			});
-		},
-
-		handle: function( event ) {
-			var elem = event.target;
-
-			// Swallow native change events from checkbox/radio, we already triggered them above
-			if ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox") ) {
-				return event.handleObj.handler.apply( this, arguments );
-			}
-		},
-
-		teardown: function() {
-			jQuery.event.remove( this, "._change" );
-
-			return !rformElems.test( this.nodeName );
-		}
-	};
-}
-
-// Create "bubbling" focus and blur events
-if ( !support.focusinBubbles ) {
-	jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) {
-
-		// Attach a single capturing handler on the document while someone wants focusin/focusout
-		var handler = function( event ) {
-				jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true );
-			};
-
-		jQuery.event.special[ fix ] = {
-			setup: function() {
-				var doc = this.ownerDocument || this,
-					attaches = jQuery._data( doc, fix );
-
-				if ( !attaches ) {
-					doc.addEventListener( orig, handler, true );
-				}
-				jQuery._data( doc, fix, ( attaches || 0 ) + 1 );
-			},
-			teardown: function() {
-				var doc = this.ownerDocument || this,
-					attaches = jQuery._data( doc, fix ) - 1;
-
-				if ( !attaches ) {
-					doc.removeEventListener( orig, handler, true );
-					jQuery._removeData( doc, fix );
-				} else {
-					jQuery._data( doc, fix, attaches );
-				}
-			}
-		};
-	});
-}
-
-jQuery.fn.extend({
-
-	on: function( types, selector, data, fn, /*INTERNAL*/ one ) {
-		var type, origFn;
-
-		// Types can be a map of types/handlers
-		if ( typeof types === "object" ) {
-			// ( types-Object, selector, data )
-			if ( typeof selector !== "string" ) {
-				// ( types-Object, data )
-				data = data || selector;
-				selector = undefined;
-			}
-			for ( type in types ) {
-				this.on( type, selector, data, types[ type ], one );
-			}
-			return this;
-		}
-
-		if ( data == null && fn == null ) {
-			// ( types, fn )
-			fn = selector;
-			data = selector = undefined;
-		} else if ( fn == null ) {
-			if ( typeof selector === "string" ) {
-				// ( types, selector, fn )
-				fn = data;
-				data = undefined;
-			} else {
-				// ( types, data, fn )
-				fn = data;
-				data = selector;
-				selector = undefined;
-			}
-		}
-		if ( fn === false ) {
-			fn = returnFalse;
-		} else if ( !fn ) {
-			return this;
-		}
-
-		if ( one === 1 ) {
-			origFn = fn;
-			fn = function( event ) {
-				// Can use an empty set, since event contains the info
-				jQuery().off( event );
-				return origFn.apply( this, arguments );
-			};
-			// Use same guid so caller can remove using origFn
-			fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
-		}
-		return this.each( function() {
-			jQuery.event.add( this, types, fn, data, selector );
-		});
-	},
-	one: function( types, selector, data, fn ) {
-		return this.on( types, selector, data, fn, 1 );
-	},
-	off: function( types, selector, fn ) {
-		var handleObj, type;
-		if ( types && types.preventDefault && types.handleObj ) {
-			// ( event )  dispatched jQuery.Event
-			handleObj = types.handleObj;
-			jQuery( types.delegateTarget ).off(
-				handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType,
-				handleObj.selector,
-				handleObj.handler
-			);
-			return this;
-		}
-		if ( typeof types === "object" ) {
-			// ( types-object [, selector] )
-			for ( type in types ) {
-				this.off( type, selector, types[ type ] );
-			}
-			return this;
-		}
-		if ( selector === false || typeof selector === "function" ) {
-			// ( types [, fn] )
-			fn = selector;
-			selector = undefined;
-		}
-		if ( fn === false ) {
-			fn = returnFalse;
-		}
-		return this.each(function() {
-			jQuery.event.remove( this, types, fn, selector );
-		});
-	},
-
-	trigger: function( type, data ) {
-		return this.each(function() {
-			jQuery.event.trigger( type, data, this );
-		});
-	},
-	triggerHandler: function( type, data ) {
-		var elem = this[0];
-		if ( elem ) {
-			return jQuery.event.trigger( type, data, elem, true );
-		}
-	}
-});
-
-
-function createSafeFragment( document ) {
-	var list = nodeNames.split( "|" ),
-		safeFrag = document.createDocumentFragment();
-
-	if ( safeFrag.createElement ) {
-		while ( list.length ) {
-			safeFrag.createElement(
-				list.pop()
-			);
-		}
-	}
-	return safeFrag;
-}
-
-var nodeNames = "abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|" +
-		"header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",
-	rinlinejQuery = / jQuery\d+="(?:null|\d+)"/g,
-	rnoshimcache = new RegExp("<(?:" + nodeNames + ")[\\s/>]", "i"),
-	rleadingWhitespace = /^\s+/,
-	rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,
-	rtagName = /<([\w:]+)/,
-	rtbody = /<tbody/i,
-	rhtml = /<|&#?\w+;/,
-	rnoInnerhtml = /<(?:script|style|link)/i,
-	// checked="checked" or checked
-	rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i,
-	rscriptType = /^$|\/(?:java|ecma)script/i,
-	rscriptTypeMasked = /^true\/(.*)/,
-	rcleanScript = /^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g,
-
-	// We have to close these tags to support XHTML (#13200)
-	wrapMap = {
-		option: [ 1, "<select multiple='multiple'>", "</select>" ],
-		legend: [ 1, "<fieldset>", "</fieldset>" ],
-		area: [ 1, "<map>", "</map>" ],
-		param: [ 1, "<object>", "</object>" ],
-		thead: [ 1, "<table>", "</table>" ],
-		tr: [ 2, "<table><tbody>", "</tbody></table>" ],
-		col: [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ],
-		td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
-
-		// IE6-8 can't serialize link, script, style, or any html5 (NoScope) tags,
-		// unless wrapped in a div with non-breaking characters in front of it.
-		_default: support.htmlSerialize ? [ 0, "", "" ] : [ 1, "X<div>", "</div>"  ]
-	},
-	safeFragment = createSafeFragment( document ),
-	fragmentDiv = safeFragment.appendChild( document.createElement("div") );
-
-wrapMap.optgroup = wrapMap.option;
-wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
-wrapMap.th = wrapMap.td;
-
-function getAll( context, tag ) {
-	var elems, elem,
-		i = 0,
-		found = typeof context.getElementsByTagName !== strundefined ? context.getElementsByTagName( tag || "*" ) :
-			typeof context.querySelectorAll !== strundefined ? context.querySelectorAll( tag || "*" ) :
-			undefined;
-
-	if ( !found ) {
-		for ( found = [], elems = context.childNodes || context; (elem = elems[i]) != null; i++ ) {
-			if ( !tag || jQuery.nodeName( elem, tag ) ) {
-				found.push( elem );
-			} else {
-				jQuery.merge( found, getAll( elem, tag ) );
-			}
-		}
-	}
-
-	return tag === undefined || tag && jQuery.nodeName( context, tag ) ?
-		jQuery.merge( [ context ], found ) :
-		found;
-}
-
-// Used in buildFragment, fixes the defaultChecked property
-function fixDefaultChecked( elem ) {
-	if ( rcheckableType.test( elem.type ) ) {
-		elem.defaultChecked = elem.checked;
-	}
-}
-
-// Support: IE<8
-// Manipulating tables requires a tbody
-function manipulationTarget( elem, content ) {
-	return jQuery.nodeName( elem, "table" ) &&
-		jQuery.nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ?
-
-		elem.getElementsByTagName("tbody")[0] ||
-			elem.appendChild( elem.ownerDocument.createElement("tbody") ) :
-		elem;
-}
-
-// Replace/restore the type attribute of script elements for safe DOM manipulation
-function disableScript( elem ) {
-	elem.type = (jQuery.find.attr( elem, "type" ) !== null) + "/" + elem.type;
-	return elem;
-}
-function restoreScript( elem ) {
-	var match = rscriptTypeMasked.exec( elem.type );
-	if ( match ) {
-		elem.type = match[1];
-	} else {
-		elem.removeAttribute("type");
-	}
-	return elem;
-}
-
-// Mark scripts as having already been evaluated
-function setGlobalEval( elems, refElements ) {
-	var elem,
-		i = 0;
-	for ( ; (elem = elems[i]) != null; i++ ) {
-		jQuery._data( elem, "globalEval", !refElements || jQuery._data( refElements[i], "globalEval" ) );
-	}
-}
-
-function cloneCopyEvent( src, dest ) {
-
-	if ( dest.nodeType !== 1 || !jQuery.hasData( src ) ) {
-		return;
-	}
-
-	var type, i, l,
-		oldData = jQuery._data( src ),
-		curData = jQuery._data( dest, oldData ),
-		events = oldData.events;
-
-	if ( events ) {
-		delete curData.handle;
-		curData.events = {};
-
-		for ( type in events ) {
-			for ( i = 0, l = events[ type ].length; i < l; i++ ) {
-				jQuery.event.add( dest, type, events[ type ][ i ] );
-			}
-		}
-	}
-
-	// make the cloned public data object a copy from the original
-	if ( curData.data ) {
-		curData.data = jQuery.extend( {}, curData.data );
-	}
-}
-
-function fixCloneNodeIssues( src, dest ) {
-	var nodeName, e, data;
-
-	// We do not need to do anything for non-Elements
-	if ( dest.nodeType !== 1 ) {
-		return;
-	}
-
-	nodeName = dest.nodeName.toLowerCase();
-
-	// IE6-8 copies events bound via attachEvent when using cloneNode.
-	if ( !support.noCloneEvent && dest[ jQuery.expando ] ) {
-		data = jQuery._data( dest );
-
-		for ( e in data.events ) {
-			jQuery.removeEvent( dest, e, data.handle );
-		}
-
-		// Event data gets referenced instead of copied if the expando gets copied too
-		dest.removeAttribute( jQuery.expando );
-	}
-
-	// IE blanks contents when cloning scripts, and tries to evaluate newly-set text
-	if ( nodeName === "script" && dest.text !== src.text ) {
-		disableScript( dest ).text = src.text;
-		restoreScript( dest );
-
-	// IE6-10 improperly clones children of object elements using classid.
-	// IE10 throws NoModificationAllowedError if parent is null, #12132.
-	} else if ( nodeName === "object" ) {
-		if ( dest.parentNode ) {
-			dest.outerHTML = src.outerHTML;
-		}
-
-		// This path appears unavoidable for IE9. When cloning an object
-		// element in IE9, the outerHTML strategy above is not sufficient.
-		// If the src has innerHTML and the destination does not,
-		// copy the src.innerHTML into the dest.innerHTML. #10324
-		if ( support.html5Clone && ( src.innerHTML && !jQuery.trim(dest.innerHTML) ) ) {
-			dest.innerHTML = src.innerHTML;
-		}
-
-	} else if ( nodeName === "input" && rcheckableType.test( src.type ) ) {
-		// IE6-8 fails to persist the checked state of a cloned checkbox
-		// or radio button. Worse, IE6-7 fail to give the cloned element
-		// a checked appearance if the defaultChecked value isn't also set
-
-		dest.defaultChecked = dest.checked = src.checked;
-
-		// IE6-7 get confused and end up setting the value of a cloned
-		// checkbox/radio button to an empty string instead of "on"
-		if ( dest.value !== src.value ) {
-			dest.value = src.value;
-		}
-
-	// IE6-8 fails to return the selected option to the default selected
-	// state when cloning options
-	} else if ( nodeName === "option" ) {
-		dest.defaultSelected = dest.selected = src.defaultSelected;
-
-	// IE6-8 fails to set the defaultValue to the correct value when
-	// cloning other types of input fields
-	} else if ( nodeName === "input" || nodeName === "textarea" ) {
-		dest.defaultValue = src.defaultValue;
-	}
-}
-
-jQuery.extend({
-	clone: function( elem, dataAndEvents, deepDataAndEvents ) {
-		var destElements, node, clone, i, srcElements,
-			inPage = jQuery.contains( elem.ownerDocument, elem );
-
-		if ( support.html5Clone || jQuery.isXMLDoc(elem) || !rnoshimcache.test( "<" + elem.nodeName + ">" ) ) {
-			clone = elem.cloneNode( true );
-
-		// IE<=8 does not properly clone detached, unknown element nodes
-		} else {
-			fragmentDiv.innerHTML = elem.outerHTML;
-			fragmentDiv.removeChild( clone = fragmentDiv.firstChild );
-		}
-
-		if ( (!support.noCloneEvent || !support.noCloneChecked) &&
-				(elem.nodeType === 1 || elem.nodeType === 11) && !jQuery.isXMLDoc(elem) ) {
-
-			// We eschew Sizzle here for performance reasons: http://jsperf.com/getall-vs-sizzle/2
-			destElements = getAll( clone );
-			srcElements = getAll( elem );
-
-			// Fix all IE cloning issues
-			for ( i = 0; (node = srcElements[i]) != null; ++i ) {
-				// Ensure that the destination node is not null; Fixes #9587
-				if ( destElements[i] ) {
-					fixCloneNodeIssues( node, destElements[i] );
-				}
-			}
-		}
-
-		// Copy the events from the original to the clone
-		if ( dataAndEvents ) {
-			if ( deepDataAndEvents ) {
-				srcElements = srcElements || getAll( elem );
-				destElements = destElements || getAll( clone );
-
-				for ( i = 0; (node = srcElements[i]) != null; i++ ) {
-					cloneCopyEvent( node, destElements[i] );
-				}
-			} else {
-				cloneCopyEvent( elem, clone );
-			}
-		}
-
-		// Preserve script evaluation history
-		destElements = getAll( clone, "script" );
-		if ( destElements.length > 0 ) {
-			setGlobalEval( destElements, !inPage && getAll( elem, "script" ) );
-		}
-
-		destElements = srcElements = node = null;
-
-		// Return the cloned set
-		return clone;
-	},
-
-	buildFragment: function( elems, context, scripts, selection ) {
-		var j, elem, contains,
-			tmp, tag, tbody, wrap,
-			l = elems.length,
-
-			// Ensure a safe fragment
-			safe = createSafeFragment( context ),
-
-			nodes = [],
-			i = 0;
-
-		for ( ; i < l; i++ ) {
-			elem = elems[ i ];
-
-			if ( elem || elem === 0 ) {
-
-				// Add nodes directly
-				if ( jQuery.type( elem ) === "object" ) {
-					jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem );
-
-				// Convert non-html into a text node
-				} else if ( !rhtml.test( elem ) ) {
-					nodes.push( context.createTextNode( elem ) );
-
-				// Convert html into DOM nodes
-				} else {
-					tmp = tmp || safe.appendChild( context.createElement("div") );
-
-					// Deserialize a standard representation
-					tag = (rtagName.exec( elem ) || [ "", "" ])[ 1 ].toLowerCase();
-					wrap = wrapMap[ tag ] || wrapMap._default;
-
-					tmp.innerHTML = wrap[1] + elem.replace( rxhtmlTag, "<$1></$2>" ) + wrap[2];
-
-					// Descend through wrappers to the right content
-					j = wrap[0];
-					while ( j-- ) {
-						tmp = tmp.lastChild;
-					}
-
-					// Manually add leading whitespace removed by IE
-					if ( !support.leadingWhitespace && rleadingWhitespace.test( elem ) ) {
-						nodes.push( context.createTextNode( rleadingWhitespace.exec( elem )[0] ) );
-					}
-
-					// Remove IE's autoinserted <tbody> from table fragments
-					if ( !support.tbody ) {
-
-						// String was a <table>, *may* have spurious <tbody>
-						elem = tag === "table" && !rtbody.test( elem ) ?
-							tmp.firstChild :
-
-							// String was a bare <thead> or <tfoot>
-							wrap[1] === "<table>" && !rtbody.test( elem ) ?
-								tmp :
-								0;
-
-						j = elem && elem.childNodes.length;
-						while ( j-- ) {
-							if ( jQuery.nodeName( (tbody = elem.childNodes[j]), "tbody" ) && !tbody.childNodes.length ) {
-								elem.removeChild( tbody );
-							}
-						}
-					}
-
-					jQuery.merge( nodes, tmp.childNodes );
-
-					// Fix #12392 for WebKit and IE > 9
-					tmp.textContent = "";
-
-					// Fix #12392 for oldIE
-					while ( tmp.firstChild ) {
-						tmp.removeChild( tmp.firstChild );
-					}
-
-					// Remember the top-level container for proper cleanup
-					tmp = safe.lastChild;
-				}
-			}
-		}
-
-		// Fix #11356: Clear elements from fragment
-		if ( tmp ) {
-			safe.removeChild( tmp );
-		}
-
-		// Reset defaultChecked for any radios and checkboxes
-		// about to be appended to the DOM in IE 6/7 (#8060)
-		if ( !support.appendChecked ) {
-			jQuery.grep( getAll( nodes, "input" ), fixDefaultChecked );
-		}
-
-		i = 0;
-		while ( (elem = nodes[ i++ ]) ) {
-
-			// #4087 - If origin and destination elements are the same, and this is
-			// that element, do not do anything
-			if ( selection && jQuery.inArray( elem, selection ) !== -1 ) {
-				continue;
-			}
-
-			contains = jQuery.contains( elem.ownerDocument, elem );
-
-			// Append to fragment
-			tmp = getAll( safe.appendChild( elem ), "script" );
-
-			// Preserve script evaluation history
-			if ( contains ) {
-				setGlobalEval( tmp );
-			}
-
-			// Capture executables
-			if ( scripts ) {
-				j = 0;
-				while ( (elem = tmp[ j++ ]) ) {
-					if ( rscriptType.test( elem.type || "" ) ) {
-						scripts.push( elem );
-					}
-				}
-			}
-		}
-
-		tmp = null;
-
-		return safe;
-	},
-
-	cleanData: function( elems, /* internal */ acceptData ) {
-		var elem, type, id, data,
-			i = 0,
-			internalKey = jQuery.expando,
-			cache = jQuery.cache,
-			deleteExpando = support.deleteExpando,
-			special = jQuery.event.special;
-
-		for ( ; (elem = elems[i]) != null; i++ ) {
-			if ( acceptData || jQuery.acceptData( elem ) ) {
-
-				id = elem[ internalKey ];
-				data = id && cache[ id ];
-
-				if ( data ) {
-					if ( data.events ) {
-						for ( type in data.events ) {
-							if ( special[ type ] ) {
-								jQuery.event.remove( elem, type );
-
-							// This is a shortcut to avoid jQuery.event.remove's overhead
-							} else {
-								jQuery.removeEvent( elem, type, data.handle );
-							}
-						}
-					}
-
-					// Remove cache only if it was not already removed by jQuery.event.remove
-					if ( cache[ id ] ) {
-
-						delete cache[ id ];
-
-						// IE does not allow us to delete expando properties from nodes,
-						// nor does it have a removeAttribute function on Document nodes;
-						// we must handle all of these cases
-						if ( deleteExpando ) {
-							delete elem[ internalKey ];
-
-						} else if ( typeof elem.removeAttribute !== strundefined ) {
-							elem.removeAttribute( internalKey );
-
-						} else {
-							elem[ internalKey ] = null;
-						}
-
-						deletedIds.push( id );
-					}
-				}
-			}
-		}
-	}
-});
-
-jQuery.fn.extend({
-	text: function( value ) {
-		return access( this, function( value ) {
-			return value === undefined ?
-				jQuery.text( this ) :
-				this.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) );
-		}, null, value, arguments.length );
-	},
-
-	append: function() {
-		return this.domManip( arguments, function( elem ) {
-			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
-				var target = manipulationTarget( this, elem );
-				target.appendChild( elem );
-			}
-		});
-	},
-
-	prepend: function() {
-		return this.domManip( arguments, function( elem ) {
-			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
-				var target = manipulationTarget( this, elem );
-				target.insertBefore( elem, target.firstChild );
-			}
-		});
-	},
-
-	before: function() {
-		return this.domManip( arguments, function( elem ) {
-			if ( this.parentNode ) {
-				this.parentNode.insertBefore( elem, this );
-			}
-		});
-	},
-
-	after: function() {
-		return this.domManip( arguments, function( elem ) {
-			if ( this.parentNode ) {
-				this.parentNode.insertBefore( elem, this.nextSibling );
-			}
-		});
-	},
-
-	remove: function( selector, keepData /* Internal Use Only */ ) {
-		var elem,
-			elems = selector ? jQuery.filter( selector, this ) : this,
-			i = 0;
-
-		for ( ; (elem = elems[i]) != null; i++ ) {
-
-			if ( !keepData && elem.nodeType === 1 ) {
-				jQuery.cleanData( getAll( elem ) );
-			}
-
-			if ( elem.parentNode ) {
-				if ( keepData && jQuery.contains( elem.ownerDocument, elem ) ) {
-					setGlobalEval( getAll( elem, "script" ) );
-				}
-				elem.parentNode.removeChild( elem );
-			}
-		}
-
-		return this;
-	},
-
-	empty: function() {
-		var elem,
-			i = 0;
-
-		for ( ; (elem = this[i]) != null; i++ ) {
-			// Remove element nodes and prevent memory leaks
-			if ( elem.nodeType === 1 ) {
-				jQuery.cleanData( getAll( elem, false ) );
-			}
-
-			// Remove any remaining nodes
-			while ( elem.firstChild ) {
-				elem.removeChild( elem.firstChild );
-			}
-
-			// If this is a select, ensure that it displays empty (#12336)
-			// Support: IE<9
-			if ( elem.options && jQuery.nodeName( elem, "select" ) ) {
-				elem.options.length = 0;
-			}
-		}
-
-		return this;
-	},
-
-	clone: function( dataAndEvents, deepDataAndEvents ) {
-		dataAndEvents = dataAndEvents == null ? false : dataAndEvents;
-		deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;
-
-		return this.map(function() {
-			return jQuery.clone( this, dataAndEvents, deepDataAndEvents );
-		});
-	},
-
-	html: function( value ) {
-		return access( this, function( value ) {
-			var elem = this[ 0 ] || {},
-				i = 0,
-				l = this.length;
-
-			if ( value === undefined ) {
-				return elem.nodeType === 1 ?
-					elem.innerHTML.replace( rinlinejQuery, "" ) :
-					undefined;
-			}
-
-			// See if we can take a shortcut and just use innerHTML
-			if ( typeof value === "string" && !rnoInnerhtml.test( value ) &&
-				( support.htmlSerialize || !rnoshimcache.test( value )  ) &&
-				( support.leadingWhitespace || !rleadingWhitespace.test( value ) ) &&
-				!wrapMap[ (rtagName.exec( value ) || [ "", "" ])[ 1 ].toLowerCase() ] ) {
-
-				value = value.replace( rxhtmlTag, "<$1></$2>" );
-
-				try {
-					for (; i < l; i++ ) {
-						// Remove element nodes and prevent memory leaks
-						elem = this[i] || {};
-						if ( elem.nodeType === 1 ) {
-							jQuery.cleanData( getAll( elem, false ) );
-							elem.innerHTML = value;
-						}
-					}
-
-					elem = 0;
-
-				// If using innerHTML throws an exception, use the fallback method
-				} catch(e) {}
-			}
-
-			if ( elem ) {
-				this.empty().append( value );
-			}
-		}, null, value, arguments.length );
-	},
-
-	replaceWith: function() {
-		var arg = arguments[ 0 ];
-
-		// Make the changes, replacing each context element with the new content
-		this.domManip( arguments, function( elem ) {
-			arg = this.parentNode;
-
-			jQuery.cleanData( getAll( this ) );
-
-			if ( arg ) {
-				arg.replaceChild( elem, this );
-			}
-		});
-
-		// Force removal if there was no new content (e.g., from empty arguments)
-		return arg && (arg.length || arg.nodeType) ? this : this.remove();
-	},
-
-	detach: function( selector ) {
-		return this.remove( selector, true );
-	},
-
-	domManip: function( args, callback ) {
-
-		// Flatten any nested arrays
-		args = concat.apply( [], args );
-
-		var first, node, hasScripts,
-			scripts, doc, fragment,
-			i = 0,
-			l = this.length,
-			set = this,
-			iNoClone = l - 1,
-			value = args[0],
-			isFunction = jQuery.isFunction( value );
-
-		// We can't cloneNode fragments that contain checked, in WebKit
-		if ( isFunction ||
-				( l > 1 && typeof value === "string" &&
-					!support.checkClone && rchecked.test( value ) ) ) {
-			return this.each(function( index ) {
-				var self = set.eq( index );
-				if ( isFunction ) {
-					args[0] = value.call( this, index, self.html() );
-				}
-				self.domManip( args, callback );
-			});
-		}
-
-		if ( l ) {
-			fragment = jQuery.buildFragment( args, this[ 0 ].ownerDocument, false, this );
-			first = fragment.firstChild;
-
-			if ( fragment.childNodes.length === 1 ) {
-				fragment = first;
-			}
-
-			if ( first ) {
-				scripts = jQuery.map( getAll( fragment, "script" ), disableScript );
-				hasScripts = scripts.length;
-
-				// Use the original fragment for the last item instead of the first because it can end up
-				// being emptied incorrectly in certain situations (#8070).
-				for ( ; i < l; i++ ) {
-					node = fragment;
-
-					if ( i !== iNoClone ) {
-						node = jQuery.clone( node, true, true );
-
-						// Keep references to cloned scripts for later restoration
-						if ( hasScripts ) {
-							jQuery.merge( scripts, getAll( node, "script" ) );
-						}
-					}
-
-					callback.call( this[i], node, i );
-				}
-
-				if ( hasScripts ) {
-					doc = scripts[ scripts.length - 1 ].ownerDocument;
-
-					// Reenable scripts
-					jQuery.map( scripts, restoreScript );
-
-					// Evaluate executable scripts on first document insertion
-					for ( i = 0; i < hasScripts; i++ ) {
-						node = scripts[ i ];
-						if ( rscriptType.test( node.type || "" ) &&
-							!jQuery._data( node, "globalEval" ) && jQuery.contains( doc, node ) ) {
-
-							if ( node.src ) {
-								// Optional AJAX dependency, but won't run scripts if not present
-								if ( jQuery._evalUrl ) {
-									jQuery._evalUrl( node.src );
-								}
-							} else {
-								jQuery.globalEval( ( node.text || node.textContent || node.innerHTML || "" ).replace( rcleanScript, "" ) );
-							}
-						}
-					}
-				}
-
-				// Fix #11809: Avoid leaking memory
-				fragment = first = null;
-			}
-		}
-
-		return this;
-	}
-});
-
-jQuery.each({
-	appendTo: "append",
-	prependTo: "prepend",
-	insertBefore: "before",
-	insertAfter: "after",
-	replaceAll: "replaceWith"
-}, function( name, original ) {
-	jQuery.fn[ name ] = function( selector ) {
-		var elems,
-			i = 0,
-			ret = [],
-			insert = jQuery( selector ),
-			last = insert.length - 1;
-
-		for ( ; i <= last; i++ ) {
-			elems = i === last ? this : this.clone(true);
-			jQuery( insert[i] )[ original ]( elems );
-
-			// Modern browsers can apply jQuery collections as arrays, but oldIE needs a .get()
-			push.apply( ret, elems.get() );
-		}
-
-		return this.pushStack( ret );
-	};
-});
-
-
-var iframe,
-	elemdisplay = {};
-
-/**
- * Retrieve the actual display of a element
- * @param {String} name nodeName of the element
- * @param {Object} doc Document object
- */
-// Called only from within defaultDisplay
-function actualDisplay( name, doc ) {
-	var style,
-		elem = jQuery( doc.createElement( name ) ).appendTo( doc.body ),
-
-		// getDefaultComputedStyle might be reliably used only on attached element
-		display = window.getDefaultComputedStyle && ( style = window.getDefaultComputedStyle( elem[ 0 ] ) ) ?
-
-			// Use of this method is a temporary fix (more like optmization) until something better comes along,
-			// since it was removed from specification and supported only in FF
-			style.display : jQuery.css( elem[ 0 ], "display" );
-
-	// We don't have any data stored on the element,
-	// so use "detach" method as fast way to get rid of the element
-	elem.detach();
-
-	return display;
-}
-
-/**
- * Try to determine the default display value of an element
- * @param {String} nodeName
- */
-function defaultDisplay( nodeName ) {
-	var doc = document,
-		display = elemdisplay[ nodeName ];
-
-	if ( !display ) {
-		display = actualDisplay( nodeName, doc );
-
-		// If the simple way fails, read from inside an iframe
-		if ( display === "none" || !display ) {
-
-			// Use the already-created iframe if possible
-			iframe = (iframe || jQuery( "<iframe frameborder='0' width='0' height='0'/>" )).appendTo( doc.documentElement );
-
-			// Always write a new HTML skeleton so Webkit and Firefox don't choke on reuse
-			doc = ( iframe[ 0 ].contentWindow || iframe[ 0 ].contentDocument ).document;
-
-			// Support: IE
-			doc.write();
-			doc.close();
-
-			display = actualDisplay( nodeName, doc );
-			iframe.detach();
-		}
-
-		// Store the correct default display
-		elemdisplay[ nodeName ] = display;
-	}
-
-	return display;
-}
-
-
-(function() {
-	var shrinkWrapBlocksVal;
-
-	support.shrinkWrapBlocks = function() {
-		if ( shrinkWrapBlocksVal != null ) {
-			return shrinkWrapBlocksVal;
-		}
-
-		// Will be changed later if needed.
-		shrinkWrapBlocksVal = false;
-
-		// Minified: var b,c,d
-		var div, body, container;
-
-		body = document.getElementsByTagName( "body" )[ 0 ];
-		if ( !body || !body.style ) {
-			// Test fired too early or in an unsupported environment, exit.
-			return;
-		}
-
-		// Setup
-		div = document.createElement( "div" );
-		container = document.createElement( "div" );
-		container.style.cssText = "position:absolute;border:0;width:0;height:0;top:0;left:-9999px";
-		body.appendChild( container ).appendChild( div );
-
-		// Support: IE6
-		// Check if elements with layout shrink-wrap their children
-		if ( typeof div.style.zoom !== strundefined ) {
-			// Reset CSS: box-sizing; display; margin; border
-			div.style.cssText =
-				// Support: Firefox<29, Android 2.3
-				// Vendor-prefix box-sizing
-				"-webkit-box-sizing:content-box;-moz-box-sizing:content-box;" +
-				"box-sizing:content-box;display:block;margin:0;border:0;" +
-				"padding:1px;width:1px;zoom:1";
-			div.appendChild( document.createElement( "div" ) ).style.width = "5px";
-			shrinkWrapBlocksVal = div.offsetWidth !== 3;
-		}
-
-		body.removeChild( container );
-
-		return shrinkWrapBlocksVal;
-	};
-
-})();
-var rmargin = (/^margin/);
-
-var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" );
-
-
-
-var getStyles, curCSS,
-	rposition = /^(top|right|bottom|left)$/;
-
-if ( window.getComputedStyle ) {
-	getStyles = function( elem ) {
-		return elem.ownerDocument.defaultView.getComputedStyle( elem, null );
-	};
-
-	curCSS = function( elem, name, computed ) {
-		var width, minWidth, maxWidth, ret,
-			style = elem.style;
-
-		computed = computed || getStyles( elem );
-
-		// getPropertyValue is only needed for .css('filter') in IE9, see #12537
-		ret = computed ? computed.getPropertyValue( name ) || computed[ name ] : undefined;
-
-		if ( computed ) {
-
-			if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) {
-				ret = jQuery.style( elem, name );
-			}
-
-			// A tribute to the "awesome hack by Dean Edwards"
-			// Chrome < 17 and Safari 5.0 uses "computed value" instead of "used value" for margin-right
-			// Safari 5.1.7 (at least) returns percentage for a larger set of values, but width seems to be reliably pixels
-			// this is against the CSSOM draft spec: http://dev.w3.org/csswg/cssom/#resolved-values
-			if ( rnumnonpx.test( ret ) && rmargin.test( name ) ) {
-
-				// Remember the original values
-				width = style.width;
-				minWidth = style.minWidth;
-				maxWidth = style.maxWidth;
-
-				// Put in the new values to get a computed value out
-				style.minWidth = style.maxWidth = style.width = ret;
-				ret = computed.width;
-
-				// Revert the changed values
-				style.width = width;
-				style.minWidth = minWidth;
-				style.maxWidth = maxWidth;
-			}
-		}
-
-		// Support: IE
-		// IE returns zIndex value as an integer.
-		return ret === undefined ?
-			ret :
-			ret + "";
-	};
-} else if ( document.documentElement.currentStyle ) {
-	getStyles = function( elem ) {
-		return elem.currentStyle;
-	};
-
-	curCSS = function( elem, name, computed ) {
-		var left, rs, rsLeft, ret,
-			style = elem.style;
-
-		computed = computed || getStyles( elem );
-		ret = computed ? computed[ name ] : undefined;
-
-		// Avoid setting ret to empty string here
-		// so we don't default to auto
-		if ( ret == null && style && style[ name ] ) {
-			ret = style[ name ];
-		}
-
-		// From the awesome hack by Dean Edwards
-		// http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291
-
-		// If we're not dealing with a regular pixel number
-		// but a number that has a weird ending, we need to convert it to pixels
-		// but not position css attributes, as those are proportional to the parent element instead
-		// and we can't measure the parent instead because it might trigger a "stacking dolls" problem
-		if ( rnumnonpx.test( ret ) && !rposition.test( name ) ) {
-
-			// Remember the original values
-			left = style.left;
-			rs = elem.runtimeStyle;
-			rsLeft = rs && rs.left;
-
-			// Put in the new values to get a computed value out
-			if ( rsLeft ) {
-				rs.left = elem.currentStyle.left;
-			}
-			style.left = name === "fontSize" ? "1em" : ret;
-			ret = style.pixelLeft + "px";
-
-			// Revert the changed values
-			style.left = left;
-			if ( rsLeft ) {
-				rs.left = rsLeft;
-			}
-		}
-
-		// Support: IE
-		// IE returns zIndex value as an integer.
-		return ret === undefined ?
-			ret :
-			ret + "" || "auto";
-	};
-}
-
-
-
-
-function addGetHookIf( conditionFn, hookFn ) {
-	// Define the hook, we'll check on the first run if it's really needed.
-	return {
-		get: function() {
-			var condition = conditionFn();
-
-			if ( condition == null ) {
-				// The test was not ready at this point; screw the hook this time
-				// but check again when needed next time.
-				return;
-			}
-
-			if ( condition ) {
-				// Hook not needed (or it's not possible to use it due to missing dependency),
-				// remove it.
-				// Since there are no other hooks for marginRight, remove the whole object.
-				delete this.get;
-				return;
-			}
-
-			// Hook needed; redefine it so that the support test is not executed again.
-
-			return (this.get = hookFn).apply( this, arguments );
-		}
-	};
-}
-
-
-(function() {
-	// Minified: var b,c,d,e,f,g, h,i
-	var div, style, a, pixelPositionVal, boxSizingReliableVal,
-		reliableHiddenOffsetsVal, reliableMarginRightVal;
-
-	// Setup
-	div = document.createElement( "div" );
-	div.innerHTML = "  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>";
-	a = div.getElementsByTagName( "a" )[ 0 ];
-	style = a && a.style;
-
-	// Finish early in limited (non-browser) environments
-	if ( !style ) {
-		return;
-	}
-
-	style.cssText = "float:left;opacity:.5";
-
-	// Support: IE<9
-	// Make sure that element opacity exists (as opposed to filter)
-	support.opacity = style.opacity === "0.5";
-
-	// Verify style float existence
-	// (IE uses styleFloat instead of cssFloat)
-	support.cssFloat = !!style.cssFloat;
-
-	div.style.backgroundClip = "content-box";
-	div.cloneNode( true ).style.backgroundClip = "";
-	support.clearCloneStyle = div.style.backgroundClip === "content-box";
-
-	// Support: Firefox<29, Android 2.3
-	// Vendor-prefix box-sizing
-	support.boxSizing = style.boxSizing === "" || style.MozBoxSizing === "" ||
-		style.WebkitBoxSizing === "";
-
-	jQuery.extend(support, {
-		reliableHiddenOffsets: function() {
-			if ( reliableHiddenOffsetsVal == null ) {
-				computeStyleTests();
-			}
-			return reliableHiddenOffsetsVal;
-		},
-
-		boxSizingReliable: function() {
-			if ( boxSizingReliableVal == null ) {
-				computeStyleTests();
-			}
-			return boxSizingReliableVal;
-		},
-
-		pixelPosition: function() {
-			if ( pixelPositionVal == null ) {
-				computeStyleTests();
-			}
-			return pixelPositionVal;
-		},
-
-		// Support: Android 2.3
-		reliableMarginRight: function() {
-			if ( reliableMarginRightVal == null ) {
-				computeStyleTests();
-			}
-			return reliableMarginRightVal;
-		}
-	});
-
-	function computeStyleTests() {
-		// Minified: var b,c,d,j
-		var div, body, container, contents;
-
-		body = document.getElementsByTagName( "body" )[ 0 ];
-		if ( !body || !body.style ) {
-			// Test fired too early or in an unsupported environment, exit.
-			return;
-		}
-
-		// Setup
-		div = document.createElement( "div" );
-		container = document.createElement( "div" );
-		container.style.cssText = "position:absolute;border:0;width:0;height:0;top:0;left:-9999px";
-		body.appendChild( container ).appendChild( div );
-
-		div.style.cssText =
-			// Support: Firefox<29, Android 2.3
-			// Vendor-prefix box-sizing
-			"-webkit-box-sizing:border-box;-moz-box-sizing:border-box;" +
-			"box-sizing:border-box;display:block;margin-top:1%;top:1%;" +
-			"border:1px;padding:1px;width:4px;position:absolute";
-
-		// Support: IE<9
-		// Assume reasonable values in the absence of getComputedStyle
-		pixelPositionVal = boxSizingReliableVal = false;
-		reliableMarginRightVal = true;
-
-		// Check for getComputedStyle so that this code is not run in IE<9.
-		if ( window.getComputedStyle ) {
-			pixelPositionVal = ( window.getComputedStyle( div, null ) || {} ).top !== "1%";
-			boxSizingReliableVal =
-				( window.getComputedStyle( div, null ) || { width: "4px" } ).width === "4px";
-
-			// Support: Android 2.3
-			// Div with explicit width and no margin-right incorrectly
-			// gets computed margin-right based on width of container (#3333)
-			// WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right
-			contents = div.appendChild( document.createElement( "div" ) );
-
-			// Reset CSS: box-sizing; display; margin; border; padding
-			contents.style.cssText = div.style.cssText =
-				// Support: Firefox<29, Android 2.3
-				// Vendor-prefix box-sizing
-				"-webkit-box-sizing:content-box;-moz-box-sizing:content-box;" +
-				"box-sizing:content-box;display:block;margin:0;border:0;padding:0";
-			contents.style.marginRight = contents.style.width = "0";
-			div.style.width = "1px";
-
-			reliableMarginRightVal =
-				!parseFloat( ( window.getComputedStyle( contents, null ) || {} ).marginRight );
-		}
-
-		// Support: IE8
-		// Check if table cells still have offsetWidth/Height when they are set
-		// to display:none and there are still other visible table cells in a
-		// table row; if so, offsetWidth/Height are not reliable for use when
-		// determining if an element has been hidden directly using
-		// display:none (it is still safe to use offsets if a parent element is
-		// hidden; don safety goggles and see bug #4512 for more information).
-		div.innerHTML = "<table><tr><td></td><td>t</td></tr></table>";
-		contents = div.getElementsByTagName( "td" );
-		contents[ 0 ].style.cssText = "margin:0;border:0;padding:0;display:none";
-		reliableHiddenOffsetsVal = contents[ 0 ].offsetHeight === 0;
-		if ( reliableHiddenOffsetsVal ) {
-			contents[ 0 ].style.display = "";
-			contents[ 1 ].style.display = "none";
-			reliableHiddenOffsetsVal = contents[ 0 ].offsetHeight === 0;
-		}
-
-		body.removeChild( container );
-	}
-
-})();
-
-
-// A method for quickly swapping in/out CSS properties to get correct calculations.
-jQuery.swap = function( elem, options, callback, args ) {
-	var ret, name,
-		old = {};
-
-	// Remember the old values, and insert the new ones
-	for ( name in options ) {
-		old[ name ] = elem.style[ name ];
-		elem.style[ name ] = options[ name ];
-	}
-
-	ret = callback.apply( elem, args || [] );
-
-	// Revert the old values
-	for ( name in options ) {
-		elem.style[ name ] = old[ name ];
-	}
-
-	return ret;
-};
-
-
-var
-		ralpha = /alpha\([^)]*\)/i,
-	ropacity = /opacity\s*=\s*([^)]*)/,
-
-	// swappable if display is none or starts with table except "table", "table-cell", or "table-caption"
-	// see here for display values: https://developer.mozilla.org/en-US/docs/CSS/display
-	rdisplayswap = /^(none|table(?!-c[ea]).+)/,
-	rnumsplit = new RegExp( "^(" + pnum + ")(.*)$", "i" ),
-	rrelNum = new RegExp( "^([+-])=(" + pnum + ")", "i" ),
-
-	cssShow = { position: "absolute", visibility: "hidden", display: "block" },
-	cssNormalTransform = {
-		letterSpacing: "0",
-		fontWeight: "400"
-	},
-
-	cssPrefixes = [ "Webkit", "O", "Moz", "ms" ];
-
-
-// return a css property mapped to a potentially vendor prefixed property
-function vendorPropName( style, name ) {
-
-	// shortcut for names that are not vendor prefixed
-	if ( name in style ) {
-		return name;
-	}
-
-	// check for vendor prefixed names
-	var capName = name.charAt(0).toUpperCase() + name.slice(1),
-		origName = name,
-		i = cssPrefixes.length;
-
-	while ( i-- ) {
-		name = cssPrefixes[ i ] + capName;
-		if ( name in style ) {
-			return name;
-		}
-	}
-
-	return origName;
-}
-
-function showHide( elements, show ) {
-	var display, elem, hidden,
-		values = [],
-		index = 0,
-		length = elements.length;
-
-	for ( ; index < length; index++ ) {
-		elem = elements[ index ];
-		if ( !elem.style ) {
-			continue;
-		}
-
-		values[ index ] = jQuery._data( elem, "olddisplay" );
-		display = elem.style.display;
-		if ( show ) {
-			// Reset the inline display of this element to learn if it is
-			// being hidden by cascaded rules or not
-			if ( !values[ index ] && display === "none" ) {
-				elem.style.display = "";
-			}
-
-			// Set elements which have been overridden with display: none
-			// in a stylesheet to whatever the default browser style is
-			// for such an element
-			if ( elem.style.display === "" && isHidden( elem ) ) {
-				values[ index ] = jQuery._data( elem, "olddisplay", defaultDisplay(elem.nodeName) );
-			}
-		} else {
-			hidden = isHidden( elem );
-
-			if ( display && display !== "none" || !hidden ) {
-				jQuery._data( elem, "olddisplay", hidden ? display : jQuery.css( elem, "display" ) );
-			}
-		}
-	}
-
-	// Set the display of most of the elements in a second loop
-	// to avoid the constant reflow
-	for ( index = 0; index < length; index++ ) {
-		elem = elements[ index ];
-		if ( !elem.style ) {
-			continue;
-		}
-		if ( !show || elem.style.display === "none" || elem.style.display === "" ) {
-			elem.style.display = show ? values[ index ] || "" : "none";
-		}
-	}
-
-	return elements;
-}
-
-function setPositiveNumber( elem, value, subtract ) {
-	var matches = rnumsplit.exec( value );
-	return matches ?
-		// Guard against undefined "subtract", e.g., when used as in cssHooks
-		Math.max( 0, matches[ 1 ] - ( subtract || 0 ) ) + ( matches[ 2 ] || "px" ) :
-		value;
-}
-
-function augmentWidthOrHeight( elem, name, extra, isBorderBox, styles ) {
-	var i = extra === ( isBorderBox ? "border" : "content" ) ?
-		// If we already have the right measurement, avoid augmentation
-		4 :
-		// Otherwise initialize for horizontal or vertical properties
-		name === "width" ? 1 : 0,
-
-		val = 0;
-
-	for ( ; i < 4; i += 2 ) {
-		// both box models exclude margin, so add it if we want it
-		if ( extra === "margin" ) {
-			val += jQuery.css( elem, extra + cssExpand[ i ], true, styles );
-		}
-
-		if ( isBorderBox ) {
-			// border-box includes padding, so remove it if we want content
-			if ( extra === "content" ) {
-				val -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
-			}
-
-			// at this point, extra isn't border nor margin, so remove border
-			if ( extra !== "margin" ) {
-				val -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
-			}
-		} else {
-			// at this point, extra isn't content, so add padding
-			val += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
-
-			// at this point, extra isn't content nor padding, so add border
-			if ( extra !== "padding" ) {
-				val += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
-			}
-		}
-	}
-
-	return val;
-}
-
-function getWidthOrHeight( elem, name, extra ) {
-
-	// Start with offset property, which is equivalent to the border-box value
-	var valueIsBorderBox = true,
-		val = name === "width" ? elem.offsetWidth : elem.offsetHeight,
-		styles = getStyles( elem ),
-		isBorderBox = support.boxSizing && jQuery.css( elem, "boxSizing", false, styles ) === "border-box";
-
-	// some non-html elements return undefined for offsetWidth, so check for null/undefined
-	// svg - https://bugzilla.mozilla.org/show_bug.cgi?id=649285
-	// MathML - https://bugzilla.mozilla.org/show_bug.cgi?id=491668
-	if ( val <= 0 || val == null ) {
-		// Fall back to computed then uncomputed css if necessary
-		val = curCSS( elem, name, styles );
-		if ( val < 0 || val == null ) {
-			val = elem.style[ name ];
-		}
-
-		// Computed unit is not pixels. Stop here and return.
-		if ( rnumnonpx.test(val) ) {
-			return val;
-		}
-
-		// we need the check for style in case a browser which returns unreliable values
-		// for getComputedStyle silently falls back to the reliable elem.style
-		valueIsBorderBox = isBorderBox && ( support.boxSizingReliable() || val === elem.style[ name ] );
-
-		// Normalize "", auto, and prepare for extra
-		val = parseFloat( val ) || 0;
-	}
-
-	// use the active box-sizing model to add/subtract irrelevant styles
-	return ( val +
-		augmentWidthOrHeight(
-			elem,
-			name,
-			extra || ( isBorderBox ? "border" : "content" ),
-			valueIsBorderBox,
-			styles
-		)
-	) + "px";
-}
-
-jQuery.extend({
-	// Add in style property hooks for overriding the default
-	// behavior of getting and setting a style property
-	cssHooks: {
-		opacity: {
-			get: function( elem, computed ) {
-				if ( computed ) {
-					// We should always get a number back from opacity
-					var ret = curCSS( elem, "opacity" );
-					return ret === "" ? "1" : ret;
-				}
-			}
-		}
-	},
-
-	// Don't automatically add "px" to these possibly-unitless properties
-	cssNumber: {
-		"columnCount": true,
-		"fillOpacity": true,
-		"flexGrow": true,
-		"flexShrink": true,
-		"fontWeight": true,
-		"lineHeight": true,
-		"opacity": true,
-		"order": true,
-		"orphans": true,
-		"widows": true,
-		"zIndex": true,
-		"zoom": true
-	},
-
-	// Add in properties whose names you wish to fix before
-	// setting or getting the value
-	cssProps: {
-		// normalize float css property
-		"float": support.cssFloat ? "cssFloat" : "styleFloat"
-	},
-
-	// Get and set the style property on a DOM Node
-	style: function( elem, name, value, extra ) {
-		// Don't set styles on text and comment nodes
-		if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {
-			return;
-		}
-
-		// Make sure that we're working with the right name
-		var ret, type, hooks,
-			origName = jQuery.camelCase( name ),
-			style = elem.style;
-
-		name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( style, origName ) );
-
-		// gets hook for the prefixed version
-		// followed by the unprefixed version
-		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
-
-		// Check if we're setting a value
-		if ( value !== undefined ) {
-			type = typeof value;
-
-			// convert relative number strings (+= or -=) to relative numbers. #7345
-			if ( type === "string" && (ret = rrelNum.exec( value )) ) {
-				value = ( ret[1] + 1 ) * ret[2] + parseFloat( jQuery.css( elem, name ) );
-				// Fixes bug #9237
-				type = "number";
-			}
-
-			// Make sure that null and NaN values aren't set. See: #7116
-			if ( value == null || value !== value ) {
-				return;
-			}
-
-			// If a number was passed in, add 'px' to the (except for certain CSS properties)
-			if ( type === "number" && !jQuery.cssNumber[ origName ] ) {
-				value += "px";
-			}
-
-			// Fixes #8908, it can be done more correctly by specifing setters in cssHooks,
-			// but it would mean to define eight (for every problematic property) identical functions
-			if ( !support.clearCloneStyle && value === "" && name.indexOf("background") === 0 ) {
-				style[ name ] = "inherit";
-			}
-
-			// If a hook was provided, use that value, otherwise just set the specified value
-			if ( !hooks || !("set" in hooks) || (value = hooks.set( elem, value, extra )) !== undefined ) {
-
-				// Support: IE
-				// Swallow errors from 'invalid' CSS values (#5509)
-				try {
-					style[ name ] = value;
-				} catch(e) {}
-			}
-
-		} else {
-			// If a hook was provided get the non-computed value from there
-			if ( hooks && "get" in hooks && (ret = hooks.get( elem, false, extra )) !== undefined ) {
-				return ret;
-			}
-
-			// Otherwise just get the value from the style object
-			return style[ name ];
-		}
-	},
-
-	css: function( elem, name, extra, styles ) {
-		var num, val, hooks,
-			origName = jQuery.camelCase( name );
-
-		// Make sure that we're working with the right name
-		name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( elem.style, origName ) );
-
-		// gets hook for the prefixed version
-		// followed by the unprefixed version
-		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
-
-		// If a hook was provided get the computed value from there
-		if ( hooks && "get" in hooks ) {
-			val = hooks.get( elem, true, extra );
-		}
-
-		// Otherwise, if a way to get the computed value exists, use that
-		if ( val === undefined ) {
-			val = curCSS( elem, name, styles );
-		}
-
-		//convert "normal" to computed value
-		if ( val === "normal" && name in cssNormalTransform ) {
-			val = cssNormalTransform[ name ];
-		}
-
-		// Return, converting to number if forced or a qualifier was provided and val looks numeric
-		if ( extra === "" || extra ) {
-			num = parseFloat( val );
-			return extra === true || jQuery.isNumeric( num ) ? num || 0 : val;
-		}
-		return val;
-	}
-});
-
-jQuery.each([ "height", "width" ], function( i, name ) {
-	jQuery.cssHooks[ name ] = {
-		get: function( elem, computed, extra ) {
-			if ( computed ) {
-				// certain elements can have dimension info if we invisibly show them
-				// however, it must have a current display style that would benefit from this
-				return rdisplayswap.test( jQuery.css( elem, "display" ) ) && elem.offsetWidth === 0 ?
-					jQuery.swap( elem, cssShow, function() {
-						return getWidthOrHeight( elem, name, extra );
-					}) :
-					getWidthOrHeight( elem, name, extra );
-			}
-		},
-
-		set: function( elem, value, extra ) {
-			var styles = extra && getStyles( elem );
-			return setPositiveNumber( elem, value, extra ?
-				augmentWidthOrHeight(
-					elem,
-					name,
-					extra,
-					support.boxSizing && jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
-					styles
-				) : 0
-			);
-		}
-	};
-});
-
-if ( !support.opacity ) {
-	jQuery.cssHooks.opacity = {
-		get: function( elem, computed ) {
-			// IE uses filters for opacity
-			return ropacity.test( (computed && elem.currentStyle ? elem.currentStyle.filter : elem.style.filter) || "" ) ?
-				( 0.01 * parseFloat( RegExp.$1 ) ) + "" :
-				computed ? "1" : "";
-		},
-
-		set: function( elem, value ) {
-			var style = elem.style,
-				currentStyle = elem.currentStyle,
-				opacity = jQuery.isNumeric( value ) ? "alpha(opacity=" + value * 100 + ")" : "",
-				filter = currentStyle && currentStyle.filter || style.filter || "";
-
-			// IE has trouble with opacity if it does not have layout
-			// Force it by setting the zoom level
-			style.zoom = 1;
-
-			// if setting opacity to 1, and no other filters exist - attempt to remove filter attribute #6652
-			// if value === "", then remove inline opacity #12685
-			if ( ( value >= 1 || value === "" ) &&
-					jQuery.trim( filter.replace( ralpha, "" ) ) === "" &&
-					style.removeAttribute ) {
-
-				// Setting style.filter to null, "" & " " still leave "filter:" in the cssText
-				// if "filter:" is present at all, clearType is disabled, we want to avoid this
-				// style.removeAttribute is IE Only, but so apparently is this code path...
-				style.removeAttribute( "filter" );
-
-				// if there is no filter style applied in a css rule or unset inline opacity, we are done
-				if ( value === "" || currentStyle && !currentStyle.filter ) {
-					return;
-				}
-			}
-
-			// otherwise, set new filter values
-			style.filter = ralpha.test( filter ) ?
-				filter.replace( ralpha, opacity ) :
-				filter + " " + opacity;
-		}
-	};
-}
-
-jQuery.cssHooks.marginRight = addGetHookIf( support.reliableMarginRight,
-	function( elem, computed ) {
-		if ( computed ) {
-			// WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right
-			// Work around by temporarily setting element display to inline-block
-			return jQuery.swap( elem, { "display": "inline-block" },
-				curCSS, [ elem, "marginRight" ] );
-		}
-	}
-);
-
-// These hooks are used by animate to expand properties
-jQuery.each({
-	margin: "",
-	padding: "",
-	border: "Width"
-}, function( prefix, suffix ) {
-	jQuery.cssHooks[ prefix + suffix ] = {
-		expand: function( value ) {
-			var i = 0,
-				expanded = {},
-
-				// assumes a single number if not a string
-				parts = typeof value === "string" ? value.split(" ") : [ value ];
-
-			for ( ; i < 4; i++ ) {
-				expanded[ prefix + cssExpand[ i ] + suffix ] =
-					parts[ i ] || parts[ i - 2 ] || parts[ 0 ];
-			}
-
-			return expanded;
-		}
-	};
-
-	if ( !rmargin.test( prefix ) ) {
-		jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber;
-	}
-});
-
-jQuery.fn.extend({
-	css: function( name, value ) {
-		return access( this, function( elem, name, value ) {
-			var styles, len,
-				map = {},
-				i = 0;
-
-			if ( jQuery.isArray( name ) ) {
-				styles = getStyles( elem );
-				len = name.length;
-
-				for ( ; i < len; i++ ) {
-					map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles );
-				}
-
-				return map;
-			}
-
-			return value !== undefined ?
-				jQuery.style( elem, name, value ) :
-				jQuery.css( elem, name );
-		}, name, value, arguments.length > 1 );
-	},
-	show: function() {
-		return showHide( this, true );
-	},
-	hide: function() {
-		return showHide( this );
-	},
-	toggle: function( state ) {
-		if ( typeof state === "boolean" ) {
-			return state ? this.show() : this.hide();
-		}
-
-		return this.each(function() {
-			if ( isHidden( this ) ) {
-				jQuery( this ).show();
-			} else {
-				jQuery( this ).hide();
-			}
-		});
-	}
-});
-
-
-function Tween( elem, options, prop, end, easing ) {
-	return new Tween.prototype.init( elem, options, prop, end, easing );
-}
-jQuery.Tween = Tween;
-
-Tween.prototype = {
-	constructor: Tween,
-	init: function( elem, options, prop, end, easing, unit ) {
-		this.elem = elem;
-		this.prop = prop;
-		this.easing = easing || "swing";
-		this.options = options;
-		this.start = this.now = this.cur();
-		this.end = end;
-		this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" );
-	},
-	cur: function() {
-		var hooks = Tween.propHooks[ this.prop ];
-
-		return hooks && hooks.get ?
-			hooks.get( this ) :
-			Tween.propHooks._default.get( this );
-	},
-	run: function( percent ) {
-		var eased,
-			hooks = Tween.propHooks[ this.prop ];
-
-		if ( this.options.duration ) {
-			this.pos = eased = jQuery.easing[ this.easing ](
-				percent, this.options.duration * percent, 0, 1, this.options.duration
-			);
-		} else {
-			this.pos = eased = percent;
-		}
-		this.now = ( this.end - this.start ) * eased + this.start;
-
-		if ( this.options.step ) {
-			this.options.step.call( this.elem, this.now, this );
-		}
-
-		if ( hooks && hooks.set ) {
-			hooks.set( this );
-		} else {
-			Tween.propHooks._default.set( this );
-		}
-		return this;
-	}
-};
-
-Tween.prototype.init.prototype = Tween.prototype;
-
-Tween.propHooks = {
-	_default: {
-		get: function( tween ) {
-			var result;
-
-			if ( tween.elem[ tween.prop ] != null &&
-				(!tween.elem.style || tween.elem.style[ tween.prop ] == null) ) {
-				return tween.elem[ tween.prop ];
-			}
-
-			// passing an empty string as a 3rd parameter to .css will automatically
-			// attempt a parseFloat and fallback to a string if the parse fails
-			// so, simple values such as "10px" are parsed to Float.
-			// complex values such as "rotate(1rad)" are returned as is.
-			result = jQuery.css( tween.elem, tween.prop, "" );
-			// Empty strings, null, undefined and "auto" are converted to 0.
-			return !result || result === "auto" ? 0 : result;
-		},
-		set: function( tween ) {
-			// use step hook for back compat - use cssHook if its there - use .style if its
-			// available and use plain properties where available
-			if ( jQuery.fx.step[ tween.prop ] ) {
-				jQuery.fx.step[ tween.prop ]( tween );
-			} else if ( tween.elem.style && ( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null || jQuery.cssHooks[ tween.prop ] ) ) {
-				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
-			} else {
-				tween.elem[ tween.prop ] = tween.now;
-			}
-		}
-	}
-};
-
-// Support: IE <=9
-// Panic based approach to setting things on disconnected nodes
-
-Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
-	set: function( tween ) {
-		if ( tween.elem.nodeType && tween.elem.parentNode ) {
-			tween.elem[ tween.prop ] = tween.now;
-		}
-	}
-};
-
-jQuery.easing = {
-	linear: function( p ) {
-		return p;
-	},
-	swing: function( p ) {
-		return 0.5 - Math.cos( p * Math.PI ) / 2;
-	}
-};
-
-jQuery.fx = Tween.prototype.init;
-
-// Back Compat <1.8 extension point
-jQuery.fx.step = {};
-
-
-
-
-var
-	fxNow, timerId,
-	rfxtypes = /^(?:toggle|show|hide)$/,
-	rfxnum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ),
-	rrun = /queueHooks$/,
-	animationPrefilters = [ defaultPrefilter ],
-	tweeners = {
-		"*": [ function( prop, value ) {
-			var tween = this.createTween( prop, value ),
-				target = tween.cur(),
-				parts = rfxnum.exec( value ),
-				unit = parts && parts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ),
-
-				// Starting value computation is required for potential unit mismatches
-				start = ( jQuery.cssNumber[ prop ] || unit !== "px" && +target ) &&
-					rfxnum.exec( jQuery.css( tween.elem, prop ) ),
-				scale = 1,
-				maxIterations = 20;
-
-			if ( start && start[ 3 ] !== unit ) {
-				// Trust units reported by jQuery.css
-				unit = unit || start[ 3 ];
-
-				// Make sure we update the tween properties later on
-				parts = parts || [];
-
-				// Iteratively approximate from a nonzero starting point
-				start = +target || 1;
-
-				do {
-					// If previous iteration zeroed out, double until we get *something*
-					// Use a string for doubling factor so we don't accidentally see scale as unchanged below
-					scale = scale || ".5";
-
-					// Adjust and apply
-					start = start / scale;
-					jQuery.style( tween.elem, prop, start + unit );
-
-				// Update scale, tolerating zero or NaN from tween.cur()
-				// And breaking the loop if scale is unchanged or perfect, or if we've just had enough
-				} while ( scale !== (scale = tween.cur() / target) && scale !== 1 && --maxIterations );
-			}
-
-			// Update tween properties
-			if ( parts ) {
-				start = tween.start = +start || +target || 0;
-				tween.unit = unit;
-				// If a +=/-= token was provided, we're doing a relative animation
-				tween.end = parts[ 1 ] ?
-					start + ( parts[ 1 ] + 1 ) * parts[ 2 ] :
-					+parts[ 2 ];
-			}
-
-			return tween;
-		} ]
-	};
-
-// Animations created synchronously will run synchronously
-function createFxNow() {
-	setTimeout(function() {
-		fxNow = undefined;
-	});
-	return ( fxNow = jQuery.now() );
-}
-
-// Generate parameters to create a standard animation
-function genFx( type, includeWidth ) {
-	var which,
-		attrs = { height: type },
-		i = 0;
-
-	// if we include width, step value is 1 to do all cssExpand values,
-	// if we don't include width, step value is 2 to skip over Left and Right
-	includeWidth = includeWidth ? 1 : 0;
-	for ( ; i < 4 ; i += 2 - includeWidth ) {
-		which = cssExpand[ i ];
-		attrs[ "margin" + which ] = attrs[ "padding" + which ] = type;
-	}
-
-	if ( includeWidth ) {
-		attrs.opacity = attrs.width = type;
-	}
-
-	return attrs;
-}
-
-function createTween( value, prop, animation ) {
-	var tween,
-		collection = ( tweeners[ prop ] || [] ).concat( tweeners[ "*" ] ),
-		index = 0,
-		length = collection.length;
-	for ( ; index < length; index++ ) {
-		if ( (tween = collection[ index ].call( animation, prop, value )) ) {
-
-			// we're done with this property
-			return tween;
-		}
-	}
-}
-
-function defaultPrefilter( elem, props, opts ) {
-	/* jshint validthis: true */
-	var prop, value, toggle, tween, hooks, oldfire, display, checkDisplay,
-		anim = this,
-		orig = {},
-		style = elem.style,
-		hidden = elem.nodeType && isHidden( elem ),
-		dataShow = jQuery._data( elem, "fxshow" );
-
-	// handle queue: false promises
-	if ( !opts.queue ) {
-		hooks = jQuery._queueHooks( elem, "fx" );
-		if ( hooks.unqueued == null ) {
-			hooks.unqueued = 0;
-			oldfire = hooks.empty.fire;
-			hooks.empty.fire = function() {
-				if ( !hooks.unqueued ) {
-					oldfire();
-				}
-			};
-		}
-		hooks.unqueued++;
-
-		anim.always(function() {
-			// doing this makes sure that the complete handler will be called
-			// before this completes
-			anim.always(function() {
-				hooks.unqueued--;
-				if ( !jQuery.queue( elem, "fx" ).length ) {
-					hooks.empty.fire();
-				}
-			});
-		});
-	}
-
-	// height/width overflow pass
-	if ( elem.nodeType === 1 && ( "height" in props || "width" in props ) ) {
-		// Make sure that nothing sneaks out
-		// Record all 3 overflow attributes because IE does not
-		// change the overflow attribute when overflowX and
-		// overflowY are set to the same value
-		opts.overflow = [ style.overflow, style.overflowX, style.overflowY ];
-
-		// Set display property to inline-block for height/width
-		// animations on inline elements that are having width/height animated
-		display = jQuery.css( elem, "display" );
-
-		// Test default display if display is currently "none"
-		checkDisplay = display === "none" ?
-			jQuery._data( elem, "olddisplay" ) || defaultDisplay( elem.nodeName ) : display;
-
-		if ( checkDisplay === "inline" && jQuery.css( elem, "float" ) === "none" ) {
-
-			// inline-level elements accept inline-block;
-			// block-level elements need to be inline with layout
-			if ( !support.inlineBlockNeedsLayout || defaultDisplay( elem.nodeName ) === "inline" ) {
-				style.display = "inline-block";
-			} else {
-				style.zoom = 1;
-			}
-		}
-	}
-
-	if ( opts.overflow ) {
-		style.overflow = "hidden";
-		if ( !support.shrinkWrapBlocks() ) {
-			anim.always(function() {
-				style.overflow = opts.overflow[ 0 ];
-				style.overflowX = opts.overflow[ 1 ];
-				style.overflowY = opts.overflow[ 2 ];
-			});
-		}
-	}
-
-	// show/hide pass
-	for ( prop in props ) {
-		value = props[ prop ];
-		if ( rfxtypes.exec( value ) ) {
-			delete props[ prop ];
-			toggle = toggle || value === "toggle";
-			if ( value === ( hidden ? "hide" : "show" ) ) {
-
-				// If there is dataShow left over from a stopped hide or show and we are going to proceed with show, we should pretend to be hidden
-				if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) {
-					hidden = true;
-				} else {
-					continue;
-				}
-			}
-			orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop );
-
-		// Any non-fx value stops us from restoring the original display value
-		} else {
-			display = undefined;
-		}
-	}
-
-	if ( !jQuery.isEmptyObject( orig ) ) {
-		if ( dataShow ) {
-			if ( "hidden" in dataShow ) {
-				hidden = dataShow.hidden;
-			}
-		} else {
-			dataShow = jQuery._data( elem, "fxshow", {} );
-		}
-
-		// store state if its toggle - enables .stop().toggle() to "reverse"
-		if ( toggle ) {
-			dataShow.hidden = !hidden;
-		}
-		if ( hidden ) {
-			jQuery( elem ).show();
-		} else {
-			anim.done(function() {
-				jQuery( elem ).hide();
-			});
-		}
-		anim.done(function() {
-			var prop;
-			jQuery._removeData( elem, "fxshow" );
-			for ( prop in orig ) {
-				jQuery.style( elem, prop, orig[ prop ] );
-			}
-		});
-		for ( prop in orig ) {
-			tween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim );
-
-			if ( !( prop in dataShow ) ) {
-				dataShow[ prop ] = tween.start;
-				if ( hidden ) {
-					tween.end = tween.start;
-					tween.start = prop === "width" || prop === "height" ? 1 : 0;
-				}
-			}
-		}
-
-	// If this is a noop like .hide().hide(), restore an overwritten display value
-	} else if ( (display === "none" ? defaultDisplay( elem.nodeName ) : display) === "inline" ) {
-		style.display = display;
-	}
-}
-
-function propFilter( props, specialEasing ) {
-	var index, name, easing, value, hooks;
-
-	// camelCase, specialEasing and expand cssHook pass
-	for ( index in props ) {
-		name = jQuery.camelCase( index );
-		easing = specialEasing[ name ];
-		value = props[ index ];
-		if ( jQuery.isArray( value ) ) {
-			easing = value[ 1 ];
-			value = props[ index ] = value[ 0 ];
-		}
-
-		if ( index !== name ) {
-			props[ name ] = value;
-			delete props[ index ];
-		}
-
-		hooks = jQuery.cssHooks[ name ];
-		if ( hooks && "expand" in hooks ) {
-			value = hooks.expand( value );
-			delete props[ name ];
-
-			// not quite $.extend, this wont overwrite keys already present.
-			// also - reusing 'index' from above because we have the correct "name"
-			for ( index in value ) {
-				if ( !( index in props ) ) {
-					props[ index ] = value[ index ];
-					specialEasing[ index ] = easing;
-				}
-			}
-		} else {
-			specialEasing[ name ] = easing;
-		}
-	}
-}
-
-function Animation( elem, properties, options ) {
-	var result,
-		stopped,
-		index = 0,
-		length = animationPrefilters.length,
-		deferred = jQuery.Deferred().always( function() {
-			// don't match elem in the :animated selector
-			delete tick.elem;
-		}),
-		tick = function() {
-			if ( stopped ) {
-				return false;
-			}
-			var currentTime = fxNow || createFxNow(),
-				remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ),
-				// archaic crash bug won't allow us to use 1 - ( 0.5 || 0 ) (#12497)
-				temp = remaining / animation.duration || 0,
-				percent = 1 - temp,
-				index = 0,
-				length = animation.tweens.length;
-
-			for ( ; index < length ; index++ ) {
-				animation.tweens[ index ].run( percent );
-			}
-
-			deferred.notifyWith( elem, [ animation, percent, remaining ]);
-
-			if ( percent < 1 && length ) {
-				return remaining;
-			} else {
-				deferred.resolveWith( elem, [ animation ] );
-				return false;
-			}
-		},
-		animation = deferred.promise({
-			elem: elem,
-			props: jQuery.extend( {}, properties ),
-			opts: jQuery.extend( true, { specialEasing: {} }, options ),
-			originalProperties: properties,
-			originalOptions: options,
-			startTime: fxNow || createFxNow(),
-			duration: options.duration,
-			tweens: [],
-			createTween: function( prop, end ) {
-				var tween = jQuery.Tween( elem, animation.opts, prop, end,
-						animation.opts.specialEasing[ prop ] || animation.opts.easing );
-				animation.tweens.push( tween );
-				return tween;
-			},
-			stop: function( gotoEnd ) {
-				var index = 0,
-					// if we are going to the end, we want to run all the tweens
-					// otherwise we skip this part
-					length = gotoEnd ? animation.tweens.length : 0;
-				if ( stopped ) {
-					return this;
-				}
-				stopped = true;
-				for ( ; index < length ; index++ ) {
-					animation.tweens[ index ].run( 1 );
-				}
-
-				// resolve when we played the last frame
-				// otherwise, reject
-				if ( gotoEnd ) {
-					deferred.resolveWith( elem, [ animation, gotoEnd ] );
-				} else {
-					deferred.rejectWith( elem, [ animation, gotoEnd ] );
-				}
-				return this;
-			}
-		}),
-		props = animation.props;
-
-	propFilter( props, animation.opts.specialEasing );
-
-	for ( ; index < length ; index++ ) {
-		result = animationPrefilters[ index ].call( animation, elem, props, animation.opts );
-		if ( result ) {
-			return result;
-		}
-	}
-
-	jQuery.map( props, createTween, animation );
-
-	if ( jQuery.isFunction( animation.opts.start ) ) {
-		animation.opts.start.call( elem, animation );
-	}
-
-	jQuery.fx.timer(
-		jQuery.extend( tick, {
-			elem: elem,
-			anim: animation,
-			queue: animation.opts.queue
-		})
-	);
-
-	// attach callbacks from options
-	return animation.progress( animation.opts.progress )
-		.done( animation.opts.done, animation.opts.complete )
-		.fail( animation.opts.fail )
-		.always( animation.opts.always );
-}
-
-jQuery.Animation = jQuery.extend( Animation, {
-	tweener: function( props, callback ) {
-		if ( jQuery.isFunction( props ) ) {
-			callback = props;
-			props = [ "*" ];
-		} else {
-			props = props.split(" ");
-		}
-
-		var prop,
-			index = 0,
-			length = props.length;
-
-		for ( ; index < length ; index++ ) {
-			prop = props[ index ];
-			tweeners[ prop ] = tweeners[ prop ] || [];
-			tweeners[ prop ].unshift( callback );
-		}
-	},
-
-	prefilter: function( callback, prepend ) {
-		if ( prepend ) {
-			animationPrefilters.unshift( callback );
-		} else {
-			animationPrefilters.push( callback );
-		}
-	}
-});
-
-jQuery.speed = function( speed, easing, fn ) {
-	var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
-		complete: fn || !fn && easing ||
-			jQuery.isFunction( speed ) && speed,
-		duration: speed,
-		easing: fn && easing || easing && !jQuery.isFunction( easing ) && easing
-	};
-
-	opt.duration = jQuery.fx.off ? 0 : typeof opt.duration === "number" ? opt.duration :
-		opt.duration in jQuery.fx.speeds ? jQuery.fx.speeds[ opt.duration ] : jQuery.fx.speeds._default;
-
-	// normalize opt.queue - true/undefined/null -> "fx"
-	if ( opt.queue == null || opt.queue === true ) {
-		opt.queue = "fx";
-	}
-
-	// Queueing
-	opt.old = opt.complete;
-
-	opt.complete = function() {
-		if ( jQuery.isFunction( opt.old ) ) {
-			opt.old.call( this );
-		}
-
-		if ( opt.queue ) {
-			jQuery.dequeue( this, opt.queue );
-		}
-	};
-
-	return opt;
-};
-
-jQuery.fn.extend({
-	fadeTo: function( speed, to, easing, callback ) {
-
-		// show any hidden elements after setting opacity to 0
-		return this.filter( isHidden ).css( "opacity", 0 ).show()
-
-			// animate to the value specified
-			.end().animate({ opacity: to }, speed, easing, callback );
-	},
-	animate: function( prop, speed, easing, callback ) {
-		var empty = jQuery.isEmptyObject( prop ),
-			optall = jQuery.speed( speed, easing, callback ),
-			doAnimation = function() {
-				// Operate on a copy of prop so per-property easing won't be lost
-				var anim = Animation( this, jQuery.extend( {}, prop ), optall );
-
-				// Empty animations, or finishing resolves immediately
-				if ( empty || jQuery._data( this, "finish" ) ) {
-					anim.stop( true );
-				}
-			};
-			doAnimation.finish = doAnimation;
-
-		return empty || optall.queue === false ?
-			this.each( doAnimation ) :
-			this.queue( optall.queue, doAnimation );
-	},
-	stop: function( type, clearQueue, gotoEnd ) {
-		var stopQueue = function( hooks ) {
-			var stop = hooks.stop;
-			delete hooks.stop;
-			stop( gotoEnd );
-		};
-
-		if ( typeof type !== "string" ) {
-			gotoEnd = clearQueue;
-			clearQueue = type;
-			type = undefined;
-		}
-		if ( clearQueue && type !== false ) {
-			this.queue( type || "fx", [] );
-		}
-
-		return this.each(function() {
-			var dequeue = true,
-				index = type != null && type + "queueHooks",
-				timers = jQuery.timers,
-				data = jQuery._data( this );
-
-			if ( index ) {
-				if ( data[ index ] && data[ index ].stop ) {
-					stopQueue( data[ index ] );
-				}
-			} else {
-				for ( index in data ) {
-					if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) {
-						stopQueue( data[ index ] );
-					}
-				}
-			}
-
-			for ( index = timers.length; index--; ) {
-				if ( timers[ index ].elem === this && (type == null || timers[ index ].queue === type) ) {
-					timers[ index ].anim.stop( gotoEnd );
-					dequeue = false;
-					timers.splice( index, 1 );
-				}
-			}
-
-			// start the next in the queue if the last step wasn't forced
-			// timers currently will call their complete callbacks, which will dequeue
-			// but only if they were gotoEnd
-			if ( dequeue || !gotoEnd ) {
-				jQuery.dequeue( this, type );
-			}
-		});
-	},
-	finish: function( type ) {
-		if ( type !== false ) {
-			type = type || "fx";
-		}
-		return this.each(function() {
-			var index,
-				data = jQuery._data( this ),
-				queue = data[ type + "queue" ],
-				hooks = data[ type + "queueHooks" ],
-				timers = jQuery.timers,
-				length = queue ? queue.length : 0;
-
-			// enable finishing flag on private data
-			data.finish = true;
-
-			// empty the queue first
-			jQuery.queue( this, type, [] );
-
-			if ( hooks && hooks.stop ) {
-				hooks.stop.call( this, true );
-			}
-
-			// look for any active animations, and finish them
-			for ( index = timers.length; index--; ) {
-				if ( timers[ index ].elem === this && timers[ index ].queue === type ) {
-					timers[ index ].anim.stop( true );
-					timers.splice( index, 1 );
-				}
-			}
-
-			// look for any animations in the old queue and finish them
-			for ( index = 0; index < length; index++ ) {
-				if ( queue[ index ] && queue[ index ].finish ) {
-					queue[ index ].finish.call( this );
-				}
-			}
-
-			// turn off finishing flag
-			delete data.finish;
-		});
-	}
-});
-
-jQuery.each([ "toggle", "show", "hide" ], function( i, name ) {
-	var cssFn = jQuery.fn[ name ];
-	jQuery.fn[ name ] = function( speed, easing, callback ) {
-		return speed == null || typeof speed === "boolean" ?
-			cssFn.apply( this, arguments ) :
-			this.animate( genFx( name, true ), speed, easing, callback );
-	};
-});
-
-// Generate shortcuts for custom animations
-jQuery.each({
-	slideDown: genFx("show"),
-	slideUp: genFx("hide"),
-	slideToggle: genFx("toggle"),
-	fadeIn: { opacity: "show" },
-	fadeOut: { opacity: "hide" },
-	fadeToggle: { opacity: "toggle" }
-}, function( name, props ) {
-	jQuery.fn[ name ] = function( speed, easing, callback ) {
-		return this.animate( props, speed, easing, callback );
-	};
-});
-
-jQuery.timers = [];
-jQuery.fx.tick = function() {
-	var timer,
-		timers = jQuery.timers,
-		i = 0;
-
-	fxNow = jQuery.now();
-
-	for ( ; i < timers.length; i++ ) {
-		timer = timers[ i ];
-		// Checks the timer has not already been removed
-		if ( !timer() && timers[ i ] === timer ) {
-			timers.splice( i--, 1 );
-		}
-	}
-
-	if ( !timers.length ) {
-		jQuery.fx.stop();
-	}
-	fxNow = undefined;
-};
-
-jQuery.fx.timer = function( timer ) {
-	jQuery.timers.push( timer );
-	if ( timer() ) {
-		jQuery.fx.start();
-	} else {
-		jQuery.timers.pop();
-	}
-};
-
-jQuery.fx.interval = 13;
-
-jQuery.fx.start = function() {
-	if ( !timerId ) {
-		timerId = setInterval( jQuery.fx.tick, jQuery.fx.interval );
-	}
-};
-
-jQuery.fx.stop = function() {
-	clearInterval( timerId );
-	timerId = null;
-};
-
-jQuery.fx.speeds = {
-	slow: 600,
-	fast: 200,
-	// Default speed
-	_default: 400
-};
-
-
-// Based off of the plugin by Clint Helfers, with permission.
-// http://blindsignals.com/index.php/2009/07/jquery-delay/
-jQuery.fn.delay = function( time, type ) {
-	time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;
-	type = type || "fx";
-
-	return this.queue( type, function( next, hooks ) {
-		var timeout = setTimeout( next, time );
-		hooks.stop = function() {
-			clearTimeout( timeout );
-		};
-	});
-};
-
-
-(function() {
-	// Minified: var a,b,c,d,e
-	var input, div, select, a, opt;
-
-	// Setup
-	div = document.createElement( "div" );
-	div.setAttribute( "className", "t" );
-	div.innerHTML = "  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>";
-	a = div.getElementsByTagName("a")[ 0 ];
-
-	// First batch of tests.
-	select = document.createElement("select");
-	opt = select.appendChild( document.createElement("option") );
-	input = div.getElementsByTagName("input")[ 0 ];
-
-	a.style.cssText = "top:1px";
-
-	// Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7)
-	support.getSetAttribute = div.className !== "t";
-
-	// Get the style information from getAttribute
-	// (IE uses .cssText instead)
-	support.style = /top/.test( a.getAttribute("style") );
-
-	// Make sure that URLs aren't manipulated
-	// (IE normalizes it by default)
-	support.hrefNormalized = a.getAttribute("href") === "/a";
-
-	// Check the default checkbox/radio value ("" on WebKit; "on" elsewhere)
-	support.checkOn = !!input.value;
-
-	// Make sure that a selected-by-default option has a working selected property.
-	// (WebKit defaults to false instead of true, IE too, if it's in an optgroup)
-	support.optSelected = opt.selected;
-
-	// Tests for enctype support on a form (#6743)
-	support.enctype = !!document.createElement("form").enctype;
-
-	// Make sure that the options inside disabled selects aren't marked as disabled
-	// (WebKit marks them as disabled)
-	select.disabled = true;
-	support.optDisabled = !opt.disabled;
-
-	// Support: IE8 only
-	// Check if we can trust getAttribute("value")
-	input = document.createElement( "input" );
-	input.setAttribute( "value", "" );
-	support.input = input.getAttribute( "value" ) === "";
-
-	// Check if an input maintains its value after becoming a radio
-	input.value = "t";
-	input.setAttribute( "type", "radio" );
-	support.radioValue = input.value === "t";
-})();
-
-
-var rreturn = /\r/g;
-
-jQuery.fn.extend({
-	val: function( value ) {
-		var hooks, ret, isFunction,
-			elem = this[0];
-
-		if ( !arguments.length ) {
-			if ( elem ) {
-				hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ];
-
-				if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) {
-					return ret;
-				}
-
-				ret = elem.value;
-
-				return typeof ret === "string" ?
-					// handle most common string cases
-					ret.replace(rreturn, "") :
-					// handle cases where value is null/undef or number
-					ret == null ? "" : ret;
-			}
-
-			return;
-		}
-
-		isFunction = jQuery.isFunction( value );
-
-		return this.each(function( i ) {
-			var val;
-
-			if ( this.nodeType !== 1 ) {
-				return;
-			}
-
-			if ( isFunction ) {
-				val = value.call( this, i, jQuery( this ).val() );
-			} else {
-				val = value;
-			}
-
-			// Treat null/undefined as ""; convert numbers to string
-			if ( val == null ) {
-				val = "";
-			} else if ( typeof val === "number" ) {
-				val += "";
-			} else if ( jQuery.isArray( val ) ) {
-				val = jQuery.map( val, function( value ) {
-					return value == null ? "" : value + "";
-				});
-			}
-
-			hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];
-
-			// If set returns undefined, fall back to normal setting
-			if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) {
-				this.value = val;
-			}
-		});
-	}
-});
-
-jQuery.extend({
-	valHooks: {
-		option: {
-			get: function( elem ) {
-				var val = jQuery.find.attr( elem, "value" );
-				return val != null ?
-					val :
-					// Support: IE10-11+
-					// option.text throws exceptions (#14686, #14858)
-					jQuery.trim( jQuery.text( elem ) );
-			}
-		},
-		select: {
-			get: function( elem ) {
-				var value, option,
-					options = elem.options,
-					index = elem.selectedIndex,
-					one = elem.type === "select-one" || index < 0,
-					values = one ? null : [],
-					max = one ? index + 1 : options.length,
-					i = index < 0 ?
-						max :
-						one ? index : 0;
-
-				// Loop through all the selected options
-				for ( ; i < max; i++ ) {
-					option = options[ i ];
-
-					// oldIE doesn't update selected after form reset (#2551)
-					if ( ( option.selected || i === index ) &&
-							// Don't return options that are disabled or in a disabled optgroup
-							( support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null ) &&
-							( !option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" ) ) ) {
-
-						// Get the specific value for the option
-						value = jQuery( option ).val();
-
-						// We don't need an array for one selects
-						if ( one ) {
-							return value;
-						}
-
-						// Multi-Selects return an array
-						values.push( value );
-					}
-				}
-
-				return values;
-			},
-
-			set: function( elem, value ) {
-				var optionSet, option,
-					options = elem.options,
-					values = jQuery.makeArray( value ),
-					i = options.length;
-
-				while ( i-- ) {
-					option = options[ i ];
-
-					if ( jQuery.inArray( jQuery.valHooks.option.get( option ), values ) >= 0 ) {
-
-						// Support: IE6
-						// When new option element is added to select box we need to
-						// force reflow of newly added node in order to workaround delay
-						// of initialization properties
-						try {
-							option.selected = optionSet = true;
-
-						} catch ( _ ) {
-
-							// Will be executed only in IE6
-							option.scrollHeight;
-						}
-
-					} else {
-						option.selected = false;
-					}
-				}
-
-				// Force browsers to behave consistently when non-matching value is set
-				if ( !optionSet ) {
-					elem.selectedIndex = -1;
-				}
-
-				return options;
-			}
-		}
-	}
-});
-
-// Radios and checkboxes getter/setter
-jQuery.each([ "radio", "checkbox" ], function() {
-	jQuery.valHooks[ this ] = {
-		set: function( elem, value ) {
-			if ( jQuery.isArray( value ) ) {
-				return ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 );
-			}
-		}
-	};
-	if ( !support.checkOn ) {
-		jQuery.valHooks[ this ].get = function( elem ) {
-			// Support: Webkit
-			// "" is returned instead of "on" if a value isn't specified
-			return elem.getAttribute("value") === null ? "on" : elem.value;
-		};
-	}
-});
-
-
-
-
-var nodeHook, boolHook,
-	attrHandle = jQuery.expr.attrHandle,
-	ruseDefault = /^(?:checked|selected)$/i,
-	getSetAttribute = support.getSetAttribute,
-	getSetInput = support.input;
-
-jQuery.fn.extend({
-	attr: function( name, value ) {
-		return access( this, jQuery.attr, name, value, arguments.length > 1 );
-	},
-
-	removeAttr: function( name ) {
-		return this.each(function() {
-			jQuery.removeAttr( this, name );
-		});
-	}
-});
-
-jQuery.extend({
-	attr: function( elem, name, value ) {
-		var hooks, ret,
-			nType = elem.nodeType;
-
-		// don't get/set attributes on text, comment and attribute nodes
-		if ( !elem || nType === 3 || nType === 8 || nType === 2 ) {
-			return;
-		}
-
-		// Fallback to prop when attributes are not supported
-		if ( typeof elem.getAttribute === strundefined ) {
-			return jQuery.prop( elem, name, value );
-		}
-
-		// All attributes are lowercase
-		// Grab necessary hook if one is defined
-		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
-			name = name.toLowerCase();
-			hooks = jQuery.attrHooks[ name ] ||
-				( jQuery.expr.match.bool.test( name ) ? boolHook : nodeHook );
-		}
-
-		if ( value !== undefined ) {
-
-			if ( value === null ) {
-				jQuery.removeAttr( elem, name );
-
-			} else if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) {
-				return ret;
-
-			} else {
-				elem.setAttribute( name, value + "" );
-				return value;
-			}
-
-		} else if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) {
-			return ret;
-
-		} else {
-			ret = jQuery.find.attr( elem, name );
-
-			// Non-existent attributes return null, we normalize to undefined
-			return ret == null ?
-				undefined :
-				ret;
-		}
-	},
-
-	removeAttr: function( elem, value ) {
-		var name, propName,
-			i = 0,
-			attrNames = value && value.match( rnotwhite );
-
-		if ( attrNames && elem.nodeType === 1 ) {
-			while ( (name = attrNames[i++]) ) {
-				propName = jQuery.propFix[ name ] || name;
-
-				// Boolean attributes get special treatment (#10870)
-				if ( jQuery.expr.match.bool.test( name ) ) {
-					// Set corresponding property to false
-					if ( getSetInput && getSetAttribute || !ruseDefault.test( name ) ) {
-						elem[ propName ] = false;
-					// Support: IE<9
-					// Also clear defaultChecked/defaultSelected (if appropriate)
-					} else {
-						elem[ jQuery.camelCase( "default-" + name ) ] =
-							elem[ propName ] = false;
-					}
-
-				// See #9699 for explanation of this approach (setting first, then removal)
-				} else {
-					jQuery.attr( elem, name, "" );
-				}
-
-				elem.removeAttribute( getSetAttribute ? name : propName );
-			}
-		}
-	},
-
-	attrHooks: {
-		type: {
-			set: function( elem, value ) {
-				if ( !support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) {
-					// Setting the type on a radio button after the value resets the value in IE6-9
-					// Reset value to default in case type is set after value during creation
-					var val = elem.value;
-					elem.setAttribute( "type", value );
-					if ( val ) {
-						elem.value = val;
-					}
-					return value;
-				}
-			}
-		}
-	}
-});
-
-// Hook for boolean attributes
-boolHook = {
-	set: function( elem, value, name ) {
-		if ( value === false ) {
-			// Remove boolean attributes when set to false
-			jQuery.removeAttr( elem, name );
-		} else if ( getSetInput && getSetAttribute || !ruseDefault.test( name ) ) {
-			// IE<8 needs the *property* name
-			elem.setAttribute( !getSetAttribute && jQuery.propFix[ name ] || name, name );
-
-		// Use defaultChecked and defaultSelected for oldIE
-		} else {
-			elem[ jQuery.camelCase( "default-" + name ) ] = elem[ name ] = true;
-		}
-
-		return name;
-	}
-};
-
-// Retrieve booleans specially
-jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) {
-
-	var getter = attrHandle[ name ] || jQuery.find.attr;
-
-	attrHandle[ name ] = getSetInput && getSetAttribute || !ruseDefault.test( name ) ?
-		function( elem, name, isXML ) {
-			var ret, handle;
-			if ( !isXML ) {
-				// Avoid an infinite loop by temporarily removing this function from the getter
-				handle = attrHandle[ name ];
-				attrHandle[ name ] = ret;
-				ret = getter( elem, name, isXML ) != null ?
-					name.toLowerCase() :
-					null;
-				attrHandle[ name ] = handle;
-			}
-			return ret;
-		} :
-		function( elem, name, isXML ) {
-			if ( !isXML ) {
-				return elem[ jQuery.camelCase( "default-" + name ) ] ?
-					name.toLowerCase() :
-					null;
-			}
-		};
-});
-
-// fix oldIE attroperties
-if ( !getSetInput || !getSetAttribute ) {
-	jQuery.attrHooks.value = {
-		set: function( elem, value, name ) {
-			if ( jQuery.nodeName( elem, "input" ) ) {
-				// Does not return so that setAttribute is also used
-				elem.defaultValue = value;
-			} else {
-				// Use nodeHook if defined (#1954); otherwise setAttribute is fine
-				return nodeHook && nodeHook.set( elem, value, name );
-			}
-		}
-	};
-}
-
-// IE6/7 do not support getting/setting some attributes with get/setAttribute
-if ( !getSetAttribute ) {
-
-	// Use this for any attribute in IE6/7
-	// This fixes almost every IE6/7 issue
-	nodeHook = {
-		set: function( elem, value, name ) {
-			// Set the existing or create a new attribute node
-			var ret = elem.getAttributeNode( name );
-			if ( !ret ) {
-				elem.setAttributeNode(
-					(ret = elem.ownerDocument.createAttribute( name ))
-				);
-			}
-
-			ret.value = value += "";
-
-			// Break association with cloned elements by also using setAttribute (#9646)
-			if ( name === "value" || value === elem.getAttribute( name ) ) {
-				return value;
-			}
-		}
-	};
-
-	// Some attributes are constructed with empty-string values when not defined
-	attrHandle.id = attrHandle.name = attrHandle.coords =
-		function( elem, name, isXML ) {
-			var ret;
-			if ( !isXML ) {
-				return (ret = elem.getAttributeNode( name )) && ret.value !== "" ?
-					ret.value :
-					null;
-			}
-		};
-
-	// Fixing value retrieval on a button requires this module
-	jQuery.valHooks.button = {
-		get: function( elem, name ) {
-			var ret = elem.getAttributeNode( name );
-			if ( ret && ret.specified ) {
-				return ret.value;
-			}
-		},
-		set: nodeHook.set
-	};
-
-	// Set contenteditable to false on removals(#10429)
-	// Setting to empty string throws an error as an invalid value
-	jQuery.attrHooks.contenteditable = {
-		set: function( elem, value, name ) {
-			nodeHook.set( elem, value === "" ? false : value, name );
-		}
-	};
-
-	// Set width and height to auto instead of 0 on empty string( Bug #8150 )
-	// This is for removals
-	jQuery.each([ "width", "height" ], function( i, name ) {
-		jQuery.attrHooks[ name ] = {
-			set: function( elem, value ) {
-				if ( value === "" ) {
-					elem.setAttribute( name, "auto" );
-					return value;
-				}
-			}
-		};
-	});
-}
-
-if ( !support.style ) {
-	jQuery.attrHooks.style = {
-		get: function( elem ) {
-			// Return undefined in the case of empty string
-			// Note: IE uppercases css property names, but if we were to .toLowerCase()
-			// .cssText, that would destroy case senstitivity in URL's, like in "background"
-			return elem.style.cssText || undefined;
-		},
-		set: function( elem, value ) {
-			return ( elem.style.cssText = value + "" );
-		}
-	};
-}
-
-
-
-
-var rfocusable = /^(?:input|select|textarea|button|object)$/i,
-	rclickable = /^(?:a|area)$/i;
-
-jQuery.fn.extend({
-	prop: function( name, value ) {
-		return access( this, jQuery.prop, name, value, arguments.length > 1 );
-	},
-
-	removeProp: function( name ) {
-		name = jQuery.propFix[ name ] || name;
-		return this.each(function() {
-			// try/catch handles cases where IE balks (such as removing a property on window)
-			try {
-				this[ name ] = undefined;
-				delete this[ name ];
-			} catch( e ) {}
-		});
-	}
-});
-
-jQuery.extend({
-	propFix: {
-		"for": "htmlFor",
-		"class": "className"
-	},
-
-	prop: function( elem, name, value ) {
-		var ret, hooks, notxml,
-			nType = elem.nodeType;
-
-		// don't get/set properties on text, comment and attribute nodes
-		if ( !elem || nType === 3 || nType === 8 || nType === 2 ) {
-			return;
-		}
-
-		notxml = nType !== 1 || !jQuery.isXMLDoc( elem );
-
-		if ( notxml ) {
-			// Fix name and attach hooks
-			name = jQuery.propFix[ name ] || name;
-			hooks = jQuery.propHooks[ name ];
-		}
-
-		if ( value !== undefined ) {
-			return hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ?
-				ret :
-				( elem[ name ] = value );
-
-		} else {
-			return hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ?
-				ret :
-				elem[ name ];
-		}
-	},
-
-	propHooks: {
-		tabIndex: {
-			get: function( elem ) {
-				// elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set
-				// http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
-				// Use proper attribute retrieval(#12072)
-				var tabindex = jQuery.find.attr( elem, "tabindex" );
-
-				return tabindex ?
-					parseInt( tabindex, 10 ) :
-					rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ?
-						0 :
-						-1;
-			}
-		}
-	}
-});
-
-// Some attributes require a special call on IE
-// http://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
-if ( !support.hrefNormalized ) {
-	// href/src property should get the full normalized URL (#10299/#12915)
-	jQuery.each([ "href", "src" ], function( i, name ) {
-		jQuery.propHooks[ name ] = {
-			get: function( elem ) {
-				return elem.getAttribute( name, 4 );
-			}
-		};
-	});
-}
-
-// Support: Safari, IE9+
-// mis-reports the default selected property of an option
-// Accessing the parent's selectedIndex property fixes it
-if ( !support.optSelected ) {
-	jQuery.propHooks.selected = {
-		get: function( elem ) {
-			var parent = elem.parentNode;
-
-			if ( parent ) {
-				parent.selectedIndex;
-
-				// Make sure that it also works with optgroups, see #5701
-				if ( parent.parentNode ) {
-					parent.parentNode.selectedIndex;
-				}
-			}
-			return null;
-		}
-	};
-}
-
-jQuery.each([
-	"tabIndex",
-	"readOnly",
-	"maxLength",
-	"cellSpacing",
-	"cellPadding",
-	"rowSpan",
-	"colSpan",
-	"useMap",
-	"frameBorder",
-	"contentEditable"
-], function() {
-	jQuery.propFix[ this.toLowerCase() ] = this;
-});
-
-// IE6/7 call enctype encoding
-if ( !support.enctype ) {
-	jQuery.propFix.enctype = "encoding";
-}
-
-
-
-
-var rclass = /[\t\r\n\f]/g;
-
-jQuery.fn.extend({
-	addClass: function( value ) {
-		var classes, elem, cur, clazz, j, finalValue,
-			i = 0,
-			len = this.length,
-			proceed = typeof value === "string" && value;
-
-		if ( jQuery.isFunction( value ) ) {
-			return this.each(function( j ) {
-				jQuery( this ).addClass( value.call( this, j, this.className ) );
-			});
-		}
-
-		if ( proceed ) {
-			// The disjunction here is for better compressibility (see removeClass)
-			classes = ( value || "" ).match( rnotwhite ) || [];
-
-			for ( ; i < len; i++ ) {
-				elem = this[ i ];
-				cur = elem.nodeType === 1 && ( elem.className ?
-					( " " + elem.className + " " ).replace( rclass, " " ) :
-					" "
-				);
-
-				if ( cur ) {
-					j = 0;
-					while ( (clazz = classes[j++]) ) {
-						if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
-							cur += clazz + " ";
-						}
-					}
-
-					// only assign if different to avoid unneeded rendering.
-					finalValue = jQuery.trim( cur );
-					if ( elem.className !== finalValue ) {
-						elem.className = finalValue;
-					}
-				}
-			}
-		}
-
-		return this;
-	},
-
-	removeClass: function( value ) {
-		var classes, elem, cur, clazz, j, finalValue,
-			i = 0,
-			len = this.length,
-			proceed = arguments.length === 0 || typeof value === "string" && value;
-
-		if ( jQuery.isFunction( value ) ) {
-			return this.each(function( j ) {
-				jQuery( this ).removeClass( value.call( this, j, this.className ) );
-			});
-		}
-		if ( proceed ) {
-			classes = ( value || "" ).match( rnotwhite ) || [];
-
-			for ( ; i < len; i++ ) {
-				elem = this[ i ];
-				// This expression is here for better compressibility (see addClass)
-				cur = elem.nodeType === 1 && ( elem.className ?
-					( " " + elem.className + " " ).replace( rclass, " " ) :
-					""
-				);
-
-				if ( cur ) {
-					j = 0;
-					while ( (clazz = classes[j++]) ) {
-						// Remove *all* instances
-						while ( cur.indexOf( " " + clazz + " " ) >= 0 ) {
-							cur = cur.replace( " " + clazz + " ", " " );
-						}
-					}
-
-					// only assign if different to avoid unneeded rendering.
-					finalValue = value ? jQuery.trim( cur ) : "";
-					if ( elem.className !== finalValue ) {
-						elem.className = finalValue;
-					}
-				}
-			}
-		}
-
-		return this;
-	},
-
-	toggleClass: function( value, stateVal ) {
-		var type = typeof value;
-
-		if ( typeof stateVal === "boolean" && type === "string" ) {
-			return stateVal ? this.addClass( value ) : this.removeClass( value );
-		}
-
-		if ( jQuery.isFunction( value ) ) {
-			return this.each(function( i ) {
-				jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal );
-			});
-		}
-
-		return this.each(function() {
-			if ( type === "string" ) {
-				// toggle individual class names
-				var className,
-					i = 0,
-					self = jQuery( this ),
-					classNames = value.match( rnotwhite ) || [];
-
-				while ( (className = classNames[ i++ ]) ) {
-					// check each className given, space separated list
-					if ( self.hasClass( className ) ) {
-						self.removeClass( className );
-					} else {
-						self.addClass( className );
-					}
-				}
-
-			// Toggle whole class name
-			} else if ( type === strundefined || type === "boolean" ) {
-				if ( this.className ) {
-					// store className if set
-					jQuery._data( this, "__className__", this.className );
-				}
-
-				// If the element has a class name or if we're passed "false",
-				// then remove the whole classname (if there was one, the above saved it).
-				// Otherwise bring back whatever was previously saved (if anything),
-				// falling back to the empty string if nothing was stored.
-				this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || "";
-			}
-		});
-	},
-
-	hasClass: function( selector ) {
-		var className = " " + selector + " ",
-			i = 0,
-			l = this.length;
-		for ( ; i < l; i++ ) {
-			if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) >= 0 ) {
-				return true;
-			}
-		}
-
-		return false;
-	}
-});
-
-
-
-
-// Return jQuery for attributes-only inclusion
-
-
-jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " +
-	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
-	"change select submit keydown keypress keyup error contextmenu").split(" "), function( i, name ) {
-
-	// Handle event binding
-	jQuery.fn[ name ] = function( data, fn ) {
-		return arguments.length > 0 ?
-			this.on( name, null, data, fn ) :
-			this.trigger( name );
-	};
-});
-
-jQuery.fn.extend({
-	hover: function( fnOver, fnOut ) {
-		return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );
-	},
-
-	bind: function( types, data, fn ) {
-		return this.on( types, null, data, fn );
-	},
-	unbind: function( types, fn ) {
-		return this.off( types, null, fn );
-	},
-
-	delegate: function( selector, types, data, fn ) {
-		return this.on( types, selector, data, fn );
-	},
-	undelegate: function( selector, types, fn ) {
-		// ( namespace ) or ( selector, types [, fn] )
-		return arguments.length === 1 ? this.off( selector, "**" ) : this.off( types, selector || "**", fn );
-	}
-});
-
-
-var nonce = jQuery.now();
-
-var rquery = (/\?/);
-
-
-
-var rvalidtokens = /(,)|(\[|{)|(}|])|"(?:[^"\\\r\n]|\\["\\\/bfnrt]|\\u[\da-fA-F]{4})*"\s*:?|true|false|null|-?(?!0\d)\d+(?:\.\d+|)(?:[eE][+-]?\d+|)/g;
-
-jQuery.parseJSON = function( data ) {
-	// Attempt to parse using the native JSON parser first
-	if ( window.JSON && window.JSON.parse ) {
-		// Support: Android 2.3
-		// Workaround failure to string-cast null input
-		return window.JSON.parse( data + "" );
-	}
-
-	var requireNonComma,
-		depth = null,
-		str = jQuery.trim( data + "" );
-
-	// Guard against invalid (and possibly dangerous) input by ensuring that nothing remains
-	// after removing valid tokens
-	return str && !jQuery.trim( str.replace( rvalidtokens, function( token, comma, open, close ) {
-
-		// Force termination if we see a misplaced comma
-		if ( requireNonComma && comma ) {
-			depth = 0;
-		}
-
-		// Perform no more replacements after returning to outermost depth
-		if ( depth === 0 ) {
-			return token;
-		}
-
-		// Commas must not follow "[", "{", or ","
-		requireNonComma = open || comma;
-
-		// Determine new depth
-		// array/object open ("[" or "{"): depth += true - false (increment)
-		// array/object close ("]" or "}"): depth += false - true (decrement)
-		// other cases ("," or primitive): depth += true - true (numeric cast)
-		depth += !close - !open;
-
-		// Remove this token
-		return "";
-	}) ) ?
-		( Function( "return " + str ) )() :
-		jQuery.error( "Invalid JSON: " + data );
-};
-
-
-// Cross-browser xml parsing
-jQuery.parseXML = function( data ) {
-	var xml, tmp;
-	if ( !data || typeof data !== "string" ) {
-		return null;
-	}
-	try {
-		if ( window.DOMParser ) { // Standard
-			tmp = new DOMParser();
-			xml = tmp.parseFromString( data, "text/xml" );
-		} else { // IE
-			xml = new ActiveXObject( "Microsoft.XMLDOM" );
-			xml.async = "false";
-			xml.loadXML( data );
-		}
-	} catch( e ) {
-		xml = undefined;
-	}
-	if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) {
-		jQuery.error( "Invalid XML: " + data );
-	}
-	return xml;
-};
-
-
-var
-	// Document location
-	ajaxLocParts,
-	ajaxLocation,
-
-	rhash = /#.*$/,
-	rts = /([?&])_=[^&]*/,
-	rheaders = /^(.*?):[ \t]*([^\r\n]*)\r?$/mg, // IE leaves an \r character at EOL
-	// #7653, #8125, #8152: local protocol detection
-	rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/,
-	rnoContent = /^(?:GET|HEAD)$/,
-	rprotocol = /^\/\//,
-	rurl = /^([\w.+-]+:)(?:\/\/(?:[^\/?#]*@|)([^\/?#:]*)(?::(\d+)|)|)/,
-
-	/* Prefilters
-	 * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example)
-	 * 2) These are called:
-	 *    - BEFORE asking for a transport
-	 *    - AFTER param serialization (s.data is a string if s.processData is true)
-	 * 3) key is the dataType
-	 * 4) the catchall symbol "*" can be used
-	 * 5) execution will start with transport dataType and THEN continue down to "*" if needed
-	 */
-	prefilters = {},
-
-	/* Transports bindings
-	 * 1) key is the dataType
-	 * 2) the catchall symbol "*" can be used
-	 * 3) selection will start with transport dataType and THEN go to "*" if needed
-	 */
-	transports = {},
-
-	// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression
-	allTypes = "*/".concat("*");
-
-// #8138, IE may throw an exception when accessing
-// a field from window.location if document.domain has been set
-try {
-	ajaxLocation = location.href;
-} catch( e ) {
-	// Use the href attribute of an A element
-	// since IE will modify it given document.location
-	ajaxLocation = document.createElement( "a" );
-	ajaxLocation.href = "";
-	ajaxLocation = ajaxLocation.href;
-}
-
-// Segment location into parts
-ajaxLocParts = rurl.exec( ajaxLocation.toLowerCase() ) || [];
-
-// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
-function addToPrefiltersOrTransports( structure ) {
-
-	// dataTypeExpression is optional and defaults to "*"
-	return function( dataTypeExpression, func ) {
-
-		if ( typeof dataTypeExpression !== "string" ) {
-			func = dataTypeExpression;
-			dataTypeExpression = "*";
-		}
-
-		var dataType,
-			i = 0,
-			dataTypes = dataTypeExpression.toLowerCase().match( rnotwhite ) || [];
-
-		if ( jQuery.isFunction( func ) ) {
-			// For each dataType in the dataTypeExpression
-			while ( (dataType = dataTypes[i++]) ) {
-				// Prepend if requested
-				if ( dataType.charAt( 0 ) === "+" ) {
-					dataType = dataType.slice( 1 ) || "*";
-					(structure[ dataType ] = structure[ dataType ] || []).unshift( func );
-
-				// Otherwise append
-				} else {
-					(structure[ dataType ] = structure[ dataType ] || []).push( func );
-				}
-			}
-		}
-	};
-}
-
-// Base inspection function for prefilters and transports
-function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) {
-
-	var inspected = {},
-		seekingTransport = ( structure === transports );
-
-	function inspect( dataType ) {
-		var selected;
-		inspected[ dataType ] = true;
-		jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) {
-			var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR );
-			if ( typeof dataTypeOrTransport === "string" && !seekingTransport && !inspected[ dataTypeOrTransport ] ) {
-				options.dataTypes.unshift( dataTypeOrTransport );
-				inspect( dataTypeOrTransport );
-				return false;
-			} else if ( seekingTransport ) {
-				return !( selected = dataTypeOrTransport );
-			}
-		});
-		return selected;
-	}
-
-	return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" );
-}
-
-// A special extend for ajax options
-// that takes "flat" options (not to be deep extended)
-// Fixes #9887
-function ajaxExtend( target, src ) {
-	var deep, key,
-		flatOptions = jQuery.ajaxSettings.flatOptions || {};
-
-	for ( key in src ) {
-		if ( src[ key ] !== undefined ) {
-			( flatOptions[ key ] ? target : ( deep || (deep = {}) ) )[ key ] = src[ key ];
-		}
-	}
-	if ( deep ) {
-		jQuery.extend( true, target, deep );
-	}
-
-	return target;
-}
-
-/* Handles responses to an ajax request:
- * - finds the right dataType (mediates between content-type and expected dataType)
- * - returns the corresponding response
- */
-function ajaxHandleResponses( s, jqXHR, responses ) {
-	var firstDataType, ct, finalDataType, type,
-		contents = s.contents,
-		dataTypes = s.dataTypes;
-
-	// Remove auto dataType and get content-type in the process
-	while ( dataTypes[ 0 ] === "*" ) {
-		dataTypes.shift();
-		if ( ct === undefined ) {
-			ct = s.mimeType || jqXHR.getResponseHeader("Content-Type");
-		}
-	}
-
-	// Check if we're dealing with a known content-type
-	if ( ct ) {
-		for ( type in contents ) {
-			if ( contents[ type ] && contents[ type ].test( ct ) ) {
-				dataTypes.unshift( type );
-				break;
-			}
-		}
-	}
-
-	// Check to see if we have a response for the expected dataType
-	if ( dataTypes[ 0 ] in responses ) {
-		finalDataType = dataTypes[ 0 ];
-	} else {
-		// Try convertible dataTypes
-		for ( type in responses ) {
-			if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[0] ] ) {
-				finalDataType = type;
-				break;
-			}
-			if ( !firstDataType ) {
-				firstDataType = type;
-			}
-		}
-		// Or just use first one
-		finalDataType = finalDataType || firstDataType;
-	}
-
-	// If we found a dataType
-	// We add the dataType to the list if needed
-	// and return the corresponding response
-	if ( finalDataType ) {
-		if ( finalDataType !== dataTypes[ 0 ] ) {
-			dataTypes.unshift( finalDataType );
-		}
-		return responses[ finalDataType ];
-	}
-}
-
-/* Chain conversions given the request and the original response
- * Also sets the responseXXX fields on the jqXHR instance
- */
-function ajaxConvert( s, response, jqXHR, isSuccess ) {
-	var conv2, current, conv, tmp, prev,
-		converters = {},
-		// Work with a copy of dataTypes in case we need to modify it for conversion
-		dataTypes = s.dataTypes.slice();
-
-	// Create converters map with lowercased keys
-	if ( dataTypes[ 1 ] ) {
-		for ( conv in s.converters ) {
-			converters[ conv.toLowerCase() ] = s.converters[ conv ];
-		}
-	}
-
-	current = dataTypes.shift();
-
-	// Convert to each sequential dataType
-	while ( current ) {
-
-		if ( s.responseFields[ current ] ) {
-			jqXHR[ s.responseFields[ current ] ] = response;
-		}
-
-		// Apply the dataFilter if provided
-		if ( !prev && isSuccess && s.dataFilter ) {
-			response = s.dataFilter( response, s.dataType );
-		}
-
-		prev = current;
-		current = dataTypes.shift();
-
-		if ( current ) {
-
-			// There's only work to do if current dataType is non-auto
-			if ( current === "*" ) {
-
-				current = prev;
-
-			// Convert response if prev dataType is non-auto and differs from current
-			} else if ( prev !== "*" && prev !== current ) {
-
-				// Seek a direct converter
-				conv = converters[ prev + " " + current ] || converters[ "* " + current ];
-
-				// If none found, seek a pair
-				if ( !conv ) {
-					for ( conv2 in converters ) {
-
-						// If conv2 outputs current
-						tmp = conv2.split( " " );
-						if ( tmp[ 1 ] === current ) {
-
-							// If prev can be converted to accepted input
-							conv = converters[ prev + " " + tmp[ 0 ] ] ||
-								converters[ "* " + tmp[ 0 ] ];
-							if ( conv ) {
-								// Condense equivalence converters
-								if ( conv === true ) {
-									conv = converters[ conv2 ];
-
-								// Otherwise, insert the intermediate dataType
-								} else if ( converters[ conv2 ] !== true ) {
-									current = tmp[ 0 ];
-									dataTypes.unshift( tmp[ 1 ] );
-								}
-								break;
-							}
-						}
-					}
-				}
-
-				// Apply converter (if not an equivalence)
-				if ( conv !== true ) {
-
-					// Unless errors are allowed to bubble, catch and return them
-					if ( conv && s[ "throws" ] ) {
-						response = conv( response );
-					} else {
-						try {
-							response = conv( response );
-						} catch ( e ) {
-							return { state: "parsererror", error: conv ? e : "No conversion from " + prev + " to " + current };
-						}
-					}
-				}
-			}
-		}
-	}
-
-	return { state: "success", data: response };
-}
-
-jQuery.extend({
-
-	// Counter for holding the number of active queries
-	active: 0,
-
-	// Last-Modified header cache for next request
-	lastModified: {},
-	etag: {},
-
-	ajaxSettings: {
-		url: ajaxLocation,
-		type: "GET",
-		isLocal: rlocalProtocol.test( ajaxLocParts[ 1 ] ),
-		global: true,
-		processData: true,
-		async: true,
-		contentType: "application/x-www-form-urlencoded; charset=UTF-8",
-		/*
-		timeout: 0,
-		data: null,
-		dataType: null,
-		username: null,
-		password: null,
-		cache: null,
-		throws: false,
-		traditional: false,
-		headers: {},
-		*/
-
-		accepts: {
-			"*": allTypes,
-			text: "text/plain",
-			html: "text/html",
-			xml: "application/xml, text/xml",
-			json: "application/json, text/javascript"
-		},
-
-		contents: {
-			xml: /xml/,
-			html: /html/,
-			json: /json/
-		},
-
-		responseFields: {
-			xml: "responseXML",
-			text: "responseText",
-			json: "responseJSON"
-		},
-
-		// Data converters
-		// Keys separate source (or catchall "*") and destination types with a single space
-		converters: {
-
-			// Convert anything to text
-			"* text": String,
-
-			// Text to html (true = no transformation)
-			"text html": true,
-
-			// Evaluate text as a json expression
-			"text json": jQuery.parseJSON,
-
-			// Parse text as xml
-			"text xml": jQuery.parseXML
-		},
-
-		// For options that shouldn't be deep extended:
-		// you can add your own custom options here if
-		// and when you create one that shouldn't be
-		// deep extended (see ajaxExtend)
-		flatOptions: {
-			url: true,
-			context: true
-		}
-	},
-
-	// Creates a full fledged settings object into target
-	// with both ajaxSettings and settings fields.
-	// If target is omitted, writes into ajaxSettings.
-	ajaxSetup: function( target, settings ) {
-		return settings ?
-
-			// Building a settings object
-			ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
-
-			// Extending ajaxSettings
-			ajaxExtend( jQuery.ajaxSettings, target );
-	},
-
-	ajaxPrefilter: addToPrefiltersOrTransports( prefilters ),
-	ajaxTransport: addToPrefiltersOrTransports( transports ),
-
-	// Main method
-	ajax: function( url, options ) {
-
-		// If url is an object, simulate pre-1.5 signature
-		if ( typeof url === "object" ) {
-			options = url;
-			url = undefined;
-		}
-
-		// Force options to be an object
-		options = options || {};
-
-		var // Cross-domain detection vars
-			parts,
-			// Loop variable
-			i,
-			// URL without anti-cache param
-			cacheURL,
-			// Response headers as string
-			responseHeadersString,
-			// timeout handle
-			timeoutTimer,
-
-			// To know if global events are to be dispatched
-			fireGlobals,
-
-			transport,
-			// Response headers
-			responseHeaders,
-			// Create the final options object
-			s = jQuery.ajaxSetup( {}, options ),
-			// Callbacks context
-			callbackContext = s.context || s,
-			// Context for global events is callbackContext if it is a DOM node or jQuery collection
-			globalEventContext = s.context && ( callbackContext.nodeType || callbackContext.jquery ) ?
-				jQuery( callbackContext ) :
-				jQuery.event,
-			// Deferreds
-			deferred = jQuery.Deferred(),
-			completeDeferred = jQuery.Callbacks("once memory"),
-			// Status-dependent callbacks
-			statusCode = s.statusCode || {},
-			// Headers (they are sent all at once)
-			requestHeaders = {},
-			requestHeadersNames = {},
-			// The jqXHR state
-			state = 0,
-			// Default abort message
-			strAbort = "canceled",
-			// Fake xhr
-			jqXHR = {
-				readyState: 0,
-
-				// Builds headers hashtable if needed
-				getResponseHeader: function( key ) {
-					var match;
-					if ( state === 2 ) {
-						if ( !responseHeaders ) {
-							responseHeaders = {};
-							while ( (match = rheaders.exec( responseHeadersString )) ) {
-								responseHeaders[ match[1].toLowerCase() ] = match[ 2 ];
-							}
-						}
-						match = responseHeaders[ key.toLowerCase() ];
-					}
-					return match == null ? null : match;
-				},
-
-				// Raw string
-				getAllResponseHeaders: function() {
-					return state === 2 ? responseHeadersString : null;
-				},
-
-				// Caches the header
-				setRequestHeader: function( name, value ) {
-					var lname = name.toLowerCase();
-					if ( !state ) {
-						name = requestHeadersNames[ lname ] = requestHeadersNames[ lname ] || name;
-						requestHeaders[ name ] = value;
-					}
-					return this;
-				},
-
-				// Overrides response content-type header
-				overrideMimeType: function( type ) {
-					if ( !state ) {
-						s.mimeType = type;
-					}
-					return this;
-				},
-
-				// Status-dependent callbacks
-				statusCode: function( map ) {
-					var code;
-					if ( map ) {
-						if ( state < 2 ) {
-							for ( code in map ) {
-								// Lazy-add the new callback in a way that preserves old ones
-								statusCode[ code ] = [ statusCode[ code ], map[ code ] ];
-							}
-						} else {
-							// Execute the appropriate callbacks
-							jqXHR.always( map[ jqXHR.status ] );
-						}
-					}
-					return this;
-				},
-
-				// Cancel the request
-				abort: function( statusText ) {
-					var finalText = statusText || strAbort;
-					if ( transport ) {
-						transport.abort( finalText );
-					}
-					done( 0, finalText );
-					return this;
-				}
-			};
-
-		// Attach deferreds
-		deferred.promise( jqXHR ).complete = completeDeferred.add;
-		jqXHR.success = jqXHR.done;
-		jqXHR.error = jqXHR.fail;
-
-		// Remove hash character (#7531: and string promotion)
-		// Add protocol if not provided (#5866: IE7 issue with protocol-less urls)
-		// Handle falsy url in the settings object (#10093: consistency with old signature)
-		// We also use the url parameter if available
-		s.url = ( ( url || s.url || ajaxLocation ) + "" ).replace( rhash, "" ).replace( rprotocol, ajaxLocParts[ 1 ] + "//" );
-
-		// Alias method option to type as per ticket #12004
-		s.type = options.method || options.type || s.method || s.type;
-
-		// Extract dataTypes list
-		s.dataTypes = jQuery.trim( s.dataType || "*" ).toLowerCase().match( rnotwhite ) || [ "" ];
-
-		// A cross-domain request is in order when we have a protocol:host:port mismatch
-		if ( s.crossDomain == null ) {
-			parts = rurl.exec( s.url.toLowerCase() );
-			s.crossDomain = !!( parts &&
-				( parts[ 1 ] !== ajaxLocParts[ 1 ] || parts[ 2 ] !== ajaxLocParts[ 2 ] ||
-					( parts[ 3 ] || ( parts[ 1 ] === "http:" ? "80" : "443" ) ) !==
-						( ajaxLocParts[ 3 ] || ( ajaxLocParts[ 1 ] === "http:" ? "80" : "443" ) ) )
-			);
-		}
-
-		// Convert data if not already a string
-		if ( s.data && s.processData && typeof s.data !== "string" ) {
-			s.data = jQuery.param( s.data, s.traditional );
-		}
-
-		// Apply prefilters
-		inspectPrefiltersOrTransports( prefilters, s, options, jqXHR );
-
-		// If request was aborted inside a prefilter, stop there
-		if ( state === 2 ) {
-			return jqXHR;
-		}
-
-		// We can fire global events as of now if asked to
-		fireGlobals = s.global;
-
-		// Watch for a new set of requests
-		if ( fireGlobals && jQuery.active++ === 0 ) {
-			jQuery.event.trigger("ajaxStart");
-		}
-
-		// Uppercase the type
-		s.type = s.type.toUpperCase();
-
-		// Determine if request has content
-		s.hasContent = !rnoContent.test( s.type );
-
-		// Save the URL in case we're toying with the If-Modified-Since
-		// and/or If-None-Match header later on
-		cacheURL = s.url;
-
-		// More options handling for requests with no content
-		if ( !s.hasContent ) {
-
-			// If data is available, append data to url
-			if ( s.data ) {
-				cacheURL = ( s.url += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data );
-				// #9682: remove data so that it's not used in an eventual retry
-				delete s.data;
-			}
-
-			// Add anti-cache in url if needed
-			if ( s.cache === false ) {
-				s.url = rts.test( cacheURL ) ?
-
-					// If there is already a '_' parameter, set its value
-					cacheURL.replace( rts, "$1_=" + nonce++ ) :
-
-					// Otherwise add one to the end
-					cacheURL + ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + nonce++;
-			}
-		}
-
-		// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
-		if ( s.ifModified ) {
-			if ( jQuery.lastModified[ cacheURL ] ) {
-				jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] );
-			}
-			if ( jQuery.etag[ cacheURL ] ) {
-				jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] );
-			}
-		}
-
-		// Set the correct header, if data is being sent
-		if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) {
-			jqXHR.setRequestHeader( "Content-Type", s.contentType );
-		}
-
-		// Set the Accepts header for the server, depending on the dataType
-		jqXHR.setRequestHeader(
-			"Accept",
-			s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[0] ] ?
-				s.accepts[ s.dataTypes[0] ] + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) :
-				s.accepts[ "*" ]
-		);
-
-		// Check for headers option
-		for ( i in s.headers ) {
-			jqXHR.setRequestHeader( i, s.headers[ i ] );
-		}
-
-		// Allow custom headers/mimetypes and early abort
-		if ( s.beforeSend && ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || state === 2 ) ) {
-			// Abort if not done already and return
-			return jqXHR.abort();
-		}
-
-		// aborting is no longer a cancellation
-		strAbort = "abort";
-
-		// Install callbacks on deferreds
-		for ( i in { success: 1, error: 1, complete: 1 } ) {
-			jqXHR[ i ]( s[ i ] );
-		}
-
-		// Get transport
-		transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR );
-
-		// If no transport, we auto-abort
-		if ( !transport ) {
-			done( -1, "No Transport" );
-		} else {
-			jqXHR.readyState = 1;
-
-			// Send global event
-			if ( fireGlobals ) {
-				globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] );
-			}
-			// Timeout
-			if ( s.async && s.timeout > 0 ) {
-				timeoutTimer = setTimeout(function() {
-					jqXHR.abort("timeout");
-				}, s.timeout );
-			}
-
-			try {
-				state = 1;
-				transport.send( requestHeaders, done );
-			} catch ( e ) {
-				// Propagate exception as error if not done
-				if ( state < 2 ) {
-					done( -1, e );
-				// Simply rethrow otherwise
-				} else {
-					throw e;
-				}
-			}
-		}
-
-		// Callback for when everything is done
-		function done( status, nativeStatusText, responses, headers ) {
-			var isSuccess, success, error, response, modified,
-				statusText = nativeStatusText;
-
-			// Called once
-			if ( state === 2 ) {
-				return;
-			}
-
-			// State is "done" now
-			state = 2;
-
-			// Clear timeout if it exists
-			if ( timeoutTimer ) {
-				clearTimeout( timeoutTimer );
-			}
-
-			// Dereference transport for early garbage collection
-			// (no matter how long the jqXHR object will be used)
-			transport = undefined;
-
-			// Cache response headers
-			responseHeadersString = headers || "";
-
-			// Set readyState
-			jqXHR.readyState = status > 0 ? 4 : 0;
-
-			// Determine if successful
-			isSuccess = status >= 200 && status < 300 || status === 304;
-
-			// Get response data
-			if ( responses ) {
-				response = ajaxHandleResponses( s, jqXHR, responses );
-			}
-
-			// Convert no matter what (that way responseXXX fields are always set)
-			response = ajaxConvert( s, response, jqXHR, isSuccess );
-
-			// If successful, handle type chaining
-			if ( isSuccess ) {
-
-				// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
-				if ( s.ifModified ) {
-					modified = jqXHR.getResponseHeader("Last-Modified");
-					if ( modified ) {
-						jQuery.lastModified[ cacheURL ] = modified;
-					}
-					modified = jqXHR.getResponseHeader("etag");
-					if ( modified ) {
-						jQuery.etag[ cacheURL ] = modified;
-					}
-				}
-
-				// if no content
-				if ( status === 204 || s.type === "HEAD" ) {
-					statusText = "nocontent";
-
-				// if not modified
-				} else if ( status === 304 ) {
-					statusText = "notmodified";
-
-				// If we have data, let's convert it
-				} else {
-					statusText = response.state;
-					success = response.data;
-					error = response.error;
-					isSuccess = !error;
-				}
-			} else {
-				// We extract error from statusText
-				// then normalize statusText and status for non-aborts
-				error = statusText;
-				if ( status || !statusText ) {
-					statusText = "error";
-					if ( status < 0 ) {
-						status = 0;
-					}
-				}
-			}
-
-			// Set data for the fake xhr object
-			jqXHR.status = status;
-			jqXHR.statusText = ( nativeStatusText || statusText ) + "";
-
-			// Success/Error
-			if ( isSuccess ) {
-				deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] );
-			} else {
-				deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] );
-			}
-
-			// Status-dependent callbacks
-			jqXHR.statusCode( statusCode );
-			statusCode = undefined;
-
-			if ( fireGlobals ) {
-				globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError",
-					[ jqXHR, s, isSuccess ? success : error ] );
-			}
-
-			// Complete
-			completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] );
-
-			if ( fireGlobals ) {
-				globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] );
-				// Handle the global AJAX counter
-				if ( !( --jQuery.active ) ) {
-					jQuery.event.trigger("ajaxStop");
-				}
-			}
-		}
-
-		return jqXHR;
-	},
-
-	getJSON: function( url, data, callback ) {
-		return jQuery.get( url, data, callback, "json" );
-	},
-
-	getScript: function( url, callback ) {
-		return jQuery.get( url, undefined, callback, "script" );
-	}
-});
-
-jQuery.each( [ "get", "post" ], function( i, method ) {
-	jQuery[ method ] = function( url, data, callback, type ) {
-		// shift arguments if data argument was omitted
-		if ( jQuery.isFunction( data ) ) {
-			type = type || callback;
-			callback = data;
-			data = undefined;
-		}
-
-		return jQuery.ajax({
-			url: url,
-			type: method,
-			dataType: type,
-			data: data,
-			success: callback
-		});
-	};
-});
-
-// Attach a bunch of functions for handling common AJAX events
-jQuery.each( [ "ajaxStart", "ajaxStop", "ajaxComplete", "ajaxError", "ajaxSuccess", "ajaxSend" ], function( i, type ) {
-	jQuery.fn[ type ] = function( fn ) {
-		return this.on( type, fn );
-	};
-});
-
-
-jQuery._evalUrl = function( url ) {
-	return jQuery.ajax({
-		url: url,
-		type: "GET",
-		dataType: "script",
-		async: false,
-		global: false,
-		"throws": true
-	});
-};
-
-
-jQuery.fn.extend({
-	wrapAll: function( html ) {
-		if ( jQuery.isFunction( html ) ) {
-			return this.each(function(i) {
-				jQuery(this).wrapAll( html.call(this, i) );
-			});
-		}
-
-		if ( this[0] ) {
-			// The elements to wrap the target around
-			var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true);
-
-			if ( this[0].parentNode ) {
-				wrap.insertBefore( this[0] );
-			}
-
-			wrap.map(function() {
-				var elem = this;
-
-				while ( elem.firstChild && elem.firstChild.nodeType === 1 ) {
-					elem = elem.firstChild;
-				}
-
-				return elem;
-			}).append( this );
-		}
-
-		return this;
-	},
-
-	wrapInner: function( html ) {
-		if ( jQuery.isFunction( html ) ) {
-			return this.each(function(i) {
-				jQuery(this).wrapInner( html.call(this, i) );
-			});
-		}
-
-		return this.each(function() {
-			var self = jQuery( this ),
-				contents = self.contents();
-
-			if ( contents.length ) {
-				contents.wrapAll( html );
-
-			} else {
-				self.append( html );
-			}
-		});
-	},
-
-	wrap: function( html ) {
-		var isFunction = jQuery.isFunction( html );
-
-		return this.each(function(i) {
-			jQuery( this ).wrapAll( isFunction ? html.call(this, i) : html );
-		});
-	},
-
-	unwrap: function() {
-		return this.parent().each(function() {
-			if ( !jQuery.nodeName( this, "body" ) ) {
-				jQuery( this ).replaceWith( this.childNodes );
-			}
-		}).end();
-	}
-});
-
-
-jQuery.expr.filters.hidden = function( elem ) {
-	// Support: Opera <= 12.12
-	// Opera reports offsetWidths and offsetHeights less than zero on some elements
-	return elem.offsetWidth <= 0 && elem.offsetHeight <= 0 ||
-		(!support.reliableHiddenOffsets() &&
-			((elem.style && elem.style.display) || jQuery.css( elem, "display" )) === "none");
-};
-
-jQuery.expr.filters.visible = function( elem ) {
-	return !jQuery.expr.filters.hidden( elem );
-};
-
-
-
-
-var r20 = /%20/g,
-	rbracket = /\[\]$/,
-	rCRLF = /\r?\n/g,
-	rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
-	rsubmittable = /^(?:input|select|textarea|keygen)/i;
-
-function buildParams( prefix, obj, traditional, add ) {
-	var name;
-
-	if ( jQuery.isArray( obj ) ) {
-		// Serialize array item.
-		jQuery.each( obj, function( i, v ) {
-			if ( traditional || rbracket.test( prefix ) ) {
-				// Treat each array item as a scalar.
-				add( prefix, v );
-
-			} else {
-				// Item is non-scalar (array or object), encode its numeric index.
-				buildParams( prefix + "[" + ( typeof v === "object" ? i : "" ) + "]", v, traditional, add );
-			}
-		});
-
-	} else if ( !traditional && jQuery.type( obj ) === "object" ) {
-		// Serialize object item.
-		for ( name in obj ) {
-			buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add );
-		}
-
-	} else {
-		// Serialize scalar item.
-		add( prefix, obj );
-	}
-}
-
-// Serialize an array of form elements or a set of
-// key/values into a query string
-jQuery.param = function( a, traditional ) {
-	var prefix,
-		s = [],
-		add = function( key, value ) {
-			// If value is a function, invoke it and return its value
-			value = jQuery.isFunction( value ) ? value() : ( value == null ? "" : value );
-			s[ s.length ] = encodeURIComponent( key ) + "=" + encodeURIComponent( value );
-		};
-
-	// Set traditional to true for jQuery <= 1.3.2 behavior.
-	if ( traditional === undefined ) {
-		traditional = jQuery.ajaxSettings && jQuery.ajaxSettings.traditional;
-	}
-
-	// If an array was passed in, assume that it is an array of form elements.
-	if ( jQuery.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
-		// Serialize the form elements
-		jQuery.each( a, function() {
-			add( this.name, this.value );
-		});
-
-	} else {
-		// If traditional, encode the "old" way (the way 1.3.2 or older
-		// did it), otherwise encode params recursively.
-		for ( prefix in a ) {
-			buildParams( prefix, a[ prefix ], traditional, add );
-		}
-	}
-
-	// Return the resulting serialization
-	return s.join( "&" ).replace( r20, "+" );
-};
-
-jQuery.fn.extend({
-	serialize: function() {
-		return jQuery.param( this.serializeArray() );
-	},
-	serializeArray: function() {
-		return this.map(function() {
-			// Can add propHook for "elements" to filter or add form elements
-			var elements = jQuery.prop( this, "elements" );
-			return elements ? jQuery.makeArray( elements ) : this;
-		})
-		.filter(function() {
-			var type = this.type;
-			// Use .is(":disabled") so that fieldset[disabled] works
-			return this.name && !jQuery( this ).is( ":disabled" ) &&
-				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
-				( this.checked || !rcheckableType.test( type ) );
-		})
-		.map(function( i, elem ) {
-			var val = jQuery( this ).val();
-
-			return val == null ?
-				null :
-				jQuery.isArray( val ) ?
-					jQuery.map( val, function( val ) {
-						return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
-					}) :
-					{ name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
-		}).get();
-	}
-});
-
-
-// Create the request object
-// (This is still attached to ajaxSettings for backward compatibility)
-jQuery.ajaxSettings.xhr = window.ActiveXObject !== undefined ?
-	// Support: IE6+
-	function() {
-
-		// XHR cannot access local files, always use ActiveX for that case
-		return !this.isLocal &&
-
-			// Support: IE7-8
-			// oldIE XHR does not support non-RFC2616 methods (#13240)
-			// See http://msdn.microsoft.com/en-us/library/ie/ms536648(v=vs.85).aspx
-			// and http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9
-			// Although this check for six methods instead of eight
-			// since IE also does not support "trace" and "connect"
-			/^(get|post|head|put|delete|options)$/i.test( this.type ) &&
-
-			createStandardXHR() || createActiveXHR();
-	} :
-	// For all other browsers, use the standard XMLHttpRequest object
-	createStandardXHR;
-
-var xhrId = 0,
-	xhrCallbacks = {},
-	xhrSupported = jQuery.ajaxSettings.xhr();
-
-// Support: IE<10
-// Open requests must be manually aborted on unload (#5280)
-if ( window.ActiveXObject ) {
-	jQuery( window ).on( "unload", function() {
-		for ( var key in xhrCallbacks ) {
-			xhrCallbacks[ key ]( undefined, true );
-		}
-	});
-}
-
-// Determine support properties
-support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported );
-xhrSupported = support.ajax = !!xhrSupported;
-
-// Create transport if the browser can provide an xhr
-if ( xhrSupported ) {
-
-	jQuery.ajaxTransport(function( options ) {
-		// Cross domain only allowed if supported through XMLHttpRequest
-		if ( !options.crossDomain || support.cors ) {
-
-			var callback;
-
-			return {
-				send: function( headers, complete ) {
-					var i,
-						xhr = options.xhr(),
-						id = ++xhrId;
-
-					// Open the socket
-					xhr.open( options.type, options.url, options.async, options.username, options.password );
-
-					// Apply custom fields if provided
-					if ( options.xhrFields ) {
-						for ( i in options.xhrFields ) {
-							xhr[ i ] = options.xhrFields[ i ];
-						}
-					}
-
-					// Override mime type if needed
-					if ( options.mimeType && xhr.overrideMimeType ) {
-						xhr.overrideMimeType( options.mimeType );
-					}
-
-					// X-Requested-With header
-					// For cross-domain requests, seeing as conditions for a preflight are
-					// akin to a jigsaw puzzle, we simply never set it to be sure.
-					// (it can always be set on a per-request basis or even using ajaxSetup)
-					// For same-domain requests, won't change header if already provided.
-					if ( !options.crossDomain && !headers["X-Requested-With"] ) {
-						headers["X-Requested-With"] = "XMLHttpRequest";
-					}
-
-					// Set headers
-					for ( i in headers ) {
-						// Support: IE<9
-						// IE's ActiveXObject throws a 'Type Mismatch' exception when setting
-						// request header to a null-value.
-						//
-						// To keep consistent with other XHR implementations, cast the value
-						// to string and ignore `undefined`.
-						if ( headers[ i ] !== undefined ) {
-							xhr.setRequestHeader( i, headers[ i ] + "" );
-						}
-					}
-
-					// Do send the request
-					// This may raise an exception which is actually
-					// handled in jQuery.ajax (so no try/catch here)
-					xhr.send( ( options.hasContent && options.data ) || null );
-
-					// Listener
-					callback = function( _, isAbort ) {
-						var status, statusText, responses;
-
-						// Was never called and is aborted or complete
-						if ( callback && ( isAbort || xhr.readyState === 4 ) ) {
-							// Clean up
-							delete xhrCallbacks[ id ];
-							callback = undefined;
-							xhr.onreadystatechange = jQuery.noop;
-
-							// Abort manually if needed
-							if ( isAbort ) {
-								if ( xhr.readyState !== 4 ) {
-									xhr.abort();
-								}
-							} else {
-								responses = {};
-								status = xhr.status;
-
-								// Support: IE<10
-								// Accessing binary-data responseText throws an exception
-								// (#11426)
-								if ( typeof xhr.responseText === "string" ) {
-									responses.text = xhr.responseText;
-								}
-
-								// Firefox throws an exception when accessing
-								// statusText for faulty cross-domain requests
-								try {
-									statusText = xhr.statusText;
-								} catch( e ) {
-									// We normalize with Webkit giving an empty statusText
-									statusText = "";
-								}
-
-								// Filter status for non standard behaviors
-
-								// If the request is local and we have data: assume a success
-								// (success with no data won't get notified, that's the best we
-								// can do given current implementations)
-								if ( !status && options.isLocal && !options.crossDomain ) {
-									status = responses.text ? 200 : 404;
-								// IE - #1450: sometimes returns 1223 when it should be 204
-								} else if ( status === 1223 ) {
-									status = 204;
-								}
-							}
-						}
-
-						// Call complete if needed
-						if ( responses ) {
-							complete( status, statusText, responses, xhr.getAllResponseHeaders() );
-						}
-					};
-
-					if ( !options.async ) {
-						// if we're in sync mode we fire the callback
-						callback();
-					} else if ( xhr.readyState === 4 ) {
-						// (IE6 & IE7) if it's in cache and has been
-						// retrieved directly we need to fire the callback
-						setTimeout( callback );
-					} else {
-						// Add to the list of active xhr callbacks
-						xhr.onreadystatechange = xhrCallbacks[ id ] = callback;
-					}
-				},
-
-				abort: function() {
-					if ( callback ) {
-						callback( undefined, true );
-					}
-				}
-			};
-		}
-	});
-}
-
-// Functions to create xhrs
-function createStandardXHR() {
-	try {
-		return new window.XMLHttpRequest();
-	} catch( e ) {}
-}
-
-function createActiveXHR() {
-	try {
-		return new window.ActiveXObject( "Microsoft.XMLHTTP" );
-	} catch( e ) {}
-}
-
-
-
-
-// Install script dataType
-jQuery.ajaxSetup({
-	accepts: {
-		script: "text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"
-	},
-	contents: {
-		script: /(?:java|ecma)script/
-	},
-	converters: {
-		"text script": function( text ) {
-			jQuery.globalEval( text );
-			return text;
-		}
-	}
-});
-
-// Handle cache's special case and global
-jQuery.ajaxPrefilter( "script", function( s ) {
-	if ( s.cache === undefined ) {
-		s.cache = false;
-	}
-	if ( s.crossDomain ) {
-		s.type = "GET";
-		s.global = false;
-	}
-});
-
-// Bind script tag hack transport
-jQuery.ajaxTransport( "script", function(s) {
-
-	// This transport only deals with cross domain requests
-	if ( s.crossDomain ) {
-
-		var script,
-			head = document.head || jQuery("head")[0] || document.documentElement;
-
-		return {
-
-			send: function( _, callback ) {
-
-				script = document.createElement("script");
-
-				script.async = true;
-
-				if ( s.scriptCharset ) {
-					script.charset = s.scriptCharset;
-				}
-
-				script.src = s.url;
-
-				// Attach handlers for all browsers
-				script.onload = script.onreadystatechange = function( _, isAbort ) {
-
-					if ( isAbort || !script.readyState || /loaded|complete/.test( script.readyState ) ) {
-
-						// Handle memory leak in IE
-						script.onload = script.onreadystatechange = null;
-
-						// Remove the script
-						if ( script.parentNode ) {
-							script.parentNode.removeChild( script );
-						}
-
-						// Dereference the script
-						script = null;
-
-						// Callback if not abort
-						if ( !isAbort ) {
-							callback( 200, "success" );
-						}
-					}
-				};
-
-				// Circumvent IE6 bugs with base elements (#2709 and #4378) by prepending
-				// Use native DOM manipulation to avoid our domManip AJAX trickery
-				head.insertBefore( script, head.firstChild );
-			},
-
-			abort: function() {
-				if ( script ) {
-					script.onload( undefined, true );
-				}
-			}
-		};
-	}
-});
-
-
-
-
-var oldCallbacks = [],
-	rjsonp = /(=)\?(?=&|$)|\?\?/;
-
-// Default jsonp settings
-jQuery.ajaxSetup({
-	jsonp: "callback",
-	jsonpCallback: function() {
-		var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( nonce++ ) );
-		this[ callback ] = true;
-		return callback;
-	}
-});
-
-// Detect, normalize options and install callbacks for jsonp requests
-jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) {
-
-	var callbackName, overwritten, responseContainer,
-		jsonProp = s.jsonp !== false && ( rjsonp.test( s.url ) ?
-			"url" :
-			typeof s.data === "string" && !( s.contentType || "" ).indexOf("application/x-www-form-urlencoded") && rjsonp.test( s.data ) && "data"
-		);
-
-	// Handle iff the expected data type is "jsonp" or we have a parameter to set
-	if ( jsonProp || s.dataTypes[ 0 ] === "jsonp" ) {
-
-		// Get callback name, remembering preexisting value associated with it
-		callbackName = s.jsonpCallback = jQuery.isFunction( s.jsonpCallback ) ?
-			s.jsonpCallback() :
-			s.jsonpCallback;
-
-		// Insert callback into url or form data
-		if ( jsonProp ) {
-			s[ jsonProp ] = s[ jsonProp ].replace( rjsonp, "$1" + callbackName );
-		} else if ( s.jsonp !== false ) {
-			s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName;
-		}
-
-		// Use data converter to retrieve json after script execution
-		s.converters["script json"] = function() {
-			if ( !responseContainer ) {
-				jQuery.error( callbackName + " was not called" );
-			}
-			return responseContainer[ 0 ];
-		};
-
-		// force json dataType
-		s.dataTypes[ 0 ] = "json";
-
-		// Install callback
-		overwritten = window[ callbackName ];
-		window[ callbackName ] = function() {
-			responseContainer = arguments;
-		};
-
-		// Clean-up function (fires after converters)
-		jqXHR.always(function() {
-			// Restore preexisting value
-			window[ callbackName ] = overwritten;
-
-			// Save back as free
-			if ( s[ callbackName ] ) {
-				// make sure that re-using the options doesn't screw things around
-				s.jsonpCallback = originalSettings.jsonpCallback;
-
-				// save the callback name for future use
-				oldCallbacks.push( callbackName );
-			}
-
-			// Call if it was a function and we have a response
-			if ( responseContainer && jQuery.isFunction( overwritten ) ) {
-				overwritten( responseContainer[ 0 ] );
-			}
-
-			responseContainer = overwritten = undefined;
-		});
-
-		// Delegate to script
-		return "script";
-	}
-});
-
-
-
-
-// data: string of html
-// context (optional): If specified, the fragment will be created in this context, defaults to document
-// keepScripts (optional): If true, will include scripts passed in the html string
-jQuery.parseHTML = function( data, context, keepScripts ) {
-	if ( !data || typeof data !== "string" ) {
-		return null;
-	}
-	if ( typeof context === "boolean" ) {
-		keepScripts = context;
-		context = false;
-	}
-	context = context || document;
-
-	var parsed = rsingleTag.exec( data ),
-		scripts = !keepScripts && [];
-
-	// Single tag
-	if ( parsed ) {
-		return [ context.createElement( parsed[1] ) ];
-	}
-
-	parsed = jQuery.buildFragment( [ data ], context, scripts );
-
-	if ( scripts && scripts.length ) {
-		jQuery( scripts ).remove();
-	}
-
-	return jQuery.merge( [], parsed.childNodes );
-};
-
-
-// Keep a copy of the old load method
-var _load = jQuery.fn.load;
-
-/**
- * Load a url into a page
- */
-jQuery.fn.load = function( url, params, callback ) {
-	if ( typeof url !== "string" && _load ) {
-		return _load.apply( this, arguments );
-	}
-
-	var selector, response, type,
-		self = this,
-		off = url.indexOf(" ");
-
-	if ( off >= 0 ) {
-		selector = jQuery.trim( url.slice( off, url.length ) );
-		url = url.slice( 0, off );
-	}
-
-	// If it's a function
-	if ( jQuery.isFunction( params ) ) {
-
-		// We assume that it's the callback
-		callback = params;
-		params = undefined;
-
-	// Otherwise, build a param string
-	} else if ( params && typeof params === "object" ) {
-		type = "POST";
-	}
-
-	// If we have elements to modify, make the request
-	if ( self.length > 0 ) {
-		jQuery.ajax({
-			url: url,
-
-			// if "type" variable is undefined, then "GET" method will be used
-			type: type,
-			dataType: "html",
-			data: params
-		}).done(function( responseText ) {
-
-			// Save response for use in complete callback
-			response = arguments;
-
-			self.html( selector ?
-
-				// If a selector was specified, locate the right elements in a dummy div
-				// Exclude scripts to avoid IE 'Permission Denied' errors
-				jQuery("<div>").append( jQuery.parseHTML( responseText ) ).find( selector ) :
-
-				// Otherwise use the full result
-				responseText );
-
-		}).complete( callback && function( jqXHR, status ) {
-			self.each( callback, response || [ jqXHR.responseText, status, jqXHR ] );
-		});
-	}
-
-	return this;
-};
-
-
-
-
-jQuery.expr.filters.animated = function( elem ) {
-	return jQuery.grep(jQuery.timers, function( fn ) {
-		return elem === fn.elem;
-	}).length;
-};
-
-
-
-
-
-var docElem = window.document.documentElement;
-
-/**
- * Gets a window from an element
- */
-function getWindow( elem ) {
-	return jQuery.isWindow( elem ) ?
-		elem :
-		elem.nodeType === 9 ?
-			elem.defaultView || elem.parentWindow :
-			false;
-}
-
-jQuery.offset = {
-	setOffset: function( elem, options, i ) {
-		var curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition,
-			position = jQuery.css( elem, "position" ),
-			curElem = jQuery( elem ),
-			props = {};
-
-		// set position first, in-case top/left are set even on static elem
-		if ( position === "static" ) {
-			elem.style.position = "relative";
-		}
-
-		curOffset = curElem.offset();
-		curCSSTop = jQuery.css( elem, "top" );
-		curCSSLeft = jQuery.css( elem, "left" );
-		calculatePosition = ( position === "absolute" || position === "fixed" ) &&
-			jQuery.inArray("auto", [ curCSSTop, curCSSLeft ] ) > -1;
-
-		// need to be able to calculate position if either top or left is auto and position is either absolute or fixed
-		if ( calculatePosition ) {
-			curPosition = curElem.position();
-			curTop = curPosition.top;
-			curLeft = curPosition.left;
-		} else {
-			curTop = parseFloat( curCSSTop ) || 0;
-			curLeft = parseFloat( curCSSLeft ) || 0;
-		}
-
-		if ( jQuery.isFunction( options ) ) {
-			options = options.call( elem, i, curOffset );
-		}
-
-		if ( options.top != null ) {
-			props.top = ( options.top - curOffset.top ) + curTop;
-		}
-		if ( options.left != null ) {
-			props.left = ( options.left - curOffset.left ) + curLeft;
-		}
-
-		if ( "using" in options ) {
-			options.using.call( elem, props );
-		} else {
-			curElem.css( props );
-		}
-	}
-};
-
-jQuery.fn.extend({
-	offset: function( options ) {
-		if ( arguments.length ) {
-			return options === undefined ?
-				this :
-				this.each(function( i ) {
-					jQuery.offset.setOffset( this, options, i );
-				});
-		}
-
-		var docElem, win,
-			box = { top: 0, left: 0 },
-			elem = this[ 0 ],
-			doc = elem && elem.ownerDocument;
-
-		if ( !doc ) {
-			return;
-		}
-
-		docElem = doc.documentElement;
-
-		// Make sure it's not a disconnected DOM node
-		if ( !jQuery.contains( docElem, elem ) ) {
-			return box;
-		}
-
-		// If we don't have gBCR, just use 0,0 rather than error
-		// BlackBerry 5, iOS 3 (original iPhone)
-		if ( typeof elem.getBoundingClientRect !== strundefined ) {
-			box = elem.getBoundingClientRect();
-		}
-		win = getWindow( doc );
-		return {
-			top: box.top  + ( win.pageYOffset || docElem.scrollTop )  - ( docElem.clientTop  || 0 ),
-			left: box.left + ( win.pageXOffset || docElem.scrollLeft ) - ( docElem.clientLeft || 0 )
-		};
-	},
-
-	position: function() {
-		if ( !this[ 0 ] ) {
-			return;
-		}
-
-		var offsetParent, offset,
-			parentOffset = { top: 0, left: 0 },
-			elem = this[ 0 ];
-
-		// fixed elements are offset from window (parentOffset = {top:0, left: 0}, because it is its only offset parent
-		if ( jQuery.css( elem, "position" ) === "fixed" ) {
-			// we assume that getBoundingClientRect is available when computed position is fixed
-			offset = elem.getBoundingClientRect();
-		} else {
-			// Get *real* offsetParent
-			offsetParent = this.offsetParent();
-
-			// Get correct offsets
-			offset = this.offset();
-			if ( !jQuery.nodeName( offsetParent[ 0 ], "html" ) ) {
-				parentOffset = offsetParent.offset();
-			}
-
-			// Add offsetParent borders
-			parentOffset.top  += jQuery.css( offsetParent[ 0 ], "borderTopWidth", true );
-			parentOffset.left += jQuery.css( offsetParent[ 0 ], "borderLeftWidth", true );
-		}
-
-		// Subtract parent offsets and element margins
-		// note: when an element has margin: auto the offsetLeft and marginLeft
-		// are the same in Safari causing offset.left to incorrectly be 0
-		return {
-			top:  offset.top  - parentOffset.top - jQuery.css( elem, "marginTop", true ),
-			left: offset.left - parentOffset.left - jQuery.css( elem, "marginLeft", true)
-		};
-	},
-
-	offsetParent: function() {
-		return this.map(function() {
-			var offsetParent = this.offsetParent || docElem;
-
-			while ( offsetParent && ( !jQuery.nodeName( offsetParent, "html" ) && jQuery.css( offsetParent, "position" ) === "static" ) ) {
-				offsetParent = offsetParent.offsetParent;
-			}
-			return offsetParent || docElem;
-		});
-	}
-});
-
-// Create scrollLeft and scrollTop methods
-jQuery.each( { scrollLeft: "pageXOffset", scrollTop: "pageYOffset" }, function( method, prop ) {
-	var top = /Y/.test( prop );
-
-	jQuery.fn[ method ] = function( val ) {
-		return access( this, function( elem, method, val ) {
-			var win = getWindow( elem );
-
-			if ( val === undefined ) {
-				return win ? (prop in win) ? win[ prop ] :
-					win.document.documentElement[ method ] :
-					elem[ method ];
-			}
-
-			if ( win ) {
-				win.scrollTo(
-					!top ? val : jQuery( win ).scrollLeft(),
-					top ? val : jQuery( win ).scrollTop()
-				);
-
-			} else {
-				elem[ method ] = val;
-			}
-		}, method, val, arguments.length, null );
-	};
-});
-
-// Add the top/left cssHooks using jQuery.fn.position
-// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084
-// getComputedStyle returns percent when specified for top/left/bottom/right
-// rather than make the css module depend on the offset module, we just check for it here
-jQuery.each( [ "top", "left" ], function( i, prop ) {
-	jQuery.cssHooks[ prop ] = addGetHookIf( support.pixelPosition,
-		function( elem, computed ) {
-			if ( computed ) {
-				computed = curCSS( elem, prop );
-				// if curCSS returns percentage, fallback to offset
-				return rnumnonpx.test( computed ) ?
-					jQuery( elem ).position()[ prop ] + "px" :
-					computed;
-			}
-		}
-	);
-});
-
-
-// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods
-jQuery.each( { Height: "height", Width: "width" }, function( name, type ) {
-	jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name }, function( defaultExtra, funcName ) {
-		// margin is only for outerHeight, outerWidth
-		jQuery.fn[ funcName ] = function( margin, value ) {
-			var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ),
-				extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" );
-
-			return access( this, function( elem, type, value ) {
-				var doc;
-
-				if ( jQuery.isWindow( elem ) ) {
-					// As of 5/8/2012 this will yield incorrect results for Mobile Safari, but there
-					// isn't a whole lot we can do. See pull request at this URL for discussion:
-					// https://github.com/jquery/jquery/pull/764
-					return elem.document.documentElement[ "client" + name ];
-				}
-
-				// Get document width or height
-				if ( elem.nodeType === 9 ) {
-					doc = elem.documentElement;
-
-					// Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height], whichever is greatest
-					// unfortunately, this causes bug #3838 in IE6/8 only, but there is currently no good, small way to fix it.
-					return Math.max(
-						elem.body[ "scroll" + name ], doc[ "scroll" + name ],
-						elem.body[ "offset" + name ], doc[ "offset" + name ],
-						doc[ "client" + name ]
-					);
-				}
-
-				return value === undefined ?
-					// Get width or height on the element, requesting but not forcing parseFloat
-					jQuery.css( elem, type, extra ) :
-
-					// Set width or height on the element
-					jQuery.style( elem, type, value, extra );
-			}, type, chainable ? margin : undefined, chainable, null );
-		};
-	});
-});
-
-
-// The number of elements contained in the matched element set
-jQuery.fn.size = function() {
-	return this.length;
-};
-
-jQuery.fn.andSelf = jQuery.fn.addBack;
-
-
-
-
-// Register as a named AMD module, since jQuery can be concatenated with other
-// files that may use define, but not via a proper concatenation script that
-// understands anonymous AMD modules. A named AMD is safest and most robust
-// way to register. Lowercase jquery is used because AMD module names are
-// derived from file names, and jQuery is normally delivered in a lowercase
-// file name. Do this after creating the global so that if an AMD module wants
-// to call noConflict to hide this version of jQuery, it will work.
-
-// Note that for maximum portability, libraries that are not jQuery should
-// declare themselves as anonymous modules, and avoid setting a global if an
-// AMD loader is present. jQuery is a special case. For more information, see
-// https://github.com/jrburke/requirejs/wiki/Updating-existing-libraries#wiki-anon
-
-if ( typeof define === "function" && define.amd ) {
-	define( "jquery", [], function() {
-		return jQuery;
-	});
-}
-
-
-
-
-var
-	// Map over jQuery in case of overwrite
-	_jQuery = window.jQuery,
-
-	// Map over the $ in case of overwrite
-	_$ = window.$;
-
-jQuery.noConflict = function( deep ) {
-	if ( window.$ === jQuery ) {
-		window.$ = _$;
-	}
-
-	if ( deep && window.jQuery === jQuery ) {
-		window.jQuery = _jQuery;
-	}
-
-	return jQuery;
-};
-
-// Expose jQuery and $ identifiers, even in
-// AMD (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
-// and CommonJS for browser emulators (#13566)
-if ( typeof noGlobal === strundefined ) {
-	window.jQuery = window.$ = jQuery;
-}
-
-
-
-
-return jQuery;
-
-}));

docs/_build/html/_static/pygments.css

@@ -1,65 +0,0 @@
-.highlight .hll { background-color: #ffffcc }
-.highlight  { background: #eeffcc; }
-.highlight .c { color: #408090; font-style: italic } /* Comment */
-.highlight .err { border: 1px solid #FF0000 } /* Error */
-.highlight .k { color: #007020; font-weight: bold } /* Keyword */
-.highlight .o { color: #666666 } /* Operator */
-.highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */
-.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
-.highlight .cp { color: #007020 } /* Comment.Preproc */
-.highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */
-.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
-.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
-.highlight .gd { color: #A00000 } /* Generic.Deleted */
-.highlight .ge { font-style: italic } /* Generic.Emph */
-.highlight .gr { color: #FF0000 } /* Generic.Error */
-.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
-.highlight .gi { color: #00A000 } /* Generic.Inserted */
-.highlight .go { color: #333333 } /* Generic.Output */
-.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
-.highlight .gs { font-weight: bold } /* Generic.Strong */
-.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
-.highlight .gt { color: #0044DD } /* Generic.Traceback */
-.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
-.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
-.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
-.highlight .kp { color: #007020 } /* Keyword.Pseudo */
-.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
-.highlight .kt { color: #902000 } /* Keyword.Type */
-.highlight .m { color: #208050 } /* Literal.Number */
-.highlight .s { color: #4070a0 } /* Literal.String */
-.highlight .na { color: #4070a0 } /* Name.Attribute */
-.highlight .nb { color: #007020 } /* Name.Builtin */
-.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
-.highlight .no { color: #60add5 } /* Name.Constant */
-.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
-.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
-.highlight .ne { color: #007020 } /* Name.Exception */
-.highlight .nf { color: #06287e } /* Name.Function */
-.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
-.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
-.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
-.highlight .nv { color: #bb60d5 } /* Name.Variable */
-.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
-.highlight .w { color: #bbbbbb } /* Text.Whitespace */
-.highlight .mb { color: #208050 } /* Literal.Number.Bin */
-.highlight .mf { color: #208050 } /* Literal.Number.Float */
-.highlight .mh { color: #208050 } /* Literal.Number.Hex */
-.highlight .mi { color: #208050 } /* Literal.Number.Integer */
-.highlight .mo { color: #208050 } /* Literal.Number.Oct */
-.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
-.highlight .sc { color: #4070a0 } /* Literal.String.Char */
-.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
-.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
-.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
-.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
-.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
-.highlight .sx { color: #c65d09 } /* Literal.String.Other */
-.highlight .sr { color: #235388 } /* Literal.String.Regex */
-.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
-.highlight .ss { color: #517918 } /* Literal.String.Symbol */
-.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
-.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
-.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
-.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
-.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */

docs/_build/html/_static/searchtools.js

@@ -1,651 +0,0 @@
-/*
- * searchtools.js_t
- * ~~~~~~~~~~~~~~~~
- *
- * Sphinx JavaScript utilities for the full-text search.
- *
- * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-
-/* Non-minified version JS is _stemmer.js if file is provided */ 
-/**
- * Porter Stemmer
- */
-var Stemmer = function() {
-
-  var step2list = {
-    ational: 'ate',
-    tional: 'tion',
-    enci: 'ence',
-    anci: 'ance',
-    izer: 'ize',
-    bli: 'ble',
-    alli: 'al',
-    entli: 'ent',
-    eli: 'e',
-    ousli: 'ous',
-    ization: 'ize',
-    ation: 'ate',
-    ator: 'ate',
-    alism: 'al',
-    iveness: 'ive',
-    fulness: 'ful',
-    ousness: 'ous',
-    aliti: 'al',
-    iviti: 'ive',
-    biliti: 'ble',
-    logi: 'log'
-  };
-
-  var step3list = {
-    icate: 'ic',
-    ative: '',
-    alize: 'al',
-    iciti: 'ic',
-    ical: 'ic',
-    ful: '',
-    ness: ''
-  };
-
-  var c = "[^aeiou]";          // consonant
-  var v = "[aeiouy]";          // vowel
-  var C = c + "[^aeiouy]*";    // consonant sequence
-  var V = v + "[aeiou]*";      // vowel sequence
-
-  var mgr0 = "^(" + C + ")?" + V + C;                      // [C]VC... is m>0
-  var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$";    // [C]VC[V] is m=1
-  var mgr1 = "^(" + C + ")?" + V + C + V + C;              // [C]VCVC... is m>1
-  var s_v   = "^(" + C + ")?" + v;                         // vowel in stem
-
-  this.stemWord = function (w) {
-    var stem;
-    var suffix;
-    var firstch;
-    var origword = w;
-
-    if (w.length < 3)
-      return w;
-
-    var re;
-    var re2;
-    var re3;
-    var re4;
-
-    firstch = w.substr(0,1);
-    if (firstch == "y")
-      w = firstch.toUpperCase() + w.substr(1);
-
-    // Step 1a
-    re = /^(.+?)(ss|i)es$/;
-    re2 = /^(.+?)([^s])s$/;
-
-    if (re.test(w))
-      w = w.replace(re,"$1$2");
-    else if (re2.test(w))
-      w = w.replace(re2,"$1$2");
-
-    // Step 1b
-    re = /^(.+?)eed$/;
-    re2 = /^(.+?)(ed|ing)$/;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      re = new RegExp(mgr0);
-      if (re.test(fp[1])) {
-        re = /.$/;
-        w = w.replace(re,"");
-      }
-    }
-    else if (re2.test(w)) {
-      var fp = re2.exec(w);
-      stem = fp[1];
-      re2 = new RegExp(s_v);
-      if (re2.test(stem)) {
-        w = stem;
-        re2 = /(at|bl|iz)$/;
-        re3 = new RegExp("([^aeiouylsz])\\1$");
-        re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
-        if (re2.test(w))
-          w = w + "e";
-        else if (re3.test(w)) {
-          re = /.$/;
-          w = w.replace(re,"");
-        }
-        else if (re4.test(w))
-          w = w + "e";
-      }
-    }
-
-    // Step 1c
-    re = /^(.+?)y$/;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      re = new RegExp(s_v);
-      if (re.test(stem))
-        w = stem + "i";
-    }
-
-    // Step 2
-    re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      suffix = fp[2];
-      re = new RegExp(mgr0);
-      if (re.test(stem))
-        w = stem + step2list[suffix];
-    }
-
-    // Step 3
-    re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      suffix = fp[2];
-      re = new RegExp(mgr0);
-      if (re.test(stem))
-        w = stem + step3list[suffix];
-    }
-
-    // Step 4
-    re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
-    re2 = /^(.+?)(s|t)(ion)$/;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      re = new RegExp(mgr1);
-      if (re.test(stem))
-        w = stem;
-    }
-    else if (re2.test(w)) {
-      var fp = re2.exec(w);
-      stem = fp[1] + fp[2];
-      re2 = new RegExp(mgr1);
-      if (re2.test(stem))
-        w = stem;
-    }
-
-    // Step 5
-    re = /^(.+?)e$/;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      re = new RegExp(mgr1);
-      re2 = new RegExp(meq1);
-      re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
-      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
-        w = stem;
-    }
-    re = /ll$/;
-    re2 = new RegExp(mgr1);
-    if (re.test(w) && re2.test(w)) {
-      re = /.$/;
-      w = w.replace(re,"");
-    }
-
-    // and turn initial Y back to y
-    if (firstch == "y")
-      w = firstch.toLowerCase() + w.substr(1);
-    return w;
-  }
-}
-
-
-
-/**
- * Simple result scoring code.
- */
-var Scorer = {
-  // Implement the following function to further tweak the score for each result
-  // The function takes a result array [filename, title, anchor, descr, score]
-  // and returns the new score.
-  /*
-  score: function(result) {
-    return result[4];
-  },
-  */
-
-  // query matches the full name of an object
-  objNameMatch: 11,
-  // or matches in the last dotted part of the object name
-  objPartialMatch: 6,
-  // Additive scores depending on the priority of the object
-  objPrio: {0:  15,   // used to be importantResults
-            1:  5,   // used to be objectResults
-            2: -5},  // used to be unimportantResults
-  //  Used when the priority is not in the mapping.
-  objPrioDefault: 0,
-
-  // query found in title
-  title: 15,
-  // query found in terms
-  term: 5
-};
-
-
-/**
- * Search Module
- */
-var Search = {
-
-  _index : null,
-  _queued_query : null,
-  _pulse_status : -1,
-
-  init : function() {
-      var params = $.getQueryParameters();
-      if (params.q) {
-          var query = params.q[0];
-          $('input[name="q"]')[0].value = query;
-          this.performSearch(query);
-      }
-  },
-
-  loadIndex : function(url) {
-    $.ajax({type: "GET", url: url, data: null,
-            dataType: "script", cache: true,
-            complete: function(jqxhr, textstatus) {
-              if (textstatus != "success") {
-                document.getElementById("searchindexloader").src = url;
-              }
-            }});
-  },
-
-  setIndex : function(index) {
-    var q;
-    this._index = index;
-    if ((q = this._queued_query) !== null) {
-      this._queued_query = null;
-      Search.query(q);
-    }
-  },
-
-  hasIndex : function() {
-      return this._index !== null;
-  },
-
-  deferQuery : function(query) {
-      this._queued_query = query;
-  },
-
-  stopPulse : function() {
-      this._pulse_status = 0;
-  },
-
-  startPulse : function() {
-    if (this._pulse_status >= 0)
-        return;
-    function pulse() {
-      var i;
-      Search._pulse_status = (Search._pulse_status + 1) % 4;
-      var dotString = '';
-      for (i = 0; i < Search._pulse_status; i++)
-        dotString += '.';
-      Search.dots.text(dotString);
-      if (Search._pulse_status > -1)
-        window.setTimeout(pulse, 500);
-    }
-    pulse();
-  },
-
-  /**
-   * perform a search for something (or wait until index is loaded)
-   */
-  performSearch : function(query) {
-    // create the required interface elements
-    this.out = $('#search-results');
-    this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);
-    this.dots = $('<span></span>').appendTo(this.title);
-    this.status = $('<p style="display: none"></p>').appendTo(this.out);
-    this.output = $('<ul class="search"/>').appendTo(this.out);
-
-    $('#search-progress').text(_('Preparing search...'));
-    this.startPulse();
-
-    // index already loaded, the browser was quick!
-    if (this.hasIndex())
-      this.query(query);
-    else
-      this.deferQuery(query);
-  },
-
-  /**
-   * execute search (requires search index to be loaded)
-   */
-  query : function(query) {
-    var i;
-    var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
-
-    // stem the searchterms and add them to the correct list
-    var stemmer = new Stemmer();
-    var searchterms = [];
-    var excluded = [];
-    var hlterms = [];
-    var tmp = query.split(/\W+/);
-    var objectterms = [];
-    for (i = 0; i < tmp.length; i++) {
-      if (tmp[i] !== "") {
-          objectterms.push(tmp[i].toLowerCase());
-      }
-
-      if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i].match(/^\d+$/) ||
-          tmp[i] === "") {
-        // skip this "word"
-        continue;
-      }
-      // stem the word
-      var word = stemmer.stemWord(tmp[i].toLowerCase());
-      var toAppend;
-      // select the correct list
-      if (word[0] == '-') {
-        toAppend = excluded;
-        word = word.substr(1);
-      }
-      else {
-        toAppend = searchterms;
-        hlterms.push(tmp[i].toLowerCase());
-      }
-      // only add if not already in the list
-      if (!$u.contains(toAppend, word))
-        toAppend.push(word);
-    }
-    var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
-
-    // console.debug('SEARCH: searching for:');
-    // console.info('required: ', searchterms);
-    // console.info('excluded: ', excluded);
-
-    // prepare search
-    var terms = this._index.terms;
-    var titleterms = this._index.titleterms;
-
-    // array of [filename, title, anchor, descr, score]
-    var results = [];
-    $('#search-progress').empty();
-
-    // lookup as object
-    for (i = 0; i < objectterms.length; i++) {
-      var others = [].concat(objectterms.slice(0, i),
-                             objectterms.slice(i+1, objectterms.length));
-      results = results.concat(this.performObjectSearch(objectterms[i], others));
-    }
-
-    // lookup as search terms in fulltext
-    results = results.concat(this.performTermsSearch(searchterms, excluded, terms, titleterms));
-
-    // let the scorer override scores with a custom scoring function
-    if (Scorer.score) {
-      for (i = 0; i < results.length; i++)
-        results[i][4] = Scorer.score(results[i]);
-    }
-
-    // now sort the results by score (in opposite order of appearance, since the
-    // display function below uses pop() to retrieve items) and then
-    // alphabetically
-    results.sort(function(a, b) {
-      var left = a[4];
-      var right = b[4];
-      if (left > right) {
-        return 1;
-      } else if (left < right) {
-        return -1;
-      } else {
-        // same score: sort alphabetically
-        left = a[1].toLowerCase();
-        right = b[1].toLowerCase();
-        return (left > right) ? -1 : ((left < right) ? 1 : 0);
-      }
-    });
-
-    // for debugging
-    //Search.lastresults = results.slice();  // a copy
-    //console.info('search results:', Search.lastresults);
-
-    // print the results
-    var resultCount = results.length;
-    function displayNextItem() {
-      // results left, load the summary and display it
-      if (results.length) {
-        var item = results.pop();
-        var listItem = $('<li style="display:none"></li>');
-        if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') {
-          // dirhtml builder
-          var dirname = item[0] + '/';
-          if (dirname.match(/\/index\/$/)) {
-            dirname = dirname.substring(0, dirname.length-6);
-          } else if (dirname == 'index/') {
-            dirname = '';
-          }
-          listItem.append($('<a/>').attr('href',
-            DOCUMENTATION_OPTIONS.URL_ROOT + dirname +
-            highlightstring + item[2]).html(item[1]));
-        } else {
-          // normal html builders
-          listItem.append($('<a/>').attr('href',
-            item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX +
-            highlightstring + item[2]).html(item[1]));
-        }
-        if (item[3]) {
-          listItem.append($('<span> (' + item[3] + ')</span>'));
-          Search.output.append(listItem);
-          listItem.slideDown(5, function() {
-            displayNextItem();
-          });
-        } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
-          $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + item[0] + '.txt',
-                  dataType: "text",
-                  complete: function(jqxhr, textstatus) {
-                    var data = jqxhr.responseText;
-                    if (data !== '' && data !== undefined) {
-                      listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));
-                    }
-                    Search.output.append(listItem);
-                    listItem.slideDown(5, function() {
-                      displayNextItem();
-                    });
-                  }});
-        } else {
-          // no source available, just display title
-          Search.output.append(listItem);
-          listItem.slideDown(5, function() {
-            displayNextItem();
-          });
-        }
-      }
-      // search finished, update title and status message
-      else {
-        Search.stopPulse();
-        Search.title.text(_('Search Results'));
-        if (!resultCount)
-          Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.'));
-        else
-            Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));
-        Search.status.fadeIn(500);
-      }
-    }
-    displayNextItem();
-  },
-
-  /**
-   * search for object names
-   */
-  performObjectSearch : function(object, otherterms) {
-    var filenames = this._index.filenames;
-    var objects = this._index.objects;
-    var objnames = this._index.objnames;
-    var titles = this._index.titles;
-
-    var i;
-    var results = [];
-
-    for (var prefix in objects) {
-      for (var name in objects[prefix]) {
-        var fullname = (prefix ? prefix + '.' : '') + name;
-        if (fullname.toLowerCase().indexOf(object) > -1) {
-          var score = 0;
-          var parts = fullname.split('.');
-          // check for different match types: exact matches of full name or
-          // "last name" (i.e. last dotted part)
-          if (fullname == object || parts[parts.length - 1] == object) {
-            score += Scorer.objNameMatch;
-          // matches in last name
-          } else if (parts[parts.length - 1].indexOf(object) > -1) {
-            score += Scorer.objPartialMatch;
-          }
-          var match = objects[prefix][name];
-          var objname = objnames[match[1]][2];
-          var title = titles[match[0]];
-          // If more than one term searched for, we require other words to be
-          // found in the name/title/description
-          if (otherterms.length > 0) {
-            var haystack = (prefix + ' ' + name + ' ' +
-                            objname + ' ' + title).toLowerCase();
-            var allfound = true;
-            for (i = 0; i < otherterms.length; i++) {
-              if (haystack.indexOf(otherterms[i]) == -1) {
-                allfound = false;
-                break;
-              }
-            }
-            if (!allfound) {
-              continue;
-            }
-          }
-          var descr = objname + _(', in ') + title;
-
-          var anchor = match[3];
-          if (anchor === '')
-            anchor = fullname;
-          else if (anchor == '-')
-            anchor = objnames[match[1]][1] + '-' + fullname;
-          // add custom score for some objects according to scorer
-          if (Scorer.objPrio.hasOwnProperty(match[2])) {
-            score += Scorer.objPrio[match[2]];
-          } else {
-            score += Scorer.objPrioDefault;
-          }
-          results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]);
-        }
-      }
-    }
-
-    return results;
-  },
-
-  /**
-   * search for full-text terms in the index
-   */
-  performTermsSearch : function(searchterms, excluded, terms, titleterms) {
-    var filenames = this._index.filenames;
-    var titles = this._index.titles;
-
-    var i, j, file;
-    var fileMap = {};
-    var scoreMap = {};
-    var results = [];
-
-    // perform the search on the required terms
-    for (i = 0; i < searchterms.length; i++) {
-      var word = searchterms[i];
-      var files = [];
-      var _o = [
-        {files: terms[word], score: Scorer.term},
-        {files: titleterms[word], score: Scorer.title}
-      ];
-
-      // no match but word was a required one
-      if ($u.every(_o, function(o){return o.files === undefined;})) {
-        break;
-      }
-      // found search word in contents
-      $u.each(_o, function(o) {
-        var _files = o.files;
-        if (_files === undefined)
-          return
-
-        if (_files.length === undefined)
-          _files = [_files];
-        files = files.concat(_files);
-
-        // set score for the word in each file to Scorer.term
-        for (j = 0; j < _files.length; j++) {
-          file = _files[j];
-          if (!(file in scoreMap))
-            scoreMap[file] = {}
-          scoreMap[file][word] = o.score;
-        }
-      });
-
-      // create the mapping
-      for (j = 0; j < files.length; j++) {
-        file = files[j];
-        if (file in fileMap)
-          fileMap[file].push(word);
-        else
-          fileMap[file] = [word];
-      }
-    }
-
-    // now check if the files don't contain excluded terms
-    for (file in fileMap) {
-      var valid = true;
-
-      // check if all requirements are matched
-      if (fileMap[file].length != searchterms.length)
-          continue;
-
-      // ensure that none of the excluded terms is in the search result
-      for (i = 0; i < excluded.length; i++) {
-        if (terms[excluded[i]] == file ||
-            titleterms[excluded[i]] == file ||
-            $u.contains(terms[excluded[i]] || [], file) ||
-            $u.contains(titleterms[excluded[i]] || [], file)) {
-          valid = false;
-          break;
-        }
-      }
-
-      // if we have still a valid result we can add it to the result list
-      if (valid) {
-        // select one (max) score for the file.
-        // for better ranking, we should calculate ranking by using words statistics like basic tf-idf...
-        var score = $u.max($u.map(fileMap[file], function(w){return scoreMap[file][w]}));
-        results.push([filenames[file], titles[file], '', null, score]);
-      }
-    }
-    return results;
-  },
-
-  /**
-   * helper function to return a node containing the
-   * search summary for a given text. keywords is a list
-   * of stemmed words, hlwords is the list of normal, unstemmed
-   * words. the first one is used to find the occurrence, the
-   * latter for highlighting it.
-   */
-  makeSearchSummary : function(text, keywords, hlwords) {
-    var textLower = text.toLowerCase();
-    var start = 0;
-    $.each(keywords, function() {
-      var i = textLower.indexOf(this.toLowerCase());
-      if (i > -1)
-        start = i;
-    });
-    start = Math.max(start - 120, 0);
-    var excerpt = ((start > 0) ? '...' : '') +
-      $.trim(text.substr(start, 240)) +
-      ((start + 240 - text.length) ? '...' : '');
-    var rv = $('<div class="context"></div>').text(excerpt);
-    $.each(hlwords, function() {
-      rv = rv.highlightText(this, 'highlighted');
-    });
-    return rv;
-  }
-};
-
-$(document).ready(function() {
-  Search.init();
-});

docs/_build/html/_static/underscore-1.3.1.js

@@ -1,999 +0,0 @@
-//     Underscore.js 1.3.1
-//     (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
-//     Underscore is freely distributable under the MIT license.
-//     Portions of Underscore are inspired or borrowed from Prototype,
-//     Oliver Steele's Functional, and John Resig's Micro-Templating.
-//     For all details and documentation:
-//     http://documentcloud.github.com/underscore
-
-(function() {
-
-  // Baseline setup
-  // --------------
-
-  // Establish the root object, `window` in the browser, or `global` on the server.
-  var root = this;
-
-  // Save the previous value of the `_` variable.
-  var previousUnderscore = root._;
-
-  // Establish the object that gets returned to break out of a loop iteration.
-  var breaker = {};
-
-  // Save bytes in the minified (but not gzipped) version:
-  var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype;
-
-  // Create quick reference variables for speed access to core prototypes.
-  var slice            = ArrayProto.slice,
-      unshift          = ArrayProto.unshift,
-      toString         = ObjProto.toString,
-      hasOwnProperty   = ObjProto.hasOwnProperty;
-
-  // All **ECMAScript 5** native function implementations that we hope to use
-  // are declared here.
-  var
-    nativeForEach      = ArrayProto.forEach,
-    nativeMap          = ArrayProto.map,
-    nativeReduce       = ArrayProto.reduce,
-    nativeReduceRight  = ArrayProto.reduceRight,
-    nativeFilter       = ArrayProto.filter,
-    nativeEvery        = ArrayProto.every,
-    nativeSome         = ArrayProto.some,
-    nativeIndexOf      = ArrayProto.indexOf,
-    nativeLastIndexOf  = ArrayProto.lastIndexOf,
-    nativeIsArray      = Array.isArray,
-    nativeKeys         = Object.keys,
-    nativeBind         = FuncProto.bind;
-
-  // Create a safe reference to the Underscore object for use below.
-  var _ = function(obj) { return new wrapper(obj); };
-
-  // Export the Underscore object for **Node.js**, with
-  // backwards-compatibility for the old `require()` API. If we're in
-  // the browser, add `_` as a global object via a string identifier,
-  // for Closure Compiler "advanced" mode.
-  if (typeof exports !== 'undefined') {
-    if (typeof module !== 'undefined' && module.exports) {
-      exports = module.exports = _;
-    }
-    exports._ = _;
-  } else {
-    root['_'] = _;
-  }
-
-  // Current version.
-  _.VERSION = '1.3.1';
-
-  // Collection Functions
-  // --------------------
-
-  // The cornerstone, an `each` implementation, aka `forEach`.
-  // Handles objects with the built-in `forEach`, arrays, and raw objects.
-  // Delegates to **ECMAScript 5**'s native `forEach` if available.
-  var each = _.each = _.forEach = function(obj, iterator, context) {
-    if (obj == null) return;
-    if (nativeForEach && obj.forEach === nativeForEach) {
-      obj.forEach(iterator, context);
-    } else if (obj.length === +obj.length) {
-      for (var i = 0, l = obj.length; i < l; i++) {
-        if (i in obj && iterator.call(context, obj[i], i, obj) === breaker) return;
-      }
-    } else {
-      for (var key in obj) {
-        if (_.has(obj, key)) {
-          if (iterator.call(context, obj[key], key, obj) === breaker) return;
-        }
-      }
-    }
-  };
-
-  // Return the results of applying the iterator to each element.
-  // Delegates to **ECMAScript 5**'s native `map` if available.
-  _.map = _.collect = function(obj, iterator, context) {
-    var results = [];
-    if (obj == null) return results;
-    if (nativeMap && obj.map === nativeMap) return obj.map(iterator, context);
-    each(obj, function(value, index, list) {
-      results[results.length] = iterator.call(context, value, index, list);
-    });
-    if (obj.length === +obj.length) results.length = obj.length;
-    return results;
-  };
-
-  // **Reduce** builds up a single result from a list of values, aka `inject`,
-  // or `foldl`. Delegates to **ECMAScript 5**'s native `reduce` if available.
-  _.reduce = _.foldl = _.inject = function(obj, iterator, memo, context) {
-    var initial = arguments.length > 2;
-    if (obj == null) obj = [];
-    if (nativeReduce && obj.reduce === nativeReduce) {
-      if (context) iterator = _.bind(iterator, context);
-      return initial ? obj.reduce(iterator, memo) : obj.reduce(iterator);
-    }
-    each(obj, function(value, index, list) {
-      if (!initial) {
-        memo = value;
-        initial = true;
-      } else {
-        memo = iterator.call(context, memo, value, index, list);
-      }
-    });
-    if (!initial) throw new TypeError('Reduce of empty array with no initial value');
-    return memo;
-  };
-
-  // The right-associative version of reduce, also known as `foldr`.
-  // Delegates to **ECMAScript 5**'s native `reduceRight` if available.
-  _.reduceRight = _.foldr = function(obj, iterator, memo, context) {
-    var initial = arguments.length > 2;
-    if (obj == null) obj = [];
-    if (nativeReduceRight && obj.reduceRight === nativeReduceRight) {
-      if (context) iterator = _.bind(iterator, context);
-      return initial ? obj.reduceRight(iterator, memo) : obj.reduceRight(iterator);
-    }
-    var reversed = _.toArray(obj).reverse();
-    if (context && !initial) iterator = _.bind(iterator, context);
-    return initial ? _.reduce(reversed, iterator, memo, context) : _.reduce(reversed, iterator);
-  };
-
-  // Return the first value which passes a truth test. Aliased as `detect`.
-  _.find = _.detect = function(obj, iterator, context) {
-    var result;
-    any(obj, function(value, index, list) {
-      if (iterator.call(context, value, index, list)) {
-        result = value;
-        return true;
-      }
-    });
-    return result;
-  };
-
-  // Return all the elements that pass a truth test.
-  // Delegates to **ECMAScript 5**'s native `filter` if available.
-  // Aliased as `select`.
-  _.filter = _.select = function(obj, iterator, context) {
-    var results = [];
-    if (obj == null) return results;
-    if (nativeFilter && obj.filter === nativeFilter) return obj.filter(iterator, context);
-    each(obj, function(value, index, list) {
-      if (iterator.call(context, value, index, list)) results[results.length] = value;
-    });
-    return results;
-  };
-
-  // Return all the elements for which a truth test fails.
-  _.reject = function(obj, iterator, context) {
-    var results = [];
-    if (obj == null) return results;
-    each(obj, function(value, index, list) {
-      if (!iterator.call(context, value, index, list)) results[results.length] = value;
-    });
-    return results;
-  };
-
-  // Determine whether all of the elements match a truth test.
-  // Delegates to **ECMAScript 5**'s native `every` if available.
-  // Aliased as `all`.
-  _.every = _.all = function(obj, iterator, context) {
-    var result = true;
-    if (obj == null) return result;
-    if (nativeEvery && obj.every === nativeEvery) return obj.every(iterator, context);
-    each(obj, function(value, index, list) {
-      if (!(result = result && iterator.call(context, value, index, list))) return breaker;
-    });
-    return result;
-  };
-
-  // Determine if at least one element in the object matches a truth test.
-  // Delegates to **ECMAScript 5**'s native `some` if available.
-  // Aliased as `any`.
-  var any = _.some = _.any = function(obj, iterator, context) {
-    iterator || (iterator = _.identity);
-    var result = false;
-    if (obj == null) return result;
-    if (nativeSome && obj.some === nativeSome) return obj.some(iterator, context);
-    each(obj, function(value, index, list) {
-      if (result || (result = iterator.call(context, value, index, list))) return breaker;
-    });
-    return !!result;
-  };
-
-  // Determine if a given value is included in the array or object using `===`.
-  // Aliased as `contains`.
-  _.include = _.contains = function(obj, target) {
-    var found = false;
-    if (obj == null) return found;
-    if (nativeIndexOf && obj.indexOf === nativeIndexOf) return obj.indexOf(target) != -1;
-    found = any(obj, function(value) {
-      return value === target;
-    });
-    return found;
-  };
-
-  // Invoke a method (with arguments) on every item in a collection.
-  _.invoke = function(obj, method) {
-    var args = slice.call(arguments, 2);
-    return _.map(obj, function(value) {
-      return (_.isFunction(method) ? method || value : value[method]).apply(value, args);
-    });
-  };
-
-  // Convenience version of a common use case of `map`: fetching a property.
-  _.pluck = function(obj, key) {
-    return _.map(obj, function(value){ return value[key]; });
-  };
-
-  // Return the maximum element or (element-based computation).
-  _.max = function(obj, iterator, context) {
-    if (!iterator && _.isArray(obj)) return Math.max.apply(Math, obj);
-    if (!iterator && _.isEmpty(obj)) return -Infinity;
-    var result = {computed : -Infinity};
-    each(obj, function(value, index, list) {
-      var computed = iterator ? iterator.call(context, value, index, list) : value;
-      computed >= result.computed && (result = {value : value, computed : computed});
-    });
-    return result.value;
-  };
-
-  // Return the minimum element (or element-based computation).
-  _.min = function(obj, iterator, context) {
-    if (!iterator && _.isArray(obj)) return Math.min.apply(Math, obj);
-    if (!iterator && _.isEmpty(obj)) return Infinity;
-    var result = {computed : Infinity};
-    each(obj, function(value, index, list) {
-      var computed = iterator ? iterator.call(context, value, index, list) : value;
-      computed < result.computed && (result = {value : value, computed : computed});
-    });
-    return result.value;
-  };
-
-  // Shuffle an array.
-  _.shuffle = function(obj) {
-    var shuffled = [], rand;
-    each(obj, function(value, index, list) {
-      if (index == 0) {
-        shuffled[0] = value;
-      } else {
-        rand = Math.floor(Math.random() * (index + 1));
-        shuffled[index] = shuffled[rand];
-        shuffled[rand] = value;
-      }
-    });
-    return shuffled;
-  };
-
-  // Sort the object's values by a criterion produced by an iterator.
-  _.sortBy = function(obj, iterator, context) {
-    return _.pluck(_.map(obj, function(value, index, list) {
-      return {
-        value : value,
-        criteria : iterator.call(context, value, index, list)
-      };
-    }).sort(function(left, right) {
-      var a = left.criteria, b = right.criteria;
-      return a < b ? -1 : a > b ? 1 : 0;
-    }), 'value');
-  };
-
-  // Groups the object's values by a criterion. Pass either a string attribute
-  // to group by, or a function that returns the criterion.
-  _.groupBy = function(obj, val) {
-    var result = {};
-    var iterator = _.isFunction(val) ? val : function(obj) { return obj[val]; };
-    each(obj, function(value, index) {
-      var key = iterator(value, index);
-      (result[key] || (result[key] = [])).push(value);
-    });
-    return result;
-  };
-
-  // Use a comparator function to figure out at what index an object should
-  // be inserted so as to maintain order. Uses binary search.
-  _.sortedIndex = function(array, obj, iterator) {
-    iterator || (iterator = _.identity);
-    var low = 0, high = array.length;
-    while (low < high) {
-      var mid = (low + high) >> 1;
-      iterator(array[mid]) < iterator(obj) ? low = mid + 1 : high = mid;
-    }
-    return low;
-  };
-
-  // Safely convert anything iterable into a real, live array.
-  _.toArray = function(iterable) {
-    if (!iterable)                return [];
-    if (iterable.toArray)         return iterable.toArray();
-    if (_.isArray(iterable))      return slice.call(iterable);
-    if (_.isArguments(iterable))  return slice.call(iterable);
-    return _.values(iterable);
-  };
-
-  // Return the number of elements in an object.
-  _.size = function(obj) {
-    return _.toArray(obj).length;
-  };
-
-  // Array Functions
-  // ---------------
-
-  // Get the first element of an array. Passing **n** will return the first N
-  // values in the array. Aliased as `head`. The **guard** check allows it to work
-  // with `_.map`.
-  _.first = _.head = function(array, n, guard) {
-    return (n != null) && !guard ? slice.call(array, 0, n) : array[0];
-  };
-
-  // Returns everything but the last entry of the array. Especcialy useful on
-  // the arguments object. Passing **n** will return all the values in
-  // the array, excluding the last N. The **guard** check allows it to work with
-  // `_.map`.
-  _.initial = function(array, n, guard) {
-    return slice.call(array, 0, array.length - ((n == null) || guard ? 1 : n));
-  };
-
-  // Get the last element of an array. Passing **n** will return the last N
-  // values in the array. The **guard** check allows it to work with `_.map`.
-  _.last = function(array, n, guard) {
-    if ((n != null) && !guard) {
-      return slice.call(array, Math.max(array.length - n, 0));
-    } else {
-      return array[array.length - 1];
-    }
-  };
-
-  // Returns everything but the first entry of the array. Aliased as `tail`.
-  // Especially useful on the arguments object. Passing an **index** will return
-  // the rest of the values in the array from that index onward. The **guard**
-  // check allows it to work with `_.map`.
-  _.rest = _.tail = function(array, index, guard) {
-    return slice.call(array, (index == null) || guard ? 1 : index);
-  };
-
-  // Trim out all falsy values from an array.
-  _.compact = function(array) {
-    return _.filter(array, function(value){ return !!value; });
-  };
-
-  // Return a completely flattened version of an array.
-  _.flatten = function(array, shallow) {
-    return _.reduce(array, function(memo, value) {
-      if (_.isArray(value)) return memo.concat(shallow ? value : _.flatten(value));
-      memo[memo.length] = value;
-      return memo;
-    }, []);
-  };
-
-  // Return a version of the array that does not contain the specified value(s).
-  _.without = function(array) {
-    return _.difference(array, slice.call(arguments, 1));
-  };
-
-  // Produce a duplicate-free version of the array. If the array has already
-  // been sorted, you have the option of using a faster algorithm.
-  // Aliased as `unique`.
-  _.uniq = _.unique = function(array, isSorted, iterator) {
-    var initial = iterator ? _.map(array, iterator) : array;
-    var result = [];
-    _.reduce(initial, function(memo, el, i) {
-      if (0 == i || (isSorted === true ? _.last(memo) != el : !_.include(memo, el))) {
-        memo[memo.length] = el;
-        result[result.length] = array[i];
-      }
-      return memo;
-    }, []);
-    return result;
-  };
-
-  // Produce an array that contains the union: each distinct element from all of
-  // the passed-in arrays.
-  _.union = function() {
-    return _.uniq(_.flatten(arguments, true));
-  };
-
-  // Produce an array that contains every item shared between all the
-  // passed-in arrays. (Aliased as "intersect" for back-compat.)
-  _.intersection = _.intersect = function(array) {
-    var rest = slice.call(arguments, 1);
-    return _.filter(_.uniq(array), function(item) {
-      return _.every(rest, function(other) {
-        return _.indexOf(other, item) >= 0;
-      });
-    });
-  };
-
-  // Take the difference between one array and a number of other arrays.
-  // Only the elements present in just the first array will remain.
-  _.difference = function(array) {
-    var rest = _.flatten(slice.call(arguments, 1));
-    return _.filter(array, function(value){ return !_.include(rest, value); });
-  };
-
-  // Zip together multiple lists into a single array -- elements that share
-  // an index go together.
-  _.zip = function() {
-    var args = slice.call(arguments);
-    var length = _.max(_.pluck(args, 'length'));
-    var results = new Array(length);
-    for (var i = 0; i < length; i++) results[i] = _.pluck(args, "" + i);
-    return results;
-  };
-
-  // If the browser doesn't supply us with indexOf (I'm looking at you, **MSIE**),
-  // we need this function. Return the position of the first occurrence of an
-  // item in an array, or -1 if the item is not included in the array.
-  // Delegates to **ECMAScript 5**'s native `indexOf` if available.
-  // If the array is large and already in sort order, pass `true`
-  // for **isSorted** to use binary search.
-  _.indexOf = function(array, item, isSorted) {
-    if (array == null) return -1;
-    var i, l;
-    if (isSorted) {
-      i = _.sortedIndex(array, item);
-      return array[i] === item ? i : -1;
-    }
-    if (nativeIndexOf && array.indexOf === nativeIndexOf) return array.indexOf(item);
-    for (i = 0, l = array.length; i < l; i++) if (i in array && array[i] === item) return i;
-    return -1;
-  };
-
-  // Delegates to **ECMAScript 5**'s native `lastIndexOf` if available.
-  _.lastIndexOf = function(array, item) {
-    if (array == null) return -1;
-    if (nativeLastIndexOf && array.lastIndexOf === nativeLastIndexOf) return array.lastIndexOf(item);
-    var i = array.length;
-    while (i--) if (i in array && array[i] === item) return i;
-    return -1;
-  };
-
-  // Generate an integer Array containing an arithmetic progression. A port of
-  // the native Python `range()` function. See
-  // [the Python documentation](http://docs.python.org/library/functions.html#range).
-  _.range = function(start, stop, step) {
-    if (arguments.length <= 1) {
-      stop = start || 0;
-      start = 0;
-    }
-    step = arguments[2] || 1;
-
-    var len = Math.max(Math.ceil((stop - start) / step), 0);
-    var idx = 0;
-    var range = new Array(len);
-
-    while(idx < len) {
-      range[idx++] = start;
-      start += step;
-    }
-
-    return range;
-  };
-
-  // Function (ahem) Functions
-  // ------------------
-
-  // Reusable constructor function for prototype setting.
-  var ctor = function(){};
-
-  // Create a function bound to a given object (assigning `this`, and arguments,
-  // optionally). Binding with arguments is also known as `curry`.
-  // Delegates to **ECMAScript 5**'s native `Function.bind` if available.
-  // We check for `func.bind` first, to fail fast when `func` is undefined.
-  _.bind = function bind(func, context) {
-    var bound, args;
-    if (func.bind === nativeBind && nativeBind) return nativeBind.apply(func, slice.call(arguments, 1));
-    if (!_.isFunction(func)) throw new TypeError;
-    args = slice.call(arguments, 2);
-    return bound = function() {
-      if (!(this instanceof bound)) return func.apply(context, args.concat(slice.call(arguments)));
-      ctor.prototype = func.prototype;
-      var self = new ctor;
-      var result = func.apply(self, args.concat(slice.call(arguments)));
-      if (Object(result) === result) return result;
-      return self;
-    };
-  };
-
-  // Bind all of an object's methods to that object. Useful for ensuring that
-  // all callbacks defined on an object belong to it.
-  _.bindAll = function(obj) {
-    var funcs = slice.call(arguments, 1);
-    if (funcs.length == 0) funcs = _.functions(obj);
-    each(funcs, function(f) { obj[f] = _.bind(obj[f], obj); });
-    return obj;
-  };
-
-  // Memoize an expensive function by storing its results.
-  _.memoize = function(func, hasher) {
-    var memo = {};
-    hasher || (hasher = _.identity);
-    return function() {
-      var key = hasher.apply(this, arguments);
-      return _.has(memo, key) ? memo[key] : (memo[key] = func.apply(this, arguments));
-    };
-  };
-
-  // Delays a function for the given number of milliseconds, and then calls
-  // it with the arguments supplied.
-  _.delay = function(func, wait) {
-    var args = slice.call(arguments, 2);
-    return setTimeout(function(){ return func.apply(func, args); }, wait);
-  };
-
-  // Defers a function, scheduling it to run after the current call stack has
-  // cleared.
-  _.defer = function(func) {
-    return _.delay.apply(_, [func, 1].concat(slice.call(arguments, 1)));
-  };
-
-  // Returns a function, that, when invoked, will only be triggered at most once
-  // during a given window of time.
-  _.throttle = function(func, wait) {
-    var context, args, timeout, throttling, more;
-    var whenDone = _.debounce(function(){ more = throttling = false; }, wait);
-    return function() {
-      context = this; args = arguments;
-      var later = function() {
-        timeout = null;
-        if (more) func.apply(context, args);
-        whenDone();
-      };
-      if (!timeout) timeout = setTimeout(later, wait);
-      if (throttling) {
-        more = true;
-      } else {
-        func.apply(context, args);
-      }
-      whenDone();
-      throttling = true;
-    };
-  };
-
-  // Returns a function, that, as long as it continues to be invoked, will not
-  // be triggered. The function will be called after it stops being called for
-  // N milliseconds.
-  _.debounce = function(func, wait) {
-    var timeout;
-    return function() {
-      var context = this, args = arguments;
-      var later = function() {
-        timeout = null;
-        func.apply(context, args);
-      };
-      clearTimeout(timeout);
-      timeout = setTimeout(later, wait);
-    };
-  };
-
-  // Returns a function that will be executed at most one time, no matter how
-  // often you call it. Useful for lazy initialization.
-  _.once = function(func) {
-    var ran = false, memo;
-    return function() {
-      if (ran) return memo;
-      ran = true;
-      return memo = func.apply(this, arguments);
-    };
-  };
-
-  // Returns the first function passed as an argument to the second,
-  // allowing you to adjust arguments, run code before and after, and
-  // conditionally execute the original function.
-  _.wrap = function(func, wrapper) {
-    return function() {
-      var args = [func].concat(slice.call(arguments, 0));
-      return wrapper.apply(this, args);
-    };
-  };
-
-  // Returns a function that is the composition of a list of functions, each
-  // consuming the return value of the function that follows.
-  _.compose = function() {
-    var funcs = arguments;
-    return function() {
-      var args = arguments;
-      for (var i = funcs.length - 1; i >= 0; i--) {
-        args = [funcs[i].apply(this, args)];
-      }
-      return args[0];
-    };
-  };
-
-  // Returns a function that will only be executed after being called N times.
-  _.after = function(times, func) {
-    if (times <= 0) return func();
-    return function() {
-      if (--times < 1) { return func.apply(this, arguments); }
-    };
-  };
-
-  // Object Functions
-  // ----------------
-
-  // Retrieve the names of an object's properties.
-  // Delegates to **ECMAScript 5**'s native `Object.keys`
-  _.keys = nativeKeys || function(obj) {
-    if (obj !== Object(obj)) throw new TypeError('Invalid object');
-    var keys = [];
-    for (var key in obj) if (_.has(obj, key)) keys[keys.length] = key;
-    return keys;
-  };
-
-  // Retrieve the values of an object's properties.
-  _.values = function(obj) {
-    return _.map(obj, _.identity);
-  };
-
-  // Return a sorted list of the function names available on the object.
-  // Aliased as `methods`
-  _.functions = _.methods = function(obj) {
-    var names = [];
-    for (var key in obj) {
-      if (_.isFunction(obj[key])) names.push(key);
-    }
-    return names.sort();
-  };
-
-  // Extend a given object with all the properties in passed-in object(s).
-  _.extend = function(obj) {
-    each(slice.call(arguments, 1), function(source) {
-      for (var prop in source) {
-        obj[prop] = source[prop];
-      }
-    });
-    return obj;
-  };
-
-  // Fill in a given object with default properties.
-  _.defaults = function(obj) {
-    each(slice.call(arguments, 1), function(source) {
-      for (var prop in source) {
-        if (obj[prop] == null) obj[prop] = source[prop];
-      }
-    });
-    return obj;
-  };
-
-  // Create a (shallow-cloned) duplicate of an object.
-  _.clone = function(obj) {
-    if (!_.isObject(obj)) return obj;
-    return _.isArray(obj) ? obj.slice() : _.extend({}, obj);
-  };
-
-  // Invokes interceptor with the obj, and then returns obj.
-  // The primary purpose of this method is to "tap into" a method chain, in
-  // order to perform operations on intermediate results within the chain.
-  _.tap = function(obj, interceptor) {
-    interceptor(obj);
-    return obj;
-  };
-
-  // Internal recursive comparison function.
-  function eq(a, b, stack) {
-    // Identical objects are equal. `0 === -0`, but they aren't identical.
-    // See the Harmony `egal` proposal: http://wiki.ecmascript.org/doku.php?id=harmony:egal.
-    if (a === b) return a !== 0 || 1 / a == 1 / b;
-    // A strict comparison is necessary because `null == undefined`.
-    if (a == null || b == null) return a === b;
-    // Unwrap any wrapped objects.
-    if (a._chain) a = a._wrapped;
-    if (b._chain) b = b._wrapped;
-    // Invoke a custom `isEqual` method if one is provided.
-    if (a.isEqual && _.isFunction(a.isEqual)) return a.isEqual(b);
-    if (b.isEqual && _.isFunction(b.isEqual)) return b.isEqual(a);
-    // Compare `[[Class]]` names.
-    var className = toString.call(a);
-    if (className != toString.call(b)) return false;
-    switch (className) {
-      // Strings, numbers, dates, and booleans are compared by value.
-      case '[object String]':
-        // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is
-        // equivalent to `new String("5")`.
-        return a == String(b);
-      case '[object Number]':
-        // `NaN`s are equivalent, but non-reflexive. An `egal` comparison is performed for
-        // other numeric values.
-        return a != +a ? b != +b : (a == 0 ? 1 / a == 1 / b : a == +b);
-      case '[object Date]':
-      case '[object Boolean]':
-        // Coerce dates and booleans to numeric primitive values. Dates are compared by their
-        // millisecond representations. Note that invalid dates with millisecond representations
-        // of `NaN` are not equivalent.
-        return +a == +b;
-      // RegExps are compared by their source patterns and flags.
-      case '[object RegExp]':
-        return a.source == b.source &&
-               a.global == b.global &&
-               a.multiline == b.multiline &&
-               a.ignoreCase == b.ignoreCase;
-    }
-    if (typeof a != 'object' || typeof b != 'object') return false;
-    // Assume equality for cyclic structures. The algorithm for detecting cyclic
-    // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
-    var length = stack.length;
-    while (length--) {
-      // Linear search. Performance is inversely proportional to the number of
-      // unique nested structures.
-      if (stack[length] == a) return true;
-    }
-    // Add the first object to the stack of traversed objects.
-    stack.push(a);
-    var size = 0, result = true;
-    // Recursively compare objects and arrays.
-    if (className == '[object Array]') {
-      // Compare array lengths to determine if a deep comparison is necessary.
-      size = a.length;
-      result = size == b.length;
-      if (result) {
-        // Deep compare the contents, ignoring non-numeric properties.
-        while (size--) {
-          // Ensure commutative equality for sparse arrays.
-          if (!(result = size in a == size in b && eq(a[size], b[size], stack))) break;
-        }
-      }
-    } else {
-      // Objects with different constructors are not equivalent.
-      if ('constructor' in a != 'constructor' in b || a.constructor != b.constructor) return false;
-      // Deep compare objects.
-      for (var key in a) {
-        if (_.has(a, key)) {
-          // Count the expected number of properties.
-          size++;
-          // Deep compare each member.
-          if (!(result = _.has(b, key) && eq(a[key], b[key], stack))) break;
-        }
-      }
-      // Ensure that both objects contain the same number of properties.
-      if (result) {
-        for (key in b) {
-          if (_.has(b, key) && !(size--)) break;
-        }
-        result = !size;
-      }
-    }
-    // Remove the first object from the stack of traversed objects.
-    stack.pop();
-    return result;
-  }
-
-  // Perform a deep comparison to check if two objects are equal.
-  _.isEqual = function(a, b) {
-    return eq(a, b, []);
-  };
-
-  // Is a given array, string, or object empty?
-  // An "empty" object has no enumerable own-properties.
-  _.isEmpty = function(obj) {
-    if (_.isArray(obj) || _.isString(obj)) return obj.length === 0;
-    for (var key in obj) if (_.has(obj, key)) return false;
-    return true;
-  };
-
-  // Is a given value a DOM element?
-  _.isElement = function(obj) {
-    return !!(obj && obj.nodeType == 1);
-  };
-
-  // Is a given value an array?
-  // Delegates to ECMA5's native Array.isArray
-  _.isArray = nativeIsArray || function(obj) {
-    return toString.call(obj) == '[object Array]';
-  };
-
-  // Is a given variable an object?
-  _.isObject = function(obj) {
-    return obj === Object(obj);
-  };
-
-  // Is a given variable an arguments object?
-  _.isArguments = function(obj) {
-    return toString.call(obj) == '[object Arguments]';
-  };
-  if (!_.isArguments(arguments)) {
-    _.isArguments = function(obj) {
-      return !!(obj && _.has(obj, 'callee'));
-    };
-  }
-
-  // Is a given value a function?
-  _.isFunction = function(obj) {
-    return toString.call(obj) == '[object Function]';
-  };
-
-  // Is a given value a string?
-  _.isString = function(obj) {
-    return toString.call(obj) == '[object String]';
-  };
-
-  // Is a given value a number?
-  _.isNumber = function(obj) {
-    return toString.call(obj) == '[object Number]';
-  };
-
-  // Is the given value `NaN`?
-  _.isNaN = function(obj) {
-    // `NaN` is the only value for which `===` is not reflexive.
-    return obj !== obj;
-  };
-
-  // Is a given value a boolean?
-  _.isBoolean = function(obj) {
-    return obj === true || obj === false || toString.call(obj) == '[object Boolean]';
-  };
-
-  // Is a given value a date?
-  _.isDate = function(obj) {
-    return toString.call(obj) == '[object Date]';
-  };
-
-  // Is the given value a regular expression?
-  _.isRegExp = function(obj) {
-    return toString.call(obj) == '[object RegExp]';
-  };
-
-  // Is a given value equal to null?
-  _.isNull = function(obj) {
-    return obj === null;
-  };
-
-  // Is a given variable undefined?
-  _.isUndefined = function(obj) {
-    return obj === void 0;
-  };
-
-  // Has own property?
-  _.has = function(obj, key) {
-    return hasOwnProperty.call(obj, key);
-  };
-
-  // Utility Functions
-  // -----------------
-
-  // Run Underscore.js in *noConflict* mode, returning the `_` variable to its
-  // previous owner. Returns a reference to the Underscore object.
-  _.noConflict = function() {
-    root._ = previousUnderscore;
-    return this;
-  };
-
-  // Keep the identity function around for default iterators.
-  _.identity = function(value) {
-    return value;
-  };
-
-  // Run a function **n** times.
-  _.times = function (n, iterator, context) {
-    for (var i = 0; i < n; i++) iterator.call(context, i);
-  };
-
-  // Escape a string for HTML interpolation.
-  _.escape = function(string) {
-    return (''+string).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#x27;').replace(/\//g,'&#x2F;');
-  };
-
-  // Add your own custom functions to the Underscore object, ensuring that
-  // they're correctly added to the OOP wrapper as well.
-  _.mixin = function(obj) {
-    each(_.functions(obj), function(name){
-      addToWrapper(name, _[name] = obj[name]);
-    });
-  };
-
-  // Generate a unique integer id (unique within the entire client session).
-  // Useful for temporary DOM ids.
-  var idCounter = 0;
-  _.uniqueId = function(prefix) {
-    var id = idCounter++;
-    return prefix ? prefix + id : id;
-  };
-
-  // By default, Underscore uses ERB-style template delimiters, change the
-  // following template settings to use alternative delimiters.
-  _.templateSettings = {
-    evaluate    : /<%([\s\S]+?)%>/g,
-    interpolate : /<%=([\s\S]+?)%>/g,
-    escape      : /<%-([\s\S]+?)%>/g
-  };
-
-  // When customizing `templateSettings`, if you don't want to define an
-  // interpolation, evaluation or escaping regex, we need one that is
-  // guaranteed not to match.
-  var noMatch = /.^/;
-
-  // Within an interpolation, evaluation, or escaping, remove HTML escaping
-  // that had been previously added.
-  var unescape = function(code) {
-    return code.replace(/\\\\/g, '\\').replace(/\\'/g, "'");
-  };
-
-  // JavaScript micro-templating, similar to John Resig's implementation.
-  // Underscore templating handles arbitrary delimiters, preserves whitespace,
-  // and correctly escapes quotes within interpolated code.
-  _.template = function(str, data) {
-    var c  = _.templateSettings;
-    var tmpl = 'var __p=[],print=function(){__p.push.apply(__p,arguments);};' +
-      'with(obj||{}){__p.push(\'' +
-      str.replace(/\\/g, '\\\\')
-         .replace(/'/g, "\\'")
-         .replace(c.escape || noMatch, function(match, code) {
-           return "',_.escape(" + unescape(code) + "),'";
-         })
-         .replace(c.interpolate || noMatch, function(match, code) {
-           return "'," + unescape(code) + ",'";
-         })
-         .replace(c.evaluate || noMatch, function(match, code) {
-           return "');" + unescape(code).replace(/[\r\n\t]/g, ' ') + ";__p.push('";
-         })
-         .replace(/\r/g, '\\r')
-         .replace(/\n/g, '\\n')
-         .replace(/\t/g, '\\t')
-         + "');}return __p.join('');";
-    var func = new Function('obj', '_', tmpl);
-    if (data) return func(data, _);
-    return function(data) {
-      return func.call(this, data, _);
-    };
-  };
-
-  // Add a "chain" function, which will delegate to the wrapper.
-  _.chain = function(obj) {
-    return _(obj).chain();
-  };
-
-  // The OOP Wrapper
-  // ---------------
-
-  // If Underscore is called as a function, it returns a wrapped object that
-  // can be used OO-style. This wrapper holds altered versions of all the
-  // underscore functions. Wrapped objects may be chained.
-  var wrapper = function(obj) { this._wrapped = obj; };
-
-  // Expose `wrapper.prototype` as `_.prototype`
-  _.prototype = wrapper.prototype;
-
-  // Helper function to continue chaining intermediate results.
-  var result = function(obj, chain) {
-    return chain ? _(obj).chain() : obj;
-  };
-
-  // A method to easily add functions to the OOP wrapper.
-  var addToWrapper = function(name, func) {
-    wrapper.prototype[name] = function() {
-      var args = slice.call(arguments);
-      unshift.call(args, this._wrapped);
-      return result(func.apply(_, args), this._chain);
-    };
-  };
-
-  // Add all of the Underscore functions to the wrapper object.
-  _.mixin(_);
-
-  // Add all mutator Array functions to the wrapper.
-  each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) {
-    var method = ArrayProto[name];
-    wrapper.prototype[name] = function() {
-      var wrapped = this._wrapped;
-      method.apply(wrapped, arguments);
-      var length = wrapped.length;
-      if ((name == 'shift' || name == 'splice') && length === 0) delete wrapped[0];
-      return result(wrapped, this._chain);
-    };
-  });
-
-  // Add all accessor Array functions to the wrapper.
-  each(['concat', 'join', 'slice'], function(name) {
-    var method = ArrayProto[name];
-    wrapper.prototype[name] = function() {
-      return result(method.apply(this._wrapped, arguments), this._chain);
-    };
-  });
-
-  // Start chaining a wrapped Underscore object.
-  wrapper.prototype.chain = function() {
-    this._chain = true;
-    return this;
-  };
-
-  // Extracts the result from a wrapped and chained object.
-  wrapper.prototype.value = function() {
-    return this._wrapped;
-  };
-
-}).call(this);

docs/_build/html/_static/underscore.js

@@ -1,31 +0,0 @@
-// Underscore.js 1.3.1
-// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
-// Underscore is freely distributable under the MIT license.
-// Portions of Underscore are inspired or borrowed from Prototype,
-// Oliver Steele's Functional, and John Resig's Micro-Templating.
-// For all details and documentation:
-// http://documentcloud.github.com/underscore
-(function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||c==null)return a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object String]":return a==String(c);case "[object Number]":return a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source==
-c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof a!="object"||typeof c!="object")return false;for(var f=d.length;f--;)if(d[f]==a)return true;d.push(a);var f=0,g=true;if(e=="[object Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return false;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c,
-h)&&!f--)break;g=!f}}d.pop();return g}var r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return new m(a)};if(typeof exports!=="undefined"){if(typeof module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else r._=b;b.VERSION="1.3.1";var j=b.each=
-b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e<f;e++){if(e in a&&c.call(d,a[e],e,a)===n)break}else for(e in a)if(b.has(a,e)&&c.call(d,a[e],e,a)===n)break};b.map=b.collect=function(a,c,b){var e=[];if(a==null)return e;if(x&&a.map===x)return a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.length>2;a==
-null&&(a=[]);if(y&&a.reduce===y)return e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect=
-function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return e=a,true});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(A&&a.filter===A)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g,h){if(!(e=
-e&&c.call(b,a,g,h)))return n});return e};var E=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(C&&a.some===C)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return n});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;return p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck=
-function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&(e={value:a,computed:b})});
-return e.value};b.shuffle=function(a){var b=[],d;j(a,function(a,f){f==0?b[0]=a:(d=Math.floor(Math.random()*(f+1)),b[f]=b[d],b[d]=a)});return b};b.sortBy=function(a,c,d){return b.pluck(b.map(a,function(a,b,g){return{value:a,criteria:c.call(d,a,b,g)}}).sort(function(a,b){var c=a.criteria,d=b.criteria;return c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a,
-c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return e};b.toArray=function(a){return!a?[]:a.toArray?a.toArray():b.isArray(a)?i.call(a):b.isArguments(a)?i.call(a):b.values(a)};b.size=function(a){return b.toArray(a).length};b.first=b.head=function(a,b,d){return b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return i.call(a,0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length-1]};b.rest=
-b.tail=function(a,b,d){return i.call(a,b==null||d?1:b)};b.compact=function(a){return b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return b.reduce(a,function(a,e){if(b.isArray(e))return a.concat(c?e:b.flatten(e));a[a.length]=e;return a},[])};b.without=function(a){return b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var d=d?b.map(a,d):a,e=[];b.reduce(d,function(d,g,h){if(0==h||(c===true?b.last(d)!=g:!b.include(d,g)))d[d.length]=g,e[e.length]=a[h];return d},[]);
-return e};b.union=function(){return b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return b.every(c,function(c){return b.indexOf(c,a)>=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1));return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return d};b.indexOf=function(a,c,
-d){if(a==null)return-1;var e;if(d)return d=b.sortedIndex(a,c),a[d]===c?d:-1;if(p&&a.indexOf===p)return a.indexOf(c);for(d=0,e=a.length;d<e;d++)if(d in a&&a[d]===c)return d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(D&&a.lastIndexOf===D)return a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return d;return-1};b.range=function(a,b,d){arguments.length<=1&&(b=a||0,a=0);for(var d=arguments[2]||1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;)g[f++]=a,a+=d;return g};
-var F=function(){};b.bind=function(a,c){var d,e;if(a.bind===s&&s)return s.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof d))return a.apply(c,e.concat(i.call(arguments)));F.prototype=a.prototype;var b=new F,g=a.apply(b,e.concat(i.call(arguments)));return Object(g)===g?g:b}};b.bindAll=function(a){var c=i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return a};b.memoize=function(a,
-c){var d={};c||(c=b.identity);return function(){var e=c.apply(this,arguments);return b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var d=i.call(arguments,2);return setTimeout(function(){return a.apply(a,d)},b)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var d,e,f,g,h,i=b.debounce(function(){h=g=false},c);return function(){d=this;e=arguments;var b;f||(f=setTimeout(function(){f=null;h&&a.apply(d,e);i()},c));g?h=true:
-a.apply(d,e);i();g=true}};b.debounce=function(a,b){var d;return function(){var e=this,f=arguments;clearTimeout(d);d=setTimeout(function(){d=null;a.apply(e,f)},b)}};b.once=function(a){var b=false,d;return function(){if(b)return d;b=true;return d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var d=[a].concat(i.call(arguments,0));return b.apply(this,d)}};b.compose=function(){var a=arguments;return function(){for(var b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)];return b[0]}};
-b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.defaults=function(a){j(i.call(arguments,
-1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)};
-b.isArguments=function(a){return l.call(a)=="[object Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a||!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object Function]"};b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"};
-b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,b){return I.call(a,b)};b.noConflict=function(){r._=G;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#x27;").replace(/\//g,"&#x2F;")};b.mixin=function(a){j(b.functions(a),
-function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var b=L++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var t=/.^/,u=function(a){return a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var d=b.templateSettings,d="var __p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape||t,function(a,b){return"',_.escape("+
-u(b)+"),'"}).replace(d.interpolate||t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return __p.join('');",e=new Function("obj","_",d);return c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var v=function(a,c){return c?b(a).chain():a},K=function(a,c){m.prototype[a]=
-function(){var a=i.call(arguments);H.call(a,this._wrapped);return v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return v(d,this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain=
-true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);

docs/_build/html/_static/websupport.js

@@ -1,808 +0,0 @@
-/*
- * websupport.js
- * ~~~~~~~~~~~~~
- *
- * sphinx.websupport utilities for all documentation.
- *
- * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-(function($) {
-  $.fn.autogrow = function() {
-    return this.each(function() {
-    var textarea = this;
-
-    $.fn.autogrow.resize(textarea);
-
-    $(textarea)
-      .focus(function() {
-        textarea.interval = setInterval(function() {
-          $.fn.autogrow.resize(textarea);
-        }, 500);
-      })
-      .blur(function() {
-        clearInterval(textarea.interval);
-      });
-    });
-  };
-
-  $.fn.autogrow.resize = function(textarea) {
-    var lineHeight = parseInt($(textarea).css('line-height'), 10);
-    var lines = textarea.value.split('\n');
-    var columns = textarea.cols;
-    var lineCount = 0;
-    $.each(lines, function() {
-      lineCount += Math.ceil(this.length / columns) || 1;
-    });
-    var height = lineHeight * (lineCount + 1);
-    $(textarea).css('height', height);
-  };
-})(jQuery);
-
-(function($) {
-  var comp, by;
-
-  function init() {
-    initEvents();
-    initComparator();
-  }
-
-  function initEvents() {
-    $(document).on("click", 'a.comment-close', function(event) {
-      event.preventDefault();
-      hide($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.vote', function(event) {
-      event.preventDefault();
-      handleVote($(this));
-    });
-    $(document).on("click", 'a.reply', function(event) {
-      event.preventDefault();
-      openReply($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.close-reply', function(event) {
-      event.preventDefault();
-      closeReply($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.sort-option', function(event) {
-      event.preventDefault();
-      handleReSort($(this));
-    });
-    $(document).on("click", 'a.show-proposal', function(event) {
-      event.preventDefault();
-      showProposal($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.hide-proposal', function(event) {
-      event.preventDefault();
-      hideProposal($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.show-propose-change', function(event) {
-      event.preventDefault();
-      showProposeChange($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.hide-propose-change', function(event) {
-      event.preventDefault();
-      hideProposeChange($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.accept-comment', function(event) {
-      event.preventDefault();
-      acceptComment($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.delete-comment', function(event) {
-      event.preventDefault();
-      deleteComment($(this).attr('id').substring(2));
-    });
-    $(document).on("click", 'a.comment-markup', function(event) {
-      event.preventDefault();
-      toggleCommentMarkupBox($(this).attr('id').substring(2));
-    });
-  }
-
-  /**
-   * Set comp, which is a comparator function used for sorting and
-   * inserting comments into the list.
-   */
-  function setComparator() {
-    // If the first three letters are "asc", sort in ascending order
-    // and remove the prefix.
-    if (by.substring(0,3) == 'asc') {
-      var i = by.substring(3);
-      comp = function(a, b) { return a[i] - b[i]; };
-    } else {
-      // Otherwise sort in descending order.
-      comp = function(a, b) { return b[by] - a[by]; };
-    }
-
-    // Reset link styles and format the selected sort option.
-    $('a.sel').attr('href', '#').removeClass('sel');
-    $('a.by' + by).removeAttr('href').addClass('sel');
-  }
-
-  /**
-   * Create a comp function. If the user has preferences stored in
-   * the sortBy cookie, use those, otherwise use the default.
-   */
-  function initComparator() {
-    by = 'rating'; // Default to sort by rating.
-    // If the sortBy cookie is set, use that instead.
-    if (document.cookie.length > 0) {
-      var start = document.cookie.indexOf('sortBy=');
-      if (start != -1) {
-        start = start + 7;
-        var end = document.cookie.indexOf(";", start);
-        if (end == -1) {
-          end = document.cookie.length;
-          by = unescape(document.cookie.substring(start, end));
-        }
-      }
-    }
-    setComparator();
-  }
-
-  /**
-   * Show a comment div.
-   */
-  function show(id) {
-    $('#ao' + id).hide();
-    $('#ah' + id).show();
-    var context = $.extend({id: id}, opts);
-    var popup = $(renderTemplate(popupTemplate, context)).hide();
-    popup.find('textarea[name="proposal"]').hide();
-    popup.find('a.by' + by).addClass('sel');
-    var form = popup.find('#cf' + id);
-    form.submit(function(event) {
-      event.preventDefault();
-      addComment(form);
-    });
-    $('#s' + id).after(popup);
-    popup.slideDown('fast', function() {
-      getComments(id);
-    });
-  }
-
-  /**
-   * Hide a comment div.
-   */
-  function hide(id) {
-    $('#ah' + id).hide();
-    $('#ao' + id).show();
-    var div = $('#sc' + id);
-    div.slideUp('fast', function() {
-      div.remove();
-    });
-  }
-
-  /**
-   * Perform an ajax request to get comments for a node
-   * and insert the comments into the comments tree.
-   */
-  function getComments(id) {
-    $.ajax({
-     type: 'GET',
-     url: opts.getCommentsURL,
-     data: {node: id},
-     success: function(data, textStatus, request) {
-       var ul = $('#cl' + id);
-       var speed = 100;
-       $('#cf' + id)
-         .find('textarea[name="proposal"]')
-         .data('source', data.source);
-
-       if (data.comments.length === 0) {
-         ul.html('<li>No comments yet.</li>');
-         ul.data('empty', true);
-       } else {
-         // If there are comments, sort them and put them in the list.
-         var comments = sortComments(data.comments);
-         speed = data.comments.length * 100;
-         appendComments(comments, ul);
-         ul.data('empty', false);
-       }
-       $('#cn' + id).slideUp(speed + 200);
-       ul.slideDown(speed);
-     },
-     error: function(request, textStatus, error) {
-       showError('Oops, there was a problem retrieving the comments.');
-     },
-     dataType: 'json'
-    });
-  }
-
-  /**
-   * Add a comment via ajax and insert the comment into the comment tree.
-   */
-  function addComment(form) {
-    var node_id = form.find('input[name="node"]').val();
-    var parent_id = form.find('input[name="parent"]').val();
-    var text = form.find('textarea[name="comment"]').val();
-    var proposal = form.find('textarea[name="proposal"]').val();
-
-    if (text == '') {
-      showError('Please enter a comment.');
-      return;
-    }
-
-    // Disable the form that is being submitted.
-    form.find('textarea,input').attr('disabled', 'disabled');
-
-    // Send the comment to the server.
-    $.ajax({
-      type: "POST",
-      url: opts.addCommentURL,
-      dataType: 'json',
-      data: {
-        node: node_id,
-        parent: parent_id,
-        text: text,
-        proposal: proposal
-      },
-      success: function(data, textStatus, error) {
-        // Reset the form.
-        if (node_id) {
-          hideProposeChange(node_id);
-        }
-        form.find('textarea')
-          .val('')
-          .add(form.find('input'))
-          .removeAttr('disabled');
-	var ul = $('#cl' + (node_id || parent_id));
-        if (ul.data('empty')) {
-          $(ul).empty();
-          ul.data('empty', false);
-        }
-        insertComment(data.comment);
-        var ao = $('#ao' + node_id);
-        ao.find('img').attr({'src': opts.commentBrightImage});
-        if (node_id) {
-          // if this was a "root" comment, remove the commenting box
-          // (the user can get it back by reopening the comment popup)
-          $('#ca' + node_id).slideUp();
-        }
-      },
-      error: function(request, textStatus, error) {
-        form.find('textarea,input').removeAttr('disabled');
-        showError('Oops, there was a problem adding the comment.');
-      }
-    });
-  }
-
-  /**
-   * Recursively append comments to the main comment list and children
-   * lists, creating the comment tree.
-   */
-  function appendComments(comments, ul) {
-    $.each(comments, function() {
-      var div = createCommentDiv(this);
-      ul.append($(document.createElement('li')).html(div));
-      appendComments(this.children, div.find('ul.comment-children'));
-      // To avoid stagnating data, don't store the comments children in data.
-      this.children = null;
-      div.data('comment', this);
-    });
-  }
-
-  /**
-   * After adding a new comment, it must be inserted in the correct
-   * location in the comment tree.
-   */
-  function insertComment(comment) {
-    var div = createCommentDiv(comment);
-
-    // To avoid stagnating data, don't store the comments children in data.
-    comment.children = null;
-    div.data('comment', comment);
-
-    var ul = $('#cl' + (comment.node || comment.parent));
-    var siblings = getChildren(ul);
-
-    var li = $(document.createElement('li'));
-    li.hide();
-
-    // Determine where in the parents children list to insert this comment.
-    for(i=0; i < siblings.length; i++) {
-      if (comp(comment, siblings[i]) <= 0) {
-        $('#cd' + siblings[i].id)
-          .parent()
-          .before(li.html(div));
-        li.slideDown('fast');
-        return;
-      }
-    }
-
-    // If we get here, this comment rates lower than all the others,
-    // or it is the only comment in the list.
-    ul.append(li.html(div));
-    li.slideDown('fast');
-  }
-
-  function acceptComment(id) {
-    $.ajax({
-      type: 'POST',
-      url: opts.acceptCommentURL,
-      data: {id: id},
-      success: function(data, textStatus, request) {
-        $('#cm' + id).fadeOut('fast');
-        $('#cd' + id).removeClass('moderate');
-      },
-      error: function(request, textStatus, error) {
-        showError('Oops, there was a problem accepting the comment.');
-      }
-    });
-  }
-
-  function deleteComment(id) {
-    $.ajax({
-      type: 'POST',
-      url: opts.deleteCommentURL,
-      data: {id: id},
-      success: function(data, textStatus, request) {
-        var div = $('#cd' + id);
-        if (data == 'delete') {
-          // Moderator mode: remove the comment and all children immediately
-          div.slideUp('fast', function() {
-            div.remove();
-          });
-          return;
-        }
-        // User mode: only mark the comment as deleted
-        div
-          .find('span.user-id:first')
-          .text('[deleted]').end()
-          .find('div.comment-text:first')
-          .text('[deleted]').end()
-          .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id +
-                ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id)
-          .remove();
-        var comment = div.data('comment');
-        comment.username = '[deleted]';
-        comment.text = '[deleted]';
-        div.data('comment', comment);
-      },
-      error: function(request, textStatus, error) {
-        showError('Oops, there was a problem deleting the comment.');
-      }
-    });
-  }
-
-  function showProposal(id) {
-    $('#sp' + id).hide();
-    $('#hp' + id).show();
-    $('#pr' + id).slideDown('fast');
-  }
-
-  function hideProposal(id) {
-    $('#hp' + id).hide();
-    $('#sp' + id).show();
-    $('#pr' + id).slideUp('fast');
-  }
-
-  function showProposeChange(id) {
-    $('#pc' + id).hide();
-    $('#hc' + id).show();
-    var textarea = $('#pt' + id);
-    textarea.val(textarea.data('source'));
-    $.fn.autogrow.resize(textarea[0]);
-    textarea.slideDown('fast');
-  }
-
-  function hideProposeChange(id) {
-    $('#hc' + id).hide();
-    $('#pc' + id).show();
-    var textarea = $('#pt' + id);
-    textarea.val('').removeAttr('disabled');
-    textarea.slideUp('fast');
-  }
-
-  function toggleCommentMarkupBox(id) {
-    $('#mb' + id).toggle();
-  }
-
-  /** Handle when the user clicks on a sort by link. */
-  function handleReSort(link) {
-    var classes = link.attr('class').split(/\s+/);
-    for (var i=0; i<classes.length; i++) {
-      if (classes[i] != 'sort-option') {
-	by = classes[i].substring(2);
-      }
-    }
-    setComparator();
-    // Save/update the sortBy cookie.
-    var expiration = new Date();
-    expiration.setDate(expiration.getDate() + 365);
-    document.cookie= 'sortBy=' + escape(by) +
-                     ';expires=' + expiration.toUTCString();
-    $('ul.comment-ul').each(function(index, ul) {
-      var comments = getChildren($(ul), true);
-      comments = sortComments(comments);
-      appendComments(comments, $(ul).empty());
-    });
-  }
-
-  /**
-   * Function to process a vote when a user clicks an arrow.
-   */
-  function handleVote(link) {
-    if (!opts.voting) {
-      showError("You'll need to login to vote.");
-      return;
-    }
-
-    var id = link.attr('id');
-    if (!id) {
-      // Didn't click on one of the voting arrows.
-      return;
-    }
-    // If it is an unvote, the new vote value is 0,
-    // Otherwise it's 1 for an upvote, or -1 for a downvote.
-    var value = 0;
-    if (id.charAt(1) != 'u') {
-      value = id.charAt(0) == 'u' ? 1 : -1;
-    }
-    // The data to be sent to the server.
-    var d = {
-      comment_id: id.substring(2),
-      value: value
-    };
-
-    // Swap the vote and unvote links.
-    link.hide();
-    $('#' + id.charAt(0) + (id.charAt(1) == 'u' ? 'v' : 'u') + d.comment_id)
-      .show();
-
-    // The div the comment is displayed in.
-    var div = $('div#cd' + d.comment_id);
-    var data = div.data('comment');
-
-    // If this is not an unvote, and the other vote arrow has
-    // already been pressed, unpress it.
-    if ((d.value !== 0) && (data.vote === d.value * -1)) {
-      $('#' + (d.value == 1 ? 'd' : 'u') + 'u' + d.comment_id).hide();
-      $('#' + (d.value == 1 ? 'd' : 'u') + 'v' + d.comment_id).show();
-    }
-
-    // Update the comments rating in the local data.
-    data.rating += (data.vote === 0) ? d.value : (d.value - data.vote);
-    data.vote = d.value;
-    div.data('comment', data);
-
-    // Change the rating text.
-    div.find('.rating:first')
-      .text(data.rating + ' point' + (data.rating == 1 ? '' : 's'));
-
-    // Send the vote information to the server.
-    $.ajax({
-      type: "POST",
-      url: opts.processVoteURL,
-      data: d,
-      error: function(request, textStatus, error) {
-        showError('Oops, there was a problem casting that vote.');
-      }
-    });
-  }
-
-  /**
-   * Open a reply form used to reply to an existing comment.
-   */
-  function openReply(id) {
-    // Swap out the reply link for the hide link
-    $('#rl' + id).hide();
-    $('#cr' + id).show();
-
-    // Add the reply li to the children ul.
-    var div = $(renderTemplate(replyTemplate, {id: id})).hide();
-    $('#cl' + id)
-      .prepend(div)
-      // Setup the submit handler for the reply form.
-      .find('#rf' + id)
-      .submit(function(event) {
-        event.preventDefault();
-        addComment($('#rf' + id));
-        closeReply(id);
-      })
-      .find('input[type=button]')
-      .click(function() {
-        closeReply(id);
-      });
-    div.slideDown('fast', function() {
-      $('#rf' + id).find('textarea').focus();
-    });
-  }
-
-  /**
-   * Close the reply form opened with openReply.
-   */
-  function closeReply(id) {
-    // Remove the reply div from the DOM.
-    $('#rd' + id).slideUp('fast', function() {
-      $(this).remove();
-    });
-
-    // Swap out the hide link for the reply link
-    $('#cr' + id).hide();
-    $('#rl' + id).show();
-  }
-
-  /**
-   * Recursively sort a tree of comments using the comp comparator.
-   */
-  function sortComments(comments) {
-    comments.sort(comp);
-    $.each(comments, function() {
-      this.children = sortComments(this.children);
-    });
-    return comments;
-  }
-
-  /**
-   * Get the children comments from a ul. If recursive is true,
-   * recursively include childrens' children.
-   */
-  function getChildren(ul, recursive) {
-    var children = [];
-    ul.children().children("[id^='cd']")
-      .each(function() {
-        var comment = $(this).data('comment');
-        if (recursive)
-          comment.children = getChildren($(this).find('#cl' + comment.id), true);
-        children.push(comment);
-      });
-    return children;
-  }
-
-  /** Create a div to display a comment in. */
-  function createCommentDiv(comment) {
-    if (!comment.displayed && !opts.moderator) {
-      return $('<div class="moderate">Thank you!  Your comment will show up '
-               + 'once it is has been approved by a moderator.</div>');
-    }
-    // Prettify the comment rating.
-    comment.pretty_rating = comment.rating + ' point' +
-      (comment.rating == 1 ? '' : 's');
-    // Make a class (for displaying not yet moderated comments differently)
-    comment.css_class = comment.displayed ? '' : ' moderate';
-    // Create a div for this comment.
-    var context = $.extend({}, opts, comment);
-    var div = $(renderTemplate(commentTemplate, context));
-
-    // If the user has voted on this comment, highlight the correct arrow.
-    if (comment.vote) {
-      var direction = (comment.vote == 1) ? 'u' : 'd';
-      div.find('#' + direction + 'v' + comment.id).hide();
-      div.find('#' + direction + 'u' + comment.id).show();
-    }
-
-    if (opts.moderator || comment.text != '[deleted]') {
-      div.find('a.reply').show();
-      if (comment.proposal_diff)
-        div.find('#sp' + comment.id).show();
-      if (opts.moderator && !comment.displayed)
-        div.find('#cm' + comment.id).show();
-      if (opts.moderator || (opts.username == comment.username))
-        div.find('#dc' + comment.id).show();
-    }
-    return div;
-  }
-
-  /**
-   * A simple template renderer. Placeholders such as <%id%> are replaced
-   * by context['id'] with items being escaped. Placeholders such as <#id#>
-   * are not escaped.
-   */
-  function renderTemplate(template, context) {
-    var esc = $(document.createElement('div'));
-
-    function handle(ph, escape) {
-      var cur = context;
-      $.each(ph.split('.'), function() {
-        cur = cur[this];
-      });
-      return escape ? esc.text(cur || "").html() : cur;
-    }
-
-    return template.replace(/<([%#])([\w\.]*)\1>/g, function() {
-      return handle(arguments[2], arguments[1] == '%' ? true : false);
-    });
-  }
-
-  /** Flash an error message briefly. */
-  function showError(message) {
-    $(document.createElement('div')).attr({'class': 'popup-error'})
-      .append($(document.createElement('div'))
-               .attr({'class': 'error-message'}).text(message))
-      .appendTo('body')
-      .fadeIn("slow")
-      .delay(2000)
-      .fadeOut("slow");
-  }
-
-  /** Add a link the user uses to open the comments popup. */
-  $.fn.comment = function() {
-    return this.each(function() {
-      var id = $(this).attr('id').substring(1);
-      var count = COMMENT_METADATA[id];
-      var title = count + ' comment' + (count == 1 ? '' : 's');
-      var image = count > 0 ? opts.commentBrightImage : opts.commentImage;
-      var addcls = count == 0 ? ' nocomment' : '';
-      $(this)
-        .append(
-          $(document.createElement('a')).attr({
-            href: '#',
-            'class': 'sphinx-comment-open' + addcls,
-            id: 'ao' + id
-          })
-            .append($(document.createElement('img')).attr({
-              src: image,
-              alt: 'comment',
-              title: title
-            }))
-            .click(function(event) {
-              event.preventDefault();
-              show($(this).attr('id').substring(2));
-            })
-        )
-        .append(
-          $(document.createElement('a')).attr({
-            href: '#',
-            'class': 'sphinx-comment-close hidden',
-            id: 'ah' + id
-          })
-            .append($(document.createElement('img')).attr({
-              src: opts.closeCommentImage,
-              alt: 'close',
-              title: 'close'
-            }))
-            .click(function(event) {
-              event.preventDefault();
-              hide($(this).attr('id').substring(2));
-            })
-        );
-    });
-  };
-
-  var opts = {
-    processVoteURL: '/_process_vote',
-    addCommentURL: '/_add_comment',
-    getCommentsURL: '/_get_comments',
-    acceptCommentURL: '/_accept_comment',
-    deleteCommentURL: '/_delete_comment',
-    commentImage: '/static/_static/comment.png',
-    closeCommentImage: '/static/_static/comment-close.png',
-    loadingImage: '/static/_static/ajax-loader.gif',
-    commentBrightImage: '/static/_static/comment-bright.png',
-    upArrow: '/static/_static/up.png',
-    downArrow: '/static/_static/down.png',
-    upArrowPressed: '/static/_static/up-pressed.png',
-    downArrowPressed: '/static/_static/down-pressed.png',
-    voting: false,
-    moderator: false
-  };
-
-  if (typeof COMMENT_OPTIONS != "undefined") {
-    opts = jQuery.extend(opts, COMMENT_OPTIONS);
-  }
-
-  var popupTemplate = '\
-    <div class="sphinx-comments" id="sc<%id%>">\
-      <p class="sort-options">\
-        Sort by:\
-        <a href="#" class="sort-option byrating">best rated</a>\
-        <a href="#" class="sort-option byascage">newest</a>\
-        <a href="#" class="sort-option byage">oldest</a>\
-      </p>\
-      <div class="comment-header">Comments</div>\
-      <div class="comment-loading" id="cn<%id%>">\
-        loading comments... <img src="<%loadingImage%>" alt="" /></div>\
-      <ul id="cl<%id%>" class="comment-ul"></ul>\
-      <div id="ca<%id%>">\
-      <p class="add-a-comment">Add a comment\
-        (<a href="#" class="comment-markup" id="ab<%id%>">markup</a>):</p>\
-      <div class="comment-markup-box" id="mb<%id%>">\
-        reStructured text markup: <i>*emph*</i>, <b>**strong**</b>, \
-        <code>``code``</code>, \
-        code blocks: <code>::</code> and an indented block after blank line</div>\
-      <form method="post" id="cf<%id%>" class="comment-form" action="">\
-        <textarea name="comment" cols="80"></textarea>\
-        <p class="propose-button">\
-          <a href="#" id="pc<%id%>" class="show-propose-change">\
-            Propose a change &#9657;\
-          </a>\
-          <a href="#" id="hc<%id%>" class="hide-propose-change">\
-            Propose a change &#9663;\
-          </a>\
-        </p>\
-        <textarea name="proposal" id="pt<%id%>" cols="80"\
-                  spellcheck="false"></textarea>\
-        <input type="submit" value="Add comment" />\
-        <input type="hidden" name="node" value="<%id%>" />\
-        <input type="hidden" name="parent" value="" />\
-      </form>\
-      </div>\
-    </div>';
-
-  var commentTemplate = '\
-    <div id="cd<%id%>" class="sphinx-comment<%css_class%>">\
-      <div class="vote">\
-        <div class="arrow">\
-          <a href="#" id="uv<%id%>" class="vote" title="vote up">\
-            <img src="<%upArrow%>" />\
-          </a>\
-          <a href="#" id="uu<%id%>" class="un vote" title="vote up">\
-            <img src="<%upArrowPressed%>" />\
-          </a>\
-        </div>\
-        <div class="arrow">\
-          <a href="#" id="dv<%id%>" class="vote" title="vote down">\
-            <img src="<%downArrow%>" id="da<%id%>" />\
-          </a>\
-          <a href="#" id="du<%id%>" class="un vote" title="vote down">\
-            <img src="<%downArrowPressed%>" />\
-          </a>\
-        </div>\
-      </div>\
-      <div class="comment-content">\
-        <p class="tagline comment">\
-          <span class="user-id"><%username%></span>\
-          <span class="rating"><%pretty_rating%></span>\
-          <span class="delta"><%time.delta%></span>\
-        </p>\
-        <div class="comment-text comment"><#text#></div>\
-        <p class="comment-opts comment">\
-          <a href="#" class="reply hidden" id="rl<%id%>">reply &#9657;</a>\
-          <a href="#" class="close-reply" id="cr<%id%>">reply &#9663;</a>\
-          <a href="#" id="sp<%id%>" class="show-proposal">proposal &#9657;</a>\
-          <a href="#" id="hp<%id%>" class="hide-proposal">proposal &#9663;</a>\
-          <a href="#" id="dc<%id%>" class="delete-comment hidden">delete</a>\
-          <span id="cm<%id%>" class="moderation hidden">\
-            <a href="#" id="ac<%id%>" class="accept-comment">accept</a>\
-          </span>\
-        </p>\
-        <pre class="proposal" id="pr<%id%>">\
-<#proposal_diff#>\
-        </pre>\
-          <ul class="comment-children" id="cl<%id%>"></ul>\
-        </div>\
-        <div class="clearleft"></div>\
-      </div>\
-    </div>';
-
-  var replyTemplate = '\
-    <li>\
-      <div class="reply-div" id="rd<%id%>">\
-        <form id="rf<%id%>">\
-          <textarea name="comment" cols="80"></textarea>\
-          <input type="submit" value="Add reply" />\
-          <input type="button" value="Cancel" />\
-          <input type="hidden" name="parent" value="<%id%>" />\
-          <input type="hidden" name="node" value="" />\
-        </form>\
-      </div>\
-    </li>';
-
-  $(document).ready(function() {
-    init();
-  });
-})(jQuery);
-
-$(document).ready(function() {
-  // add comment anchors for all paragraphs that are commentable
-  $('.sphinx-has-comment').comment();
-
-  // highlight search words in search results
-  $("div.context").each(function() {
-    var params = $.getQueryParameters();
-    var terms = (params.q) ? params.q[0].split(/\s+/) : [];
-    var result = $(this);
-    $.each(terms, function() {
-      result.highlightText(this.toLowerCase(), 'highlighted');
-    });
-  });
-
-  // directly open comment window if requested
-  var anchor = document.location.hash;
-  if (anchor.substring(0, 9) == '#comment-') {
-    $('#ao' + anchor.substring(9)).click();
-    document.location.hash = '#s' + anchor.substring(9);
-  }
-});

docs/_build/html/flask/flask.ext.html

@@ -1,136 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask.ext package &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../_static/jquery.js"></script>
-    <script type="text/javascript" src="../_static/underscore.js"></script>
-    <script type="text/javascript" src="../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../genindex.html" />
-    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../index.html" />
-   
-  <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <div class="section" id="flask-ext-package">
-<h1>flask.ext package<a class="headerlink" href="#flask-ext-package" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="module-flask.ext">
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-flask.ext" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-ext">
-<h3>flask.ext<a class="headerlink" href="#flask-ext" title="Permalink to this headline">¶</a></h3>
-<p>Redirect imports for extensions.  This module basically makes it possible
-for us to transition from flaskext.foo to flask_foo without having to
-force all extensions to upgrade at the same time.</p>
-<p>When a user does <code class="docutils literal"><span class="pre">from</span> <span class="pre">flask.ext.foo</span> <span class="pre">import</span> <span class="pre">bar</span></code> it will attempt to
-import <code class="docutils literal"><span class="pre">from</span> <span class="pre">flask_foo</span> <span class="pre">import</span> <span class="pre">bar</span></code> first and when that fails it will
-try to import <code class="docutils literal"><span class="pre">from</span> <span class="pre">flaskext.foo</span> <span class="pre">import</span> <span class="pre">bar</span></code>.</p>
-<p>We&#8217;re switching from namespace packages because it was just too painful for
-everybody involved.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper">
-  <h3><a href="../index.html">Table Of Contents</a></h3>
-  <ul>
-<li><a class="reference internal" href="#">flask.ext package</a><ul>
-<li><a class="reference internal" href="#module-flask.ext">Module contents</a><ul>
-<li><a class="reference internal" href="#flask-ext">flask.ext</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-  <div role="note" aria-label="source link">
-    <h3>This Page</h3>
-    <ul class="this-page-menu">
-      <li><a href="../_sources/flask/flask.ext.txt"
-            rel="nofollow">Show Source</a></li>
-    </ul>
-   </div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-      |
-      <a href="../_sources/flask/flask.ext.txt"
-          rel="nofollow">Page source</a>
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/flask/flask.html

@@ -1,4693 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>flask package &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../_static/jquery.js"></script>
-    <script type="text/javascript" src="../_static/underscore.js"></script>
-    <script type="text/javascript" src="../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../genindex.html" />
-    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../index.html" />
-   
-  <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <div class="section" id="flask-package">
-<h1>flask package<a class="headerlink" href="#flask-package" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="subpackages">
-<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline">¶</a></h2>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="flask.ext.html">flask.ext package</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="flask.ext.html#module-flask.ext">Module contents</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.ext.html#flask-ext">flask.ext</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-</div>
-<div class="section" id="submodules">
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
-</div>
-<div class="section" id="module-flask.app">
-<span id="flask-app-module"></span><h2>flask.app module<a class="headerlink" href="#module-flask.app" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-app">
-<h3>flask.app<a class="headerlink" href="#flask-app" title="Permalink to this headline">¶</a></h3>
-<p>This module implements the central WSGI application object.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.app.Flask">
-<em class="property">class </em><code class="descclassname">flask.app.</code><code class="descname">Flask</code><span class="sig-paren">(</span><em>import_name</em>, <em>static_path=None</em>, <em>static_url_path=None</em>, <em>static_folder='static'</em>, <em>template_folder='templates'</em>, <em>instance_path=None</em>, <em>instance_relative_config=False</em>, <em>root_path=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">flask.helpers._PackageBoundObject</span></code></p>
-<p>The flask object implements a WSGI application and acts as the central
-object.  It is passed the name of the module or package of the
-application.  Once it is created it will act as a central registry for
-the view functions, the URL rules, template configuration and much more.</p>
-<p>The name of the package is used to resolve resources from inside the
-package or the folder the module is contained in depending on if the
-package parameter resolves to an actual python package (a folder with
-an <code class="file docutils literal"><span class="pre">__init__.py</span></code> file inside) or a standard module (just a <code class="docutils literal"><span class="pre">.py</span></code> file).</p>
-<p>For more information about resource loading, see <code class="xref py py-func docutils literal"><span class="pre">open_resource()</span></code>.</p>
-<p>Usually you create a <a class="reference internal" href="#flask.app.Flask" title="flask.app.Flask"><code class="xref py py-class docutils literal"><span class="pre">Flask</span></code></a> instance in your main module or
-in the <code class="file docutils literal"><span class="pre">__init__.py</span></code> file of your package like this:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">flask</span> <span class="k">import</span> <span class="n">Flask</span>
-<span class="n">app</span> <span class="o">=</span> <span class="n">Flask</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
-</pre></div>
-</div>
-<div class="admonition-about-the-first-parameter admonition">
-<p class="first admonition-title">About the First Parameter</p>
-<p>The idea of the first parameter is to give Flask an idea of what
-belongs to your application.  This name is used to find resources
-on the filesystem, can be used by extensions to improve debugging
-information and a lot more.</p>
-<p>So it&#8217;s important what you provide there.  If you are using a single
-module, <cite>__name__</cite> is always the correct value.  If you however are
-using a package, it&#8217;s usually recommended to hardcode the name of
-your package there.</p>
-<p>For example if your application is defined in <code class="file docutils literal"><span class="pre">yourapplication/app.py</span></code>
-you should create it with one of the two versions below:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span> <span class="o">=</span> <span class="n">Flask</span><span class="p">(</span><span class="s1">&#39;yourapplication&#39;</span><span class="p">)</span>
-<span class="n">app</span> <span class="o">=</span> <span class="n">Flask</span><span class="p">(</span><span class="n">__name__</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;.&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">])</span>
-</pre></div>
-</div>
-<p class="last">Why is that?  The application will work even with <cite>__name__</cite>, thanks
-to how resources are looked up.  However it will make debugging more
-painful.  Certain extensions can make assumptions based on the
-import name of your application.  For example the Flask-SQLAlchemy
-extension will look for the code in your application that triggered
-an SQL query in debug mode.  If the import name is not properly set
-up, that debugging information is lost.  (For example it would only
-pick up SQL queries in <cite>yourapplication.app</cite> and not
-<cite>yourapplication.views.frontend</cite>)</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7: </span>The <cite>static_url_path</cite>, <cite>static_folder</cite>, and <cite>template_folder</cite>
-parameters were added.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8: </span>The <cite>instance_path</cite> and <cite>instance_relative_config</cite> parameters were
-added.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11: </span>The <cite>root_path</cite> parameter was added.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>import_name</strong> &#8211; the name of the application package</li>
-<li><strong>static_url_path</strong> &#8211; can be used to specify a different path for the
-static files on the web.  Defaults to the name
-of the <cite>static_folder</cite> folder.</li>
-<li><strong>static_folder</strong> &#8211; the folder with static files that should be served
-at <cite>static_url_path</cite>.  Defaults to the <code class="docutils literal"><span class="pre">'static'</span></code>
-folder in the root path of the application.</li>
-<li><strong>template_folder</strong> &#8211; the folder that contains the templates that should
-be used by the application.  Defaults to
-<code class="docutils literal"><span class="pre">'templates'</span></code> folder in the root path of the
-application.</li>
-<li><strong>instance_path</strong> &#8211; An alternative instance path for the application.
-By default the folder <code class="docutils literal"><span class="pre">'instance'</span></code> next to the
-package or module is assumed to be the instance
-path.</li>
-<li><strong>instance_relative_config</strong> &#8211; if set to <code class="docutils literal"><span class="pre">True</span></code> relative filenames
-for loading the config are assumed to
-be relative to the instance path instead
-of the application root.</li>
-<li><strong>root_path</strong> &#8211; Flask by default will automatically calculate the path
-to the root of the application.  In certain situations
-this cannot be achieved (for instance if the package
-is a Python 3 namespace package) and needs to be
-manually defined.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="method">
-<dt id="flask.app.Flask.add_template_filter">
-<code class="descname">add_template_filter</code><span class="sig-paren">(</span><em>f</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.add_template_filter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.add_template_filter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template filter.  Works exactly like the
-<a class="reference internal" href="#flask.app.Flask.template_filter" title="flask.app.Flask.template_filter"><code class="xref py py-meth docutils literal"><span class="pre">template_filter()</span></code></a> decorator.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the filter, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.add_template_global">
-<code class="descname">add_template_global</code><span class="sig-paren">(</span><em>f</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.add_template_global"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.add_template_global" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template global function. Works exactly like the
-<a class="reference internal" href="#flask.app.Flask.template_global" title="flask.app.Flask.template_global"><code class="xref py py-meth docutils literal"><span class="pre">template_global()</span></code></a> decorator.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the global function, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.add_template_test">
-<code class="descname">add_template_test</code><span class="sig-paren">(</span><em>f</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.add_template_test"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.add_template_test" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template test.  Works exactly like the
-<a class="reference internal" href="#flask.app.Flask.template_test" title="flask.app.Flask.template_test"><code class="xref py py-meth docutils literal"><span class="pre">template_test()</span></code></a> decorator.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the test, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.add_url_rule">
-<code class="descname">add_url_rule</code><span class="sig-paren">(</span><em>rule</em>, <em>endpoint=None</em>, <em>view_func=None</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.add_url_rule"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.add_url_rule" title="Permalink to this definition">¶</a></dt>
-<dd><p>Connects a URL rule.  Works exactly like the <a class="reference internal" href="#flask.app.Flask.route" title="flask.app.Flask.route"><code class="xref py py-meth docutils literal"><span class="pre">route()</span></code></a>
-decorator.  If a view_func is provided it will be registered with the
-endpoint.</p>
-<p>Basically this example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="k">pass</span>
-</pre></div>
-</div>
-<p>Is equivalent to the following:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="k">pass</span>
-<span class="n">app</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">,</span> <span class="s1">&#39;index&#39;</span><span class="p">,</span> <span class="n">index</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>If the view_func is not provided you will need to connect the endpoint
-to a view function like so:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">view_functions</span><span class="p">[</span><span class="s1">&#39;index&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">index</span>
-</pre></div>
-</div>
-<p>Internally <a class="reference internal" href="#flask.app.Flask.route" title="flask.app.Flask.route"><code class="xref py py-meth docutils literal"><span class="pre">route()</span></code></a> invokes <a class="reference internal" href="#flask.app.Flask.add_url_rule" title="flask.app.Flask.add_url_rule"><code class="xref py py-meth docutils literal"><span class="pre">add_url_rule()</span></code></a> so if you want
-to customize the behavior via subclassing you only need to change
-this method.</p>
-<p>For more information refer to <span class="xref std std-ref">url-route-registrations</span>.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.2: </span><cite>view_func</cite> parameter added.</p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.6: </span><code class="docutils literal"><span class="pre">OPTIONS</span></code> is added automatically as method.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>rule</strong> &#8211; the URL rule as string</li>
-<li><strong>endpoint</strong> &#8211; the endpoint for the registered URL rule.  Flask
-itself assumes the name of the view function as
-endpoint</li>
-<li><strong>view_func</strong> &#8211; the function to call when serving a request to the
-provided endpoint</li>
-<li><strong>options</strong> &#8211; the options to be forwarded to the underlying
-<code class="xref py py-class docutils literal"><span class="pre">Rule</span></code> object.  A change
-to Werkzeug is handling of method options.  methods
-is a list of methods this rule should be limited
-to (<code class="docutils literal"><span class="pre">GET</span></code>, <code class="docutils literal"><span class="pre">POST</span></code> etc.).  By default a rule
-just listens for <code class="docutils literal"><span class="pre">GET</span></code> (and implicitly <code class="docutils literal"><span class="pre">HEAD</span></code>).
-Starting with Flask 0.6, <code class="docutils literal"><span class="pre">OPTIONS</span></code> is implicitly
-added and handled by the standard request handling.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.after_request">
-<code class="descname">after_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.after_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.after_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a function to be run after each request.</p>
-<p>Your function must take one parameter, an instance of
-<a class="reference internal" href="#flask.app.Flask.response_class" title="flask.app.Flask.response_class"><code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code></a> and return a new response object or the
-same (see <a class="reference internal" href="#flask.app.Flask.process_response" title="flask.app.Flask.process_response"><code class="xref py py-meth docutils literal"><span class="pre">process_response()</span></code></a>).</p>
-<p>As of Flask 0.7 this function might not be executed at the end of the
-request in case an unhandled exception occurred.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.after_request_funcs">
-<code class="descname">after_request_funcs</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.after_request_funcs" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with lists of functions that should be called after
-each request.  The key of the dictionary is the name of the blueprint
-this function is active for, <code class="docutils literal"><span class="pre">None</span></code> for all requests.  This can for
-example be used to close database connections. To register a function
-here, use the <a class="reference internal" href="#flask.app.Flask.after_request" title="flask.app.Flask.after_request"><code class="xref py py-meth docutils literal"><span class="pre">after_request()</span></code></a> decorator.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.app_context">
-<code class="descname">app_context</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.app_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.app_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Binds the application only.  For as long as the application is bound
-to the current context the <code class="xref py py-data docutils literal"><span class="pre">flask.current_app</span></code> points to that
-application.  An application context is automatically created when a
-request context is pushed if necessary.</p>
-<p>Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">with</span> <span class="n">app</span><span class="o">.</span><span class="n">app_context</span><span class="p">():</span>
-    <span class="o">...</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.app_ctx_globals_class">
-<code class="descname">app_ctx_globals_class</code><a class="headerlink" href="#flask.app.Flask.app_ctx_globals_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>The class that is used for the <code class="xref py py-data docutils literal"><span class="pre">g</span></code> instance.</p>
-<p>Example use cases for a custom class:</p>
-<ol class="arabic simple">
-<li>Store arbitrary attributes on flask.g.</li>
-<li>Add a property for lazy per-request database connectors.</li>
-<li>Return None instead of AttributeError on unexpected attributes.</li>
-<li>Raise exception if an unexpected attr is set, a &#8220;controlled&#8221; flask.g.</li>
-</ol>
-<p>In Flask 0.9 this property was called <cite>request_globals_class</cite> but it
-was changed in 0.10 to <a class="reference internal" href="#flask.app.Flask.app_ctx_globals_class" title="flask.app.Flask.app_ctx_globals_class"><code class="xref py py-attr docutils literal"><span class="pre">app_ctx_globals_class</span></code></a> because the
-flask.g object is now application context scoped.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">_AppCtxGlobals</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.auto_find_instance_path">
-<code class="descname">auto_find_instance_path</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.auto_find_instance_path"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.auto_find_instance_path" title="Permalink to this definition">¶</a></dt>
-<dd><p>Tries to locate the instance path if it was not provided to the
-constructor of the application class.  It will basically calculate
-the path to a folder named <code class="docutils literal"><span class="pre">instance</span></code> next to your main file or
-the package.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.before_first_request">
-<code class="descname">before_first_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.before_first_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.before_first_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a function to be run before the first request to this
-instance of the application.</p>
-<p>The function will be called without any arguments and its return
-value is ignored.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.before_first_request_funcs">
-<code class="descname">before_first_request_funcs</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.before_first_request_funcs" title="Permalink to this definition">¶</a></dt>
-<dd><p>A lists of functions that should be called at the beginning of the
-first request to this instance.  To register a function here, use
-the <a class="reference internal" href="#flask.app.Flask.before_first_request" title="flask.app.Flask.before_first_request"><code class="xref py py-meth docutils literal"><span class="pre">before_first_request()</span></code></a> decorator.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.before_request">
-<code class="descname">before_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.before_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.before_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a function to run before each request.</p>
-<p>The function will be called without any arguments.
-If the function returns a non-None value, it&#8217;s handled as
-if it was the return value from the view and further
-request handling is stopped.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.before_request_funcs">
-<code class="descname">before_request_funcs</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.before_request_funcs" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with lists of functions that should be called at the
-beginning of the request.  The key of the dictionary is the name of
-the blueprint this function is active for, <code class="docutils literal"><span class="pre">None</span></code> for all requests.
-This can for example be used to open database connections or
-getting hold of the currently logged in user.  To register a
-function here, use the <a class="reference internal" href="#flask.app.Flask.before_request" title="flask.app.Flask.before_request"><code class="xref py py-meth docutils literal"><span class="pre">before_request()</span></code></a> decorator.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.blueprints">
-<code class="descname">blueprints</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.blueprints" title="Permalink to this definition">¶</a></dt>
-<dd><p>all the attached blueprints in a dictionary by name.  Blueprints
-can be attached multiple times so this dictionary does not tell
-you how often they got attached.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.cli">
-<code class="descname">cli</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.cli" title="Permalink to this definition">¶</a></dt>
-<dd><p>The click command line context for this application.  Commands
-registered here show up in the <strong class="command">flask</strong> command once the
-application has been discovered.  The default commands are
-provided by Flask itself and can be overridden.</p>
-<p>This is an instance of a <code class="xref py py-class docutils literal"><span class="pre">click.Group</span></code> object.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.config">
-<code class="descname">config</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.config" title="Permalink to this definition">¶</a></dt>
-<dd><p>The configuration dictionary as <code class="xref py py-class docutils literal"><span class="pre">Config</span></code>.  This behaves
-exactly like a regular dictionary but supports additional methods
-to load a config from files.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.config_class">
-<code class="descname">config_class</code><a class="headerlink" href="#flask.app.Flask.config_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>The class that is used for the <code class="docutils literal"><span class="pre">config</span></code> attribute of this app.
-Defaults to <code class="xref py py-class docutils literal"><span class="pre">Config</span></code>.</p>
-<p>Example use cases for a custom class:</p>
-<ol class="arabic simple">
-<li>Default values for certain config options.</li>
-<li>Access to config values through attributes in addition to keys.</li>
-</ol>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">Config</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.context_processor">
-<code class="descname">context_processor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.context_processor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.context_processor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a template context processor function.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.create_global_jinja_loader">
-<code class="descname">create_global_jinja_loader</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.create_global_jinja_loader"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.create_global_jinja_loader" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates the loader for the Jinja2 environment.  Can be used to
-override just the loader and keeping the rest unchanged.  It&#8217;s
-discouraged to override this function.  Instead one should override
-the <code class="xref py py-meth docutils literal"><span class="pre">jinja_loader()</span></code> function instead.</p>
-<p>The global loader dispatches between the loaders of the application
-and the individual blueprints.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.create_jinja_environment">
-<code class="descname">create_jinja_environment</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.create_jinja_environment"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.create_jinja_environment" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates the Jinja2 environment based on <a class="reference internal" href="#flask.app.Flask.jinja_options" title="flask.app.Flask.jinja_options"><code class="xref py py-attr docutils literal"><span class="pre">jinja_options</span></code></a>
-and <a class="reference internal" href="#flask.app.Flask.select_jinja_autoescape" title="flask.app.Flask.select_jinja_autoescape"><code class="xref py py-meth docutils literal"><span class="pre">select_jinja_autoescape()</span></code></a>.  Since 0.7 this also adds
-the Jinja2 globals and filters after initialization.  Override
-this function to customize the behavior.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.5.</span></p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.11: </span><code class="docutils literal"><span class="pre">Environment.auto_reload</span></code> set in accordance with
-<code class="docutils literal"><span class="pre">TEMPLATES_AUTO_RELOAD</span></code> configuration option.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.create_url_adapter">
-<code class="descname">create_url_adapter</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.create_url_adapter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.create_url_adapter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a URL adapter for the given request.  The URL adapter
-is created at a point where the request context is not yet set up
-so the request is passed explicitly.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.6.</span></p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.9: </span>This can now also be called without a request object when the
-URL adapter is created for the application context.</p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.debug">
-<code class="descname">debug</code><a class="headerlink" href="#flask.app.Flask.debug" title="Permalink to this definition">¶</a></dt>
-<dd><p>The debug flag.  Set this to <code class="docutils literal"><span class="pre">True</span></code> to enable debugging of the
-application.  In debug mode the debugger will kick in when an unhandled
-exception occurs and the integrated server will automatically reload
-the application if changes in the code are detected.</p>
-<p>This attribute can also be configured from the config with the <code class="docutils literal"><span class="pre">DEBUG</span></code>
-configuration key.  Defaults to <code class="docutils literal"><span class="pre">False</span></code>.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.default_config">
-<code class="descname">default_config</code><em class="property"> = ImmutableDict({'JSON_AS_ASCII': True, 'PRESERVE_CONTEXT_ON_EXCEPTION': None, 'PERMANENT_SESSION_LIFETIME': datetime.timedelta(31), 'SESSION_COOKIE_SECURE': False, 'LOGGER_HANDLER_POLICY': 'always', 'SESSION_COOKIE_DOMAIN': None, 'SESSION_COOKIE_NAME': 'session', 'SESSION_REFRESH_EACH_REQUEST': True, 'TRAP_BAD_REQUEST_ERRORS': False, 'PREFERRED_URL_SCHEME': 'http', 'APPLICATION_ROOT': None, 'LOGGER_NAME': None, 'TEMPLATES_AUTO_RELOAD': None, 'EXPLAIN_TEMPLATE_LOADING': False, 'PROPAGATE_EXCEPTIONS': None, 'SESSION_COOKIE_HTTPONLY': True, 'JSON_SORT_KEYS': True, 'TESTING': False, 'TRAP_HTTP_EXCEPTIONS': False, 'SERVER_NAME': None, 'SECRET_KEY': None, 'USE_X_SENDFILE': False, 'DEBUG': False, 'MAX_CONTENT_LENGTH': None, 'SESSION_COOKIE_PATH': None, 'SEND_FILE_MAX_AGE_DEFAULT': datetime.timedelta(0, 43200), 'JSONIFY_MIMETYPE': 'application/json', 'JSONIFY_PRETTYPRINT_REGULAR': True})</em><a class="headerlink" href="#flask.app.Flask.default_config" title="Permalink to this definition">¶</a></dt>
-<dd><p>Default configuration parameters.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.dispatch_request">
-<code class="descname">dispatch_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.dispatch_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.dispatch_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Does the request dispatching.  Matches the URL and returns the
-return value of the view or error handler.  This does not have to
-be a response object.  In order to convert the return value to a
-proper response object, call <a class="reference internal" href="#flask.app.Flask.make_response" title="flask.app.Flask.make_response"><code class="xref py py-func docutils literal"><span class="pre">make_response()</span></code></a>.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.7: </span>This no longer does the exception handling, this code was
-moved to the new <a class="reference internal" href="#flask.app.Flask.full_dispatch_request" title="flask.app.Flask.full_dispatch_request"><code class="xref py py-meth docutils literal"><span class="pre">full_dispatch_request()</span></code></a>.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.do_teardown_appcontext">
-<code class="descname">do_teardown_appcontext</code><span class="sig-paren">(</span><em>exc=&lt;object object at 0x000001E1FDEFF7A0&gt;</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.do_teardown_appcontext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.do_teardown_appcontext" title="Permalink to this definition">¶</a></dt>
-<dd><p>Called when an application context is popped.  This works pretty
-much the same as <a class="reference internal" href="#flask.app.Flask.do_teardown_request" title="flask.app.Flask.do_teardown_request"><code class="xref py py-meth docutils literal"><span class="pre">do_teardown_request()</span></code></a> but for the application
-context.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.do_teardown_request">
-<code class="descname">do_teardown_request</code><span class="sig-paren">(</span><em>exc=&lt;object object at 0x000001E1FDEFF7A0&gt;</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.do_teardown_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.do_teardown_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Called after the actual request dispatching and will
-call every as <a class="reference internal" href="#flask.app.Flask.teardown_request" title="flask.app.Flask.teardown_request"><code class="xref py py-meth docutils literal"><span class="pre">teardown_request()</span></code></a> decorated function.  This is
-not actually called by the <a class="reference internal" href="#flask.app.Flask" title="flask.app.Flask"><code class="xref py py-class docutils literal"><span class="pre">Flask</span></code></a> object itself but is always
-triggered when the request context is popped.  That way we have a
-tighter control over certain resources under testing environments.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.9: </span>Added the <cite>exc</cite> argument.  Previously this was always using the
-current exception information.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.endpoint">
-<code class="descname">endpoint</code><span class="sig-paren">(</span><em>endpoint</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.endpoint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.endpoint" title="Permalink to this definition">¶</a></dt>
-<dd><p>A decorator to register a function as an endpoint.
-Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">endpoint</span><span class="p">(</span><span class="s1">&#39;example.endpoint&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">example</span><span class="p">():</span>
-    <span class="k">return</span> <span class="s2">&quot;example&quot;</span>
-</pre></div>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>endpoint</strong> &#8211; the name of the endpoint</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.error_handler_spec">
-<code class="descname">error_handler_spec</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.error_handler_spec" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary of all registered error handlers.  The key is <code class="docutils literal"><span class="pre">None</span></code>
-for error handlers active on the application, otherwise the key is
-the name of the blueprint.  Each key points to another dictionary
-where the key is the status code of the http exception.  The
-special key <code class="docutils literal"><span class="pre">None</span></code> points to a list of tuples where the first item
-is the class for the instance check and the second the error handler
-function.</p>
-<p>To register a error handler, use the <a class="reference internal" href="#flask.app.Flask.errorhandler" title="flask.app.Flask.errorhandler"><code class="xref py py-meth docutils literal"><span class="pre">errorhandler()</span></code></a>
-decorator.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.error_handlers">
-<code class="descname">error_handlers</code><a class="headerlink" href="#flask.app.Flask.error_handlers" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.errorhandler">
-<code class="descname">errorhandler</code><span class="sig-paren">(</span><em>code_or_exception</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.errorhandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.errorhandler" title="Permalink to this definition">¶</a></dt>
-<dd><p>A decorator that is used to register a function give a given
-error code.  Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">errorhandler</span><span class="p">(</span><span class="mi">404</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">page_not_found</span><span class="p">(</span><span class="n">error</span><span class="p">):</span>
-    <span class="k">return</span> <span class="s1">&#39;This page does not exist&#39;</span><span class="p">,</span> <span class="mi">404</span>
-</pre></div>
-</div>
-<p>You can also register handlers for arbitrary exceptions:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">errorhandler</span><span class="p">(</span><span class="n">DatabaseError</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">special_exception_handler</span><span class="p">(</span><span class="n">error</span><span class="p">):</span>
-    <span class="k">return</span> <span class="s1">&#39;Database connection failed&#39;</span><span class="p">,</span> <span class="mi">500</span>
-</pre></div>
-</div>
-<p>You can also register a function as error handler without using
-the <a class="reference internal" href="#flask.app.Flask.errorhandler" title="flask.app.Flask.errorhandler"><code class="xref py py-meth docutils literal"><span class="pre">errorhandler()</span></code></a> decorator.  The following example is
-equivalent to the one above:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">page_not_found</span><span class="p">(</span><span class="n">error</span><span class="p">):</span>
-    <span class="k">return</span> <span class="s1">&#39;This page does not exist&#39;</span><span class="p">,</span> <span class="mi">404</span>
-<span class="n">app</span><span class="o">.</span><span class="n">error_handler_spec</span><span class="p">[</span><span class="kc">None</span><span class="p">][</span><span class="mi">404</span><span class="p">]</span> <span class="o">=</span> <span class="n">page_not_found</span>
-</pre></div>
-</div>
-<p>Setting error handlers via assignments to <a class="reference internal" href="#flask.app.Flask.error_handler_spec" title="flask.app.Flask.error_handler_spec"><code class="xref py py-attr docutils literal"><span class="pre">error_handler_spec</span></code></a>
-however is discouraged as it requires fiddling with nested dictionaries
-and the special case for arbitrary exception types.</p>
-<p>The first <code class="docutils literal"><span class="pre">None</span></code> refers to the active blueprint.  If the error
-handler should be application wide <code class="docutils literal"><span class="pre">None</span></code> shall be used.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7: </span>Use <a class="reference internal" href="#flask.app.Flask.register_error_handler" title="flask.app.Flask.register_error_handler"><code class="xref py py-meth docutils literal"><span class="pre">register_error_handler()</span></code></a> instead of modifying
-<a class="reference internal" href="#flask.app.Flask.error_handler_spec" title="flask.app.Flask.error_handler_spec"><code class="xref py py-attr docutils literal"><span class="pre">error_handler_spec</span></code></a> directly, for application wide error
-handlers.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7: </span>One can now additionally also register custom exception types
-that do not necessarily have to be a subclass of the
-<code class="xref py py-class docutils literal"><span class="pre">HTTPException</span></code> class.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>code</strong> &#8211; the code as integer for the handler</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.extensions">
-<code class="descname">extensions</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.extensions" title="Permalink to this definition">¶</a></dt>
-<dd><p>a place where extensions can store application specific state.  For
-example this is where an extension could store database engines and
-similar things.  For backwards compatibility extensions should register
-themselves like this:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="ow">not</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">app</span><span class="p">,</span> <span class="s1">&#39;extensions&#39;</span><span class="p">):</span>
-    <span class="n">app</span><span class="o">.</span><span class="n">extensions</span> <span class="o">=</span> <span class="p">{}</span>
-<span class="n">app</span><span class="o">.</span><span class="n">extensions</span><span class="p">[</span><span class="s1">&#39;extensionname&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">SomeObject</span><span class="p">()</span>
-</pre></div>
-</div>
-<p>The key must match the name of the extension module. For example in
-case of a &#8220;Flask-Foo&#8221; extension in <cite>flask_foo</cite>, the key would be
-<code class="docutils literal"><span class="pre">'foo'</span></code>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.full_dispatch_request">
-<code class="descname">full_dispatch_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.full_dispatch_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.full_dispatch_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Dispatches the request and on top of that performs request
-pre and postprocessing as well as HTTP exception catching and
-error handling.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.got_first_request">
-<code class="descname">got_first_request</code><a class="headerlink" href="#flask.app.Flask.got_first_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>This attribute is set to <code class="docutils literal"><span class="pre">True</span></code> if the application started
-handling the first request.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.handle_exception">
-<code class="descname">handle_exception</code><span class="sig-paren">(</span><em>e</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.handle_exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.handle_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>Default exception handling that kicks in when an exception
-occurs that is not caught.  In debug mode the exception will
-be re-raised immediately, otherwise it is logged and the handler
-for a 500 internal server error is used.  If no such handler
-exists, a default 500 internal server error message is displayed.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.3.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.handle_http_exception">
-<code class="descname">handle_http_exception</code><span class="sig-paren">(</span><em>e</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.handle_http_exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.handle_http_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>Handles an HTTP exception.  By default this will invoke the
-registered error handlers and fall back to returning the
-exception as response.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.3.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.handle_url_build_error">
-<code class="descname">handle_url_build_error</code><span class="sig-paren">(</span><em>error</em>, <em>endpoint</em>, <em>values</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.handle_url_build_error"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.handle_url_build_error" title="Permalink to this definition">¶</a></dt>
-<dd><p>Handle <code class="xref py py-class docutils literal"><span class="pre">BuildError</span></code> on <code class="xref py py-meth docutils literal"><span class="pre">url_for()</span></code>.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.handle_user_exception">
-<code class="descname">handle_user_exception</code><span class="sig-paren">(</span><em>e</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.handle_user_exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.handle_user_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>This method is called whenever an exception occurs that should be
-handled.  A special case are
-<code class="xref py py-class docutils literal"><span class="pre">HTTPException</span></code>s which are forwarded by
-this function to the <a class="reference internal" href="#flask.app.Flask.handle_http_exception" title="flask.app.Flask.handle_http_exception"><code class="xref py py-meth docutils literal"><span class="pre">handle_http_exception()</span></code></a> method.  This
-function will either return a response value or reraise the
-exception with the same traceback.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.init_jinja_globals">
-<code class="descname">init_jinja_globals</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.init_jinja_globals"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.init_jinja_globals" title="Permalink to this definition">¶</a></dt>
-<dd><p>Deprecated.  Used to initialize the Jinja2 globals.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.5.</span></p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.7: </span>This method is deprecated with 0.7.  Override
-<a class="reference internal" href="#flask.app.Flask.create_jinja_environment" title="flask.app.Flask.create_jinja_environment"><code class="xref py py-meth docutils literal"><span class="pre">create_jinja_environment()</span></code></a> instead.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.inject_url_defaults">
-<code class="descname">inject_url_defaults</code><span class="sig-paren">(</span><em>endpoint</em>, <em>values</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.inject_url_defaults"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.inject_url_defaults" title="Permalink to this definition">¶</a></dt>
-<dd><p>Injects the URL defaults for the given endpoint directly into
-the values dictionary passed.  This is used internally and
-automatically called on URL building.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.instance_path">
-<code class="descname">instance_path</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.instance_path" title="Permalink to this definition">¶</a></dt>
-<dd><p>Holds the path to the instance folder.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.iter_blueprints">
-<code class="descname">iter_blueprints</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.iter_blueprints"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.iter_blueprints" title="Permalink to this definition">¶</a></dt>
-<dd><p>Iterates over all blueprints by the order they were registered.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.jinja_env">
-<code class="descname">jinja_env</code><a class="reference internal" href="../_modules/flask/app.html#Flask.jinja_env"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.jinja_env" title="Permalink to this definition">¶</a></dt>
-<dd><p>The Jinja2 environment used to load templates.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.jinja_environment">
-<code class="descname">jinja_environment</code><a class="headerlink" href="#flask.app.Flask.jinja_environment" title="Permalink to this definition">¶</a></dt>
-<dd><p>The class that is used for the Jinja environment.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">Environment</span></code></p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.jinja_options">
-<code class="descname">jinja_options</code><em class="property"> = ImmutableDict({'extensions': ['jinja2.ext.autoescape', 'jinja2.ext.with_']})</em><a class="headerlink" href="#flask.app.Flask.jinja_options" title="Permalink to this definition">¶</a></dt>
-<dd><p>Options that are passed directly to the Jinja2 environment.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.json_decoder">
-<code class="descname">json_decoder</code><a class="headerlink" href="#flask.app.Flask.json_decoder" title="Permalink to this definition">¶</a></dt>
-<dd><p>The JSON decoder class to use.  Defaults to <a class="reference internal" href="#flask.json.JSONDecoder" title="flask.json.JSONDecoder"><code class="xref py py-class docutils literal"><span class="pre">JSONDecoder</span></code></a>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">JSONDecoder</span></code></p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.json_encoder">
-<code class="descname">json_encoder</code><a class="headerlink" href="#flask.app.Flask.json_encoder" title="Permalink to this definition">¶</a></dt>
-<dd><p>The JSON encoder class to use.  Defaults to <a class="reference internal" href="#flask.json.JSONEncoder" title="flask.json.JSONEncoder"><code class="xref py py-class docutils literal"><span class="pre">JSONEncoder</span></code></a>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">JSONEncoder</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.log_exception">
-<code class="descname">log_exception</code><span class="sig-paren">(</span><em>exc_info</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.log_exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.log_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>Logs an exception.  This is called by <a class="reference internal" href="#flask.app.Flask.handle_exception" title="flask.app.Flask.handle_exception"><code class="xref py py-meth docutils literal"><span class="pre">handle_exception()</span></code></a>
-if debugging is disabled and right before the handler is called.
-The default implementation logs the exception as error on the
-<a class="reference internal" href="#flask.app.Flask.logger" title="flask.app.Flask.logger"><code class="xref py py-attr docutils literal"><span class="pre">logger</span></code></a>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.logger">
-<code class="descname">logger</code><a class="headerlink" href="#flask.app.Flask.logger" title="Permalink to this definition">¶</a></dt>
-<dd><p>A <code class="xref py py-class docutils literal"><span class="pre">logging.Logger</span></code> object for this application.  The
-default configuration is to log to stderr if the application is
-in debug mode.  This logger can be used to (surprise) log messages.
-Here some examples:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s1">&#39;A value for debugging&#39;</span><span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s1">&#39;A warning occurred (</span><span class="si">%d</span><span class="s1"> apples)&#39;</span><span class="p">,</span> <span class="mi">42</span><span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s1">&#39;An error occurred&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.3.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.logger_name">
-<code class="descname">logger_name</code><a class="headerlink" href="#flask.app.Flask.logger_name" title="Permalink to this definition">¶</a></dt>
-<dd><p>The name of the logger to use.  By default the logger name is the
-package name passed to the constructor.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.4.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.make_config">
-<code class="descname">make_config</code><span class="sig-paren">(</span><em>instance_relative=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.make_config"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.make_config" title="Permalink to this definition">¶</a></dt>
-<dd><p>Used to create the config attribute by the Flask constructor.
-The <cite>instance_relative</cite> parameter is passed in from the constructor
-of Flask (there named <cite>instance_relative_config</cite>) and indicates if
-the config should be relative to the instance path or the root path
-of the application.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.make_default_options_response">
-<code class="descname">make_default_options_response</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.make_default_options_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.make_default_options_response" title="Permalink to this definition">¶</a></dt>
-<dd><p>This method is called to create the default <code class="docutils literal"><span class="pre">OPTIONS</span></code> response.
-This can be changed through subclassing to change the default
-behavior of <code class="docutils literal"><span class="pre">OPTIONS</span></code> responses.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.make_null_session">
-<code class="descname">make_null_session</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.make_null_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.make_null_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a new instance of a missing session.  Instead of overriding
-this method we recommend replacing the <a class="reference internal" href="#flask.app.Flask.session_interface" title="flask.app.Flask.session_interface"><code class="xref py py-class docutils literal"><span class="pre">session_interface</span></code></a>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.make_response">
-<code class="descname">make_response</code><span class="sig-paren">(</span><em>rv</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.make_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.make_response" title="Permalink to this definition">¶</a></dt>
-<dd><p>Converts the return value from a view function to a real
-response object that is an instance of <a class="reference internal" href="#flask.app.Flask.response_class" title="flask.app.Flask.response_class"><code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code></a>.</p>
-<p>The following types are allowed for <cite>rv</cite>:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="35%" />
-<col width="65%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><a class="reference internal" href="#flask.app.Flask.response_class" title="flask.app.Flask.response_class"><code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code></a></td>
-<td>the object is returned unchanged</td>
-</tr>
-<tr class="row-even"><td><code class="xref py py-class docutils literal"><span class="pre">str</span></code></td>
-<td>a response object is created with the
-string as body</td>
-</tr>
-<tr class="row-odd"><td><code class="xref py py-class docutils literal"><span class="pre">unicode</span></code></td>
-<td>a response object is created with the
-string encoded to utf-8 as body</td>
-</tr>
-<tr class="row-even"><td>a WSGI function</td>
-<td>the function is called as WSGI application
-and buffered as response object</td>
-</tr>
-<tr class="row-odd"><td><code class="xref py py-class docutils literal"><span class="pre">tuple</span></code></td>
-<td>A tuple in the form <code class="docutils literal"><span class="pre">(response,</span> <span class="pre">status,</span>
-<span class="pre">headers)</span></code> or <code class="docutils literal"><span class="pre">(response,</span> <span class="pre">headers)</span></code>
-where <cite>response</cite> is any of the
-types defined here, <cite>status</cite> is a string
-or an integer and <cite>headers</cite> is a list or
-a dictionary with header values.</td>
-</tr>
-</tbody>
-</table>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>rv</strong> &#8211; the return value from the view function</td>
-</tr>
-</tbody>
-</table>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.9: </span>Previously a tuple was interpreted as the arguments for the
-response object.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.make_shell_context">
-<code class="descname">make_shell_context</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.make_shell_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.make_shell_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns the shell context for an interactive shell for this
-application.  This runs all the registered shell context
-processors.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.name">
-<code class="descname">name</code><a class="reference internal" href="../_modules/flask/app.html#Flask.name"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.name" title="Permalink to this definition">¶</a></dt>
-<dd><p>The name of the application.  This is usually the import name
-with the difference that it&#8217;s guessed from the run file if the
-import name is main.  This name is used as a display name when
-Flask needs the name of the application.  It can be set and overridden
-to change the value.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.open_instance_resource">
-<code class="descname">open_instance_resource</code><span class="sig-paren">(</span><em>resource</em>, <em>mode='rb'</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.open_instance_resource"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.open_instance_resource" title="Permalink to this definition">¶</a></dt>
-<dd><p>Opens a resource from the application&#8217;s instance folder
-(<a class="reference internal" href="#flask.app.Flask.instance_path" title="flask.app.Flask.instance_path"><code class="xref py py-attr docutils literal"><span class="pre">instance_path</span></code></a>).  Otherwise works like
-<code class="xref py py-meth docutils literal"><span class="pre">open_resource()</span></code>.  Instance resources can also be opened for
-writing.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>resource</strong> &#8211; the name of the resource.  To access resources within
-subfolders use forward slashes as separator.</li>
-<li><strong>mode</strong> &#8211; resource file opening mode, default is &#8216;rb&#8217;.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.open_session">
-<code class="descname">open_session</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.open_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.open_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates or opens a new session.  Default implementation stores all
-session data in a signed cookie.  This requires that the
-<a class="reference internal" href="#flask.app.Flask.secret_key" title="flask.app.Flask.secret_key"><code class="xref py py-attr docutils literal"><span class="pre">secret_key</span></code></a> is set.  Instead of overriding this method
-we recommend replacing the <a class="reference internal" href="#flask.app.Flask.session_interface" title="flask.app.Flask.session_interface"><code class="xref py py-class docutils literal"><span class="pre">session_interface</span></code></a>.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>request</strong> &#8211; an instance of <a class="reference internal" href="#flask.app.Flask.request_class" title="flask.app.Flask.request_class"><code class="xref py py-attr docutils literal"><span class="pre">request_class</span></code></a>.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.permanent_session_lifetime">
-<code class="descname">permanent_session_lifetime</code><a class="headerlink" href="#flask.app.Flask.permanent_session_lifetime" title="Permalink to this definition">¶</a></dt>
-<dd><p>A <code class="xref py py-class docutils literal"><span class="pre">timedelta</span></code> which is used to set the expiration
-date of a permanent session.  The default is 31 days which makes a
-permanent session survive for roughly one month.</p>
-<p>This attribute can also be configured from the config with the
-<code class="docutils literal"><span class="pre">PERMANENT_SESSION_LIFETIME</span></code> configuration key.  Defaults to
-<code class="docutils literal"><span class="pre">timedelta(days=31)</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.preprocess_request">
-<code class="descname">preprocess_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.preprocess_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.preprocess_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Called before the actual request dispatching and will
-call each <a class="reference internal" href="#flask.app.Flask.before_request" title="flask.app.Flask.before_request"><code class="xref py py-meth docutils literal"><span class="pre">before_request()</span></code></a> decorated function, passing no
-arguments.
-If any of these functions returns a value, it&#8217;s handled as
-if it was the return value from the view and further
-request handling is stopped.</p>
-<p>This also triggers the <code class="xref py py-meth docutils literal"><span class="pre">url_value_processor()</span></code> functions before
-the actual <a class="reference internal" href="#flask.app.Flask.before_request" title="flask.app.Flask.before_request"><code class="xref py py-meth docutils literal"><span class="pre">before_request()</span></code></a> functions are called.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.preserve_context_on_exception">
-<code class="descname">preserve_context_on_exception</code><a class="headerlink" href="#flask.app.Flask.preserve_context_on_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns the value of the <code class="docutils literal"><span class="pre">PRESERVE_CONTEXT_ON_EXCEPTION</span></code>
-configuration value in case it&#8217;s set, otherwise a sensible default
-is returned.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.process_response">
-<code class="descname">process_response</code><span class="sig-paren">(</span><em>response</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.process_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.process_response" title="Permalink to this definition">¶</a></dt>
-<dd><p>Can be overridden in order to modify the response object
-before it&#8217;s sent to the WSGI server.  By default this will
-call all the <a class="reference internal" href="#flask.app.Flask.after_request" title="flask.app.Flask.after_request"><code class="xref py py-meth docutils literal"><span class="pre">after_request()</span></code></a> decorated functions.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.5: </span>As of Flask 0.5 the functions registered for after request
-execution are called in reverse order of registration.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>response</strong> &#8211; a <a class="reference internal" href="#flask.app.Flask.response_class" title="flask.app.Flask.response_class"><code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code></a> object.</td>
-</tr>
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">a new response object or the same, has to be an
-instance of <a class="reference internal" href="#flask.app.Flask.response_class" title="flask.app.Flask.response_class"><code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code></a>.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.propagate_exceptions">
-<code class="descname">propagate_exceptions</code><a class="headerlink" href="#flask.app.Flask.propagate_exceptions" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns the value of the <code class="docutils literal"><span class="pre">PROPAGATE_EXCEPTIONS</span></code> configuration
-value in case it&#8217;s set, otherwise a sensible default is returned.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.raise_routing_exception">
-<code class="descname">raise_routing_exception</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.raise_routing_exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.raise_routing_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>Exceptions that are recording during routing are reraised with
-this method.  During debug we are not reraising redirect requests
-for non <code class="docutils literal"><span class="pre">GET</span></code>, <code class="docutils literal"><span class="pre">HEAD</span></code>, or <code class="docutils literal"><span class="pre">OPTIONS</span></code> requests and we&#8217;re raising
-a different error instead to help debug situations.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Internal:</th><td class="field-body"></td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.register_blueprint">
-<code class="descname">register_blueprint</code><span class="sig-paren">(</span><em>blueprint</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.register_blueprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.register_blueprint" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a blueprint on the application. For information about 
-blueprints head over to <span class="xref std std-ref">blueprints</span>.</p>
-<p>The blueprint name is passed in as the first argument.  
-Options are passed as additional keyword arguments and forwarded to 
-<cite>blueprints</cite> in an &#8220;options&#8221; dictionary.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>subdomain</strong> &#8211; set a subdomain for the blueprint</li>
-<li><strong>url_prefix</strong> &#8211; set the prefix for all URLs defined on the blueprint.
-<code class="docutils literal"><span class="pre">(url_prefix='/&lt;lang</span> <span class="pre">code&gt;')</span></code></li>
-<li><strong>url_defaults</strong> &#8211; a dictionary with URL defaults that is added to 
-each and every URL defined with this blueprint</li>
-<li><strong>static_folder</strong> &#8211; add a static folder to urls in this blueprint</li>
-<li><strong>static_url_path</strong> &#8211; add a static url path to urls in this blueprint</li>
-<li><strong>template_folder</strong> &#8211; set an alternate template folder</li>
-<li><strong>root_path</strong> &#8211; set an alternate root path for this blueprint</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.register_error_handler">
-<code class="descname">register_error_handler</code><span class="sig-paren">(</span><em>code_or_exception</em>, <em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.register_error_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.register_error_handler" title="Permalink to this definition">¶</a></dt>
-<dd><p>Alternative error attach function to the <a class="reference internal" href="#flask.app.Flask.errorhandler" title="flask.app.Flask.errorhandler"><code class="xref py py-meth docutils literal"><span class="pre">errorhandler()</span></code></a>
-decorator that is more straightforward to use for non decorator
-usage.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.request_class">
-<code class="descname">request_class</code><a class="headerlink" href="#flask.app.Flask.request_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>The class that is used for request objects.  See <code class="xref py py-class docutils literal"><span class="pre">Request</span></code>
-for more information.</p>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">Request</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.request_context">
-<code class="descname">request_context</code><span class="sig-paren">(</span><em>environ</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.request_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.request_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a <a class="reference internal" href="#flask.ctx.RequestContext" title="flask.ctx.RequestContext"><code class="xref py py-class docutils literal"><span class="pre">RequestContext</span></code></a> from the given
-environment and binds it to the current context.  This must be used in
-combination with the <code class="docutils literal"><span class="pre">with</span></code> statement because the request is only bound
-to the current context for the duration of the <code class="docutils literal"><span class="pre">with</span></code> block.</p>
-<p>Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">with</span> <span class="n">app</span><span class="o">.</span><span class="n">request_context</span><span class="p">(</span><span class="n">environ</span><span class="p">):</span>
-    <span class="n">do_something_with</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>The object returned can also be used without the <code class="docutils literal"><span class="pre">with</span></code> statement
-which is useful for working in the shell.  The example above is
-doing exactly the same as this code:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ctx</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">request_context</span><span class="p">(</span><span class="n">environ</span><span class="p">)</span>
-<span class="n">ctx</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-<span class="k">try</span><span class="p">:</span>
-    <span class="n">do_something_with</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
-<span class="k">finally</span><span class="p">:</span>
-    <span class="n">ctx</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-</pre></div>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.3: </span>Added support for non-with statement usage and <code class="docutils literal"><span class="pre">with</span></code> statement
-is now passed the ctx object.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>environ</strong> &#8211; a WSGI environment</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.request_globals_class">
-<code class="descname">request_globals_class</code><a class="headerlink" href="#flask.app.Flask.request_globals_class" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.response_class">
-<code class="descname">response_class</code><a class="headerlink" href="#flask.app.Flask.response_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>The class that is used for response objects.  See
-<code class="xref py py-class docutils literal"><span class="pre">Response</span></code> for more information.</p>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">Response</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.route">
-<code class="descname">route</code><span class="sig-paren">(</span><em>rule</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.route"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.route" title="Permalink to this definition">¶</a></dt>
-<dd><p>A decorator that is used to register a view function for a
-given URL rule.  This does the same thing as <a class="reference internal" href="#flask.app.Flask.add_url_rule" title="flask.app.Flask.add_url_rule"><code class="xref py py-meth docutils literal"><span class="pre">add_url_rule()</span></code></a>
-but is intended for decorator usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="k">return</span> <span class="s1">&#39;Hello World&#39;</span>
-</pre></div>
-</div>
-<p>For more information refer to <span class="xref std std-ref">url-route-registrations</span>.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>rule</strong> &#8211; the URL rule as string</li>
-<li><strong>endpoint</strong> &#8211; the endpoint for the registered URL rule.  Flask
-itself assumes the name of the view function as
-endpoint</li>
-<li><strong>options</strong> &#8211; the options to be forwarded to the underlying
-<code class="xref py py-class docutils literal"><span class="pre">Rule</span></code> object.  A change
-to Werkzeug is handling of method options.  methods
-is a list of methods this rule should be limited
-to (<code class="docutils literal"><span class="pre">GET</span></code>, <code class="docutils literal"><span class="pre">POST</span></code> etc.).  By default a rule
-just listens for <code class="docutils literal"><span class="pre">GET</span></code> (and implicitly <code class="docutils literal"><span class="pre">HEAD</span></code>).
-Starting with Flask 0.6, <code class="docutils literal"><span class="pre">OPTIONS</span></code> is implicitly
-added and handled by the standard request handling.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.run">
-<code class="descname">run</code><span class="sig-paren">(</span><em>host=None</em>, <em>port=None</em>, <em>debug=None</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.run"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.run" title="Permalink to this definition">¶</a></dt>
-<dd><p>Runs the application on a local development server.</p>
-<p>Do not use <code class="docutils literal"><span class="pre">run()</span></code> in a production setting. It is not intended to
-meet security and performance requirements for a production server.
-Instead, see <span class="xref std std-ref">deployment</span> for WSGI server recommendations.</p>
-<p>If the <a class="reference internal" href="#flask.app.Flask.debug" title="flask.app.Flask.debug"><code class="xref py py-attr docutils literal"><span class="pre">debug</span></code></a> flag is set the server will automatically reload
-for code changes and show a debugger in case an exception happened.</p>
-<p>If you want to run the application in debug mode, but disable the
-code execution on the interactive debugger, you can pass
-<code class="docutils literal"><span class="pre">use_evalex=False</span></code> as parameter.  This will keep the debugger&#8217;s
-traceback screen active, but disable code execution.</p>
-<p>It is not recommended to use this function for development with
-automatic reloading as this is badly supported.  Instead you should
-be using the <strong class="command">flask</strong> command line script&#8217;s <code class="docutils literal"><span class="pre">run</span></code> support.</p>
-<div class="admonition-keep-in-mind admonition">
-<p class="first admonition-title">Keep in Mind</p>
-<p class="last">Flask will suppress any server error with a generic error page
-unless it is in debug mode.  As such to enable just the
-interactive debugger without the code reloading, you have to
-invoke <a class="reference internal" href="#flask.app.Flask.run" title="flask.app.Flask.run"><code class="xref py py-meth docutils literal"><span class="pre">run()</span></code></a> with <code class="docutils literal"><span class="pre">debug=True</span></code> and <code class="docutils literal"><span class="pre">use_reloader=False</span></code>.
-Setting <code class="docutils literal"><span class="pre">use_debugger</span></code> to <code class="docutils literal"><span class="pre">True</span></code> without being in debug mode
-won&#8217;t catch any exceptions because there won&#8217;t be any to
-catch.</p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.10: </span>The default port is now picked from the <code class="docutils literal"><span class="pre">SERVER_NAME</span></code> variable.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>host</strong> &#8211; the hostname to listen on. Set this to <code class="docutils literal"><span class="pre">'0.0.0.0'</span></code> to
-have the server available externally as well. Defaults to
-<code class="docutils literal"><span class="pre">'127.0.0.1'</span></code>.</li>
-<li><strong>port</strong> &#8211; the port of the webserver. Defaults to <code class="docutils literal"><span class="pre">5000</span></code> or the
-port defined in the <code class="docutils literal"><span class="pre">SERVER_NAME</span></code> config variable if
-present.</li>
-<li><strong>debug</strong> &#8211; if given, enable or disable debug mode.
-See <a class="reference internal" href="#flask.app.Flask.debug" title="flask.app.Flask.debug"><code class="xref py py-attr docutils literal"><span class="pre">debug</span></code></a>.</li>
-<li><strong>options</strong> &#8211; the options to be forwarded to the underlying
-Werkzeug server.  See
-<code class="xref py py-func docutils literal"><span class="pre">werkzeug.serving.run_simple()</span></code> for more
-information.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.save_session">
-<code class="descname">save_session</code><span class="sig-paren">(</span><em>session</em>, <em>response</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.save_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.save_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>Saves the session if it needs updates.  For the default
-implementation, check <a class="reference internal" href="#flask.app.Flask.open_session" title="flask.app.Flask.open_session"><code class="xref py py-meth docutils literal"><span class="pre">open_session()</span></code></a>.  Instead of overriding this
-method we recommend replacing the <a class="reference internal" href="#flask.app.Flask.session_interface" title="flask.app.Flask.session_interface"><code class="xref py py-class docutils literal"><span class="pre">session_interface</span></code></a>.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>session</strong> &#8211; the session to be saved (a
-<code class="xref py py-class docutils literal"><span class="pre">SecureCookie</span></code>
-object)</li>
-<li><strong>response</strong> &#8211; an instance of <a class="reference internal" href="#flask.app.Flask.response_class" title="flask.app.Flask.response_class"><code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code></a></li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.secret_key">
-<code class="descname">secret_key</code><a class="headerlink" href="#flask.app.Flask.secret_key" title="Permalink to this definition">¶</a></dt>
-<dd><p>If a secret key is set, cryptographic components can use this to
-sign cookies and other things.  Set this to a complex random value
-when you want to use the secure cookie for instance.</p>
-<p>This attribute can also be configured from the config with the
-<code class="docutils literal"><span class="pre">SECRET_KEY</span></code> configuration key.  Defaults to <code class="docutils literal"><span class="pre">None</span></code>.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.select_jinja_autoescape">
-<code class="descname">select_jinja_autoescape</code><span class="sig-paren">(</span><em>filename</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.select_jinja_autoescape"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.select_jinja_autoescape" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns <code class="docutils literal"><span class="pre">True</span></code> if autoescaping should be active for the given
-template name. If no template name is given, returns <cite>True</cite>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.5.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.send_file_max_age_default">
-<code class="descname">send_file_max_age_default</code><a class="headerlink" href="#flask.app.Flask.send_file_max_age_default" title="Permalink to this definition">¶</a></dt>
-<dd><p>A <code class="xref py py-class docutils literal"><span class="pre">timedelta</span></code> which is used as default cache_timeout
-for the <code class="xref py py-func docutils literal"><span class="pre">send_file()</span></code> functions. The default is 12 hours.</p>
-<p>This attribute can also be configured from the config with the
-<code class="docutils literal"><span class="pre">SEND_FILE_MAX_AGE_DEFAULT</span></code> configuration key. This configuration
-variable can also be set with an integer value used as seconds.
-Defaults to <code class="docutils literal"><span class="pre">timedelta(hours=12)</span></code></p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.session_cookie_name">
-<code class="descname">session_cookie_name</code><a class="headerlink" href="#flask.app.Flask.session_cookie_name" title="Permalink to this definition">¶</a></dt>
-<dd><p>The secure cookie uses this for the name of the session cookie.</p>
-<p>This attribute can also be configured from the config with the
-<code class="docutils literal"><span class="pre">SESSION_COOKIE_NAME</span></code> configuration key.  Defaults to <code class="docutils literal"><span class="pre">'session'</span></code></p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.session_interface">
-<code class="descname">session_interface</code><em class="property"> = &lt;flask.sessions.SecureCookieSessionInterface object at 0x000001E1821AB278&gt;</em><a class="headerlink" href="#flask.app.Flask.session_interface" title="Permalink to this definition">¶</a></dt>
-<dd><p>the session interface to use.  By default an instance of
-<a class="reference internal" href="#flask.sessions.SecureCookieSessionInterface" title="flask.sessions.SecureCookieSessionInterface"><code class="xref py py-class docutils literal"><span class="pre">SecureCookieSessionInterface</span></code></a> is used here.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.shell_context_processor">
-<code class="descname">shell_context_processor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.shell_context_processor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.shell_context_processor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a shell context processor function.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.shell_context_processors">
-<code class="descname">shell_context_processors</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.shell_context_processors" title="Permalink to this definition">¶</a></dt>
-<dd><p>A list of shell context processor functions that should be run
-when a shell context is created.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.should_ignore_error">
-<code class="descname">should_ignore_error</code><span class="sig-paren">(</span><em>error</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.should_ignore_error"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.should_ignore_error" title="Permalink to this definition">¶</a></dt>
-<dd><p>This is called to figure out if an error should be ignored
-or not as far as the teardown system is concerned.  If this
-function returns <code class="docutils literal"><span class="pre">True</span></code> then the teardown handlers will not be
-passed the error.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.teardown_appcontext">
-<code class="descname">teardown_appcontext</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.teardown_appcontext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.teardown_appcontext" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a function to be called when the application context
-ends.  These functions are typically also called when the request
-context is popped.</p>
-<p>Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ctx</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">app_context</span><span class="p">()</span>
-<span class="n">ctx</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-<span class="o">...</span>
-<span class="n">ctx</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-</pre></div>
-</div>
-<p>When <code class="docutils literal"><span class="pre">ctx.pop()</span></code> is executed in the above example, the teardown
-functions are called just before the app context moves from the
-stack of active contexts.  This becomes relevant if you are using
-such constructs in tests.</p>
-<p>Since a request context typically also manages an application
-context it would also be called when you pop a request context.</p>
-<p>When a teardown function was called because of an exception it will
-be passed an error object.</p>
-<p>The return values of teardown functions are ignored.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.teardown_appcontext_funcs">
-<code class="descname">teardown_appcontext_funcs</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.teardown_appcontext_funcs" title="Permalink to this definition">¶</a></dt>
-<dd><p>A list of functions that are called when the application context
-is destroyed.  Since the application context is also torn down
-if the request ends this is the place to store code that disconnects
-from databases.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.teardown_request">
-<code class="descname">teardown_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.teardown_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.teardown_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a function to be run at the end of each request,
-regardless of whether there was an exception or not.  These functions
-are executed when the request context is popped, even if not an
-actual request was performed.</p>
-<p>Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ctx</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">test_request_context</span><span class="p">()</span>
-<span class="n">ctx</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
-<span class="o">...</span>
-<span class="n">ctx</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-</pre></div>
-</div>
-<p>When <code class="docutils literal"><span class="pre">ctx.pop()</span></code> is executed in the above example, the teardown
-functions are called just before the request context moves from the
-stack of active contexts.  This becomes relevant if you are using
-such constructs in tests.</p>
-<p>Generally teardown functions must take every necessary step to avoid
-that they will fail.  If they do execute code that might fail they
-will have to surround the execution of these code by try/except
-statements and log occurring errors.</p>
-<p>When a teardown function was called because of a exception it will
-be passed an error object.</p>
-<p>The return values of teardown functions are ignored.</p>
-<div class="admonition-debug-note admonition">
-<p class="first admonition-title">Debug Note</p>
-<p class="last">In debug mode Flask will not tear down a request on an exception
-immediately.  Instead it will keep it alive so that the interactive
-debugger can still access it.  This behavior can be controlled
-by the <code class="docutils literal"><span class="pre">PRESERVE_CONTEXT_ON_EXCEPTION</span></code> configuration variable.</p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.teardown_request_funcs">
-<code class="descname">teardown_request_funcs</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.teardown_request_funcs" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with lists of functions that are called after
-each request, even if an exception has occurred. The key of the
-dictionary is the name of the blueprint this function is active for,
-<code class="docutils literal"><span class="pre">None</span></code> for all requests. These functions are not allowed to modify
-the request, and their return values are ignored. If an exception
-occurred while processing the request, it gets passed to each
-teardown_request function. To register a function here, use the
-<a class="reference internal" href="#flask.app.Flask.teardown_request" title="flask.app.Flask.teardown_request"><code class="xref py py-meth docutils literal"><span class="pre">teardown_request()</span></code></a> decorator.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.template_context_processors">
-<code class="descname">template_context_processors</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.template_context_processors" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with list of functions that are called without argument
-to populate the template context.  The key of the dictionary is the
-name of the blueprint this function is active for, <code class="docutils literal"><span class="pre">None</span></code> for all
-requests.  Each returns a dictionary that the template context is
-updated with.  To register a function here, use the
-<a class="reference internal" href="#flask.app.Flask.context_processor" title="flask.app.Flask.context_processor"><code class="xref py py-meth docutils literal"><span class="pre">context_processor()</span></code></a> decorator.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.template_filter">
-<code class="descname">template_filter</code><span class="sig-paren">(</span><em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.template_filter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.template_filter" title="Permalink to this definition">¶</a></dt>
-<dd><p>A decorator that is used to register custom template filter.
-You can specify a name for the filter, otherwise the function
-name will be used. Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">template_filter</span><span class="p">()</span>
-<span class="k">def</span> <span class="nf">reverse</span><span class="p">(</span><span class="n">s</span><span class="p">):</span>
-    <span class="k">return</span> <span class="n">s</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</pre></div>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the filter, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.template_global">
-<code class="descname">template_global</code><span class="sig-paren">(</span><em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.template_global"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.template_global" title="Permalink to this definition">¶</a></dt>
-<dd><p>A decorator that is used to register a custom template global function.
-You can specify a name for the global function, otherwise the function
-name will be used. Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">template_global</span><span class="p">()</span>
-<span class="k">def</span> <span class="nf">double</span><span class="p">(</span><span class="n">n</span><span class="p">):</span>
-    <span class="k">return</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">n</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the global function, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.template_test">
-<code class="descname">template_test</code><span class="sig-paren">(</span><em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.template_test"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.template_test" title="Permalink to this definition">¶</a></dt>
-<dd><p>A decorator that is used to register custom template test.
-You can specify a name for the test, otherwise the function
-name will be used. Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">template_test</span><span class="p">()</span>
-<span class="k">def</span> <span class="nf">is_prime</span><span class="p">(</span><span class="n">n</span><span class="p">):</span>
-    <span class="k">if</span> <span class="n">n</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
-        <span class="k">return</span> <span class="kc">True</span>
-    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="nb">int</span><span class="p">(</span><span class="n">math</span><span class="o">.</span><span class="n">ceil</span><span class="p">(</span><span class="n">math</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="n">n</span><span class="p">)))</span> <span class="o">+</span> <span class="mi">1</span><span class="p">):</span>
-        <span class="k">if</span> <span class="n">n</span> <span class="o">%</span> <span class="n">i</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-            <span class="k">return</span> <span class="kc">False</span>
-    <span class="k">return</span> <span class="kc">True</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the test, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.test_client">
-<code class="descname">test_client</code><span class="sig-paren">(</span><em>use_cookies=True</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.test_client"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.test_client" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a test client for this application.  For information
-about unit testing head over to <span class="xref std std-ref">testing</span>.</p>
-<p>Note that if you are testing for assertions or exceptions in your
-application code, you must set <code class="docutils literal"><span class="pre">app.testing</span> <span class="pre">=</span> <span class="pre">True</span></code> in order for the
-exceptions to propagate to the test client.  Otherwise, the exception
-will be handled by the application (not visible to the test client) and
-the only indication of an AssertionError or other exception will be a
-500 status code response to the test client.  See the <a class="reference internal" href="#flask.app.Flask.testing" title="flask.app.Flask.testing"><code class="xref py py-attr docutils literal"><span class="pre">testing</span></code></a>
-attribute.  For example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">testing</span> <span class="o">=</span> <span class="kc">True</span>
-<span class="n">client</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">test_client</span><span class="p">()</span>
-</pre></div>
-</div>
-<p>The test client can be used in a <code class="docutils literal"><span class="pre">with</span></code> block to defer the closing down
-of the context until the end of the <code class="docutils literal"><span class="pre">with</span></code> block.  This is useful if
-you want to access the context locals for testing:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">with</span> <span class="n">app</span><span class="o">.</span><span class="n">test_client</span><span class="p">()</span> <span class="k">as</span> <span class="n">c</span><span class="p">:</span>
-    <span class="n">rv</span> <span class="o">=</span> <span class="n">c</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;/?vodka=42&#39;</span><span class="p">)</span>
-    <span class="k">assert</span> <span class="n">request</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s1">&#39;vodka&#39;</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;42&#39;</span>
-</pre></div>
-</div>
-<p>Additionally, you may pass optional keyword arguments that will then
-be passed to the application&#8217;s <a class="reference internal" href="#flask.app.Flask.test_client_class" title="flask.app.Flask.test_client_class"><code class="xref py py-attr docutils literal"><span class="pre">test_client_class</span></code></a> constructor.
-For example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">flask.testing</span> <span class="k">import</span> <span class="n">FlaskClient</span>
-
-<span class="k">class</span> <span class="nc">CustomClient</span><span class="p">(</span><span class="n">FlaskClient</span><span class="p">):</span>
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">authentication</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-        <span class="n">FlaskClient</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_authentication</span> <span class="o">=</span> <span class="n">authentication</span>
-
-<span class="n">app</span><span class="o">.</span><span class="n">test_client_class</span> <span class="o">=</span> <span class="n">CustomClient</span>
-<span class="n">client</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">test_client</span><span class="p">(</span><span class="n">authentication</span><span class="o">=</span><span class="s1">&#39;Basic ....&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>See <a class="reference internal" href="#flask.testing.FlaskClient" title="flask.testing.FlaskClient"><code class="xref py py-class docutils literal"><span class="pre">FlaskClient</span></code></a> for more information.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.4: </span>added support for <code class="docutils literal"><span class="pre">with</span></code> block usage for the client.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7: </span>The <cite>use_cookies</cite> parameter was added as well as the ability
-to override the client to be used by setting the
-<a class="reference internal" href="#flask.app.Flask.test_client_class" title="flask.app.Flask.test_client_class"><code class="xref py py-attr docutils literal"><span class="pre">test_client_class</span></code></a> attribute.</p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.11: </span>Added <cite>**kwargs</cite> to support passing additional keyword arguments to
-the constructor of <a class="reference internal" href="#flask.app.Flask.test_client_class" title="flask.app.Flask.test_client_class"><code class="xref py py-attr docutils literal"><span class="pre">test_client_class</span></code></a>.</p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.test_client_class">
-<code class="descname">test_client_class</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.test_client_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>the test client that is used with when <cite>test_client</cite> is used.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.test_request_context">
-<code class="descname">test_request_context</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.test_request_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.test_request_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a WSGI environment from the given values (see
-<code class="xref py py-class docutils literal"><span class="pre">werkzeug.test.EnvironBuilder</span></code> for more information, this
-function accepts the same arguments).</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.testing">
-<code class="descname">testing</code><a class="headerlink" href="#flask.app.Flask.testing" title="Permalink to this definition">¶</a></dt>
-<dd><p>The testing flag.  Set this to <code class="docutils literal"><span class="pre">True</span></code> to enable the test mode of
-Flask extensions (and in the future probably also Flask itself).
-For example this might activate unittest helpers that have an
-additional runtime cost which should not be enabled by default.</p>
-<p>If this is enabled and PROPAGATE_EXCEPTIONS is not changed from the
-default it&#8217;s implicitly enabled.</p>
-<p>This attribute can also be configured from the config with the
-<code class="docutils literal"><span class="pre">TESTING</span></code> configuration key.  Defaults to <code class="docutils literal"><span class="pre">False</span></code>.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.trap_http_exception">
-<code class="descname">trap_http_exception</code><span class="sig-paren">(</span><em>e</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.trap_http_exception"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.trap_http_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>Checks if an HTTP exception should be trapped or not.  By default
-this will return <code class="docutils literal"><span class="pre">False</span></code> for all exceptions except for a bad request
-key error if <code class="docutils literal"><span class="pre">TRAP_BAD_REQUEST_ERRORS</span></code> is set to <code class="docutils literal"><span class="pre">True</span></code>.  It
-also returns <code class="docutils literal"><span class="pre">True</span></code> if <code class="docutils literal"><span class="pre">TRAP_HTTP_EXCEPTIONS</span></code> is set to <code class="docutils literal"><span class="pre">True</span></code>.</p>
-<p>This is called for all HTTP exceptions raised by a view function.
-If it returns <code class="docutils literal"><span class="pre">True</span></code> for any exception the error handler for this
-exception is not called and it shows up as regular exception in the
-traceback.  This is helpful for debugging implicitly raised HTTP
-exceptions.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.try_trigger_before_first_request_functions">
-<code class="descname">try_trigger_before_first_request_functions</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.try_trigger_before_first_request_functions"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.try_trigger_before_first_request_functions" title="Permalink to this definition">¶</a></dt>
-<dd><p>Called before each request and will ensure that it triggers
-the <a class="reference internal" href="#flask.app.Flask.before_first_request_funcs" title="flask.app.Flask.before_first_request_funcs"><code class="xref py py-attr docutils literal"><span class="pre">before_first_request_funcs</span></code></a> and only exactly once per
-application instance (which means process usually).</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Internal:</th><td class="field-body"></td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.update_template_context">
-<code class="descname">update_template_context</code><span class="sig-paren">(</span><em>context</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.update_template_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.update_template_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Update the template context with some commonly used variables.
-This injects request, session, config and g into the template
-context as well as everything template context processors want
-to inject.  Note that the as of Flask 0.6, the original values
-in the context will not be overridden if a context processor
-decides to return a value with the same key.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>context</strong> &#8211; the context as a dictionary that is updated in place
-to add extra variables.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.url_build_error_handlers">
-<code class="descname">url_build_error_handlers</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.url_build_error_handlers" title="Permalink to this definition">¶</a></dt>
-<dd><p>A list of functions that are called when <code class="xref py py-meth docutils literal"><span class="pre">url_for()</span></code> raises a
-<code class="xref py py-exc docutils literal"><span class="pre">BuildError</span></code>.  Each function registered here
-is called with <cite>error</cite>, <cite>endpoint</cite> and <cite>values</cite>.  If a function
-returns <code class="docutils literal"><span class="pre">None</span></code> or raises a <code class="xref py py-exc docutils literal"><span class="pre">BuildError</span></code> the next function is
-tried.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.url_default_functions">
-<code class="descname">url_default_functions</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.url_default_functions" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with lists of functions that can be used as URL value
-preprocessors.  The key <code class="docutils literal"><span class="pre">None</span></code> here is used for application wide
-callbacks, otherwise the key is the name of the blueprint.
-Each of these functions has the chance to modify the dictionary
-of URL values before they are used as the keyword arguments of the
-view function.  For each function registered this one should also
-provide a <a class="reference internal" href="#flask.app.Flask.url_defaults" title="flask.app.Flask.url_defaults"><code class="xref py py-meth docutils literal"><span class="pre">url_defaults()</span></code></a> function that adds the parameters
-automatically again that were removed that way.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.url_defaults">
-<code class="descname">url_defaults</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.url_defaults"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.url_defaults" title="Permalink to this definition">¶</a></dt>
-<dd><p>Callback function for URL defaults for all view functions of the
-application.  It&#8217;s called with the endpoint and values and should
-update the values passed in place.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.url_map">
-<code class="descname">url_map</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.url_map" title="Permalink to this definition">¶</a></dt>
-<dd><p>The <code class="xref py py-class docutils literal"><span class="pre">Map</span></code> for this instance.  You can use
-this to change the routing converters after the class was created
-but before any routes are connected.  Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">werkzeug.routing</span> <span class="k">import</span> <span class="n">BaseConverter</span>
-
-<span class="k">class</span> <span class="nc">ListConverter</span><span class="p">(</span><span class="n">BaseConverter</span><span class="p">):</span>
-    <span class="k">def</span> <span class="nf">to_python</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;,&#39;</span><span class="p">)</span>
-    <span class="k">def</span> <span class="nf">to_url</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">values</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;,&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">BaseConverter</span><span class="o">.</span><span class="n">to_url</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-                        <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">values</span><span class="p">)</span>
-
-<span class="n">app</span> <span class="o">=</span> <span class="n">Flask</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">url_map</span><span class="o">.</span><span class="n">converters</span><span class="p">[</span><span class="s1">&#39;list&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">ListConverter</span>
-</pre></div>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.url_rule_class">
-<code class="descname">url_rule_class</code><a class="headerlink" href="#flask.app.Flask.url_rule_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>The rule object to use for URL rules created.  This is used by
-<a class="reference internal" href="#flask.app.Flask.add_url_rule" title="flask.app.Flask.add_url_rule"><code class="xref py py-meth docutils literal"><span class="pre">add_url_rule()</span></code></a>.  Defaults to <code class="xref py py-class docutils literal"><span class="pre">werkzeug.routing.Rule</span></code>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-<p>alias of <code class="xref py py-class docutils literal"><span class="pre">Rule</span></code></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.url_value_preprocessor">
-<code class="descname">url_value_preprocessor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.url_value_preprocessor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.url_value_preprocessor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a function as URL value preprocessor for all view
-functions of the application.  It&#8217;s called before the view functions
-are called and can modify the url values provided.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.url_value_preprocessors">
-<code class="descname">url_value_preprocessors</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.url_value_preprocessors" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with lists of functions that can be used as URL
-value processor functions.  Whenever a URL is built these functions
-are called to modify the dictionary of values in place.  The key
-<code class="docutils literal"><span class="pre">None</span></code> here is used for application wide
-callbacks, otherwise the key is the name of the blueprint.
-Each of these functions has the chance to modify the dictionary</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.use_x_sendfile">
-<code class="descname">use_x_sendfile</code><a class="headerlink" href="#flask.app.Flask.use_x_sendfile" title="Permalink to this definition">¶</a></dt>
-<dd><p>Enable this if you want to use the X-Sendfile feature.  Keep in
-mind that the server has to support this.  This only affects files
-sent with the <code class="xref py py-func docutils literal"><span class="pre">send_file()</span></code> method.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.2.</span></p>
-</div>
-<p>This attribute can also be configured from the config with the
-<code class="docutils literal"><span class="pre">USE_X_SENDFILE</span></code> configuration key.  Defaults to <code class="docutils literal"><span class="pre">False</span></code>.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.app.Flask.view_functions">
-<code class="descname">view_functions</code><em class="property"> = None</em><a class="headerlink" href="#flask.app.Flask.view_functions" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary of all view functions registered.  The keys will
-be function names which are also used to generate URLs and
-the values are the function objects themselves.
-To register a view function, use the <a class="reference internal" href="#flask.app.Flask.route" title="flask.app.Flask.route"><code class="xref py py-meth docutils literal"><span class="pre">route()</span></code></a> decorator.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.app.Flask.wsgi_app">
-<code class="descname">wsgi_app</code><span class="sig-paren">(</span><em>environ</em>, <em>start_response</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#Flask.wsgi_app"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.Flask.wsgi_app" title="Permalink to this definition">¶</a></dt>
-<dd><p>The actual WSGI application.  This is not implemented in
-<cite>__call__</cite> so that middlewares can be applied without losing a
-reference to the class.  So instead of doing this:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span> <span class="o">=</span> <span class="n">MyMiddleware</span><span class="p">(</span><span class="n">app</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>It&#8217;s a better idea to do this instead:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">wsgi_app</span> <span class="o">=</span> <span class="n">MyMiddleware</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">wsgi_app</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>Then you still have the original application object around and
-can continue to call methods on it.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.7: </span>The behavior of the before and after request callbacks was changed
-under error conditions and a new callback was added that will
-always execute at the end of the request, independent on if an
-error occurred or not.  See <span class="xref std std-ref">callbacks-and-errors</span>.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>environ</strong> &#8211; a WSGI environment</li>
-<li><strong>start_response</strong> &#8211; a callable accepting a status code,
-a list of headers and an optional
-exception context to start the response</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.app.setupmethod">
-<code class="descclassname">flask.app.</code><code class="descname">setupmethod</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/app.html#setupmethod"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.app.setupmethod" title="Permalink to this definition">¶</a></dt>
-<dd><p>Wraps a method so that it performs a check in debug mode if the
-first request was already handled.</p>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.blueprints">
-<span id="flask-blueprints-module"></span><h2>flask.blueprints module<a class="headerlink" href="#module-flask.blueprints" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-blueprints">
-<h3>flask.blueprints<a class="headerlink" href="#flask-blueprints" title="Permalink to this headline">¶</a></h3>
-<p>Blueprints are the recommended way to implement larger or more
-pluggable applications in Flask 0.7 and later.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.blueprints.Blueprint">
-<em class="property">class </em><code class="descclassname">flask.blueprints.</code><code class="descname">Blueprint</code><span class="sig-paren">(</span><em>name</em>, <em>import_name</em>, <em>static_folder=None</em>, <em>static_url_path=None</em>, <em>template_folder=None</em>, <em>url_prefix=None</em>, <em>subdomain=None</em>, <em>url_defaults=None</em>, <em>root_path=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">flask.helpers._PackageBoundObject</span></code></p>
-<p>Represents a blueprint.  A blueprint is an object that records
-functions that will be called with the
-<a class="reference internal" href="#flask.blueprints.BlueprintSetupState" title="flask.blueprints.BlueprintSetupState"><code class="xref py py-class docutils literal"><span class="pre">BlueprintSetupState</span></code></a> later to register functions
-or other things on the main application.  See <span class="xref std std-ref">blueprints</span> for more
-information.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.add_app_template_filter">
-<code class="descname">add_app_template_filter</code><span class="sig-paren">(</span><em>f</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.add_app_template_filter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.add_app_template_filter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template filter, available application wide.  Like
-<code class="xref py py-meth docutils literal"><span class="pre">Flask.add_template_filter()</span></code> but for a blueprint.  Works exactly
-like the <a class="reference internal" href="#flask.blueprints.Blueprint.app_template_filter" title="flask.blueprints.Blueprint.app_template_filter"><code class="xref py py-meth docutils literal"><span class="pre">app_template_filter()</span></code></a> decorator.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the filter, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.add_app_template_global">
-<code class="descname">add_app_template_global</code><span class="sig-paren">(</span><em>f</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.add_app_template_global"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.add_app_template_global" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template global, available application wide.  Like
-<code class="xref py py-meth docutils literal"><span class="pre">Flask.add_template_global()</span></code> but for a blueprint.  Works exactly
-like the <a class="reference internal" href="#flask.blueprints.Blueprint.app_template_global" title="flask.blueprints.Blueprint.app_template_global"><code class="xref py py-meth docutils literal"><span class="pre">app_template_global()</span></code></a> decorator.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the global, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.add_app_template_test">
-<code class="descname">add_app_template_test</code><span class="sig-paren">(</span><em>f</em>, <em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.add_app_template_test"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.add_app_template_test" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template test, available application wide.  Like
-<code class="xref py py-meth docutils literal"><span class="pre">Flask.add_template_test()</span></code> but for a blueprint.  Works exactly
-like the <a class="reference internal" href="#flask.blueprints.Blueprint.app_template_test" title="flask.blueprints.Blueprint.app_template_test"><code class="xref py py-meth docutils literal"><span class="pre">app_template_test()</span></code></a> decorator.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the test, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.add_url_rule">
-<code class="descname">add_url_rule</code><span class="sig-paren">(</span><em>rule</em>, <em>endpoint=None</em>, <em>view_func=None</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.add_url_rule"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.add_url_rule" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.add_url_rule()</span></code> but for a blueprint.  The endpoint for
-the <code class="xref py py-func docutils literal"><span class="pre">url_for()</span></code> function is prefixed with the name of the blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.after_app_request">
-<code class="descname">after_app_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.after_app_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.after_app_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.after_request()</span></code> but for a blueprint.  Such a function
-is executed after each request, even if outside of the blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.after_request">
-<code class="descname">after_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.after_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.after_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.after_request()</span></code> but for a blueprint.  This function
-is only executed after each request that is handled by a function of
-that blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_context_processor">
-<code class="descname">app_context_processor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_context_processor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_context_processor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.context_processor()</span></code> but for a blueprint.  Such a
-function is executed each request, even if outside of the blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_errorhandler">
-<code class="descname">app_errorhandler</code><span class="sig-paren">(</span><em>code</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_errorhandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_errorhandler" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.errorhandler()</span></code> but for a blueprint.  This
-handler is used for all requests, even if outside of the blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_template_filter">
-<code class="descname">app_template_filter</code><span class="sig-paren">(</span><em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_template_filter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_template_filter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template filter, available application wide.  Like
-<code class="xref py py-meth docutils literal"><span class="pre">Flask.template_filter()</span></code> but for a blueprint.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the filter, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_template_global">
-<code class="descname">app_template_global</code><span class="sig-paren">(</span><em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_template_global"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_template_global" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template global, available application wide.  Like
-<code class="xref py py-meth docutils literal"><span class="pre">Flask.template_global()</span></code> but for a blueprint.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the global, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_template_test">
-<code class="descname">app_template_test</code><span class="sig-paren">(</span><em>name=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_template_test"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_template_test" title="Permalink to this definition">¶</a></dt>
-<dd><p>Register a custom template test, available application wide.  Like
-<code class="xref py py-meth docutils literal"><span class="pre">Flask.template_test()</span></code> but for a blueprint.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> &#8211; the optional name of the test, otherwise the
-function name will be used.</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_url_defaults">
-<code class="descname">app_url_defaults</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_url_defaults"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_url_defaults" title="Permalink to this definition">¶</a></dt>
-<dd><p>Same as <a class="reference internal" href="#flask.blueprints.Blueprint.url_defaults" title="flask.blueprints.Blueprint.url_defaults"><code class="xref py py-meth docutils literal"><span class="pre">url_defaults()</span></code></a> but application wide.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.app_url_value_preprocessor">
-<code class="descname">app_url_value_preprocessor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.app_url_value_preprocessor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.app_url_value_preprocessor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Same as <a class="reference internal" href="#flask.blueprints.Blueprint.url_value_preprocessor" title="flask.blueprints.Blueprint.url_value_preprocessor"><code class="xref py py-meth docutils literal"><span class="pre">url_value_preprocessor()</span></code></a> but application wide.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.before_app_first_request">
-<code class="descname">before_app_first_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.before_app_first_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.before_app_first_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.before_first_request()</span></code>.  Such a function is
-executed before the first request to the application.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.before_app_request">
-<code class="descname">before_app_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.before_app_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.before_app_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.before_request()</span></code>.  Such a function is executed
-before each request, even if outside of a blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.before_request">
-<code class="descname">before_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.before_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.before_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.before_request()</span></code> but for a blueprint.  This function
-is only executed before each request that is handled by a function of
-that blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.context_processor">
-<code class="descname">context_processor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.context_processor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.context_processor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.context_processor()</span></code> but for a blueprint.  This
-function is only executed for requests handled by a blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.endpoint">
-<code class="descname">endpoint</code><span class="sig-paren">(</span><em>endpoint</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.endpoint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.endpoint" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.endpoint()</span></code> but for a blueprint.  This does not
-prefix the endpoint with the blueprint name, this has to be done
-explicitly by the user of this method.  If the endpoint is prefixed
-with a <cite>.</cite> it will be registered to the current blueprint, otherwise
-it&#8217;s an application independent endpoint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.errorhandler">
-<code class="descname">errorhandler</code><span class="sig-paren">(</span><em>code_or_exception</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.errorhandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.errorhandler" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers an error handler that becomes active for this blueprint
-only.  Please be aware that routing does not happen local to a
-blueprint so an error handler for 404 usually is not handled by
-a blueprint unless it is caused inside a view function.  Another
-special case is the 500 internal server error which is always looked
-up from the application.</p>
-<p>Otherwise works as the <code class="xref py py-meth docutils literal"><span class="pre">errorhandler()</span></code> decorator
-of the <code class="xref py py-class docutils literal"><span class="pre">Flask</span></code> object.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.make_setup_state">
-<code class="descname">make_setup_state</code><span class="sig-paren">(</span><em>app</em>, <em>options</em>, <em>first_registration=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.make_setup_state"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.make_setup_state" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates an instance of <a class="reference internal" href="#flask.blueprints.BlueprintSetupState" title="flask.blueprints.BlueprintSetupState"><code class="xref py py-meth docutils literal"><span class="pre">BlueprintSetupState()</span></code></a>
-object that is later passed to the register callback functions.
-Subclasses can override this to return a subclass of the setup state.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.record">
-<code class="descname">record</code><span class="sig-paren">(</span><em>func</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.record"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.record" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a function that is called when the blueprint is
-registered on the application.  This function is called with the
-state as argument as returned by the <a class="reference internal" href="#flask.blueprints.Blueprint.make_setup_state" title="flask.blueprints.Blueprint.make_setup_state"><code class="xref py py-meth docutils literal"><span class="pre">make_setup_state()</span></code></a>
-method.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.record_once">
-<code class="descname">record_once</code><span class="sig-paren">(</span><em>func</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.record_once"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.record_once" title="Permalink to this definition">¶</a></dt>
-<dd><p>Works like <a class="reference internal" href="#flask.blueprints.Blueprint.record" title="flask.blueprints.Blueprint.record"><code class="xref py py-meth docutils literal"><span class="pre">record()</span></code></a> but wraps the function in another
-function that will ensure the function is only called once.  If the
-blueprint is registered a second time on the application, the
-function passed is not called.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.register">
-<code class="descname">register</code><span class="sig-paren">(</span><em>app</em>, <em>options</em>, <em>first_registration=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.register"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.register" title="Permalink to this definition">¶</a></dt>
-<dd><p>Called by <code class="xref py py-meth docutils literal"><span class="pre">Flask.register_blueprint()</span></code> to register a blueprint
-on the application.  This can be overridden to customize the register
-behavior.  Keyword arguments from
-<code class="xref py py-func docutils literal"><span class="pre">register_blueprint()</span></code> are directly forwarded to this
-method in the <cite>options</cite> dictionary.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.register_error_handler">
-<code class="descname">register_error_handler</code><span class="sig-paren">(</span><em>code_or_exception</em>, <em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.register_error_handler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.register_error_handler" title="Permalink to this definition">¶</a></dt>
-<dd><p>Non-decorator version of the <a class="reference internal" href="#flask.blueprints.Blueprint.errorhandler" title="flask.blueprints.Blueprint.errorhandler"><code class="xref py py-meth docutils literal"><span class="pre">errorhandler()</span></code></a> error attach
-function, akin to the <code class="xref py py-meth docutils literal"><span class="pre">register_error_handler()</span></code>
-application-wide function of the <code class="xref py py-class docutils literal"><span class="pre">Flask</span></code> object but
-for error handlers limited to this blueprint.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.route">
-<code class="descname">route</code><span class="sig-paren">(</span><em>rule</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.route"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.route" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.route()</span></code> but for a blueprint.  The endpoint for the
-<code class="xref py py-func docutils literal"><span class="pre">url_for()</span></code> function is prefixed with the name of the blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.teardown_app_request">
-<code class="descname">teardown_app_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.teardown_app_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.teardown_app_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.teardown_request()</span></code> but for a blueprint.  Such a
-function is executed when tearing down each request, even if outside of
-the blueprint.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.teardown_request">
-<code class="descname">teardown_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.teardown_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.teardown_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <code class="xref py py-meth docutils literal"><span class="pre">Flask.teardown_request()</span></code> but for a blueprint.  This
-function is only executed when tearing down requests handled by a
-function of that blueprint.  Teardown request functions are executed
-when the request context is popped, even when no actual request was
-performed.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.url_defaults">
-<code class="descname">url_defaults</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.url_defaults"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.url_defaults" title="Permalink to this definition">¶</a></dt>
-<dd><p>Callback function for URL defaults for this blueprint.  It&#8217;s called
-with the endpoint and values and should update the values passed
-in place.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.blueprints.Blueprint.url_value_preprocessor">
-<code class="descname">url_value_preprocessor</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#Blueprint.url_value_preprocessor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.Blueprint.url_value_preprocessor" title="Permalink to this definition">¶</a></dt>
-<dd><p>Registers a function as URL value preprocessor for this
-blueprint.  It&#8217;s called before the view functions are called and
-can modify the url values provided.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.Blueprint.warn_on_modifications">
-<code class="descname">warn_on_modifications</code><em class="property"> = False</em><a class="headerlink" href="#flask.blueprints.Blueprint.warn_on_modifications" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.blueprints.BlueprintSetupState">
-<em class="property">class </em><code class="descclassname">flask.blueprints.</code><code class="descname">BlueprintSetupState</code><span class="sig-paren">(</span><em>blueprint</em>, <em>app</em>, <em>options</em>, <em>first_registration</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#BlueprintSetupState"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.BlueprintSetupState" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Temporary holder object for registering a blueprint with the
-application.  An instance of this class is created by the
-<code class="xref py py-meth docutils literal"><span class="pre">make_setup_state()</span></code> method and later passed
-to all register callback functions.</p>
-<dl class="method">
-<dt id="flask.blueprints.BlueprintSetupState.add_url_rule">
-<code class="descname">add_url_rule</code><span class="sig-paren">(</span><em>rule</em>, <em>endpoint=None</em>, <em>view_func=None</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/blueprints.html#BlueprintSetupState.add_url_rule"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.add_url_rule" title="Permalink to this definition">¶</a></dt>
-<dd><p>A helper method to register a rule (and optionally a view function)
-to the application.  The endpoint is automatically prefixed with the
-blueprint&#8217;s name.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.app">
-<code class="descname">app</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.app" title="Permalink to this definition">¶</a></dt>
-<dd><p>a reference to the current application</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.blueprint">
-<code class="descname">blueprint</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.blueprint" title="Permalink to this definition">¶</a></dt>
-<dd><p>a reference to the blueprint that created this setup state.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.first_registration">
-<code class="descname">first_registration</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.first_registration" title="Permalink to this definition">¶</a></dt>
-<dd><p>as blueprints can be registered multiple times with the
-application and not everything wants to be registered
-multiple times on it, this attribute can be used to figure
-out if the blueprint was registered in the past already.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.options">
-<code class="descname">options</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.options" title="Permalink to this definition">¶</a></dt>
-<dd><p>a dictionary with all options that were passed to the
-<code class="xref py py-meth docutils literal"><span class="pre">register_blueprint()</span></code> method.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.subdomain">
-<code class="descname">subdomain</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.subdomain" title="Permalink to this definition">¶</a></dt>
-<dd><p>The subdomain that the blueprint should be active for, <code class="docutils literal"><span class="pre">None</span></code>
-otherwise.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.url_defaults">
-<code class="descname">url_defaults</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.url_defaults" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with URL defaults that is added to each and every
-URL that was defined with the blueprint.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.blueprints.BlueprintSetupState.url_prefix">
-<code class="descname">url_prefix</code><em class="property"> = None</em><a class="headerlink" href="#flask.blueprints.BlueprintSetupState.url_prefix" title="Permalink to this definition">¶</a></dt>
-<dd><p>The prefix that should be used for all URLs defined on the
-blueprint.</p>
-</dd></dl>
-
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.cli">
-<span id="flask-cli-module"></span><h2>flask.cli module<a class="headerlink" href="#module-flask.cli" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-cli">
-<h3>flask.cli<a class="headerlink" href="#flask-cli" title="Permalink to this headline">¶</a></h3>
-<p>A simple command line application to run flask apps.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.cli.AppGroup">
-<em class="property">class </em><code class="descclassname">flask.cli.</code><code class="descname">AppGroup</code><span class="sig-paren">(</span><em>name=None</em>, <em>commands=None</em>, <em>**attrs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#AppGroup"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.AppGroup" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">click.core.Group</span></code></p>
-<p>This works similar to a regular click <code class="xref py py-class docutils literal"><span class="pre">Group</span></code> but it
-changes the behavior of the <a class="reference internal" href="#flask.cli.AppGroup.command" title="flask.cli.AppGroup.command"><code class="xref py py-meth docutils literal"><span class="pre">command()</span></code></a> decorator so that it
-automatically wraps the functions in <a class="reference internal" href="#flask.cli.with_appcontext" title="flask.cli.with_appcontext"><code class="xref py py-func docutils literal"><span class="pre">with_appcontext()</span></code></a>.</p>
-<p>Not to be confused with <a class="reference internal" href="#flask.cli.FlaskGroup" title="flask.cli.FlaskGroup"><code class="xref py py-class docutils literal"><span class="pre">FlaskGroup</span></code></a>.</p>
-<dl class="method">
-<dt id="flask.cli.AppGroup.command">
-<code class="descname">command</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#AppGroup.command"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.AppGroup.command" title="Permalink to this definition">¶</a></dt>
-<dd><p>This works exactly like the method of the same name on a regular
-<code class="xref py py-class docutils literal"><span class="pre">click.Group</span></code> but it wraps callbacks in <a class="reference internal" href="#flask.cli.with_appcontext" title="flask.cli.with_appcontext"><code class="xref py py-func docutils literal"><span class="pre">with_appcontext()</span></code></a>
-unless it&#8217;s disabled by passing <code class="docutils literal"><span class="pre">with_appcontext=False</span></code>.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.cli.AppGroup.group">
-<code class="descname">group</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#AppGroup.group"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.AppGroup.group" title="Permalink to this definition">¶</a></dt>
-<dd><p>This works exactly like the method of the same name on a regular
-<code class="xref py py-class docutils literal"><span class="pre">click.Group</span></code> but it defaults the group class to
-<a class="reference internal" href="#flask.cli.AppGroup" title="flask.cli.AppGroup"><code class="xref py py-class docutils literal"><span class="pre">AppGroup</span></code></a>.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.cli.DispatchingApp">
-<em class="property">class </em><code class="descclassname">flask.cli.</code><code class="descname">DispatchingApp</code><span class="sig-paren">(</span><em>loader</em>, <em>use_eager_loading=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#DispatchingApp"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.DispatchingApp" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Special application that dispatches to a flask application which
-is imported by name in a background thread.  If an error happens
-it is is recorded and shows as part of the WSGI handling which in case
-of the Werkzeug debugger means that it shows up in the browser.</p>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.cli.FlaskGroup">
-<em class="property">class </em><code class="descclassname">flask.cli.</code><code class="descname">FlaskGroup</code><span class="sig-paren">(</span><em>add_default_commands=True</em>, <em>create_app=None</em>, <em>**extra</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#FlaskGroup"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.FlaskGroup" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <a class="reference internal" href="#flask.cli.AppGroup" title="flask.cli.AppGroup"><code class="xref py py-class docutils literal"><span class="pre">flask.cli.AppGroup</span></code></a></p>
-<p>Special subclass of the <a class="reference internal" href="#flask.cli.AppGroup" title="flask.cli.AppGroup"><code class="xref py py-class docutils literal"><span class="pre">AppGroup</span></code></a> group that supports
-loading more commands from the configured Flask app.  Normally a
-developer does not have to interface with this class but there are
-some very advanced use cases for which it makes sense to create an
-instance of this.</p>
-<p>For information as of why this is useful see <span class="xref std std-ref">custom-scripts</span>.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>add_default_commands</strong> &#8211; if this is True then the default run and
-shell commands wil be added.</li>
-<li><strong>create_app</strong> &#8211; an optional callback that is passed the script info
-and returns the loaded app.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="method">
-<dt id="flask.cli.FlaskGroup.get_command">
-<code class="descname">get_command</code><span class="sig-paren">(</span><em>ctx</em>, <em>name</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#FlaskGroup.get_command"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.FlaskGroup.get_command" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.cli.FlaskGroup.list_commands">
-<code class="descname">list_commands</code><span class="sig-paren">(</span><em>ctx</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#FlaskGroup.list_commands"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.FlaskGroup.list_commands" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.cli.FlaskGroup.main">
-<code class="descname">main</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#FlaskGroup.main"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.FlaskGroup.main" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="exception">
-<dt id="flask.cli.NoAppException">
-<em class="property">exception </em><code class="descclassname">flask.cli.</code><code class="descname">NoAppException</code><span class="sig-paren">(</span><em>message</em>, <em>ctx=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#NoAppException"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.NoAppException" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">click.exceptions.UsageError</span></code></p>
-<p>Raised if an application cannot be found or loaded.</p>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.cli.ScriptInfo">
-<em class="property">class </em><code class="descclassname">flask.cli.</code><code class="descname">ScriptInfo</code><span class="sig-paren">(</span><em>app_import_path=None</em>, <em>create_app=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#ScriptInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.ScriptInfo" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Help object to deal with Flask applications.  This is usually not
-necessary to interface with as it&#8217;s used internally in the dispatching
-to click.  In future versions of Flask this object will most likely play
-a bigger role.  Typically it&#8217;s created automatically by the
-<a class="reference internal" href="#flask.cli.FlaskGroup" title="flask.cli.FlaskGroup"><code class="xref py py-class docutils literal"><span class="pre">FlaskGroup</span></code></a> but you can also manually create it and pass it
-onwards as click object.</p>
-<dl class="attribute">
-<dt id="flask.cli.ScriptInfo.app_import_path">
-<code class="descname">app_import_path</code><em class="property"> = None</em><a class="headerlink" href="#flask.cli.ScriptInfo.app_import_path" title="Permalink to this definition">¶</a></dt>
-<dd><p>Optionally the import path for the Flask application.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.cli.ScriptInfo.create_app">
-<code class="descname">create_app</code><em class="property"> = None</em><a class="headerlink" href="#flask.cli.ScriptInfo.create_app" title="Permalink to this definition">¶</a></dt>
-<dd><p>Optionally a function that is passed the script info to create
-the instance of the application.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.cli.ScriptInfo.data">
-<code class="descname">data</code><em class="property"> = None</em><a class="headerlink" href="#flask.cli.ScriptInfo.data" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dictionary with arbitrary data that can be associated with
-this script info.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.cli.ScriptInfo.load_app">
-<code class="descname">load_app</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#ScriptInfo.load_app"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.ScriptInfo.load_app" title="Permalink to this definition">¶</a></dt>
-<dd><p>Loads the Flask app (if not yet loaded) and returns it.  Calling
-this multiple times will just result in the already loaded app to
-be returned.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.cli.find_best_app">
-<code class="descclassname">flask.cli.</code><code class="descname">find_best_app</code><span class="sig-paren">(</span><em>module</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#find_best_app"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.find_best_app" title="Permalink to this definition">¶</a></dt>
-<dd><p>Given a module instance this tries to find the best possible
-application in the module or raises an exception.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.cli.find_default_import_path">
-<code class="descclassname">flask.cli.</code><code class="descname">find_default_import_path</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#find_default_import_path"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.find_default_import_path" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="function">
-<dt id="flask.cli.locate_app">
-<code class="descclassname">flask.cli.</code><code class="descname">locate_app</code><span class="sig-paren">(</span><em>app_id</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#locate_app"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.locate_app" title="Permalink to this definition">¶</a></dt>
-<dd><p>Attempts to locate the application.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.cli.main">
-<code class="descclassname">flask.cli.</code><code class="descname">main</code><span class="sig-paren">(</span><em>as_module=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#main"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.main" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="function">
-<dt id="flask.cli.prepare_exec_for_file">
-<code class="descclassname">flask.cli.</code><code class="descname">prepare_exec_for_file</code><span class="sig-paren">(</span><em>filename</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#prepare_exec_for_file"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.prepare_exec_for_file" title="Permalink to this definition">¶</a></dt>
-<dd><p>Given a filename this will try to calculate the python path, add it
-to the search path and return the actual module name that is expected.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.cli.with_appcontext">
-<code class="descclassname">flask.cli.</code><code class="descname">with_appcontext</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/cli.html#with_appcontext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.cli.with_appcontext" title="Permalink to this definition">¶</a></dt>
-<dd><p>Wraps a callback so that it&#8217;s guaranteed to be executed with the
-script&#8217;s application context.  If callbacks are registered directly
-to the <code class="docutils literal"><span class="pre">app.cli</span></code> object then they are wrapped with this function
-by default unless it&#8217;s disabled.</p>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.config">
-<span id="flask-config-module"></span><h2>flask.config module<a class="headerlink" href="#module-flask.config" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-config">
-<h3>flask.config<a class="headerlink" href="#flask-config" title="Permalink to this headline">¶</a></h3>
-<p>Implements the configuration related objects.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.config.Config">
-<em class="property">class </em><code class="descclassname">flask.config.</code><code class="descname">Config</code><span class="sig-paren">(</span><em>root_path</em>, <em>defaults=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">dict</span></code></p>
-<p>Works exactly like a dict but provides ways to fill it from files
-or special dictionaries.  There are two common patterns to populate the
-config.</p>
-<p>Either you can fill the config from a config file:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">from_pyfile</span><span class="p">(</span><span class="s1">&#39;yourconfig.cfg&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>Or alternatively you can define the configuration options in the
-module that calls <a class="reference internal" href="#flask.config.Config.from_object" title="flask.config.Config.from_object"><code class="xref py py-meth docutils literal"><span class="pre">from_object()</span></code></a> or provide an import path to
-a module that should be loaded.  It is also possible to tell it to
-use the same module and with that provide the configuration values
-just before the call:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">DEBUG</span> <span class="o">=</span> <span class="kc">True</span>
-<span class="n">SECRET_KEY</span> <span class="o">=</span> <span class="s1">&#39;development key&#39;</span>
-<span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">from_object</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>In both cases (loading from any Python file or loading from modules),
-only uppercase keys are added to the config.  This makes it possible to use
-lowercase values in the config file for temporary values that are not added
-to the config or to define the config keys in the same file that implements
-the application.</p>
-<p>Probably the most interesting way to load configurations is from an
-environment variable pointing to a file:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">from_envvar</span><span class="p">(</span><span class="s1">&#39;YOURAPPLICATION_SETTINGS&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>In this case before launching the application you have to set this
-environment variable to the file you want to use.  On Linux and OS X
-use the export statement:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">export</span> <span class="n">YOURAPPLICATION_SETTINGS</span><span class="o">=</span><span class="s1">&#39;/path/to/config/file&#39;</span>
-</pre></div>
-</div>
-<p>On windows use <cite>set</cite> instead.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>root_path</strong> &#8211; path to which files are read relative from.  When the
-config object is created by the application, this is
-the application&#8217;s <code class="xref py py-attr docutils literal"><span class="pre">root_path</span></code>.</li>
-<li><strong>defaults</strong> &#8211; an optional dictionary of default values</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="method">
-<dt id="flask.config.Config.from_envvar">
-<code class="descname">from_envvar</code><span class="sig-paren">(</span><em>variable_name</em>, <em>silent=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config.from_envvar"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config.from_envvar" title="Permalink to this definition">¶</a></dt>
-<dd><p>Loads a configuration from an environment variable pointing to
-a configuration file.  This is basically just a shortcut with nicer
-error messages for this line of code:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">from_pyfile</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;YOURAPPLICATION_SETTINGS&#39;</span><span class="p">])</span>
-</pre></div>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>variable_name</strong> &#8211; name of the environment variable</li>
-<li><strong>silent</strong> &#8211; set to <code class="docutils literal"><span class="pre">True</span></code> if you want silent failure for missing
-files.</li>
-</ul>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">bool. <code class="docutils literal"><span class="pre">True</span></code> if able to load config, <code class="docutils literal"><span class="pre">False</span></code> otherwise.</p>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.config.Config.from_json">
-<code class="descname">from_json</code><span class="sig-paren">(</span><em>filename</em>, <em>silent=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config.from_json"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config.from_json" title="Permalink to this definition">¶</a></dt>
-<dd><p>Updates the values in the config from a JSON file. This function
-behaves as if the JSON object was a dictionary and passed to the
-<a class="reference internal" href="#flask.config.Config.from_mapping" title="flask.config.Config.from_mapping"><code class="xref py py-meth docutils literal"><span class="pre">from_mapping()</span></code></a> function.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>filename</strong> &#8211; the filename of the JSON file.  This can either be an
-absolute filename or a filename relative to the
-root path.</li>
-<li><strong>silent</strong> &#8211; set to <code class="docutils literal"><span class="pre">True</span></code> if you want silent failure for missing
-files.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.config.Config.from_mapping">
-<code class="descname">from_mapping</code><span class="sig-paren">(</span><em>*mapping</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config.from_mapping"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config.from_mapping" title="Permalink to this definition">¶</a></dt>
-<dd><p>Updates the config like <code class="xref py py-meth docutils literal"><span class="pre">update()</span></code> ignoring items with non-upper
-keys.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.config.Config.from_object">
-<code class="descname">from_object</code><span class="sig-paren">(</span><em>obj</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config.from_object"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config.from_object" title="Permalink to this definition">¶</a></dt>
-<dd><p>Updates the values from the given object.  An object can be of one
-of the following two types:</p>
-<ul class="simple">
-<li>a string: in this case the object with that name will be imported</li>
-<li>an actual object reference: that object is used directly</li>
-</ul>
-<p>Objects are usually either modules or classes.</p>
-<p>Just the uppercase variables in that object are stored in the config.
-Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">from_object</span><span class="p">(</span><span class="s1">&#39;yourapplication.default_config&#39;</span><span class="p">)</span>
-<span class="kn">from</span> <span class="nn">yourapplication</span> <span class="k">import</span> <span class="n">default_config</span>
-<span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">from_object</span><span class="p">(</span><span class="n">default_config</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>You should not use this function to load the actual configuration but
-rather configuration defaults.  The actual config should be loaded
-with <a class="reference internal" href="#flask.config.Config.from_pyfile" title="flask.config.Config.from_pyfile"><code class="xref py py-meth docutils literal"><span class="pre">from_pyfile()</span></code></a> and ideally from a location not within the
-package because the package might be installed system wide.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>obj</strong> &#8211; an import name or object</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.config.Config.from_pyfile">
-<code class="descname">from_pyfile</code><span class="sig-paren">(</span><em>filename</em>, <em>silent=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config.from_pyfile"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config.from_pyfile" title="Permalink to this definition">¶</a></dt>
-<dd><p>Updates the values in the config from a Python file.  This function
-behaves as if the file was imported as module with the
-<a class="reference internal" href="#flask.config.Config.from_object" title="flask.config.Config.from_object"><code class="xref py py-meth docutils literal"><span class="pre">from_object()</span></code></a> function.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>filename</strong> &#8211; the filename of the config.  This can either be an
-absolute filename or a filename relative to the
-root path.</li>
-<li><strong>silent</strong> &#8211; set to <code class="docutils literal"><span class="pre">True</span></code> if you want silent failure for missing
-files.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7: </span><cite>silent</cite> parameter.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.config.Config.get_namespace">
-<code class="descname">get_namespace</code><span class="sig-paren">(</span><em>namespace</em>, <em>lowercase=True</em>, <em>trim_namespace=True</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#Config.get_namespace"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.Config.get_namespace" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns a dictionary containing a subset of configuration options
-that match the specified namespace/prefix. Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;IMAGE_STORE_TYPE&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;fs&#39;</span>
-<span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;IMAGE_STORE_PATH&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;/var/app/images&#39;</span>
-<span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;IMAGE_STORE_BASE_URL&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;http://img.website.com&#39;</span>
-<span class="n">image_store_config</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">get_namespace</span><span class="p">(</span><span class="s1">&#39;IMAGE_STORE_&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>The resulting dictionary <cite>image_store_config</cite> would look like:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="p">{</span>
-    <span class="s1">&#39;type&#39;</span><span class="p">:</span> <span class="s1">&#39;fs&#39;</span><span class="p">,</span>
-    <span class="s1">&#39;path&#39;</span><span class="p">:</span> <span class="s1">&#39;/var/app/images&#39;</span><span class="p">,</span>
-    <span class="s1">&#39;base_url&#39;</span><span class="p">:</span> <span class="s1">&#39;http://img.website.com&#39;</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-<p>This is often useful when configuration options map directly to
-keyword arguments in functions or class constructors.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>namespace</strong> &#8211; a configuration namespace</li>
-<li><strong>lowercase</strong> &#8211; a flag indicating if the keys of the resulting
-dictionary should be lowercase</li>
-<li><strong>trim_namespace</strong> &#8211; a flag indicating if the keys of the resulting
-dictionary should not include the namespace</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.config.ConfigAttribute">
-<em class="property">class </em><code class="descclassname">flask.config.</code><code class="descname">ConfigAttribute</code><span class="sig-paren">(</span><em>name</em>, <em>get_converter=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/config.html#ConfigAttribute"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.config.ConfigAttribute" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Makes an attribute forward to the config</p>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.ctx">
-<span id="flask-ctx-module"></span><h2>flask.ctx module<a class="headerlink" href="#module-flask.ctx" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-ctx">
-<h3>flask.ctx<a class="headerlink" href="#flask-ctx" title="Permalink to this headline">¶</a></h3>
-<p>Implements the objects required to keep the context.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.ctx.AppContext">
-<em class="property">class </em><code class="descclassname">flask.ctx.</code><code class="descname">AppContext</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#AppContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.AppContext" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>The application context binds an application object implicitly
-to the current thread or greenlet, similar to how the
-<a class="reference internal" href="#flask.ctx.RequestContext" title="flask.ctx.RequestContext"><code class="xref py py-class docutils literal"><span class="pre">RequestContext</span></code></a> binds request information.  The application
-context is also implicitly created if a request context is created
-but the application is not on top of the individual application
-context.</p>
-<dl class="method">
-<dt id="flask.ctx.AppContext.pop">
-<code class="descname">pop</code><span class="sig-paren">(</span><em>exc=&lt;object object at 0x000001E1FDEFF780&gt;</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#AppContext.pop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.AppContext.pop" title="Permalink to this definition">¶</a></dt>
-<dd><p>Pops the app context.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.ctx.AppContext.push">
-<code class="descname">push</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#AppContext.push"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.AppContext.push" title="Permalink to this definition">¶</a></dt>
-<dd><p>Binds the app context to the current context.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.ctx.RequestContext">
-<em class="property">class </em><code class="descclassname">flask.ctx.</code><code class="descname">RequestContext</code><span class="sig-paren">(</span><em>app</em>, <em>environ</em>, <em>request=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#RequestContext"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.RequestContext" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>The request context contains all request relevant information.  It is
-created at the beginning of the request and pushed to the
-<cite>_request_ctx_stack</cite> and removed at the end of it.  It will create the
-URL adapter and request object for the WSGI environment provided.</p>
-<p>Do not attempt to use this class directly, instead use
-<code class="xref py py-meth docutils literal"><span class="pre">test_request_context()</span></code> and
-<code class="xref py py-meth docutils literal"><span class="pre">request_context()</span></code> to create this object.</p>
-<p>When the request context is popped, it will evaluate all the
-functions registered on the application for teardown execution
-(<code class="xref py py-meth docutils literal"><span class="pre">teardown_request()</span></code>).</p>
-<p>The request context is automatically popped at the end of the request
-for you.  In debug mode the request context is kept around if
-exceptions happen so that interactive debuggers have a chance to
-introspect the data.  With 0.4 this can also be forced for requests
-that did not fail and outside of <code class="docutils literal"><span class="pre">DEBUG</span></code> mode.  By setting
-<code class="docutils literal"><span class="pre">'flask._preserve_context'</span></code> to <code class="docutils literal"><span class="pre">True</span></code> on the WSGI environment the
-context will not pop itself at the end of the request.  This is used by
-the <code class="xref py py-meth docutils literal"><span class="pre">test_client()</span></code> for example to implement the
-deferred cleanup functionality.</p>
-<p>You might find this helpful for unittests where you need the
-information from the context local around for a little longer.  Make
-sure to properly <code class="xref py py-meth docutils literal"><span class="pre">pop()</span></code> the stack yourself in
-that situation, otherwise your unittests will leak memory.</p>
-<dl class="method">
-<dt id="flask.ctx.RequestContext.auto_pop">
-<code class="descname">auto_pop</code><span class="sig-paren">(</span><em>exc</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#RequestContext.auto_pop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.RequestContext.auto_pop" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.ctx.RequestContext.copy">
-<code class="descname">copy</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#RequestContext.copy"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.RequestContext.copy" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a copy of this request context with the same request object.
-This can be used to move a request context to a different greenlet.
-Because the actual request object is the same this cannot be used to
-move a request context to a different thread unless access to the
-request object is locked.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.ctx.RequestContext.g">
-<code class="descname">g</code><a class="headerlink" href="#flask.ctx.RequestContext.g" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.ctx.RequestContext.match_request">
-<code class="descname">match_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#RequestContext.match_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.RequestContext.match_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Can be overridden by a subclass to hook into the matching
-of the request.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.ctx.RequestContext.pop">
-<code class="descname">pop</code><span class="sig-paren">(</span><em>exc=&lt;object object at 0x000001E1FDEFF780&gt;</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#RequestContext.pop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.RequestContext.pop" title="Permalink to this definition">¶</a></dt>
-<dd><p>Pops the request context and unbinds it by doing that.  This will
-also trigger the execution of functions registered by the
-<code class="xref py py-meth docutils literal"><span class="pre">teardown_request()</span></code> decorator.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.9: </span>Added the <cite>exc</cite> argument.</p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.ctx.RequestContext.push">
-<code class="descname">push</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#RequestContext.push"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.RequestContext.push" title="Permalink to this definition">¶</a></dt>
-<dd><p>Binds the request context to the current context.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.ctx.after_this_request">
-<code class="descclassname">flask.ctx.</code><code class="descname">after_this_request</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#after_this_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.after_this_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Executes a function after this request.  This is useful to modify
-response objects.  The function is passed the response object and has
-to return the same or a new one.</p>
-<p>Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="nd">@after_this_request</span>
-    <span class="k">def</span> <span class="nf">add_header</span><span class="p">(</span><span class="n">response</span><span class="p">):</span>
-        <span class="n">response</span><span class="o">.</span><span class="n">headers</span><span class="p">[</span><span class="s1">&#39;X-Foo&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;Parachute&#39;</span>
-        <span class="k">return</span> <span class="n">response</span>
-    <span class="k">return</span> <span class="s1">&#39;Hello World!&#39;</span>
-</pre></div>
-</div>
-<p>This is more useful if a function other than the view function wants to
-modify a response.  For instance think of a decorator that wants to add
-some headers without converting the return value into a response object.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.ctx.copy_current_request_context">
-<code class="descclassname">flask.ctx.</code><code class="descname">copy_current_request_context</code><span class="sig-paren">(</span><em>f</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#copy_current_request_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.copy_current_request_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>A helper function that decorates a function to retain the current
-request context.  This is useful when working with greenlets.  The moment
-the function is decorated a copy of the request context is created and
-then pushed when the function is called.</p>
-<p>Example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">gevent</span>
-<span class="kn">from</span> <span class="nn">flask</span> <span class="k">import</span> <span class="n">copy_current_request_context</span>
-
-<span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="nd">@copy_current_request_context</span>
-    <span class="k">def</span> <span class="nf">do_some_work</span><span class="p">():</span>
-        <span class="c1"># do some work here, it can access flask.request like you</span>
-        <span class="c1"># would otherwise in the view function.</span>
-        <span class="o">...</span>
-    <span class="n">gevent</span><span class="o">.</span><span class="n">spawn</span><span class="p">(</span><span class="n">do_some_work</span><span class="p">)</span>
-    <span class="k">return</span> <span class="s1">&#39;Regular response&#39;</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.ctx.has_app_context">
-<code class="descclassname">flask.ctx.</code><code class="descname">has_app_context</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#has_app_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.has_app_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Works like <a class="reference internal" href="#flask.ctx.has_request_context" title="flask.ctx.has_request_context"><code class="xref py py-func docutils literal"><span class="pre">has_request_context()</span></code></a> but for the application
-context.  You can also just do a boolean check on the
-<code class="xref py py-data docutils literal"><span class="pre">current_app</span></code> object instead.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.ctx.has_request_context">
-<code class="descclassname">flask.ctx.</code><code class="descname">has_request_context</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/ctx.html#has_request_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.ctx.has_request_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>If you have code that wants to test if a request context is there or
-not this function can be used.  For instance, you may want to take advantage
-of request information if the request object is available, but fail
-silently if it is unavailable.</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">User</span><span class="p">(</span><span class="n">db</span><span class="o">.</span><span class="n">Model</span><span class="p">):</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">username</span><span class="p">,</span> <span class="n">remote_addr</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">username</span> <span class="o">=</span> <span class="n">username</span>
-        <span class="k">if</span> <span class="n">remote_addr</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">has_request_context</span><span class="p">():</span>
-            <span class="n">remote_addr</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">remote_addr</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">remote_addr</span> <span class="o">=</span> <span class="n">remote_addr</span>
-</pre></div>
-</div>
-<p>Alternatively you can also just test any of the context bound objects
-(such as <code class="xref py py-class docutils literal"><span class="pre">request</span></code> or <code class="xref py py-class docutils literal"><span class="pre">g</span></code> for truthness):</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">User</span><span class="p">(</span><span class="n">db</span><span class="o">.</span><span class="n">Model</span><span class="p">):</span>
-
-    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">username</span><span class="p">,</span> <span class="n">remote_addr</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">username</span> <span class="o">=</span> <span class="n">username</span>
-        <span class="k">if</span> <span class="n">remote_addr</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">request</span><span class="p">:</span>
-            <span class="n">remote_addr</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">remote_addr</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">remote_addr</span> <span class="o">=</span> <span class="n">remote_addr</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.7.</span></p>
-</div>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.debughelpers">
-<span id="flask-debughelpers-module"></span><h2>flask.debughelpers module<a class="headerlink" href="#module-flask.debughelpers" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-debughelpers">
-<h3>flask.debughelpers<a class="headerlink" href="#flask-debughelpers" title="Permalink to this headline">¶</a></h3>
-<p>Various helpers to make the development experience better.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="exception">
-<dt id="flask.debughelpers.DebugFilesKeyError">
-<em class="property">exception </em><code class="descclassname">flask.debughelpers.</code><code class="descname">DebugFilesKeyError</code><span class="sig-paren">(</span><em>request</em>, <em>key</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/debughelpers.html#DebugFilesKeyError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.debughelpers.DebugFilesKeyError" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">KeyError</span></code>, <code class="xref py py-class docutils literal"><span class="pre">AssertionError</span></code></p>
-<p>Raised from request.files during debugging.  The idea is that it can
-provide a better error message than just a generic KeyError/BadRequest.</p>
-</dd></dl>
-
-<dl class="exception">
-<dt id="flask.debughelpers.FormDataRoutingRedirect">
-<em class="property">exception </em><code class="descclassname">flask.debughelpers.</code><code class="descname">FormDataRoutingRedirect</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/debughelpers.html#FormDataRoutingRedirect"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.debughelpers.FormDataRoutingRedirect" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">AssertionError</span></code></p>
-<p>This exception is raised by Flask in debug mode if it detects a
-redirect caused by the routing system when the request method is not
-GET, HEAD or OPTIONS.  Reasoning: form data will be dropped.</p>
-</dd></dl>
-
-<dl class="exception">
-<dt id="flask.debughelpers.UnexpectedUnicodeError">
-<em class="property">exception </em><code class="descclassname">flask.debughelpers.</code><code class="descname">UnexpectedUnicodeError</code><a class="reference internal" href="../_modules/flask/debughelpers.html#UnexpectedUnicodeError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.debughelpers.UnexpectedUnicodeError" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">AssertionError</span></code>, <code class="xref py py-class docutils literal"><span class="pre">UnicodeError</span></code></p>
-<p>Raised in places where we want some better error reporting for
-unexpected unicode or binary data.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.debughelpers.attach_enctype_error_multidict">
-<code class="descclassname">flask.debughelpers.</code><code class="descname">attach_enctype_error_multidict</code><span class="sig-paren">(</span><em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/debughelpers.html#attach_enctype_error_multidict"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.debughelpers.attach_enctype_error_multidict" title="Permalink to this definition">¶</a></dt>
-<dd><p>Since Flask 0.8 we&#8217;re monkeypatching the files object in case a
-request is detected that does not use multipart form data but the files
-object is accessed.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.debughelpers.explain_template_loading_attempts">
-<code class="descclassname">flask.debughelpers.</code><code class="descname">explain_template_loading_attempts</code><span class="sig-paren">(</span><em>app</em>, <em>template</em>, <em>attempts</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/debughelpers.html#explain_template_loading_attempts"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.debughelpers.explain_template_loading_attempts" title="Permalink to this definition">¶</a></dt>
-<dd><p>This should help developers understand what failed</p>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.exthook">
-<span id="flask-exthook-module"></span><h2>flask.exthook module<a class="headerlink" href="#module-flask.exthook" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-exthook">
-<h3>flask.exthook<a class="headerlink" href="#flask-exthook" title="Permalink to this headline">¶</a></h3>
-<p>Redirect imports for extensions.  This module basically makes it possible
-for us to transition from flaskext.foo to flask_foo without having to
-force all extensions to upgrade at the same time.</p>
-<p>When a user does <code class="docutils literal"><span class="pre">from</span> <span class="pre">flask.ext.foo</span> <span class="pre">import</span> <span class="pre">bar</span></code> it will attempt to
-import <code class="docutils literal"><span class="pre">from</span> <span class="pre">flask_foo</span> <span class="pre">import</span> <span class="pre">bar</span></code> first and when that fails it will
-try to import <code class="docutils literal"><span class="pre">from</span> <span class="pre">flaskext.foo</span> <span class="pre">import</span> <span class="pre">bar</span></code>.</p>
-<p>We&#8217;re switching from namespace packages because it was just too painful for
-everybody involved.</p>
-<p>This is used by <cite>flask.ext</cite>.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="exception">
-<dt id="flask.exthook.ExtDeprecationWarning">
-<em class="property">exception </em><code class="descclassname">flask.exthook.</code><code class="descname">ExtDeprecationWarning</code><a class="reference internal" href="../_modules/flask/exthook.html#ExtDeprecationWarning"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtDeprecationWarning" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">DeprecationWarning</span></code></p>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.exthook.ExtensionImporter">
-<em class="property">class </em><code class="descclassname">flask.exthook.</code><code class="descname">ExtensionImporter</code><span class="sig-paren">(</span><em>module_choices</em>, <em>wrapper_module</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/exthook.html#ExtensionImporter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtensionImporter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>This importer redirects imports from this submodule to other locations.
-This makes it possible to transition from the old flaskext.name to the
-newer flask_name without people having a hard time.</p>
-<dl class="method">
-<dt id="flask.exthook.ExtensionImporter.find_module">
-<code class="descname">find_module</code><span class="sig-paren">(</span><em>fullname</em>, <em>path=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/exthook.html#ExtensionImporter.find_module"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtensionImporter.find_module" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.exthook.ExtensionImporter.install">
-<code class="descname">install</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/exthook.html#ExtensionImporter.install"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtensionImporter.install" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.exthook.ExtensionImporter.is_important_frame">
-<code class="descname">is_important_frame</code><span class="sig-paren">(</span><em>important_module</em>, <em>tb</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/exthook.html#ExtensionImporter.is_important_frame"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtensionImporter.is_important_frame" title="Permalink to this definition">¶</a></dt>
-<dd><p>Checks a single frame if it&#8217;s important.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.exthook.ExtensionImporter.is_important_traceback">
-<code class="descname">is_important_traceback</code><span class="sig-paren">(</span><em>important_module</em>, <em>tb</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/exthook.html#ExtensionImporter.is_important_traceback"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtensionImporter.is_important_traceback" title="Permalink to this definition">¶</a></dt>
-<dd><p>Walks a traceback&#8217;s frames and checks if any of the frames
-originated in the given important module.  If that is the case then we
-were able to import the module itself but apparently something went
-wrong when the module was imported.  (Eg: import of an import failed).</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.exthook.ExtensionImporter.load_module">
-<code class="descname">load_module</code><span class="sig-paren">(</span><em>fullname</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/exthook.html#ExtensionImporter.load_module"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.exthook.ExtensionImporter.load_module" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.globals">
-<span id="flask-globals-module"></span><h2>flask.globals module<a class="headerlink" href="#module-flask.globals" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-globals">
-<h3>flask.globals<a class="headerlink" href="#flask-globals" title="Permalink to this headline">¶</a></h3>
-<p>Defines all the global objects that are proxies to the current
-active context.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="section" id="module-flask.helpers">
-<span id="flask-helpers-module"></span><h2>flask.helpers module<a class="headerlink" href="#module-flask.helpers" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-helpers">
-<h3>flask.helpers<a class="headerlink" href="#flask-helpers" title="Permalink to this headline">¶</a></h3>
-<p>Implements various helpers.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="function">
-<dt id="flask.helpers.find_package">
-<code class="descclassname">flask.helpers.</code><code class="descname">find_package</code><span class="sig-paren">(</span><em>import_name</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#find_package"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.find_package" title="Permalink to this definition">¶</a></dt>
-<dd><p>Finds a package and returns the prefix (or None if the package is
-not installed) as well as the folder that contains the package or
-module as a tuple.  The package path returned is the module that would
-have to be added to the pythonpath in order to make it possible to
-import the module.  The prefix is the path below which a UNIX like
-folder structure exists (lib, share etc.).</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.flash">
-<code class="descclassname">flask.helpers.</code><code class="descname">flash</code><span class="sig-paren">(</span><em>message</em>, <em>category='message'</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#flash"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.flash" title="Permalink to this definition">¶</a></dt>
-<dd><p>Flashes a message to the next request.  In order to remove the
-flashed message from the session and to display it to the user,
-the template has to call <a class="reference internal" href="#flask.helpers.get_flashed_messages" title="flask.helpers.get_flashed_messages"><code class="xref py py-func docutils literal"><span class="pre">get_flashed_messages()</span></code></a>.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.3: </span><cite>category</cite> parameter added.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>message</strong> &#8211; the message to be flashed.</li>
-<li><strong>category</strong> &#8211; the category for the message.  The following values
-are recommended: <code class="docutils literal"><span class="pre">'message'</span></code> for any kind of message,
-<code class="docutils literal"><span class="pre">'error'</span></code> for errors, <code class="docutils literal"><span class="pre">'info'</span></code> for information
-messages and <code class="docutils literal"><span class="pre">'warning'</span></code> for warnings.  However any
-kind of string can be used as category.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.get_debug_flag">
-<code class="descclassname">flask.helpers.</code><code class="descname">get_debug_flag</code><span class="sig-paren">(</span><em>default=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#get_debug_flag"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.get_debug_flag" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.get_flashed_messages">
-<code class="descclassname">flask.helpers.</code><code class="descname">get_flashed_messages</code><span class="sig-paren">(</span><em>with_categories=False</em>, <em>category_filter=[]</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#get_flashed_messages"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.get_flashed_messages" title="Permalink to this definition">¶</a></dt>
-<dd><p>Pulls all flashed messages from the session and returns them.
-Further calls in the same request to the function will return
-the same messages.  By default just the messages are returned,
-but when <cite>with_categories</cite> is set to <code class="docutils literal"><span class="pre">True</span></code>, the return value will
-be a list of tuples in the form <code class="docutils literal"><span class="pre">(category,</span> <span class="pre">message)</span></code> instead.</p>
-<p>Filter the flashed messages to one or more categories by providing those
-categories in <cite>category_filter</cite>.  This allows rendering categories in
-separate html blocks.  The <cite>with_categories</cite> and <cite>category_filter</cite>
-arguments are distinct:</p>
-<ul class="simple">
-<li><cite>with_categories</cite> controls whether categories are returned with message
-text (<code class="docutils literal"><span class="pre">True</span></code> gives a tuple, where <code class="docutils literal"><span class="pre">False</span></code> gives just the message text).</li>
-<li><cite>category_filter</cite> filters the messages down to only those matching the
-provided categories.</li>
-</ul>
-<p>See <span class="xref std std-ref">message-flashing-pattern</span> for examples.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.3: </span><cite>with_categories</cite> parameter added.</p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.9: </span><cite>category_filter</cite> parameter added.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>with_categories</strong> &#8211; set to <code class="docutils literal"><span class="pre">True</span></code> to also receive categories.</li>
-<li><strong>category_filter</strong> &#8211; whitelist of categories to limit return values</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.get_root_path">
-<code class="descclassname">flask.helpers.</code><code class="descname">get_root_path</code><span class="sig-paren">(</span><em>import_name</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#get_root_path"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.get_root_path" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns the path to a package or cwd if that cannot be found.  This
-returns the path of a package or the folder that contains a module.</p>
-<p>Not to be confused with the package path returned by <a class="reference internal" href="#flask.helpers.find_package" title="flask.helpers.find_package"><code class="xref py py-func docutils literal"><span class="pre">find_package()</span></code></a>.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.get_template_attribute">
-<code class="descclassname">flask.helpers.</code><code class="descname">get_template_attribute</code><span class="sig-paren">(</span><em>template_name</em>, <em>attribute</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#get_template_attribute"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.get_template_attribute" title="Permalink to this definition">¶</a></dt>
-<dd><p>Loads a macro (or variable) a template exports.  This can be used to
-invoke a macro from within Python code.  If you for example have a
-template named <code class="file docutils literal"><span class="pre">_cider.html</span></code> with the following contents:</p>
-<div class="highlight-html+jinja"><div class="highlight"><pre><span></span><span class="cp">{%</span> <span class="k">macro</span> <span class="nv">hello</span><span class="o">(</span><span class="nv">name</span><span class="o">)</span> <span class="cp">%}</span>Hello <span class="cp">{{</span> <span class="nv">name</span> <span class="cp">}}</span>!<span class="cp">{%</span> <span class="k">endmacro</span> <span class="cp">%}</span>
-</pre></div>
-</div>
-<p>You can access this from Python code like this:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">hello</span> <span class="o">=</span> <span class="n">get_template_attribute</span><span class="p">(</span><span class="s1">&#39;_cider.html&#39;</span><span class="p">,</span> <span class="s1">&#39;hello&#39;</span><span class="p">)</span>
-<span class="k">return</span> <span class="n">hello</span><span class="p">(</span><span class="s1">&#39;World&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.2.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>template_name</strong> &#8211; the name of the template</li>
-<li><strong>attribute</strong> &#8211; the name of the variable of macro to access</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.helpers.locked_cached_property">
-<em class="property">class </em><code class="descclassname">flask.helpers.</code><code class="descname">locked_cached_property</code><span class="sig-paren">(</span><em>func</em>, <em>name=None</em>, <em>doc=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#locked_cached_property"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.locked_cached_property" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>A decorator that converts a function into a lazy property.  The
-function wrapped is called the first time to retrieve the result
-and then that calculated result is used the next time you access
-the value.  Works like the one in Werkzeug but has a lock for
-thread safety.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.make_response">
-<code class="descclassname">flask.helpers.</code><code class="descname">make_response</code><span class="sig-paren">(</span><em>*args</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#make_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.make_response" title="Permalink to this definition">¶</a></dt>
-<dd><p>Sometimes it is necessary to set additional headers in a view.  Because
-views do not have to return response objects but can return a value that
-is converted into a response object by Flask itself, it becomes tricky to
-add headers to it.  This function can be called instead of using a return
-and you will get a response object which you can use to attach headers.</p>
-<p>If view looked like this and you want to add a new header:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="k">return</span> <span class="n">render_template</span><span class="p">(</span><span class="s1">&#39;index.html&#39;</span><span class="p">,</span> <span class="n">foo</span><span class="o">=</span><span class="mi">42</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>You can now do something like this:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">index</span><span class="p">():</span>
-    <span class="n">response</span> <span class="o">=</span> <span class="n">make_response</span><span class="p">(</span><span class="n">render_template</span><span class="p">(</span><span class="s1">&#39;index.html&#39;</span><span class="p">,</span> <span class="n">foo</span><span class="o">=</span><span class="mi">42</span><span class="p">))</span>
-    <span class="n">response</span><span class="o">.</span><span class="n">headers</span><span class="p">[</span><span class="s1">&#39;X-Parachutes&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;parachutes are cool&#39;</span>
-    <span class="k">return</span> <span class="n">response</span>
-</pre></div>
-</div>
-<p>This function accepts the very same arguments you can return from a
-view function.  This for example creates a response with a 404 error
-code:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">response</span> <span class="o">=</span> <span class="n">make_response</span><span class="p">(</span><span class="n">render_template</span><span class="p">(</span><span class="s1">&#39;not_found.html&#39;</span><span class="p">),</span> <span class="mi">404</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>The other use case of this function is to force the return value of a
-view function into a response which is helpful with view
-decorators:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">response</span> <span class="o">=</span> <span class="n">make_response</span><span class="p">(</span><span class="n">view_function</span><span class="p">())</span>
-<span class="n">response</span><span class="o">.</span><span class="n">headers</span><span class="p">[</span><span class="s1">&#39;X-Parachutes&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;parachutes are cool&#39;</span>
-</pre></div>
-</div>
-<p>Internally this function does the following things:</p>
-<ul class="simple">
-<li>if no arguments are passed, it creates a new response argument</li>
-<li>if one argument is passed, <code class="xref py py-meth docutils literal"><span class="pre">flask.Flask.make_response()</span></code>
-is invoked with it.</li>
-<li>if more than one argument is passed, the arguments are passed
-to the <code class="xref py py-meth docutils literal"><span class="pre">flask.Flask.make_response()</span></code> function as tuple.</li>
-</ul>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.6.</span></p>
-</div>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.safe_join">
-<code class="descclassname">flask.helpers.</code><code class="descname">safe_join</code><span class="sig-paren">(</span><em>directory</em>, <em>filename</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#safe_join"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.safe_join" title="Permalink to this definition">¶</a></dt>
-<dd><p>Safely join <cite>directory</cite> and <cite>filename</cite>.</p>
-<p>Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/wiki/&lt;path:filename&gt;&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">wiki_page</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
-    <span class="n">filename</span> <span class="o">=</span> <span class="n">safe_join</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;WIKI_FOLDER&#39;</span><span class="p">],</span> <span class="n">filename</span><span class="p">)</span>
-    <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="s1">&#39;rb&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">fd</span><span class="p">:</span>
-        <span class="n">content</span> <span class="o">=</span> <span class="n">fd</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>  <span class="c1"># Read and process the file content...</span>
-</pre></div>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
-<li><strong>directory</strong> &#8211; the base directory.</li>
-<li><strong>filename</strong> &#8211; the untrusted filename relative to that directory.</li>
-</ul>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal"><span class="pre">NotFound</span></code> if the resulting path
-would fall out of <cite>directory</cite>.</p>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.send_file">
-<code class="descclassname">flask.helpers.</code><code class="descname">send_file</code><span class="sig-paren">(</span><em>filename_or_fp</em>, <em>mimetype=None</em>, <em>as_attachment=False</em>, <em>attachment_filename=None</em>, <em>add_etags=True</em>, <em>cache_timeout=None</em>, <em>conditional=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#send_file"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.send_file" title="Permalink to this definition">¶</a></dt>
-<dd><p>Sends the contents of a file to the client.  This will use the
-most efficient method available and configured.  By default it will
-try to use the WSGI server&#8217;s file_wrapper support.  Alternatively
-you can set the application&#8217;s <code class="xref py py-attr docutils literal"><span class="pre">use_x_sendfile</span></code> attribute
-to <code class="docutils literal"><span class="pre">True</span></code> to directly emit an <code class="docutils literal"><span class="pre">X-Sendfile</span></code> header.  This however
-requires support of the underlying webserver for <code class="docutils literal"><span class="pre">X-Sendfile</span></code>.</p>
-<p>By default it will try to guess the mimetype for you, but you can
-also explicitly provide one.  For extra security you probably want
-to send certain files as attachment (HTML for instance).  The mimetype
-guessing requires a <cite>filename</cite> or an <cite>attachment_filename</cite> to be
-provided.</p>
-<p>Please never pass filenames to this function from user sources;
-you should use <a class="reference internal" href="#flask.helpers.send_from_directory" title="flask.helpers.send_from_directory"><code class="xref py py-func docutils literal"><span class="pre">send_from_directory()</span></code></a> instead.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.2.</span></p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.5: </span>The <cite>add_etags</cite>, <cite>cache_timeout</cite> and <cite>conditional</cite> parameters were
-added.  The default behavior is now to attach etags.</p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.7: </span>mimetype guessing and etag support for file objects was
-deprecated because it was unreliable.  Pass a filename if you are
-able to, otherwise attach an etag yourself.  This functionality
-will be removed in Flask 1.0</p>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.9: </span>cache_timeout pulls its default from application config, when None.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>filename_or_fp</strong> &#8211; the filename of the file to send in <cite>latin-1</cite>.
-This is relative to the <code class="xref py py-attr docutils literal"><span class="pre">root_path</span></code>
-if a relative path is specified.
-Alternatively a file object might be provided in
-which case <code class="docutils literal"><span class="pre">X-Sendfile</span></code> might not work and fall
-back to the traditional method.  Make sure that the
-file pointer is positioned at the start of data to
-send before calling <a class="reference internal" href="#flask.helpers.send_file" title="flask.helpers.send_file"><code class="xref py py-func docutils literal"><span class="pre">send_file()</span></code></a>.</li>
-<li><strong>mimetype</strong> &#8211; the mimetype of the file if provided, otherwise
-auto detection happens.</li>
-<li><strong>as_attachment</strong> &#8211; set to <code class="docutils literal"><span class="pre">True</span></code> if you want to send this file with
-a <code class="docutils literal"><span class="pre">Content-Disposition:</span> <span class="pre">attachment</span></code> header.</li>
-<li><strong>attachment_filename</strong> &#8211; the filename for the attachment if it
-differs from the file&#8217;s filename.</li>
-<li><strong>add_etags</strong> &#8211; set to <code class="docutils literal"><span class="pre">False</span></code> to disable attaching of etags.</li>
-<li><strong>conditional</strong> &#8211; set to <code class="docutils literal"><span class="pre">True</span></code> to enable conditional responses.</li>
-<li><strong>cache_timeout</strong> &#8211; the timeout in seconds for the headers. When <code class="docutils literal"><span class="pre">None</span></code>
-(default), this value is set by
-<code class="xref py py-meth docutils literal"><span class="pre">get_send_file_max_age()</span></code> of
-<code class="xref py py-data docutils literal"><span class="pre">current_app</span></code>.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.send_from_directory">
-<code class="descclassname">flask.helpers.</code><code class="descname">send_from_directory</code><span class="sig-paren">(</span><em>directory</em>, <em>filename</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#send_from_directory"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.send_from_directory" title="Permalink to this definition">¶</a></dt>
-<dd><p>Send a file from a given directory with <a class="reference internal" href="#flask.helpers.send_file" title="flask.helpers.send_file"><code class="xref py py-func docutils literal"><span class="pre">send_file()</span></code></a>.  This
-is a secure way to quickly expose static files from an upload folder
-or something similar.</p>
-<p>Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/uploads/&lt;path:filename&gt;&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">download_file</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
-    <span class="k">return</span> <span class="n">send_from_directory</span><span class="p">(</span><span class="n">app</span><span class="o">.</span><span class="n">config</span><span class="p">[</span><span class="s1">&#39;UPLOAD_FOLDER&#39;</span><span class="p">],</span>
-                               <span class="n">filename</span><span class="p">,</span> <span class="n">as_attachment</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</pre></div>
-</div>
-<div class="admonition-sending-files-and-performance admonition">
-<p class="first admonition-title">Sending files and Performance</p>
-<p class="last">It is strongly recommended to activate either <code class="docutils literal"><span class="pre">X-Sendfile</span></code> support in
-your webserver or (if no authentication happens) to tell the webserver
-to serve files for the given path on its own without calling into the
-web application for improved performance.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.5.</span></p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>directory</strong> &#8211; the directory where all the files are stored.</li>
-<li><strong>filename</strong> &#8211; the filename relative to that directory to
-download.</li>
-<li><strong>options</strong> &#8211; optional keyword arguments that are directly
-forwarded to <a class="reference internal" href="#flask.helpers.send_file" title="flask.helpers.send_file"><code class="xref py py-func docutils literal"><span class="pre">send_file()</span></code></a>.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.stream_with_context">
-<code class="descclassname">flask.helpers.</code><code class="descname">stream_with_context</code><span class="sig-paren">(</span><em>generator_or_function</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#stream_with_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.stream_with_context" title="Permalink to this definition">¶</a></dt>
-<dd><p>Request contexts disappear when the response is started on the server.
-This is done for efficiency reasons and to make it less likely to encounter
-memory leaks with badly written WSGI middlewares.  The downside is that if
-you are using streamed responses, the generator cannot access request bound
-information any more.</p>
-<p>This function however can help you keep the context around for longer:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">flask</span> <span class="k">import</span> <span class="n">stream_with_context</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">Response</span>
-
-<span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/stream&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">streamed_response</span><span class="p">():</span>
-    <span class="nd">@stream_with_context</span>
-    <span class="k">def</span> <span class="nf">generate</span><span class="p">():</span>
-        <span class="k">yield</span> <span class="s1">&#39;Hello &#39;</span>
-        <span class="k">yield</span> <span class="n">request</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span>
-        <span class="k">yield</span> <span class="s1">&#39;!&#39;</span>
-    <span class="k">return</span> <span class="n">Response</span><span class="p">(</span><span class="n">generate</span><span class="p">())</span>
-</pre></div>
-</div>
-<p>Alternatively it can also be used around a specific generator:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">flask</span> <span class="k">import</span> <span class="n">stream_with_context</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">Response</span>
-
-<span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/stream&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">streamed_response</span><span class="p">():</span>
-    <span class="k">def</span> <span class="nf">generate</span><span class="p">():</span>
-        <span class="k">yield</span> <span class="s1">&#39;Hello &#39;</span>
-        <span class="k">yield</span> <span class="n">request</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s1">&#39;name&#39;</span><span class="p">]</span>
-        <span class="k">yield</span> <span class="s1">&#39;!&#39;</span>
-    <span class="k">return</span> <span class="n">Response</span><span class="p">(</span><span class="n">stream_with_context</span><span class="p">(</span><span class="n">generate</span><span class="p">()))</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9.</span></p>
-</div>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.total_seconds">
-<code class="descclassname">flask.helpers.</code><code class="descname">total_seconds</code><span class="sig-paren">(</span><em>td</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#total_seconds"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.total_seconds" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns the total seconds from a timedelta object.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>td</strong> (<em>timedelta</em>) &#8211; the timedelta to be converted in seconds</td>
-</tr>
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">number of seconds</td>
-</tr>
-<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">int</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.helpers.url_for">
-<code class="descclassname">flask.helpers.</code><code class="descname">url_for</code><span class="sig-paren">(</span><em>endpoint</em>, <em>**values</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/helpers.html#url_for"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.helpers.url_for" title="Permalink to this definition">¶</a></dt>
-<dd><p>Generates a URL to the given endpoint with the method provided.</p>
-<p>Variable arguments that are unknown to the target endpoint are appended
-to the generated URL as query arguments.  If the value of a query argument
-is <code class="docutils literal"><span class="pre">None</span></code>, the whole pair is skipped.  In case blueprints are active
-you can shortcut references to the same blueprint by prefixing the
-local endpoint with a dot (<code class="docutils literal"><span class="pre">.</span></code>).</p>
-<p>This will reference the index function local to the current blueprint:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">url_for</span><span class="p">(</span><span class="s1">&#39;.index&#39;</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>For more information, head over to the <span class="xref std std-ref">Quickstart</span>.</p>
-<p>To integrate applications, <code class="xref py py-class docutils literal"><span class="pre">Flask</span></code> has a hook to intercept URL build
-errors through <code class="xref py py-attr docutils literal"><span class="pre">Flask.url_build_error_handlers</span></code>.  The <cite>url_for</cite>
-function results in a <code class="xref py py-exc docutils literal"><span class="pre">BuildError</span></code> when the current
-app does not have a URL for the given endpoint and values.  When it does, the
-<code class="xref py py-data docutils literal"><span class="pre">current_app</span></code> calls its <code class="xref py py-attr docutils literal"><span class="pre">url_build_error_handlers</span></code> if
-it is not <code class="docutils literal"><span class="pre">None</span></code>, which can return a string to use as the result of
-<cite>url_for</cite> (instead of <cite>url_for</cite>&#8216;s default to raise the
-<code class="xref py py-exc docutils literal"><span class="pre">BuildError</span></code> exception) or re-raise the exception.
-An example:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">external_url_handler</span><span class="p">(</span><span class="n">error</span><span class="p">,</span> <span class="n">endpoint</span><span class="p">,</span> <span class="n">values</span><span class="p">):</span>
-    <span class="s2">&quot;Looks up an external URL when `url_for` cannot build a URL.&quot;</span>
-    <span class="c1"># This is an example of hooking the build_error_handler.</span>
-    <span class="c1"># Here, lookup_url is some utility function you&#39;ve built</span>
-    <span class="c1"># which looks up the endpoint in some external URL registry.</span>
-    <span class="n">url</span> <span class="o">=</span> <span class="n">lookup_url</span><span class="p">(</span><span class="n">endpoint</span><span class="p">,</span> <span class="o">**</span><span class="n">values</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">url</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="c1"># External lookup did not have a URL.</span>
-        <span class="c1"># Re-raise the BuildError, in context of original traceback.</span>
-        <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-        <span class="k">if</span> <span class="n">exc_value</span> <span class="ow">is</span> <span class="n">error</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="n">error</span>
-    <span class="c1"># url_for will use this result, instead of raising BuildError.</span>
-    <span class="k">return</span> <span class="n">url</span>
-
-<span class="n">app</span><span class="o">.</span><span class="n">url_build_error_handlers</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">external_url_handler</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>Here, <cite>error</cite> is the instance of <code class="xref py py-exc docutils literal"><span class="pre">BuildError</span></code>, and
-<cite>endpoint</cite> and <cite>values</cite> are the arguments passed into <cite>url_for</cite>.  Note
-that this is for building URLs outside the current application, and not for
-handling 404 NotFound errors.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10: </span>The <cite>_scheme</cite> parameter was added.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9: </span>The <cite>_anchor</cite> and <cite>_method</cite> parameters were added.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.9: </span>Calls <code class="xref py py-meth docutils literal"><span class="pre">Flask.handle_build_error()</span></code> on
-<code class="xref py py-exc docutils literal"><span class="pre">BuildError</span></code>.</p>
-</div>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>endpoint</strong> &#8211; the endpoint of the URL (name of the function)</li>
-<li><strong>values</strong> &#8211; the variable arguments of the URL rule</li>
-<li><strong>_external</strong> &#8211; if set to <code class="docutils literal"><span class="pre">True</span></code>, an absolute URL is generated. Server
-address can be changed via <code class="docutils literal"><span class="pre">SERVER_NAME</span></code> configuration variable which
-defaults to <cite>localhost</cite>.</li>
-<li><strong>_scheme</strong> &#8211; a string specifying the desired URL scheme. The <cite>_external</cite>
-parameter must be set to <code class="docutils literal"><span class="pre">True</span></code> or a <code class="xref py py-exc docutils literal"><span class="pre">ValueError</span></code> is raised. The default
-behavior uses the same scheme as the current request, or
-<code class="docutils literal"><span class="pre">PREFERRED_URL_SCHEME</span></code> from the <span class="xref std std-ref">app configuration</span> if no
-request context is available. As of Werkzeug 0.10, this also can be set
-to an empty string to build protocol-relative URLs.</li>
-<li><strong>_anchor</strong> &#8211; if provided this is added as anchor to the URL.</li>
-<li><strong>_method</strong> &#8211; if provided this explicitly specifies an HTTP method.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.json">
-<span id="flask-json-module"></span><h2>flask.json module<a class="headerlink" href="#module-flask.json" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-jsonimpl">
-<h3>flask.jsonimpl<a class="headerlink" href="#flask-jsonimpl" title="Permalink to this headline">¶</a></h3>
-<p>Implementation helpers for the JSON support in Flask.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="function">
-<dt id="flask.json.dump">
-<code class="descclassname">flask.json.</code><code class="descname">dump</code><span class="sig-paren">(</span><em>obj</em>, <em>fp</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#dump"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.dump" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a> but writes into a file object.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.json.dumps">
-<code class="descclassname">flask.json.</code><code class="descname">dumps</code><span class="sig-paren">(</span><em>obj</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#dumps"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.dumps" title="Permalink to this definition">¶</a></dt>
-<dd><p>Serialize <code class="docutils literal"><span class="pre">obj</span></code> to a JSON formatted <code class="docutils literal"><span class="pre">str</span></code> by using the application&#8217;s
-configured encoder (<code class="xref py py-attr docutils literal"><span class="pre">json_encoder</span></code>) if there is an
-application on the stack.</p>
-<p>This function can return <code class="docutils literal"><span class="pre">unicode</span></code> strings or ascii-only bytestrings by
-default which coerce into unicode strings automatically.  That behavior by
-default is controlled by the <code class="docutils literal"><span class="pre">JSON_AS_ASCII</span></code> configuration variable
-and can be overridden by the simplejson <code class="docutils literal"><span class="pre">ensure_ascii</span></code> parameter.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.json.load">
-<code class="descclassname">flask.json.</code><code class="descname">load</code><span class="sig-paren">(</span><em>fp</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#load"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.load" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <a class="reference internal" href="#flask.json.loads" title="flask.json.loads"><code class="xref py py-func docutils literal"><span class="pre">loads()</span></code></a> but reads from a file object.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.json.loads">
-<code class="descclassname">flask.json.</code><code class="descname">loads</code><span class="sig-paren">(</span><em>s</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#loads"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.loads" title="Permalink to this definition">¶</a></dt>
-<dd><p>Unserialize a JSON object from a string <code class="docutils literal"><span class="pre">s</span></code> by using the application&#8217;s
-configured decoder (<code class="xref py py-attr docutils literal"><span class="pre">json_decoder</span></code>) if there is an
-application on the stack.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.json.htmlsafe_dump">
-<code class="descclassname">flask.json.</code><code class="descname">htmlsafe_dump</code><span class="sig-paren">(</span><em>obj</em>, <em>fp</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#htmlsafe_dump"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.htmlsafe_dump" title="Permalink to this definition">¶</a></dt>
-<dd><p>Like <a class="reference internal" href="#flask.json.htmlsafe_dumps" title="flask.json.htmlsafe_dumps"><code class="xref py py-func docutils literal"><span class="pre">htmlsafe_dumps()</span></code></a> but writes into a file object.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.json.htmlsafe_dumps">
-<code class="descclassname">flask.json.</code><code class="descname">htmlsafe_dumps</code><span class="sig-paren">(</span><em>obj</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#htmlsafe_dumps"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.htmlsafe_dumps" title="Permalink to this definition">¶</a></dt>
-<dd><p>Works exactly like <a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a> but is safe for use in <code class="docutils literal"><span class="pre">&lt;script&gt;</span></code>
-tags.  It accepts the same arguments and returns a JSON string.  Note that
-this is available in templates through the <code class="docutils literal"><span class="pre">|tojson</span></code> filter which will
-also mark the result as safe.  Due to how this function escapes certain
-characters this is safe even if used outside of <code class="docutils literal"><span class="pre">&lt;script&gt;</span></code> tags.</p>
-<p>The following characters are escaped in strings:</p>
-<ul class="simple">
-<li><code class="docutils literal"><span class="pre">&lt;</span></code></li>
-<li><code class="docutils literal"><span class="pre">&gt;</span></code></li>
-<li><code class="docutils literal"><span class="pre">&amp;</span></code></li>
-<li><code class="docutils literal"><span class="pre">'</span></code></li>
-</ul>
-<p>This makes it safe to embed such strings in any place in HTML with the
-notable exception of double quoted attributes.  In that case single
-quote your attributes or HTML escape it in addition.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.10: </span>This function&#8217;s return value is now always safe for HTML usage, even
-if outside of script tags or if used in XHTML.  This rule does not
-hold true when using this function in HTML attributes that are double
-quoted.  Always single quote attributes if you use the <code class="docutils literal"><span class="pre">|tojson</span></code>
-filter.  Alternatively use <code class="docutils literal"><span class="pre">|tojson|forceescape</span></code>.</p>
-</div>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.json.JSONDecoder">
-<em class="property">class </em><code class="descclassname">flask.json.</code><code class="descname">JSONDecoder</code><span class="sig-paren">(</span><em>encoding=None</em>, <em>object_hook=None</em>, <em>parse_float=None</em>, <em>parse_int=None</em>, <em>parse_constant=None</em>, <em>strict=True</em>, <em>object_pairs_hook=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#JSONDecoder"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.JSONDecoder" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">simplejson.decoder.JSONDecoder</span></code></p>
-<p>The default JSON decoder.  This one does not change the behavior from
-the default simplejson decoder.  Consult the <code class="xref py py-mod docutils literal"><span class="pre">json</span></code> documentation
-for more information.  This decoder is not only used for the load
-functions of this module but also <code class="xref py py-attr docutils literal"><span class="pre">Request</span></code>.</p>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.json.JSONEncoder">
-<em class="property">class </em><code class="descclassname">flask.json.</code><code class="descname">JSONEncoder</code><span class="sig-paren">(</span><em>skipkeys=False</em>, <em>ensure_ascii=True</em>, <em>check_circular=True</em>, <em>allow_nan=True</em>, <em>sort_keys=False</em>, <em>indent=None</em>, <em>separators=None</em>, <em>encoding='utf-8'</em>, <em>default=None</em>, <em>use_decimal=True</em>, <em>namedtuple_as_object=True</em>, <em>tuple_as_array=True</em>, <em>bigint_as_string=False</em>, <em>item_sort_key=None</em>, <em>for_json=False</em>, <em>ignore_nan=False</em>, <em>int_as_string_bitcount=None</em>, <em>iterable_as_array=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#JSONEncoder"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.JSONEncoder" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">simplejson.encoder.JSONEncoder</span></code></p>
-<p>The default Flask JSON encoder.  This one extends the default simplejson
-encoder by also supporting <code class="docutils literal"><span class="pre">datetime</span></code> objects, <code class="docutils literal"><span class="pre">UUID</span></code> as well as
-<code class="docutils literal"><span class="pre">Markup</span></code> objects which are serialized as RFC 822 datetime strings (same
-as the HTTP date format).  In order to support more data types override the
-<a class="reference internal" href="#flask.json.JSONEncoder.default" title="flask.json.JSONEncoder.default"><code class="xref py py-meth docutils literal"><span class="pre">default()</span></code></a> method.</p>
-<dl class="method">
-<dt id="flask.json.JSONEncoder.default">
-<code class="descname">default</code><span class="sig-paren">(</span><em>o</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#JSONEncoder.default"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.JSONEncoder.default" title="Permalink to this definition">¶</a></dt>
-<dd><p>Implement this method in a subclass such that it returns a
-serializable object for <code class="docutils literal"><span class="pre">o</span></code>, or calls the base implementation (to
-raise a <code class="xref py py-exc docutils literal"><span class="pre">TypeError</span></code>).</p>
-<p>For example, to support arbitrary iterators, you could implement
-default like this:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">default</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">o</span><span class="p">):</span>
-    <span class="k">try</span><span class="p">:</span>
-        <span class="n">iterable</span> <span class="o">=</span> <span class="nb">iter</span><span class="p">(</span><span class="n">o</span><span class="p">)</span>
-    <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span>
-        <span class="k">pass</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">iterable</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">JSONEncoder</span><span class="o">.</span><span class="n">default</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">o</span><span class="p">)</span>
-</pre></div>
-</div>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.json.jsonify">
-<code class="descclassname">flask.json.</code><code class="descname">jsonify</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/json.html#jsonify"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.json.jsonify" title="Permalink to this definition">¶</a></dt>
-<dd><p>This function wraps <a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a> to add a few enhancements that make
-life easier.  It turns the JSON output into a <code class="xref py py-class docutils literal"><span class="pre">Response</span></code>
-object with the <em class="mimetype">application/json</em> mimetype.  For convenience, it
-also converts multiple arguments into an array or multiple keyword arguments
-into a dict.  This means that both <code class="docutils literal"><span class="pre">jsonify(1,2,3)</span></code> and
-<code class="docutils literal"><span class="pre">jsonify([1,2,3])</span></code> serialize to <code class="docutils literal"><span class="pre">[1,2,3]</span></code>.</p>
-<p>For clarity, the JSON serialization behavior has the following differences
-from <a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a>:</p>
-<ol class="arabic simple">
-<li>Single argument: Passed straight through to <a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a>.</li>
-<li>Multiple arguments: Converted to an array before being passed to
-<a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a>.</li>
-<li>Multiple keyword arguments: Converted to a dict before being passed to
-<a class="reference internal" href="#flask.json.dumps" title="flask.json.dumps"><code class="xref py py-func docutils literal"><span class="pre">dumps()</span></code></a>.</li>
-<li>Both args and kwargs: Behavior undefined and will throw an exception.</li>
-</ol>
-<p>Example usage:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">flask</span> <span class="k">import</span> <span class="n">jsonify</span>
-
-<span class="nd">@app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/_get_current_user&#39;</span><span class="p">)</span>
-<span class="k">def</span> <span class="nf">get_current_user</span><span class="p">():</span>
-    <span class="k">return</span> <span class="n">jsonify</span><span class="p">(</span><span class="n">username</span><span class="o">=</span><span class="n">g</span><span class="o">.</span><span class="n">user</span><span class="o">.</span><span class="n">username</span><span class="p">,</span>
-                   <span class="n">email</span><span class="o">=</span><span class="n">g</span><span class="o">.</span><span class="n">user</span><span class="o">.</span><span class="n">email</span><span class="p">,</span>
-                   <span class="nb">id</span><span class="o">=</span><span class="n">g</span><span class="o">.</span><span class="n">user</span><span class="o">.</span><span class="n">id</span><span class="p">)</span>
-</pre></div>
-</div>
-<p>This will send a JSON response like this to the browser:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="p">{</span>
-    <span class="s2">&quot;username&quot;</span><span class="p">:</span> <span class="s2">&quot;admin&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;email&quot;</span><span class="p">:</span> <span class="s2">&quot;admin@localhost&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;id&quot;</span><span class="p">:</span> <span class="mi">42</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.11: </span>Added support for serializing top-level arrays. This introduces a
-security risk in ancient browsers. See <span class="xref std std-ref">json-security</span> for details.</p>
-</div>
-<p>This function&#8217;s response will be pretty printed if it was not requested
-with <code class="docutils literal"><span class="pre">X-Requested-With:</span> <span class="pre">XMLHttpRequest</span></code> to simplify debugging unless
-the <code class="docutils literal"><span class="pre">JSONIFY_PRETTYPRINT_REGULAR</span></code> config parameter is set to false.
-Compressed (not pretty) formatting currently means no indents and no
-spaces after separators.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.2.</span></p>
-</div>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.logging">
-<span id="flask-logging-module"></span><h2>flask.logging module<a class="headerlink" href="#module-flask.logging" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-logging">
-<h3>flask.logging<a class="headerlink" href="#flask-logging" title="Permalink to this headline">¶</a></h3>
-<p>Implements the logging support for Flask.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="function">
-<dt id="flask.logging.create_logger">
-<code class="descclassname">flask.logging.</code><code class="descname">create_logger</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/logging.html#create_logger"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.logging.create_logger" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a logger for the given application.  This logger works
-similar to a regular Python logger but changes the effective logging
-level based on the application&#8217;s debug flag.  Furthermore this
-function also removes all attached handlers in case there was a
-logger with the log name before.</p>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.sessions">
-<span id="flask-sessions-module"></span><h2>flask.sessions module<a class="headerlink" href="#module-flask.sessions" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-sessions">
-<h3>flask.sessions<a class="headerlink" href="#flask-sessions" title="Permalink to this headline">¶</a></h3>
-<p>Implements cookie based sessions based on itsdangerous.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.sessions.NullSession">
-<em class="property">class </em><code class="descclassname">flask.sessions.</code><code class="descname">NullSession</code><span class="sig-paren">(</span><em>initial=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#NullSession"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.NullSession" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <a class="reference internal" href="#flask.sessions.SecureCookieSession" title="flask.sessions.SecureCookieSession"><code class="xref py py-class docutils literal"><span class="pre">flask.sessions.SecureCookieSession</span></code></a></p>
-<p>Class used to generate nicer error messages if sessions are not
-available.  Will still allow read-only access to the empty session
-but fail on setting.</p>
-<dl class="method">
-<dt id="flask.sessions.NullSession.clear">
-<code class="descname">clear</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="headerlink" href="#flask.sessions.NullSession.clear" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.NullSession.pop">
-<code class="descname">pop</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="headerlink" href="#flask.sessions.NullSession.pop" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.NullSession.popitem">
-<code class="descname">popitem</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="headerlink" href="#flask.sessions.NullSession.popitem" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.NullSession.setdefault">
-<code class="descname">setdefault</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="headerlink" href="#flask.sessions.NullSession.setdefault" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.NullSession.update">
-<code class="descname">update</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="headerlink" href="#flask.sessions.NullSession.update" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.sessions.SecureCookieSession">
-<em class="property">class </em><code class="descclassname">flask.sessions.</code><code class="descname">SecureCookieSession</code><span class="sig-paren">(</span><em>initial=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SecureCookieSession"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SecureCookieSession" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">werkzeug.datastructures.CallbackDict</span></code>, <a class="reference internal" href="#flask.sessions.SessionMixin" title="flask.sessions.SessionMixin"><code class="xref py py-class docutils literal"><span class="pre">flask.sessions.SessionMixin</span></code></a></p>
-<p>Base class for sessions based on signed cookies.</p>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.sessions.SecureCookieSessionInterface">
-<em class="property">class </em><code class="descclassname">flask.sessions.</code><code class="descname">SecureCookieSessionInterface</code><a class="reference internal" href="../_modules/flask/sessions.html#SecureCookieSessionInterface"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <a class="reference internal" href="#flask.sessions.SessionInterface" title="flask.sessions.SessionInterface"><code class="xref py py-class docutils literal"><span class="pre">flask.sessions.SessionInterface</span></code></a></p>
-<p>The default session interface that stores sessions in signed cookies
-through the <code class="xref py py-mod docutils literal"><span class="pre">itsdangerous</span></code> module.</p>
-<dl class="staticmethod">
-<dt id="flask.sessions.SecureCookieSessionInterface.digest_method">
-<em class="property">static </em><code class="descname">digest_method</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.digest_method" title="Permalink to this definition">¶</a></dt>
-<dd><p>the hash function to use for the signature.  The default is sha1</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SecureCookieSessionInterface.get_signing_serializer">
-<code class="descname">get_signing_serializer</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SecureCookieSessionInterface.get_signing_serializer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.get_signing_serializer" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SecureCookieSessionInterface.key_derivation">
-<code class="descname">key_derivation</code><em class="property"> = 'hmac'</em><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.key_derivation" title="Permalink to this definition">¶</a></dt>
-<dd><p>the name of the itsdangerous supported key derivation.  The default
-is hmac.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SecureCookieSessionInterface.open_session">
-<code class="descname">open_session</code><span class="sig-paren">(</span><em>app</em>, <em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SecureCookieSessionInterface.open_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.open_session" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SecureCookieSessionInterface.salt">
-<code class="descname">salt</code><em class="property"> = 'cookie-session'</em><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.salt" title="Permalink to this definition">¶</a></dt>
-<dd><p>the salt that should be applied on top of the secret key for the
-signing of cookie based sessions.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SecureCookieSessionInterface.save_session">
-<code class="descname">save_session</code><span class="sig-paren">(</span><em>app</em>, <em>session</em>, <em>response</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SecureCookieSessionInterface.save_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.save_session" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SecureCookieSessionInterface.serializer">
-<code class="descname">serializer</code><em class="property"> = &lt;flask.sessions.TaggedJSONSerializer object at 0x000001E1821A4C18&gt;</em><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.serializer" title="Permalink to this definition">¶</a></dt>
-<dd><p>A python serializer for the payload.  The default is a compact
-JSON derived serializer with support for some extra Python types
-such as datetime objects or tuples.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SecureCookieSessionInterface.session_class">
-<code class="descname">session_class</code><a class="headerlink" href="#flask.sessions.SecureCookieSessionInterface.session_class" title="Permalink to this definition">¶</a></dt>
-<dd><p>alias of <a class="reference internal" href="#flask.sessions.SecureCookieSession" title="flask.sessions.SecureCookieSession"><code class="xref py py-class docutils literal"><span class="pre">SecureCookieSession</span></code></a></p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.sessions.SessionInterface">
-<em class="property">class </em><code class="descclassname">flask.sessions.</code><code class="descname">SessionInterface</code><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>The basic interface you have to implement in order to replace the
-default session interface which uses werkzeug&#8217;s securecookie
-implementation.  The only methods you have to implement are
-<a class="reference internal" href="#flask.sessions.SessionInterface.open_session" title="flask.sessions.SessionInterface.open_session"><code class="xref py py-meth docutils literal"><span class="pre">open_session()</span></code></a> and <a class="reference internal" href="#flask.sessions.SessionInterface.save_session" title="flask.sessions.SessionInterface.save_session"><code class="xref py py-meth docutils literal"><span class="pre">save_session()</span></code></a>, the others have
-useful defaults which you don&#8217;t need to change.</p>
-<p>The session object returned by the <a class="reference internal" href="#flask.sessions.SessionInterface.open_session" title="flask.sessions.SessionInterface.open_session"><code class="xref py py-meth docutils literal"><span class="pre">open_session()</span></code></a> method has to
-provide a dictionary like interface plus the properties and methods
-from the <a class="reference internal" href="#flask.sessions.SessionMixin" title="flask.sessions.SessionMixin"><code class="xref py py-class docutils literal"><span class="pre">SessionMixin</span></code></a>.  We recommend just subclassing a dict
-and adding that mixin:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">Session</span><span class="p">(</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SessionMixin</span><span class="p">):</span>
-    <span class="k">pass</span>
-</pre></div>
-</div>
-<p>If <a class="reference internal" href="#flask.sessions.SessionInterface.open_session" title="flask.sessions.SessionInterface.open_session"><code class="xref py py-meth docutils literal"><span class="pre">open_session()</span></code></a> returns <code class="docutils literal"><span class="pre">None</span></code> Flask will call into
-<a class="reference internal" href="#flask.sessions.SessionInterface.make_null_session" title="flask.sessions.SessionInterface.make_null_session"><code class="xref py py-meth docutils literal"><span class="pre">make_null_session()</span></code></a> to create a session that acts as replacement
-if the session support cannot work because some requirement is not
-fulfilled.  The default <a class="reference internal" href="#flask.sessions.NullSession" title="flask.sessions.NullSession"><code class="xref py py-class docutils literal"><span class="pre">NullSession</span></code></a> class that is created
-will complain that the secret key was not set.</p>
-<p>To replace the session interface on an application all you have to do
-is to assign <code class="xref py py-attr docutils literal"><span class="pre">flask.Flask.session_interface</span></code>:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">app</span> <span class="o">=</span> <span class="n">Flask</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
-<span class="n">app</span><span class="o">.</span><span class="n">session_interface</span> <span class="o">=</span> <span class="n">MySessionInterface</span><span class="p">()</span>
-</pre></div>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.get_cookie_domain">
-<code class="descname">get_cookie_domain</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.get_cookie_domain"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.get_cookie_domain" title="Permalink to this definition">¶</a></dt>
-<dd><p>Helpful helper method that returns the cookie domain that should
-be used for the session cookie if session cookies are used.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.get_cookie_httponly">
-<code class="descname">get_cookie_httponly</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.get_cookie_httponly"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.get_cookie_httponly" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns True if the session cookie should be httponly.  This
-currently just returns the value of the <code class="docutils literal"><span class="pre">SESSION_COOKIE_HTTPONLY</span></code>
-config var.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.get_cookie_path">
-<code class="descname">get_cookie_path</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.get_cookie_path"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.get_cookie_path" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns the path for which the cookie should be valid.  The
-default implementation uses the value from the <code class="docutils literal"><span class="pre">SESSION_COOKIE_PATH</span></code>
-config var if it&#8217;s set, and falls back to <code class="docutils literal"><span class="pre">APPLICATION_ROOT</span></code> or
-uses <code class="docutils literal"><span class="pre">/</span></code> if it&#8217;s <code class="docutils literal"><span class="pre">None</span></code>.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.get_cookie_secure">
-<code class="descname">get_cookie_secure</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.get_cookie_secure"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.get_cookie_secure" title="Permalink to this definition">¶</a></dt>
-<dd><p>Returns True if the cookie should be secure.  This currently
-just returns the value of the <code class="docutils literal"><span class="pre">SESSION_COOKIE_SECURE</span></code> setting.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.get_expiration_time">
-<code class="descname">get_expiration_time</code><span class="sig-paren">(</span><em>app</em>, <em>session</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.get_expiration_time"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.get_expiration_time" title="Permalink to this definition">¶</a></dt>
-<dd><p>A helper method that returns an expiration date for the session
-or <code class="docutils literal"><span class="pre">None</span></code> if the session is linked to the browser session.  The
-default implementation returns now + the permanent session
-lifetime configured on the application.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.is_null_session">
-<code class="descname">is_null_session</code><span class="sig-paren">(</span><em>obj</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.is_null_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.is_null_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>Checks if a given object is a null session.  Null sessions are
-not asked to be saved.</p>
-<p>This checks if the object is an instance of <a class="reference internal" href="#flask.sessions.SessionInterface.null_session_class" title="flask.sessions.SessionInterface.null_session_class"><code class="xref py py-attr docutils literal"><span class="pre">null_session_class</span></code></a>
-by default.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.make_null_session">
-<code class="descname">make_null_session</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.make_null_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.make_null_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a null session which acts as a replacement object if the
-real session support could not be loaded due to a configuration
-error.  This mainly aids the user experience because the job of the
-null session is to still support lookup without complaining but
-modifications are answered with a helpful error message of what
-failed.</p>
-<p>This creates an instance of <a class="reference internal" href="#flask.sessions.SessionInterface.null_session_class" title="flask.sessions.SessionInterface.null_session_class"><code class="xref py py-attr docutils literal"><span class="pre">null_session_class</span></code></a> by default.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SessionInterface.null_session_class">
-<code class="descname">null_session_class</code><a class="headerlink" href="#flask.sessions.SessionInterface.null_session_class" title="Permalink to this definition">¶</a></dt>
-<dd><p><a class="reference internal" href="#flask.sessions.SessionInterface.make_null_session" title="flask.sessions.SessionInterface.make_null_session"><code class="xref py py-meth docutils literal"><span class="pre">make_null_session()</span></code></a> will look here for the class that should
-be created when a null session is requested.  Likewise the
-<a class="reference internal" href="#flask.sessions.SessionInterface.is_null_session" title="flask.sessions.SessionInterface.is_null_session"><code class="xref py py-meth docutils literal"><span class="pre">is_null_session()</span></code></a> method will perform a typecheck against
-this type.</p>
-<p>alias of <a class="reference internal" href="#flask.sessions.NullSession" title="flask.sessions.NullSession"><code class="xref py py-class docutils literal"><span class="pre">NullSession</span></code></a></p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.open_session">
-<code class="descname">open_session</code><span class="sig-paren">(</span><em>app</em>, <em>request</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.open_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.open_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>This method has to be implemented and must either return <code class="docutils literal"><span class="pre">None</span></code>
-in case the loading failed because of a configuration error or an
-instance of a session object which implements a dictionary like
-interface + the methods and attributes on <a class="reference internal" href="#flask.sessions.SessionMixin" title="flask.sessions.SessionMixin"><code class="xref py py-class docutils literal"><span class="pre">SessionMixin</span></code></a>.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SessionInterface.pickle_based">
-<code class="descname">pickle_based</code><em class="property"> = False</em><a class="headerlink" href="#flask.sessions.SessionInterface.pickle_based" title="Permalink to this definition">¶</a></dt>
-<dd><p>A flag that indicates if the session interface is pickle based.
-This can be used by flask extensions to make a decision in regards
-to how to deal with the session object.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.10.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.save_session">
-<code class="descname">save_session</code><span class="sig-paren">(</span><em>app</em>, <em>session</em>, <em>response</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.save_session"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.save_session" title="Permalink to this definition">¶</a></dt>
-<dd><p>This is called for actual sessions returned by <a class="reference internal" href="#flask.sessions.SessionInterface.open_session" title="flask.sessions.SessionInterface.open_session"><code class="xref py py-meth docutils literal"><span class="pre">open_session()</span></code></a>
-at the end of the request.  This is still called during a request
-context so if you absolutely need access to the request you can do
-that.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.SessionInterface.should_set_cookie">
-<code class="descname">should_set_cookie</code><span class="sig-paren">(</span><em>app</em>, <em>session</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#SessionInterface.should_set_cookie"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionInterface.should_set_cookie" title="Permalink to this definition">¶</a></dt>
-<dd><p>Indicates whether a cookie should be set now or not.  This is
-used by session backends to figure out if they should emit a
-set-cookie header or not.  The default behavior is controlled by
-the <code class="docutils literal"><span class="pre">SESSION_REFRESH_EACH_REQUEST</span></code> config variable.  If
-it&#8217;s set to <code class="docutils literal"><span class="pre">False</span></code> then a cookie is only set if the session is
-modified, if set to <code class="docutils literal"><span class="pre">True</span></code> it&#8217;s always set if the session is
-permanent.</p>
-<p>This check is usually skipped if sessions get deleted.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.sessions.SessionMixin">
-<em class="property">class </em><code class="descclassname">flask.sessions.</code><code class="descname">SessionMixin</code><a class="reference internal" href="../_modules/flask/sessions.html#SessionMixin"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.SessionMixin" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Expands a basic dictionary with an accessors that are expected
-by Flask extensions and users for the session.</p>
-<dl class="attribute">
-<dt id="flask.sessions.SessionMixin.modified">
-<code class="descname">modified</code><em class="property"> = True</em><a class="headerlink" href="#flask.sessions.SessionMixin.modified" title="Permalink to this definition">¶</a></dt>
-<dd><p>for some backends this will always be <code class="docutils literal"><span class="pre">True</span></code>, but some backends will
-default this to false and detect changes in the dictionary for as
-long as changes do not happen on mutable structures in the session.
-The default mixin implementation just hardcodes <code class="docutils literal"><span class="pre">True</span></code> in.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SessionMixin.new">
-<code class="descname">new</code><em class="property"> = False</em><a class="headerlink" href="#flask.sessions.SessionMixin.new" title="Permalink to this definition">¶</a></dt>
-<dd><p>some session backends can tell you if a session is new, but that is
-not necessarily guaranteed.  Use with caution.  The default mixin
-implementation just hardcodes <code class="docutils literal"><span class="pre">False</span></code> in.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.sessions.SessionMixin.permanent">
-<code class="descname">permanent</code><a class="headerlink" href="#flask.sessions.SessionMixin.permanent" title="Permalink to this definition">¶</a></dt>
-<dd><p>this reflects the <code class="docutils literal"><span class="pre">'_permanent'</span></code> key in the dict.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.sessions.TaggedJSONSerializer">
-<em class="property">class </em><code class="descclassname">flask.sessions.</code><code class="descname">TaggedJSONSerializer</code><a class="reference internal" href="../_modules/flask/sessions.html#TaggedJSONSerializer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.TaggedJSONSerializer" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>A customized JSON serializer that supports a few extra types that
-we take for granted when serializing (tuples, markup objects, datetime).</p>
-<dl class="method">
-<dt id="flask.sessions.TaggedJSONSerializer.dumps">
-<code class="descname">dumps</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#TaggedJSONSerializer.dumps"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.TaggedJSONSerializer.dumps" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.sessions.TaggedJSONSerializer.loads">
-<code class="descname">loads</code><span class="sig-paren">(</span><em>value</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/sessions.html#TaggedJSONSerializer.loads"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.sessions.TaggedJSONSerializer.loads" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.signals">
-<span id="flask-signals-module"></span><h2>flask.signals module<a class="headerlink" href="#module-flask.signals" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-signals">
-<h3>flask.signals<a class="headerlink" href="#flask-signals" title="Permalink to this headline">¶</a></h3>
-<p>Implements signals based on blinker if available, otherwise
-falls silently back to a noop.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.signals.Namespace">
-<em class="property">class </em><code class="descclassname">flask.signals.</code><code class="descname">Namespace</code><a class="reference internal" href="../_modules/flask/signals.html#Namespace"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.signals.Namespace" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<dl class="method">
-<dt id="flask.signals.Namespace.signal">
-<code class="descname">signal</code><span class="sig-paren">(</span><em>name</em>, <em>doc=None</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/signals.html#Namespace.signal"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.signals.Namespace.signal" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.templating">
-<span id="flask-templating-module"></span><h2>flask.templating module<a class="headerlink" href="#module-flask.templating" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-templating">
-<h3>flask.templating<a class="headerlink" href="#flask-templating" title="Permalink to this headline">¶</a></h3>
-<p>Implements the bridge to Jinja2.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.templating.DispatchingJinjaLoader">
-<em class="property">class </em><code class="descclassname">flask.templating.</code><code class="descname">DispatchingJinjaLoader</code><span class="sig-paren">(</span><em>app</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/templating.html#DispatchingJinjaLoader"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.templating.DispatchingJinjaLoader" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">jinja2.loaders.BaseLoader</span></code></p>
-<p>A loader that looks for templates in the application and all
-the blueprint folders.</p>
-<dl class="method">
-<dt id="flask.templating.DispatchingJinjaLoader.get_source">
-<code class="descname">get_source</code><span class="sig-paren">(</span><em>environment</em>, <em>template</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/templating.html#DispatchingJinjaLoader.get_source"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.templating.DispatchingJinjaLoader.get_source" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.templating.DispatchingJinjaLoader.list_templates">
-<code class="descname">list_templates</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/templating.html#DispatchingJinjaLoader.list_templates"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.templating.DispatchingJinjaLoader.list_templates" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.templating.Environment">
-<em class="property">class </em><code class="descclassname">flask.templating.</code><code class="descname">Environment</code><span class="sig-paren">(</span><em>app</em>, <em>**options</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/templating.html#Environment"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.templating.Environment" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">jinja2.environment.Environment</span></code></p>
-<p>Works like a regular Jinja2 environment but has some additional
-knowledge of how Flask&#8217;s blueprint works so that it can prepend the
-name of the blueprint to referenced templates if necessary.</p>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.templating.render_template">
-<code class="descclassname">flask.templating.</code><code class="descname">render_template</code><span class="sig-paren">(</span><em>template_name_or_list</em>, <em>**context</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/templating.html#render_template"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.templating.render_template" title="Permalink to this definition">¶</a></dt>
-<dd><p>Renders a template from the template folder with the given
-context.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>template_name_or_list</strong> &#8211; the name of the template to be
-rendered, or an iterable with template names
-the first one existing will be rendered</li>
-<li><strong>context</strong> &#8211; the variables that should be available in the
-context of the template.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.templating.render_template_string">
-<code class="descclassname">flask.templating.</code><code class="descname">render_template_string</code><span class="sig-paren">(</span><em>source</em>, <em>**context</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/templating.html#render_template_string"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.templating.render_template_string" title="Permalink to this definition">¶</a></dt>
-<dd><p>Renders a template from the given template source string
-with the given context. Template variables will be autoescaped.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>source</strong> &#8211; the source code of the template to be
-rendered</li>
-<li><strong>context</strong> &#8211; the variables that should be available in the
-context of the template.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.testing">
-<span id="flask-testing-module"></span><h2>flask.testing module<a class="headerlink" href="#module-flask.testing" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-testing">
-<h3>flask.testing<a class="headerlink" href="#flask-testing" title="Permalink to this headline">¶</a></h3>
-<p>Implements test support helpers.  This module is lazily imported
-and usually not used in production environments.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.testing.FlaskClient">
-<em class="property">class </em><code class="descclassname">flask.testing.</code><code class="descname">FlaskClient</code><span class="sig-paren">(</span><em>application</em>, <em>response_wrapper=None</em>, <em>use_cookies=True</em>, <em>allow_subdomain_redirects=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/testing.html#FlaskClient"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.testing.FlaskClient" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">werkzeug.test.Client</span></code></p>
-<p>Works like a regular Werkzeug test client but has some knowledge about
-how Flask works to defer the cleanup of the request context stack to the
-end of a <code class="docutils literal"><span class="pre">with</span></code> body when used in a <code class="docutils literal"><span class="pre">with</span></code> statement.  For general
-information about how to use this class refer to
-<code class="xref py py-class docutils literal"><span class="pre">werkzeug.test.Client</span></code>.</p>
-<p>Basic usage is outlined in the <span class="xref std std-ref">testing</span> chapter.</p>
-<dl class="method">
-<dt id="flask.testing.FlaskClient.open">
-<code class="descname">open</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/testing.html#FlaskClient.open"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.testing.FlaskClient.open" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="attribute">
-<dt id="flask.testing.FlaskClient.preserve_context">
-<code class="descname">preserve_context</code><em class="property"> = False</em><a class="headerlink" href="#flask.testing.FlaskClient.preserve_context" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="flask.testing.FlaskClient.session_transaction">
-<code class="descname">session_transaction</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/testing.html#FlaskClient.session_transaction"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.testing.FlaskClient.session_transaction" title="Permalink to this definition">¶</a></dt>
-<dd><p>When used in combination with a <code class="docutils literal"><span class="pre">with</span></code> statement this opens a
-session transaction.  This can be used to modify the session that
-the test client uses.  Once the <code class="docutils literal"><span class="pre">with</span></code> block is left the session is
-stored back.</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">with</span> <span class="n">client</span><span class="o">.</span><span class="n">session_transaction</span><span class="p">()</span> <span class="k">as</span> <span class="n">session</span><span class="p">:</span>
-    <span class="n">session</span><span class="p">[</span><span class="s1">&#39;value&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="mi">42</span>
-</pre></div>
-</div>
-<p>Internally this is implemented by going through a temporary test
-request context and since session handling could depend on
-request variables this function accepts the same arguments as
-<code class="xref py py-meth docutils literal"><span class="pre">test_request_context()</span></code> which are directly
-passed through.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="function">
-<dt id="flask.testing.make_test_environ_builder">
-<code class="descclassname">flask.testing.</code><code class="descname">make_test_environ_builder</code><span class="sig-paren">(</span><em>app</em>, <em>path='/'</em>, <em>base_url=None</em>, <em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/testing.html#make_test_environ_builder"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.testing.make_test_environ_builder" title="Permalink to this definition">¶</a></dt>
-<dd><p>Creates a new test builder with some application defaults thrown in.</p>
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.views">
-<span id="flask-views-module"></span><h2>flask.views module<a class="headerlink" href="#module-flask.views" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-views">
-<h3>flask.views<a class="headerlink" href="#flask-views" title="Permalink to this headline">¶</a></h3>
-<p>This module provides class-based views inspired by the ones in Django.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.views.MethodView">
-<em class="property">class </em><code class="descclassname">flask.views.</code><code class="descname">MethodView</code><a class="reference internal" href="../_modules/flask/views.html#MethodView"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.views.MethodView" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <a class="reference internal" href="#flask.views.View" title="flask.views.View"><code class="xref py py-class docutils literal"><span class="pre">flask.views.View</span></code></a></p>
-<p>Like a regular class-based view but that dispatches requests to
-particular methods.  For instance if you implement a method called
-<code class="xref py py-meth docutils literal"><span class="pre">get()</span></code> it means you will response to <code class="docutils literal"><span class="pre">'GET'</span></code> requests and
-the <a class="reference internal" href="#flask.views.MethodView.dispatch_request" title="flask.views.MethodView.dispatch_request"><code class="xref py py-meth docutils literal"><span class="pre">dispatch_request()</span></code></a> implementation will automatically
-forward your request to that.  Also <code class="xref py py-attr docutils literal"><span class="pre">options</span></code> is set for you
-automatically:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">CounterAPI</span><span class="p">(</span><span class="n">MethodView</span><span class="p">):</span>
-
-    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">session</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;counter&#39;</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
-
-    <span class="k">def</span> <span class="nf">post</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="n">session</span><span class="p">[</span><span class="s1">&#39;counter&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">session</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;counter&#39;</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span>
-        <span class="k">return</span> <span class="s1">&#39;OK&#39;</span>
-
-<span class="n">app</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="s1">&#39;/counter&#39;</span><span class="p">,</span> <span class="n">view_func</span><span class="o">=</span><span class="n">CounterAPI</span><span class="o">.</span><span class="n">as_view</span><span class="p">(</span><span class="s1">&#39;counter&#39;</span><span class="p">))</span>
-</pre></div>
-</div>
-<dl class="method">
-<dt id="flask.views.MethodView.dispatch_request">
-<code class="descname">dispatch_request</code><span class="sig-paren">(</span><em>*args</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/views.html#MethodView.dispatch_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.views.MethodView.dispatch_request" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.views.MethodViewType">
-<em class="property">class </em><code class="descclassname">flask.views.</code><code class="descname">MethodViewType</code><a class="reference internal" href="../_modules/flask/views.html#MethodViewType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.views.MethodViewType" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">type</span></code></p>
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.views.View">
-<em class="property">class </em><code class="descclassname">flask.views.</code><code class="descname">View</code><a class="reference internal" href="../_modules/flask/views.html#View"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.views.View" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Alternative way to use view functions.  A subclass has to implement
-<a class="reference internal" href="#flask.views.View.dispatch_request" title="flask.views.View.dispatch_request"><code class="xref py py-meth docutils literal"><span class="pre">dispatch_request()</span></code></a> which is called with the view arguments from
-the URL routing system.  If <a class="reference internal" href="#flask.views.View.methods" title="flask.views.View.methods"><code class="xref py py-attr docutils literal"><span class="pre">methods</span></code></a> is provided the methods
-do not have to be passed to the <code class="xref py py-meth docutils literal"><span class="pre">add_url_rule()</span></code>
-method explicitly:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">MyView</span><span class="p">(</span><span class="n">View</span><span class="p">):</span>
-    <span class="n">methods</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;GET&#39;</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">dispatch_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span>
-        <span class="k">return</span> <span class="s1">&#39;Hello </span><span class="si">%s</span><span class="s1">!&#39;</span> <span class="o">%</span> <span class="n">name</span>
-
-<span class="n">app</span><span class="o">.</span><span class="n">add_url_rule</span><span class="p">(</span><span class="s1">&#39;/hello/&lt;name&gt;&#39;</span><span class="p">,</span> <span class="n">view_func</span><span class="o">=</span><span class="n">MyView</span><span class="o">.</span><span class="n">as_view</span><span class="p">(</span><span class="s1">&#39;myview&#39;</span><span class="p">))</span>
-</pre></div>
-</div>
-<p>When you want to decorate a pluggable view you will have to either do that
-when the view function is created (by wrapping the return value of
-<a class="reference internal" href="#flask.views.View.as_view" title="flask.views.View.as_view"><code class="xref py py-meth docutils literal"><span class="pre">as_view()</span></code></a>) or you can use the <a class="reference internal" href="#flask.views.View.decorators" title="flask.views.View.decorators"><code class="xref py py-attr docutils literal"><span class="pre">decorators</span></code></a> attribute:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">SecretView</span><span class="p">(</span><span class="n">View</span><span class="p">):</span>
-    <span class="n">methods</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;GET&#39;</span><span class="p">]</span>
-    <span class="n">decorators</span> <span class="o">=</span> <span class="p">[</span><span class="n">superuser_required</span><span class="p">]</span>
-
-    <span class="k">def</span> <span class="nf">dispatch_request</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="o">...</span>
-</pre></div>
-</div>
-<p>The decorators stored in the decorators list are applied one after another
-when the view function is created.  Note that you can <em>not</em> use the class
-based decorators since those would decorate the view class and not the
-generated view function!</p>
-<dl class="classmethod">
-<dt id="flask.views.View.as_view">
-<em class="property">classmethod </em><code class="descname">as_view</code><span class="sig-paren">(</span><em>name</em>, <em>*class_args</em>, <em>**class_kwargs</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/views.html#View.as_view"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.views.View.as_view" title="Permalink to this definition">¶</a></dt>
-<dd><p>Converts the class into an actual view function that can be used
-with the routing system.  Internally this generates a function on the
-fly which will instantiate the <a class="reference internal" href="#flask.views.View" title="flask.views.View"><code class="xref py py-class docutils literal"><span class="pre">View</span></code></a> on each request and call
-the <a class="reference internal" href="#flask.views.View.dispatch_request" title="flask.views.View.dispatch_request"><code class="xref py py-meth docutils literal"><span class="pre">dispatch_request()</span></code></a> method on it.</p>
-<p>The arguments passed to <a class="reference internal" href="#flask.views.View.as_view" title="flask.views.View.as_view"><code class="xref py py-meth docutils literal"><span class="pre">as_view()</span></code></a> are forwarded to the
-constructor of the class.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.views.View.decorators">
-<code class="descname">decorators</code><em class="property"> = ()</em><a class="headerlink" href="#flask.views.View.decorators" title="Permalink to this definition">¶</a></dt>
-<dd><p>The canonical way to decorate class-based views is to decorate the
-return value of as_view().  However since this moves parts of the
-logic from the class declaration to the place where it&#8217;s hooked
-into the routing system.</p>
-<p>You can place one or more decorators in this list and whenever the
-view function is created the result is automatically decorated.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.views.View.dispatch_request">
-<code class="descname">dispatch_request</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/views.html#View.dispatch_request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.views.View.dispatch_request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Subclasses have to override this method to implement the
-actual view function code.  This method is called with all
-the arguments from the URL rule.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.views.View.methods">
-<code class="descname">methods</code><em class="property"> = None</em><a class="headerlink" href="#flask.views.View.methods" title="Permalink to this definition">¶</a></dt>
-<dd><p>A list of methods this view can handle.</p>
-</dd></dl>
-
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask.wrappers">
-<span id="flask-wrappers-module"></span><h2>flask.wrappers module<a class="headerlink" href="#module-flask.wrappers" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask-wrappers">
-<h3>flask.wrappers<a class="headerlink" href="#flask-wrappers" title="Permalink to this headline">¶</a></h3>
-<p>Implements the WSGI wrappers (request and response).</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-<dl class="class">
-<dt id="flask.wrappers.Request">
-<em class="property">class </em><code class="descclassname">flask.wrappers.</code><code class="descname">Request</code><span class="sig-paren">(</span><em>environ</em>, <em>populate_request=True</em>, <em>shallow=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/wrappers.html#Request"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.wrappers.Request" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">werkzeug.wrappers.Request</span></code></p>
-<p>The request object used by default in Flask.  Remembers the
-matched endpoint and view arguments.</p>
-<p>It is what ends up as <code class="xref py py-class docutils literal"><span class="pre">request</span></code>.  If you want to replace
-the request object used you can subclass this and set
-<code class="xref py py-attr docutils literal"><span class="pre">request_class</span></code> to your subclass.</p>
-<p>The request object is a <code class="xref py py-class docutils literal"><span class="pre">Request</span></code> subclass and
-provides all of the attributes Werkzeug defines plus a few Flask
-specific ones.</p>
-<dl class="attribute">
-<dt id="flask.wrappers.Request.blueprint">
-<code class="descname">blueprint</code><a class="headerlink" href="#flask.wrappers.Request.blueprint" title="Permalink to this definition">¶</a></dt>
-<dd><p>The name of the current blueprint</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.endpoint">
-<code class="descname">endpoint</code><a class="headerlink" href="#flask.wrappers.Request.endpoint" title="Permalink to this definition">¶</a></dt>
-<dd><p>The endpoint that matched the request.  This in combination with
-<a class="reference internal" href="#flask.wrappers.Request.view_args" title="flask.wrappers.Request.view_args"><code class="xref py py-attr docutils literal"><span class="pre">view_args</span></code></a> can be used to reconstruct the same or a
-modified URL.  If an exception happened when matching, this will
-be <code class="docutils literal"><span class="pre">None</span></code>.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.wrappers.Request.get_json">
-<code class="descname">get_json</code><span class="sig-paren">(</span><em>force=False</em>, <em>silent=False</em>, <em>cache=True</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/wrappers.html#Request.get_json"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.wrappers.Request.get_json" title="Permalink to this definition">¶</a></dt>
-<dd><p>Parses the incoming JSON request data and returns it.  By default
-this function will return <code class="docutils literal"><span class="pre">None</span></code> if the mimetype is not
-<em class="mimetype">application/json</em> but this can be overridden by the
-<code class="docutils literal"><span class="pre">force</span></code> parameter. If parsing fails the
-<a class="reference internal" href="#flask.wrappers.Request.on_json_loading_failed" title="flask.wrappers.Request.on_json_loading_failed"><code class="xref py py-meth docutils literal"><span class="pre">on_json_loading_failed()</span></code></a> method on the request object will be
-invoked.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
-<li><strong>force</strong> &#8211; if set to <code class="docutils literal"><span class="pre">True</span></code> the mimetype is ignored.</li>
-<li><strong>silent</strong> &#8211; if set to <code class="docutils literal"><span class="pre">True</span></code> this method will fail silently
-and return <code class="docutils literal"><span class="pre">None</span></code>.</li>
-<li><strong>cache</strong> &#8211; if set to <code class="docutils literal"><span class="pre">True</span></code> the parsed JSON data is remembered
-on the request.</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.is_json">
-<code class="descname">is_json</code><a class="headerlink" href="#flask.wrappers.Request.is_json" title="Permalink to this definition">¶</a></dt>
-<dd><p>Indicates if this request is JSON or not.  By default a request
-is considered to include JSON data if the mimetype is
-<em class="mimetype">application/json</em> or <em class="mimetype">application/*+json</em>.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.11.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.json">
-<code class="descname">json</code><a class="headerlink" href="#flask.wrappers.Request.json" title="Permalink to this definition">¶</a></dt>
-<dd><p>If the mimetype is <em class="mimetype">application/json</em> this will contain the
-parsed JSON data.  Otherwise this will be <code class="docutils literal"><span class="pre">None</span></code>.</p>
-<p>The <a class="reference internal" href="#flask.wrappers.Request.get_json" title="flask.wrappers.Request.get_json"><code class="xref py py-meth docutils literal"><span class="pre">get_json()</span></code></a> method should be used instead.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.max_content_length">
-<code class="descname">max_content_length</code><a class="headerlink" href="#flask.wrappers.Request.max_content_length" title="Permalink to this definition">¶</a></dt>
-<dd><p>Read-only view of the <code class="docutils literal"><span class="pre">MAX_CONTENT_LENGTH</span></code> config key.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.module">
-<code class="descname">module</code><a class="headerlink" href="#flask.wrappers.Request.module" title="Permalink to this definition">¶</a></dt>
-<dd><p>The name of the current module if the request was dispatched
-to an actual module.  This is deprecated functionality, use blueprints
-instead.</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="flask.wrappers.Request.on_json_loading_failed">
-<code class="descname">on_json_loading_failed</code><span class="sig-paren">(</span><em>e</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/wrappers.html#Request.on_json_loading_failed"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.wrappers.Request.on_json_loading_failed" title="Permalink to this definition">¶</a></dt>
-<dd><p>Called if decoding of the JSON data failed.  The return value of
-this method is used by <a class="reference internal" href="#flask.wrappers.Request.get_json" title="flask.wrappers.Request.get_json"><code class="xref py py-meth docutils literal"><span class="pre">get_json()</span></code></a> when an error occurred.  The
-default implementation just raises a <code class="xref py py-class docutils literal"><span class="pre">BadRequest</span></code> exception.</p>
-<div class="versionchanged">
-<p><span class="versionmodified">Changed in version 0.10: </span>Removed buggy previous behavior of generating a random JSON
-response.  If you want that behavior back you can trivially
-add it by subclassing.</p>
-</div>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.8.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.routing_exception">
-<code class="descname">routing_exception</code><em class="property"> = None</em><a class="headerlink" href="#flask.wrappers.Request.routing_exception" title="Permalink to this definition">¶</a></dt>
-<dd><p>If matching the URL failed, this is the exception that will be
-raised / was raised as part of the request handling.  This is
-usually a <code class="xref py py-exc docutils literal"><span class="pre">NotFound</span></code> exception or
-something similar.</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.url_rule">
-<code class="descname">url_rule</code><em class="property"> = None</em><a class="headerlink" href="#flask.wrappers.Request.url_rule" title="Permalink to this definition">¶</a></dt>
-<dd><p>The internal URL rule that matched the request.  This can be
-useful to inspect which methods are allowed for the URL from
-a before/after handler (<code class="docutils literal"><span class="pre">request.url_rule.methods</span></code>) etc.</p>
-<div class="versionadded">
-<p><span class="versionmodified">New in version 0.6.</span></p>
-</div>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="flask.wrappers.Request.view_args">
-<code class="descname">view_args</code><em class="property"> = None</em><a class="headerlink" href="#flask.wrappers.Request.view_args" title="Permalink to this definition">¶</a></dt>
-<dd><p>A dict of view arguments that matched the request.  If an exception
-happened when matching, this will be <code class="docutils literal"><span class="pre">None</span></code>.</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="flask.wrappers.Response">
-<em class="property">class </em><code class="descclassname">flask.wrappers.</code><code class="descname">Response</code><span class="sig-paren">(</span><em>response=None</em>, <em>status=None</em>, <em>headers=None</em>, <em>mimetype=None</em>, <em>content_type=None</em>, <em>direct_passthrough=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/flask/wrappers.html#Response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#flask.wrappers.Response" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">werkzeug.wrappers.Response</span></code></p>
-<p>The response object that is used by default in Flask.  Works like the
-response object from Werkzeug but is set to have an HTML mimetype by
-default.  Quite often you don&#8217;t have to create this object yourself because
-<code class="xref py py-meth docutils literal"><span class="pre">make_response()</span></code> will take care of that for you.</p>
-<p>If you want to replace the response object used you can subclass this and
-set <code class="xref py py-attr docutils literal"><span class="pre">response_class</span></code> to your subclass.</p>
-<dl class="attribute">
-<dt id="flask.wrappers.Response.default_mimetype">
-<code class="descname">default_mimetype</code><em class="property"> = 'text/html'</em><a class="headerlink" href="#flask.wrappers.Response.default_mimetype" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-</div>
-</div>
-<div class="section" id="module-flask">
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-flask" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="flask">
-<h3>flask<a class="headerlink" href="#flask" title="Permalink to this headline">¶</a></h3>
-<p>A microframework based on Werkzeug.  It&#8217;s extensively documented
-and follows best practice patterns.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">copyright:</th><td class="field-body"><ol class="first loweralpha simple" start="3">
-<li>2015 by Armin Ronacher.</li>
-</ol>
-</td>
-</tr>
-<tr class="field-even field"><th class="field-name">license:</th><td class="field-body"><p class="first last">BSD, see LICENSE for more details.</p>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper">
-  <h3><a href="../index.html">Table Of Contents</a></h3>
-  <ul>
-<li><a class="reference internal" href="#">flask package</a><ul>
-<li><a class="reference internal" href="#subpackages">Subpackages</a></li>
-<li><a class="reference internal" href="#submodules">Submodules</a></li>
-<li><a class="reference internal" href="#module-flask.app">flask.app module</a><ul>
-<li><a class="reference internal" href="#flask-app">flask.app</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.blueprints">flask.blueprints module</a><ul>
-<li><a class="reference internal" href="#flask-blueprints">flask.blueprints</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.cli">flask.cli module</a><ul>
-<li><a class="reference internal" href="#flask-cli">flask.cli</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.config">flask.config module</a><ul>
-<li><a class="reference internal" href="#flask-config">flask.config</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.ctx">flask.ctx module</a><ul>
-<li><a class="reference internal" href="#flask-ctx">flask.ctx</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.debughelpers">flask.debughelpers module</a><ul>
-<li><a class="reference internal" href="#flask-debughelpers">flask.debughelpers</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.exthook">flask.exthook module</a><ul>
-<li><a class="reference internal" href="#flask-exthook">flask.exthook</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.globals">flask.globals module</a><ul>
-<li><a class="reference internal" href="#flask-globals">flask.globals</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.helpers">flask.helpers module</a><ul>
-<li><a class="reference internal" href="#flask-helpers">flask.helpers</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.json">flask.json module</a><ul>
-<li><a class="reference internal" href="#flask-jsonimpl">flask.jsonimpl</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.logging">flask.logging module</a><ul>
-<li><a class="reference internal" href="#flask-logging">flask.logging</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.sessions">flask.sessions module</a><ul>
-<li><a class="reference internal" href="#flask-sessions">flask.sessions</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.signals">flask.signals module</a><ul>
-<li><a class="reference internal" href="#flask-signals">flask.signals</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.templating">flask.templating module</a><ul>
-<li><a class="reference internal" href="#flask-templating">flask.templating</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.testing">flask.testing module</a><ul>
-<li><a class="reference internal" href="#flask-testing">flask.testing</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.views">flask.views module</a><ul>
-<li><a class="reference internal" href="#flask-views">flask.views</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask.wrappers">flask.wrappers module</a><ul>
-<li><a class="reference internal" href="#flask-wrappers">flask.wrappers</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#module-flask">Module contents</a><ul>
-<li><a class="reference internal" href="#flask">flask</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-  <div role="note" aria-label="source link">
-    <h3>This Page</h3>
-    <ul class="this-page-menu">
-      <li><a href="../_sources/flask/flask.txt"
-            rel="nofollow">Show Source</a></li>
-    </ul>
-   </div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-      |
-      <a href="../_sources/flask/flask.txt"
-          rel="nofollow">Page source</a>
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/flask/index.html

@@ -1,199 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>Welcome to flask’s documentation! &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../_static/jquery.js"></script>
-    <script type="text/javascript" src="../_static/underscore.js"></script>
-    <script type="text/javascript" src="../_static/doctools.js"></script>
-    <link rel="index" title="Index" href="../genindex.html" />
-    <link rel="search" title="Search" href="../search.html" />
-    <link rel="top" title="proxypool  documentation" href="../index.html" />
-   
-  <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <div class="section" id="welcome-to-flask-s-documentation">
-<h1>Welcome to flask&#8217;s documentation!<a class="headerlink" href="#welcome-to-flask-s-documentation" title="Permalink to this headline">¶</a></h1>
-<p>Contents:</p>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="flask.html">flask package</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#subpackages">Subpackages</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.ext.html">flask.ext package</a><ul>
-<li class="toctree-l4"><a class="reference internal" href="flask.ext.html#module-flask.ext">Module contents</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#submodules">Submodules</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.app">flask.app module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-app">flask.app</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.blueprints">flask.blueprints module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-blueprints">flask.blueprints</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.cli">flask.cli module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-cli">flask.cli</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.config">flask.config module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-config">flask.config</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.ctx">flask.ctx module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-ctx">flask.ctx</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.debughelpers">flask.debughelpers module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-debughelpers">flask.debughelpers</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.exthook">flask.exthook module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-exthook">flask.exthook</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.globals">flask.globals module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-globals">flask.globals</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.helpers">flask.helpers module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-helpers">flask.helpers</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.json">flask.json module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-jsonimpl">flask.jsonimpl</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.logging">flask.logging module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-logging">flask.logging</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.sessions">flask.sessions module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-sessions">flask.sessions</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.signals">flask.signals module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-signals">flask.signals</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.templating">flask.templating module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-templating">flask.templating</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.testing">flask.testing module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-testing">flask.testing</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.views">flask.views module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-views">flask.views</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask.wrappers">flask.wrappers module</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask-wrappers">flask.wrappers</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="flask.html#module-flask">Module contents</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="flask.html#flask">flask</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-</div>
-<div class="section" id="indices-and-tables">
-<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1>
-<ul class="simple">
-<li><a class="reference internal" href="../genindex.html"><span class="std std-ref">Index</span></a></li>
-<li><a class="reference internal" href="../py-modindex.html"><span class="std std-ref">Module Index</span></a></li>
-<li><a class="reference internal" href="../search.html"><span class="std std-ref">Search Page</span></a></li>
-</ul>
-</div>
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper">
-  <h3><a href="../index.html">Table Of Contents</a></h3>
-  <ul>
-<li><a class="reference internal" href="#">Welcome to flask&#8217;s documentation!</a></li>
-<li><a class="reference internal" href="#indices-and-tables">Indices and tables</a></li>
-</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="../index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-  <div role="note" aria-label="source link">
-    <h3>This Page</h3>
-    <ul class="this-page-menu">
-      <li><a href="../_sources/flask/index.txt"
-            rel="nofollow">Show Source</a></li>
-    </ul>
-   </div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-      |
-      <a href="../_sources/flask/index.txt"
-          rel="nofollow">Page source</a>
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/genindex.html

@@ -1,1775 +0,0 @@
-
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>Index &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="index" title="Index" href="#" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="top" title="proxypool  documentation" href="index.html" />
-   
-  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-
-<h1 id="index">Index</h1>
-
-<div class="genindex-jumpbox">
- <a href="#A"><strong>A</strong></a>
- | <a href="#B"><strong>B</strong></a>
- | <a href="#C"><strong>C</strong></a>
- | <a href="#D"><strong>D</strong></a>
- | <a href="#E"><strong>E</strong></a>
- | <a href="#F"><strong>F</strong></a>
- | <a href="#G"><strong>G</strong></a>
- | <a href="#H"><strong>H</strong></a>
- | <a href="#I"><strong>I</strong></a>
- | <a href="#J"><strong>J</strong></a>
- | <a href="#K"><strong>K</strong></a>
- | <a href="#L"><strong>L</strong></a>
- | <a href="#M"><strong>M</strong></a>
- | <a href="#N"><strong>N</strong></a>
- | <a href="#O"><strong>O</strong></a>
- | <a href="#P"><strong>P</strong></a>
- | <a href="#Q"><strong>Q</strong></a>
- | <a href="#R"><strong>R</strong></a>
- | <a href="#S"><strong>S</strong></a>
- | <a href="#T"><strong>T</strong></a>
- | <a href="#U"><strong>U</strong></a>
- | <a href="#V"><strong>V</strong></a>
- | <a href="#W"><strong>W</strong></a>
- 
-</div>
-<h2 id="A">A</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.add_app_template_filter">add_app_template_filter() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.add_app_template_global">add_app_template_global() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.add_app_template_test">add_app_template_test() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.add_template_filter">add_template_filter() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.add_template_global">add_template_global() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.add_template_test">add_template_test() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.PoolAdder.add_to_queue">add_to_queue() (proxypool.schedule.PoolAdder method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.add_url_rule">add_url_rule() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.add_url_rule">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-        
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.add_url_rule">(flask.blueprints.BlueprintSetupState method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.after_app_request">after_app_request() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.after_request">after_request() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.after_request">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.after_request_funcs">after_request_funcs (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.after_this_request">after_this_request() (in module flask.ctx)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.app">app (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.app_context">app_context() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_context_processor">app_context_processor() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.app_ctx_globals_class">app_ctx_globals_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_errorhandler">app_errorhandler() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.ScriptInfo.app_import_path">app_import_path (flask.cli.ScriptInfo attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_template_filter">app_template_filter() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_template_global">app_template_global() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_template_test">app_template_test() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_url_defaults">app_url_defaults() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.app_url_value_preprocessor">app_url_value_preprocessor() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.AppContext">AppContext (class in flask.ctx)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.AppGroup">AppGroup (class in flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.views.View.as_view">as_view() (flask.views.View class method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.debughelpers.attach_enctype_error_multidict">attach_enctype_error_multidict() (in module flask.debughelpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.auto_find_instance_path">auto_find_instance_path() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext.auto_pop">auto_pop() (flask.ctx.RequestContext method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="B">B</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.before_app_first_request">before_app_first_request() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.before_app_request">before_app_request() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.before_first_request">before_first_request() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.before_first_request_funcs">before_first_request_funcs (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.before_request">before_request() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.before_request">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.before_request_funcs">before_request_funcs (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint">Blueprint (class in flask.blueprints)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.blueprint">blueprint (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.wrappers.Request.blueprint">(flask.wrappers.Request attribute)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.blueprints">blueprints (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState">BlueprintSetupState (class in flask.blueprints)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="C">C</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="proxypool.html#proxypool.schedule.Schedule.check_pool">check_pool() (proxypool.schedule.Schedule static method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.NullSession.clear">clear() (flask.sessions.NullSession method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.cli">cli (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.AppGroup.command">command() (flask.cli.AppGroup method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config">Config (class in flask.config)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.config">config (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.config_class">config_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.ConfigAttribute">ConfigAttribute (class in flask.config)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.context_processor">context_processor() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.context_processor">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext.copy">copy() (flask.ctx.RequestContext method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.copy_current_request_context">copy_current_request_context() (in module flask.ctx)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_daili66">crawl_daili66() (proxypool.proxyGetter.FreeProxyGetter method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_kuaidaili">crawl_kuaidaili() (proxypool.proxyGetter.FreeProxyGetter method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_proxy360">crawl_proxy360() (proxypool.proxyGetter.FreeProxyGetter method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.FreeProxyGetter.crawl_xici">crawl_xici() (proxypool.proxyGetter.FreeProxyGetter method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.ScriptInfo.create_app">create_app (flask.cli.ScriptInfo attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.create_global_jinja_loader">create_global_jinja_loader() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.create_jinja_environment">create_jinja_environment() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.logging.create_logger">create_logger() (in module flask.logging)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.create_url_adapter">create_url_adapter() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="D">D</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.ScriptInfo.data">data (flask.cli.ScriptInfo attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.debug">debug (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.debughelpers.DebugFilesKeyError">DebugFilesKeyError</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.views.View.decorators">decorators (flask.views.View attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.JSONEncoder.default">default() (flask.json.JSONEncoder method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.default_config">default_config (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Response.default_mimetype">default_mimetype (flask.wrappers.Response attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.digest_method">digest_method() (flask.sessions.SecureCookieSessionInterface static method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.dispatch_request">dispatch_request() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.views.MethodView.dispatch_request">(flask.views.MethodView method)</a>
-  </dt>
-
-        
-  <dt><a href="flask/flask.html#flask.views.View.dispatch_request">(flask.views.View method)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.DispatchingApp">DispatchingApp (class in flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.templating.DispatchingJinjaLoader">DispatchingJinjaLoader (class in flask.templating)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.do_teardown_appcontext">do_teardown_appcontext() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.do_teardown_request">do_teardown_request() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.utils.Downloader.download">download() (proxypool.utils.Downloader method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.utils.Downloader.download_single_page">download_single_page() (proxypool.utils.Downloader method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.utils.Downloader">Downloader (class in proxypool.utils)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.dump">dump() (in module flask.json)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.TaggedJSONSerializer.dumps">dumps() (flask.sessions.TaggedJSONSerializer method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.json.dumps">(in module flask.json)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-</tr></table>
-
-<h2 id="E">E</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.endpoint">endpoint (flask.wrappers.Request attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.endpoint">endpoint() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.endpoint">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.templating.Environment">Environment (class in flask.templating)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.error_handler_spec">error_handler_spec (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.error_handlers">error_handlers (flask.app.Flask attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.errorhandler">errorhandler() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.errorhandler">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.debughelpers.explain_template_loading_attempts">explain_template_loading_attempts() (in module flask.debughelpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtDeprecationWarning">ExtDeprecationWarning</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtensionImporter">ExtensionImporter (class in flask.exthook)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.extensions">extensions (flask.app.Flask attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="F">F</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.find_best_app">find_best_app() (in module flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.find_default_import_path">find_default_import_path() (in module flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtensionImporter.find_module">find_module() (flask.exthook.ExtensionImporter method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.find_package">find_package() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.first_registration">first_registration (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.flash">flash() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask">Flask (class in flask.app)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask">flask (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.app">flask.app (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.blueprints">flask.blueprints (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.cli">flask.cli (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.config">flask.config (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.ctx">flask.ctx (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.debughelpers">flask.debughelpers (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.ext.html#module-flask.ext">flask.ext (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.exthook">flask.exthook (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.globals">flask.globals (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.helpers">flask.helpers (module)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#module-flask.json">flask.json (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.logging">flask.logging (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.sessions">flask.sessions (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.signals">flask.signals (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.templating">flask.templating (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.testing">flask.testing (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.views">flask.views (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#module-flask.wrappers">flask.wrappers (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.testing.FlaskClient">FlaskClient (class in flask.testing)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.FlaskGroup">FlaskGroup (class in flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.db.RedisClient.flush">flush() (proxypool.db.RedisClient method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.debughelpers.FormDataRoutingRedirect">FormDataRoutingRedirect</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.FreeProxyGetter">FreeProxyGetter (class in proxypool.proxyGetter)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config.from_envvar">from_envvar() (flask.config.Config method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config.from_json">from_json() (flask.config.Config method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config.from_mapping">from_mapping() (flask.config.Config method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config.from_object">from_object() (flask.config.Config method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config.from_pyfile">from_pyfile() (flask.config.Config method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.full_dispatch_request">full_dispatch_request() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="G">G</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext.g">g (flask.ctx.RequestContext attribute)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.db.RedisClient.get">get() (proxypool.db.RedisClient method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.FlaskGroup.get_command">get_command() (flask.cli.FlaskGroup method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.get_cookie_domain">get_cookie_domain() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.get_cookie_httponly">get_cookie_httponly() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.get_cookie_path">get_cookie_path() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.get_cookie_secure">get_cookie_secure() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.get_debug_flag">get_debug_flag() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.get_expiration_time">get_expiration_time() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.get_flashed_messages">get_flashed_messages() (in module flask.helpers)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.get_json">get_json() (flask.wrappers.Request method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.config.Config.get_namespace">get_namespace() (flask.config.Config method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.utils.get_page">get_page() (in module proxypool.utils)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.FreeProxyGetter.get_raw_proxies">get_raw_proxies() (proxypool.proxyGetter.FreeProxyGetter method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.get_root_path">get_root_path() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.get_signing_serializer">get_signing_serializer() (flask.sessions.SecureCookieSessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.templating.DispatchingJinjaLoader.get_source">get_source() (flask.templating.DispatchingJinjaLoader method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.get_template_attribute">get_template_attribute() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.ValidityTester.get_usable_proxies">get_usable_proxies() (proxypool.schedule.ValidityTester method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.got_first_request">got_first_request (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.AppGroup.group">group() (flask.cli.AppGroup method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="H">H</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.handle_exception">handle_exception() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.handle_http_exception">handle_http_exception() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.handle_url_build_error">handle_url_build_error() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.handle_user_exception">handle_user_exception() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.ctx.has_app_context">has_app_context() (in module flask.ctx)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.has_request_context">has_request_context() (in module flask.ctx)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.utils.Downloader.htmls">htmls (proxypool.utils.Downloader attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.htmlsafe_dump">htmlsafe_dump() (in module flask.json)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.htmlsafe_dumps">htmlsafe_dumps() (in module flask.json)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="I">I</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.init_jinja_globals">init_jinja_globals() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.inject_url_defaults">inject_url_defaults() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtensionImporter.install">install() (flask.exthook.ExtensionImporter method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.instance_path">instance_path (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtensionImporter.is_important_frame">is_important_frame() (flask.exthook.ExtensionImporter method)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtensionImporter.is_important_traceback">is_important_traceback() (flask.exthook.ExtensionImporter method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.is_json">is_json (flask.wrappers.Request attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.is_null_session">is_null_session() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.PoolAdder.is_over_threshold">is_over_threshold() (proxypool.schedule.PoolAdder method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.iter_blueprints">iter_blueprints() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="J">J</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.jinja_env">jinja_env (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.jinja_environment">jinja_environment (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.jinja_options">jinja_options (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.json">json (flask.wrappers.Request attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.json_decoder">json_decoder (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.json_encoder">json_encoder (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.JSONDecoder">JSONDecoder (class in flask.json)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.JSONEncoder">JSONEncoder (class in flask.json)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.jsonify">jsonify() (in module flask.json)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="K">K</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.key_derivation">key_derivation (flask.sessions.SecureCookieSessionInterface attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="L">L</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.FlaskGroup.list_commands">list_commands() (flask.cli.FlaskGroup method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.templating.DispatchingJinjaLoader.list_templates">list_templates() (flask.templating.DispatchingJinjaLoader method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.json.load">load() (in module flask.json)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.ScriptInfo.load_app">load_app() (flask.cli.ScriptInfo method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.exthook.ExtensionImporter.load_module">load_module() (flask.exthook.ExtensionImporter method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.TaggedJSONSerializer.loads">loads() (flask.sessions.TaggedJSONSerializer method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.json.loads">(in module flask.json)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.locate_app">locate_app() (in module flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.locked_cached_property">locked_cached_property (class in flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.log_exception">log_exception() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.logger">logger (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.logger_name">logger_name (flask.app.Flask attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="M">M</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.FlaskGroup.main">main() (flask.cli.FlaskGroup method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.cli.main">(in module flask.cli)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.make_config">make_config() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.make_default_options_response">make_default_options_response() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.make_null_session">make_null_session() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.make_null_session">(flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.make_response">make_response() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.helpers.make_response">(in module flask.helpers)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.make_setup_state">make_setup_state() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.make_shell_context">make_shell_context() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.testing.make_test_environ_builder">make_test_environ_builder() (in module flask.testing)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext.match_request">match_request() (flask.ctx.RequestContext method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.max_content_length">max_content_length (flask.wrappers.Request attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.views.View.methods">methods (flask.views.View attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.views.MethodView">MethodView (class in flask.views)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.views.MethodViewType">MethodViewType (class in flask.views)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionMixin.modified">modified (flask.sessions.SessionMixin attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.module">module (flask.wrappers.Request attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="N">N</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.name">name (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.signals.Namespace">Namespace (class in flask.signals)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionMixin.new">new (flask.sessions.SessionMixin attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.NoAppException">NoAppException</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.null_session_class">null_session_class (flask.sessions.SessionInterface attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.NullSession">NullSession (class in flask.sessions)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="O">O</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.on_json_loading_failed">on_json_loading_failed() (flask.wrappers.Request method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.testing.FlaskClient.open">open() (flask.testing.FlaskClient method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.open_instance_resource">open_instance_resource() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.open_session">open_session() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.open_session">(flask.sessions.SecureCookieSessionInterface method)</a>
-  </dt>
-
-        
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.open_session">(flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.options">options (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="P">P</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionMixin.permanent">permanent (flask.sessions.SessionMixin attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.permanent_session_lifetime">permanent_session_lifetime (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.pickle_based">pickle_based (flask.sessions.SessionInterface attribute)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.PoolAdder">PoolAdder (class in proxypool.schedule)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.error.PoolEmptyError">PoolEmptyError</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.AppContext.pop">pop() (flask.ctx.AppContext method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext.pop">(flask.ctx.RequestContext method)</a>
-  </dt>
-
-        
-  <dt><a href="flask/flask.html#flask.sessions.NullSession.pop">(flask.sessions.NullSession method)</a>
-  </dt>
-
-        
-  <dt><a href="proxypool.html#proxypool.db.RedisClient.pop">(proxypool.db.RedisClient method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.sessions.NullSession.popitem">popitem() (flask.sessions.NullSession method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.prepare_exec_for_file">prepare_exec_for_file() (in module flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.preprocess_request">preprocess_request() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.testing.FlaskClient.preserve_context">preserve_context (flask.testing.FlaskClient attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.preserve_context_on_exception">preserve_context_on_exception (flask.app.Flask attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.process_response">process_response() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.propagate_exceptions">propagate_exceptions (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.proxyGetter.ProxyMetaclass">ProxyMetaclass (class in proxypool.proxyGetter)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool">proxypool (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.api">proxypool.api (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.db">proxypool.db (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.error">proxypool.error (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.proxyGetter">proxypool.proxyGetter (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.schedule">proxypool.schedule (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.setting">proxypool.setting (module)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#module-proxypool.utils">proxypool.utils (module)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.AppContext.push">push() (flask.ctx.AppContext method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext.push">(flask.ctx.RequestContext method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="proxypool.html#proxypool.db.RedisClient.put">put() (proxypool.db.RedisClient method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.db.RedisClient.put_many">put_many() (proxypool.db.RedisClient method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="Q">Q</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="proxypool.html#proxypool.db.RedisClient.queue_len">queue_len (proxypool.db.RedisClient attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="R">R</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.raise_routing_exception">raise_routing_exception() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.record">record() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.record_once">record_once() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.db.RedisClient">RedisClient (class in proxypool.db)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.register">register() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.register_blueprint">register_blueprint() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.register_error_handler">register_error_handler() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.register_error_handler">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.templating.render_template">render_template() (in module flask.templating)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.templating.render_template_string">render_template_string() (in module flask.templating)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request">Request (class in flask.wrappers)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.request_class">request_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.request_context">request_context() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.request_globals_class">request_globals_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.ctx.RequestContext">RequestContext (class in flask.ctx)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.error.ResourceDepletionError">ResourceDepletionError</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Response">Response (class in flask.wrappers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.response_class">response_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.route">route() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.route">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.routing_exception">routing_exception (flask.wrappers.Request attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.run">run() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="proxypool.html#proxypool.schedule.Schedule.run">(proxypool.schedule.Schedule method)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-</tr></table>
-
-<h2 id="S">S</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.helpers.safe_join">safe_join() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.salt">salt (flask.sessions.SecureCookieSessionInterface attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.save_session">save_session() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.save_session">(flask.sessions.SecureCookieSessionInterface method)</a>
-  </dt>
-
-        
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.save_session">(flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="proxypool.html#proxypool.schedule.Schedule">Schedule (class in proxypool.schedule)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.cli.ScriptInfo">ScriptInfo (class in flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.secret_key">secret_key (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSession">SecureCookieSession (class in flask.sessions)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface">SecureCookieSessionInterface (class in flask.sessions)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.select_jinja_autoescape">select_jinja_autoescape() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.send_file">send_file() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.send_file_max_age_default">send_file_max_age_default (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.send_from_directory">send_from_directory() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.serializer">serializer (flask.sessions.SecureCookieSessionInterface attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.sessions.SecureCookieSessionInterface.session_class">session_class (flask.sessions.SecureCookieSessionInterface attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.session_cookie_name">session_cookie_name (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.session_interface">session_interface (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.testing.FlaskClient.session_transaction">session_transaction() (flask.testing.FlaskClient method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface">SessionInterface (class in flask.sessions)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionMixin">SessionMixin (class in flask.sessions)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.ValidityTester.set_raw_proxies">set_raw_proxies() (proxypool.schedule.ValidityTester method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.NullSession.setdefault">setdefault() (flask.sessions.NullSession method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.setupmethod">setupmethod() (in module flask.app)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.shell_context_processor">shell_context_processor() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.shell_context_processors">shell_context_processors (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.should_ignore_error">should_ignore_error() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.SessionInterface.should_set_cookie">should_set_cookie() (flask.sessions.SessionInterface method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.signals.Namespace.signal">signal() (flask.signals.Namespace method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.stream_with_context">stream_with_context() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.subdomain">subdomain (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="T">T</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.sessions.TaggedJSONSerializer">TaggedJSONSerializer (class in flask.sessions)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.teardown_app_request">teardown_app_request() (flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.teardown_appcontext">teardown_appcontext() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.teardown_appcontext_funcs">teardown_appcontext_funcs (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.teardown_request">teardown_request() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.teardown_request">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.teardown_request_funcs">teardown_request_funcs (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.template_context_processors">template_context_processors (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.template_filter">template_filter() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.template_global">template_global() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.template_test">template_test() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.ValidityTester.test">test() (proxypool.schedule.ValidityTester method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.ValidityTester.test_api">test_api (proxypool.schedule.ValidityTester attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.test_client">test_client() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.test_client_class">test_client_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.test_request_context">test_request_context() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.ValidityTester.test_single_proxy">test_single_proxy() (proxypool.schedule.ValidityTester method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.testing">testing (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.helpers.total_seconds">total_seconds() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.trap_http_exception">trap_http_exception() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.try_trigger_before_first_request_functions">try_trigger_before_first_request_functions() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="U">U</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.debughelpers.UnexpectedUnicodeError">UnexpectedUnicodeError</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.sessions.NullSession.update">update() (flask.sessions.NullSession method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.update_template_context">update_template_context() (flask.app.Flask method)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_build_error_handlers">url_build_error_handlers (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_default_functions">url_default_functions (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.url_defaults">url_defaults (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_defaults">url_defaults() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.url_defaults">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.helpers.url_for">url_for() (in module flask.helpers)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_map">url_map (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.blueprints.BlueprintSetupState.url_prefix">url_prefix (flask.blueprints.BlueprintSetupState attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.url_rule">url_rule (flask.wrappers.Request attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_rule_class">url_rule_class (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_value_preprocessor">url_value_preprocessor() (flask.app.Flask method)</a>
-  </dt>
-
-      <dd><dl>
-        
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.url_value_preprocessor">(flask.blueprints.Blueprint method)</a>
-  </dt>
-
-      </dl></dd>
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.url_value_preprocessors">url_value_preprocessors (flask.app.Flask attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.use_x_sendfile">use_x_sendfile (flask.app.Flask attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="V">V</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="proxypool.html#proxypool.schedule.Schedule.valid_proxy">valid_proxy() (proxypool.schedule.Schedule static method)</a>
-  </dt>
-
-      
-  <dt><a href="proxypool.html#proxypool.schedule.ValidityTester">ValidityTester (class in proxypool.schedule)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.views.View">View (class in flask.views)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.wrappers.Request.view_args">view_args (flask.wrappers.Request attribute)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.view_functions">view_functions (flask.app.Flask attribute)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-<h2 id="W">W</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.blueprints.Blueprint.warn_on_modifications">warn_on_modifications (flask.blueprints.Blueprint attribute)</a>
-  </dt>
-
-  </dl></td>
-  <td style="width: 33%" valign="top"><dl>
-      
-  <dt><a href="flask/flask.html#flask.cli.with_appcontext">with_appcontext() (in module flask.cli)</a>
-  </dt>
-
-      
-  <dt><a href="flask/flask.html#flask.app.Flask.wsgi_app">wsgi_app() (flask.app.Flask method)</a>
-  </dt>
-
-  </dl></td>
-</tr></table>
-
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper">
-
-   <div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/index.html

@@ -1,130 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>Welcome to proxypool’s documentation! &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="top" title="proxypool  documentation" href="#" />
-    <link rel="next" title="proxypool package" href="proxypool.html" />
-   
-  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <div class="section" id="welcome-to-proxypool-s-documentation">
-<h1>Welcome to proxypool&#8217;s documentation!<a class="headerlink" href="#welcome-to-proxypool-s-documentation" title="Permalink to this headline">¶</a></h1>
-<p>Contents:</p>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="proxypool.html">proxypool package</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#submodules">Submodules</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.api">proxypool.api module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.db">proxypool.db module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.error">proxypool.error module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.proxyGetter">proxypool.proxyGetter module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.schedule">proxypool.schedule module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.setting">proxypool.setting module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool.utils">proxypool.utils module</a></li>
-<li class="toctree-l2"><a class="reference internal" href="proxypool.html#module-proxypool">Module contents</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</div>
-<div class="section" id="indices-and-tables">
-<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1>
-<ul class="simple">
-<li><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></li>
-<li><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module Index</span></a></li>
-<li><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></li>
-</ul>
-</div>
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper">
-  <h3><a href="#">Table Of Contents</a></h3>
-  <ul>
-<li><a class="reference internal" href="#">Welcome to proxypool&#8217;s documentation!</a></li>
-<li><a class="reference internal" href="#indices-and-tables">Indices and tables</a></li>
-</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="#">Documentation overview</a><ul>
-      <li>Next: <a href="proxypool.html" title="next chapter">proxypool package</a></li>
-  </ul></li>
-</ul>
-</div>
-  <div role="note" aria-label="source link">
-    <h3>This Page</h3>
-    <ul class="this-page-menu">
-      <li><a href="_sources/index.txt"
-            rel="nofollow">Show Source</a></li>
-    </ul>
-   </div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-      |
-      <a href="_sources/index.txt"
-          rel="nofollow">Page source</a>
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/proxypool.html

@@ -1,398 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>proxypool package &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="top" title="proxypool  documentation" href="index.html" />
-    <link rel="prev" title="Welcome to proxypool’s documentation!" href="index.html" />
-   
-  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <div class="section" id="proxypool-package">
-<h1>proxypool package<a class="headerlink" href="#proxypool-package" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="submodules">
-<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline">¶</a></h2>
-</div>
-<div class="section" id="module-proxypool.api">
-<span id="proxypool-api-module"></span><h2>proxypool.api module<a class="headerlink" href="#module-proxypool.api" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div><blockquote>
-<div><a class="reference external" href="http://127.0.0.1:5000">http://127.0.0.1:5000</a>/进入主页。
-访问 <a class="reference external" href="http://127.0.0.1:5000/get">http://127.0.0.1:5000/get</a> 
-从代理池中获取一个代理。 
-访问 <a class="reference external" href="http://127.0.0.1:5000/count">http://127.0.0.1:5000/count</a>
-获取代理池中可用代理的总数。</div></blockquote>
-<p>Author:        Liu
-Date:          2016/12/9</p>
-</div></blockquote>
-</div>
-<hr class="docutils" />
-<div class="section" id="module-proxypool.db">
-<span id="proxypool-db-module"></span><h2>proxypool.db module<a class="headerlink" href="#module-proxypool.db" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div><blockquote>
-<div>的交互。</div></blockquote>
-<p>Author:        Liu
-Date:          2016/12/9</p>
-</div></blockquote>
-<hr class="docutils" />
-<dl class="class">
-<dt id="proxypool.db.RedisClient">
-<em class="property">class </em><code class="descclassname">proxypool.db.</code><code class="descname">RedisClient</code><span class="sig-paren">(</span><em>host='localhost'</em>, <em>port=6379</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/db.html#RedisClient"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.db.RedisClient" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>Redis数据库操作类。</p>
-<dl class="method">
-<dt id="proxypool.db.RedisClient.flush">
-<code class="descname">flush</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/db.html#RedisClient.flush"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.db.RedisClient.flush" title="Permalink to this definition">¶</a></dt>
-<dd><p>刷新Redis中的全部内容，测试用。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.db.RedisClient.get">
-<code class="descname">get</code><span class="sig-paren">(</span><em>count=1</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/db.html#RedisClient.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.db.RedisClient.get" title="Permalink to this definition">¶</a></dt>
-<dd><p>从Pool中获取一定量数据。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.db.RedisClient.pop">
-<code class="descname">pop</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/db.html#RedisClient.pop"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.db.RedisClient.pop" title="Permalink to this definition">¶</a></dt>
-<dd><p>弹出一个可用代理。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.db.RedisClient.put">
-<code class="descname">put</code><span class="sig-paren">(</span><em>proxy</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/db.html#RedisClient.put"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.db.RedisClient.put" title="Permalink to this definition">¶</a></dt>
-<dd><p>将代理压入Pool中。
-用Redis的set容器来负责去重，如果proxy能被压入proxy_set，
-就将其放入proxy pool中，否则不压入。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.db.RedisClient.put_many">
-<code class="descname">put_many</code><span class="sig-paren">(</span><em>proxies</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/db.html#RedisClient.put_many"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.db.RedisClient.put_many" title="Permalink to this definition">¶</a></dt>
-<dd><p>将一定量的代理压入Pool。</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="proxypool.db.RedisClient.queue_len">
-<code class="descname">queue_len</code><a class="headerlink" href="#proxypool.db.RedisClient.queue_len" title="Permalink to this definition">¶</a></dt>
-<dd><p>获取proxy pool的大小。</p>
-</dd></dl>
-
-</dd></dl>
-
-</div>
-<div class="section" id="module-proxypool.error">
-<span id="proxypool-error-module"></span><h2>proxypool.error module<a class="headerlink" href="#module-proxypool.error" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div>Author:        Liu
-Date:          2016/12/9</div></blockquote>
-<hr class="docutils" />
-<dl class="exception">
-<dt id="proxypool.error.PoolEmptyError">
-<em class="property">exception </em><code class="descclassname">proxypool.error.</code><code class="descname">PoolEmptyError</code><a class="reference internal" href="_modules/proxypool/error.html#PoolEmptyError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.error.PoolEmptyError" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">Exception</span></code></p>
-<p>代理池空异常，如果代理池长时间为空，则抛出此异常。</p>
-</dd></dl>
-
-<dl class="exception">
-<dt id="proxypool.error.ResourceDepletionError">
-<em class="property">exception </em><code class="descclassname">proxypool.error.</code><code class="descname">ResourceDepletionError</code><a class="reference internal" href="_modules/proxypool/error.html#ResourceDepletionError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.error.ResourceDepletionError" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">Exception</span></code></p>
-<p>资源枯竭异常，如果从所有抓取网站都抓不到可用的代理资源，
-则抛出此异常。</p>
-</dd></dl>
-
-</div>
-<div class="section" id="module-proxypool.proxyGetter">
-<span id="proxypool-proxygetter-module"></span><h2>proxypool.proxyGetter module<a class="headerlink" href="#module-proxypool.proxyGetter" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div>Author:        Liu
-Date:          2016/12/9</div></blockquote>
-<hr class="docutils" />
-<dl class="class">
-<dt id="proxypool.proxyGetter.FreeProxyGetter">
-<em class="property">class </em><code class="descclassname">proxypool.proxyGetter.</code><code class="descname">FreeProxyGetter</code><a class="reference internal" href="_modules/proxypool/proxyGetter.html#FreeProxyGetter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.FreeProxyGetter" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>代理爬虫，负责扫描各大代理网站，抓取代理。
-该类有可扩展性，可根据需要自己添加新站点的代理抓取函数，
-但是函数名必须以crawl_开头，返回值必须以&#8221;host:port&#8221;的形式返回，
-添加器会自动识别并调用此类函数。</p>
-<dl class="method">
-<dt id="proxypool.proxyGetter.FreeProxyGetter.crawl_daili66">
-<code class="descname">crawl_daili66</code><span class="sig-paren">(</span><em>page_count=4</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/proxyGetter.html#FreeProxyGetter.crawl_daili66"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.FreeProxyGetter.crawl_daili66" title="Permalink to this definition">¶</a></dt>
-<dd><p>抓取代理66网的数据。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.proxyGetter.FreeProxyGetter.crawl_kuaidaili">
-<code class="descname">crawl_kuaidaili</code><span class="sig-paren">(</span><em>page_count=8</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/proxyGetter.html#FreeProxyGetter.crawl_kuaidaili"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.FreeProxyGetter.crawl_kuaidaili" title="Permalink to this definition">¶</a></dt>
-<dd><p>抓取快代理网的数据</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.proxyGetter.FreeProxyGetter.crawl_proxy360">
-<code class="descname">crawl_proxy360</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/proxyGetter.html#FreeProxyGetter.crawl_proxy360"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.FreeProxyGetter.crawl_proxy360" title="Permalink to this definition">¶</a></dt>
-<dd><p>抓取proxy360网的数据。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.proxyGetter.FreeProxyGetter.crawl_xici">
-<code class="descname">crawl_xici</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/proxyGetter.html#FreeProxyGetter.crawl_xici"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.FreeProxyGetter.crawl_xici" title="Permalink to this definition">¶</a></dt>
-<dd><p>抓取xici代理网的数据。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.proxyGetter.FreeProxyGetter.get_raw_proxies">
-<code class="descname">get_raw_proxies</code><span class="sig-paren">(</span><em>callback</em>, <em>count=40</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/proxyGetter.html#FreeProxyGetter.get_raw_proxies"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.FreeProxyGetter.get_raw_proxies" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="proxypool.proxyGetter.ProxyMetaclass">
-<em class="property">class </em><code class="descclassname">proxypool.proxyGetter.</code><code class="descname">ProxyMetaclass</code><a class="reference internal" href="_modules/proxypool/proxyGetter.html#ProxyMetaclass"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.proxyGetter.ProxyMetaclass" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">type</span></code></p>
-<p>爬虫的元类，在FreeProxyGetter类中加入
-__CrawlFunc__和__CrawlFuncCount__
-两个参数，分别表示爬虫函数，和爬虫函数的数量。</p>
-</dd></dl>
-
-</div>
-<div class="section" id="module-proxypool.schedule">
-<span id="proxypool-schedule-module"></span><h2>proxypool.schedule module<a class="headerlink" href="#module-proxypool.schedule" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div><blockquote>
-<div>包含ValidityTester，PoolAdder，
-Schedule三个类，负责维护代理池。</div></blockquote>
-<p>Author:        Liu
-Date:          2016/12/9</p>
-</div></blockquote>
-<hr class="docutils" />
-<dl class="class">
-<dt id="proxypool.schedule.PoolAdder">
-<em class="property">class </em><code class="descclassname">proxypool.schedule.</code><code class="descname">PoolAdder</code><span class="sig-paren">(</span><em>threshold</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#PoolAdder"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.PoolAdder" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>添加器，负责向池中补充代理</p>
-<dl class="method">
-<dt id="proxypool.schedule.PoolAdder.add_to_queue">
-<code class="descname">add_to_queue</code><span class="sig-paren">(</span><em>flag=40</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#PoolAdder.add_to_queue"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.PoolAdder.add_to_queue" title="Permalink to this definition">¶</a></dt>
-<dd><p>命令爬虫抓取一定量未检测的代理，然后检测，将通过检测的代理
-加入到代理池中。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.schedule.PoolAdder.is_over_threshold">
-<code class="descname">is_over_threshold</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#PoolAdder.is_over_threshold"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.PoolAdder.is_over_threshold" title="Permalink to this definition">¶</a></dt>
-<dd><p>判断代理池中的数据量是否达到阈值。</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="proxypool.schedule.Schedule">
-<em class="property">class </em><code class="descclassname">proxypool.schedule.</code><code class="descname">Schedule</code><a class="reference internal" href="_modules/proxypool/schedule.html#Schedule"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.Schedule" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>总调度器，用于协调各调度器模块</p>
-<dl class="staticmethod">
-<dt id="proxypool.schedule.Schedule.check_pool">
-<em class="property">static </em><code class="descname">check_pool</code><span class="sig-paren">(</span><em>lower_threshold=10</em>, <em>upper_threshold=40</em>, <em>cycle=20</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#Schedule.check_pool"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.Schedule.check_pool" title="Permalink to this definition">¶</a></dt>
-<dd><p>协调添加器，当代理池中可用代理的数量低于下阈值时，触发添加器，启动爬虫
-补充代理，当代理达到上阈值时，添加器停止工作。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.schedule.Schedule.run">
-<code class="descname">run</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#Schedule.run"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.Schedule.run" title="Permalink to this definition">¶</a></dt>
-<dd><p>运行调度器，创建两个进程，对代理池进行维护。</p>
-</dd></dl>
-
-<dl class="staticmethod">
-<dt id="proxypool.schedule.Schedule.valid_proxy">
-<em class="property">static </em><code class="descname">valid_proxy</code><span class="sig-paren">(</span><em>cycle=600</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#Schedule.valid_proxy"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.Schedule.valid_proxy" title="Permalink to this definition">¶</a></dt>
-<dd><p>对已经如池的代理进行检测，防止池中的代理因长期
-不使用而过期。
-抽出代理池队列中前1/4的代理，检测，合格者压入队列尾。</p>
-</dd></dl>
-
-</dd></dl>
-
-<dl class="class">
-<dt id="proxypool.schedule.ValidityTester">
-<em class="property">class </em><code class="descclassname">proxypool.schedule.</code><code class="descname">ValidityTester</code><a class="reference internal" href="_modules/proxypool/schedule.html#ValidityTester"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.ValidityTester" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>检验器，负责对未知的代理进行异步检测。</p>
-<dl class="method">
-<dt id="proxypool.schedule.ValidityTester.get_usable_proxies">
-<code class="descname">get_usable_proxies</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#ValidityTester.get_usable_proxies"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.ValidityTester.get_usable_proxies" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="proxypool.schedule.ValidityTester.set_raw_proxies">
-<code class="descname">set_raw_proxies</code><span class="sig-paren">(</span><em>proxies</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#ValidityTester.set_raw_proxies"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.ValidityTester.set_raw_proxies" title="Permalink to this definition">¶</a></dt>
-<dd><p>设置待检测的代理。</p>
-</dd></dl>
-
-<dl class="method">
-<dt id="proxypool.schedule.ValidityTester.test">
-<code class="descname">test</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#ValidityTester.test"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.ValidityTester.test" title="Permalink to this definition">¶</a></dt>
-<dd><p>异步检测_raw_proxies中的全部代理。</p>
-</dd></dl>
-
-<dl class="attribute">
-<dt id="proxypool.schedule.ValidityTester.test_api">
-<code class="descname">test_api</code><em class="property"> = 'https://www.baidu.com'</em><a class="headerlink" href="#proxypool.schedule.ValidityTester.test_api" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="proxypool.schedule.ValidityTester.test_single_proxy">
-<code class="descname">test_single_proxy</code><span class="sig-paren">(</span><em>proxy</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/schedule.html#ValidityTester.test_single_proxy"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.schedule.ValidityTester.test_single_proxy" title="Permalink to this definition">¶</a></dt>
-<dd><p>检测单个代理，如果可用，则将其加入_usable_proxies</p>
-</dd></dl>
-
-</dd></dl>
-
-</div>
-<div class="section" id="module-proxypool.setting">
-<span id="proxypool-setting-module"></span><h2>proxypool.setting module<a class="headerlink" href="#module-proxypool.setting" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div>Author:        Liu
-Date:          2016/12/9</div></blockquote>
-</div>
-<hr class="docutils" />
-<div class="section" id="module-proxypool.utils">
-<span id="proxypool-utils-module"></span><h2>proxypool.utils module<a class="headerlink" href="#module-proxypool.utils" title="Permalink to this headline">¶</a></h2>
-<dl class="class">
-<dt id="proxypool.utils.Downloader">
-<em class="property">class </em><code class="descclassname">proxypool.utils.</code><code class="descname">Downloader</code><span class="sig-paren">(</span><em>urls</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/utils.html#Downloader"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.utils.Downloader" title="Permalink to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
-<p>一个异步下载器，可以对代理源异步抓取，但是容易被BAN。</p>
-<dl class="method">
-<dt id="proxypool.utils.Downloader.download">
-<code class="descname">download</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/utils.html#Downloader.download"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.utils.Downloader.download" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="method">
-<dt id="proxypool.utils.Downloader.download_single_page">
-<code class="descname">download_single_page</code><span class="sig-paren">(</span><em>url</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/utils.html#Downloader.download_single_page"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.utils.Downloader.download_single_page" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-<dl class="attribute">
-<dt id="proxypool.utils.Downloader.htmls">
-<code class="descname">htmls</code><a class="headerlink" href="#proxypool.utils.Downloader.htmls" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="function">
-<dt id="proxypool.utils.get_page">
-<code class="descclassname">proxypool.utils.</code><code class="descname">get_page</code><span class="sig-paren">(</span><em>url</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/proxypool/utils.html#get_page"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#proxypool.utils.get_page" title="Permalink to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</div>
-<div class="section" id="module-proxypool">
-<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-proxypool" title="Permalink to this headline">¶</a></h2>
-</div>
-</div>
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper">
-  <h3><a href="index.html">Table Of Contents</a></h3>
-  <ul>
-<li><a class="reference internal" href="#">proxypool package</a><ul>
-<li><a class="reference internal" href="#submodules">Submodules</a></li>
-<li><a class="reference internal" href="#module-proxypool.api">proxypool.api module</a></li>
-<li><a class="reference internal" href="#module-proxypool.db">proxypool.db module</a></li>
-<li><a class="reference internal" href="#module-proxypool.error">proxypool.error module</a></li>
-<li><a class="reference internal" href="#module-proxypool.proxyGetter">proxypool.proxyGetter module</a></li>
-<li><a class="reference internal" href="#module-proxypool.schedule">proxypool.schedule module</a></li>
-<li><a class="reference internal" href="#module-proxypool.setting">proxypool.setting module</a></li>
-<li><a class="reference internal" href="#module-proxypool.utils">proxypool.utils module</a></li>
-<li><a class="reference internal" href="#module-proxypool">Module contents</a></li>
-</ul>
-</li>
-</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="index.html">Documentation overview</a><ul>
-      <li>Previous: <a href="index.html" title="previous chapter">Welcome to proxypool&#8217;s documentation!</a></li>
-  </ul></li>
-</ul>
-</div>
-  <div role="note" aria-label="source link">
-    <h3>This Page</h3>
-    <ul class="this-page-menu">
-      <li><a href="_sources/proxypool.txt"
-            rel="nofollow">Show Source</a></li>
-    </ul>
-   </div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-      |
-      <a href="_sources/proxypool.txt"
-          rel="nofollow">Page source</a>
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/py-modindex.html

@@ -1,240 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>Python Module Index &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="search.html" />
-    <link rel="top" title="proxypool  documentation" href="index.html" />
-
-   
-  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-
-   <h1>Python Module Index</h1>
-
-   <div class="modindex-jumpbox">
-   <a href="#cap-f"><strong>f</strong></a> | 
-   <a href="#cap-p"><strong>p</strong></a>
-   </div>
-
-   <table class="indextable modindextable" cellspacing="0" cellpadding="2">
-     <tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
-     <tr class="cap" id="cap-f"><td></td><td>
-       <strong>f</strong></td><td></td></tr>
-     <tr>
-       <td><img src="_static/minus.png" class="toggler"
-              id="toggle-1" style="display: none" alt="-" /></td>
-       <td>
-       <a href="flask/flask.html#module-flask"><code class="xref">flask</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.app"><code class="xref">flask.app</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.blueprints"><code class="xref">flask.blueprints</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.cli"><code class="xref">flask.cli</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.config"><code class="xref">flask.config</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.ctx"><code class="xref">flask.ctx</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.debughelpers"><code class="xref">flask.debughelpers</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.ext.html#module-flask.ext"><code class="xref">flask.ext</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.exthook"><code class="xref">flask.exthook</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.globals"><code class="xref">flask.globals</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.helpers"><code class="xref">flask.helpers</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.json"><code class="xref">flask.json</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.logging"><code class="xref">flask.logging</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.sessions"><code class="xref">flask.sessions</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.signals"><code class="xref">flask.signals</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.templating"><code class="xref">flask.templating</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.testing"><code class="xref">flask.testing</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.views"><code class="xref">flask.views</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-1">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="flask/flask.html#module-flask.wrappers"><code class="xref">flask.wrappers</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
-     <tr class="cap" id="cap-p"><td></td><td>
-       <strong>p</strong></td><td></td></tr>
-     <tr>
-       <td><img src="_static/minus.png" class="toggler"
-              id="toggle-2" style="display: none" alt="-" /></td>
-       <td>
-       <a href="proxypool.html#module-proxypool"><code class="xref">proxypool</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.api"><code class="xref">proxypool.api</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.db"><code class="xref">proxypool.db</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.error"><code class="xref">proxypool.error</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.proxyGetter"><code class="xref">proxypool.proxyGetter</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.schedule"><code class="xref">proxypool.schedule</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.setting"><code class="xref">proxypool.setting</code></a></td><td>
-       <em></em></td></tr>
-     <tr class="cg-2">
-       <td></td>
-       <td>&#160;&#160;&#160;
-       <a href="proxypool.html#module-proxypool.utils"><code class="xref">proxypool.utils</code></a></td><td>
-       <em></em></td></tr>
-   </table>
-
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
-  <h3>Quick search</h3>
-    <form class="search" action="search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="Go" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
-    </form>
-</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/_build/html/search.html

@@ -1,104 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    
-    <title>Search &#8212; proxypool  documentation</title>
-    
-    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
-    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-    
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    './',
-        VERSION:     '',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="_static/jquery.js"></script>
-    <script type="text/javascript" src="_static/underscore.js"></script>
-    <script type="text/javascript" src="_static/doctools.js"></script>
-    <script type="text/javascript" src="_static/searchtools.js"></script>
-    <link rel="index" title="Index" href="genindex.html" />
-    <link rel="search" title="Search" href="#" />
-    <link rel="top" title="proxypool  documentation" href="index.html" />
-  <script type="text/javascript">
-    jQuery(function() { Search.loadIndex("searchindex.js"); });
-  </script>
-  
-  <script type="text/javascript" id="searchindexloader"></script>
-  
-   
-  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-  
-  
-  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
-
-  </head>
-  <body role="document">
-  
-
-    <div class="document">
-      <div class="documentwrapper">
-        <div class="bodywrapper">
-          <div class="body" role="main">
-            
-  <h1 id="search-documentation">Search</h1>
-  <div id="fallback" class="admonition warning">
-  <script type="text/javascript">$('#fallback').hide();</script>
-  <p>
-    Please activate JavaScript to enable the search
-    functionality.
-  </p>
-  </div>
-  <p>
-    From here you can search these documents. Enter your search
-    words into the box below and click "search". Note that the search
-    function will automatically search for all of the words. Pages
-    containing fewer words won't appear in the result list.
-  </p>
-  <form action="" method="get">
-    <input type="text" name="q" value="" />
-    <input type="submit" value="search" />
-    <span id="search-progress" style="padding-left: 10px"></span>
-  </form>
-  
-  <div id="search-results">
-  
-  </div>
-
-          </div>
-        </div>
-      </div>
-      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
-        <div class="sphinxsidebarwrapper"><div class="relations">
-<h3>Related Topics</h3>
-<ul>
-  <li><a href="index.html">Documentation overview</a><ul>
-  </ul></li>
-</ul>
-</div>
-        </div>
-      </div>
-      <div class="clearer"></div>
-    </div>
-    <div class="footer">
-      &copy;2016, Author.
-      
-      |
-      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.8</a>
-      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.9</a>
-      
-    </div>
-
-    
-
-    
-  </body>
-</html>

docs/conf.py

@@ -1,428 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-#
-# proxypool documentation build configuration file, created by
-# sphinx-quickstart on Sun Dec 18 11:44:51 2016.
-#
-# This file is execfile()d with the current directory set to its
-# containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-
-# -- General configuration ------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx.ext.todo',
-    'sphinx.ext.viewcode',
-]
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
-
-# The encoding of source files.
-#
-# source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = 'proxypool'
-copyright = '2016, Author'
-author = 'Author'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = ''
-# The full version, including alpha/beta/rc tags.
-release = ''
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
-language = 'en'
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#
-# today = ''
-#
-# Else, today_fmt is used as the format for a strftime call.
-#
-# today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
-
-# The reST default role (used for this markup: `text`) to use for all
-# documents.
-#
-# default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#
-# add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#
-# add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#
-# show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-# modindex_common_prefix = []
-
-# If true, keep warnings as "system message" paragraphs in the built documents.
-# keep_warnings = False
-
-# If true, `todo` and `todoList` produce output, else they produce nothing.
-todo_include_todos = True
-
-
-# -- Options for HTML output ----------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = 'alabaster'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-#
-# html_theme_options = {}
-
-# Add any paths that contain custom themes here, relative to this directory.
-# html_theme_path = []
-
-# The name for this set of Sphinx documents.
-# "<project> v<release> documentation" by default.
-#
-# html_title = 'proxypool v'
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#
-# html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#
-# html_logo = None
-
-# The name of an image file (relative to this directory) to use as a favicon of
-# the docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#
-# html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# Add any extra paths that contain custom files (such as robots.txt or
-# .htaccess) here, relative to this directory. These files are copied
-# directly to the root of the documentation.
-#
-# html_extra_path = []
-
-# If not None, a 'Last updated on:' timestamp is inserted at every page
-# bottom, using the given strftime format.
-# The empty string is equivalent to '%b %d, %Y'.
-#
-# html_last_updated_fmt = None
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#
-# html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#
-# html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#
-# html_additional_pages = {}
-
-# If false, no module index is generated.
-#
-# html_domain_indices = True
-
-# If false, no index is generated.
-#
-# html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#
-# html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#
-# html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#
-# html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#
-# html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#
-# html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-# html_file_suffix = None
-
-# Language to be used for generating the HTML full-text search index.
-# Sphinx supports the following languages:
-#   'da', 'de', 'en', 'es', 'fi', 'fr', 'h', 'it', 'ja'
-#   'nl', 'no', 'pt', 'ro', 'r', 'sv', 'tr', 'zh'
-#
-# html_search_language = 'en'
-
-# A dictionary with options for the search language support, empty by default.
-# 'ja' uses this config value.
-# 'zh' user can custom change `jieba` dictionary path.
-#
-# html_search_options = {'type': 'default'}
-
-# The name of a javascript file (relative to the configuration directory) that
-# implements a search results scorer. If empty, the default will be used.
-#
-# html_search_scorer = 'scorer.js'
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'proxypooldoc'
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements = {
-     # The paper size ('letterpaper' or 'a4paper').
-     #
-     # 'papersize': 'letterpaper',
-
-     # The font size ('10pt', '11pt' or '12pt').
-     #
-     # 'pointsize': '10pt',
-
-     # Additional stuff for the LaTeX preamble.
-     #
-     # 'preamble': '',
-
-     # Latex figure (float) alignment
-     #
-     # 'figure_align': 'htbp',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-    (master_doc, 'proxypool.tex', 'proxypool Documentation',
-     'Author', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#
-# latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#
-# latex_use_parts = False
-
-# If true, show page references after internal links.
-#
-# latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#
-# latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#
-# latex_appendices = []
-
-# It false, will not define \strong, \code, 	itleref, \crossref ... but only
-# \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added
-# packages.
-#
-# latex_keep_old_macro_names = True
-
-# If false, no module index is generated.
-#
-# latex_domain_indices = True
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'proxypool', 'proxypool Documentation',
-     [author], 1)
-]
-
-# If true, show URL addresses after external links.
-#
-# man_show_urls = False
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (master_doc, 'proxypool', 'proxypool Documentation',
-     author, 'proxypool', 'One line description of project.',
-     'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#
-# texinfo_appendices = []
-
-# If false, no module index is generated.
-#
-# texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#
-# texinfo_show_urls = 'footnote'
-
-# If true, do not generate a @detailmenu in the "Top" node's menu.
-#
-# texinfo_no_detailmenu = False
-
-
-# -- Options for Epub output ----------------------------------------------
-
-# Bibliographic Dublin Core info.
-epub_title = project
-epub_author = author
-epub_publisher = author
-epub_copyright = copyright
-
-# The basename for the epub file. It defaults to the project name.
-# epub_basename = project
-
-# The HTML theme for the epub output. Since the default themes are not
-# optimized for small screen space, using the same theme for HTML and epub
-# output is usually not wise. This defaults to 'epub', a theme designed to save
-# visual space.
-#
-# epub_theme = 'epub'
-
-# The language of the text. It defaults to the language option
-# or 'en' if the language is not set.
-#
-# epub_language = ''
-
-# The scheme of the identifier. Typical schemes are ISBN or URL.
-# epub_scheme = ''
-
-# The unique identifier of the text. This can be a ISBN number
-# or the project homepage.
-#
-# epub_identifier = ''
-
-# A unique identification for the text.
-#
-# epub_uid = ''
-
-# A tuple containing the cover image and cover page html template filenames.
-#
-# epub_cover = ()
-
-# A sequence of (type, uri, title) tuples for the guide element of content.opf.
-#
-# epub_guide = ()
-
-# HTML files that should be inserted before the pages created by sphinx.
-# The format is a list of tuples containing the path and title.
-#
-# epub_pre_files = []
-
-# HTML files that should be inserted after the pages created by sphinx.
-# The format is a list of tuples containing the path and title.
-#
-# epub_post_files = []
-
-# A list of files that should not be packed into the epub file.
-epub_exclude_files = ['search.html']
-
-# The depth of the table of contents in toc.ncx.
-#
-# epub_tocdepth = 3
-
-# Allow duplicate toc entries.
-#
-# epub_tocdup = True
-
-# Choose between 'default' and 'includehidden'.
-#
-# epub_tocscope = 'default'
-
-# Fix unsupported image types using the Pillow.
-#
-# epub_fix_images = False
-
-# Scale large images.
-#
-# epub_max_image_width = 0
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#
-# epub_show_urls = 'inline'
-
-# If false, no index is generated.
-#
-# epub_use_index = True

docs/index.rst

@@ -1,23 +0,0 @@
-.. proxypool documentation master file, created by
-   sphinx-quickstart on Sun Dec 18 11:44:51 2016.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to proxypool's documentation!
-=====================================
-
-Contents:
-
-.. toctree::
-   :maxdepth: 4
-
-   proxypool
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-

docs/make.bat

@@ -1,281 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=_build
-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
-set I18NSPHINXOPTS=%SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  epub3      to make an epub3
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  xml        to make Docutils-native XML files
-	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	echo.  coverage   to run coverage check of the documentation if enabled
-	echo.  dummy      to check syntax errors of document sources
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-
-REM Check if sphinx-build is available and fallback to Python version if any
-%SPHINXBUILD% 1>NUL 2>NUL
-if errorlevel 9009 goto sphinx_python
-goto sphinx_ok
-
-:sphinx_python
-
-set SPHINXBUILD=python -m sphinx.__init__
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-:sphinx_ok
-
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
-	goto end
-)
-
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\proxypool.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\proxypool.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "epub3" (
-	%SPHINXBUILD% -b epub3 %ALLSPHINXOPTS% %BUILDDIR%/epub3
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub3 file is in %BUILDDIR%/epub3.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdf" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdfja" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf-ja
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-if "%1" == "coverage" (
-	%SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of coverage in the sources finished, look at the ^
-results in %BUILDDIR%/coverage/python.txt.
-	goto end
-)
-
-if "%1" == "xml" (
-	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The XML files are in %BUILDDIR%/xml.
-	goto end
-)
-
-if "%1" == "pseudoxml" (
-	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
-	goto end
-)
-
-if "%1" == "dummy" (
-	%SPHINXBUILD% -b dummy %ALLSPHINXOPTS% %BUILDDIR%/dummy
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. Dummy builder generates no files.
-	goto end
-)
-
-:end

docs/proxypool.rst

@@ -1,70 +0,0 @@
-proxypool package
-=================
-
-Submodules
-----------
-
-proxypool.api module
---------------------
-
-.. automodule:: proxypool.api
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.db module
--------------------
-
-.. automodule:: proxypool.db
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.error module
-----------------------
-
-.. automodule:: proxypool.error
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.proxyGetter module
-----------------------------
-
-.. automodule:: proxypool.proxyGetter
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.schedule module
--------------------------
-
-.. automodule:: proxypool.schedule
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.setting module
-------------------------
-
-.. automodule:: proxypool.setting
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-proxypool.utils module
-----------------------
-
-.. automodule:: proxypool.utils
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: proxypool
-    :members:
-    :undoc-members:
-    :show-inheritance:

examples/example.py

@@ -2,13 +2,10 @@ import os
 import sys
 import requests
 from bs4 import BeautifulSoup
-import lxml
-parentdir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-sys.path.insert(0, parentdir)
 
-# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-# Before run this example, Please run 'run.py'.!!
-# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+sys.path.insert(0, dir)
+
 
 def get_proxy():
     r = requests.get('http://127.0.0.1:5000/get')

examples/testaio.py

@@ -1,16 +0,0 @@
-import aiohttp
-import asyncio
-import async_timeout
-
-async def fetch(session, url):
-    with async_timeout.timeout(10):
-        async with session.get(url) as response:
-            return await response.text()
-
-async def main(loop):
-    async with aiohttp.ClientSession(loop=loop) as session:
-        html = await fetch(session, 'http://www.baidu.com')
-        print(html)
-
-loop = asyncio.get_event_loop()
-loop.run_until_complete(main(loop))

examples/testaio2.py

@@ -1,37 +0,0 @@
-import asyncio
-import random
-
-
-@asyncio.coroutine
-def smart_fib(n):
-	index = 0
-	a = 0
-	b = 1
-	while index < n:
-		sleep_secs = random.uniform(0, 0.2)
-		yield from asyncio.sleep(sleep_secs)
-		print('Smart one think {} secs to get {}'.format(sleep_secs, b))
-		a, b = b, a + b
-		index += 1
-
-@asyncio.coroutine
-def stupid_fib(n):
-	index = 0
-	a = 0
-	b = 1
-	while index < n:
-		sleep_secs = random.uniform(0, 0.4)
-		yield from asyncio.sleep(sleep_secs)
-		print('Stupid one think {} secs to get {}'.format(sleep_secs, b))
-		a, b = b, a + b
-		index += 1
-
-if __name__ == '__main__':
-	loop = asyncio.get_event_loop()
-	tasks = [
-		asyncio.async(smart_fib(10)),
-		asyncio.async(stupid_fib(10)),
-	]
-	loop.run_until_complete(asyncio.wait(tasks))
-	print('All fib finished.')
-	loop.close()

proxypool/db.py

@@ -15,6 +15,7 @@ class RedisClient(object):
         """从Pool中获取一定量数据。"""
         proxies = self._db.lrange("proxies", 0, count - 1)
         self._db.ltrim("proxies", count, -1)
+        print(proxies)
         return proxies
 
     def put(self, proxy):
@@ -37,7 +38,7 @@ class RedisClient(object):
         """弹出一个可用代理。
         """
         try:
-            return self._db.blpop("proxies", 30)[1].decode('utf-8')
+            return self._db.rpop("proxies").decode('utf-8')
         except:
             raise PoolEmptyError
 
@@ -55,4 +56,4 @@ class RedisClient(object):
 
 if __name__ == '__main__':
     conn = RedisClient()
-    print(conn.get(20))
+    print(conn.pop())

proxypool/getter.py

@@ -32,6 +32,7 @@ class FreeProxyGetter(object, metaclass=ProxyMetaclass):
         proxies = []
         print('Callback', callback)
         for proxy in eval("self.{}()".format(callback)):
+            print('Getting', proxy, 'from', callback)
             proxies.append(proxy)
         return proxies
 

proxypool/schedule.py

@@ -2,10 +2,12 @@ import time
 from multiprocessing import Process
 import asyncio
 import aiohttp
+from aiohttp.errors import ProxyConnectionError
 from proxypool.db import RedisClient
 from proxypool.error import ResourceDepletionError
 from proxypool.getter import FreeProxyGetter
 from proxypool.setting import *
+from asyncio import TimeoutError
 
 
 class ValidityTester(object):
@@ -32,13 +34,15 @@ class ValidityTester(object):
         """
         async with aiohttp.ClientSession() as session:
             try:
+                if isinstance(proxy, bytes):
+                    proxy = proxy.decode('utf-8')
                 real_proxy = 'http://' + proxy
-                print('Testing', real_proxy)
+                print('Testing', proxy)
                 async with session.get(self.test_api, proxy=real_proxy, timeout=15) as response:
-                    await response
-                    self._usable_proxies.append(proxy)
-                    print('Valid proxy', proxy)
-            except Exception:
+                    if response.status == 200:
+                        self._usable_proxies.append(proxy)
+                        print('Valid proxy', proxy)
+            except (ProxyConnectionError, TimeoutError):
                 print('Invalid proxy', proxy)
 
     def test(self):
@@ -46,9 +50,12 @@ class ValidityTester(object):
         异步检测_raw_proxies中的全部代理。
         """
         print('ValidityTester is working')
-        loop = asyncio.get_event_loop()
-        tasks = [self.test_single_proxy(proxy) for proxy in self._raw_proxies]
-        loop.run_until_complete(asyncio.wait(tasks))
+        try:
+            loop = asyncio.get_event_loop()
+            tasks = [self.test_single_proxy(proxy) for proxy in self._raw_proxies]
+            loop.run_until_complete(asyncio.wait(tasks))
+        except ValueError:
+            print('Async Error')
 
     def get_usable_proxies(self):
         return self._usable_proxies
@@ -81,11 +88,18 @@ class PoolAdder(object):
         """
         print('PoolAdder is working')
         proxy_count = 0
-        if not self.is_over_threshold():
+        while not self.is_over_threshold():
             for callback_label in range(self._crawler.__CrawlFuncCount__):
                 callback = self._crawler.__CrawlFunc__[callback_label]
                 raw_proxies = self._crawler.get_raw_proxies(callback)
+                self._tester.set_raw_proxies(raw_proxies)
+                self._tester.test()
+                proxies = self._tester.get_usable_proxies()
+                self._conn.put_many(proxies)
                 proxy_count += len(raw_proxies)
+                if self.is_over_threshold():
+                    print('IP is enough, waiting to be used')
+                    break
             if proxy_count == 0:
                 raise ResourceDepletionError
 
@@ -100,20 +114,23 @@ class Schedule(object):
         """
         对已经如池的代理进行检测，防止池中的代理因长期
         不使用而过期。
-        抽出代理池队列中前1/4的代理，检测，合格者压入队列尾。
+        抽出代理池队列中前1/2的代理，检测，合格者压入队列尾。
         """
         conn = RedisClient()
         tester = ValidityTester()
         while True:
-            time.sleep(cycle)
-            count = int(0.25 * conn.queue_len)
+            print('Refreshing ip')
+            count = int(0.5 * conn.queue_len)
             if count == 0:
+                print('Waiting for adding')
+                time.sleep(cycle)
                 continue
             raw_proxies = conn.get(count)
             tester.set_raw_proxies(raw_proxies)
             tester.test()
             proxies = tester.get_usable_proxies()
             conn.put_many(proxies)
+            time.sleep(cycle)
 
     @staticmethod
     def check_pool(lower_threshold=POOL_LOWER_THRESHOLD,
@@ -134,6 +151,7 @@ class Schedule(object):
         """
         运行调度器，创建两个进程，对代理池进行维护。
         """
+        print('Ip processing running')
         valid_process = Process(target=Schedule.valid_proxy)
         check_process = Process(target=Schedule.check_pool)
         valid_process.start()

proxypool/setting.py

@@ -4,10 +4,10 @@ HOST = 'localhost'
 PORT = 6379
 
 
-POOL_LOWER_THRESHOLD = 20
-POOL_UPPER_THRESHOLD = 200
+POOL_LOWER_THRESHOLD = 2
+POOL_UPPER_THRESHOLD = 100
 
-VALID_CHECK_CYCLE = 600
+VALID_CHECK_CYCLE = 60
 POOL_LEN_CHECK_CYCLE = 20
 
 TEST_API='http://www.baidu.com'

tests/test_api.py

@@ -1,41 +0,0 @@
-import unittest
-import os
-import sys
-parentdir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-sys.path.insert(0, parentdir)
-from proxypool.db import RedisClient
-from proxypool.api import app
-
-
-class ApiTestCase(unittest.TestCase):
-
-    def setUp(self):
-        self._app = app.test_client()
-        self._conn = RedisClient()
-
-    def tearDown(self):
-        self._conn.flush()
-
-    def test_get(self):
-        self._conn.put('aaa')
-        self._conn.put('bbb')
-        r = self._app.get('/get')
-        assert 'aaa' in str(r.data)
-        r = self._app.get('/get')
-        assert 'bbb' in str(r.data)
-
-    def test_count(self):
-        self._conn.put('aaa')
-        self._conn.put('bbb')
-        r = self._app.get('/count')
-        assert '2' in str(r.data)
-        self._conn.put('ccc')
-        self._conn.put('ddd')
-        r = self._app.get('/count')
-        assert '4' in str(r.data)
-        proxy = self._conn.pop()
-        r = self._app.get('/count')
-        assert '3' in str(r.data)
-
-if __name__ == '__main__':
-    unittest.main()

tests/test_db.py

@@ -1,36 +0,0 @@
-import unittest
-import os
-import sys
-parentdir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-sys.path.insert(0, parentdir)
-from proxypool.db import RedisClient
-
-
-class RedisClientTestCase(unittest.TestCase):
-
-    def setUp(self):
-        self._conn = RedisClient()
-
-    def tearDown(self):
-        self._conn.flush()
-
-    def test_put_and_pop(self):
-        self._conn.put("label")
-        assert self._conn.pop() == "label"
-
-    def test_put_many(self):
-        self._conn.put_many(['a', 'b'])
-        assert self._conn.pop() == "a"
-        assert self._conn.pop() == "b"
-
-    def test_len(self):
-        self._conn.put_many(['a', 'b', 'c'])
-        assert self._conn.queue_len == 3
-
-    def test_get(self):
-        self._conn.put_many(['a', 'b', 'c', 'd'])
-        _ = self._conn.get(2)
-        assert self._conn.queue_len == 2
-
-if __name__ == '__main__':
-    unittest.main()

tests/test_schdule.py

@@ -1,28 +0,0 @@
-import unittest
-import os
-import sys
-parentdir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-sys.path.insert(0, parentdir)
-from proxypool.schedule import ValidityTester
-
-
-class SchduleTestCase(unittest.TestCase):
-
-    def setUp(self):
-        self._tester = ValidityTester()
-
-    def tearDown(self):
-        pass
-
-    def test_tester(self):
-        fake_proxies = ['00.000.00.00:8000',
-                        '01.000.00.00:8001',
-                        '00.020.00.00:8002',
-                        '00.000.30.00:8003']
-        self._tester.set_raw_proxies(fake_proxies)
-        self._tester.test()
-        proxies = self._tester._usable_proxies
-        assert proxies == []
-
-if __name__ == '__main__':
-    unittest.main()