├── .bumpversion.cfg
├── .gitignore
├── .travis.yml
├── LICENSE
├── MANIFEST.in
├── Makefile
├── README.md
├── README_dev.md
├── docs
├── .buildinfo
├── .doctrees
│ ├── api.doctree
│ ├── contributing.doctree
│ ├── environment.pickle
│ ├── index.doctree
│ └── welcome.doctree
├── .nojekyll
├── _modules
│ ├── index.html
│ └── many_requests
│ │ ├── easy_async.html
│ │ └── many_requests_.html
├── _sources
│ ├── api.rst.txt
│ ├── contributing.md.txt
│ ├── index.rst.txt
│ └── welcome.md.txt
├── _static
│ ├── basic.css
│ ├── css
│ │ ├── badge_only.css
│ │ ├── fonts
│ │ │ ├── Roboto-Slab-Bold.woff
│ │ │ ├── Roboto-Slab-Bold.woff2
│ │ │ ├── Roboto-Slab-Regular.woff
│ │ │ ├── Roboto-Slab-Regular.woff2
│ │ │ ├── fontawesome-webfont.eot
│ │ │ ├── fontawesome-webfont.svg
│ │ │ ├── fontawesome-webfont.ttf
│ │ │ ├── fontawesome-webfont.woff
│ │ │ ├── fontawesome-webfont.woff2
│ │ │ ├── lato-bold-italic.woff
│ │ │ ├── lato-bold-italic.woff2
│ │ │ ├── lato-bold.woff
│ │ │ ├── lato-bold.woff2
│ │ │ ├── lato-normal-italic.woff
│ │ │ ├── lato-normal-italic.woff2
│ │ │ ├── lato-normal.woff
│ │ │ └── lato-normal.woff2
│ │ └── theme.css
│ ├── doctools.js
│ ├── documentation_options.js
│ ├── file.png
│ ├── fonts
│ │ ├── FontAwesome.otf
│ │ ├── Lato
│ │ │ ├── lato-bold.eot
│ │ │ ├── lato-bold.ttf
│ │ │ ├── lato-bold.woff
│ │ │ ├── lato-bold.woff2
│ │ │ ├── lato-bolditalic.eot
│ │ │ ├── lato-bolditalic.ttf
│ │ │ ├── lato-bolditalic.woff
│ │ │ ├── lato-bolditalic.woff2
│ │ │ ├── lato-italic.eot
│ │ │ ├── lato-italic.ttf
│ │ │ ├── lato-italic.woff
│ │ │ ├── lato-italic.woff2
│ │ │ ├── lato-regular.eot
│ │ │ ├── lato-regular.ttf
│ │ │ ├── lato-regular.woff
│ │ │ └── lato-regular.woff2
│ │ ├── Roboto-Slab-Bold.woff
│ │ ├── Roboto-Slab-Bold.woff2
│ │ ├── Roboto-Slab-Light.woff
│ │ ├── Roboto-Slab-Light.woff2
│ │ ├── Roboto-Slab-Regular.woff
│ │ ├── Roboto-Slab-Regular.woff2
│ │ ├── Roboto-Slab-Thin.woff
│ │ ├── Roboto-Slab-Thin.woff2
│ │ ├── RobotoSlab
│ │ │ ├── roboto-slab-v7-bold.eot
│ │ │ ├── roboto-slab-v7-bold.ttf
│ │ │ ├── roboto-slab-v7-bold.woff
│ │ │ ├── roboto-slab-v7-bold.woff2
│ │ │ ├── roboto-slab-v7-regular.eot
│ │ │ ├── roboto-slab-v7-regular.ttf
│ │ │ ├── roboto-slab-v7-regular.woff
│ │ │ └── roboto-slab-v7-regular.woff2
│ │ ├── fontawesome-webfont.eot
│ │ ├── fontawesome-webfont.svg
│ │ ├── fontawesome-webfont.ttf
│ │ ├── fontawesome-webfont.woff
│ │ ├── fontawesome-webfont.woff2
│ │ ├── lato-bold-italic.woff
│ │ ├── lato-bold-italic.woff2
│ │ ├── lato-bold.woff
│ │ ├── lato-bold.woff2
│ │ ├── lato-normal-italic.woff
│ │ ├── lato-normal-italic.woff2
│ │ ├── lato-normal.woff
│ │ └── lato-normal.woff2
│ ├── jquery-3.5.1.js
│ ├── jquery.js
│ ├── js
│ │ ├── badge_only.js
│ │ ├── html5shiv-printshiv.min.js
│ │ ├── html5shiv.min.js
│ │ ├── modernizr.min.js
│ │ └── theme.js
│ ├── language_data.js
│ ├── minus.png
│ ├── plus.png
│ ├── pygments.css
│ ├── searchtools.js
│ ├── underscore-1.3.1.js
│ └── underscore.js
├── api.html
├── contributing.html
├── genindex.html
├── index.html
├── objects.inv
├── search.html
├── searchindex.js
└── welcome.html
├── docs_source
├── api.rst
├── conf.py
├── contributing.md
├── index.rst
└── welcome.md
├── many_requests
├── __init__.py
├── common.py
├── easy_async.py
└── many_requests_.py
├── pytest.ini
├── requirements.txt
├── requirements_dev.txt
├── setup.cfg
├── setup.py
├── tests
├── __init__.py
├── mock_server.py
├── test_authentication.py
├── test_easy_async.py
└── test_many_requests.py
└── tox.ini
/.bumpversion.cfg:
--------------------------------------------------------------------------------
1 | [bumpversion]
2 | current_version = 0.2.1
3 | commit = True
4 | tag = True
5 |
6 | [bumpversion:file:setup.cfg]
7 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | # Created by .ignore support plugin (hsz.mobi)
2 | ### JetBrains template
3 | # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
4 | # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
5 |
6 | # User-specific stuff
7 | .idea/**/workspace.xml
8 | .idea/**/tasks.xml
9 | .idea/**/usage.statistics.xml
10 | .idea/**/dictionaries
11 | .idea/**/shelf
12 |
13 | # Generated files
14 | .idea/**/contentModel.xml
15 |
16 | # Sensitive or high-churn files
17 | .idea/**/dataSources/
18 | .idea/**/dataSources.ids
19 | .idea/**/dataSources.local.xml
20 | .idea/**/sqlDataSources.xml
21 | .idea/**/dynamic.xml
22 | .idea/**/uiDesigner.xml
23 | .idea/**/dbnavigator.xml
24 |
25 | # Gradle
26 | .idea/**/gradle.xml
27 | .idea/**/libraries
28 |
29 | # Gradle and Maven with auto-import
30 | # When using Gradle or Maven with auto-import, you should exclude module files,
31 | # since they will be recreated, and may cause churn. Uncomment if using
32 | # auto-import.
33 | # .idea/artifacts
34 | # .idea/compiler.xml
35 | # .idea/jarRepositories.xml
36 | # .idea/modules.xml
37 | # .idea/*.iml
38 | # .idea/modules
39 | # *.iml
40 | # *.ipr
41 |
42 | # CMake
43 | cmake-build-*/
44 |
45 | # Mongo Explorer plugin
46 | .idea/**/mongoSettings.xml
47 |
48 | # File-based project format
49 | *.iws
50 |
51 | # IntelliJ
52 | out/
53 |
54 | # mpeltonen/sbt-idea plugin
55 | .idea_modules/
56 |
57 | # JIRA plugin
58 | atlassian-ide-plugin.xml
59 |
60 | # Cursive Clojure plugin
61 | .idea/replstate.xml
62 |
63 | # Crashlytics plugin (for Android Studio and IntelliJ)
64 | com_crashlytics_export_strings.xml
65 | crashlytics.properties
66 | crashlytics-build.properties
67 | fabric.properties
68 |
69 | # Editor-based Rest Client
70 | .idea/httpRequests
71 |
72 | # Android studio 3.1+ serialized cache file
73 | .idea/caches/build_file_checksums.ser
74 |
75 | ### Python template
76 | # Byte-compiled / optimized / DLL files
77 | __pycache__/
78 | *.py[cod]
79 | *$py.class
80 |
81 | # C extensions
82 | *.so
83 |
84 | # Distribution / packaging
85 | .Python
86 | build/
87 | develop-eggs/
88 | dist/
89 | downloads/
90 | eggs/
91 | .eggs/
92 | lib/
93 | lib64/
94 | parts/
95 | sdist/
96 | var/
97 | wheels/
98 | share/python-wheels/
99 | *.egg-info/
100 | .installed.cfg
101 | *.egg
102 | MANIFEST
103 |
104 | # PyInstaller
105 | # Usually these files are written by a python script from a template
106 | # before PyInstaller builds the exe, so as to inject date/other infos into it.
107 | *.manifest
108 | *.spec
109 |
110 | # Installer logs
111 | pip-log.txt
112 | pip-delete-this-directory.txt
113 |
114 | # Unit test / coverage reports
115 | htmlcov/
116 | .tox/
117 | .nox/
118 | .coverage
119 | .coverage.*
120 | .cache
121 | nosetests.xml
122 | coverage.xml
123 | *.cover
124 | *.py,cover
125 | .hypothesis/
126 | .pytest_cache/
127 | cover/
128 |
129 | # Translations
130 | *.mo
131 | *.pot
132 |
133 | # Django stuff:
134 | *.log
135 | local_settings.py
136 | db.sqlite3
137 | db.sqlite3-journal
138 |
139 | # Flask stuff:
140 | instance/
141 | .webassets-cache
142 |
143 | # Scrapy stuff:
144 | .scrapy
145 |
146 | # Sphinx documentation
147 | docs/_build/
148 |
149 | # PyBuilder
150 | .pybuilder/
151 | target/
152 |
153 | # Jupyter Notebook
154 | .ipynb_checkpoints
155 |
156 | # IPython
157 | profile_default/
158 | ipython_config.py
159 |
160 | # pyenv
161 | # For a library or package, you might want to ignore these files since the code is
162 | # intended to run in multiple environments; otherwise, check them in:
163 | # .python-version
164 |
165 | # pipenv
166 | # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
167 | # However, in case of collaboration, if having platform-specific dependencies or dependencies
168 | # having no cross-platform support, pipenv may install dependencies that don't work, or not
169 | # install all needed dependencies.
170 | #Pipfile.lock
171 |
172 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow
173 | __pypackages__/
174 |
175 | # Celery stuff
176 | celerybeat-schedule
177 | celerybeat.pid
178 |
179 | # SageMath parsed files
180 | *.sage.py
181 |
182 | # Environments
183 | .env
184 | .venv
185 | env/
186 | venv/
187 | ENV/
188 | env.bak/
189 | venv.bak/
190 |
191 | # Spyder project settings
192 | .spyderproject
193 | .spyproject
194 |
195 | # Rope project settings
196 | .ropeproject
197 |
198 | # mkdocs documentation
199 | /site
200 |
201 | # mypy
202 | .mypy_cache/
203 | .dmypy.json
204 | dmypy.json
205 |
206 | # Pyre type checker
207 | .pyre/
208 |
209 | # pytype static type analyzer
210 | .pytype/
211 |
212 | # Cython debug symbols
213 | cython_debug/
214 |
215 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: python
2 | python:
3 | - "3.6"
4 | - "3.7"
5 | - "3.8"
6 | - "3.9"
7 | before_install:
8 | - python --version
9 | - pip install --upgrade pip
10 | - pip install --upgrade pytest
11 | install:
12 | - pip install -r requirements.txt
13 | - pip install -r requirements_dev.txt
14 | script:
15 | - pytest
16 | after_success:
17 | - codecov # submit coverage
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2020 Josh Levy-Kramer
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/MANIFEST.in:
--------------------------------------------------------------------------------
1 | include README*.md
2 | include requirements*.txt
3 | include LICENSE
4 | include pyproject.toml
5 | global-include *.pyx
6 | global-include *.pyd
--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | # Add to PHONY target list so it always it run even when nothing has changed
2 | .PHONY: dist install clean venv-create venv-activate docs check-dist test-pypi pypi-upload
3 |
4 | dist:
5 | python setup.py sdist bdist_wheel
6 |
7 | install:
8 | pip install .
9 |
10 | clean:
11 | $(RM) -r build dist src/*.egg-info
12 | $(RM) -r .pytest_cache
13 | find . -name __pycache__ -exec rm -r {} +
14 | #git clean -fdX
15 |
16 | venv-create:
17 | python -m venv many_requests-venv
18 | source many_requests-venv/bin/activate
19 |
20 | venv-activate:
21 | # Doesn't work. Need to execute manually
22 | source many_requests-venv/bin/activate
23 |
24 | venv-delete:
25 | rm -rf many_requests-venv
26 |
27 | docs:
28 | sphinx-build -a -E -b html docs_source docs
29 |
30 | check-dist:
31 | twine check dist/*
32 |
33 | test-pypi:
34 | twine upload --repository-url https://test.pypi.org/legacy/ dist/*
35 |
36 | pypi-upload:
37 | twine upload dist/*
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | [](https://pypi.org/project/many_requests/)
2 | 
3 | [](https://travis-ci.com/joshlk/many_requests)
4 | [](https://joshlk.github.io/many_requests)
5 |
6 | # many_requests
7 |
8 | Dead easy interface for executing many HTTP requests asynchronously.
9 | It has been tested in the wild with over 10 million requests.
10 | Automatically handles errors and executes retries.
11 |
12 | Built on-top of [Trio](https://github.com/python-trio/trio) and [asks](https://github.com/theelous3/asks). Interface heavily inspired by [Requests](https://github.com/psf/requests) and [joblib](https://github.com/joblib/joblib).
13 |
14 | Also provides helper functions for executing [embarrassingly parallel](https://en.wikipedia.org/wiki/Embarrassingly_parallel) async coroutines.
15 |
16 | To install:
17 |
18 | ```bash
19 | pip install many-requests
20 | ```
21 |
22 | ## Example Usage
23 |
24 | Execute 10 GET requests for example.org:
25 |
26 | ```python
27 | from many_requests import ManyRequests
28 | responses = ManyRequests(n_workers=5, n_connections=5)(
29 | method='GET',
30 | url=['https://example.org' for i in range(10)])
31 | ```
32 |
33 | Query HackNews API for 10 items and parse JSON output:
34 |
35 | ```python
36 | responses = ManyRequests(n_workers=5, n_connections=5, json=True)(
37 | method='GET',
38 | url=[f'https://hacker-news.firebaseio.com/v0/item/{i}.json?print=pretty' for i in range(10)])
39 | ```
40 |
41 | To use basic authentication with all requests:
42 |
43 | ```python
44 | from asks import BasicAuth
45 | username = 'user'
46 | password = 'pw'
47 | responses = ManyRequests(n_workers=5, n_connections=5)(
48 | method='GET',
49 | url=['https://example.org' for i in range(10)],
50 | auth=BasicAuth((username, password)))
51 | ```
52 |
53 | To execute embarrassingly parallel async coroutines, for example 10 `trio.sleep` calls:
54 |
55 | ```python
56 | from many_requests import EasyAsync, delayed
57 | import trio
58 | outputs = EasyAsync(n_workers = 4)(delayed(trio.sleep)(i) for i in range(10))
59 | ```
60 |
--------------------------------------------------------------------------------
/README_dev.md:
--------------------------------------------------------------------------------
1 |
2 | # Build and push to PyPi
3 | Requires: `pip install twine`
4 | Don't forget to increment version number
5 |
6 | Bump version (major, minor or patch):
7 |
8 | ```shell script
9 | bump2version patch
10 | ```
11 |
12 | Build dist
13 |
14 | ```shell script
15 | rm -r dist
16 | make dist
17 | ```
18 |
19 | Upload to test PyPi
20 |
21 | ```shell script
22 | make check-dist
23 | make test-pypi
24 | ```
25 |
26 | Activate virtual env (might need to `make venv-create`)
27 |
28 | ```shell script
29 | source many_requests-venv/bin/activate
30 | ```
31 |
32 | Test install (in virtual env):
33 |
34 | ```shell script
35 | pip install --upgrade --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple many_requests
36 | ```
37 |
38 | Then push to real PyPI:
39 |
40 | ```shell script
41 | rm -r dist
42 | make dist
43 | make pypi-upload
44 | ```
45 |
--------------------------------------------------------------------------------
/docs/.buildinfo:
--------------------------------------------------------------------------------
1 | # Sphinx build info version 1
2 | # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3 | config: c648d68578f7e65630e7bc2f8a4fd755
4 | tags: 645f666f9bcd5a90fca523b33c5a78b7
5 |
--------------------------------------------------------------------------------
/docs/.doctrees/api.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/.doctrees/api.doctree
--------------------------------------------------------------------------------
/docs/.doctrees/contributing.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/.doctrees/contributing.doctree
--------------------------------------------------------------------------------
/docs/.doctrees/environment.pickle:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/.doctrees/environment.pickle
--------------------------------------------------------------------------------
/docs/.doctrees/index.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/.doctrees/index.doctree
--------------------------------------------------------------------------------
/docs/.doctrees/welcome.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/.doctrees/welcome.doctree
--------------------------------------------------------------------------------
/docs/.nojekyll:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/.nojekyll
--------------------------------------------------------------------------------
/docs/_modules/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 | Overview: module code — many_requests v0.1.0 documentation
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
95 |
96 |
97 |
98 |
99 |
100 |
101 |
102 |
103 | many_requests
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
123 |
124 |
125 |
126 |
127 |
128 |
129 |
130 |
131 |
132 | »
133 |
134 | Overview: module code
135 |
136 |
137 |
138 |
139 |
140 |
141 |
142 |
143 |
144 |
145 |
146 |
147 |
148 |
149 |
All modules for which code is available
150 |
153 |
154 |
155 |
156 |
157 |
179 |
180 |
181 |
182 |
183 |
184 |
185 |
186 |
187 |
188 |
193 |
194 |
195 |
196 |
197 |
198 |
199 |
200 |
--------------------------------------------------------------------------------
/docs/_sources/api.rst.txt:
--------------------------------------------------------------------------------
1 | ============
2 | API
3 | ============
4 |
5 | :mod:`many_requests`
6 | ====================
7 |
8 | many_requests.many\_requests module
9 | -----------------------------------
10 |
11 | .. autoclass:: many_requests.many_requests_.ManyRequests
12 | :members:
13 | :special-members: __call__
14 |
15 | many_requests.easy\_async module
16 | --------------------------------
17 |
18 | .. autoclass:: many_requests.easy_async.EasyAsync
19 | :members:
20 | :special-members: __call__
21 |
22 | .. autofunction:: many_requests.easy_async.delayed
23 |
24 | .. autofunction:: many_requests.easy_async.zip_kw
25 |
26 |
--------------------------------------------------------------------------------
/docs/_sources/contributing.md.txt:
--------------------------------------------------------------------------------
1 | # Contributing
2 |
3 | Contributions are welcomed. Please fork and submit PR request. Code on [GitHub](https://github.com/joshlk/many_requests).
--------------------------------------------------------------------------------
/docs/_sources/index.rst.txt:
--------------------------------------------------------------------------------
1 | .. dataclassframe documentation master file, created by
2 | sphinx-quickstart on Tue Oct 27 09:45:39 2020.
3 | You can adapt this file completely to your liking, but it should at least
4 | contain the root `toctree` directive.
5 |
6 | .. toctree::
7 | :maxdepth: 2
8 | :caption: Contents:
9 |
10 | welcome
11 | api
12 | contributing
13 |
14 | Indices and tables
15 | ==================
16 |
17 | * :ref:`genindex`
18 | * :ref:`modindex`
19 | * :ref:`search`
20 |
--------------------------------------------------------------------------------
/docs/_sources/welcome.md.txt:
--------------------------------------------------------------------------------
1 | # Welcome to many-requests's documentation!
2 |
3 | Dead easy interface for executing many HTTP requests asynchronously.
4 | It has been tested in the wild with over 10 million requests.
5 | Automatically handles errors and executes retries.
6 |
7 | Built on-top of [Trio](https://github.com/python-trio/trio) and [asks](https://github.com/theelous3/asks).
8 |
9 | Also provides helper functions for executing [embarrassingly parallel](https://en.wikipedia.org/wiki/Embarrassingly_parallel) async coroutines.
10 |
11 | To install:
12 |
13 | ```bash
14 | pip install many-requests
15 | ```
16 |
17 | ## Example Usage
18 |
19 | Execute 10 GET requests for example.org:
20 |
21 | ```python
22 | from many_requests import ManyRequests
23 | responses = ManyRequests(n_workers=5, n_connections=5)(
24 | method='GET',
25 | url=['https://example.org' for i in range(10)])
26 | ```
27 |
28 | Query HackNews API for 10 items and parse JSON output:
29 |
30 | ```python
31 | responses = ManyRequests(n_workers=5, n_connections=5, json=True)(
32 | method='GET',
33 | url=[f'https://hacker-news.firebaseio.com/v0/item/{i}.json?print=pretty' for i in range(10)])
34 | ```
35 |
36 | To use basic authentication with all requests:
37 |
38 | ```python
39 | from asks import BasicAuth
40 | username = 'user'
41 | password = 'pw'
42 | responses = ManyRequests(n_workers=5, n_connections=5)(
43 | method='GET',
44 | url=['https://example.org' for i in range(10)],
45 | auth=BasicAuth((username, password)))
46 | ```
47 |
48 | To execute embarrassingly parallel async coroutines, for example 10 `trio.sleep` calls:
49 |
50 | ```python
51 | from many_requests import EasyAsync, delayed
52 | import trio
53 | outputs = EasyAsync(n_workers = 4)(delayed(trio.sleep)(i) for i in range(10))
54 | ```
55 |
--------------------------------------------------------------------------------
/docs/_static/basic.css:
--------------------------------------------------------------------------------
1 | /*
2 | * basic.css
3 | * ~~~~~~~~~
4 | *
5 | * Sphinx stylesheet -- basic theme.
6 | *
7 | * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
8 | * :license: BSD, see LICENSE for details.
9 | *
10 | */
11 |
12 | /* -- main layout ----------------------------------------------------------- */
13 |
14 | div.clearer {
15 | clear: both;
16 | }
17 |
18 | div.section::after {
19 | display: block;
20 | content: '';
21 | clear: left;
22 | }
23 |
24 | /* -- relbar ---------------------------------------------------------------- */
25 |
26 | div.related {
27 | width: 100%;
28 | font-size: 90%;
29 | }
30 |
31 | div.related h3 {
32 | display: none;
33 | }
34 |
35 | div.related ul {
36 | margin: 0;
37 | padding: 0 0 0 10px;
38 | list-style: none;
39 | }
40 |
41 | div.related li {
42 | display: inline;
43 | }
44 |
45 | div.related li.right {
46 | float: right;
47 | margin-right: 5px;
48 | }
49 |
50 | /* -- sidebar --------------------------------------------------------------- */
51 |
52 | div.sphinxsidebarwrapper {
53 | padding: 10px 5px 0 10px;
54 | }
55 |
56 | div.sphinxsidebar {
57 | float: left;
58 | width: 230px;
59 | margin-left: -100%;
60 | font-size: 90%;
61 | word-wrap: break-word;
62 | overflow-wrap : break-word;
63 | }
64 |
65 | div.sphinxsidebar ul {
66 | list-style: none;
67 | }
68 |
69 | div.sphinxsidebar ul ul,
70 | div.sphinxsidebar ul.want-points {
71 | margin-left: 20px;
72 | list-style: square;
73 | }
74 |
75 | div.sphinxsidebar ul ul {
76 | margin-top: 0;
77 | margin-bottom: 0;
78 | }
79 |
80 | div.sphinxsidebar form {
81 | margin-top: 10px;
82 | }
83 |
84 | div.sphinxsidebar input {
85 | border: 1px solid #98dbcc;
86 | font-family: sans-serif;
87 | font-size: 1em;
88 | }
89 |
90 | div.sphinxsidebar #searchbox form.search {
91 | overflow: hidden;
92 | }
93 |
94 | div.sphinxsidebar #searchbox input[type="text"] {
95 | float: left;
96 | width: 80%;
97 | padding: 0.25em;
98 | box-sizing: border-box;
99 | }
100 |
101 | div.sphinxsidebar #searchbox input[type="submit"] {
102 | float: left;
103 | width: 20%;
104 | border-left: none;
105 | padding: 0.25em;
106 | box-sizing: border-box;
107 | }
108 |
109 |
110 | img {
111 | border: 0;
112 | max-width: 100%;
113 | }
114 |
115 | /* -- search page ----------------------------------------------------------- */
116 |
117 | ul.search {
118 | margin: 10px 0 0 20px;
119 | padding: 0;
120 | }
121 |
122 | ul.search li {
123 | padding: 5px 0 5px 20px;
124 | background-image: url(file.png);
125 | background-repeat: no-repeat;
126 | background-position: 0 7px;
127 | }
128 |
129 | ul.search li a {
130 | font-weight: bold;
131 | }
132 |
133 | ul.search li div.context {
134 | color: #888;
135 | margin: 2px 0 0 30px;
136 | text-align: left;
137 | }
138 |
139 | ul.keywordmatches li.goodmatch a {
140 | font-weight: bold;
141 | }
142 |
143 | /* -- index page ------------------------------------------------------------ */
144 |
145 | table.contentstable {
146 | width: 90%;
147 | margin-left: auto;
148 | margin-right: auto;
149 | }
150 |
151 | table.contentstable p.biglink {
152 | line-height: 150%;
153 | }
154 |
155 | a.biglink {
156 | font-size: 1.3em;
157 | }
158 |
159 | span.linkdescr {
160 | font-style: italic;
161 | padding-top: 5px;
162 | font-size: 90%;
163 | }
164 |
165 | /* -- general index --------------------------------------------------------- */
166 |
167 | table.indextable {
168 | width: 100%;
169 | }
170 |
171 | table.indextable td {
172 | text-align: left;
173 | vertical-align: top;
174 | }
175 |
176 | table.indextable ul {
177 | margin-top: 0;
178 | margin-bottom: 0;
179 | list-style-type: none;
180 | }
181 |
182 | table.indextable > tbody > tr > td > ul {
183 | padding-left: 0em;
184 | }
185 |
186 | table.indextable tr.pcap {
187 | height: 10px;
188 | }
189 |
190 | table.indextable tr.cap {
191 | margin-top: 10px;
192 | background-color: #f2f2f2;
193 | }
194 |
195 | img.toggler {
196 | margin-right: 3px;
197 | margin-top: 3px;
198 | cursor: pointer;
199 | }
200 |
201 | div.modindex-jumpbox {
202 | border-top: 1px solid #ddd;
203 | border-bottom: 1px solid #ddd;
204 | margin: 1em 0 1em 0;
205 | padding: 0.4em;
206 | }
207 |
208 | div.genindex-jumpbox {
209 | border-top: 1px solid #ddd;
210 | border-bottom: 1px solid #ddd;
211 | margin: 1em 0 1em 0;
212 | padding: 0.4em;
213 | }
214 |
215 | /* -- domain module index --------------------------------------------------- */
216 |
217 | table.modindextable td {
218 | padding: 2px;
219 | border-collapse: collapse;
220 | }
221 |
222 | /* -- general body styles --------------------------------------------------- */
223 |
224 | div.body {
225 | min-width: 450px;
226 | max-width: 800px;
227 | }
228 |
229 | div.body p, div.body dd, div.body li, div.body blockquote {
230 | -moz-hyphens: auto;
231 | -ms-hyphens: auto;
232 | -webkit-hyphens: auto;
233 | hyphens: auto;
234 | }
235 |
236 | a.headerlink {
237 | visibility: hidden;
238 | }
239 |
240 | a.brackets:before,
241 | span.brackets > a:before{
242 | content: "[";
243 | }
244 |
245 | a.brackets:after,
246 | span.brackets > a:after {
247 | content: "]";
248 | }
249 |
250 | h1:hover > a.headerlink,
251 | h2:hover > a.headerlink,
252 | h3:hover > a.headerlink,
253 | h4:hover > a.headerlink,
254 | h5:hover > a.headerlink,
255 | h6:hover > a.headerlink,
256 | dt:hover > a.headerlink,
257 | caption:hover > a.headerlink,
258 | p.caption:hover > a.headerlink,
259 | div.code-block-caption:hover > a.headerlink {
260 | visibility: visible;
261 | }
262 |
263 | div.body p.caption {
264 | text-align: inherit;
265 | }
266 |
267 | div.body td {
268 | text-align: left;
269 | }
270 |
271 | .first {
272 | margin-top: 0 !important;
273 | }
274 |
275 | p.rubric {
276 | margin-top: 30px;
277 | font-weight: bold;
278 | }
279 |
280 | img.align-left, .figure.align-left, object.align-left {
281 | clear: left;
282 | float: left;
283 | margin-right: 1em;
284 | }
285 |
286 | img.align-right, .figure.align-right, object.align-right {
287 | clear: right;
288 | float: right;
289 | margin-left: 1em;
290 | }
291 |
292 | img.align-center, .figure.align-center, object.align-center {
293 | display: block;
294 | margin-left: auto;
295 | margin-right: auto;
296 | }
297 |
298 | img.align-default, .figure.align-default {
299 | display: block;
300 | margin-left: auto;
301 | margin-right: auto;
302 | }
303 |
304 | .align-left {
305 | text-align: left;
306 | }
307 |
308 | .align-center {
309 | text-align: center;
310 | }
311 |
312 | .align-default {
313 | text-align: center;
314 | }
315 |
316 | .align-right {
317 | text-align: right;
318 | }
319 |
320 | /* -- sidebars -------------------------------------------------------------- */
321 |
322 | div.sidebar {
323 | margin: 0 0 0.5em 1em;
324 | border: 1px solid #ddb;
325 | padding: 7px;
326 | background-color: #ffe;
327 | width: 40%;
328 | float: right;
329 | clear: right;
330 | overflow-x: auto;
331 | }
332 |
333 | p.sidebar-title {
334 | font-weight: bold;
335 | }
336 |
337 | div.admonition, div.topic, blockquote {
338 | clear: left;
339 | }
340 |
341 | /* -- topics ---------------------------------------------------------------- */
342 |
343 | div.topic {
344 | border: 1px solid #ccc;
345 | padding: 7px;
346 | margin: 10px 0 10px 0;
347 | }
348 |
349 | p.topic-title {
350 | font-size: 1.1em;
351 | font-weight: bold;
352 | margin-top: 10px;
353 | }
354 |
355 | /* -- admonitions ----------------------------------------------------------- */
356 |
357 | div.admonition {
358 | margin-top: 10px;
359 | margin-bottom: 10px;
360 | padding: 7px;
361 | }
362 |
363 | div.admonition dt {
364 | font-weight: bold;
365 | }
366 |
367 | p.admonition-title {
368 | margin: 0px 10px 5px 0px;
369 | font-weight: bold;
370 | }
371 |
372 | div.body p.centered {
373 | text-align: center;
374 | margin-top: 25px;
375 | }
376 |
377 | /* -- content of sidebars/topics/admonitions -------------------------------- */
378 |
379 | div.sidebar > :last-child,
380 | div.topic > :last-child,
381 | div.admonition > :last-child {
382 | margin-bottom: 0;
383 | }
384 |
385 | div.sidebar::after,
386 | div.topic::after,
387 | div.admonition::after,
388 | blockquote::after {
389 | display: block;
390 | content: '';
391 | clear: both;
392 | }
393 |
394 | /* -- tables ---------------------------------------------------------------- */
395 |
396 | table.docutils {
397 | margin-top: 10px;
398 | margin-bottom: 10px;
399 | border: 0;
400 | border-collapse: collapse;
401 | }
402 |
403 | table.align-center {
404 | margin-left: auto;
405 | margin-right: auto;
406 | }
407 |
408 | table.align-default {
409 | margin-left: auto;
410 | margin-right: auto;
411 | }
412 |
413 | table caption span.caption-number {
414 | font-style: italic;
415 | }
416 |
417 | table caption span.caption-text {
418 | }
419 |
420 | table.docutils td, table.docutils th {
421 | padding: 1px 8px 1px 5px;
422 | border-top: 0;
423 | border-left: 0;
424 | border-right: 0;
425 | border-bottom: 1px solid #aaa;
426 | }
427 |
428 | table.footnote td, table.footnote th {
429 | border: 0 !important;
430 | }
431 |
432 | th {
433 | text-align: left;
434 | padding-right: 5px;
435 | }
436 |
437 | table.citation {
438 | border-left: solid 1px gray;
439 | margin-left: 1px;
440 | }
441 |
442 | table.citation td {
443 | border-bottom: none;
444 | }
445 |
446 | th > :first-child,
447 | td > :first-child {
448 | margin-top: 0px;
449 | }
450 |
451 | th > :last-child,
452 | td > :last-child {
453 | margin-bottom: 0px;
454 | }
455 |
456 | /* -- figures --------------------------------------------------------------- */
457 |
458 | div.figure {
459 | margin: 0.5em;
460 | padding: 0.5em;
461 | }
462 |
463 | div.figure p.caption {
464 | padding: 0.3em;
465 | }
466 |
467 | div.figure p.caption span.caption-number {
468 | font-style: italic;
469 | }
470 |
471 | div.figure p.caption span.caption-text {
472 | }
473 |
474 | /* -- field list styles ----------------------------------------------------- */
475 |
476 | table.field-list td, table.field-list th {
477 | border: 0 !important;
478 | }
479 |
480 | .field-list ul {
481 | margin: 0;
482 | padding-left: 1em;
483 | }
484 |
485 | .field-list p {
486 | margin: 0;
487 | }
488 |
489 | .field-name {
490 | -moz-hyphens: manual;
491 | -ms-hyphens: manual;
492 | -webkit-hyphens: manual;
493 | hyphens: manual;
494 | }
495 |
496 | /* -- hlist styles ---------------------------------------------------------- */
497 |
498 | table.hlist {
499 | margin: 1em 0;
500 | }
501 |
502 | table.hlist td {
503 | vertical-align: top;
504 | }
505 |
506 |
507 | /* -- other body styles ----------------------------------------------------- */
508 |
509 | ol.arabic {
510 | list-style: decimal;
511 | }
512 |
513 | ol.loweralpha {
514 | list-style: lower-alpha;
515 | }
516 |
517 | ol.upperalpha {
518 | list-style: upper-alpha;
519 | }
520 |
521 | ol.lowerroman {
522 | list-style: lower-roman;
523 | }
524 |
525 | ol.upperroman {
526 | list-style: upper-roman;
527 | }
528 |
529 | :not(li) > ol > li:first-child > :first-child,
530 | :not(li) > ul > li:first-child > :first-child {
531 | margin-top: 0px;
532 | }
533 |
534 | :not(li) > ol > li:last-child > :last-child,
535 | :not(li) > ul > li:last-child > :last-child {
536 | margin-bottom: 0px;
537 | }
538 |
539 | ol.simple ol p,
540 | ol.simple ul p,
541 | ul.simple ol p,
542 | ul.simple ul p {
543 | margin-top: 0;
544 | }
545 |
546 | ol.simple > li:not(:first-child) > p,
547 | ul.simple > li:not(:first-child) > p {
548 | margin-top: 0;
549 | }
550 |
551 | ol.simple p,
552 | ul.simple p {
553 | margin-bottom: 0;
554 | }
555 |
556 | dl.footnote > dt,
557 | dl.citation > dt {
558 | float: left;
559 | margin-right: 0.5em;
560 | }
561 |
562 | dl.footnote > dd,
563 | dl.citation > dd {
564 | margin-bottom: 0em;
565 | }
566 |
567 | dl.footnote > dd:after,
568 | dl.citation > dd:after {
569 | content: "";
570 | clear: both;
571 | }
572 |
573 | dl.field-list {
574 | display: grid;
575 | grid-template-columns: fit-content(30%) auto;
576 | }
577 |
578 | dl.field-list > dt {
579 | font-weight: bold;
580 | word-break: break-word;
581 | padding-left: 0.5em;
582 | padding-right: 5px;
583 | }
584 |
585 | dl.field-list > dt:after {
586 | content: ":";
587 | }
588 |
589 | dl.field-list > dd {
590 | padding-left: 0.5em;
591 | margin-top: 0em;
592 | margin-left: 0em;
593 | margin-bottom: 0em;
594 | }
595 |
596 | dl {
597 | margin-bottom: 15px;
598 | }
599 |
600 | dd > :first-child {
601 | margin-top: 0px;
602 | }
603 |
604 | dd ul, dd table {
605 | margin-bottom: 10px;
606 | }
607 |
608 | dd {
609 | margin-top: 3px;
610 | margin-bottom: 10px;
611 | margin-left: 30px;
612 | }
613 |
614 | dl > dd:last-child,
615 | dl > dd:last-child > :last-child {
616 | margin-bottom: 0;
617 | }
618 |
619 | dt:target, span.highlighted {
620 | background-color: #fbe54e;
621 | }
622 |
623 | rect.highlighted {
624 | fill: #fbe54e;
625 | }
626 |
627 | dl.glossary dt {
628 | font-weight: bold;
629 | font-size: 1.1em;
630 | }
631 |
632 | .optional {
633 | font-size: 1.3em;
634 | }
635 |
636 | .sig-paren {
637 | font-size: larger;
638 | }
639 |
640 | .versionmodified {
641 | font-style: italic;
642 | }
643 |
644 | .system-message {
645 | background-color: #fda;
646 | padding: 5px;
647 | border: 3px solid red;
648 | }
649 |
650 | .footnote:target {
651 | background-color: #ffa;
652 | }
653 |
654 | .line-block {
655 | display: block;
656 | margin-top: 1em;
657 | margin-bottom: 1em;
658 | }
659 |
660 | .line-block .line-block {
661 | margin-top: 0;
662 | margin-bottom: 0;
663 | margin-left: 1.5em;
664 | }
665 |
666 | .guilabel, .menuselection {
667 | font-family: sans-serif;
668 | }
669 |
670 | .accelerator {
671 | text-decoration: underline;
672 | }
673 |
674 | .classifier {
675 | font-style: oblique;
676 | }
677 |
678 | .classifier:before {
679 | font-style: normal;
680 | margin: 0.5em;
681 | content: ":";
682 | }
683 |
684 | abbr, acronym {
685 | border-bottom: dotted 1px;
686 | cursor: help;
687 | }
688 |
689 | /* -- code displays --------------------------------------------------------- */
690 |
691 | pre {
692 | overflow: auto;
693 | overflow-y: hidden; /* fixes display issues on Chrome browsers */
694 | }
695 |
696 | pre, div[class*="highlight-"] {
697 | clear: both;
698 | }
699 |
700 | span.pre {
701 | -moz-hyphens: none;
702 | -ms-hyphens: none;
703 | -webkit-hyphens: none;
704 | hyphens: none;
705 | }
706 |
707 | div[class*="highlight-"] {
708 | margin: 1em 0;
709 | }
710 |
711 | td.linenos pre {
712 | border: 0;
713 | background-color: transparent;
714 | color: #aaa;
715 | }
716 |
717 | table.highlighttable {
718 | display: block;
719 | }
720 |
721 | table.highlighttable tbody {
722 | display: block;
723 | }
724 |
725 | table.highlighttable tr {
726 | display: flex;
727 | }
728 |
729 | table.highlighttable td {
730 | margin: 0;
731 | padding: 0;
732 | }
733 |
734 | table.highlighttable td.linenos {
735 | padding-right: 0.5em;
736 | }
737 |
738 | table.highlighttable td.code {
739 | flex: 1;
740 | overflow: hidden;
741 | }
742 |
743 | .highlight .hll {
744 | display: block;
745 | }
746 |
747 | div.highlight pre,
748 | table.highlighttable pre {
749 | margin: 0;
750 | }
751 |
752 | div.code-block-caption + div {
753 | margin-top: 0;
754 | }
755 |
756 | div.code-block-caption {
757 | margin-top: 1em;
758 | padding: 2px 5px;
759 | font-size: small;
760 | }
761 |
762 | div.code-block-caption code {
763 | background-color: transparent;
764 | }
765 |
766 | table.highlighttable td.linenos,
767 | div.doctest > div.highlight span.gp { /* gp: Generic.Prompt */
768 | user-select: none;
769 | }
770 |
771 | div.code-block-caption span.caption-number {
772 | padding: 0.1em 0.3em;
773 | font-style: italic;
774 | }
775 |
776 | div.code-block-caption span.caption-text {
777 | }
778 |
779 | div.literal-block-wrapper {
780 | margin: 1em 0;
781 | }
782 |
783 | code.descname {
784 | background-color: transparent;
785 | font-weight: bold;
786 | font-size: 1.2em;
787 | }
788 |
789 | code.descclassname {
790 | background-color: transparent;
791 | }
792 |
793 | code.xref, a code {
794 | background-color: transparent;
795 | font-weight: bold;
796 | }
797 |
798 | h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
799 | background-color: transparent;
800 | }
801 |
802 | .viewcode-link {
803 | float: right;
804 | }
805 |
806 | .viewcode-back {
807 | float: right;
808 | font-family: sans-serif;
809 | }
810 |
811 | div.viewcode-block:target {
812 | margin: -1px -10px;
813 | padding: 0 10px;
814 | }
815 |
816 | /* -- math display ---------------------------------------------------------- */
817 |
818 | img.math {
819 | vertical-align: middle;
820 | }
821 |
822 | div.body div.math p {
823 | text-align: center;
824 | }
825 |
826 | span.eqno {
827 | float: right;
828 | }
829 |
830 | span.eqno a.headerlink {
831 | position: absolute;
832 | z-index: 1;
833 | }
834 |
835 | div.math:hover a.headerlink {
836 | visibility: visible;
837 | }
838 |
839 | /* -- printout stylesheet --------------------------------------------------- */
840 |
841 | @media print {
842 | div.document,
843 | div.documentwrapper,
844 | div.bodywrapper {
845 | margin: 0 !important;
846 | width: 100%;
847 | }
848 |
849 | div.sphinxsidebar,
850 | div.related,
851 | div.footer,
852 | #top-link {
853 | display: none;
854 | }
855 | }
--------------------------------------------------------------------------------
/docs/_static/css/badge_only.css:
--------------------------------------------------------------------------------
1 | .fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}
--------------------------------------------------------------------------------
/docs/_static/css/fonts/Roboto-Slab-Bold.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/Roboto-Slab-Bold.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/Roboto-Slab-Bold.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/Roboto-Slab-Bold.woff2
--------------------------------------------------------------------------------
/docs/_static/css/fonts/Roboto-Slab-Regular.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/Roboto-Slab-Regular.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/Roboto-Slab-Regular.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/Roboto-Slab-Regular.woff2
--------------------------------------------------------------------------------
/docs/_static/css/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/fontawesome-webfont.eot
--------------------------------------------------------------------------------
/docs/_static/css/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/fontawesome-webfont.ttf
--------------------------------------------------------------------------------
/docs/_static/css/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/fontawesome-webfont.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/fontawesome-webfont.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/fontawesome-webfont.woff2
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-bold-italic.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-bold-italic.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-bold-italic.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-bold-italic.woff2
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-bold.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-bold.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-bold.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-bold.woff2
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-normal-italic.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-normal-italic.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-normal-italic.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-normal-italic.woff2
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-normal.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-normal.woff
--------------------------------------------------------------------------------
/docs/_static/css/fonts/lato-normal.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/css/fonts/lato-normal.woff2
--------------------------------------------------------------------------------
/docs/_static/doctools.js:
--------------------------------------------------------------------------------
1 | /*
2 | * doctools.js
3 | * ~~~~~~~~~~~
4 | *
5 | * Sphinx JavaScript utilities for all documentation.
6 | *
7 | * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
8 | * :license: BSD, see LICENSE for details.
9 | *
10 | */
11 |
12 | /**
13 | * select a different prefix for underscore
14 | */
15 | $u = _.noConflict();
16 |
17 | /**
18 | * make the code below compatible with browsers without
19 | * an installed firebug like debugger
20 | if (!window.console || !console.firebug) {
21 | var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
22 | "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
23 | "profile", "profileEnd"];
24 | window.console = {};
25 | for (var i = 0; i < names.length; ++i)
26 | window.console[names[i]] = function() {};
27 | }
28 | */
29 |
30 | /**
31 | * small helper function to urldecode strings
32 | */
33 | jQuery.urldecode = function(x) {
34 | return decodeURIComponent(x).replace(/\+/g, ' ');
35 | };
36 |
37 | /**
38 | * small helper function to urlencode strings
39 | */
40 | jQuery.urlencode = encodeURIComponent;
41 |
42 | /**
43 | * This function returns the parsed url parameters of the
44 | * current request. Multiple values per key are supported,
45 | * it will always return arrays of strings for the value parts.
46 | */
47 | jQuery.getQueryParameters = function(s) {
48 | if (typeof s === 'undefined')
49 | s = document.location.search;
50 | var parts = s.substr(s.indexOf('?') + 1).split('&');
51 | var result = {};
52 | for (var i = 0; i < parts.length; i++) {
53 | var tmp = parts[i].split('=', 2);
54 | var key = jQuery.urldecode(tmp[0]);
55 | var value = jQuery.urldecode(tmp[1]);
56 | if (key in result)
57 | result[key].push(value);
58 | else
59 | result[key] = [value];
60 | }
61 | return result;
62 | };
63 |
64 | /**
65 | * highlight a given string on a jquery object by wrapping it in
66 | * span elements with the given class name.
67 | */
68 | jQuery.fn.highlightText = function(text, className) {
69 | function highlight(node, addItems) {
70 | if (node.nodeType === 3) {
71 | var val = node.nodeValue;
72 | var pos = val.toLowerCase().indexOf(text);
73 | if (pos >= 0 &&
74 | !jQuery(node.parentNode).hasClass(className) &&
75 | !jQuery(node.parentNode).hasClass("nohighlight")) {
76 | var span;
77 | var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
78 | if (isInSVG) {
79 | span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
80 | } else {
81 | span = document.createElement("span");
82 | span.className = className;
83 | }
84 | span.appendChild(document.createTextNode(val.substr(pos, text.length)));
85 | node.parentNode.insertBefore(span, node.parentNode.insertBefore(
86 | document.createTextNode(val.substr(pos + text.length)),
87 | node.nextSibling));
88 | node.nodeValue = val.substr(0, pos);
89 | if (isInSVG) {
90 | var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
91 | var bbox = node.parentElement.getBBox();
92 | rect.x.baseVal.value = bbox.x;
93 | rect.y.baseVal.value = bbox.y;
94 | rect.width.baseVal.value = bbox.width;
95 | rect.height.baseVal.value = bbox.height;
96 | rect.setAttribute('class', className);
97 | addItems.push({
98 | "parent": node.parentNode,
99 | "target": rect});
100 | }
101 | }
102 | }
103 | else if (!jQuery(node).is("button, select, textarea")) {
104 | jQuery.each(node.childNodes, function() {
105 | highlight(this, addItems);
106 | });
107 | }
108 | }
109 | var addItems = [];
110 | var result = this.each(function() {
111 | highlight(this, addItems);
112 | });
113 | for (var i = 0; i < addItems.length; ++i) {
114 | jQuery(addItems[i].parent).before(addItems[i].target);
115 | }
116 | return result;
117 | };
118 |
119 | /*
120 | * backward compatibility for jQuery.browser
121 | * This will be supported until firefox bug is fixed.
122 | */
123 | if (!jQuery.browser) {
124 | jQuery.uaMatch = function(ua) {
125 | ua = ua.toLowerCase();
126 |
127 | var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
128 | /(webkit)[ \/]([\w.]+)/.exec(ua) ||
129 | /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
130 | /(msie) ([\w.]+)/.exec(ua) ||
131 | ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
132 | [];
133 |
134 | return {
135 | browser: match[ 1 ] || "",
136 | version: match[ 2 ] || "0"
137 | };
138 | };
139 | jQuery.browser = {};
140 | jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
141 | }
142 |
143 | /**
144 | * Small JavaScript module for the documentation.
145 | */
146 | var Documentation = {
147 |
148 | init : function() {
149 | this.fixFirefoxAnchorBug();
150 | this.highlightSearchWords();
151 | this.initIndexTable();
152 | if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) {
153 | this.initOnKeyListeners();
154 | }
155 | },
156 |
157 | /**
158 | * i18n support
159 | */
160 | TRANSLATIONS : {},
161 | PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; },
162 | LOCALE : 'unknown',
163 |
164 | // gettext and ngettext don't access this so that the functions
165 | // can safely bound to a different name (_ = Documentation.gettext)
166 | gettext : function(string) {
167 | var translated = Documentation.TRANSLATIONS[string];
168 | if (typeof translated === 'undefined')
169 | return string;
170 | return (typeof translated === 'string') ? translated : translated[0];
171 | },
172 |
173 | ngettext : function(singular, plural, n) {
174 | var translated = Documentation.TRANSLATIONS[singular];
175 | if (typeof translated === 'undefined')
176 | return (n == 1) ? singular : plural;
177 | return translated[Documentation.PLURALEXPR(n)];
178 | },
179 |
180 | addTranslations : function(catalog) {
181 | for (var key in catalog.messages)
182 | this.TRANSLATIONS[key] = catalog.messages[key];
183 | this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
184 | this.LOCALE = catalog.locale;
185 | },
186 |
187 | /**
188 | * add context elements like header anchor links
189 | */
190 | addContextElements : function() {
191 | $('div[id] > :header:first').each(function() {
192 | $('').
193 | attr('href', '#' + this.id).
194 | attr('title', _('Permalink to this headline')).
195 | appendTo(this);
196 | });
197 | $('dt[id]').each(function() {
198 | $('').
199 | attr('href', '#' + this.id).
200 | attr('title', _('Permalink to this definition')).
201 | appendTo(this);
202 | });
203 | },
204 |
205 | /**
206 | * workaround a firefox stupidity
207 | * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
208 | */
209 | fixFirefoxAnchorBug : function() {
210 | if (document.location.hash && $.browser.mozilla)
211 | window.setTimeout(function() {
212 | document.location.href += '';
213 | }, 10);
214 | },
215 |
216 | /**
217 | * highlight the search words provided in the url in the text
218 | */
219 | highlightSearchWords : function() {
220 | var params = $.getQueryParameters();
221 | var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
222 | if (terms.length) {
223 | var body = $('div.body');
224 | if (!body.length) {
225 | body = $('body');
226 | }
227 | window.setTimeout(function() {
228 | $.each(terms, function() {
229 | body.highlightText(this.toLowerCase(), 'highlighted');
230 | });
231 | }, 10);
232 | $('' + _('Hide Search Matches') + '
')
234 | .appendTo($('#searchbox'));
235 | }
236 | },
237 |
238 | /**
239 | * init the domain index toggle buttons
240 | */
241 | initIndexTable : function() {
242 | var togglers = $('img.toggler').click(function() {
243 | var src = $(this).attr('src');
244 | var idnum = $(this).attr('id').substr(7);
245 | $('tr.cg-' + idnum).toggle();
246 | if (src.substr(-9) === 'minus.png')
247 | $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
248 | else
249 | $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
250 | }).css('display', '');
251 | if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
252 | togglers.click();
253 | }
254 | },
255 |
256 | /**
257 | * helper function to hide the search marks again
258 | */
259 | hideSearchWords : function() {
260 | $('#searchbox .highlight-link').fadeOut(300);
261 | $('span.highlighted').removeClass('highlighted');
262 | },
263 |
264 | /**
265 | * make the url absolute
266 | */
267 | makeURL : function(relativeURL) {
268 | return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
269 | },
270 |
271 | /**
272 | * get the current relative url
273 | */
274 | getCurrentURL : function() {
275 | var path = document.location.pathname;
276 | var parts = path.split(/\//);
277 | $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
278 | if (this === '..')
279 | parts.pop();
280 | });
281 | var url = parts.join('/');
282 | return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
283 | },
284 |
285 | initOnKeyListeners: function() {
286 | $(document).keydown(function(event) {
287 | var activeElementType = document.activeElement.tagName;
288 | // don't navigate when in search box or textarea
289 | if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT'
290 | && !event.altKey && !event.ctrlKey && !event.metaKey && !event.shiftKey) {
291 | switch (event.keyCode) {
292 | case 37: // left
293 | var prevHref = $('link[rel="prev"]').prop('href');
294 | if (prevHref) {
295 | window.location.href = prevHref;
296 | return false;
297 | }
298 | case 39: // right
299 | var nextHref = $('link[rel="next"]').prop('href');
300 | if (nextHref) {
301 | window.location.href = nextHref;
302 | return false;
303 | }
304 | }
305 | }
306 | });
307 | }
308 | };
309 |
310 | // quick alias for translations
311 | _ = Documentation.gettext;
312 |
313 | $(document).ready(function() {
314 | Documentation.init();
315 | });
316 |
--------------------------------------------------------------------------------
/docs/_static/documentation_options.js:
--------------------------------------------------------------------------------
1 | var DOCUMENTATION_OPTIONS = {
2 | URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
3 | VERSION: 'v0.1.0',
4 | LANGUAGE: 'None',
5 | COLLAPSE_INDEX: false,
6 | BUILDER: 'html',
7 | FILE_SUFFIX: '.html',
8 | LINK_SUFFIX: '.html',
9 | HAS_SOURCE: true,
10 | SOURCELINK_SUFFIX: '.txt',
11 | NAVIGATION_WITH_KEYS: false
12 | };
--------------------------------------------------------------------------------
/docs/_static/file.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/file.png
--------------------------------------------------------------------------------
/docs/_static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/FontAwesome.otf
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bold.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bold.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bold.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bold.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bold.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bold.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bold.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bolditalic.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bolditalic.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bolditalic.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bolditalic.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bolditalic.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bolditalic.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-bolditalic.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-bolditalic.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-italic.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-italic.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-italic.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-italic.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-italic.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-italic.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-italic.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-italic.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-regular.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-regular.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-regular.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-regular.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-regular.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Lato/lato-regular.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Lato/lato-regular.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Bold.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Bold.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Bold.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Bold.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Light.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Light.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Light.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Light.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Regular.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Regular.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Regular.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Regular.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Thin.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Thin.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/Roboto-Slab-Thin.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/Roboto-Slab-Thin.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/fontawesome-webfont.eot
--------------------------------------------------------------------------------
/docs/_static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/fontawesome-webfont.ttf
--------------------------------------------------------------------------------
/docs/_static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/fontawesome-webfont.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/fontawesome-webfont.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/fontawesome-webfont.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-bold-italic.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-bold-italic.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-bold-italic.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-bold-italic.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-bold.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-bold.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-bold.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-bold.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-normal-italic.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-normal-italic.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-normal-italic.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-normal-italic.woff2
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-normal.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-normal.woff
--------------------------------------------------------------------------------
/docs/_static/fonts/lato-normal.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/fonts/lato-normal.woff2
--------------------------------------------------------------------------------
/docs/_static/js/badge_only.js:
--------------------------------------------------------------------------------
1 | !function(e){var t={};function r(n){if(t[n])return t[n].exports;var o=t[n]={i:n,l:!1,exports:{}};return e[n].call(o.exports,o,o.exports,r),o.l=!0,o.exports}r.m=e,r.c=t,r.d=function(e,t,n){r.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:n})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="",r(r.s=4)}({4:function(e,t,r){}});
--------------------------------------------------------------------------------
/docs/_static/js/html5shiv-printshiv.min.js:
--------------------------------------------------------------------------------
1 | /**
2 | * @preserve HTML5 Shiv 3.7.3-pre | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
3 | */
4 | !function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=y.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=y.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),y.elements=c+" "+a,j(b)}function f(a){var b=x[a[v]];return b||(b={},w++,a[v]=w,x[w]=b),b}function g(a,c,d){if(c||(c=b),q)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():u.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||t.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),q)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return y.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(y,b.frag)}function j(a){a||(a=b);var d=f(a);return!y.shivCSS||p||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),q||i(a,d),a}function k(a){for(var b,c=a.getElementsByTagName("*"),e=c.length,f=RegExp("^(?:"+d().join("|")+")$","i"),g=[];e--;)b=c[e],f.test(b.nodeName)&&g.push(b.applyElement(l(b)));return g}function l(a){for(var b,c=a.attributes,d=c.length,e=a.ownerDocument.createElement(A+":"+a.nodeName);d--;)b=c[d],b.specified&&e.setAttribute(b.nodeName,b.nodeValue);return e.style.cssText=a.style.cssText,e}function m(a){for(var b,c=a.split("{"),e=c.length,f=RegExp("(^|[\\s,>+~])("+d().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),g="$1"+A+"\\:$2";e--;)b=c[e]=c[e].split("}"),b[b.length-1]=b[b.length-1].replace(f,g),c[e]=b.join("}");return c.join("{")}function n(a){for(var b=a.length;b--;)a[b].removeNode()}function o(a){function b(){clearTimeout(g._removeSheetTimer),d&&d.removeNode(!0),d=null}var d,e,g=f(a),h=a.namespaces,i=a.parentWindow;return!B||a.printShived?a:("undefined"==typeof h[A]&&h.add(A),i.attachEvent("onbeforeprint",function(){b();for(var f,g,h,i=a.styleSheets,j=[],l=i.length,n=Array(l);l--;)n[l]=i[l];for(;h=n.pop();)if(!h.disabled&&z.test(h.media)){try{f=h.imports,g=f.length}catch(o){g=0}for(l=0;g>l;l++)n.push(f[l]);try{j.push(h.cssText)}catch(o){}}j=m(j.reverse().join("")),e=k(a),d=c(a,j)}),i.attachEvent("onafterprint",function(){n(e),clearTimeout(g._removeSheetTimer),g._removeSheetTimer=setTimeout(b,500)}),a.printShived=!0,a)}var p,q,r="3.7.3",s=a.html5||{},t=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,u=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,v="_html5shiv",w=0,x={};!function(){try{var a=b.createElement("a");a.innerHTML=" ",p="hidden"in a,q=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){p=!0,q=!0}}();var y={elements:s.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:r,shivCSS:s.shivCSS!==!1,supportsUnknownElements:q,shivMethods:s.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=y,j(b);var z=/^$|\b(?:all|print)\b/,A="html5shiv",B=!q&&function(){var c=b.documentElement;return!("undefined"==typeof b.namespaces||"undefined"==typeof b.parentWindow||"undefined"==typeof c.applyElement||"undefined"==typeof c.removeNode||"undefined"==typeof a.attachEvent)}();y.type+=" print",y.shivPrint=o,o(b),"object"==typeof module&&module.exports&&(module.exports=y)}("undefined"!=typeof window?window:this,document);
--------------------------------------------------------------------------------
/docs/_static/js/html5shiv.min.js:
--------------------------------------------------------------------------------
1 | /**
2 | * @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
3 | */
4 | !function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3-pre",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML=" ",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document);
--------------------------------------------------------------------------------
/docs/_static/js/modernizr.min.js:
--------------------------------------------------------------------------------
1 | /* Modernizr 2.6.2 (Custom Build) | MIT & BSD
2 | * Build: http://modernizr.com/download/#-fontface-backgroundsize-borderimage-borderradius-boxshadow-flexbox-hsla-multiplebgs-opacity-rgba-textshadow-cssanimations-csscolumns-generatedcontent-cssgradients-cssreflections-csstransforms-csstransforms3d-csstransitions-applicationcache-canvas-canvastext-draganddrop-hashchange-history-audio-video-indexeddb-input-inputtypes-localstorage-postmessage-sessionstorage-websockets-websqldatabase-webworkers-geolocation-inlinesvg-smil-svg-svgclippaths-touch-webgl-shiv-mq-cssclasses-addtest-prefixed-teststyles-testprop-testallprops-hasevent-prefixes-domprefixes-load
3 | */
4 | ;window.Modernizr=function(a,b,c){function D(a){j.cssText=a}function E(a,b){return D(n.join(a+";")+(b||""))}function F(a,b){return typeof a===b}function G(a,b){return!!~(""+a).indexOf(b)}function H(a,b){for(var d in a){var e=a[d];if(!G(e,"-")&&j[e]!==c)return b=="pfx"?e:!0}return!1}function I(a,b,d){for(var e in a){var f=b[a[e]];if(f!==c)return d===!1?a[e]:F(f,"function")?f.bind(d||b):f}return!1}function J(a,b,c){var d=a.charAt(0).toUpperCase()+a.slice(1),e=(a+" "+p.join(d+" ")+d).split(" ");return F(b,"string")||F(b,"undefined")?H(e,b):(e=(a+" "+q.join(d+" ")+d).split(" "),I(e,b,c))}function K(){e.input=function(c){for(var d=0,e=c.length;d',a,""].join(""),l.id=h,(m?l:n).innerHTML+=f,n.appendChild(l),m||(n.style.background="",n.style.overflow="hidden",k=g.style.overflow,g.style.overflow="hidden",g.appendChild(n)),i=c(l,a),m?l.parentNode.removeChild(l):(n.parentNode.removeChild(n),g.style.overflow=k),!!i},z=function(b){var c=a.matchMedia||a.msMatchMedia;if(c)return c(b).matches;var d;return y("@media "+b+" { #"+h+" { position: absolute; } }",function(b){d=(a.getComputedStyle?getComputedStyle(b,null):b.currentStyle)["position"]=="absolute"}),d},A=function(){function d(d,e){e=e||b.createElement(a[d]||"div"),d="on"+d;var f=d in e;return f||(e.setAttribute||(e=b.createElement("div")),e.setAttribute&&e.removeAttribute&&(e.setAttribute(d,""),f=F(e[d],"function"),F(e[d],"undefined")||(e[d]=c),e.removeAttribute(d))),e=null,f}var a={select:"input",change:"input",submit:"form",reset:"form",error:"img",load:"img",abort:"img"};return d}(),B={}.hasOwnProperty,C;!F(B,"undefined")&&!F(B.call,"undefined")?C=function(a,b){return B.call(a,b)}:C=function(a,b){return b in a&&F(a.constructor.prototype[b],"undefined")},Function.prototype.bind||(Function.prototype.bind=function(b){var c=this;if(typeof c!="function")throw new TypeError;var d=w.call(arguments,1),e=function(){if(this instanceof e){var a=function(){};a.prototype=c.prototype;var f=new a,g=c.apply(f,d.concat(w.call(arguments)));return Object(g)===g?g:f}return c.apply(b,d.concat(w.call(arguments)))};return e}),s.flexbox=function(){return J("flexWrap")},s.canvas=function(){var a=b.createElement("canvas");return!!a.getContext&&!!a.getContext("2d")},s.canvastext=function(){return!!e.canvas&&!!F(b.createElement("canvas").getContext("2d").fillText,"function")},s.webgl=function(){return!!a.WebGLRenderingContext},s.touch=function(){var c;return"ontouchstart"in a||a.DocumentTouch&&b instanceof DocumentTouch?c=!0:y(["@media (",n.join("touch-enabled),("),h,")","{#modernizr{top:9px;position:absolute}}"].join(""),function(a){c=a.offsetTop===9}),c},s.geolocation=function(){return"geolocation"in navigator},s.postmessage=function(){return!!a.postMessage},s.websqldatabase=function(){return!!a.openDatabase},s.indexedDB=function(){return!!J("indexedDB",a)},s.hashchange=function(){return A("hashchange",a)&&(b.documentMode===c||b.documentMode>7)},s.history=function(){return!!a.history&&!!history.pushState},s.draganddrop=function(){var a=b.createElement("div");return"draggable"in a||"ondragstart"in a&&"ondrop"in a},s.websockets=function(){return"WebSocket"in a||"MozWebSocket"in a},s.rgba=function(){return D("background-color:rgba(150,255,150,.5)"),G(j.backgroundColor,"rgba")},s.hsla=function(){return D("background-color:hsla(120,40%,100%,.5)"),G(j.backgroundColor,"rgba")||G(j.backgroundColor,"hsla")},s.multiplebgs=function(){return D("background:url(https://),url(https://),red url(https://)"),/(url\s*\(.*?){3}/.test(j.background)},s.backgroundsize=function(){return J("backgroundSize")},s.borderimage=function(){return J("borderImage")},s.borderradius=function(){return J("borderRadius")},s.boxshadow=function(){return J("boxShadow")},s.textshadow=function(){return b.createElement("div").style.textShadow===""},s.opacity=function(){return E("opacity:.55"),/^0.55$/.test(j.opacity)},s.cssanimations=function(){return J("animationName")},s.csscolumns=function(){return J("columnCount")},s.cssgradients=function(){var a="background-image:",b="gradient(linear,left top,right bottom,from(#9f9),to(white));",c="linear-gradient(left top,#9f9, white);";return D((a+"-webkit- ".split(" ").join(b+a)+n.join(c+a)).slice(0,-a.length)),G(j.backgroundImage,"gradient")},s.cssreflections=function(){return J("boxReflect")},s.csstransforms=function(){return!!J("transform")},s.csstransforms3d=function(){var a=!!J("perspective");return a&&"webkitPerspective"in g.style&&y("@media (transform-3d),(-webkit-transform-3d){#modernizr{left:9px;position:absolute;height:3px;}}",function(b,c){a=b.offsetLeft===9&&b.offsetHeight===3}),a},s.csstransitions=function(){return J("transition")},s.fontface=function(){var a;return y('@font-face {font-family:"font";src:url("https://")}',function(c,d){var e=b.getElementById("smodernizr"),f=e.sheet||e.styleSheet,g=f?f.cssRules&&f.cssRules[0]?f.cssRules[0].cssText:f.cssText||"":"";a=/src/i.test(g)&&g.indexOf(d.split(" ")[0])===0}),a},s.generatedcontent=function(){var a;return y(["#",h,"{font:0/0 a}#",h,':after{content:"',l,'";visibility:hidden;font:3px/1 a}'].join(""),function(b){a=b.offsetHeight>=3}),a},s.video=function(){var a=b.createElement("video"),c=!1;try{if(c=!!a.canPlayType)c=new Boolean(c),c.ogg=a.canPlayType('video/ogg; codecs="theora"').replace(/^no$/,""),c.h264=a.canPlayType('video/mp4; codecs="avc1.42E01E"').replace(/^no$/,""),c.webm=a.canPlayType('video/webm; codecs="vp8, vorbis"').replace(/^no$/,"")}catch(d){}return c},s.audio=function(){var a=b.createElement("audio"),c=!1;try{if(c=!!a.canPlayType)c=new Boolean(c),c.ogg=a.canPlayType('audio/ogg; codecs="vorbis"').replace(/^no$/,""),c.mp3=a.canPlayType("audio/mpeg;").replace(/^no$/,""),c.wav=a.canPlayType('audio/wav; codecs="1"').replace(/^no$/,""),c.m4a=(a.canPlayType("audio/x-m4a;")||a.canPlayType("audio/aac;")).replace(/^no$/,"")}catch(d){}return c},s.localstorage=function(){try{return localStorage.setItem(h,h),localStorage.removeItem(h),!0}catch(a){return!1}},s.sessionstorage=function(){try{return sessionStorage.setItem(h,h),sessionStorage.removeItem(h),!0}catch(a){return!1}},s.webworkers=function(){return!!a.Worker},s.applicationcache=function(){return!!a.applicationCache},s.svg=function(){return!!b.createElementNS&&!!b.createElementNS(r.svg,"svg").createSVGRect},s.inlinesvg=function(){var a=b.createElement("div");return a.innerHTML=" ",(a.firstChild&&a.firstChild.namespaceURI)==r.svg},s.smil=function(){return!!b.createElementNS&&/SVGAnimate/.test(m.call(b.createElementNS(r.svg,"animate")))},s.svgclippaths=function(){return!!b.createElementNS&&/SVGClipPath/.test(m.call(b.createElementNS(r.svg,"clipPath")))};for(var L in s)C(s,L)&&(x=L.toLowerCase(),e[x]=s[L](),v.push((e[x]?"":"no-")+x));return e.input||K(),e.addTest=function(a,b){if(typeof a=="object")for(var d in a)C(a,d)&&e.addTest(d,a[d]);else{a=a.toLowerCase();if(e[a]!==c)return e;b=typeof b=="function"?b():b,typeof f!="undefined"&&f&&(g.className+=" "+(b?"":"no-")+a),e[a]=b}return e},D(""),i=k=null,function(a,b){function k(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function l(){var a=r.elements;return typeof a=="string"?a.split(" "):a}function m(a){var b=i[a[g]];return b||(b={},h++,a[g]=h,i[h]=b),b}function n(a,c,f){c||(c=b);if(j)return c.createElement(a);f||(f=m(c));var g;return f.cache[a]?g=f.cache[a].cloneNode():e.test(a)?g=(f.cache[a]=f.createElem(a)).cloneNode():g=f.createElem(a),g.canHaveChildren&&!d.test(a)?f.frag.appendChild(g):g}function o(a,c){a||(a=b);if(j)return a.createDocumentFragment();c=c||m(a);var d=c.frag.cloneNode(),e=0,f=l(),g=f.length;for(;e",f="hidden"in a,j=a.childNodes.length==1||function(){b.createElement("a");var a=b.createDocumentFragment();return typeof a.cloneNode=="undefined"||typeof a.createDocumentFragment=="undefined"||typeof a.createElement=="undefined"}()}catch(c){f=!0,j=!0}})();var r={elements:c.elements||"abbr article aside audio bdi canvas data datalist details figcaption figure footer header hgroup mark meter nav output progress section summary time video",shivCSS:c.shivCSS!==!1,supportsUnknownElements:j,shivMethods:c.shivMethods!==!1,type:"default",shivDocument:q,createElement:n,createDocumentFragment:o};a.html5=r,q(b)}(this,b),e._version=d,e._prefixes=n,e._domPrefixes=q,e._cssomPrefixes=p,e.mq=z,e.hasEvent=A,e.testProp=function(a){return H([a])},e.testAllProps=J,e.testStyles=y,e.prefixed=function(a,b,c){return b?J(a,b,c):J(a,"pfx")},g.className=g.className.replace(/(^|\s)no-js(\s|$)/,"$1$2")+(f?" js "+v.join(" "):""),e}(this,this.document),function(a,b,c){function d(a){return"[object Function]"==o.call(a)}function e(a){return"string"==typeof a}function f(){}function g(a){return!a||"loaded"==a||"complete"==a||"uninitialized"==a}function h(){var a=p.shift();q=1,a?a.t?m(function(){("c"==a.t?B.injectCss:B.injectJs)(a.s,0,a.a,a.x,a.e,1)},0):(a(),h()):q=0}function i(a,c,d,e,f,i,j){function k(b){if(!o&&g(l.readyState)&&(u.r=o=1,!q&&h(),l.onload=l.onreadystatechange=null,b)){"img"!=a&&m(function(){t.removeChild(l)},50);for(var d in y[c])y[c].hasOwnProperty(d)&&y[c][d].onload()}}var j=j||B.errorTimeout,l=b.createElement(a),o=0,r=0,u={t:d,s:c,e:f,a:i,x:j};1===y[c]&&(r=1,y[c]=[]),"object"==a?l.data=c:(l.src=c,l.type=a),l.width=l.height="0",l.onerror=l.onload=l.onreadystatechange=function(){k.call(this,r)},p.splice(e,0,u),"img"!=a&&(r||2===y[c]?(t.insertBefore(l,s?null:n),m(k,j)):y[c].push(l))}function j(a,b,c,d,f){return q=0,b=b||"j",e(a)?i("c"==b?v:u,a,b,this.i++,c,d,f):(p.splice(this.i++,0,a),1==p.length&&h()),this}function k(){var a=B;return a.loader={load:j,i:0},a}var l=b.documentElement,m=a.setTimeout,n=b.getElementsByTagName("script")[0],o={}.toString,p=[],q=0,r="MozAppearance"in l.style,s=r&&!!b.createRange().compareNode,t=s?l:n.parentNode,l=a.opera&&"[object Opera]"==o.call(a.opera),l=!!b.attachEvent&&!l,u=r?"object":l?"script":"img",v=l?"script":u,w=Array.isArray||function(a){return"[object Array]"==o.call(a)},x=[],y={},z={timeout:function(a,b){return b.length&&(a.timeout=b[0]),a}},A,B;B=function(a){function b(a){var a=a.split("!"),b=x.length,c=a.pop(),d=a.length,c={url:c,origUrl:c,prefixes:a},e,f,g;for(f=0;f"),n("table.docutils.footnote").wrap(""),n("table.docutils.citation").wrap("
"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n(' '),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}t.length>0&&($(".wy-menu-vertical .current").removeClass("current"),t.addClass("current"),t.closest("li.toctree-l1").addClass("current"),t.closest("li.toctree-l1").parent().addClass("current"),t.closest("li.toctree-l1").addClass("current"),t.closest("li.toctree-l2").addClass("current"),t.closest("li.toctree-l3").addClass("current"),t.closest("li.toctree-l4").addClass("current"),t.closest("li.toctree-l5").addClass("current"),t[0].scrollIntoView())}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t0
62 | var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1
63 | var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1
64 | var s_v = "^(" + C + ")?" + v; // vowel in stem
65 |
66 | this.stemWord = function (w) {
67 | var stem;
68 | var suffix;
69 | var firstch;
70 | var origword = w;
71 |
72 | if (w.length < 3)
73 | return w;
74 |
75 | var re;
76 | var re2;
77 | var re3;
78 | var re4;
79 |
80 | firstch = w.substr(0,1);
81 | if (firstch == "y")
82 | w = firstch.toUpperCase() + w.substr(1);
83 |
84 | // Step 1a
85 | re = /^(.+?)(ss|i)es$/;
86 | re2 = /^(.+?)([^s])s$/;
87 |
88 | if (re.test(w))
89 | w = w.replace(re,"$1$2");
90 | else if (re2.test(w))
91 | w = w.replace(re2,"$1$2");
92 |
93 | // Step 1b
94 | re = /^(.+?)eed$/;
95 | re2 = /^(.+?)(ed|ing)$/;
96 | if (re.test(w)) {
97 | var fp = re.exec(w);
98 | re = new RegExp(mgr0);
99 | if (re.test(fp[1])) {
100 | re = /.$/;
101 | w = w.replace(re,"");
102 | }
103 | }
104 | else if (re2.test(w)) {
105 | var fp = re2.exec(w);
106 | stem = fp[1];
107 | re2 = new RegExp(s_v);
108 | if (re2.test(stem)) {
109 | w = stem;
110 | re2 = /(at|bl|iz)$/;
111 | re3 = new RegExp("([^aeiouylsz])\\1$");
112 | re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
113 | if (re2.test(w))
114 | w = w + "e";
115 | else if (re3.test(w)) {
116 | re = /.$/;
117 | w = w.replace(re,"");
118 | }
119 | else if (re4.test(w))
120 | w = w + "e";
121 | }
122 | }
123 |
124 | // Step 1c
125 | re = /^(.+?)y$/;
126 | if (re.test(w)) {
127 | var fp = re.exec(w);
128 | stem = fp[1];
129 | re = new RegExp(s_v);
130 | if (re.test(stem))
131 | w = stem + "i";
132 | }
133 |
134 | // Step 2
135 | re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
136 | if (re.test(w)) {
137 | var fp = re.exec(w);
138 | stem = fp[1];
139 | suffix = fp[2];
140 | re = new RegExp(mgr0);
141 | if (re.test(stem))
142 | w = stem + step2list[suffix];
143 | }
144 |
145 | // Step 3
146 | re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
147 | if (re.test(w)) {
148 | var fp = re.exec(w);
149 | stem = fp[1];
150 | suffix = fp[2];
151 | re = new RegExp(mgr0);
152 | if (re.test(stem))
153 | w = stem + step3list[suffix];
154 | }
155 |
156 | // Step 4
157 | re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
158 | re2 = /^(.+?)(s|t)(ion)$/;
159 | if (re.test(w)) {
160 | var fp = re.exec(w);
161 | stem = fp[1];
162 | re = new RegExp(mgr1);
163 | if (re.test(stem))
164 | w = stem;
165 | }
166 | else if (re2.test(w)) {
167 | var fp = re2.exec(w);
168 | stem = fp[1] + fp[2];
169 | re2 = new RegExp(mgr1);
170 | if (re2.test(stem))
171 | w = stem;
172 | }
173 |
174 | // Step 5
175 | re = /^(.+?)e$/;
176 | if (re.test(w)) {
177 | var fp = re.exec(w);
178 | stem = fp[1];
179 | re = new RegExp(mgr1);
180 | re2 = new RegExp(meq1);
181 | re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
182 | if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
183 | w = stem;
184 | }
185 | re = /ll$/;
186 | re2 = new RegExp(mgr1);
187 | if (re.test(w) && re2.test(w)) {
188 | re = /.$/;
189 | w = w.replace(re,"");
190 | }
191 |
192 | // and turn initial Y back to y
193 | if (firstch == "y")
194 | w = firstch.toLowerCase() + w.substr(1);
195 | return w;
196 | }
197 | }
198 |
199 |
200 |
201 |
202 |
203 | var splitChars = (function() {
204 | var result = {};
205 | var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648,
206 | 1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702,
207 | 2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971,
208 | 2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345,
209 | 3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761,
210 | 3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823,
211 | 4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125,
212 | 8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695,
213 | 11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587,
214 | 43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141];
215 | var i, j, start, end;
216 | for (i = 0; i < singles.length; i++) {
217 | result[singles[i]] = true;
218 | }
219 | var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709],
220 | [722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161],
221 | [1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568],
222 | [1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807],
223 | [1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047],
224 | [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383],
225 | [2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450],
226 | [2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547],
227 | [2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673],
228 | [2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820],
229 | [2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946],
230 | [2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023],
231 | [3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173],
232 | [3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332],
233 | [3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481],
234 | [3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718],
235 | [3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791],
236 | [3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095],
237 | [4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205],
238 | [4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687],
239 | [4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968],
240 | [4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869],
241 | [5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102],
242 | [6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271],
243 | [6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592],
244 | [6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822],
245 | [6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167],
246 | [7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959],
247 | [7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143],
248 | [8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318],
249 | [8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483],
250 | [8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101],
251 | [10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567],
252 | [11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292],
253 | [12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444],
254 | [12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783],
255 | [12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311],
256 | [19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511],
257 | [42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774],
258 | [42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071],
259 | [43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263],
260 | [43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519],
261 | [43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647],
262 | [43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967],
263 | [44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295],
264 | [57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274],
265 | [64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007],
266 | [65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381],
267 | [65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]];
268 | for (i = 0; i < ranges.length; i++) {
269 | start = ranges[i][0];
270 | end = ranges[i][1];
271 | for (j = start; j <= end; j++) {
272 | result[j] = true;
273 | }
274 | }
275 | return result;
276 | })();
277 |
278 | function splitQuery(query) {
279 | var result = [];
280 | var start = -1;
281 | for (var i = 0; i < query.length; i++) {
282 | if (splitChars[query.charCodeAt(i)]) {
283 | if (start !== -1) {
284 | result.push(query.slice(start, i));
285 | start = -1;
286 | }
287 | } else if (start === -1) {
288 | start = i;
289 | }
290 | }
291 | if (start !== -1) {
292 | result.push(query.slice(start));
293 | }
294 | return result;
295 | }
296 |
297 |
298 |
--------------------------------------------------------------------------------
/docs/_static/minus.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/minus.png
--------------------------------------------------------------------------------
/docs/_static/plus.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/_static/plus.png
--------------------------------------------------------------------------------
/docs/_static/pygments.css:
--------------------------------------------------------------------------------
1 | pre { line-height: 125%; }
2 | td.linenos pre { color: #000000; background-color: #f0f0f0; padding-left: 5px; padding-right: 5px; }
3 | span.linenos { color: #000000; background-color: #f0f0f0; padding-left: 5px; padding-right: 5px; }
4 | td.linenos pre.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
5 | span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
6 | .highlight .hll { background-color: #ffffcc }
7 | .highlight { background: #f8f8f8; }
8 | .highlight .c { color: #408080; font-style: italic } /* Comment */
9 | .highlight .err { border: 1px solid #FF0000 } /* Error */
10 | .highlight .k { color: #008000; font-weight: bold } /* Keyword */
11 | .highlight .o { color: #666666 } /* Operator */
12 | .highlight .ch { color: #408080; font-style: italic } /* Comment.Hashbang */
13 | .highlight .cm { color: #408080; font-style: italic } /* Comment.Multiline */
14 | .highlight .cp { color: #BC7A00 } /* Comment.Preproc */
15 | .highlight .cpf { color: #408080; font-style: italic } /* Comment.PreprocFile */
16 | .highlight .c1 { color: #408080; font-style: italic } /* Comment.Single */
17 | .highlight .cs { color: #408080; font-style: italic } /* Comment.Special */
18 | .highlight .gd { color: #A00000 } /* Generic.Deleted */
19 | .highlight .ge { font-style: italic } /* Generic.Emph */
20 | .highlight .gr { color: #FF0000 } /* Generic.Error */
21 | .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
22 | .highlight .gi { color: #00A000 } /* Generic.Inserted */
23 | .highlight .go { color: #888888 } /* Generic.Output */
24 | .highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */
25 | .highlight .gs { font-weight: bold } /* Generic.Strong */
26 | .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
27 | .highlight .gt { color: #0044DD } /* Generic.Traceback */
28 | .highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */
29 | .highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
30 | .highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
31 | .highlight .kp { color: #008000 } /* Keyword.Pseudo */
32 | .highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
33 | .highlight .kt { color: #B00040 } /* Keyword.Type */
34 | .highlight .m { color: #666666 } /* Literal.Number */
35 | .highlight .s { color: #BA2121 } /* Literal.String */
36 | .highlight .na { color: #7D9029 } /* Name.Attribute */
37 | .highlight .nb { color: #008000 } /* Name.Builtin */
38 | .highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */
39 | .highlight .no { color: #880000 } /* Name.Constant */
40 | .highlight .nd { color: #AA22FF } /* Name.Decorator */
41 | .highlight .ni { color: #999999; font-weight: bold } /* Name.Entity */
42 | .highlight .ne { color: #D2413A; font-weight: bold } /* Name.Exception */
43 | .highlight .nf { color: #0000FF } /* Name.Function */
44 | .highlight .nl { color: #A0A000 } /* Name.Label */
45 | .highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */
46 | .highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */
47 | .highlight .nv { color: #19177C } /* Name.Variable */
48 | .highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */
49 | .highlight .w { color: #bbbbbb } /* Text.Whitespace */
50 | .highlight .mb { color: #666666 } /* Literal.Number.Bin */
51 | .highlight .mf { color: #666666 } /* Literal.Number.Float */
52 | .highlight .mh { color: #666666 } /* Literal.Number.Hex */
53 | .highlight .mi { color: #666666 } /* Literal.Number.Integer */
54 | .highlight .mo { color: #666666 } /* Literal.Number.Oct */
55 | .highlight .sa { color: #BA2121 } /* Literal.String.Affix */
56 | .highlight .sb { color: #BA2121 } /* Literal.String.Backtick */
57 | .highlight .sc { color: #BA2121 } /* Literal.String.Char */
58 | .highlight .dl { color: #BA2121 } /* Literal.String.Delimiter */
59 | .highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
60 | .highlight .s2 { color: #BA2121 } /* Literal.String.Double */
61 | .highlight .se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */
62 | .highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */
63 | .highlight .si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */
64 | .highlight .sx { color: #008000 } /* Literal.String.Other */
65 | .highlight .sr { color: #BB6688 } /* Literal.String.Regex */
66 | .highlight .s1 { color: #BA2121 } /* Literal.String.Single */
67 | .highlight .ss { color: #19177C } /* Literal.String.Symbol */
68 | .highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */
69 | .highlight .fm { color: #0000FF } /* Name.Function.Magic */
70 | .highlight .vc { color: #19177C } /* Name.Variable.Class */
71 | .highlight .vg { color: #19177C } /* Name.Variable.Global */
72 | .highlight .vi { color: #19177C } /* Name.Variable.Instance */
73 | .highlight .vm { color: #19177C } /* Name.Variable.Magic */
74 | .highlight .il { color: #666666 } /* Literal.Number.Integer.Long */
--------------------------------------------------------------------------------
/docs/_static/searchtools.js:
--------------------------------------------------------------------------------
1 | /*
2 | * searchtools.js
3 | * ~~~~~~~~~~~~~~~~
4 | *
5 | * Sphinx JavaScript utilities for the full-text search.
6 | *
7 | * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
8 | * :license: BSD, see LICENSE for details.
9 | *
10 | */
11 |
12 | if (!Scorer) {
13 | /**
14 | * Simple result scoring code.
15 | */
16 | var Scorer = {
17 | // Implement the following function to further tweak the score for each result
18 | // The function takes a result array [filename, title, anchor, descr, score]
19 | // and returns the new score.
20 | /*
21 | score: function(result) {
22 | return result[4];
23 | },
24 | */
25 |
26 | // query matches the full name of an object
27 | objNameMatch: 11,
28 | // or matches in the last dotted part of the object name
29 | objPartialMatch: 6,
30 | // Additive scores depending on the priority of the object
31 | objPrio: {0: 15, // used to be importantResults
32 | 1: 5, // used to be objectResults
33 | 2: -5}, // used to be unimportantResults
34 | // Used when the priority is not in the mapping.
35 | objPrioDefault: 0,
36 |
37 | // query found in title
38 | title: 15,
39 | partialTitle: 7,
40 | // query found in terms
41 | term: 5,
42 | partialTerm: 2
43 | };
44 | }
45 |
46 | if (!splitQuery) {
47 | function splitQuery(query) {
48 | return query.split(/\s+/);
49 | }
50 | }
51 |
52 | /**
53 | * Search Module
54 | */
55 | var Search = {
56 |
57 | _index : null,
58 | _queued_query : null,
59 | _pulse_status : -1,
60 |
61 | htmlToText : function(htmlString) {
62 | var htmlElement = document.createElement('span');
63 | htmlElement.innerHTML = htmlString;
64 | $(htmlElement).find('.headerlink').remove();
65 | docContent = $(htmlElement).find('[role=main]')[0];
66 | if(docContent === undefined) {
67 | console.warn("Content block not found. Sphinx search tries to obtain it " +
68 | "via '[role=main]'. Could you check your theme or template.");
69 | return "";
70 | }
71 | return docContent.textContent || docContent.innerText;
72 | },
73 |
74 | init : function() {
75 | var params = $.getQueryParameters();
76 | if (params.q) {
77 | var query = params.q[0];
78 | $('input[name="q"]')[0].value = query;
79 | this.performSearch(query);
80 | }
81 | },
82 |
83 | loadIndex : function(url) {
84 | $.ajax({type: "GET", url: url, data: null,
85 | dataType: "script", cache: true,
86 | complete: function(jqxhr, textstatus) {
87 | if (textstatus != "success") {
88 | document.getElementById("searchindexloader").src = url;
89 | }
90 | }});
91 | },
92 |
93 | setIndex : function(index) {
94 | var q;
95 | this._index = index;
96 | if ((q = this._queued_query) !== null) {
97 | this._queued_query = null;
98 | Search.query(q);
99 | }
100 | },
101 |
102 | hasIndex : function() {
103 | return this._index !== null;
104 | },
105 |
106 | deferQuery : function(query) {
107 | this._queued_query = query;
108 | },
109 |
110 | stopPulse : function() {
111 | this._pulse_status = 0;
112 | },
113 |
114 | startPulse : function() {
115 | if (this._pulse_status >= 0)
116 | return;
117 | function pulse() {
118 | var i;
119 | Search._pulse_status = (Search._pulse_status + 1) % 4;
120 | var dotString = '';
121 | for (i = 0; i < Search._pulse_status; i++)
122 | dotString += '.';
123 | Search.dots.text(dotString);
124 | if (Search._pulse_status > -1)
125 | window.setTimeout(pulse, 500);
126 | }
127 | pulse();
128 | },
129 |
130 | /**
131 | * perform a search for something (or wait until index is loaded)
132 | */
133 | performSearch : function(query) {
134 | // create the required interface elements
135 | this.out = $('#search-results');
136 | this.title = $('' + _('Searching') + ' ').appendTo(this.out);
137 | this.dots = $(' ').appendTo(this.title);
138 | this.status = $('
').appendTo(this.out);
139 | this.output = $('').appendTo(this.out);
140 |
141 | $('#search-progress').text(_('Preparing search...'));
142 | this.startPulse();
143 |
144 | // index already loaded, the browser was quick!
145 | if (this.hasIndex())
146 | this.query(query);
147 | else
148 | this.deferQuery(query);
149 | },
150 |
151 | /**
152 | * execute search (requires search index to be loaded)
153 | */
154 | query : function(query) {
155 | var i;
156 |
157 | // stem the searchterms and add them to the correct list
158 | var stemmer = new Stemmer();
159 | var searchterms = [];
160 | var excluded = [];
161 | var hlterms = [];
162 | var tmp = splitQuery(query);
163 | var objectterms = [];
164 | for (i = 0; i < tmp.length; i++) {
165 | if (tmp[i] !== "") {
166 | objectterms.push(tmp[i].toLowerCase());
167 | }
168 |
169 | if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i] === "") {
170 | // skip this "word"
171 | continue;
172 | }
173 | // stem the word
174 | var word = stemmer.stemWord(tmp[i].toLowerCase());
175 | // prevent stemmer from cutting word smaller than two chars
176 | if(word.length < 3 && tmp[i].length >= 3) {
177 | word = tmp[i];
178 | }
179 | var toAppend;
180 | // select the correct list
181 | if (word[0] == '-') {
182 | toAppend = excluded;
183 | word = word.substr(1);
184 | }
185 | else {
186 | toAppend = searchterms;
187 | hlterms.push(tmp[i].toLowerCase());
188 | }
189 | // only add if not already in the list
190 | if (!$u.contains(toAppend, word))
191 | toAppend.push(word);
192 | }
193 | var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
194 |
195 | // console.debug('SEARCH: searching for:');
196 | // console.info('required: ', searchterms);
197 | // console.info('excluded: ', excluded);
198 |
199 | // prepare search
200 | var terms = this._index.terms;
201 | var titleterms = this._index.titleterms;
202 |
203 | // array of [filename, title, anchor, descr, score]
204 | var results = [];
205 | $('#search-progress').empty();
206 |
207 | // lookup as object
208 | for (i = 0; i < objectterms.length; i++) {
209 | var others = [].concat(objectterms.slice(0, i),
210 | objectterms.slice(i+1, objectterms.length));
211 | results = results.concat(this.performObjectSearch(objectterms[i], others));
212 | }
213 |
214 | // lookup as search terms in fulltext
215 | results = results.concat(this.performTermsSearch(searchterms, excluded, terms, titleterms));
216 |
217 | // let the scorer override scores with a custom scoring function
218 | if (Scorer.score) {
219 | for (i = 0; i < results.length; i++)
220 | results[i][4] = Scorer.score(results[i]);
221 | }
222 |
223 | // now sort the results by score (in opposite order of appearance, since the
224 | // display function below uses pop() to retrieve items) and then
225 | // alphabetically
226 | results.sort(function(a, b) {
227 | var left = a[4];
228 | var right = b[4];
229 | if (left > right) {
230 | return 1;
231 | } else if (left < right) {
232 | return -1;
233 | } else {
234 | // same score: sort alphabetically
235 | left = a[1].toLowerCase();
236 | right = b[1].toLowerCase();
237 | return (left > right) ? -1 : ((left < right) ? 1 : 0);
238 | }
239 | });
240 |
241 | // for debugging
242 | //Search.lastresults = results.slice(); // a copy
243 | //console.info('search results:', Search.lastresults);
244 |
245 | // print the results
246 | var resultCount = results.length;
247 | function displayNextItem() {
248 | // results left, load the summary and display it
249 | if (results.length) {
250 | var item = results.pop();
251 | var listItem = $(' ');
252 | var requestUrl = "";
253 | var linkUrl = "";
254 | if (DOCUMENTATION_OPTIONS.BUILDER === 'dirhtml') {
255 | // dirhtml builder
256 | var dirname = item[0] + '/';
257 | if (dirname.match(/\/index\/$/)) {
258 | dirname = dirname.substring(0, dirname.length-6);
259 | } else if (dirname == 'index/') {
260 | dirname = '';
261 | }
262 | requestUrl = DOCUMENTATION_OPTIONS.URL_ROOT + dirname;
263 | linkUrl = requestUrl;
264 |
265 | } else {
266 | // normal html builders
267 | requestUrl = DOCUMENTATION_OPTIONS.URL_ROOT + item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX;
268 | linkUrl = item[0] + DOCUMENTATION_OPTIONS.LINK_SUFFIX;
269 | }
270 | listItem.append($(' ').attr('href',
271 | linkUrl +
272 | highlightstring + item[2]).html(item[1]));
273 | if (item[3]) {
274 | listItem.append($(' (' + item[3] + ') '));
275 | Search.output.append(listItem);
276 | listItem.slideDown(5, function() {
277 | displayNextItem();
278 | });
279 | } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
280 | $.ajax({url: requestUrl,
281 | dataType: "text",
282 | complete: function(jqxhr, textstatus) {
283 | var data = jqxhr.responseText;
284 | if (data !== '' && data !== undefined) {
285 | listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));
286 | }
287 | Search.output.append(listItem);
288 | listItem.slideDown(5, function() {
289 | displayNextItem();
290 | });
291 | }});
292 | } else {
293 | // no source available, just display title
294 | Search.output.append(listItem);
295 | listItem.slideDown(5, function() {
296 | displayNextItem();
297 | });
298 | }
299 | }
300 | // search finished, update title and status message
301 | else {
302 | Search.stopPulse();
303 | Search.title.text(_('Search Results'));
304 | if (!resultCount)
305 | 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.'));
306 | else
307 | Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));
308 | Search.status.fadeIn(500);
309 | }
310 | }
311 | displayNextItem();
312 | },
313 |
314 | /**
315 | * search for object names
316 | */
317 | performObjectSearch : function(object, otherterms) {
318 | var filenames = this._index.filenames;
319 | var docnames = this._index.docnames;
320 | var objects = this._index.objects;
321 | var objnames = this._index.objnames;
322 | var titles = this._index.titles;
323 |
324 | var i;
325 | var results = [];
326 |
327 | for (var prefix in objects) {
328 | for (var name in objects[prefix]) {
329 | var fullname = (prefix ? prefix + '.' : '') + name;
330 | var fullnameLower = fullname.toLowerCase()
331 | if (fullnameLower.indexOf(object) > -1) {
332 | var score = 0;
333 | var parts = fullnameLower.split('.');
334 | // check for different match types: exact matches of full name or
335 | // "last name" (i.e. last dotted part)
336 | if (fullnameLower == object || parts[parts.length - 1] == object) {
337 | score += Scorer.objNameMatch;
338 | // matches in last name
339 | } else if (parts[parts.length - 1].indexOf(object) > -1) {
340 | score += Scorer.objPartialMatch;
341 | }
342 | var match = objects[prefix][name];
343 | var objname = objnames[match[1]][2];
344 | var title = titles[match[0]];
345 | // If more than one term searched for, we require other words to be
346 | // found in the name/title/description
347 | if (otherterms.length > 0) {
348 | var haystack = (prefix + ' ' + name + ' ' +
349 | objname + ' ' + title).toLowerCase();
350 | var allfound = true;
351 | for (i = 0; i < otherterms.length; i++) {
352 | if (haystack.indexOf(otherterms[i]) == -1) {
353 | allfound = false;
354 | break;
355 | }
356 | }
357 | if (!allfound) {
358 | continue;
359 | }
360 | }
361 | var descr = objname + _(', in ') + title;
362 |
363 | var anchor = match[3];
364 | if (anchor === '')
365 | anchor = fullname;
366 | else if (anchor == '-')
367 | anchor = objnames[match[1]][1] + '-' + fullname;
368 | // add custom score for some objects according to scorer
369 | if (Scorer.objPrio.hasOwnProperty(match[2])) {
370 | score += Scorer.objPrio[match[2]];
371 | } else {
372 | score += Scorer.objPrioDefault;
373 | }
374 | results.push([docnames[match[0]], fullname, '#'+anchor, descr, score, filenames[match[0]]]);
375 | }
376 | }
377 | }
378 |
379 | return results;
380 | },
381 |
382 | /**
383 | * search for full-text terms in the index
384 | */
385 | performTermsSearch : function(searchterms, excluded, terms, titleterms) {
386 | var docnames = this._index.docnames;
387 | var filenames = this._index.filenames;
388 | var titles = this._index.titles;
389 |
390 | var i, j, file;
391 | var fileMap = {};
392 | var scoreMap = {};
393 | var results = [];
394 |
395 | // perform the search on the required terms
396 | for (i = 0; i < searchterms.length; i++) {
397 | var word = searchterms[i];
398 | var files = [];
399 | var _o = [
400 | {files: terms[word], score: Scorer.term},
401 | {files: titleterms[word], score: Scorer.title}
402 | ];
403 | // add support for partial matches
404 | if (word.length > 2) {
405 | for (var w in terms) {
406 | if (w.match(word) && !terms[word]) {
407 | _o.push({files: terms[w], score: Scorer.partialTerm})
408 | }
409 | }
410 | for (var w in titleterms) {
411 | if (w.match(word) && !titleterms[word]) {
412 | _o.push({files: titleterms[w], score: Scorer.partialTitle})
413 | }
414 | }
415 | }
416 |
417 | // no match but word was a required one
418 | if ($u.every(_o, function(o){return o.files === undefined;})) {
419 | break;
420 | }
421 | // found search word in contents
422 | $u.each(_o, function(o) {
423 | var _files = o.files;
424 | if (_files === undefined)
425 | return
426 |
427 | if (_files.length === undefined)
428 | _files = [_files];
429 | files = files.concat(_files);
430 |
431 | // set score for the word in each file to Scorer.term
432 | for (j = 0; j < _files.length; j++) {
433 | file = _files[j];
434 | if (!(file in scoreMap))
435 | scoreMap[file] = {};
436 | scoreMap[file][word] = o.score;
437 | }
438 | });
439 |
440 | // create the mapping
441 | for (j = 0; j < files.length; j++) {
442 | file = files[j];
443 | if (file in fileMap && fileMap[file].indexOf(word) === -1)
444 | fileMap[file].push(word);
445 | else
446 | fileMap[file] = [word];
447 | }
448 | }
449 |
450 | // now check if the files don't contain excluded terms
451 | for (file in fileMap) {
452 | var valid = true;
453 |
454 | // check if all requirements are matched
455 | var filteredTermCount = // as search terms with length < 3 are discarded: ignore
456 | searchterms.filter(function(term){return term.length > 2}).length
457 | if (
458 | fileMap[file].length != searchterms.length &&
459 | fileMap[file].length != filteredTermCount
460 | ) continue;
461 |
462 | // ensure that none of the excluded terms is in the search result
463 | for (i = 0; i < excluded.length; i++) {
464 | if (terms[excluded[i]] == file ||
465 | titleterms[excluded[i]] == file ||
466 | $u.contains(terms[excluded[i]] || [], file) ||
467 | $u.contains(titleterms[excluded[i]] || [], file)) {
468 | valid = false;
469 | break;
470 | }
471 | }
472 |
473 | // if we have still a valid result we can add it to the result list
474 | if (valid) {
475 | // select one (max) score for the file.
476 | // for better ranking, we should calculate ranking by using words statistics like basic tf-idf...
477 | var score = $u.max($u.map(fileMap[file], function(w){return scoreMap[file][w]}));
478 | results.push([docnames[file], titles[file], '', null, score, filenames[file]]);
479 | }
480 | }
481 | return results;
482 | },
483 |
484 | /**
485 | * helper function to return a node containing the
486 | * search summary for a given text. keywords is a list
487 | * of stemmed words, hlwords is the list of normal, unstemmed
488 | * words. the first one is used to find the occurrence, the
489 | * latter for highlighting it.
490 | */
491 | makeSearchSummary : function(htmlText, keywords, hlwords) {
492 | var text = Search.htmlToText(htmlText);
493 | var textLower = text.toLowerCase();
494 | var start = 0;
495 | $.each(keywords, function() {
496 | var i = textLower.indexOf(this.toLowerCase());
497 | if (i > -1)
498 | start = i;
499 | });
500 | start = Math.max(start - 120, 0);
501 | var excerpt = ((start > 0) ? '...' : '') +
502 | $.trim(text.substr(start, 240)) +
503 | ((start + 240 - text.length) ? '...' : '');
504 | var rv = $('
').text(excerpt);
505 | $.each(hlwords, function() {
506 | rv = rv.highlightText(this, 'highlighted');
507 | });
508 | return rv;
509 | }
510 | };
511 |
512 | $(document).ready(function() {
513 | Search.init();
514 | });
515 |
--------------------------------------------------------------------------------
/docs/_static/underscore.js:
--------------------------------------------------------------------------------
1 | // Underscore.js 1.3.1
2 | // (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
3 | // Underscore is freely distributable under the MIT license.
4 | // Portions of Underscore are inspired or borrowed from Prototype,
5 | // Oliver Steele's Functional, and John Resig's Micro-Templating.
6 | // For all details and documentation:
7 | // http://documentcloud.github.com/underscore
8 | (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==
9 | 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,
10 | 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=
11 | 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;e2;a==
12 | 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=
13 | 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=
14 | 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=
15 | 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;bd?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,
17 | c,d){d||(d=b.identity);for(var e=0,f=a.length;e>1;d(a[g])=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=0;d--)b=[a[d].apply(this,b)];return b[0]}};
24 | 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,
25 | 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)};
26 | 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]"};
27 | 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 /g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin=function(a){j(b.functions(a),
28 | 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("+
29 | 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]=
30 | 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=
31 | true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);
32 |
--------------------------------------------------------------------------------
/docs/contributing.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 | Contributing — many_requests v0.1.0 documentation
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
96 |
97 |
98 |
99 |
100 |
101 |
102 |
103 |
104 | many_requests
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
123 |
124 |
125 |
126 |
127 |
128 |
129 |
130 |
131 |
132 |
133 | »
134 |
135 | Contributing
136 |
137 |
138 |
139 |
140 |
141 | View page source
142 |
143 |
144 |
145 |
146 |
147 |
148 |
149 |
150 |
151 |
152 |
153 |
154 |
155 |
Contributing
156 |
Contributions are welcomed. Please fork and submit PR request. Code on GitHub .
157 |
158 |
159 |
160 |
161 |
162 |
163 |
192 |
193 |
194 |
195 |
196 |
197 |
198 |
199 |
200 |
201 |
206 |
207 |
208 |
209 |
210 |
211 |
212 |
213 |
--------------------------------------------------------------------------------
/docs/genindex.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 | Index — many_requests v0.1.0 documentation
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
95 |
96 |
97 |
98 |
99 |
100 |
101 |
102 |
103 | many_requests
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
123 |
124 |
125 |
126 |
127 |
128 |
129 |
130 |
131 |
132 | »
133 |
134 | Index
135 |
136 |
137 |
138 |
139 |
140 |
141 |
142 |
143 |
144 |
145 |
146 |
147 |
148 |
149 |
150 |
151 |
152 |
Index
153 |
154 |
155 |
_
156 | |
D
157 | |
E
158 | |
M
159 | |
Z
160 |
161 |
162 |
_
163 |
181 |
182 |
D
183 |
189 |
190 |
E
191 |
197 |
198 |
M
199 |
205 |
206 |
Z
207 |
213 |
214 |
215 |
216 |
217 |
218 |
219 |
241 |
242 |
243 |
244 |
245 |
246 |
247 |
248 |
249 |
250 |
255 |
256 |
257 |
258 |
259 |
260 |
261 |
262 |
--------------------------------------------------------------------------------
/docs/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 | Indices and tables — many_requests v0.1.0 documentation
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
96 |
97 |
98 |
99 |
100 |
101 |
102 |
103 |
104 | many_requests
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
123 |
124 |
125 |
126 |
127 |
128 |
129 |
130 |
131 |
132 |
133 | »
134 |
135 | Indices and tables
136 |
137 |
138 |
139 |
140 |
141 | View page source
142 |
143 |
144 |
145 |
146 |
147 |
148 |
149 |
150 |
151 |
152 |
153 |
154 |
155 |
Contents:
156 |
167 |
168 |
169 |
Indices and tables
170 |
175 |
176 |
177 |
178 |
179 |
180 |
181 |
210 |
211 |
212 |
213 |
214 |
215 |
216 |
217 |
218 |
219 |
224 |
225 |
226 |
227 |
228 |
229 |
230 |
231 |
--------------------------------------------------------------------------------
/docs/objects.inv:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/docs/objects.inv
--------------------------------------------------------------------------------
/docs/search.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 | Search — many_requests v0.1.0 documentation
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
97 |
98 |
99 |
100 |
101 |
102 |
103 |
104 |
105 | many_requests
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
123 |
124 |
125 |
126 |
127 |
128 |
129 |
130 |
131 |
132 |
133 |
134 | »
135 |
136 | Search
137 |
138 |
139 |
140 |
141 |
142 |
143 |
144 |
145 |
146 |
147 |
148 |
149 |
150 |
151 |
152 |
153 |
154 |
155 |
156 | Please activate JavaScript to enable the search functionality.
157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
165 |
166 |
167 |
168 |
169 |
191 |
192 |
193 |
194 |
195 |
196 |
197 |
198 |
199 |
200 |
205 |
206 |
207 |
208 |
209 |
210 |
213 |
214 |
215 |
216 |
217 |
218 |
219 |
--------------------------------------------------------------------------------
/docs/searchindex.js:
--------------------------------------------------------------------------------
1 | Search.setIndex({docnames:["api","contributing","index","welcome"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.viewcode":1,sphinx:56},filenames:["api.rst","contributing.md","index.rst","welcome.md"],objects:{"many_requests.easy_async":{EasyAsync:[0,0,1,""],delayed:[0,2,1,""],zip_kw:[0,2,1,""]},"many_requests.easy_async.EasyAsync":{__call__:[0,1,1,""],__init__:[0,1,1,""]},"many_requests.many_requests_":{ManyRequests:[0,0,1,""]},"many_requests.many_requests_.ManyRequests":{__call__:[0,1,1,""],__init__:[0,1,1,""]}},objnames:{"0":["py","class","Python class"],"1":["py","method","Python method"],"2":["py","function","Python function"]},objtypes:{"0":"py:class","1":"py:method","2":"py:function"},terms:{"200":0,"256":0,"66k":0,"byte":[],"class":0,"default":0,"float":0,"function":[0,3],"import":[0,3],"int":0,"long":0,"new":3,"return":0,"true":[0,3],"try":0,For:0,The:0,These:0,Used:0,Will:0,__call__:0,__init__:0,abs_tol:0,accept:0,after:0,all:[0,3],also:[0,3],ani:0,api:[2,3],appli:0,args_:0,argument:0,ask:[0,3],assert:0,assum:0,async:[0,3],asynchron:[0,3],asyncronosli:0,attempt:0,attribut:0,auth:[0,3],authbas:0,authent:3,automat:[0,3],bad:0,badrespons:0,bar:0,basic:[0,3],basicauth:3,been:[0,3],befor:0,bodi:0,bool:0,built:3,calcul:0,call:3,callabl:0,can:0,captur:0,chang:0,child:0,code:[0,1],com:3,common:0,configur:0,connect:0,contain:0,content:2,contribut:2,cooki:0,cookiejar:[],coroutin:[0,3],correspond:0,could:[],custom:0,data:0,dead:[0,3],decor:0,def:0,delai:[0,3],delet:0,determin:0,dict:0,dictionari:0,differ:0,digest:0,dispatch:0,document:2,duplic:0,each:0,easi:[0,3],easyasync:[0,3],embarrassingli:3,enabl:0,error:[0,3],everi:0,exampl:[0,2],execut:[0,3],exhaust:0,fail:0,fals:0,few:0,file:[],firebaseio:3,fork:1,from:[0,3],full:0,func:0,func_:0,get:[0,3],github:1,given:0,good:0,hacker:3,hacknew:3,handl:[0,3],has:[0,3],have:0,head:0,header:0,helper:3,how:0,http:[0,3],includ:0,increas:0,index:2,input:0,instal:3,instead:0,interfac:[0,3],isclos:0,isclose_:0,item:[0,3],iter:0,its:0,json:[0,3],keyword:0,kwarg:0,kwargs_:0,last:0,lead:0,length:0,like:0,limit:0,list:0,lot:0,maco:0,mani:[0,2],many_request:[2,3],many_requests_:0,manyrequest:[0,3],match:0,math:0,max:0,memori:0,method:[0,3],million:3,mimic:0,modul:2,n_connect:[0,3],n_worker:[0,3],none:0,nth:0,number:0,object:0,obtain:0,ok_cod:0,ok_response_func:0,onc:0,open:0,option:0,order:0,org:[0,3],output:[0,3],over:3,page:2,pair:0,parallel:[0,3],param:0,paramet:0,paramt:0,pars:[0,3],password:3,patch:0,pip:3,pleas:1,posit:0,post:0,pretti:3,print:3,process:0,progress:0,provid:3,put:0,python:[],queri:[0,3],rang:[0,3],reason:0,repeat:0,request:[0,1,2],responc:0,respons:[0,3],response_object:0,retir:0,retri:[0,3],retry_sleep:0,same:0,search:2,second:0,send:0,sequenc:0,serializ:0,set:0,shortest:0,should:0,simpl:0,singl:0,sleep:[0,3],slower:0,sourc:0,specifi:0,startup:0,statu:0,stop:0,str:0,string:0,submit:1,task:0,test:3,thei:[],time:0,togeth:0,too:0,top:3,trio:[0,3],tupl:[],turn:0,type:0,ubuntu:0,union:0,url:[0,3],usag:2,use:[0,3],used:0,user:3,usernam:3,using:0,wait:0,welcom:[1,2],when:0,where:0,which:0,wild:3,worker:0,zip:0,zip_kw:0},titles:["API","Contributing","Indices and tables","Welcome to many-requests\u2019s documentation!"],titleterms:{api:0,contribut:1,document:3,easy_async:0,easy_request:[],easyget:[],exampl:3,indic:2,mani:3,many_request:0,modul:0,request:3,tabl:2,usag:3,welcom:3}})
--------------------------------------------------------------------------------
/docs/welcome.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 | Welcome to many-requests’s documentation! — many_requests v0.1.0 documentation
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 | many_requests
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
123 |
124 |
125 |
126 |
127 |
128 |
129 |
130 |
131 |
132 |
133 |
134 |
135 |
136 |
137 | »
138 |
139 | Welcome to many-requests’s documentation!
140 |
141 |
142 |
143 |
144 |
145 | View page source
146 |
147 |
148 |
149 |
150 |
151 |
152 |
153 |
154 |
155 |
156 |
157 |
158 |
159 |
Welcome to many-requests’s documentation!
160 |
Dead easy interface for executing many HTTP requests asynchronously.
161 | It has been tested in the wild with over 10 million requests.
162 | Automatically handles errors and executes retries.
163 |
Built on-top of Trio and asks .
164 |
Also provides helper functions for executing embarrassingly parallel async coroutines.
165 |
To install:
166 |
pip install many-requests
167 |
168 |
169 |
170 |
Example Usage
171 |
Execute 10 GET requests for example.org:
172 |
from many_requests import ManyRequests
173 | responses = ManyRequests ( n_workers = 5 , n_connections = 5 )(
174 | method = 'GET' ,
175 | url = [ 'https://example.org' for i in range ( 10 )])
176 |
177 |
178 |
Query HackNews API for 10 items and parse JSON output:
179 |
responses = ManyRequests ( n_workers = 5 , n_connections = 5 , json = True )(
180 | method = 'GET' ,
181 | url = [ f 'https://hacker-news.firebaseio.com/v0/item/ { i } .json?print=pretty' for i in range ( 10 )])
182 |
183 |
184 |
To use basic authentication with all requests:
185 |
from asks import BasicAuth
186 | username = 'user'
187 | password = 'pw'
188 | responses = ManyRequests ( n_workers = 5 , n_connections = 5 )(
189 | method = 'GET' ,
190 | url = [ 'https://example.org' for i in range ( 10 )],
191 | auth = BasicAuth (( username , password )))
192 |
193 |
194 |
To execute embarrassingly parallel async coroutines, for example 10 trio.sleep
calls:
195 |
from many_requests import EasyAsync , delayed
196 | import trio
197 | outputs = EasyAsync ( n_workers = 4 )( delayed ( trio . sleep )( i ) for i in range ( 10 ))
198 |
199 |
200 |
201 |
202 |
203 |
204 |
205 |
206 |
207 |
238 |
239 |
240 |
241 |
242 |
243 |
244 |
245 |
246 |
247 |
252 |
253 |
254 |
255 |
256 |
257 |
258 |
259 |
--------------------------------------------------------------------------------
/docs_source/api.rst:
--------------------------------------------------------------------------------
1 | ============
2 | API
3 | ============
4 |
5 | :mod:`many_requests`
6 | ====================
7 |
8 | many_requests.many\_requests module
9 | -----------------------------------
10 |
11 | .. autoclass:: many_requests.many_requests_.ManyRequests
12 | :members:
13 | :special-members: __call__
14 |
15 | many_requests.easy\_async module
16 | --------------------------------
17 |
18 | .. autoclass:: many_requests.easy_async.EasyAsync
19 | :members:
20 | :special-members: __call__
21 |
22 | .. autofunction:: many_requests.easy_async.delayed
23 |
24 | .. autofunction:: many_requests.easy_async.zip_kw
25 |
26 |
--------------------------------------------------------------------------------
/docs_source/conf.py:
--------------------------------------------------------------------------------
1 | # Configuration file for the Sphinx documentation builder.
2 | #
3 | # This file only contains a selection of the most common options. For a full
4 | # list see the documentation:
5 | # https://www.sphinx-doc.org/en/master/usage/configuration.html
6 |
7 | # -- Path setup --------------------------------------------------------------
8 |
9 | # If extensions (or modules to document with autodoc) are in another directory,
10 | # add these directories to sys.path here. If the directory is relative to the
11 | # documentation root, use os.path.abspath to make it absolute, like shown here.
12 | #
13 | import os
14 | import sys
15 | sys.path.insert(0, os.path.abspath('../'))
16 | import sphinx_rtd_theme
17 |
18 | # -- Project information -----------------------------------------------------
19 |
20 | project = 'many_requests'
21 | copyright = '2020, Josh Levy-Kramer. MIT license'
22 | author = 'Josh Levy-Kramer'
23 |
24 | # The full version, including alpha/beta/rc tags
25 | release = 'v0.1.0'
26 |
27 |
28 | # -- General configuration ---------------------------------------------------
29 |
30 | extensions = [
31 | 'sphinx.ext.autodoc',
32 | 'sphinx.ext.viewcode',
33 | 'recommonmark',
34 | "sphinx_rtd_theme",
35 | "sphinx.ext.napoleon"
36 | ]
37 |
38 | napoleon_google_docstring = True
39 | napoleon_use_param = False
40 | napoleon_use_ivar = True
41 | napoleon_include_init_with_doc = True
42 |
43 | autodoc_member_order = 'bysource'
44 |
45 | # Add any paths that contain templates here, relative to this directory.
46 | templates_path = ['_templates']
47 |
48 | # List of patterns, relative to source directory, that match files and
49 | # directories to ignore when looking for source files.
50 | # This pattern also affects html_static_path and html_extra_path.
51 | exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
52 |
53 | # Add markdown as a source suffix
54 | source_suffix = {
55 | '.rst': 'restructuredtext',
56 | '.txt': 'markdown',
57 | '.md': 'markdown',
58 | }
59 |
60 | # -- Options for HTML output -------------------------------------------------
61 |
62 | # The theme to use for HTML and HTML Help pages. See the documentation for
63 | # a list of builtin themes.
64 | #
65 | html_theme = 'sphinx_rtd_theme' #'alabaster'
66 |
67 | # Add any paths that contain custom static files (such as style sheets) here,
68 | # relative to this directory. They are copied after the builtin static files,
69 | # so a file named "default.css" will overwrite the builtin "default.css".
70 | html_static_path = ['_static']
--------------------------------------------------------------------------------
/docs_source/contributing.md:
--------------------------------------------------------------------------------
1 | # Contributing
2 |
3 | Contributions are welcomed. Please fork and submit PR request. Code on [GitHub](https://github.com/joshlk/many_requests).
--------------------------------------------------------------------------------
/docs_source/index.rst:
--------------------------------------------------------------------------------
1 | .. dataclassframe documentation master file, created by
2 | sphinx-quickstart on Tue Oct 27 09:45:39 2020.
3 | You can adapt this file completely to your liking, but it should at least
4 | contain the root `toctree` directive.
5 |
6 | .. toctree::
7 | :maxdepth: 2
8 | :caption: Contents:
9 |
10 | welcome
11 | api
12 | contributing
13 |
14 | Indices and tables
15 | ==================
16 |
17 | * :ref:`genindex`
18 | * :ref:`modindex`
19 | * :ref:`search`
20 |
--------------------------------------------------------------------------------
/docs_source/welcome.md:
--------------------------------------------------------------------------------
1 | # Welcome to many-requests's documentation!
2 |
3 | Dead easy interface for executing many HTTP requests asynchronously.
4 | It has been tested in the wild with over 10 million requests.
5 | Automatically handles errors and executes retries.
6 |
7 | Built on-top of [Trio](https://github.com/python-trio/trio) and [asks](https://github.com/theelous3/asks).
8 |
9 | Also provides helper functions for executing [embarrassingly parallel](https://en.wikipedia.org/wiki/Embarrassingly_parallel) async coroutines.
10 |
11 | To install:
12 |
13 | ```bash
14 | pip install many-requests
15 | ```
16 |
17 | ## Example Usage
18 |
19 | Execute 10 GET requests for example.org:
20 |
21 | ```python
22 | from many_requests import ManyRequests
23 | responses = ManyRequests(n_workers=5, n_connections=5)(
24 | method='GET',
25 | url=['https://example.org' for i in range(10)])
26 | ```
27 |
28 | Query HackNews API for 10 items and parse JSON output:
29 |
30 | ```python
31 | responses = ManyRequests(n_workers=5, n_connections=5, json=True)(
32 | method='GET',
33 | url=[f'https://hacker-news.firebaseio.com/v0/item/{i}.json?print=pretty' for i in range(10)])
34 | ```
35 |
36 | To use basic authentication with all requests:
37 |
38 | ```python
39 | from asks import BasicAuth
40 | username = 'user'
41 | password = 'pw'
42 | responses = ManyRequests(n_workers=5, n_connections=5)(
43 | method='GET',
44 | url=['https://example.org' for i in range(10)],
45 | auth=BasicAuth((username, password)))
46 | ```
47 |
48 | To execute embarrassingly parallel async coroutines, for example 10 `trio.sleep` calls:
49 |
50 | ```python
51 | from many_requests import EasyAsync, delayed
52 | import trio
53 | outputs = EasyAsync(n_workers = 4)(delayed(trio.sleep)(i) for i in range(10))
54 | ```
55 |
--------------------------------------------------------------------------------
/many_requests/__init__.py:
--------------------------------------------------------------------------------
1 | from .easy_async import EasyAsync, delayed, zip_kw
2 | from .many_requests_ import ManyRequests, BadResponse
3 |
--------------------------------------------------------------------------------
/many_requests/common.py:
--------------------------------------------------------------------------------
1 | from collections.abc import Iterable
2 |
3 | N_WORKERS_DEFAULT = 15
4 | N_CONNECTIONS_DEFAULT = 10
5 |
6 |
7 | class BadResponse(Exception):
8 | """BadResponse exception. Contains the `response`, `reason` and `attempt_num` as data if supplied."""
9 | def __init__(self, description, response=None, reason=None, attempt_num=None):
10 | self.description = description
11 | self.response = response
12 | self.reason = reason
13 | self.retry_num = attempt_num
14 |
15 | def __repr__(self):
16 | return f"BadResponse('{self.description}')"
17 |
18 |
19 | def is_collection(var):
20 | """Test if iterable but not a string"""
21 | return isinstance(var, Iterable) and not isinstance(var, str)
22 |
--------------------------------------------------------------------------------
/many_requests/easy_async.py:
--------------------------------------------------------------------------------
1 |
2 | from itertools import repeat, count
3 | from typing import Iterable, Optional, Any, Coroutine, Callable
4 |
5 | import trio
6 | from tqdm.auto import tqdm
7 |
8 | from many_requests.common import N_WORKERS_DEFAULT, is_collection
9 |
10 |
11 | def delayed(func: Callable[..., Coroutine]):
12 | """
13 | Decorator used to capture an async function with arguments and delay its execution.
14 |
15 | Examples:
16 | >>> import asks
17 | >>> func_, args_, kwargs_ = delayed(asks.request)('GET', url='https://example.org')
18 | >>> assert func_ == asks.request
19 | >>> assert args_ == ('GET',)
20 | >>> assert kwargs_ == {'url': 'https://example.org'}
21 | """
22 |
23 | def delayed_func(*args, **kwargs):
24 | return func, args, kwargs
25 |
26 | return delayed_func
27 |
28 |
29 | def zip_kw(**kwargs):
30 | """
31 | Return an iterator of N dictionaries, where the Nth item of each iterator specified in `kwargs` is paired together.
32 | Like `zip` but returns a dict instead.
33 | Also keyword arguments which are strings or not iterators are automatically repeated N times.
34 | `zip_kw` stops when the shortest iterator has been exhausted.
35 | """
36 |
37 | has_collection = False
38 | for k, v in kwargs.items():
39 | if not is_collection(v):
40 | kwargs[k] = repeat(v)
41 | else:
42 | has_collection = True
43 | kwargs[k] = iter(v)
44 |
45 | counter = count() if has_collection else range(1)
46 | try:
47 | for i in counter:
48 | dict_item = {k: next(v) for k, v in kwargs.items()}
49 | yield dict_item
50 | except StopIteration:
51 | pass
52 |
53 |
54 | class EasyAsync:
55 | def __init__(self, n_workers: int = N_WORKERS_DEFAULT):
56 | """
57 | Dead simple parallel execution of async coroutines.
58 | `n_workers` are dispatched which asynchronously process each task given.
59 |
60 | Args:
61 | n_workers: Number of workers to use
62 |
63 | Examples:
64 | Each of the 10 tasks sleeps for `i` seconds asyncronosly:
65 |
66 | >>> EasyAsync(n_workers = 4)(delayed(trio.sleep)(i) for i in range(10))
67 |
68 | Each task calculates `isclose` with a different `a` and `b` paramter. `abs_tol` is set to 4 for all tasks:
69 |
70 | >>> from math import isclose
71 | >>> async def isclose_(a, b, abs_tol): return isclose(a=a, b=b, abs_tol=abs_tol)
72 | >>> EasyAsync(n_workers = 4)(
73 | >>> delayed(isclose_)(**kwargs)
74 | >>> for kwargs in zip_kw(a=range(10), b=range(10)[::-1], abs_tol=4))
75 | """
76 |
77 | self.n_workers = n_workers
78 | self.progress_bar = None
79 |
80 | def __call__(self, tasks: Iterable[delayed], length: Optional[int] = None):
81 | """
82 | Execute given coroutine `tasks` using workers. The order of output will match the order of input.
83 |
84 | Args:
85 | tasks: A sequence of coroutines to execute
86 | length: The number of tasks. If not specified it will try obtain the length automatically.
87 | Used for progress bar
88 |
89 | Returns:
90 | A list of outputs from each task. The order of items is determined by the input.
91 | """
92 |
93 | if length is None:
94 | try:
95 | length = len(tasks)
96 | except TypeError:
97 | pass
98 |
99 | self.progress_bar = tqdm(total=length, smoothing=0)
100 |
101 | self.tasks = enumerate(iter(tasks)) # Force the sequence to be a iterator
102 | self.outputs = []
103 |
104 | trio.run(self._worker_nursery)
105 |
106 | # Order output and remove idx
107 | self.outputs = sorted(self.outputs, key=lambda e: e[0])
108 | self.outputs = [e[1] for e in self.outputs]
109 |
110 | return self.outputs
111 |
112 | async def _worker_nursery(self):
113 | """Start a trio nursery with n workers"""
114 | async with trio.open_nursery() as nursery:
115 | for i in range(self.n_workers):
116 | nursery.start_soon(self._worker)
117 |
118 | async def _worker(self):
119 | """Execute tasks until exhausted"""
120 | for idx, task in self.tasks:
121 | function, args, kwargs = task
122 | output = await function(*args, **kwargs)
123 | self.outputs.append((idx, output))
124 | self._progress_update(1)
125 |
126 | def _progress_update(self, n: int):
127 | """Increment progress bar"""
128 | if self.progress_bar is not None:
129 | self.progress_bar.update(n)
130 |
--------------------------------------------------------------------------------
/many_requests/many_requests_.py:
--------------------------------------------------------------------------------
1 |
2 | import logging
3 | from json import JSONDecodeError
4 | from ssl import SSLError
5 | from typing import List, Optional, Dict, Union, Iterable, Callable
6 | import asks
7 | import trio
8 | from asks import AuthBase
9 | from asks.errors import AsksException
10 | from asks.response_objects import Response
11 | from h11 import ProtocolError
12 |
13 | from .easy_async import EasyAsync, delayed, zip_kw
14 | from .common import BadResponse, N_WORKERS_DEFAULT, N_CONNECTIONS_DEFAULT, is_collection
15 |
16 |
17 | class ManyRequests:
18 | def __init__(
19 | self,
20 | n_workers: int = N_WORKERS_DEFAULT,
21 | n_connections: int = N_CONNECTIONS_DEFAULT,
22 | retries: int = 10,
23 | retry_sleep: float = 3,
24 | ok_codes: Iterable[int] = (200,),
25 | ok_response_func: Callable = None,
26 | json: bool = False,
27 | ):
28 | """
29 | Dead easy interface for executing many HTTP requests asynchronously.
30 |
31 | Args:
32 | n_workers: Max number of workers to use. Too many workers will use a lot of memory and increase startup
33 | time, too few can lead to slower execution.
34 | n_connections: Max number of open connections to have open at once. The number of connections is also
35 | limited by the OS. For example, by default MacOS has a limit of 256 and Ubuntu has ~66k. These limits
36 | can be changed with OS configuration.
37 | retries: Number of retries to attempt if a request fails
38 | retry_sleep: How long to wait in seconds before retrying a request
39 | ok_codes: A sequence of HTTP status codes to accept as ok. If `any`, all responses will be assumed to be ok
40 | ok_response_func: A function to apply to the response to determine if ok. Should return True/False.
41 | json: Parse response body as json and return instead of full Responce object
42 |
43 | Examples:
44 | Execute 10 GET requests to https://example.org
45 |
46 | >>> responses = ManyRequests(n_workers=5, n_connections=5)(
47 | >>> method='GET', url=[f'https://example.org' for i in range(10)])
48 | """
49 | self.n_workers = n_workers
50 | self.n_connections = n_connections
51 | self.session = None
52 | self.retries = retries
53 | self.retry_sleep = retry_sleep
54 | self.ok_codes = ok_codes
55 | self.ok_response_func = ok_response_func
56 | self.json = json
57 |
58 | self.requests = None
59 | self.responses = None
60 |
61 | def __call__(
62 | self,
63 | method: Union[str, List[str]],
64 | url: Union[str, List[str]],
65 | params: Union[None, str, Dict, List[str], List[Dict]] = None,
66 | data: Union[None, str, Dict, List[str], List[Dict]] = None,
67 | json: Union[None, Dict, List[Dict]] = None,
68 | headers: Union[None, Dict, List[Dict]] = None,
69 | cookies: Union[None, Dict, List[Dict]] = None,
70 | auth: Union[None, AuthBase, List[AuthBase]] = None,
71 | ) -> List[Union[Response, BadResponse]]:
72 | """
73 | Process asynchronously many requests, handling bad responses. Return the responses in the same order.
74 | If no ok response was obtained after retires a `BadResponse` will be included in the corresponding position of
75 | the output. A `BadResponse` will contain the last response and error reason.
76 |
77 | Arguments mimic `asks.request`_, which in turn mimics `requests.request`_.
78 |
79 | **Each argument can be a single item or a list of N items, where N is the number of requests.
80 | When the argument is a single item, that attribute is duplicated N times for every request.**
81 |
82 | Args:
83 | method: HTTP method type `GET`, `OPTIONS`, `HEAD`, `POST`, `PUT`, `PATCH`, or `DELETE`.
84 | url: URL of the Request
85 | params: Data to send in the query string of the Request. Dictionary or string.
86 | data: Data to send in the body of the Request. Dictionary or string.
87 | json: A JSON serializable dictionary to send as JSON in the body of the Request.
88 | headers: Dictionary of HTTP Headers to send with the Request
89 | cookies: Dictionary object to send with the Request
90 | auth: Enable Basic/Digest/Custom HTTP Auth. Should be a child of `asks.AuthBase`
91 |
92 | Returns:
93 | responses: A list of responses in the same order of the requests. Will include a `BadResponse` in the
94 | position of a request where no good response was obtained.
95 |
96 | .. _asks.request:
97 | https://asks.readthedocs.io/en/latest/overview-of-funcs-and-args.html
98 | .. _requests.request:
99 | https://2.python-requests.org/en/master/api/#requests.request
100 | """
101 |
102 | length = None
103 | for e in (method, url, params, data, json, headers, cookies, auth):
104 | if not is_collection(e):
105 | continue
106 | try:
107 | l = len(e)
108 | if length is None or l < length:
109 | length = l
110 | except TypeError:
111 | pass
112 |
113 | self.session = asks.Session(connections=self.n_connections)
114 | responses = EasyAsync(n_workers=self.n_workers)(
115 | tasks=(
116 | delayed(self._runner)(request_kwargs=kwargs)
117 | for kwargs in zip_kw(
118 | method=method,
119 | url=url,
120 | params=params,
121 | data=data,
122 | json=json,
123 | headers=headers,
124 | cookies=cookies,
125 | auth=auth,
126 | )
127 | ),
128 | length=length,
129 | )
130 |
131 | return responses
132 |
133 | async def _runner(self, request_kwargs):
134 | """Task which handles completing a HTTP request and errors that arise"""
135 |
136 | last_error = None
137 |
138 | for attempt_i in range(0, self.retries + 1):
139 | try:
140 | try:
141 | response = await self.session.request(**request_kwargs)
142 | except ProtocolError as e:
143 | name = type(e).__name__
144 | raise BadResponse(f'HTTPError:{name}', reason=name, attempt_num=attempt_i)
145 | except AsksException as e:
146 | name = type(e).__name__
147 | raise BadResponse(f'AsksException:{name}', reason=name, attempt_num=attempt_i)
148 | except SSLError as e:
149 | name = type(e).__name__
150 | raise BadResponse(f'SSLError:{name}', reason=name, attempt_num=attempt_i)
151 |
152 | if self.ok_codes != "any" and response.status_code not in self.ok_codes:
153 | raise BadResponse(f"Bad response status code: {response.status_code}. Should be in {self.ok_codes}",
154 | response=response, reason='bad_status_code', attempt_num=attempt_i)
155 |
156 | if self.ok_response_func is not None and not self.ok_response_func(response):
157 | raise BadResponse('Bad response determined by `ok_response_func`', response=response,
158 | reason='ok_response_func', attempt_num=attempt_i)
159 |
160 | if self.json:
161 | try:
162 | response = response.json()
163 | except JSONDecodeError as e:
164 | raise BadResponse('Cannot decode JSON', response=response, reason='JSONDecodeError',
165 | attempt_num=attempt_i)
166 |
167 | logging.debug(f"OK Response {request_kwargs}")
168 | return response
169 |
170 | except BadResponse as e:
171 | try:
172 | code, text = response.status_code, response.text
173 | except NameError:
174 | code, text = None, None
175 |
176 | request_kwargs_ = {k: v for k, v in request_kwargs.items() if v is not None}
177 | logging.info(
178 | f"Bad response {request_kwargs_}: Attempt {attempt_i}. Error {type(e).__name__}. Code: {code}. Body: {text}"
179 | )
180 |
181 | last_error = e
182 | await trio.sleep(self.retry_sleep)
183 |
184 | request_kwargs_ = {k: v for k, v in request_kwargs.items() if v is not None}
185 | logging.warning(
186 | f"FAILED Request {request_kwargs_}: Permanently failed. Last error: {last_error.description}"
187 | )
188 | return last_error
189 |
--------------------------------------------------------------------------------
/pytest.ini:
--------------------------------------------------------------------------------
1 | [pytest]
2 | testpaths =
3 | tests
4 | norecursedirs=dist build .tox scripts
5 | addopts =
6 | -r a
7 | -v
--------------------------------------------------------------------------------
/requirements.txt:
--------------------------------------------------------------------------------
1 | trio
2 | asks
3 | tqdm
4 |
--------------------------------------------------------------------------------
/requirements_dev.txt:
--------------------------------------------------------------------------------
1 | pytest
2 | wheel
3 | setuptools
4 | twine
5 | sphinx>=3.2.1
6 | codecov
7 | recommonmark
8 | sphinx-rtd-theme
9 | bump2version
10 | aiohttp
11 | requests
12 | aiohttp-basicauth-middleware
13 |
--------------------------------------------------------------------------------
/setup.cfg:
--------------------------------------------------------------------------------
1 | [metadata]
2 | name = many_requests
3 | version = 0.2.1
4 | description = Dead easy interface for executing many HTTP requests asynchronously. Also provides helper functions for executing embarrassingly parallel async coroutines.
5 | long_description = file: README.md
6 | long_description_content_type = text/markdown
7 | license = MIT License
8 | author = Josh Levy-Kramer
9 | url = https://github.com/joshlk/many_requests
10 | download_urls = https://pypi.org/project/many_requests
11 | project_urls =
12 | Documentation = https://joshlk.github.io/many_requests
13 | Code = https://github.com/joshlk/many_requests
14 | Issue tracker = https://github.com/joshlk/many_requests/issues
15 | classifiers =
16 | Development Status :: 5 - Production/Stable
17 | Intended Audience :: Developers
18 | Topic :: Internet :: WWW/HTTP
19 | License :: OSI Approved :: MIT License
20 | Programming Language :: Python :: 3
21 |
22 | [options]
23 | zip_safe = False
24 | python_requires = >=3.6
25 | packages = find:
26 |
--------------------------------------------------------------------------------
/setup.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python3
2 |
3 | from setuptools import setup
4 |
5 | with open("requirements.txt") as fp:
6 | install_requires = fp.read().strip().split("\n")
7 |
8 | with open("requirements_dev.txt") as fp:
9 | dev_requires = fp.read().strip().split("\n")
10 |
11 | setup(
12 | install_requires=install_requires,
13 | extras_require={
14 | "dev": dev_requires,
15 | "docs": ["sphinx", "sphinx-rtd-theme"]
16 | }
17 | )
18 |
--------------------------------------------------------------------------------
/tests/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/joshlk/many_requests/f80df66c8b5cd0f59b3ef31622a36e8ebd30094e/tests/__init__.py
--------------------------------------------------------------------------------
/tests/mock_server.py:
--------------------------------------------------------------------------------
1 | import asyncio
2 | import logging
3 | import multiprocessing
4 | import random
5 | from time import sleep
6 | import requests
7 |
8 | import pytest
9 | from aiohttp import web
10 | from aiohttp_basicauth_middleware import basic_auth_middleware
11 |
12 |
13 | @pytest.fixture(scope="module")
14 | def web_server():
15 | def mock_web_server():
16 | SLEEP_MEAN = 1
17 | async def sleep_rand():
18 | secs = random.expovariate(1/SLEEP_MEAN)
19 | if secs > 2*SLEEP_MEAN:
20 | logging.info(f"Sleeping request for {secs} seconds")
21 | await asyncio.sleep(secs)
22 |
23 | async def ok_handle(request):
24 | await sleep_rand()
25 | return web.Response(text='Ok response')
26 |
27 | async def var_handle(request):
28 | await sleep_rand()
29 | name = request.match_info.get('text', "Anonymous")
30 | text = "Hello, " + name
31 | return web.Response(text=text)
32 |
33 | async def json_handle(request):
34 | json = '{"foo": "bar"}'
35 | await sleep_rand()
36 | return web.Response(text=json)
37 |
38 | async def bad_request_handle(request):
39 | await sleep_rand()
40 | return web.HTTPBadRequest()
41 |
42 | async def mixed_response_handle(request):
43 | await sleep_rand()
44 | return random.choices(
45 | [web.Response(text='Ok response'), web.HTTPTooManyRequests()],
46 | weights=[0.6,0.4]
47 | )[0]
48 |
49 | asyncio.set_event_loop(asyncio.new_event_loop()) # Only use if in seperate thread or process
50 | app = web.Application()
51 | app.router.add_get('/', ok_handle)
52 | app.router.add_get('/ok', ok_handle)
53 | app.router.add_get('/var/{text}', var_handle)
54 | app.router.add_get('/json', json_handle)
55 | app.router.add_get('/bad_request', bad_request_handle)
56 | app.router.add_get('/mixed_response', mixed_response_handle)
57 |
58 | # Route with basic auth
59 | app.router.add_route('GET', '/basic_auth', ok_handle)
60 | app.middlewares.append(
61 | basic_auth_middleware(('/basic_auth',), {'username': 'password'})
62 | )
63 |
64 | web.run_app(app)
65 |
66 | logging.info('Start mock server')
67 | p = multiprocessing.Process(target=mock_web_server)
68 | p.start()
69 | while True: # Wait for server to start-up
70 | try:
71 | r = requests.get('http://0.0.0.0:8080/')
72 | except:
73 | sleep(0.1)
74 | continue
75 | if r.ok:
76 | break
77 | yield web
78 | logging.info('Teardown mock server')
79 | p.terminate()
80 |
--------------------------------------------------------------------------------
/tests/test_authentication.py:
--------------------------------------------------------------------------------
1 | from asks import BasicAuth
2 |
3 | from unittest import TestCase
4 | import pytest
5 | from asks.response_objects import Response
6 |
7 | from many_requests.many_requests_ import ManyRequests
8 | from many_requests.common import BadResponse
9 | from .mock_server import web_server
10 |
11 | @pytest.mark.usefixtures("web_server")
12 | class TestManyRequestAuth(TestCase):
13 |
14 | def test_basic_auth(self):
15 | auths = [
16 | BasicAuth(auth_info=(("username", "password"))), # ok
17 | BasicAuth(auth_info=(("username", "bad_password"))) # bad
18 | ]
19 | url = 'http://0.0.0.0:8080/basic_auth'
20 | responses = ManyRequests(10, 2, retries=2, retry_sleep=0)(method='GET', url=url, auth=auths)
21 | assert len(responses) == 2
22 |
23 | ok_res = responses[0]
24 | assert isinstance(ok_res, Response)
25 | assert ok_res.url == url
26 |
27 | bad_res = responses[1]
28 | assert isinstance(bad_res, BadResponse)
29 | assert bad_res.response.status_code == 401
30 | assert bad_res.response.url == url
31 |
32 |
33 |
--------------------------------------------------------------------------------
/tests/test_easy_async.py:
--------------------------------------------------------------------------------
1 | from math import isclose
2 | from unittest import TestCase
3 |
4 | import asks
5 | from trio import sleep
6 | from many_requests.easy_async import EasyAsync, delayed, zip_kw
7 |
8 |
9 | class TestEasyAsync(TestCase):
10 |
11 | def test_EasyAsync_sleep(self):
12 | n_workers = 3
13 | n_tasks = 10
14 | sleep_seconds = 1
15 | output = EasyAsync(n_workers)(delayed(sleep)(sleep_seconds) for i in range(n_tasks))
16 |
17 | assert len(output) == n_tasks
18 | assert output == [None] * len(output)
19 |
20 | def test_EasyAsync_isclose(self):
21 | async def isclose_(a, b, abs_tol):
22 | return isclose(a=a, b=b, abs_tol=abs_tol)
23 |
24 | output = EasyAsync(n_workers=4)(
25 | delayed(isclose_)(**kwargs) for kwargs in zip_kw(a=range(10), b=range(10)[::-1], abs_tol=4))
26 |
27 | assert output == [False, False, False, True, True, True, True, False, False, False]
28 |
29 | def test_AsyncParallel_ask_get(self):
30 | n_workers = 3
31 | n_tasks = 10
32 | EasyAsync(n_workers)(delayed(asks.get)(f'https://example.org/{i}') for i in range(n_tasks))
33 |
--------------------------------------------------------------------------------
/tests/test_many_requests.py:
--------------------------------------------------------------------------------
1 | from unittest import TestCase
2 | import pytest
3 | from asks.response_objects import Response
4 |
5 | from many_requests.many_requests_ import ManyRequests
6 | from many_requests.common import BadResponse
7 | from .mock_server import web_server
8 |
9 |
10 | @pytest.mark.usefixtures("web_server")
11 | class TestManyRequest(TestCase):
12 |
13 | def test_request(self):
14 | urls = [f'http://0.0.0.0:8080/' for i in range(10)]
15 | responses = ManyRequests(10, 2, retries=2, retry_sleep=0)(method='GET', url=urls)
16 | assert len(responses) == 10
17 | for response, url in zip(responses, urls):
18 | assert response.url == url
19 | assert isinstance(response, Response)
20 |
21 | def test_request_json(self):
22 | json = True
23 | urls = [f'http://0.0.0.0:8080/json' for i in range(10)]
24 | responses = ManyRequests(10, 2, retries=2, retry_sleep=0, json=json)(method='GET', url=urls)
25 | assert len(responses) == 10
26 | for response, url in zip(responses, urls):
27 | assert isinstance(response, dict)
28 | assert response == {"foo": "bar"}
29 |
30 | def test_json_failure(self):
31 | json = True
32 | urls = [f'http://0.0.0.0:8080/' for i in range(10)]
33 | responses = ManyRequests(10, 2, retries=2, retry_sleep=0, json=json)(method='GET', url=urls)
34 | assert len(responses) == 10
35 | for error, url in zip(responses, urls):
36 | assert isinstance(error, BadResponse)
37 | assert error.response.url == url
38 | assert error.reason == 'JSONDecodeError'
39 |
40 | def test_status_code_failure(self):
41 | urls = [f'https://example.org/bad_request' for i in range(10)]
42 | responses = ManyRequests(10, 2, retries=2, retry_sleep=0)(method='GET', url=urls)
43 | assert len(responses) == 10
44 | for error, url in zip(responses, urls):
45 | assert isinstance(error, BadResponse)
46 | assert error.response.url == url
47 | assert error.reason == 'bad_status_code'
48 |
49 | def test_single_request(self):
50 | json = False
51 | ok_code = (200,)
52 | responses = ManyRequests(10, 2, retries=2, retry_sleep=0, ok_codes=ok_code, json=json)(
53 | method='GET', url='https://example.org/')
54 | assert len(responses) == 1
55 | response = responses[0]
56 | assert response.url == 'https://example.org/'
57 | assert isinstance(response, Response)
58 |
59 |
--------------------------------------------------------------------------------
/tox.ini:
--------------------------------------------------------------------------------
1 | # Needed for setup.py to work correctly (no idea why)
2 | [tox]
3 | envlist = py{36,37,38}
4 |
5 | [testenv]
6 | basepython =
7 | py34: python3.6
8 | py35: python3.7
9 | py36: python3.8
10 | deps =
11 | check-manifest
12 | readme_renderer
13 | flake8
14 | pytest
15 | commands =
16 | check-manifest --ignore tox.ini,tests*
17 | python setup.py check -m -r -s
18 | flake8 .
19 | py.test tests
20 | [flake8]
21 | exclude = .tox,*.egg,build,data
22 | select = E,W,F
--------------------------------------------------------------------------------