[tor-talk] Stem Release 1.1

Damian Johnson atagar at torproject.org
Mon Oct 14 16:13:18 UTC 2013

Hi all. After seven months of work I'm pleased to announce Stem's 1.1.0 release!

For those who aren't familiar with it, Stem is a Python library for
interacting with Tor. With it you can script against your relay,
descriptor data, or even write applications similar to arm and


So what's new in this release?


* Remote Descriptor Fetching

The stem.descriptor.remote module allows you download current Tor
descriptor data from directory authorities and mirrors, much like Tor
itself does. With this you can easily check the status of the network
without piggybacking on a local instance of Tor (or even having it


For example...

from stem.descriptor.remote import DescriptorDownloader

downloader = DescriptorDownloader()

  for desc in downloader.get_consensus().run():
    print "found relay %s (%s)" % (desc.nickname, desc.fingerprint)
except Exception as exc:
  print "Unable to retrieve the consensus: %s" % exc


* Connection Resolution

One of arm's most popular features has been its ability to monitor
Tor's connections, and stem can now do the same! Lookups are performed
via seven *nix and FreeBSD resolvers, for more information and an
example see...



* Numerous Features and Fixes

For a rundown of other changes see...


Cheers! -Damian

More information about the tor-talk mailing list