[tor-commits] [stem/master] Remote descriptor fetching module

[atagar at torproject.org]

commit 7f050ebfa475aeb39f6b1b4a0f7ad53620931646
Merge: b6c23b0 713b046
Author: Damian Johnson <atagar at 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(-)