§ q-Ph•ãó—ddlmZddlZddlmZeje¦«5ddlmZ ddlm Z ddd¦«n #1swxYwYer"ddl Z ddl m Z e jdkrddlmZnddlmZgd¢ZGd „d ej¦«Zdd „Zdd„Zdd„ZdS)é)Ú annotationsN)Ú TYPE_CHECKING)ÚPyStringCacheHolder)Ú TracebackType)éé )ÚSelf)Ú StringCacheÚdisable_string_cacheÚenable_string_cacheÚusing_string_cachecó"—eZdZdZdd„Zdd „Zd S)r a¸ Context manager for enabling and disabling the global string cache. :class:`Categorical` columns created under the same global string cache have the same underlying physical value when string values are equal. This allows the columns to be concatenated or used in a join operation, for example. Notes ----- Enabling the global string cache introduces some overhead. The amount of overhead depends on the number of categories in your data. It is advised to enable the global string cache only when strictly necessary. If `StringCache` calls are nested, the global string cache will only be disabled and cleared when the outermost context exits. Examples -------- Construct two Series using the same global string cache. >>> with pl.StringCache(): ... s1 = pl.Series("color", ["red", "green", "red"], dtype=pl.Categorical) ... s2 = pl.Series("color", ["blue", "red", "green"], dtype=pl.Categorical) As both Series are constructed under the same global string cache, they can be concatenated. >>> pl.concat([s1, s2]) shape: (6,) Series: 'color' [cat] [ "red" "green" "red" "blue" "red" "green" ] The class can also be used as a function decorator, in which case the string cache is enabled during function execution, and disabled afterwards. >>> @pl.StringCache() ... def construct_categoricals() -> pl.Series: ... s1 = pl.Series("color", ["red", "green", "red"], dtype=pl.Categorical) ... s2 = pl.Series("color", ["blue", "red", "green"], dtype=pl.Categorical) ... return pl.concat([s1, s2]) Úreturnr có,—t¦«|_|S©N)rÚ _string_cache)Úselfs úS/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/polars/string_cache.pyÚ __enter__zStringCache.__enter__Ns€Ý0Ñ2Ô2ˆÔ؈ óÚexc_typeútype[BaseException] | NoneÚexc_valúBaseException | NoneÚexc_tbúTracebackType | NoneÚNonecó —|`dSr)r)rrrrs rÚ__exit__zStringCache.__exit__Rs€ð Ð Ð Ð rN)rr )rrrrrrrr)Ú__name__Ú __module__Ú __qualname__Ú__doc__rr©rrr r sG€€€€€ð/ð/ðbðððððððððrr rrcó,—tj¦«dS)a¡ Enable the global string cache. :class:`Categorical` columns created under the same global string cache have the same underlying physical value when string values are equal. This allows the columns to be concatenated or used in a join operation, for example. See Also -------- StringCache : Context manager for enabling and disabling the string cache. disable_string_cache : Function to disable the string cache. Notes ----- Enabling the global string cache introduces some overhead. The amount of overhead depends on the number of categories in your data. It is advised to enable the global string cache only when strictly necessary. Consider using the :class:`StringCache` context manager for a more reliable way of enabling and disabling the string cache. Examples -------- Construct two Series using the same global string cache. >>> pl.enable_string_cache() >>> s1 = pl.Series("color", ["red", "green", "red"], dtype=pl.Categorical) >>> s2 = pl.Series("color", ["blue", "red", "green"], dtype=pl.Categorical) >>> pl.disable_string_cache() As both Series are constructed under the same global string cache, they can be concatenated. >>> pl.concat([s1, s2]) shape: (6,) Series: 'color' [cat] [ "red" "green" "red" "blue" "red" "green" ] N)Úplrr r$rrr r [s€õ\ÔÑÔÐÐÐrÚboolcó(—tj¦«S)as Disable and clear the global string cache. See Also -------- enable_string_cache : Function to enable the string cache. StringCache : Context manager for enabling and disabling the string cache. Notes ----- Consider using the :class:`StringCache` context manager for a more reliable way of enabling and disabling the string cache. When used in conjunction with the :class:`StringCache` context manager, the string cache will not be disabled until the context manager exits. Examples -------- Construct two Series using the same global string cache. >>> pl.enable_string_cache() >>> s1 = pl.Series("color", ["red", "green", "red"], dtype=pl.Categorical) >>> s2 = pl.Series("color", ["blue", "red", "green"], dtype=pl.Categorical) >>> pl.disable_string_cache() As both Series are constructed under the same global string cache, they can be concatenated. >>> pl.concat([s1, s2]) shape: (6,) Series: 'color' [cat] [ "red" "green" "red" "blue" "red" "green" ] )r&r r$rrr r Œs€õR Ô #Ñ %Ô %Ð%rcó(—tj¦«S)z1Check whether the global string cache is enabled.)r&r r$rrr r ¸s€å Ô !Ñ #Ô #Ð#r)rr)rr')Ú __future__rÚ contextlibÚtypingrÚsuppressÚ ImportErrorÚ polars.polarsÚpolarsr&rÚsysÚtypesrÚ version_infor Útyping_extensionsÚ__all__ÚContextDecoratorr r r r r$rrúr7s¢ðØ"Ð"Ð"Ð"Ð"Ð"àÐÐÐØ Ð Ð Ð Ð Ð à€ZÔ˜Ñ%Ô%ð2ð2ØÐÐÐÐÐØ1Ð1Ð1Ð1Ð1Ð1ð2ð2ð2ñ2ô2ð2ð2ð2ð2ð2ð2øøøð2ð2ð2ð2ðð+Ø€J€J€JØ#Ð#Ð#Ð#Ð#Ð#à Ô˜7Ò"Ð"ØÐÐÐÐÐÐà*Ð*Ð*Ð*Ð*Ð*ð ð ð €ð<ð<ð<ð<ð<*Ô-ñ<ô<ð<ð~.ð.ð.ð.ðb)&ð)&ð)&ð)&ðX$ð$ð$ð$ð$ð$s ¡ :º>Á>