stem's get_consensus().run() always returns a list, but DocumentHandler implies it returns an object
When I read the stem DocumentHandler documentation for DOCUMENT, it syas that it returns a NetworkStatusDocument:
https://stem.torproject.org/api/descriptor/descriptor.html#stem.descriptor.init.DocumentHandler
But when I call:
stem.descriptor.remote.get_consensus(document_handler='DOCUMENT').run()
It actually returns a list of NetworkStatusDocuments with one entry.
I understand why this happens (you might be reading a list of consensuses), but it's confusing.
Please document this behaviour in one or more of get_consensus(), run(), or DocumentHandler DOCUMENT/BARE_DOCUMENT.