Documentation shows private functions

The documentation lists some functions that are not available outside the submodule they are defined in. All of the usage examples use:

import humanize

humanize.…

but this does not allow access to these methods.

These functions should be exported to the parent module.

[hugovk]

Thanks for the PR!

I wonder if we should instead deprecate these (emit DeprecationWarnings) and make them private in the next major release?

(For example, rename gettext to _gettext, call _gettext internally, and have a new gettext that emits the warning and calls _gettext.)

The functions in question:

i18n: gettext and ngettext.

time: abs_timedelta, date_and_delta, Unit

These are all pretty much intended for internal use, that’s probably why they weren’t made fully public.

[hugovk]

Yes, this is what I had in mind, thank you!