a
     ˜ëjö-  ã                   @  sZ  U d Z ddlmZ ddlZddlmZ ddlmZmZm	Z	m
Z
mZmZ ddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZ dd	„ d
d	„ gZG dd„ deƒZedd�G dd„ dƒƒZ edd�G dd„ dƒƒZ!dddœdd„Z"d+dddddœdd„Z#d,dddddœdd „Z$ddd!œd"d#„Z%d$d%œd&d'„Z&e&ƒ Z'd$e(d(< e)e' *¡ ƒZ+d)e(d*< dS )-zThe Language class.é    )ÚannotationsN)Ú	dataclass)ÚDictÚListÚNoReturnÚOptionalÚUnionÚSeté   )Ú_PART3_TO_CODESÚ_PART3_TO_NAME_INDEXÚ_PART3_TO_MACROLANGUAGESÚ_PART3_TO_RETIREMENTSÚ_PART2B_TO_PART3Ú_PART2T_TO_PART3Ú_PART1_TO_PART3Ú_REF_NAME_TO_PART3Ú_PRINT_NAME_TO_PART3Ú_INVERTED_NAME_TO_PART3Ú_CodesColumnÚ_NameIndexColumnÚ_RetirementsColumnÚ_MacrolanguagesColumnÚ_COLUMN_TYPEc                 C  s   |   ¡  ¡ S ©N)ÚstripÚlower©Úx© r   úN/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/iso639/language.pyÚ<lambda>   ó    r!   c                 C  s   |   ¡  ¡ S r   )r   Útitler   r   r   r    r!      r"   c                   @  s   e Zd ZdS )ÚLanguageNotFoundErrorN)Ú__name__Ú
__module__Ú__qualname__r   r   r   r    r$   #   s   r$   T)Úfrozenc                   @  s&   e Zd ZU dZdZded< ded< dS )ÚNamez-Represents an alternative name of a language.)ÚprintÚinvertedÚstrr*   r+   N)r%   r&   r'   Ú__doc__Ú	__slots__Ú__annotations__r   r   r   r    r)   '   s   
r)   c                   @  s*  e Zd ZU dZdZded< ded< ded< ded< ded	< ded
< ded< ded< ded< ded< ded< ded< ded< ded< ded< ddœdd„Zddœdd„Zeddœddd dœd d!„ƒZ	edd d"œd#d$„ƒZ
edd d"œd%d&„ƒZedd d"œd'd(„ƒZedd d"œd)d*„ƒZedd d"œd+d,„ƒZd-S ).ÚLanguagez.Represents a language in the ISO 639-3 charts.©Úpart3Úpart2bÚpart2tÚpart1ÚscopeÚtypeÚstatusÚnameÚcommentÚother_namesÚmacrolanguageÚretire_reasonÚretire_change_toÚretire_remedyÚretire_dater,   r2   zUnion[str, None]r3   r4   r5   r6   r7   r8   r9   r:   zUnion[List[Name], None]r;   r<   r=   r>   r?   zUnion[datetime.date, None]r@   Úint©Úreturnc                 C  s
   t | jƒS r   )Úhashr2   )Úselfr   r   r    Ú__hash__f   s    zLanguage.__hash__Úboolc                 C  s   t |tƒo| j|jkS r   )Ú
isinstancer0   r2   )rE   Úotherr   r   r    Ú__eq__i   s    zLanguage.__eq__F)Úexact)Ú
user_inputrK   rC   c               C  s4   t jt jt jt jtjt jtjtj	g}t
t|||ƒ S )a1  Return a ``Language`` instance by matching on the user input.

        Parameters
        ----------
        user_input : str
            A language code or name.
        exact : bool, optional
            Whether to enforce exact matching against the user input.
            Defaults to `False`. If `False`, matching is case-insensitive
            and ignores leading/trailing whitespace.

        Returns
        -------
        Language

        Notes
        -----
        At a high level, `Language.match` assumes the input is more likely to be
        a language code rather than a language name.
        Beyond that, the precise order in matching is as follows:

        * ISO 639-3 codes (among the active codes)
        * ISO 639-2 (bibliographic) codes
        * ISO 639-2 (terminological) codes
        * ISO 639-1 codes
        * ISO 639-3 codes (among the retired codes)
        * ISO 639-3 reference language names
        * ISO 639-3 alternative language names (the "print" ones)
        * ISO 639-3 alternative language names (the "inverted" ones)
        )r   ÚIDÚPART2BÚPART2TÚPART1r   ÚREF_NAMEr   Ú
PRINT_NAMEÚINVERTED_NAMEÚ_PART3_TO_LANGUAGESÚ
_get_part3)ÚclsrL   rK   Úquery_orderr   r   r    Úmatchl   s    $ø
zLanguage.match©rL   rC   c                C  s   t t|tjtjgƒ S )z6Return a ``Language`` instance from an ISO 639-3 code.)rT   Ú_get_part3_exactr   rM   r   ©rV   rL   r   r   r    Ú
from_part3›   s    ÿzLanguage.from_part3c                C  s   t t|tjgƒ S )zFReturn a ``Language`` instance from an ISO 639-2 (bibliographic) code.)rT   rZ   r   rN   r[   r   r   r    Úfrom_part2b¢   s    zLanguage.from_part2bc                C  s   t t|tjgƒ S )zGReturn a ``Language`` instance from an ISO 639-2 (terminological) code.)rT   rZ   r   rO   r[   r   r   r    Úfrom_part2t§   s    zLanguage.from_part2tc                C  s   t t|tjgƒ S )z6Return a ``Language`` instance from an ISO 639-1 code.)rT   rZ   r   rP   r[   r   r   r    Ú
from_part1¬   s    zLanguage.from_part1c                C  s   t jtjtjg}tt||ƒ S )zIReturn a ``Language`` instance from an ISO 639-3 reference language name.)r   rQ   r   rR   rS   rT   rZ   )rV   rL   rW   r   r   r    Ú	from_name±   s
    ýzLanguage.from_nameN)r%   r&   r'   r-   r.   r/   rF   rJ   ÚclassmethodrX   r\   r]   r^   r_   r`   r   r   r   r    r0   0   s>   
