This file is indexed.

/usr/share/doc/python-tenacity-doc/html/index.html is in python-tenacity-doc 4.8.0-0ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Tenacity &#8212; Tenacity  documentation</title>
    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true,
        SOURCELINK_SUFFIX: '.txt'
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
   
  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
  
  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />

  </head>
  <body>
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="tenacity">
<h1>Tenacity<a class="headerlink" href="#tenacity" title="Permalink to this headline"></a></h1>
<p>Tenacity is an Apache 2.0 licensed general-purpose retrying library, written in
Python, to simplify the task of adding retry behavior to just about anything.
It originates from <a class="reference external" href="https://github.com/rholder/retrying/issues/65">a fork of retrying</a>.</p>
<p>The simplest use case is retrying a flaky function whenever an <cite>Exception</cite>
occurs until a value is returned.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">random</span>
<span class="kn">from</span> <span class="nn">tenacity</span> <span class="k">import</span> <span class="n">retry</span>

<span class="nd">@retry</span>
<span class="k">def</span> <span class="nf">do_something_unreliable</span><span class="p">():</span>
    <span class="k">if</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">10</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
        <span class="k">raise</span> <span class="ne">IOError</span><span class="p">(</span><span class="s2">&quot;Broken sauce, everything is hosed!!!111one&quot;</span><span class="p">)</span>
    <span class="k">else</span><span class="p">:</span>
        <span class="k">return</span> <span class="s2">&quot;Awesome sauce!&quot;</span>

<span class="nb">print</span><span class="p">(</span><span class="n">do_something_unreliable</span><span class="p">())</span>
</pre></div>
</div>
<div class="section" id="features">
<h2>Features<a class="headerlink" href="#features" title="Permalink to this headline"></a></h2>
<ul class="simple">
<li>Generic Decorator API</li>
<li>Specify stop condition (i.e. limit by number of attempts)</li>
<li>Specify wait condition (i.e. exponential backoff sleeping between attempts)</li>
<li>Customize retrying on Exceptions</li>
<li>Customize retrying on expected returned result</li>
<li>Retry on coroutines</li>
</ul>
</div>
<div class="section" id="installation">
<h2>Installation<a class="headerlink" href="#installation" title="Permalink to this headline"></a></h2>
<p>To install <em>tenacity</em>, simply:</p>
<div class="highlight-bash"><div class="highlight"><pre><span></span>$ pip install tenacity
</pre></div>
</div>
</div>
<div class="section" id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<p>As you saw above, the default behavior is to retry forever without waiting when
an exception is raised.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span>
<span class="k">def</span> <span class="nf">never_give_up_never_surrender</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Retry forever ignoring Exceptions, don&#39;t wait between retries&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>Let’s be a little less persistent and set some boundaries, such as the number
of attempts before giving up.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">7</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">stop_after_7_attempts</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Stopping after 7 attempts&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>We don’t have all day, so let’s set a boundary for how long we should be
retrying stuff.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_delay</span><span class="p">(</span><span class="mi">10</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">stop_after_10_s</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Stopping after 10 seconds&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>You can combine several stop conditions by using the <cite>|</cite> operator:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="p">(</span><span class="n">stop_after_delay</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span> <span class="o">|</span> <span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">5</span><span class="p">)))</span>
<span class="k">def</span> <span class="nf">stop_after_10_s_or_5_retries</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Stopping after 10 seconds or 5 retries&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>Most things don’t like to be polled as fast as possible, so let’s just wait 2
seconds between retries.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait_fixed</span><span class="p">(</span><span class="mi">2</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">wait_2_s</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Wait 2 second between retries&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>Some things perform best with a bit of randomness injected.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait_random</span><span class="p">(</span><span class="nb">min</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="mi">2</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">wait_random_1_to_2_s</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Randomly wait 1 to 2 seconds between retries&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>Then again, it’s hard to beat exponential backoff when retrying distributed
services and other remote endpoints.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait_exponential</span><span class="p">(</span><span class="n">multiplier</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="mi">10</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">wait_exponential_1</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Wait 2^x * 1 second between each retry, up to 10 seconds, then 10 seconds afterwards&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>Then again, it’s also hard to beat combining fixed waits and jitter (to
help avoid thundering herds) when retrying distributed services and other
remote endpoints.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait_fixed</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="o">+</span> <span class="n">wait_random</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">2</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">wait_fixed_jitter</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Wait at least 3 seconds, and add up to 2 seconds of random delay&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>When multiple processes are in contention for a shared resource, exponentially
increasing jitter helps minimise collisions.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait_random_exponential</span><span class="p">(</span><span class="n">multiplier</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="mi">60</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">wait_exponential_jitter</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Randomly wait up to 2^x * 1 seconds between each retry until the range reaches 60 seconds, then randomly up to 60 seconds afterwards&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>Sometimes it’s necessary to build a chain of backoffs.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">wait</span><span class="o">=</span><span class="n">wait_chain</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">wait_fixed</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">3</span><span class="p">)]</span> <span class="o">+</span>
                       <span class="p">[</span><span class="n">wait_fixed</span><span class="p">(</span><span class="mi">7</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">)]</span> <span class="o">+</span>
                       <span class="p">[</span><span class="n">wait_fixed</span><span class="p">(</span><span class="mi">9</span><span class="p">)]))</span>
