122 lines
6.4 KiB
HTML
122 lines
6.4 KiB
HTML
<!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>Eventlet Networking Library</title>
|
|
<link rel="stylesheet" href="doc/_static/default.css" type="text/css" />
|
|
<link rel="stylesheet" href="doc/_static/pygments.css" type="text/css" />
|
|
<link rel="top" title="Eventlet Networking Library" href="" />
|
|
</head>
|
|
<body>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body">
|
|
|
|
<div class="section" id="eventlet">
|
|
<h1>Eventlet</h1>
|
|
|
|
<p>Eventlet is a concurrent networking library for Python that allows you to change how you run your code, not how you write it.</p>
|
|
|
|
<ul>
|
|
<li>It uses epoll or libevent for <a class="reference external" href="http://en.wikipedia.org/wiki/Asynchronous_I/O#Select.28.2Fpoll.29_loops">highly scalable non-blocking I/O</a>.</li>
|
|
<li><a class="reference external" href="http://en.wikipedia.org/wiki/Coroutine">Coroutines</a> ensure that the developer uses a blocking style of programming that is similar to threading, but provide the benefits of non-blocking I/O.</li>
|
|
<li>The event dispatch is implicit, which means you can easily use Eventlet from the Python interpreter, or as a small part of a larger application.</li>
|
|
</ul>
|
|
|
|
<p>It's easy to get started using Eventlet, and easy to convert existing applications to use it. Start off by looking at <a href="doc/examples.html">examples</a>, <a href="doc/design_patterns.html">common design patterns</a>, and the list of the <a href="doc/basic_usage.html">basic API primitives</a>.</p>
|
|
|
|
<h3><a href="doc/">API Documentation</a></h3>
|
|
|
|
<h3>Installation</h3>
|
|
|
|
<p>To install eventlet, simply:
|
|
<pre>
|
|
easy_install eventlet
|
|
</pre></p>
|
|
|
|
<p>Alternately, you can download the source tarball from <a href="http://pypi.python.org/pypi/eventlet/">PyPi</a>:
|
|
<ul>
|
|
<li><a href="http://pypi.python.org/packages/source/e/eventlet/eventlet-0.9.17.tar.gz">eventlet-0.9.17.tar.gz</a></li>
|
|
</ul>
|
|
</p>
|
|
|
|
<h3>Discussion</h3>
|
|
|
|
<p><a href="https://lists.secondlife.com/cgi-bin/mailman/listinfo/eventletdev">eventletdev at lists.secondlife.com</a></p>
|
|
|
|
<p>This is a relatively low-traffic list about using and developing eventlet. Look through the <a href="https://lists.secondlife.com/pipermail/eventletdev/">archives</a> for some useful information and possible answers to questions.</p>
|
|
|
|
<p>There's an IRC channel dedicated to eventlet: <a href="irc://kubrick.freenode.net/#eventlet">#eventlet on freenode</a>. It's a pretty chill place to hang out!</p>
|
|
|
|
<h3>Development</h3>
|
|
|
|
<p><a href="http://bitbucket.org/which_linden/eventlet/">trunk repository</a></p>
|
|
|
|
<p>We use Mercurial for our source control, hosted by BitBucket. It's easy to branch off the main repository and contribute patches, tests, and documentation back upstream.</p>
|
|
|
|
<h4>Bugs</h4>
|
|
|
|
<p><a href="http://bitbucket.org/which_linden/eventlet/issues/new/">Bug Report Form</a></p>
|
|
|
|
<p>No registration is required. Please be sure to report bugs <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">as effectively as possible</a>, to ensure that we understand and act on them quickly.</p>
|
|
|
|
<div class="section" id="web-crawler-example">
|
|
<h2>Web Crawler Example<a class="headerlink" href="#web-crawler-example" title="Permalink to this headline">¶</a></h2>
|
|
<p>This is a simple web “crawler” that fetches a bunch of urls using a coroutine pool. It has as much concurrency (i.e. pages being fetched simultaneously) as coroutines in the pool.</p>
|
|
|
|
<div class="highlight-python"><div class="highlight"><pre><span class="n">urls</span> <span class="o">=</span> <span class="p">[</span><span class="s">"http://www.google.com/intl/en_ALL/images/logo.gif"</span><span class="p">,</span>
|
|
<span class="s">"https://wiki.secondlife.com/w/images/secondlife.jpg"</span><span class="p">,</span>
|
|
<span class="s">"http://us.i1.yimg.com/us.yimg.com/i/ww/beta/y3.gif"</span><span class="p">]</span>
|
|
|
|
<span class="kn">import</span> <span class="nn">eventlet</span>
|
|
<span class="kn">from</span> <span class="nn">eventlet.green</span> <span class="kn">import</span> <span class="n">urllib2</span>
|
|
|
|
<span class="k">def</span> <span class="nf">fetch</span><span class="p">(</span><span class="n">url</span><span class="p">):</span>
|
|
|
|
<span class="k">return</span> <span class="n">urllib2</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="n">url</span><span class="p">)</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
|
|
|
|
<span class="n">pool</span> <span class="o">=</span> <span class="n">eventlet</span><span class="o">.</span><span class="n">GreenPool</span><span class="p">()</span>
|
|
|
|
<span class="k">for</span> <span class="n">body</span> <span class="ow">in</span> <span class="n">pool</span><span class="o">.</span><span class="n">imap</span><span class="p">(</span><span class="n">fetch</span><span class="p">,</span> <span class="n">urls</span><span class="p">):</span>
|
|
<span class="k">print</span> <span class="s">"got body"</span><span class="p">,</span> <span class="nb">len</span><span class="p">(</span><span class="n">body</span><span class="p">)</span>
|
|
</pre></div>
|
|
|
|
<h3>Stats</h3>
|
|
<script type="text/javascript" src="http://www.ohloh.net/p/480234/widgets/project_basic_stats.js"></script>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="section" id="contents">
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="">Links</a></h3>
|
|
<ul>
|
|
<li><a class="reference external" href="http://blog.eventlet.net/">Blog</a></li>
|
|
<li><a class="reference external" href="doc/">Documentation</a></li>
|
|
<li><a class="reference external" href="https://lists.secondlife.com/pipermail/eventletdev/">Mailing List Archives</a></li>
|
|
<li><a class="reference external" href="http://eventlet.net/hudson/">Automated Builds</a></li>
|
|
<li><a class="reference external" href="http://bitbucket.org/which_linden/eventlet/issues/new/">Bug Report Form</a></li>
|
|
<li><a class="reference external" href="irc://chat.freenode.net/#eventlet">irc channel</a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li>.</li>
|
|
</ul>
|
|
</div>
|
|
</body>
|
|
</html>
|