j+UdZddlmZddlZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZdd gZGd d eZed d GddZed d GddZd&dZ d'd(dZ d)d*dZd+d Z d,d"Z!e!Z"d!e#d#<e$e"%Z&d$e#d%<dS)-zThe Language class.) annotationsN) dataclass)NoReturn)_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*|SN)lowerxs Y/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/iso639/language.pyrsAGGIIc*|Sr)titlers rrrsrceZdZdS)LanguageNotFoundErrorN)__name__ __module__ __qualname__rrr!r!sDrr!T)frozenslotsc(eZdZUdZded<ded<dS)Namez-Represents an alternative name of a language.strprintinvertedN)r"r#r$__doc____annotations__r%rrr)r)#s(77JJJMMMMMrr)cPeZdZUdZded<ded<ded<ded<ded<ded <ded <ded <ded <d ed<ded<ded<ded<ded<ded<d%dZd&dZeddd'dZed(dZ ed(d Z ed(d!Z ed(d"Z ed(d#Z d$S))Languagez.Represents a language in the ISO 639-3 charts.r*part3 str | Nonepart2bpart2tpart1scopetypestatusnamecommentzlist[Name] | None other_names macrolanguage retire_reasonretire_change_to retire_remedyzdatetime.date | None retire_datereturnintc*t|jSr)hashr1)selfs r__hash__zLanguage.__hash__FsDJrboolcLt|to|j|jkSr) isinstancer0r1)rEothers r__eq__zLanguage.__eq__Is %**HtzU[/HHrT) strict_case user_inputrLctjtjtjtjt jtjtjtj g}tt|||S)aReturn a ``Language`` instance by matching on the user input. Parameters ---------- user_input : str A language code or name. strict_case : bool, optional Defaults to ``True``, for enforcing strict case sensitivity. If ``False`` and if ``user_input`` doesn't find a match, further match attempts will be made with the all-lowercase version of ``user_input`` (``"foobar"``) and the title-case version of ``user_input`` (``"Foobar"``). 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) ) rIDPART2BPART2TPART1rREF_NAMEr PRINT_NAME INVERTED_NAME_PART3_TO_LANGUAGES _get_part3)clsrMrL query_orders rmatchzLanguage.matchLsTL O        !  !  '  * + #:j+{#S#STTrcdtt|tjtjgS)z6Return a ``Language`` instance from an ISO 639-3 code.)rV_get_part3_exactrrOrrXrMs r from_part3zLanguage.from_part3}s)# Z,/;M;P)Q R R  rcNtt|tjgS)zFReturn a ``Language`` instance from an ISO 639-2 (bibliographic) code.)rVr\rrPr]s r from_part2bzLanguage.from_part2b ##3JAT@U#V#VWWrcNtt|tjgS)zGReturn a ``Language`` instance from an ISO 639-2 (terminological) code.)rVr\rrQr]s r from_part2tzLanguage.from_part2trarcNtt|tjgS)z6Return a ``Language`` instance from an ISO 639-1 code.)rVr\rrRr]s r from_part1zLanguage.from_part1s ##3JAS@T#U#UVVrc~tjtjtjg}t t ||S)zIReturn a ``Language`` instance from an ISO 639-3 reference language name.)rrSrrTrUrVr\)rXrMrYs r from_namezLanguage.from_names5  !  '  *+ ##3J #L#LMMrN)rArB)rArG)rMr*rLrGrAr0)rMr*rAr0)r"r#r$r-r.rFrK classmethodrZr^r`rcrergr%rrr0r0+s88JJJJJJKKK III#"""    %%%%    IIII>B.U.U.U.U.U[.U`   [ XXX[XXXX[XWWW[WNNN[NNNrr0rMr*rArc&t|d)Nz# isn't an ISO language code or name)r!)rMs r_raise_language_not_found_errorrjs : T T T U UUrrYlist[_COLUMN_TYPE]rLrGc t||S#t$rY}|r|tD]3} t||||ccYd}~S#t$rY0wxYwt|Yd}~dSd}~wwxYw)aGet 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. strict_case : bool, optional Defaults to ``True``, for enforcing strict case sensitivity. If ``False`` and if ``user_input`` doesn't find a match, further match attempts will be made with the all-lowercase version of ``user_input`` (``"foobar"``) and the title-case version of ``user_input`` (``"Foobar"``). Returns ------- str Raises ------ LanguageNotFoundError If `part3` isn't a language name or code N)r\r!_STRING_CLEANING_FUNCSrj)rMrYrLefuncs rrWrWs6 < K888 < < <  <G. < <+DD,<,r?r@)rrsr r rrSrrrrTrUappendr)rMID RET_REASON CHANGE_TOREMEDYdatetimestrptime EFFECTIVEdaterPrQrRSCOPETYPECOMMENTr0)r1 from_codesfrom_macrolanguagesfrom_retirementsref_namer;rowpir<r=r>r?r@r3r4r5r6r7r8r:languages r _get_languagers!$U++J26u==,077  ; <()) 09 : &(K#'r22++#./5E5S1T11!!!!!!!!   tAqzz * * *%K(.B334I4MNNM%+001C1NOOM(.B334F4PQQ%+001C1JKKM  "" /9 :J  $&&&  L/0L/0<-.<-.,+,\12~~mt \T 4'4#+t#+t)1T#+t'4H$ Ordict[str, Language]czi}tD]}t|||<tD]}t|||<|Sr)rrr ) languagesr1s r_get_all_languagesr[sUI 00(// %&00(// % rrVz set[Language] ALL_LANGUAGES)rMr*rAr)T)rMr*rYrkrLrGrAr*r)rMr*rYrkrpr2rAr*)r1r*rAr0)rAr)'r- __future__rr dataclassesrtypingr_datarrr r r r r rrrrrrrrrm Exceptionr!r)r0rjrWr\rrrVr.setvaluesrr%rrrs""""""!!!!!!$.-/B/BC     I    $d###$# $d###oNoNoNoNoNoNoN$#oNdVVVV KO'<'<'<'<'+=+?+?????"s#6#=#=#?#?@@ @@@@@@r