<span class="k">def</span> <span class="nf">wait_fixed_chained</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Wait 3s for 3 attempts, 7s for the next 2 attempts and 9s for all attempts thereafter&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>We have a few options for dealing with retries that raise specific or general
exceptions, as in the cases here.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">retry</span><span class="o">=</span><span class="n">retry_if_exception_type</span><span class="p">(</span><span class="ne">IOError</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">might_io_error</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Retry forever with no wait if an IOError occurs, raise any other errors&quot;</span><span class="p">)</span>
    <span class="k">raise</span> <span class="ne">Exception</span>
</pre></div>
</div>
<p>We can also use the result of the function to alter the behavior of retrying.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">is_none_p</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
    <span class="sd">&quot;&quot;&quot;Return True if value is None&quot;&quot;&quot;</span>
    <span class="k">return</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span>

<span class="nd">@retry</span><span class="p">(</span><span class="n">retry</span><span class="o">=</span><span class="n">retry_if_result</span><span class="p">(</span><span class="n">is_none_p</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">might_return_none</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Retry with no wait if return value is None&quot;</span><span class="p">)</span>
</pre></div>
</div>
<p>We can also combine several conditions:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">is_none_p</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
    <span class="sd">&quot;&quot;&quot;Return True if value is None&quot;&quot;&quot;</span>
    <span class="k">return</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span>

<span class="nd">@retry</span><span class="p">(</span><span class="n">retry</span><span class="o">=</span><span class="p">(</span><span class="n">retry_if_result</span><span class="p">(</span><span class="n">is_none_p</span><span class="p">)</span> <span class="o">|</span> <span class="n">retry_if_exception_type</span><span class="p">()))</span>
<span class="k">def</span> <span class="nf">might_return_none</span><span class="p">():</span>
    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Retry forever ignoring Exceptions with no wait if return value is None&quot;</span><span class="p">)</span>
</pre></div>
</div>
<p>Any combination of stop, wait, etc. is also supported to give you the freedom
to mix and match.</p>
<p>It’s also possible to retry explicitly at any time by raising the <cite>TryAgain</cite>
exception:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span>
<span class="k">def</span> <span class="nf">do_something</span><span class="p">():</span>
    <span class="n">result</span> <span class="o">=</span> <span class="n">something_else</span><span class="p">()</span>
    <span class="k">if</span> <span class="n">result</span> <span class="o">==</span> <span class="mi">23</span><span class="p">:</span>
       <span class="k">raise</span> <span class="n">TryAgain</span>
</pre></div>
</div>
<p>While callables that “timeout” retrying raise a <cite>RetryError</cite> by default,
we can reraise the last attempt’s exception if needed:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">reraise</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">3</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">raise_my_exception</span><span class="p">():</span>
    <span class="k">raise</span> <span class="n">MyException</span><span class="p">(</span><span class="s2">&quot;Fail&quot;</span><span class="p">)</span>

<span class="k">try</span><span class="p">:</span>
    <span class="n">raise_my_exception</span><span class="p">()</span>
<span class="k">except</span> <span class="n">MyException</span><span class="p">:</span>
    <span class="c1"># timed out retrying</span>
    <span class="k">pass</span>
</pre></div>
</div>
<p>It’s possible to execute an action before any attempt of calling the function
by using the before callback function:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="vm">__name__</span><span class="p">)</span>

<span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">3</span><span class="p">),</span> <span class="n">before</span><span class="o">=</span><span class="n">before_log</span><span class="p">(</span><span class="n">logger</span><span class="p">,</span> <span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">raise_my_exception</span><span class="p">():</span>
    <span class="k">raise</span> <span class="n">MyException</span><span class="p">(</span><span class="s2">&quot;Fail&quot;</span><span class="p">)</span>
</pre></div>
</div>
<p>In the same spirit, It’s possible to execute after a call that failed:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="vm">__name__</span><span class="p">)</span>