.r0   r,   r   rY   c                 C  s   t | ›d�ƒ‚d S )Nz# isn't an ISO language code or name)r$   )rL   r   r   r    Ú_raise_language_not_found_error¼   s    rb   zList[_COLUMN_TYPE]rG   )rL   rW   rK   rC   c                 C  sŒ   zt | |ƒW S  ty† } zb|r&|‚nLtD ]>}z"t || ƒ|| ƒW   W  Y d}~S  tyf   Y q*Y q*0 q*t| ƒ W Y d}~n
d}~0 0 dS )a  Get the part 3 code of a language.

    Parameters
    ----------
    user_input : str
        The user-provided language code or name.
    query_order : List[_COLUMN_TYPE]
        A list of columns to specify query order.
    exact : bool, optional
        Whether to enforce exact matching against the user input. Defaults to `True`.
        If `False`, basic string cleaning is applied to the user input.

    Returns
    -------
    str

    Raises
    ------
    LanguageNotFoundError
        If `part3` isn't a language name or code
    N)rZ   r$   Ú_STRING_CLEANING_FUNCSrb   )rL   rW   rK   ÚeÚfuncr   r   r    rU   À   s    "rU   zOptional[str])rL   rW   Úoriginal_user_inputrC   c                 C  sü   d}|D ]Ú}|t jkr(| tv rÖ|   S n®|t jkr>t | ¡}n˜|t jkrTt | ¡}n‚|t jkrjt	 | ¡}nl|t
jkr†| tv rÖ|   S nP|t jkrœt | ¡}n:|tjkr²t | ¡}n$|tjkrÈt | ¡}ntd|› �ƒ‚|dur qäq|du røt|pô| ƒ |S )a  Get the part 3 code of a language.

    Parameters
    ----------
    user_input : str
        The user-provided language code or name.
    query_order : List[_COLUMN_TYPE]
        A list of columns to specify query order.
    original_user_input : str, optional
        The original user input. Default is `None`.
        This argument is used when the user input has been cleaned.

    Returns
    -------
    str

    Raises
    ------
    LanguageNotFoundError
        If `part3` isn't a language name or code
    NzInvalid column: )r   rM   r   rN   r   ÚgetrO   r   rP   r   r   r   rQ   r   r   rR   r   rS   r   Ú
ValueErrorrb   )rL   rW   rf   r2   Úcolumnr   r   r    rZ   ç   s4    









rZ   )r2   rC   c                 C  sÈ  t  | ¡}t | ¡}t | ¡}|r,|tj n|tj }g }t | g ¡D ]@}|tj	 |tj
  }}||  krt|ksFn | t||ƒ¡ qF|pŽd}|p–i  tj¡}	|p¦i  tj¡}
|p¶i  tj¡}|pÆi  tj¡}|rìtj |tj d¡ ¡ nd}|�r<|tj }|tj }|tj }|tj }|tj }d}|}|tj }n d}d}d}d}d}d}|}d}t| |�phd|�ppd|�pxd||�p‚d|||�pŽd|�p–d|	�pžd|
�p¦d|�p®d|�p¶d|�p¾dd�}|S )zžCreate a ``Language`` instance.

    Parameters
    ----------
    part3 : str
        Part 3 code of the language.

    Returns
    -------
    Language
    Nz%Y-%m-%dÚAÚIÚRr1   )r   rg   r   r   r   rQ   r   r   r   rR   rS   Úappendr)   r   ZMIDZ
RET_REASONZ	CHANGE_TOZREMEDYÚdatetimeÚstrptimeZ	EFFECTIVEÚdaterN   rO   rP   ZSCOPEZTYPEÚCOMMENTr0   )r2   Z
from_codesZfrom_macrolanguagesZfrom_retirementsZref_namer;   ÚrowÚpÚir<   r=   r>   r?   r@   r3   r4   r5   r6   r7   r8   r:   Úlanguager   r   r    Ú_get_language   st    


ÿýý
ÿû




ñrv   zDict[str, Language]rB   c                  C  s4   i } t D ]}t|ƒ| |< qtD ]}t|ƒ| |< q| S r   )r   rv   r   )Ú	languagesr2   r   r   r    Ú_get_all_languagesu  s    rx   rT   zSet[Language]ÚALL_LANGUAGES)T)N),r-   Ú
__future__r   rn   Zdataclassesr   Útypingr   r   r   r   r   r	   Ú_datar   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rc   Ú	Exceptionr$   r)   r0   rb   rU   rZ   rv   rx   rT   r/   ÚsetÚvaluesry   r   r   r   r    Ú<module>   s.    Dþ  ÿ* ý9U	