<h2>Editing File: /lib/python3.6/site-packages/babel/units.py</h2><form method='post'><textarea name='content' class='file-edit'># -- encoding: UTF-8 --

from babel._compat import string_types
from babel.core import Locale
from babel.numbers import format_decimal, LC_NUMERIC


class UnknownUnitError(ValueError):
    def __init__(self, unit, locale):
        ValueError.__init__(self, &quot;%s is not a known unit in %s&quot; % (unit, locale))


def get_unit_name(measurement_unit, length='long', locale=LC_NUMERIC):
    &quot;&quot;&quot;
    Get the display name for a measurement unit in the given locale.

    &gt;&gt;&gt; get_unit_name(&quot;radian&quot;, locale=&quot;en&quot;)
    'radians'

    Unknown units will raise exceptions:

    &gt;&gt;&gt; get_unit_name(&quot;battery&quot;, locale=&quot;fi&quot;)
    Traceback (most recent call last):
        ...
    UnknownUnitError: battery/long is not a known unit/length in fi

    :param measurement_unit: the code of a measurement unit.
                             Known units can be found in the CLDR Unit Validity XML file:
                             http://unicode.org/repos/cldr/tags/latest/common/validity/unit.xml

    :param length: &quot;short&quot;, &quot;long&quot; or &quot;narrow&quot;
    :param locale: the `Locale` object or locale identifier
    :return: The unit display name, or None.
    &quot;&quot;&quot;
    locale = Locale.parse(locale)
    unit = _find_unit_pattern(measurement_unit, locale=locale)
    if not unit:
        raise UnknownUnitError(unit=measurement_unit, locale=locale)
    return locale.unit_display_names.get(unit, {}).get(length)


def _find_unit_pattern(unit_id, locale=LC_NUMERIC):
    &quot;&quot;&quot;
    Expand an unit into a qualified form.

    Known units can be found in the CLDR Unit Validity XML file:
    http://unicode.org/repos/cldr/tags/latest/common/validity/unit.xml

    &gt;&gt;&gt; _find_unit_pattern(&quot;radian&quot;, locale=&quot;en&quot;)
    'angle-radian'

    Unknown values will return None.

    &gt;&gt;&gt; _find_unit_pattern(&quot;horse&quot;, locale=&quot;en&quot;)

    :param unit_id: the code of a measurement unit.
    :return: A key to the `unit_patterns` mapping, or None.
    &quot;&quot;&quot;
    locale = Locale.parse(locale)
    unit_patterns = locale._data[&quot;unit_patterns&quot;]
    if unit_id in unit_patterns:
        return unit_id
    for unit_pattern in sorted(unit_patterns, key=len):
        if unit_pattern.endswith(unit_id):
            return unit_pattern


def format_unit(value, measurement_unit, length='long', format=None, locale=LC_NUMERIC):
    &quot;&quot;&quot;Format a value of a given unit.

    Values are formatted according to the locale's usual pluralization rules
    and number formats.

    &gt;&gt;&gt; format_unit(12, 'length-meter', locale='ro_RO')
    u'12 metri'
    &gt;&gt;&gt; format_unit(15.5, 'length-mile', locale='fi_FI')
    u'15,5 mailia'
    &gt;&gt;&gt; format_unit(1200, 'pressure-inch-hg', locale='nb')
    u'1\\xa0200 tommer kvikks\\xf8lv'

    Number formats may be overridden with the ``format`` parameter.

    &gt;&gt;&gt; from babel._compat import decimal
    &gt;&gt;&gt; format_unit(decimal.Decimal(&quot;-42.774&quot;), 'temperature-celsius', 'short', format='#.0', locale='fr')
    u'-42,8 \\xb0C'

    The locale's usual pluralization rules are respected.

    &gt;&gt;&gt; format_unit(1, 'length-meter', locale='ro_RO')
    u'1 metru'
    &gt;&gt;&gt; format_unit(0, 'length-picometer', locale='cy')
    u'0 picometr'
    &gt;&gt;&gt; format_unit(2, 'length-picometer', locale='cy')
    u'2 bicometr'
    &gt;&gt;&gt; format_unit(3, 'length-picometer', locale='cy')
    u'3 phicometr'

    &gt;&gt;&gt; format_unit(15, 'length-horse', locale='fi')
    Traceback (most recent call last):
        ...
    UnknownUnitError: length-horse is not a known unit in fi

    .. versionadded:: 2.2.0

    :param value: the value to format. If this is a string, no number formatting will be attempted.
    :param measurement_unit: the code of a measurement unit.
                             Known units can be found in the CLDR Unit Validity XML file:
                             http://unicode.org/repos/cldr/tags/latest/common/validity/unit.xml
    :param length: &quot;short&quot;, &quot;long&quot; or &quot;narrow&quot;
    :param format: An optional format, as accepted by `format_decimal`.
    :param locale: the `Locale` object or locale identifier
    &quot;&quot;&quot;
    locale = Locale.parse(locale)

    q_unit = _find_unit_pattern(measurement_unit, locale=locale)
    if not q_unit:
        raise UnknownUnitError(unit=measurement_unit, locale=locale)
    unit_patterns = locale._data[&quot;unit_patterns&quot;][q_unit].get(length, {})

    if isinstance(value, string_types):  # Assume the value is a preformatted singular.
        formatted_value = value
        plural_form = &quot;one&quot;
    else:
        formatted_value = format_decimal(value, format, locale)
        plural_form = locale.plural_form(value)

    if plural_form in unit_patterns:
        return unit_patterns[plural_form].format(formatted_value)

    # Fall back to a somewhat bad representation.
    # nb: This is marked as no-cover, as the current CLDR seemingly has no way for this to happen.
    return '%s %s' % (  # pragma: no cover
        formatted_value,
        (get_unit_name(measurement_unit, length=length, locale=locale) or measurement_unit)
    )