<span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">3</span><span class="p">),</span> <span class="n">after</span><span class="o">=</span><span class="n">after_log</span><span class="p">(</span><span class="n">logger</span><span class="p">,</span> <span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">raise_my_exception</span><span class="p">():</span>
    <span class="k">raise</span> <span class="n">MyException</span><span class="p">(</span><span class="s2">&quot;Fail&quot;</span><span class="p">)</span>
</pre></div>
</div>
<p>You can access the statistics about the retry made over a function by using the
<cite>retry</cite> attribute attached to the function and its <cite>statistics</cite> attribute:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">3</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">raise_my_exception</span><span class="p">():</span>
    <span class="k">raise</span> <span class="n">MyException</span><span class="p">(</span><span class="s2">&quot;Fail&quot;</span><span class="p">)</span>

<span class="k">try</span><span class="p">:</span>
    <span class="n">raise_my_exception</span><span class="p">()</span>
<span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
    <span class="k">pass</span>

<span class="nb">print</span><span class="p">(</span><span class="n">raise_my_exception</span><span class="o">.</span><span class="n">retry</span><span class="o">.</span><span class="n">statistics</span><span class="p">)</span>
</pre></div>
</div>
<p>You can change the arguments of a retry decorator as needed when calling it by
using the <cite>retry_with</cite> function attached to the wrapped function:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nd">@retry</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">3</span><span class="p">))</span>
<span class="k">def</span> <span class="nf">raise_my_exception</span><span class="p">():</span>
    <span class="k">raise</span> <span class="n">MyException</span><span class="p">(</span><span class="s2">&quot;Fail&quot;</span><span class="p">)</span>

<span class="k">try</span><span class="p">:</span>
    <span class="n">raise_my_exception</span><span class="o">.</span><span class="n">retry_with</span><span class="p">(</span><span class="n">stop</span><span class="o">=</span><span class="n">stop_after_attempt</span><span class="p">(</span><span class="mi">4</span><span class="p">))()</span>
<span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
    <span class="k">pass</span>

<span class="nb">print</span><span class="p">(</span><span class="n">raise_my_exception</span><span class="o">.</span><span class="n">retry</span><span class="o">.</span><span class="n">statistics</span><span class="p">)</span>
</pre></div>
</div>
<p>Finally, <code class="docutils literal"><span class="pre">retry</span></code> works also on asyncio and Tornado (&gt;= 4.5) coroutines.
Sleeps are done asynchronously too.</p>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="nd">@retry</span>
<span class="n">async</span> <span class="k">def</span> <span class="nf">my_async_function</span><span class="p">(</span><span class="n">loop</span><span class="p">):</span>
    <span class="n">await</span> <span class="n">loop</span><span class="o">.</span><span class="n">getaddrinfo</span><span class="p">(</span><span class="s1">&#39;8.8.8.8&#39;</span><span class="p">,</span> <span class="mi">53</span><span class="p">)</span>
</pre></div>
</div>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="nd">@retry</span>
<span class="nd">@tornado.gen.coroutine</span>
<span class="k">def</span> <span class="nf">my_async_function</span><span class="p">(</span><span class="n">http_client</span><span class="p">,</span> <span class="n">url</span><span class="p">):</span>
    <span class="k">yield</span> <span class="n">http_client</span><span class="o">.</span><span class="n">fetch</span><span class="p">(</span><span class="n">url</span><span class="p">)</span>
</pre></div>
</div>
</div>
<div class="section" id="contribute">
<h2>Contribute<a class="headerlink" href="#contribute" title="Permalink to this headline"></a></h2>
<ol class="arabic simple">
<li>Check for open issues or open a fresh issue to start a discussion around a
feature idea or a bug.</li>
<li>Fork <a class="reference external" href="https://github.com/jd/tenacity">the repository</a> on GitHub to start making your changes to the
<strong>master</strong> branch (or branch off of it).</li>
<li>Write a test which shows that the bug was fixed or that the feature works as
expected.</li>
<li>Make the docs better (or more detailed, or more easier to read, or …)</li>
</ol>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h3><a href="#">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Tenacity</a><ul>
<li><a class="reference internal" href="#features">Features</a></li>
<li><a class="reference internal" href="#installation">Installation</a></li>
<li><a class="reference internal" href="#examples">Examples</a></li>
<li><a class="reference internal" href="#contribute">Contribute</a></li>
</ul>
</li>
</ul>
<div class="relations">
<h3>Related Topics</h3>
<ul>
  <li><a href="#">Documentation overview</a><ul>
  </ul></li>
</ul>
</div>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/index.rst.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <div><input type="text" name="q" /></div>
      <div><input type="submit" value="Go" /></div>
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="footer">
      &copy;.
      
      |
      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.6.6</a>
      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a>
      
      |
      <a href="_sources/index.rst.txt"
          rel="nofollow">Page source</a>
    </div>

    

    
  </body>
</html>