o i@sdZddlmZddlmZddlZddlZddlZddlm Z m Z ddl m Z eej fd%d dZej fd&ddZd'ddZd(ddZddefd)d#d$ZdS)*zx Helpers for configuring locale settings. Name `localization` is chosen to avoid overlap with builtin `locale` module. ) annotations)contextmanagerN)CallableIterator)options new_localestr | tuple[str, str]lc_varintreturnIterator[str | tuple[str, str]]c cst|}z2t||t\}}|dur$|dur$|d|Vn |VWt||dSWt||dSt||w)aE Context manager for temporarily setting a locale. Parameters ---------- new_locale : str or tuple A string of the form .. For example to set the current locale to US English with a UTF8 encoding, you would pass "en_US.UTF-8". lc_var : int, default `locale.LC_ALL` The category of the locale being set. Notes ----- This is useful when you want to run a particular block of code under a particular locale, without globally setting the locale. This probably isn't thread-safe. N.)locale setlocale getlocale)rr current_localenormalized_codenormalized_encodingrV/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/pandas/_config/localization.py set_locales   rlcstrboolc CsRzt||d WdWdS1swYWdSttjfy(YdSw)aj Check to see if we can set a locale, and subsequently get the locale, without raising an Exception. Parameters ---------- lc : str The locale to attempt to set. lc_var : int, default `locale.LC_ALL` The category of the locale being set. Returns ------- bool Whether the passed locale can be set )r NFT)r ValueErrorrError)rr rrrcan_set_locale8s rlocaleslist[str] | str normalize list[str]csddfdd|DDS)ar Return a list of normalized locales that do not throw an ``Exception`` when set. Parameters ---------- locales : str A string where each locale is separated by a newline. normalize : bool Whether to call ``locale.normalize`` on each locale. Returns ------- valid_locales : list A list of valid locales. cSsg|]}t|r|qSr)r.0locrrr ds z"_valid_locales..c3s*|]}r t|n|VqdS)N)rrstripr!rrr fs  z!_valid_locales..r)rrrr&r_valid_localesSs  r(bytescCstjdgddS)Nz locale -aT)shell) subprocess check_outputrrrr_default_locale_getternsr-Tprefix str | None locale_getterCallable[[], bytes]list[str] | Nonec Csz|}Wn tjyYdSwz-|d}g}|D]!}z |t|tjjdWqty<|t|ddYqwWn t yGYnw|durQt ||St |d}| d|}t ||S)a Get all the locales that are available on the system. Parameters ---------- prefix : str If not ``None`` then return only those locales with the prefix provided. For example to get all English language locales (those that start with ``"en"``), pass ``prefix="en"``. normalize : bool Call ``locale.normalize`` on the resulting list of available locales. If ``True``, only locales that can be set without throwing an ``Exception`` are returned. locale_getter : callable The function to use to retrieve the current locales. This should return a string with each locale separated by a newline character. Returns ------- locales : list of strings A list of locale strings that can be set with ``locale.setlocale()``. For example:: locale.setlocale(locale.LC_ALL, locale_string) On error will return None (no locale available, e.g. Windows) N )encodingz windows-1252z.* )r+CalledProcessErrorsplitappendrrdisplayr4 UnicodeError TypeErrorr(recompilefindalljoin) r.rr0 raw_localessplit_raw_locales out_localesxpatternfoundrrr get_localesrs.!      rF)rrr r r r )rrr r r r)rrrrr r )r r))r.r/rrr0r1r r2)__doc__ __future__r contextlibrrr<r+typingrrpandas._config.configrLC_ALLrrr(r-rFrrrrs$   #