deprecate tub.listenOn("tcp:0")

[Brian Warner]

We're moving towards less auto-magic allocation/detection and more pre-allocated ports and user-supplied hostnames/IP-addresses. The practice of automatically detecting locally-attached interfaces only works when the other machine you're talking to is on the same network (and with NAT, this is usually not true). And the automatic detection makes things less predictable.

So the plan is to deprecate the following:

• Listener.getPortnum()
• tub.setLocationAutomatically()
• tub.listenOn("tcp:0"). Or rather, you could still do that, but without .getPortnum() there's no way to find out the port that got allocated. So you should always choose the port number first.
• #137 is WONTFIXed, which would have added Tub.listenOn(portfile=)

And we're adding foolscap.util.allocate_tcp_port() (which doesn't block) to help applications perform the allocation ahead of time.