split_unit

justunits.split_unit(text: str, allowed_separators: Optional[justunits.AttributeUnitSeparators] = None, converter: Optional[Callable[[str], Any]] = None) → Tuple[str, Union[justunits.AUnit, justunits.UnknownUnit]]

Splits an attribute/value with a trailing unit.

Parameters

  • text – Text containing an attribute/value-unit pair.

  • allowed_separators – The separators which should be taken into account for splitting.

  • converter – A callable converting a string into the desired object. A failed conversion must raise a ValueError. Default is str.

Returns

Tuple[str, Union[AUnit, UnknownUnit]]

Examples

>>> import justunits
>>> justunits.split_unit("1 apple", converter=int)
(1, (AUnit(apple 'apple' fruit),))