[tor-commits] [stem/master] Deprecate stem.descriptor.export

[atagar at torproject.org]

commit 29e70dfe8af598aa7f54518c92490d32a8a0dd76
Author: Damian Johnson <atagar at torproject.org>
Date:   Fri Sep 7 03:43:27 2018 -0700

    Deprecate stem.descriptor.export
    
    This module was provided by a contributor in stem's early days to export
    descriptors as csvs. I've never used it, and aside from that contributor
    years ago never heard of anyone else using it either.
    
    Lets propose dropping it and see if anyone would mind. Happy to keep it
    if it's useful, but if it isn't seems the very definition of bloat. ;)
---
 docs/change_log.rst       | 1 +
 stem/descriptor/export.py | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/docs/change_log.rst b/docs/change_log.rst
index 9331890c..b91f69b3 100644
--- a/docs/change_log.rst
+++ b/docs/change_log.rst
@@ -79,6 +79,7 @@ The following are only available within Stem's `git repository
   * Don't retry downloading descriptors when we've timed out
   * Don't download from tor26 and Bifroest, which are authorities that frequently timeout
   * `stem.descriptor.remote <api/descriptor/remote.html>`_  now consistently defaults **fall_back_to_authority** to false
+  * Deprecated `stem.descriptor.export <api/descriptor/export.html>`_. If you use it please `let us know <https://www.atagar.com/contact/>`_.
   * Added :func:`~stem.descriptor.remote.their_server_descriptor`
   * Added the reply_headers attribute to :class:`~stem.descriptor.remote.Query`
   * Supplying a User-Agent when downloading descriptors
diff --git a/stem/descriptor/export.py b/stem/descriptor/export.py
index f6d73ebb..c565bfac 100644
--- a/stem/descriptor/export.py
+++ b/stem/descriptor/export.py
@@ -10,6 +10,11 @@ Toolkit for exporting descriptors to other formats.
 
   export_csv - Exports descriptors to a CSV
   export_csv_file - Writes exported CSV output to a file
+
+.. deprecated:: 1.7.0
+
+   This module will likely be removed in Stem 2.0 due to lack of usage. If you
+   use this modle please `let me know <https://www.atagar.com/contact/>`_.
 """
 
 import csv