removing IP-address autodetection, Tor integration

[David Stainton]

Hi Brian Warner and everyone else too,

There's some really good examples of how to use the txtorcon's Tor
hidden service endpoints... that also demonstrate how to properly
determine the generated .onion address from the fired IListeningPort:
https://github.com/meejah/txtorcon/blob/master/examples/launch_tor_endpoint.py
https://github.com/meejah/txtorcon/blob/master/examples/launch_tor_endpoint2.py

whereas these two examples don't use the endpoint abstraction and
instead use TorConfig to configure the tor process with a onion
service:
https://github.com/meejah/txtorcon/blob/master/examples/launch_tor_with_hiddenservice.py
https://github.com/meejah/txtorcon/blob/master/examples/launch_tor_with_simplehttpd.py

I don't think there is any reason for us to not use the client +
server endpoint objects... Even if there are edge cases where the
existing endpoint parser or endpoint constructors are not sufficiently
flexible we should opt to add another class method to the endpoint
object instead of using TorConfig directly.

Meejah has written some excellent documentation here:
http://timaq4ygg2iegci7.onion/txtorcon-protocol.html#txtorcon.TCPHiddenServiceEndpoint

"""There are three main ways to use this class, and you are encouraged
to use the @classmethod ways of creating instances: system_tor,
global_tor, and private_tor"""


Cheers,

~david

On Tue, Jul 28, 2015 at 9:23 PM, Daira Hopwood <daira at jacaranda.org> wrote:
> On 23/07/15 16:54, Chris Kerr wrote:
>> Also, perhaps changing the keyword to 'AUTODETECT' rather than 'AUTO' might
>> make the configuration easier to understand.
>
> -1; people are unlikely to find out about "AUTO" except by looking at the
> docs or by following someone else's advice, and in both those cases it would
> be clear that it refers to auto-detection. Changing it now would prevent writing
> a tahoe.cfg, or instructions for how to write/change one, that would work under
> both new and old versions.
>
> --
> Daira Hopwood ⚥
>
>
> _______________________________________________
> tahoe-dev mailing list
> tahoe-dev at tahoe-lafs.org
> https://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev
>