commit 7f050ebfa475aeb39f6b1b4a0f7ad53620931646 Merge: b6c23b0 713b046 Author: Damian Johnson atagar@torproject.org Date: Sun Jul 21 18:39:17 2013 -0700

Remote descriptor fetching module

What started as a tor-dev@ thread has finally accumulated in a surprisingly simple module. This provides the ability to download tor descriptors from directory mirrors or authorities, and is made of up of two classes...

* Query

The core of the module. This is a request to download a given descriptor resource from a pool of authorities and/or mirrors. This retries failed requests and can be iterated over to get the descriptor results.

* DescriptorDownloader

A configurable class for issuing Queries. This provides only two things: simple methods to get common descriptor types, and an easy way of specifying default Query parameters.

https://lists.torproject.org/pipermail/tor-dev/2013-May/004924.html https://trac.torproject.org/8257

docs/api.rst | 5 +- docs/api/descriptor/remote.rst | 5 + docs/contents.rst | 1 + stem/control.py | 4 +- stem/descriptor/__init__.py | 21 +- stem/descriptor/extrainfo_descriptor.py | 18 +- stem/descriptor/microdescriptor.py | 13 +- stem/descriptor/networkstatus.py | 71 +++- stem/descriptor/remote.py | 581 +++++++++++++++++++++++++++++ stem/descriptor/router_status_entry.py | 16 +- stem/descriptor/server_descriptor.py | 29 +- test/integ/descriptor/remote.py | 210 +++++++++++ test/runner.py | 1 + test/settings.cfg | 4 +- test/unit/descriptor/remote.py | 125 +++++++ test/unit/descriptor/server_descriptor.py | 8 +- 16 files changed, 1056 insertions(+), 56 deletions(-)