o $&]i@sPddlmZddlmZmZddlmZerddlmZGdddeeZdS)) annotations) TYPE_CHECKINGGeneric)SeriesT)NonNestedLiteralc@seZdZd%ddZd&ddZd&d d Zd'd dZd(ddZd&ddZd&ddZ d&ddZ d&ddZ d&ddZ dddd)d"d#Z d$S)*SeriesListNamespaceseriesrreturnNonecCs ||_dS)N)_narwhals_series)selfrr R/var/www/html/IGF-ODF-V3/venv/lib/python3.10/site-packages/narwhals/series_list.py__init__ s zSeriesListNamespace.__init__cC|j|jjjS)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 r r rrs zSeriesListNamespace.lencCr)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 rrruniquerr r rr(s zSeriesListNamespace.uniqueitemrcCs|j|jjj|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 rr r rr@szSeriesListNamespace.containsindexintcCsXt|tsdt|jd}t||dkr d|d}t||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.) isinstancertype__name__ TypeError ValueErrorr rrrget)r rmsgr r rr Xs  zSeriesListNamespace.getcCr)aCompute the min 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.min().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [i64] [ 1 3 ] )r rrrminrr r rr"y zSeriesListNamespace.mincCr)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 rrrmaxrr r rr$ zSeriesListNamespace.maxcCr)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 rrrmeanrr r rr&r#zSeriesListNamespace.meancCr)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 rrrmedianrr r rr'r%zSeriesListNamespace.mediancCr)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 rrrsumrr r rr(r#zSeriesListNamespace.sumF descending nulls_lastr*boolr+cCs|j|jjjj||dS)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] ] r))r rrrsort)r r*r+r r rr-s  zSeriesListNamespace.sortN)rrr r )r r)rrr r)rrr r)r*r,r+r,r r)r __module__ __qualname__rrrrr r"r$r&r'r(r-r r r rr s      !    rN) __future__rtypingrrnarwhals.typingrrrr r r rs