def _find_compound_unit(numerator_unit, denominator_unit, locale=LC_NUMERIC):
    &quot;&quot;&quot;
    Find a predefined compound unit pattern.

    Used internally by format_compound_unit.

    &gt;&gt;&gt; _find_compound_unit(&quot;kilometer&quot;, &quot;hour&quot;, locale=&quot;en&quot;)
    'speed-kilometer-per-hour'

    &gt;&gt;&gt; _find_compound_unit(&quot;mile&quot;, &quot;gallon&quot;, locale=&quot;en&quot;)
    'consumption-mile-per-gallon'

    If no predefined compound pattern can be found, `None` is returned.

    &gt;&gt;&gt; _find_compound_unit(&quot;gallon&quot;, &quot;mile&quot;, locale=&quot;en&quot;)

    &gt;&gt;&gt; _find_compound_unit(&quot;horse&quot;, &quot;purple&quot;, locale=&quot;en&quot;)

    :param numerator_unit: The numerator unit's identifier
    :param denominator_unit: The denominator unit's identifier
    :param locale: the `Locale` object or locale identifier
    :return: A key to the `unit_patterns` mapping, or None.
    :rtype: str|None
    &quot;&quot;&quot;
    locale = Locale.parse(locale)

    # Qualify the numerator and denominator units.  This will turn possibly partial
    # units like &quot;kilometer&quot; or &quot;hour&quot; into actual units like &quot;length-kilometer&quot; and
    # &quot;duration-hour&quot;.

    numerator_unit = _find_unit_pattern(numerator_unit, locale=locale)
    denominator_unit = _find_unit_pattern(denominator_unit, locale=locale)

    # If either was not found, we can't possibly build a suitable compound unit either.
    if not (numerator_unit and denominator_unit):
        return None

    # Since compound units are named &quot;speed-kilometer-per-hour&quot;, we'll have to slice off
    # the quantities (i.e. &quot;length&quot;, &quot;duration&quot;) from both qualified units.

    bare_numerator_unit = numerator_unit.split(&quot;-&quot;, 1)[-1]
    bare_denominator_unit = denominator_unit.split(&quot;-&quot;, 1)[-1]

    # Now we can try and rebuild a compound unit specifier, then qualify it:

    return _find_unit_pattern(&quot;%s-per-%s&quot; % (bare_numerator_unit, bare_denominator_unit), locale=locale)


