tools.time feature: "Raw" mode for seconds_to_human()

[dgw]

It's cute that tools.time.seconds_to_human() takes care of the future/past grammar for you (adding "in " to the front or " ago" to the back, depending on the delta's sign). But it makes using that function really annoying in some cases, when it should be the perfect tool.

For the use cases I'm looking at, the most useful thing would be a "raw" mode that returns the intermediate list of units, rather than the fully-formatted string. In implementing this, we could actually simplify the code around here and eliminate the split(', ') below it:

sopel/sopel/tools/time.py

Lines 243 to 250 in 3959137

	result = ", ".join(filter(lambda x: bool(x), [
	"{0} {1}".format(years, years_text) if years else "",
	"{0} {1}".format(months, months_text) if months else "",
	"{0} {1}".format(days, days_text) if days else "",
	"{0} {1}".format(hours, hours_text) if hours else "",
	"{0} {1}".format(minutes, minutes_text) if minutes else "",
	"{0} {1}".format(seconds, seconds_text) if seconds else ""
	]))

Related: #1798, #1799. Not all of these will necessarily be implemented. Right now they're all just ideas, and picking the right one or two could make the API flexible and intuitive enough that we don't need to bake every little feature into it.

[dgw]

This actually should be low-hanging fruit, and I'll self-assign it for the last two weeks of Hacktoberfest to (hopefully) motivate myself to take care of it.

[Exirel]

I did that for you.

[dgw]

Aww, I forgot about this one after all. 😩