diff options
Diffstat (limited to 'changelog.html')
| -rw-r--r-- | changelog.html | 232 |
1 files changed, 188 insertions, 44 deletions
diff --git a/changelog.html b/changelog.html index 14f09b6d..31bc289b 100644 --- a/changelog.html +++ b/changelog.html @@ -6,13 +6,13 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - <title>Change history — Kombu v1.0.6 documentation</title> + <title>Change history — Kombu v1.1.0 documentation</title> <link rel="stylesheet" href="static/celery.css" type="text/css" /> <link rel="stylesheet" href="static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '', - VERSION: '1.0.6', + VERSION: '1.1.0', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true @@ -21,7 +21,7 @@ <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="top" title="Kombu v1.0.6 documentation" href="index.html" /> + <link rel="top" title="Kombu v1.1.0 documentation" href="index.html" /> <link rel="prev" title="Finalize - kombu.utils.finalize" href="reference/kombu.utils.finalize.html" /> </head> <body> @@ -37,7 +37,7 @@ <li class="right" > <a href="reference/kombu.utils.finalize.html" title="Finalize - kombu.utils.finalize" accesskey="P">previous</a> |</li> - <li><a href="index.html">Kombu v1.0.6 documentation</a> »</li> + <li><a href="index.html">Kombu v1.1.0 documentation</a> »</li> </ul> </div> @@ -48,13 +48,152 @@ <div class="section" id="change-history"> <h1>Change history<a class="headerlink" href="#change-history" title="Permalink to this headline">¶</a></h1> -<div class="section" id="id1"> -<h2>1.0.6<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-1-0"> +<span id="id1"></span><h2>1.1.0<a class="headerlink" href="#version-1-1-0" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> -<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-03-22 16:00 P.M CET</td> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-04-05 01:05 P.M CEST</td> +</tr> +</tbody> +</table> +<div class="section" id="important-notes"> +<span id="v110-important"></span><h3>Important Notes<a class="headerlink" href="#important-notes" title="Permalink to this headline">¶</a></h3> +<ul> +<li><p class="first">Virtual transports: Message body is now base64 encoded by default +(Issue #27).</p> +<blockquote> +<div><p>This should solve problems sending binary data with virtual +transports.</p> +<p>Message compatibility is handled by adding a <tt class="docutils literal"><span class="pre">body_encoding</span></tt> +property, so messages sent by older versions is compatible +with this release. However – If you are accessing the messages +directly not using Kombu, then you have to respect +the <tt class="docutils literal"><span class="pre">body_encoding</span></tt> property.</p> +<p>If you need to disable base64 encoding then you can do so +via the transport options:</p> +<div class="highlight-python"><div class="highlight"><pre><span class="n">BrokerConnection</span><span class="p">(</span><span class="n">transport</span><span class="o">=</span><span class="s">"..."</span><span class="p">,</span> + <span class="n">transport_options</span><span class="o">=</span><span class="p">{</span><span class="s">"body_encoding"</span><span class="p">:</span> <span class="bp">None</span><span class="p">})</span> +</pre></div> +</div> +<p><strong>For transport authors</strong>:</p> +<blockquote> +<div><p>You don’t have to change anything in your custom transports, +as this is handled automatically by the base class.</p> +<p>If you want to use a different encoder you can do so by adding +a key to <tt class="docutils literal"><span class="pre">Channel.codecs</span></tt>. Default encoding is specified +by the <tt class="docutils literal"><span class="pre">Channel.body_encoding</span></tt> attribute.</p> +<p>A new codec must provide two methods: <tt class="docutils literal"><span class="pre">encode(data)</span></tt> and +<tt class="docutils literal"><span class="pre">decode(data)</span></tt>.</p> +</div></blockquote> +</div></blockquote> +</li> +<li><p class="first">ConnectionPool/ChannelPool/Resource: Setting <tt class="docutils literal"><span class="pre">limit=None</span></tt> (or 0) +now disables pool semantics, and will establish and close +the resource whenever acquired or released.</p> +</li> +<li><p class="first">ConnectionPool/ChannelPool/Resource: Is now using a LIFO queue +instead of the previous FIFO behavior.</p> +<blockquote> +<div><p>This means that the last resource released will be the one +acquired next. I.e. if only a single thread is using the pool +this means only a single connection will ever be used.</p> +</div></blockquote> +</li> +<li><p class="first">BrokerConnection: Cloned connections did not inherit transport_options +(<tt class="docutils literal"><span class="pre">__copy__</span></tt>).</p> +</li> +<li><p class="first">contrib/requirements is now located in the top directory +of the distribution.</p> +</li> +<li><p class="first">MongoDB: Now supports authentication using the <tt class="docutils literal"><span class="pre">userid</span></tt> and <tt class="docutils literal"><span class="pre">password</span></tt> +arguments to <tt class="xref py py-class docutils literal"><span class="pre">BrokerConnection</span></tt> (Issue #30).</p> +</li> +<li><p class="first">BrokerConnection: Default autentication credentials are now delegated to +the individual transports.</p> +<blockquote> +<div><p>This means that the <tt class="docutils literal"><span class="pre">userid</span></tt> and <tt class="docutils literal"><span class="pre">password</span></tt> arguments to +BrokerConnection is no longer <em>guest/guest</em> by default.</p> +<p>The amqplib and pika transports will still have the default +credentials.</p> +</div></blockquote> +</li> +<li><p class="first"><tt class="xref py py-meth docutils literal"><span class="pre">Consumer.__exit__()</span></tt> did not have the correct signature (Issue #32).</p> +</li> +<li><p class="first">Channel objects now have a <tt class="docutils literal"><span class="pre">channel_id</span></tt> attribute.</p> +</li> +<li><dl class="first docutils"> +<dt>MongoDB: Version sniffing broke with development versions of</dt> +<dd><p class="first last">mongod (Issue #29).</p> +</dd> +</dl> +</li> +<li><p class="first">New environment variable <span class="target" id="index-0"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_CONNECTION</span></tt> will now emit debug +log messages for connection related actions.</p> +<p><span class="target" id="index-1"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_DEBUG</span></tt> will also enable <span class="target" id="index-2"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_CONNECTION</span></tt>.</p> +</li> +</ul> +</div> +</div> +<div class="section" id="version-1-0-7"> +<span id="id2"></span><h2>1.0.7<a class="headerlink" href="#version-1-0-7" title="Permalink to this headline">¶</a></h2> +<table class="docutils field-list" frame="void" rules="none"> +<col class="field-name" /> +<col class="field-body" /> +<tbody valign="top"> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-03-28 05:45 P.M CEST</td> +</tr> +</tbody> +</table> +<ul> +<li><p class="first">Now depends on anyjson 0.3.1</p> +<blockquote> +<div><p>cjson is no longer a recommended json implementation, and anyjson +will now emit a deprecation warning if used.</p> +</div></blockquote> +</li> +<li><p class="first">Please note that the Pika backend only works with version 0.5.2.</p> +<blockquote> +<div><p>The latest version (0.9.x) drastically changed API, and it is not +compatible yet.</p> +</div></blockquote> +</li> +<li><p class="first">on_decode_error is now called for exceptions in message_to_python +(Issue #24).</p> +</li> +<li><p class="first">Redis: did not respect QoS settings.</p> +</li> +<li><p class="first">Redis: Creating a connection now ensures the connection is established.</p> +<blockquote> +<div><p>This means <tt class="docutils literal"><span class="pre">BrokerConnection.ensure_connection</span></tt> works properly with +Redis.</p> +</div></blockquote> +</li> +<li><p class="first">consumer_tag argument to <tt class="docutils literal"><span class="pre">Queue.consume</span></tt> can’t be <tt class="xref py py-const xref docutils literal"><span class="pre">None</span></tt> +(Issue #21).</p> +<blockquote> +<div><p>A None value is now automatically converted to empty string. +An empty string will make the server generate a unique tag.</p> +</div></blockquote> +</li> +<li><p class="first">BrokerConnection now supports a <tt class="docutils literal"><span class="pre">transport_options</span></tt> argument.</p> +<blockquote> +<div><p>This can be used to pass additional arguments to transports.</p> +</div></blockquote> +</li> +<li><p class="first">Pika: <tt class="docutils literal"><span class="pre">drain_events</span></tt> raised <tt class="xref py py-exc docutils literal"><span class="pre">socket.timeout</span></tt> even if no timeout +set (Issue #8).</p> +</li> +</ul> +</div> +<div class="section" id="id3"> +<h2>1.0.6<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2> +<table class="docutils field-list" frame="void" rules="none"> +<col class="field-name" /> +<col class="field-body" /> +<tbody valign="top"> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-03-22 04:00 P.M CET</td> </tr> </tbody> </table> @@ -66,14 +205,14 @@ transport.</p> <li><p class="first">Redis: The redis-py <tt class="xref py py-exc docutils literal"><span class="pre">InvalidData</span></tt> exception suddenly changed name to <tt class="xref py py-exc docutils literal"><span class="pre">DataError</span></tt>.</p> </li> -<li><p class="first">The <span class="target" id="index-0"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_DEBUG</span></tt> environment variable can now be set to log all +<li><p class="first">The <span class="target" id="index-3"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_DEBUG</span></tt> environment variable can now be set to log all channel method calls.</p> <p>Support for the following environment variables have been added:</p> <blockquote> -<ul class="simple"> -<li><span class="target" id="index-1"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_CHANNEL</span></tt> will wrap channels in an object that +<div><ul class="simple"> +<li><span class="target" id="index-4"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_CHANNEL</span></tt> will wrap channels in an object that logs every method call.</li> -<li><span class="target" id="index-2"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_DEBUG</span></tt> both enables channel logging and configures the +<li><span class="target" id="index-5"></span><tt class="xref std std-envvar docutils literal"><span class="pre">KOMBU_LOG_DEBUG</span></tt> both enables channel logging and configures the root logger to emit messages to standard error.</li> </ul> <p><strong>Example Usage</strong>:</p> @@ -90,17 +229,17 @@ Channel open [Kombu channel:1] queue_declare('myq', passive=True) (u'myq', 0, 1)</pre> </div> -</blockquote> +</div></blockquote> </li> </ul> </div> -<div class="section" id="id2"> -<h2>1.0.5<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-0-5"> +<span id="id4"></span><h2>1.0.5<a class="headerlink" href="#version-1-0-5" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> -<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-03-17 16:00 P.M CET</td> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-03-17 04:00 P.M CET</td> </tr> </tbody> </table> @@ -110,10 +249,10 @@ affected (redis, mongodb, memory, django, sqlalchemy, couchdb, beanstalk).</p> </li> <li><p class="first">Virtual Transports: Fixed potential race condition when acking messages.</p> <blockquote> -<p>If you have been affected by this, the error would show itself as an +<div><p>If you have been affected by this, the error would show itself as an exception raised by the OrderedDict implementation. (<tt class="docutils literal"><span class="pre">object</span> <span class="pre">no</span> <span class="pre">longer</span> <span class="pre">exists</span></tt>).</p> -</blockquote> +</div></blockquote> </li> <li><p class="first">MongoDB transport requires the <tt class="docutils literal"><span class="pre">findandmodify</span></tt> command only available in MongoDB 1.3+, so now raises an exception if connected to an incompatible @@ -124,33 +263,33 @@ consumer tag.</p> </li> </ul> </div> -<div class="section" id="id3"> -<h2>1.0.4<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-0-4"> +<span id="id5"></span><h2>1.0.4<a class="headerlink" href="#version-1-0-4" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> -<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-02-28 16:00 P.M CET</td> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-02-28 04:00 P.M CET</td> </tr> </tbody> </table> <ul> <li><p class="first">Added Transport.polling_interval</p> <blockquote> -<p>Used by django-kombu to increase the time to sleep between SELECTs when +<div><p>Used by django-kombu to increase the time to sleep between SELECTs when there are no messages in the queue.</p> <p>Users of django-kombu should upgrade to django-kombu v0.9.2.</p> -</blockquote> +</div></blockquote> </li> </ul> </div> -<div class="section" id="id4"> -<h2>1.0.3<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-0-3"> +<span id="id6"></span><h2>1.0.3<a class="headerlink" href="#version-1-0-3" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> -<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-02-12 16:00 P.M CET</td> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2011-02-12 04:00 P.M CET</td> </tr> </tbody> </table> @@ -160,8 +299,8 @@ there are no messages in the queue.</p> <li>Copyright headers updated to include 2011.</li> </ul> </div> -<div class="section" id="id5"> -<h2>1.0.2<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-0-2"> +<span id="id7"></span><h2>1.0.2<a class="headerlink" href="#version-1-0-2" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> @@ -175,8 +314,8 @@ there are no messages in the queue.</p> <li>Ghettoq backend names are now automatically translated to the new names.</li> </ul> </div> -<div class="section" id="id6"> -<h2>1.0.1<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-0-1"> +<span id="id8"></span><h2>1.0.1<a class="headerlink" href="#version-1-0-1" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> @@ -189,8 +328,8 @@ there are no messages in the queue.</p> <li>Redis: Now works with Linux (epoll)</li> </ul> </div> -<div class="section" id="id7"> -<h2>1.0.0<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-1-0-0"> +<span id="id9"></span><h2>1.0.0<a class="headerlink" href="#version-1-0-0" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> @@ -203,13 +342,13 @@ there are no messages in the queue.</p> <li>Initial release</li> </ul> </div> -<div class="section" id="id8"> -<h2>0.1.0<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h2> +<div class="section" id="version-0-1-0"> +<span id="id10"></span><h2>0.1.0<a class="headerlink" href="#version-0-1-0" title="Permalink to this headline">¶</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> -<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2010-07-22 4:20 P.M CET</td> +<tr class="field"><th class="field-name">release-date:</th><td class="field-body">2010-07-22 04:20 P.M CET</td> </tr> </tbody> </table> @@ -230,14 +369,19 @@ there are no messages in the queue.</p> <h3><a href="index.html">Table Of Contents</a></h3> <ul> <li><a class="reference internal" href="#">Change history</a><ul> -<li><a class="reference internal" href="#id1">1.0.6</a></li> -<li><a class="reference internal" href="#id2">1.0.5</a></li> -<li><a class="reference internal" href="#id3">1.0.4</a></li> -<li><a class="reference internal" href="#id4">1.0.3</a></li> -<li><a class="reference internal" href="#id5">1.0.2</a></li> -<li><a class="reference internal" href="#id6">1.0.1</a></li> -<li><a class="reference internal" href="#id7">1.0.0</a></li> -<li><a class="reference internal" href="#id8">0.1.0</a></li> +<li><a class="reference internal" href="#version-1-1-0">1.1.0</a><ul> +<li><a class="reference internal" href="#important-notes">Important Notes</a></li> +</ul> +</li> +<li><a class="reference internal" href="#version-1-0-7">1.0.7</a></li> +<li><a class="reference internal" href="#id3">1.0.6</a></li> +<li><a class="reference internal" href="#version-1-0-5">1.0.5</a></li> +<li><a class="reference internal" href="#version-1-0-4">1.0.4</a></li> +<li><a class="reference internal" href="#version-1-0-3">1.0.3</a></li> +<li><a class="reference internal" href="#version-1-0-2">1.0.2</a></li> +<li><a class="reference internal" href="#version-1-0-1">1.0.1</a></li> +<li><a class="reference internal" href="#version-1-0-0">1.0.0</a></li> +<li><a class="reference internal" href="#version-0-1-0">0.1.0</a></li> </ul> </li> </ul> @@ -279,12 +423,12 @@ there are no messages in the queue.</p> <li class="right" > <a href="reference/kombu.utils.finalize.html" title="Finalize - kombu.utils.finalize" >previous</a> |</li> - <li><a href="index.html">Kombu v1.0.6 documentation</a> »</li> + <li><a href="index.html">Kombu v1.1.0 documentation</a> »</li> </ul> </div> <div class="footer"> © Copyright 2009-2011, Ask Solem. - Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.4. + Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> </html>
\ No newline at end of file |