sphinx_autodoc_suggestion.py

# Re - https://pypi.org/project/sphinx-autodoc-typehints/
# Re - https://www.reddit.com/r/Python/comments/hcc7d9/any_emerging_peps_on_unifying_type_hints_with_doc/

from typing import Union

def format_unit(
    value: Union[float, int]  # a numeric value, 
    unit: str                 # the unit for the value (kg, m, etc.)
) -> str:
    """
    Formats the given value as a human readable string using the given units.
    """
    return '{} {}'.format(value, unit)