find_distributions documentation issues
The section "Extending the search algorithm" says that find_distributions
must return an iterable. However, the current implementation actually requires an iteratOR, because it calls next
here. So if someone writes a find_distributions
which returns a list, this will fail.
Separately, the DistributionFinder.Context
.name
attribute is documented as indicating "names to match" (plural). However, it's actually just a single string.
Finally, it says that DistributionFinder.Context
"may supply other relevant context". This is so vague as to be useless. If it's supposed to mean "we may add other properties in the future", isn't that true of any API?