B
    dh.              
   @  s   d dl mZ d dlZd dlmZ d dlmZ d dlmZm	Z	 erLd dl
mZ G dd deZd	efd
ddddddZefd
dddddZd	defdd
dddd
dddZefd
d
dddddZdddd	defdddddddddddZdS )    )annotationsN)TYPE_CHECKING)Locale)
LC_NUMERICformat_decimal)Literalc               @  s   e Zd ZddddddZdS )UnknownUnitErrorstrr   None)unitlocalereturnc             C  s   t | | d|  d S )Nz is not a known unit in )
ValueError__init__)selfr   r    r   X/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/babel/units.pyr      s    zUnknownUnitError.__init__N)__name__
__module____qualname__r   r   r   r   r   r      s   r   longr	   z$Literal[('short', 'long', 'narrow')]zLocale | str | Nonez
str | None)measurement_unitlengthr   r   c             C  s:   t |}t| |d}|s&t| |d|j|i |S )a  
    Get the display name for a measurement unit in the given locale.

    >>> get_unit_name("radian", locale="en")
    'radians'

    Unknown units will raise exceptions:

    >>> get_unit_name("battery", locale="fi")
    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:
                             https://unicode.org/repos/cldr/tags/latest/common/validity/unit.xml

    :param length: "short", "long" or "narrow"
    :param locale: the `Locale` object or locale identifier
    :return: The unit display name, or None.
    )r   )r   r   )r   parse_find_unit_patternr   Zunit_display_namesget)r   r   r   r   r   r   r   get_unit_name   s
    
r   )unit_idr   r   c             C  sH   t |}|jd }| |kr | S x"t|tdD ]}|| r.|S q.W dS )a  
    Expand an unit into a qualified form.

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

    >>> _find_unit_pattern("radian", locale="en")
    'angle-radian'

    Unknown values will return None.

    >>> _find_unit_pattern("horse", locale="en")

    :param unit_id: the code of a measurement unit.
    :return: A key to the `unit_patterns` mapping, or None.
    unit_patterns)keyN)r   r   _datasortedlenendswith)r   r   r   Zunit_patternr   r   r   r   3   s    


r   zfloat | decimal.Decimal)valuer   r   formatr   r   c       
      C  s   t |}t||d}|s&t||d|jd | |i }t| trP| }d}nt| ||}|	| }||kr||| 
|S t|||d}	| d|	p| S )a  Format a value of a given unit.

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

    >>> format_unit(12, 'length-meter', locale='ro_RO')
    u'12 metri'
    >>> format_unit(15.5, 'length-mile', locale='fi_FI')
    u'15,5 mailia'
    >>> format_unit(1200, 'pressure-millimeter-ofhg', locale='nb')
    u'1\xa0200 millimeter kvikks\xf8lv'
    >>> format_unit(270, 'ton', locale='en')
    u'270 tons'

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

    >>> import decimal
    >>> format_unit(decimal.Decimal("-42.774"), 'temperature-celsius', 'short', format='#.0', locale='fr')
    u'-42,8\u202f\xb0C'

    The locale's usual pluralization rules are respected.

    >>> format_unit(1, 'length-meter', locale='ro_RO')
    u'1 metru'
    >>> format_unit(0, 'length-mile', locale='cy')
    u'0 mi'
    >>> format_unit(1, 'length-mile', locale='cy')
    u'1 filltir'
    >>> format_unit(3, 'length-mile', locale='cy')
    u'3 milltir'

    >>> 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:
                             https://unicode.org/repos/cldr/tags/latest/common/validity/unit.xml
    :param length: "short", "long" or "narrow"
    :param format: An optional format, as accepted by `format_decimal`.
    :param locale: the `Locale` object or locale identifier
    )r   )r   r   r   one)r   r    )r   r   r   r   r    r   
isinstancer	   r   plural_formr%   r   )
r$   r   r   r%   r   Zq_unitr   Zformatted_valuer)   Zfallback_namer   r   r   format_unitM   s    5


r*   )numerator_unitdenominator_unitr   r   c             C  sd   t |}t| |d} t||d}| r*|s.dS | ddd }|ddd }t| d| |dS )a  
    Find a predefined compound unit pattern.

    Used internally by format_compound_unit.

    >>> _find_compound_unit("kilometer", "hour", locale="en")
    'speed-kilometer-per-hour'

    >>> _find_compound_unit("mile", "gallon", locale="en")
    'consumption-mile-per-gallon'

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

    >>> _find_compound_unit("gallon", "mile", locale="en")

    >>> _find_compound_unit("horse", "purple", locale="en")

    :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
    )r   N-   z-per-)r   r   r   split)r+   r,   r   Zbare_numerator_unitZbare_denominator_unitr   r   r   _find_compound_unit   s    
r1   r.   )numerator_valuer+   denominator_valuer,   r   r%   r   r   c             C  s"  t |}|r>|r>|dkr>t|||d}|r>t| ||||dS t| trN| }n&|rft| ||||d}nt| ||d}t|tr|}	np|r|dkrt||d}|jd 	|i 	|i 	d}
|
r|

|S d}t|||||d }	nt|||d}	|jd 	di 	|i 	d	d
}
|

||	S )a  
    Format a compound number value, i.e. "kilometers per hour" or similar.

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

    >>> format_compound_unit(7, denominator_value=11, length="short", locale="pt")
    '7/11'

    >>> format_compound_unit(150, "kilometer", denominator_unit="hour", locale="sv")
    '150 kilometer per timme'

    >>> format_compound_unit(150, "kilowatt", denominator_unit="year", locale="fi")
    '150 kilowattia / vuosi'

    >>> format_compound_unit(32.5, "ton", 15, denominator_unit="hour", locale="en")
    '32.5 tons per 15 hours'

    >>> format_compound_unit(160, denominator_unit="square-meter", locale="fr")
    '160 par m\xe8tre carr\xe9'

    >>> format_compound_unit(4, "meter", "ratakisko", length="short", locale="fi")
    '4 m/ratakisko'

    >>> format_compound_unit(35, "minute", denominator_unit="fathom", locale="sv")
    '35 minuter per famn'

    >>> from babel.numbers import format_currency
    >>> format_compound_unit(format_currency(35, "JPY", locale="de"), denominator_unit="liter", locale="de")
    '35\xa0\xa5 pro Liter'

    See https://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. "short", "long" or "narrow"
    :param format: An optional format, as accepted by `format_decimal`.
    :param locale: the `Locale` object or locale identifier
    :return: A formatted compound value.
    r.   )r   )r   r%   r   )r%   r   r   Zper Zcompound_unit_patternsZcompoundz{0}/{1})r   r   r1   r*   r(   r	   r   r   r    r   r%   strip)r2   r+   r3   r,   r   r%   r   Zcompound_unitZformatted_numeratorZformatted_denominatorZper_patternr   r   r   format_compound_unit   s2    5


 
"r6   )
__future__r   decimaltypingr   Z
babel.corer   Zbabel.numbersr   r   typing_extensionsr   r   r   r   r   r*   r1   r6   r   r   r   r   <module>   s(   J3