Good options itemization!
>> This would give us a clean, fast API with no flags:
>> mode(Iterable) -> scalar
>> multimode(Iterable) -> list
[...]
>> For any of those options, we should still add a separate multimode()
>> function.
[..]
>> * Add a Deprecation warning to the current behavior of mode() when it
>> finds multimodal data. Then change the behavior in Python 3.9. This
>> is uncomfortable for one release, but does get us to the cleanest API
>> and best performance.
LGTM upto 3.9, shouldn't be "mode" at some point be replaced by
"multimode" ? |