<!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="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Gevent — PyMongo 3.7.2 documentation</title>
<link rel="stylesheet" href="../_static/pydoctheme.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/language_data.js"></script>
<script type="text/javascript" src="../_static/sidebar.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="GridFS Example" href="gridfs.html" />
<link rel="prev" title="Geospatial Indexing Example" href="geo.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="gridfs.html" title="GridFS Example"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="geo.html" title="Geospatial Indexing Example"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">PyMongo 3.7.2 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Examples</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="gevent">
<h1>Gevent<a class="headerlink" href="#gevent" title="Permalink to this headline">¶</a></h1>
<p>PyMongo supports <a class="reference external" href="http://www.gevent.org/">Gevent</a>. Simply call Gevent’s
<code class="docutils literal notranslate"><span class="pre">monkey.patch_all()</span></code> before loading any other modules:</p>
<div class="highlight-pycon notranslate"><div class="highlight"><pre><span></span><span class="gp">>>> </span><span class="c1"># You must call patch_all() *before* importing any other modules</span>
<span class="gp">>>> </span><span class="kn">from</span> <span class="nn">gevent</span> <span class="kn">import</span> <span class="n">monkey</span>
<span class="gp">>>> </span><span class="n">monkey</span><span class="o">.</span><span class="n">patch_all</span><span class="p">()</span>
<span class="gp">>>> </span><span class="kn">from</span> <span class="nn">pymongo</span> <span class="kn">import</span> <span class="n">MongoClient</span>
<span class="gp">>>> </span><span class="n">client</span> <span class="o">=</span> <span class="n">MongoClient</span><span class="p">()</span>
</pre></div>
</div>
<p>PyMongo uses thread and socket functions from the Python standard library.
Gevent’s monkey-patching replaces those standard functions so that PyMongo
does asynchronous I/O with non-blocking sockets, and schedules operations
on greenlets instead of threads.</p>
<div class="section" id="avoid-blocking-in-hub-join">
<h2>Avoid blocking in Hub.join<a class="headerlink" href="#avoid-blocking-in-hub-join" title="Permalink to this headline">¶</a></h2>
<p>By default, PyMongo uses threads to discover and monitor your servers’ topology
(see <a class="reference internal" href="high_availability.html#health-monitoring"><span class="std std-ref">Health Monitoring</span></a>). If you execute <code class="docutils literal notranslate"><span class="pre">monkey.patch_all()</span></code> when
your application first begins, PyMongo automatically uses greenlets instead
of threads.</p>
<p>When shutting down, if your application calls <code class="xref py py-meth docutils literal notranslate"><span class="pre">join()</span></code> on
Gevent’s <code class="xref py py-class docutils literal notranslate"><span class="pre">Hub</span></code> without first terminating these background
greenlets, the call to <code class="xref py py-meth docutils literal notranslate"><span class="pre">join()</span></code> blocks indefinitely. You
therefore <strong>must close or dereference</strong> any active
<a class="reference internal" href="../api/pymongo/mongo_client.html#pymongo.mongo_client.MongoClient" title="pymongo.mongo_client.MongoClient"><code class="xref py py-class docutils literal notranslate"><span class="pre">MongoClient</span></code></a> before exiting.</p>
<p>An example solution to this issue in some application frameworks is a signal
handler to end background greenlets when your application receives SIGHUP:</p>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">signal</span>
<span class="k">def</span> <span class="nf">graceful_reload</span><span class="p">(</span><span class="n">signum</span><span class="p">,</span> <span class="n">traceback</span><span class="p">):</span>
<span class="sd">"""Explicitly close some global MongoClient object."""</span>
<span class="n">client</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
<span class="n">signal</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="n">signal</span><span class="o">.</span><span class="n">SIGHUP</span><span class="p">,</span> <span class="n">graceful_reload</span><span class="p">)</span>
</pre></div>
</div>
<p>Applications using uWSGI prior to 1.9.16 are affected by this issue,
or newer uWSGI versions with the <code class="docutils literal notranslate"><span class="pre">-gevent-wait-for-hub</span></code> option.
See <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Changelog-1.9.16.html#important-change-in-the-gevent-plugin-shutdown-reload-procedure">the uWSGI changelog for details</a>.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Gevent</a><ul>
<li><a class="reference internal" href="#avoid-blocking-in-hub-join">Avoid blocking in Hub.join</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="geo.html"
title="previous chapter">Geospatial Indexing Example</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="gridfs.html"
title="next chapter">GridFS Example</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/examples/gevent.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="gridfs.html" title="GridFS Example"
>next</a> |</li>
<li class="right" >
<a href="geo.html" title="Geospatial Indexing Example"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">PyMongo 3.7.2 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >Examples</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright MongoDB, Inc. 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
9955584118b2135ac21554fe39454ae6
>
files
>
331
