
    ̆h5                       S SK Jr  S SKrS SKJr  S SKJr  S SKJrJ	r	   " S S\
5      r  S       SS jjrSSS	 jjr   SS
S.             SS jjjr S       SS jjr      SS
S.                 SS jjjrg)    )annotationsN)Literal)Locale)
LC_NUMERICformat_decimalc                      \ rS rSrSS jrSrg)UnknownUnitError
   c                8    [         R                  X SU 35        g )Nz is not a known unit in )
ValueError__init__)selfunitlocales      C/opt/services/DDDS/venv/lib/python3.13/site-packages/babel/units.pyr   UnknownUnitError.__init__   s    DF*B6("KL     N)r   strr   r   returnNone)__name__
__module____qualname____firstlineno__r   __static_attributes__r   r   r   r	   r	   
   s    Mr   r	   c                    [         R                  " U=(       d    [        5      n[        XS9nU(       d	  [	        XS9eUR
                  R                  U0 5      R                  U5      $ )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   )r   parser   _find_unit_patternr	   unit_display_namesget)measurement_unitlengthr   r   s       r   get_unit_namer&      sU    4 \\&.J/F.>D$4DD$$((r266v>>r   c                    [         R                  " U=(       d    [        5      nUR                  S   nX;   a  U $ [	        U[
        S9 H  nUR                  U 5      (       d  M  Us  $    g)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)r   r    r   _datasortedlenendswith)unit_idr   r(   unit_patterns       r   r!   r!   0   s]    " \\&.J/F$*LL$AM}#6  )) 7 r   latnnumbering_systemc                  [         R                  " U=(       d    [        5      n[        XS9nU(       d	  [	        XS9eUR
                  S   U   R                  U0 5      n[        U [        5      (       a  U nSn	O[        XXES9nUR                  U 5      n	X;   a  Xy   R                  U5      $ [        XUS9n
U SU
=(       d    U 3$ )u  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'
>>> 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.
r   r   r(   oner1   )r%   r    )r   r    r   r!   r	   r*   r#   
isinstancer   r   plural_formformatr&   )valuer$   r%   r8   r   r2   q_unitr(   formatted_valuer7   fallback_names              r   format_unitr=   K   s    x \\&.J/F 0@F$4DDLL1&9==fbIM%(b((/#)00AA ""2&QMa A1ABCCr   c                    [         R                  " U=(       d    [        5      n[        XS9n[        XS9nU(       a  U(       d  gUR	                  SS5      S   nUR	                  SS5      S   n[        U SU 3US9$ )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
r   N-   z-per-)r   r    r   r!   split)numerator_unitdenominator_unitr   resolved_numerator_unitresolved_denominator_unitbare_numerator_unitbare_denominator_units          r   _find_compound_unitrI      s    8 \\&.J/F 1O 23C S $(A
 277Q?C5;;CCBG !4 5U;P:QR[abbr   c          	     2   [         R                  " U=(       d    [        5      nU(       a,  U(       a%  US:X  a  [        XUS9nU(       a  [	        U UUUUUS9$ [        U [        5      (       a  U n	O"U(       a  [	        U UUUUUS9n	O[        U UUUS9n	[        U[        5      (       a  Un
OU(       a  US:X  aa  [        X6S9nUR                  S   R                  U0 5      R                  U0 5      R                  S5      nU(       a  UR                  U	5      $ Sn[	        UU=(       d    SUUUUS9R                  5       n
O[        UUUUS9n
UR                  S	   R                  S0 5      R                  U0 5      R                  S
S5      nUR                  X5      $ )uA	  
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.
r@   r   )r%   r8   r   r2   )r8   r   r2   r(   per )r$   r%   r8   r   r2   compound_unit_patternscompoundz{0}/{1})r   r    r   rI   r=   r6   r   r   r!   r*   r#   r8   strip)numerator_valuerC   denominator_valuerD   r%   r8   r   r2   compound_unitformatted_numeratorformatted_denominatorper_patterns               r   format_compound_unitrV      s   z \\&.J/F */@A/E+NU[\!1  /3''-	)-
 --	
 #S)) 1	!12BR ,,7;;<LbQUUV\^`aeefklK"))*=>> !# +.4"-!
 %' 	 !/-	!
 ,,78<<UBGKKFTVW[[\fhqrK1IIr   )longN)r$   r   r%   "Literal['short', 'long', 'narrow']r   Locale | str | Noner   
str | None)N)r.   r   r   rY   r   rZ   )rW   NN)r9   str | float | decimal.Decimalr$   r   r%   rX   r8   rZ   r   rY   r2   Literal['default'] | strr   r   )rC   r   rD   r   r   rY   r   rZ   )Nr@   NrW   NN)rP   r[   rC   rZ   rQ   r[   rD   rZ   r%   rX   r8   rZ   r   rY   r2   r\   r   rZ   )
__future__r   decimaltypingr   
babel.corer   babel.numbersr   r   r   r	   r&   r!   r=   rI   rV   r   r   r   <module>rb      s   "    4Mz M 28"&??.?  ? 	?B< 28"&PD 28PD(PDPD /PD 	PD
  PD /PD 	PDl #'1c1c1c  1c 	1cl "&78#'17"&BJ 28BJ2BJBJ 5BJ !	BJ
 /BJ BJ  BJ /BJ BJr   