U [Sh5 @sddlmZddlZddlmZddlmZddlmZm Z Gddde Z d!d d d d d ddZ d"d d d dddZ d#dddd d d d dd dddZd$d d d d dddZd%dddd dd d d d dd d dd ZdS)&) annotationsN)Literal)Locale) LC_NUMERICformat_decimalc@seZdZddddddZdS)UnknownUnitErrorstrrNone)unitlocalereturncCst||d|dS)Nz is not a known unit in ) ValueError__init__)selfr r r>/root/rtd-docs/venv/lib/python3.8/site-packages/babel/units.pyr szUnknownUnitError.__init__N)__name__ __module__ __qualname__rrrrrr srlongrz$Literal[('short', 'long', 'narrow')]zLocale | str | Nonez str | None)measurement_unitlengthr r cCs>t|p 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. Defaults to the system numeric locale. :return: The unit display name, or None. r r r )rparser_find_unit_patternrZunit_display_namesget)rrr r rrr get_unit_names   r)unit_idr r cCsLt|p t}|jd}||kr$|St|tdD]}||r0|Sq0dS)a Expand a 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)rrr_datasortedlenendswith)rr rZ unit_patternrrrr0s   rZlatnnumbering_systemzstr | float | decimal.DecimalzLiteral['default'] | str)valuerrformatr r&r c Cst|p t}t||d}|s*t||d|jd||i}t|trT|}d} nt ||||d}| |} | |kr||  |St |||d} |d| p|S)uFormat 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' >>> format_unit(1234.5, 'kilogram', locale='ar_EG', numbering_system='default') u'1٬234٫5 كيلوغرام' 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. Defaults to the system numeric locale. :param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn". The special value "default" will use the default numbering system of the locale. :raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale. rrroner%)rr  ) rrrrrr!r isinstancerr plural_formr(r) r'rrr(r r&Zq_unitrZformatted_valuer,Z fallback_namerrr format_unitKs<    r-)numerator_unitdenominator_unitr r cCsht|p t}t||d}t||d}|r.|s2dS|ddd}|ddd}t|d||dS)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. Defaults to the system numeric locale. :return: A key to the `unit_patterns` mapping, or None. :rtype: str|None rN-z-per-)rrrrsplit)r.r/r Zresolved_numerator_unitZresolved_denominator_unitZbare_numerator_unitZbare_denominator_unitrrr_find_compound_units  r4r1) numerator_valuer.denominator_valuer/rr(r r&r c Cs4t|p t}|rD|rD|dkrDt|||d}|rDt||||||dSt|trT|} n*|rnt||||||d} nt||||d} t|tr|} nx|r|dkrt||d}|j d |i |i d} | r| | Sd}t||pd||||d } nt||||d} |j d  di |i d d } | | | S) u 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(1234.5, "ton", 15, denominator_unit="hour", locale="ar_EG", numbering_system="arab") '1٬234٫5 طن لكل 15 ساعة' >>> 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="nautical-mile", locale="sv") '35 minuter per nautisk mil' >>> 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. Defaults to the system numeric locale. :param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn". The special value "default" will use the default numbering system of the locale. :return: A formatted compound value. :raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale. r1r)rr(r r&)r(r r&rZper)rrr(r r&Zcompound_unit_patternsZcompoundz{0}/{1}) rrrr4r-r+rrrr!rr(strip) r5r.r6r/rr(r r&Z compound_unitZformatted_numeratorZformatted_denominatorZ per_patternrrrformat_compound_unitsl=       "r9)rN)N)rNN)N)Nr1NrNN) __future__rdecimaltypingrZ babel.corerZ babel.numbersrrr rrrr-r4r9rrrrs4   !V6