o
    i                     @  sb   d Z ddlmZ ddlmZ ddlmZ ddlmZm	Z	 er$ddl
mZ e	 ZdefdddZdS )aY  
    babel.lists
    ~~~~~~~~~~~

    Locale dependent formatting of lists.

    The default locale for the functions in this module is determined by the
    following environment variables, in that order:

     * ``LC_ALL``, and
     * ``LANG``

    :copyright: (c) 2015-2023 by the Babel Team.
    :license: BSD, see LICENSE for more details.
    )annotations)Sequence)TYPE_CHECKING)Localedefault_locale)LiteralstandardlstSequence[str]style\Literal['standard', 'standard-short', 'or', 'or-short', 'unit', 'unit-short', 'unit-narrow']localeLocale | str | Nonereturnstrc                 C  s   t |}| s	dS t| dkr| d S ||jvr)td| d|dt|j d|j| }t| dkr;|d	 j|  S |d
 | d | d }| dd D ]
}|d ||}qM|d || d }|S )u  
    Format the items in `lst` as a list.

    >>> format_list(['apples', 'oranges', 'pears'], locale='en')
    u'apples, oranges, and pears'
    >>> format_list(['apples', 'oranges', 'pears'], locale='zh')
    u'apples、oranges和pears'
    >>> format_list(['omena', 'peruna', 'aplari'], style='or', locale='fi')
    u'omena, peruna tai aplari'

    These styles are defined, but not all are necessarily available in all locales.
    The following text is verbatim from the Unicode TR35-49 spec [1].

    * standard:
      A typical 'and' list for arbitrary placeholders.
      eg. "January, February, and March"
    * standard-short:
      A short version of a 'and' list, suitable for use with short or abbreviated placeholder values.
      eg. "Jan., Feb., and Mar."
    * or:
      A typical 'or' list for arbitrary placeholders.
      eg. "January, February, or March"
    * or-short:
      A short version of an 'or' list.
      eg. "Jan., Feb., or Mar."
    * unit:
      A list suitable for wide units.
      eg. "3 feet, 7 inches"
    * unit-short:
      A list suitable for short units
      eg. "3 ft, 7 in"
    * unit-narrow:
      A list suitable for narrow units, where space on the screen is very limited.
      eg. "3′ 7″"

    [1]: https://www.unicode.org/reports/tr35/tr35-49/tr35-general.html#ListPatterns

    :param lst: a sequence of items to format in to a list
    :param style: the style to format the list with. See above for description.
    :param locale: the locale
        r   zLocale z( does not support list formatting style z (supported are )   2startmiddleend)r   parselenlist_patterns
ValueErrorsortedformat)r	   r   r   patternsresultelem r#   F/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/babel/lists.pyformat_list   s&   
,

r%   N)r	   r
   r   r   r   r   r   r   )__doc__
__future__r   collections.abcr   typingr   
babel.corer   r   typing_extensionsr   DEFAULT_LOCALEr%   r#   r#   r#   r$   <module>   s    