<!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>Change Log — Pyro 4.21 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '4.21',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</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="top" title="Pyro 4.21 documentation" href="index.html" />
<link rel="next" title="Software License and Disclaimer" href="license.html" />
<link rel="prev" title="Pyrolite - client library for Java and .NET" href="pyrolite.html" />
</head>
<body>
<div class="related">
<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="license.html" title="Software License and Disclaimer"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="pyrolite.html" title="Pyrolite - client library for Java and .NET"
accesskey="P">previous</a> |</li>
<li><a href="index.html">Pyro 4.21 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="change-log">
<h1>Change Log<a class="headerlink" href="#change-log" title="Permalink to this headline">ΒΆ</a></h1>
<p><strong>Pyro 4.21</strong></p>
<ul class="simple">
<li>fixed denial of service vulnerabilities in socket servers</li>
<li>MSG_PING message type added (internal server ping mechanism)</li>
<li>disconnects example added that uses MSG_PING</li>
<li>more exception types recognised in the serializers (such as GeneratorExit)</li>
<li>fixed async regression when dealing with errors (properly serialize exceptionwrapper)</li>
<li>fixed warehouse and stockmarket tutorials to work with new serializer logic</li>
<li>fixed examples that didn’t yet work with new serializer logic</li>
<li>fixed unit tests to use unittest2 on Python 2.6</li>
<li>no longer supports jython 2.5. You’ll have to upgrade to jython 2.7.</li>
<li>got rid of some byte/str handling cruft (because we no longer need to deal with jython 2.5)</li>
<li>implemented autoproxy support for serpent and json serializers. It is not possible to do this for marshal.</li>
<li>fixed serpent serialization problem with backslash escapes in unicode strings (requires serpent >= 1.3)</li>
</ul>
<p><strong>Pyro 4.20</strong></p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The serializer-change is backwards-incompatible.
You may have to change your remote object method contracts to deal with the
changes. (or switch back to pickle if you can deal with its inherent security risk)</p>
</div>
<ul class="simple">
<li>multiple serializers supported instead of just pickle. (pickle, serpent, json, marshal)
pickle is unsafe/unsecure, so a choice of safe/secure serializers is now available</li>
<li>config item SERIALIZER added to select desired serializer, default is ‘serpent’</li>
<li>wire protocol version bumped because of this (45)</li>
<li>config item LOGWIRE added to be able to see in the logfile what passes over the wire</li>
</ul>
<p><strong>Pyro 4.18</strong></p>
<ul class="simple">
<li>IPV6 support landed in trunk (merged ipv6 branch)</li>
<li>added config item PREFER_IP_VERSION (4,6,0, default=4)</li>
<li>socketutil.getIpVersion added</li>
<li>socketutil.getMyIpAddress removed, use socketutil.getIpAddress(“”) instead</li>
<li>socketutil.createSocket and createBroadcastSocket got new ipv6 argument to create ipv6 sockets instead of ipv4</li>
<li>socketutil.bindOnUnusedPort now knows about ipv6 socket type as well</li>
<li>Uri locations using numeric “[...]” ip-address notation are considered to be IPv6</li>
<li>When Pyro displays a numeric IPv6 address in a Pyro uri, it will also use the “[...]” notation for the address</li>
<li>Added ipv6 related unittests</li>
<li>Added a few best-practices to the manual</li>
</ul>
<p><strong>Pyro 4.17</strong></p>
<ul class="simple">
<li>Fixed possible IndentationError problem with sending modules in Flame</li>
<li>Can now deal with exceptions that can’t be serialized: they’re raised as generic PyroError instead, with appropriate message</li>
<li>added new config item FLAME_ENABLED, to enable/disable the use of Pyro Flame on the server. Default is false (disabled).</li>
<li>Moved futures from core to new futures module. Code using Pyro4.Future will still work.</li>
<li>Added python version info to configuration dump</li>
<li>Made it more clear in the manual that you need to have the same major Python version on both sides</li>
</ul>
<p><strong>Pyro 4.16</strong></p>
<ul class="simple">
<li>New implementation for the threadpool server: job queue with self-adjusting number of workers.
The workaround that was in place (fixed pool size) has been removed.</li>
<li>minor api doc fix: corrected reference of Pyro4 package members</li>
</ul>
<p><strong>Pyro 4.15</strong></p>
<ul class="simple">
<li>Minimum threadpool size increased to 20 (from 4) to give a bit more breathing room
while the threadpool scaling still needs to be fixed</li>
<li>Binding a proxy will no longer release an existing connection first, instead it will just do nothing if the proxy has already been bound to its uri</li>
<li>Resolved a race condition related to releasing and binding a proxy, improved unit test</li>
<li>Documentation contains new homepage link</li>
<li>No longer gives a warning about version incompatibility on Jython 2.5</li>
<li>optimize bytecode flag no longer added in setup script when using jython, this used to crash the setup.py install process on jython</li>
<li>fixed a gc issue due to a circular dependency</li>
<li>IronPython: improved suggesting a free port number in socketutil.findProbablyUnusedPort</li>
<li>IronPython: threadpoolserver no longer attempts to join the worker threads because not all threads seemed to actually exit on IronPython, thereby hanging the process when shutting down a daemon.</li>
<li>Added a paragraph to tips&tricks about MSG_WAITALL</li>
<li>socket.MSG_WAITALL is no longer deleted by importing Pyro on systems that have a broken MSG_WAITALL (Windows). You’ll have to check for this yourself now, but I wanted to get rid of this side effect of importing Pyro.</li>
</ul>
<p><strong>Pyro 4.14</strong></p>
<ul class="simple">
<li>Fixed source-newline incompatibility with sending module sources with flame, the
fixExecSourceNewlines should be used on Python 3.0 and 3.1 as well it seemed.</li>
<li>fix IronPython crash: set socketutil.setNoInherit to a dummy for IronPython
because it can’t pass the proper arguments to the win32 api call</li>
<li>new config item MAX_MESSAGE_SIZE to optionally set a limit on the size of the
messages sent on the wire, default=0 bytes (which means unlimited size).</li>
<li>fixed some unit test problems with pypy and ironpython</li>
<li>fixed some problems with MSG_WAITALL socket option on systems that don’t properly support it</li>
<li>temporary workaround for threadpool scaling problem (lock-up):
pool is fixed at THREADPOOL_MINTHREADS threads, until the thread pool has been redesigned to get rid of the issues.</li>
</ul>
<p><strong>Pyro 4.13</strong></p>
<ul class="simple">
<li>fixed source-newline problem with sending module sources with flame, this could break
on Python < 2.7 because exec is very picky about newlines in the source text on older pythons</li>
<li>fixed URI and Proxy equality comparisons and hash(). Note that Proxy equality and hashing is
done on the local proxy object and not on the remote Pyro object.</li>
<li>added contrib directory where contributed stuff can be put. For now, there’s a Linux init.d
script for the name server daemon.</li>
<li>fix setNoInherit on 64-bits Python on Windows (see <a class="reference external" href="http://tech.oyster.com/cherrypy-ctypes-and-being-explicit/">http://tech.oyster.com/cherrypy-ctypes-and-being-explicit/</a>)</li>
<li>setting natport to 0 now replaces it by the internal port number, to facilitate one-to-one NAT port mapping setups</li>
<li>fixed _pyroId attribute problem when running with Cython</li>
</ul>
<p><strong>Pyro 4.12</strong></p>
<ul class="simple">
<li>added a few more code examples and cross-references to the docs to hopefully make it easier
to understand what the different ways of connecting your client code and server objects are</li>
<li>proxies no longer connect again if already connected (could happen with threads)</li>
<li>fixed not-equal-comparison for uri and serializer objects (x!=y)</li>
</ul>
<p><strong>Pyro 4.11</strong></p>
<ul class="simple">
<li>added host and port parameters to Daemon.serveSimple</li>
<li>added nathost and natport parameters to Daemon to be able to run behind a NAT router/firewall</li>
<li>added nathost and natport options to name server to configure it for use with NAT</li>
<li>added NATHOST and NATPORT config items to configure the external address for use with NAT</li>
<li>added BROADCAST_ADDRS config item. Use this to set the appropriate broadcast addresses (comma separated)
The default is ‘<broadcast>’ but you might need to change this on certain platforms (OpenSUSE?)
where that doesn’t work very well.</li>
<li>changed logger category from Pyro to Pyro4</li>
<li>connection closed error is no longer logged if it’s just a normal terminated proxy connection</li>
<li>fixed a config cleanup error in the test suite that could break it, depending on test execution order</li>
</ul>
<p><strong>Pyro 4.10</strong></p>
<ul class="simple">
<li>added Future class that provides async (future) function calls for any callable (not just Pyro proxies)</li>
<li>renamed _AsyncResult to FutureResult</li>
<li>added Flame (foreign location automatic module exposer) in Pyro4.utils.flame, including docs and example</li>
<li>Pyrolite also gained support for Flame (client access)</li>
<li>improved FutureResult.then(), it now accepts additional normal arguments as well instead of only kwargs</li>
<li>renamed Pyro4.config.refresh to Pyro4.config.reset because reset better describes what it is doing</li>
<li>added parameter to config.refresh to make it ignore environment variables</li>
<li>refactored internal threadpool into its own module, added unit tests</li>
</ul>
<p><strong>Pyro 4.9</strong></p>
<ul class="simple">
<li>removed AsyncResultTimeout exception</li>
<li>asyncresult.ready is now a property instead of a method</li>
<li>asyncresult.wait() is a new method taking the optional timeout argument to wait for the result to become available.
It doesn’t raise an exception, instead it returns true or false.</li>
<li>completed the documentation</li>
<li>added gui_eventloop example</li>
<li>added deadlock example</li>
<li>added itunes example</li>
<li>fixed some missing methods in the api reference documentation</li>
<li>serialized data is released a bit faster to improve garbage collection</li>
<li>fixed setting socket options in socketutil.createSocket</li>
<li>socket SO_REUSEADDR option now not set anymore by default; added new config item SOCK_REUSE to be able to set it to True if you want.</li>
<li>threaded server should deal with EINTR and other errors better (retry call)</li>
<li>better closedown of threadpool server</li>
<li>fix for potential autoproxy failure when unregistering pyro objects</li>
</ul>
<p><strong>Pyro 4.8</strong></p>
<ul class="simple">
<li>Major additions to the documentation: tutorials, API docs, and much more.</li>
<li>Polished many docstrings in the sources, they’re used in the generation of the API docs.</li>
<li>Unix domain socket support. Added <tt class="file docutils literal"><span class="pre">unixdomainsock</span></tt> example and unit tests.</li>
<li>Added options to the name server and echo server to use Unix domain sockets.</li>
<li>Name server broadcast responder will attempt to guess the caller’s correct network
interface, and use that to respond with the name server location IP (instead of 0.0.0.0).
This should fix some problems that occurred when the nameserver was listening on
0.0.0.0 and the proxy couldn’t connect to it after lookup. Added unit test.</li>
<li>API change: async callbacks have been changed into the more general async “call chain”,
using the <tt class="docutils literal"><span class="pre">then()</span></tt> method. Added examples and unit tests.</li>
<li>Async calls now copy the proxy internally so they don’t serialize after another anymore.</li>
<li>A python 2.6 compatibility issue was fixed in the unit tests.</li>
</ul>
<p><strong>Pyro 4.7</strong></p>
<ul class="simple">
<li>AutoProxy feature! This is a very nice one that I’ve always wanted to realize in Pyro ever since
the early days. Now it’s here: Pyro will automatically take care of any Pyro
objects that you pass around through remote method calls. It will replace them
by a proxy automatically, so the receiving side can call methods on it and be
sure to talk to the remote object instead of a local copy. No more need to
create a proxy object manually.
This feature can be switched off using the config item <tt class="docutils literal"><span class="pre">AUTOPROXY</span></tt> to get the old behavior.
Added a new <tt class="file docutils literal"><span class="pre">autoproxy</span></tt> example and changed several old examples to make use of this feature.</li>
<li>Asynchronous method calls: you can execute a remote method (or a batch of remote method) asynchronously,
and retrieve the results sometime in the future. Pyro will take care of collecting
the return values in the background. Added <tt class="file docutils literal"><span class="pre">async</span></tt> example.</li>
<li>One-line-server-setup using <tt class="docutils literal"><span class="pre">Pyro4.Daemon.serveSimple</span></tt>, handy for quickly starting a server with basic settings.</li>
<li><tt class="docutils literal"><span class="pre">nameserver.register()</span></tt> behavior change: it will now overwrite an existing registration with the same name unless
you provide a <tt class="docutils literal"><span class="pre">safe=True</span></tt> argument. This means you don’t need to <tt class="docutils literal"><span class="pre">unregister()</span></tt>
your server objects anymore all the time when restarting the server.</li>
<li>added <tt class="docutils literal"><span class="pre">Pyro4.util.excepthook</span></tt> that you can use for <tt class="docutils literal"><span class="pre">sys.excepthook</span></tt></li>
<li>Part of the new manual has been written, including a tutorial where two simple applications are built.</li>
</ul>
<p><strong>Pyro 4.6</strong></p>
<ul class="simple">
<li>Added batch call feature to greatly speed up many calls on the same proxy. Pyro can do 180,000 calls/sec or more with this.</li>
<li>Fixed handling of connection fail in handshake</li>
<li>A couple of python3 fixes related to the hmac key</li>
<li>More unit test coverage</li>
</ul>
<p><strong>Pyro 4.5</strong></p>
<ul class="simple">
<li>Added builtin test echo server, with example and unittest. Try <tt class="docutils literal"><span class="pre">python</span> <span class="pre">-m</span> <span class="pre">Pyro4.test.echoserver</span> <span class="pre">-h</span></tt></li>
<li>Made <tt class="docutils literal"><span class="pre">Pyro4.config</span></tt> into a proper class with error checking.</li>
<li>Some Jython related fixes.</li>
<li>Code cleanups (pep8 is happier now)</li>
<li>Fixed error behaviour, no longer crashes server in some cases</li>
<li><tt class="docutils literal"><span class="pre">HMAC_KEY</span></tt> is no longer required, but you’ll still get a warning if you don’t set it</li>
</ul>
<p><strong>Pyro 4.4</strong></p>
<ul class="simple">
<li>removed pickle stream version check (too much overhead for too little benefit).</li>
<li>set no-inherit flag on server socket to prevent problems with child processes blocking the socket. More info: <a class="reference external" href="http://www.cherrypy.org/ticket/856">http://www.cherrypy.org/ticket/856</a></li>
<li>added HMAC message digests to the protocol, with a user configurable secret shared key in <tt class="docutils literal"><span class="pre">HMAC_KEY</span></tt> (required).
This means you could now safely expose your Pyro interface to the outside world, without risk
of getting owned by malicious messages constructed by a hacker.
You need to have enough trust in your shared key. note that the data is not encrypted,
it is only signed, so you still should not send sensitive data in plain text.</li>
</ul>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<img class="logo" src="_static/pyro.png" alt="Logo"/>
</a></p>
<h4>Previous topic</h4>
<p class="topless"><a href="pyrolite.html"
title="previous chapter">Pyrolite - client library for Java and .NET</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="license.html"
title="next chapter">Software License and Disclaimer</a></p>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<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>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<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="license.html" title="Software License and Disclaimer"
>next</a> |</li>
<li class="right" >
<a href="pyrolite.html" title="Pyrolite - client library for Java and .NET"
>previous</a> |</li>
<li><a href="index.html">Pyro 4.21 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright Irmen de Jong.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
