Updated py-foolscap to 0.12.5.

* Release 0.12.5 (07-Dec-2016)

** Connection Status Reporting

This release adds an object named `ConnectionInfo`, which encapsulates
information about a connection (both progress while being established, and
the outcome once connected). This includes which connection hint was
successful, what happened with the other hints, which handlers were used for
each, and when the connection was made or lost. To get one of these, use
`tub.getConnectionInfoForFURL(furl)` any time after `getReference()` is
called, or `rref.getConnectionInfo()` after it resolves.  #267

It also adds `ReconnectionInfo`, a similar object for Reconnectors. These
capture the state of reconnection process (trying, established, waiting), and
will provide a `ConnectionInfo` for the most recent (possibly successful)
connection attempt. The API is `reconnector.getReconnectionInfo()`.  #268

For details, see "Connection Progress/Status" and "Reconnector Status" in
`doc/using-foolscap.rst`.

** Connection Handler API Changes

To support `ConnectionInfo`, the Connection Handler API was changed.

The one backwards-incompatible change was that the `hint_to_endpoint()`
method now takes a third argument, to update the status as the handler makes
progress. External handler functions will need to be modified to accept this
new argument, and applications which use them should declare a dependency
upon the latest Foolscap version, to avoid runtime breakage.

Several backwards-compatible changes were made too: handlers can provide a
`describe()` method (which feeds `ConnectionInfo.connectionHandlers`), and
they can now set a special attribute on any exception they raise, to further
influence the status string.

In addition, the `tor.control_endpoint_maker()` handler now accepts an
optional second argument, which causes the maker function to be called with a
additional `update_status` argument. This backwards-compatible change allows
the maker function to influence the `ConnectionInfo` status too.

The Tor connection handler was enhanced to report distinct statuses for the
different phases of connection: launching a new copy of Tor, connecting to an
existing Tor daemon, etc.

** Minor Fixes

Foolscap-0.12.0 broke `flappserver create`, causing the command to hang
rather than exiting cleanly (although the flappserver directory itself was
probably created properly). This release finally fixes it.  #271

3 files changed, 14 insertions, 8 deletions

diff --git a/net/py-foolscap/Makefile b/net/py-foolscap/Makefile
index ce84eb5e5ce..5df724ae647 100644
--- a/net/py-foolscap/Makefile
+++ b/net/py-foolscap/Makefile
@@ -1,6 +1,6 @@
-# $NetBSD: Makefile,v 1.23 2016/10/19 12:54:04 wiz Exp $
+# $NetBSD: Makefile,v 1.24 2016/12/12 14:27:39 wiz Exp $
 
-DISTNAME=	foolscap-0.12.4
+DISTNAME=	foolscap-0.12.5
 PKGNAME=	${PYPKGPREFIX}-${DISTNAME}
 CATEGORIES=	net python
 MASTER_SITES=	${MASTER_SITE_PYPI:=f/foolscap/}
diff --git a/net/py-foolscap/PLIST b/net/py-foolscap/PLIST
index 7e63782e44e..3a379daf68d 100644
--- a/net/py-foolscap/PLIST
+++ b/net/py-foolscap/PLIST
@@ -1,4 +1,4 @@
-@comment $NetBSD: PLIST,v 1.9 2016/09/01 16:54:32 wiz Exp $
+@comment $NetBSD: PLIST,v 1.10 2016/12/12 14:27:39 wiz Exp $
 bin/flappclient
 bin/flappserver
 bin/flogtool
@@ -77,6 +77,9 @@ ${PYSITELIB}/foolscap/eventual.pyo
 ${PYSITELIB}/foolscap/furl.py
 ${PYSITELIB}/foolscap/furl.pyc
 ${PYSITELIB}/foolscap/furl.pyo
+${PYSITELIB}/foolscap/info.py
+${PYSITELIB}/foolscap/info.pyc
+${PYSITELIB}/foolscap/info.pyo
 ${PYSITELIB}/foolscap/ipb.py
 ${PYSITELIB}/foolscap/ipb.pyc
 ${PYSITELIB}/foolscap/ipb.pyo
@@ -239,6 +242,9 @@ ${PYSITELIB}/foolscap/test/test_eventual.pyo
 ${PYSITELIB}/foolscap/test/test_gifts.py
 ${PYSITELIB}/foolscap/test/test_gifts.pyc
 ${PYSITELIB}/foolscap/test/test_gifts.pyo
+${PYSITELIB}/foolscap/test/test_info.py
+${PYSITELIB}/foolscap/test/test_info.pyc
+${PYSITELIB}/foolscap/test/test_info.pyo
 ${PYSITELIB}/foolscap/test/test_interfaces.py
 ${PYSITELIB}/foolscap/test/test_interfaces.pyc
 ${PYSITELIB}/foolscap/test/test_interfaces.pyo
diff --git a/net/py-foolscap/distinfo b/net/py-foolscap/distinfo
index 63234204861..da2ecc35392 100644
--- a/net/py-foolscap/distinfo
+++ b/net/py-foolscap/distinfo
@@ -1,6 +1,6 @@
-$NetBSD: distinfo,v 1.15 2016/10/19 12:54:04 wiz Exp $
+$NetBSD: distinfo,v 1.16 2016/12/12 14:27:39 wiz Exp $
 
-SHA1 (foolscap-0.12.4.tar.gz) = 55f6010cc9ccca400e835866e7a18d7f3f8a58c1
-RMD160 (foolscap-0.12.4.tar.gz) = 1dc6115895e9947fc37bd08337d3f76840ca3bfe
-SHA512 (foolscap-0.12.4.tar.gz) = d991f252d5e54caac810b67e33be2a357d7da462e112688ca99b0d2a71b600830d87c00236325b5240c35b046d34b56cf8bd54045c4ccf533f99b7981a4f8634
-Size (foolscap-0.12.4.tar.gz) = 507397 bytes
+SHA1 (foolscap-0.12.5.tar.gz) = b52f35f13713568c3dd2c28ce666c4a5c9c2d209
+RMD160 (foolscap-0.12.5.tar.gz) = 0627c62438bdec951731b8d9715f07d96dc62e61
+SHA512 (foolscap-0.12.5.tar.gz) = 80c18ac67d74ae2ffa26c84aba17ceac4e98745d9c91730136c2aaeab7349ee8c0aadc5b6e19fed8e1e210c33957e52f9a25699348e07ace7cfb26859f13e7ec
+Size (foolscap-0.12.5.tar.gz) = 516411 bytes