txtorcon
docs: https://txtorcon.readthedocs.org or http://fjblvrw2jrxnhtg67qpbzi45r7ofojaoo3orzykesly2j3c2m3htapid.onion/
torsocks git clone git://fjblvrw2jrxnhtg67qpbzi45r7ofojaoo3orzykesly2j3c2m3htapid.onion/txtorcon.git
MIT-licensed;
Python 3.8+, PyPy 7.3.7+;
Ten Thousand Feet
txtorcon is an implementation of the control-spec for Tor using the Twisted networking library for Python.
This is useful for writing utilities to control or make use of Tor in event-based Python programs. If your Twisted program supports endpoints (like twistd does) your server or client can make use of Tor immediately, with no code changes. Start your own Tor or connect to one and get live stream, circuit, relay updates; read and change config; monitor events; build circuits; create onion services; etcetera (ReadTheDocs).
Some Possibly Motivational Example Code
from twisted.internet.task import react
from twisted.internet.defer import inlineCallbacks, ensureDeferred
from twisted.internet.endpoints import UNIXClientEndpoint
import treq
import txtorcon
async def main(reactor):
tor = await txtorcon.connect(
reactor,
UNIXClientEndpoint(reactor, "/var/run/tor/control")
)
print("Connected to Tor version {}".format(tor.version))
url = u'https://www.torproject.org:443'
print(u"Downloading {}".format(repr(url)))
resp = await treq.get(url, agent=tor.web_agent())
print(u" {} bytes".format(resp.length))
data = await resp.text()
print(u"Got {} bytes:\n{}\n[...]{}".format(
len(data),
data[:120],
data[-120:],
))
print(u"Creating a circuit")
state = await tor.create_state()
circ = await state.build_circuit()
await circ.when_built()
print(u" path: {}".format(" -> ".join([r.ip for r in circ.path])))
print(u"Downloading meejah's public key via above circuit...")
config = await tor.get_config()
resp = await treq.get(
u'https://meejah.ca/meejah.asc',
agent=circ.web_agent(reactor, config.socks_endpoint(reactor)),
)
data = await resp.text()
print(data)
@react
def _main(reactor):
return ensureDeferred(main(reactor))Try It Now On Debian/Ubuntu
For example, serve some files via an onion service (aka hidden service):
$ sudo apt-get install --install-suggests python3-txtorcon
$ twistd -n web --port "onion:80" --path ~/public_htmlRead More
All the documentation starts in docs/index.rst. Also hosted at txtorcon.rtfd.org.
You’ll want to start with the introductions (hosted at RTD).
1 maintainer
Metadata
1 maintainer
Release files for txtorcon 26.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| txtorcon-26.6.0.tar.gz | 312.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| txtorcon-26.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 574.0 kB
Release files / txtorcon-26.6.0.tar.gz
| Download URL | txtorcon-26.6.0.tar.gz |
|---|---|
| Size | 312.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0408f063a9fcb8df529daca57bb7373ea0f5b4ebaffcd5103754b7c561773f68
|
|
BLAKE2b-256 checksum How to use checksums |
0c599b868727e8a41b6b5be4c0dad15b8188b75cb9ca3162aa7cdd20b7cfa808
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.11.6
|
Release files / txtorcon-26.6.0-py3-none-any.whl
| Download URL | txtorcon-26.6.0-py3-none-any.whl |
|---|---|
| Size | 261.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2c5a6e9bf639e48a8fb8a19ceedca0c8b40a8b15c7c049483671fec625dc93a0
|
|
BLAKE2b-256 checksum How to use checksums |
4127c8b133268a62f7afa637f0cba1a02741a91cb91ad24596bc3f947c1754a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.11.6
|
