[tor-dev] txtorcon 0.19.0

[meejah]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

I'm very happy to release txtorcon 0.19.0. This merges most of the
development that happened over the last several months on the
release-1.x branch. Featuring:

 * Full Python3 support (and universal wheels)

 * Drop txsocksx and use a custom implementation (this also implements
   the custom Tor SOCKS5 methods RESOLVE and RESOLVE_PTR). Uses
   Automat for the state-machine.

 * Drop support for older Twisted releases (12, 13 and 14 are no
   longer supported).

 * Add a top-level API object (txtorcon.Tor) that abstracts a running
   Tor. Instances of this class are created with txtorcon.connect or
   txtorcon.launch. These instances are intended to be "the"
   high-level API and most users shouldn't need anything else.

 * Integrated support for twisted.web.client.Agent, baked into
   txtorcon.Tor. This allows simple, straightforward use of treq or
   "raw" twisted.web.client for making client-type Web requests via
   Tor. Automatically handles configuration of SOCKS ports.

 * new high-level API for putting streams on specific Circuits. This
   adds txtorcon.Circuit.stream_via and txtorcon.Circuit.web_agent
   methods that work the same as the "Tor" equivalent methods except
   they use a specific circuit. This makes
   txtorcon.TorState.set_attacher the "low-level" / "expert"
   interface. Most users should only need the new API.

 * big revamp / re-write of the documentation, including the new
   Programming Guide:
   https://txtorcon.readthedocs.io/en/latest/guide.html

 * Issue 203: https://github.com/meejah/txtorcon/issues/203

 * new helper: txtorcon.Router.get_onionoo_details which downloads
   JSON for a particular relay from OnionOO

 * new helper: txtorcon.util.create_tbb_web_headers which returns
   headers resembling a recent Tor Browser suitable for use with
   Twisted or treq web agents.

 * Issue 72: https://github.com/meejah/txtorcon/issues/72

 * Specific SocksError subclasses for all the available SOCKS5 errors
   added by https://github.com/felipedau

 * (more) Python3 fixes from https://github.com/rodrigc

You can download the release from PyPI or GitHub (or of course "pip
install txtorcon"):

   https://pypi.python.org/pypi/txtorcon/0.19.0
   https://github.com/meejah/txtorcon/releases/tag/v0.19.0

Releases are also available from the hidden service:

   http://timaq4ygg2iegci7.onion/txtorcon-0.19.0.tar.gz
   http://timaq4ygg2iegci7.onion/txtorcon-0.19.0.tar.gz.asc

You can verify the sha256sum of both by running the following 4 lines
in a shell wherever you have the files downloaded:

cat <<EOF | sha256sum --check
09d56fbd6e33eef7405c8ca354bbba06da2cefa02763d15c4bc9ac274c5daeeb  dist/txtorcon-0.19.0.tar.gz
cc51b4249ad126c31ea2746ec5ef1bcb7f6b0c34ced070913ed7772c0e48edf5  dist/txtorcon-0.19.0-py2.py3-none-any.whl
EOF

thanks,
meejah
-----BEGIN PGP SIGNATURE-----

iQEcBAEBAgAGBQJY+ZjOAAoJEMJgKAMSgGmnadEH/R0YCoID3xTkbFL7mVhtqY2e
p7sPcFT50jUGDASaER2YoQ4syzptnQcLid5/pCf+F2xMwCVgayqaipNXtugNHZIl
9cCOnI09+IntCFLkVXQqMGnEzSSzcM0Ln87Qa9MMjNNZM+aj2WshmFnObdqsWNRo
tIhnuKgMDgqoO9OgiXCsUXFQeooDDidnrnJgl5U7AA0+13nIar+/q9vCxMtDqSV9
kfh5IkB4RaeJTzDtTMYQKKHTIltdn7o0LrCyp1QsMhX+iHU4xZVOi7etgFnACqsP
S1u2LMT1FggvyEAzIwn45ADhKpuPBrR35N5C21vQklHVEb9nQxI9LXTHCi0Fv5g=
=mGZj
-----END PGP SIGNATURE-----