mxiXddlmZddlmZmZddlmZerddlmZGddeeZy)) annotations) TYPE_CHECKINGGeneric)SeriesT)NonNestedLiteralcleZdZddZddZddZddZddZddZddZ ddZ dd Z dd Z d d d dd Z y)SeriesListNamespacec||_y)N)_narwhals_series)selfseriess K/home/htdocs/ttos/venv/lib/python3.12/site-packages/narwhals/series_list.py__init__zSeriesListNamespace.__init__ s &c|jj|jjjj S)aMReturn the number of elements in each list. Null values count towards the total. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> s_native = pa.chunked_array([[[1, 2], [3, 4, None], None, []]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.len().to_native() # doctest: +ELLIPSIS [ [ 2, 3, null, 0 ] ] )r _with_compliant_compliant_serieslistlenr s rrzSeriesListNamespace.lens;*$$44  ! ! 3 3 8 8 < < >  rc|jj|jjjj S)asGet the unique/distinct values in the list. Null values are included in the result. The order of unique values is not guaranteed. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[1, 1, 2], [3, 3, None], None, []]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.unique().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (4,) Series: '' [list[i64]] [ [1, 2] [null, 3] null [] ] )r rrruniquers rrzSeriesListNamespace.unique(s;($$44  ! ! 3 3 8 8 ? ? A  rc|jj|jjjj |S)aFCheck if sublists contain the given item. Arguments: item: Item that will be checked for membership. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[1, 2], None, []]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.contains(1).to_native() # doctest: +NORMALIZE_WHITESPACE shape: (3,) Series: '' [bool] [ true null false ] )r rrrcontains)r items rrzSeriesListNamespace.contains@s=($$44  ! ! 3 3 8 8 A A$ G  rc&t|ts$dt|jd}t ||dkrd|d}t ||j j|j jjj|S)aReturn the value by index in each list. Negative indices are not accepted. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[1, 2], [3, 4, None], [None, 5]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.get(1).to_native() # doctest: +NORMALIZE_WHITESPACE shape: (3,) Series: '' [i64] [ 2 4 5 ] z'Index must be of type 'int'. Got type 'z ' instead.rzIndex z8 is out of bounds: should be greater than or equal to 0.) isinstanceinttype__name__ TypeError ValueErrorr rrrget)r indexmsgs rr#zSeriesListNamespace.getXs&%%9$u+:N:N9OzZ C. 195'!YZCS/ !$$44  ! ! 3 3 8 8 < >> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[1], [3, 4, None]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.min().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [i64] [ 1 3 ] )r rrrminrs rr'zSeriesListNamespace.miny; $$44  ! ! 3 3 8 8 < < >  rc|jj|jjjj S)aCompute the max value of the lists in the array. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> s_native = pa.chunked_array([[[1], [3, 4, None]]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.max().to_native() # doctest: +ELLIPSIS [ [ 1, 4 ] ] )r rrrmaxrs rr*zSeriesListNamespace.maxs;"$$44  ! ! 3 3 8 8 < < >  rc|jj|jjjj S)aCompute the mean value of the lists in the array. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[1], [3, 4, None]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.mean().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [f64] [ 1.0 3.5 ] )r rrrmeanrs rr,zSeriesListNamespace.means; $$44  ! ! 3 3 8 8 = = ?  rc|jj|jjjj S)aCompute the median value of the lists in the array. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> s_native = pa.chunked_array([[[1], [3, 4, None]]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.median().to_native() # doctest: +ELLIPSIS [ [ 1, 3 ] ] )r rrrmedianrs rr.zSeriesListNamespace.medians;"$$44  ! ! 3 3 8 8 ? ? A  rc|jj|jjjj S)aCompute the sum value of the lists in the array. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[1], [3, 4, None]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.sum().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [i64] [ 1 7 ] )r rrrsumrs rr0zSeriesListNamespace.sumr(rF descending nulls_lastc|jj|jjjj ||S)a^Sort the lists of the series. Arguments: descending: Sort in descending order. nulls_last: Place null values last. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series([[2, -1, 1], [3, -4, None]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.list.sort().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [list[i64]] [ [-1, 1, 2] [null, -4, 3] ] r1)r rrrsort)r r2r3s rr5zSeriesListNamespace.sortsG($$44  ! ! 3 3 8 8 = =%* >   rN)r rreturnNone)r6r)rrr6r)r$rr6r)r2boolr3r8r6r)r __module__ __qualname__rrrrr#r'r*r,r.r0r5rrr r sA' 2 0 0 B ( * ( * (*/5 rr N) __future__rtypingrrnarwhals.typingrrr r;rrr?s'")#0l ''*l r