Opened 2 years ago

Closed 2 years ago

#24705 closed defect (fixed)

stem's get_consensus().run() always returns a list, but DocumentHandler implies it returns an object

Reported by: teor Owned by: atagar
Priority: Medium Milestone:
Component: Archived/Stem Version:
Severity: Normal Keywords:
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:


When I read the stem DocumentHandler documentation for DOCUMENT, it syas that it returns a NetworkStatusDocument:

But when I call:


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.

Child Tickets

Change History (1)

comment:1 Changed 2 years ago by atagar

Resolution: fixed
Status: newclosed

Hi Tim. I certainly understand the confusion. Added a bit to explain it...

Note: See TracTickets for help on using tickets.