commit 9886aeef2abc9de64bd00c62339b58eee0d8bc7b Author: Sambuddha Basu <sambuddhabasu1@gmail.com> Date: Mon May 25 08:12:01 2015 +0400 Added downloadable tutotial for tutorial East of the Sun & West of the Moon --- docs/_static/example/utilities.py | 28 ++++++++++++++++++++++++++++ docs/tutorials/east_of_the_sun.rst | 33 +++------------------------------ 2 files changed, 31 insertions(+), 30 deletions(-) diff --git a/docs/_static/example/utilities.py b/docs/_static/example/utilities.py new file mode 100644 index 0000000..460f6ff --- /dev/null +++ b/docs/_static/example/utilities.py @@ -0,0 +1,28 @@ +import sys + +from stem.util.connection import get_connections, system_resolvers +from stem.util.system import pid_by_name + +resolvers = system_resolvers() + +if not resolvers: + print "Stem doesn't support any connection resolvers on our platform." + sys.exit(1) + +picked_resolver = resolvers[0] # lets just opt for the first +print "Our platform supports connection resolution via: %s (picked %s)" % (', '.join(resolvers), picked_resolver) + +tor_pids = pid_by_name('tor', multiple = True) + +if not tor_pids: + print "Unable to get tor's pid. Is it running?" + sys.exit(1) +elif len(tor_pids) > 1: + print "You're running %i instances of tor, picking the one with pid %i" % (len(tor_pids), tor_pids[0]) +else: + print "Tor is running with pid %i" % tor_pids[0] + +print "\nConnections:\n" + +for conn in get_connections(picked_resolver, process_pid = tor_pids[0], process_name = 'tor'): + print " %s:%s => %s:%s" % (conn.local_address, conn.local_port, conn.remote_address, conn.remote_port) diff --git a/docs/tutorials/east_of_the_sun.rst b/docs/tutorials/east_of_the_sun.rst index 13ede2d..f577df9 100644 --- a/docs/tutorials/east_of_the_sun.rst +++ b/docs/tutorials/east_of_the_sun.rst @@ -33,36 +33,9 @@ but likely also a violation of wiretap laws. With that out of the way, how do you look up this information? Below is a simple script that dumps Tor's present connections. -:: - - import sys - - from stem.util.connection import get_connections, system_resolvers - from stem.util.system import pid_by_name - - resolvers = system_resolvers() - - if not resolvers: - print "Stem doesn't support any connection resolvers on our platform." - sys.exit(1) - - picked_resolver = resolvers[0] # lets just opt for the first - print "Our platform supports connection resolution via: %s (picked %s)" % (', '.join(resolvers), picked_resolver) - - tor_pids = pid_by_name('tor', multiple = True) - - if not tor_pids: - print "Unable to get tor's pid. Is it running?" - sys.exit(1) - elif len(tor_pids) > 1: - print "You're running %i instances of tor, picking the one with pid %i" % (len(tor_pids), tor_pids[0]) - else: - print "Tor is running with pid %i" % tor_pids[0] - - print "\nConnections:\n" - - for conn in get_connections(picked_resolver, process_pid = tor_pids[0], process_name = 'tor'): - print " %s:%s => %s:%s" % (conn.local_address, conn.local_port, conn.remote_address, conn.remote_port) +.. literalinclude:: /_static/example/utilities.py + :caption: `[Download] <../_static/example/utilities.py>`__ + :language: python ::