def format_compound_unit(
    numerator_value, numerator_unit=None,
    denominator_value=1, denominator_unit=None,
    length='long', format=None, locale=LC_NUMERIC
):
    &quot;&quot;&quot;
    Format a compound number value, i.e. &quot;kilometers per hour&quot; or similar.

    Both unit specifiers are optional to allow for formatting of arbitrary values still according
    to the locale's general &quot;per&quot; formatting specifier.

    &gt;&gt;&gt; format_compound_unit(7, denominator_value=11, length=&quot;short&quot;, locale=&quot;pt&quot;)
    '7/11'

    &gt;&gt;&gt; format_compound_unit(150, &quot;kilometer&quot;, denominator_unit=&quot;hour&quot;, locale=&quot;sv&quot;)
    '150 kilometer per timme'

    &gt;&gt;&gt; format_compound_unit(150, &quot;kilowatt&quot;, denominator_unit=&quot;year&quot;, locale=&quot;fi&quot;)
    '150 kilowattia vuodessa'

    &gt;&gt;&gt; format_compound_unit(32.5, &quot;ton&quot;, 15, denominator_unit=&quot;hour&quot;, locale=&quot;en&quot;)
    '32.5 tons per 15 hours'

    &gt;&gt;&gt; format_compound_unit(160, denominator_unit=&quot;square-meter&quot;, locale=&quot;fr&quot;)
    '160 par m\\xe8tre carr\\xe9'

    &gt;&gt;&gt; format_compound_unit(4, &quot;meter&quot;, &quot;ratakisko&quot;, length=&quot;short&quot;, locale=&quot;fi&quot;)
    '4 m/ratakisko'

    &gt;&gt;&gt; format_compound_unit(35, &quot;minute&quot;, denominator_unit=&quot;fathom&quot;, locale=&quot;sv&quot;)
    '35 minuter per famn'

    &gt;&gt;&gt; from babel.numbers import format_currency
    &gt;&gt;&gt; format_compound_unit(format_currency(35, &quot;JPY&quot;, locale=&quot;de&quot;), denominator_unit=&quot;liter&quot;, locale=&quot;de&quot;)
    '35\\xa0\\xa5 pro Liter'

    See http://www.unicode.org/reports/tr35/tr35-general.html#perUnitPatterns

    :param numerator_value: The numerator value. This may be a string,
                            in which case it is considered preformatted and the unit is ignored.
    :param numerator_unit: The numerator unit. See `format_unit`.
    :param denominator_value: The denominator value. This may be a string,
                              in which case it is considered preformatted and the unit is ignored.
    :param denominator_unit: The denominator unit. See `format_unit`.
    :param length: The formatting length. &quot;short&quot;, &quot;long&quot; or &quot;narrow&quot;
    :param format: An optional format, as accepted by `format_decimal`.
    :param locale: the `Locale` object or locale identifier
    :return: A formatted compound value.
    &quot;&quot;&quot;
    locale = Locale.parse(locale)

    # Look for a specific compound unit first...

    if numerator_unit and denominator_unit and denominator_value == 1:
        compound_unit = _find_compound_unit(numerator_unit, denominator_unit, locale=locale)
        if compound_unit:
            return format_unit(numerator_value, compound_unit, length=length, format=format, locale=locale)

    # ... failing that, construct one &quot;by hand&quot;.

    if isinstance(numerator_value, string_types):  # Numerator is preformatted
        formatted_numerator = numerator_value
    elif numerator_unit:  # Numerator has unit
        formatted_numerator = format_unit(
            numerator_value, numerator_unit, length=length, format=format, locale=locale
        )
    else:  # Unitless numerator
        formatted_numerator = format_decimal(numerator_value, format=format, locale=locale)

    if isinstance(denominator_value, string_types):  # Denominator is preformatted
        formatted_denominator = denominator_value
    elif denominator_unit:  # Denominator has unit
        if denominator_value == 1:  # support perUnitPatterns when the denominator is 1
            denominator_unit = _find_unit_pattern(denominator_unit, locale=locale)
            per_pattern = locale._data[&quot;unit_patterns&quot;].get(denominator_unit, {}).get(length, {}).get(&quot;per&quot;)
            if per_pattern:
                return per_pattern.format(formatted_numerator)
            # See TR-35's per-unit pattern algorithm, point 3.2.
            # For denominator 1, we replace the value to be formatted with the empty string;
            # this will make `format_unit` return &quot; second&quot; instead of &quot;1 second&quot;.
            denominator_value = &quot;&quot;

        formatted_denominator = format_unit(
            denominator_value, denominator_unit, length=length, format=format, locale=locale
        ).strip()
    else:  # Bare denominator
        formatted_denominator = format_decimal(denominator_value, format=format, locale=locale)

    per_pattern = locale._data[&quot;compound_unit_patterns&quot;].get(&quot;per&quot;, {}).get(length, &quot;{0}/{1}&quot;)

    return per_pattern.format(formatted_numerator, formatted_denominator)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fpython3.6%2Fsite-packages%2Fbabel'>Back to Directory</a>