from __future__ import annotations

import math
from datetime import datetime, time, timedelta
from decimal import Decimal as D
from typing import Any

import hypothesis.strategies as st
import pytest
from hypothesis import given

import polars as pl
from polars.exceptions import InvalidOperationError
from polars.testing import assert_series_equal, assert_series_not_equal
from polars.testing.parametric import dtypes, series

nan = float("nan")
pytest_plugins = ["pytester"]


@given(s=series())
def test_assert_series_equal_parametric(s: pl.Series) -> None:
    assert_series_equal(s, s)


@given(data=st.data())
def test_assert_series_equal_parametric_array(data: st.DataObject) -> None:
    inner = data.draw(dtypes(excluded_dtypes=[pl.Categorical]))
    shape = data.draw(st.integers(min_value=1, max_value=3))
    dtype = pl.Array(inner, shape=shape)
    s = data.draw(series(dtype=dtype))

    assert_series_equal(s, s)


def test_compare_series_value_mismatch() -> None:
    srs1 = pl.Series([1, 2, 3])
    srs2 = pl.Series([2, 3, 4])
    assert_series_not_equal(srs1, srs2)

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(srs1, srs2)


def test_compare_series_empty_equal() -> None:
    srs1 = pl.Series([])
    srs2 = pl.Series(())
    assert_series_equal(srs1, srs2)

    with pytest.raises(
        AssertionError,
        match=r"Series are equal \(but are expected not to be\)",
    ):
        assert_series_not_equal(srs1, srs2)


def test_assert_series_equal_check_order() -> None:
    srs1 = pl.Series([1, 2, 3, None])
    srs2 = pl.Series([2, None, 3, 1])
    assert_series_equal(srs1, srs2, check_order=False)

    with pytest.raises(
        AssertionError,
        match=r"Series are equal \(but are expected not to be\)",
    ):
        assert_series_not_equal(srs1, srs2, check_order=False)


def test_assert_series_equal_check_order_unsortable_type() -> None:
    s1 = pl.Series([object(), object()])
    s2 = pl.Series([object(), object()])
    with pytest.raises(
        InvalidOperationError,
        match="`sort_with` operation not supported for dtype `object`",
    ):
        assert_series_equal(s1, s2, check_order=False)


def test_compare_series_nans_assert_equal() -> None:
    srs1 = pl.Series([1.0, 2.0, nan, 4.0, None, 6.0])
    srs2 = pl.Series([1.0, nan, 3.0, 4.0, None, 6.0])
    srs3 = pl.Series([1.0, 2.0, 3.0, 4.0, None, 6.0])

    for srs in (srs1, srs2, srs3):
        assert_series_equal(srs, srs)
        assert_series_equal(srs, srs, check_exact=True)

    for check_exact in (False, True):
        if check_exact:
            check_msg = "exact value mismatch"
        else:
            check_msg = "Series are different.*value mismatch.*"

        with pytest.raises(AssertionError, match=check_msg):
            assert_series_equal(srs1, srs2, check_exact=check_exact)
        with pytest.raises(AssertionError, match=check_msg):
            assert_series_equal(srs1, srs3, check_exact=check_exact)

    srs4 = pl.Series([1.0, 2.0, 3.0, 4.0, None, 6.0])
    srs5 = pl.Series([1.0, 2.0, 3.0, 4.0, nan, 6.0])
    srs6 = pl.Series([1, 2, 3, 4, None, 6])

    assert_series_equal(srs4, srs6, check_dtypes=False)
    with pytest.raises(AssertionError):
        assert_series_equal(srs5, srs6, check_dtypes=False)
    assert_series_not_equal(srs5, srs6, check_dtypes=True)

    # nested
    for float_type in (pl.Float32, pl.Float64):
        srs = pl.Series([[0.0, nan]], dtype=pl.List(float_type))
        assert srs.dtype == pl.List(float_type)
        assert_series_equal(srs, srs)


def test_compare_series_nulls() -> None:
    srs1 = pl.Series([1, 2, None])
    srs2 = pl.Series([1, 2, None])
    assert_series_equal(srs1, srs2)

    srs1 = pl.Series([1, 2, 3])
    srs2 = pl.Series([1, None, None])
    assert_series_not_equal(srs1, srs2)

    with pytest.raises(AssertionError, match="value mismatch"):
        assert_series_equal(srs1, srs2)


def test_compare_series_value_mismatch_string() -> None:
    srs1 = pl.Series(["hello", "no"])
    srs2 = pl.Series(["hello", "yes"])

    assert_series_not_equal(srs1, srs2)
    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(srs1, srs2)


def test_compare_series_dtype_mismatch() -> None:
    srs1 = pl.Series([1, 2, 3])
    srs2 = pl.Series([1.0, 2.0, 3.0])
    assert_series_not_equal(srs1, srs2)

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(dtype mismatch\)",
    ):
        assert_series_equal(srs1, srs2)


@pytest.mark.parametrize(
    "assert_function", [assert_series_equal, assert_series_not_equal]
)
def test_compare_series_input_type_mismatch(assert_function: Any) -> None:
    srs1 = pl.Series([1, 2, 3])
    srs2 = pl.DataFrame({"col1": [2, 3, 4]})

    with pytest.raises(
        AssertionError,
        match=r"inputs are different \(unexpected input types\)",
    ):
        assert_function(srs1, srs2)


def test_compare_series_name_mismatch() -> None:
    srs1 = pl.Series(values=[1, 2, 3], name="srs1")
    srs2 = pl.Series(values=[1, 2, 3], name="srs2")
    with pytest.raises(
        AssertionError,
        match=r"Series are different \(name mismatch\)",
    ):
        assert_series_equal(srs1, srs2)


def test_compare_series_length_mismatch() -> None:
    srs1 = pl.Series(values=[1, 2, 3, 4], name="srs1")
    srs2 = pl.Series(values=[1, 2, 3], name="srs2")

    assert_series_not_equal(srs1, srs2)
    with pytest.raises(
        AssertionError,
        match=r"Series are different \(length mismatch\)",
    ):
        assert_series_equal(srs1, srs2)


def test_compare_series_value_exact_mismatch() -> None:
    srs1 = pl.Series([1.0, 2.0, 3.0])
    srs2 = pl.Series([1.0, 2.0 + 1e-7, 3.0])
    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(srs1, srs2, check_exact=True)


def test_assert_series_equal_int_overflow() -> None:
    # internally may call 'abs' if not check_exact, which can overflow on signed int
    s0 = pl.Series([-128], dtype=pl.Int8)
    s1 = pl.Series([0, -128], dtype=pl.Int8)
    s2 = pl.Series([1, -128], dtype=pl.Int8)

    for check_exact in (True, False):
        assert_series_equal(s0, s0, check_exact=check_exact)
        with pytest.raises(AssertionError):
            assert_series_equal(s1, s2, check_exact=check_exact)


@pytest.mark.parametrize(
    ("data1", "data2"),
    [
        ([datetime(2022, 10, 2, 12)], [datetime(2022, 10, 2, 13)]),
        ([time(10, 0, 0)], [time(10, 0, 10)]),
        ([timedelta(10, 0, 0)], [timedelta(10, 0, 10)]),
    ],
)
def test_assert_series_equal_temporal(data1: Any, data2: Any) -> None:
    s1 = pl.Series(data1)
    s2 = pl.Series(data2)
    assert_series_not_equal(s1, s2)


@pytest.mark.parametrize(
    ("s1", "s2", "kwargs"),
    [
        pytest.param(
            pl.Series([0.2, 0.3]),
            pl.Series([0.2, 0.3]),
            {"abs_tol": 1e-15},
            id="equal_floats_low_abs_tol",
        ),
        pytest.param(
            pl.Series([0.2, 0.3]),
            pl.Series([0.2, 0.3000000000000001]),
            {"abs_tol": 1e-15},
            id="approx_equal_float_low_abs_tol",
        ),
        pytest.param(
            pl.Series([0.2, 0.3]),
            pl.Series([0.2, 0.31]),
            {"abs_tol": 0.1},
            id="approx_equal_float_high_abs_tol",
        ),
        pytest.param(
            pl.Series([0.2, 1.3]),
            pl.Series([0.2, 0.9]),
            {"abs_tol": 1},
            id="approx_equal_float_integer_abs_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, nan]),
            pl.Series([1.005, 2.005, nan]),
            {"abs_tol": 1e-2, "rel_tol": 0.0},
            id="approx_equal_float_nan_abs_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, None]),
            pl.Series([1.005, 2.005, None]),
            {"abs_tol": 1e-2},
            id="approx_equal_float_none_abs_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, nan]),
            pl.Series([1.005, 2.015, nan]),
            {"abs_tol": 0.0, "rel_tol": 1e-2},
            id="approx_equal_float_nan_rel_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, None]),
            pl.Series([1.005, 2.015, None]),
            {"rel_tol": 1e-2},
            id="approx_equal_float_none_rel_tol",
        ),
        pytest.param(
            pl.Series([0.0, 1.0, 2.0], dtype=pl.Float64),
            pl.Series([0, 1, 2], dtype=pl.Int64),
            {"check_dtypes": False},
            id="equal_int_float_integer_no_check_dtype",
        ),
        pytest.param(
            pl.Series([0, 1, 2], dtype=pl.Float64),
            pl.Series([0, 1, 2], dtype=pl.Float32),
            {"check_dtypes": False},
            id="equal_int_float_integer_no_check_dtype",
        ),
        pytest.param(
            pl.Series([0, 1, 2], dtype=pl.Int64),
            pl.Series([0, 1, 2], dtype=pl.Int64),
            {},
            id="equal_int",
        ),
        pytest.param(
            pl.Series(["a", "b", "c"], dtype=pl.String),
            pl.Series(["a", "b", "c"], dtype=pl.String),
            {},
            id="equal_str",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.31]]),
            {"abs_tol": 0.1},
            id="list_of_float_high_abs_tol",
        ),
        pytest.param(
            pl.Series([[0.2, 1.3]]),
            pl.Series([[0.2, 0.9]]),
            {"abs_tol": 1},
            id="list_of_float_integer_abs_tol",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.300000001]]),
            {"rel_tol": 1e-15},
            id="list_of_float_low_rel_tol",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.301]]),
            {"rel_tol": 0.1},
            id="list_of_float_high_rel_tol",
        ),
        pytest.param(
            pl.Series([[0.2, 1.3]]),
            pl.Series([[0.2, 0.9]]),
            {"rel_tol": 1},
            id="list_of_float_integer_rel_tol",
        ),
        pytest.param(
            pl.Series([[None, 1.3]]),
            pl.Series([[None, 0.9]]),
            {"rel_tol": 1},
            id="list_of_none_and_float_integer_rel_tol",
        ),
        pytest.param(
            pl.Series([[None, 1]], dtype=pl.List(pl.Int64)),
            pl.Series([[None, 1]], dtype=pl.List(pl.Int64)),
            {"rel_tol": 1},
            id="list_of_none_and_int_integer_rel_tol",
        ),
        pytest.param(
            pl.Series([[math.nan, 1.3]]),
            pl.Series([[math.nan, 0.9]]),
            {"rel_tol": 1},
            id="list_of_none_and_float_integer_rel_tol",
        ),
        pytest.param(
            pl.Series([[2.0, 3.0]]),
            pl.Series([[2, 3]]),
            {"check_exact": False, "check_dtypes": False},
            id="list_of_float_list_of_int_check_dtype_false",
        ),
        pytest.param(
            pl.Series([[[0.2, 3.0]]]),
            pl.Series([[[0.2, 3.00000001]]]),
            {"abs_tol": 0.1},
            id="nested_list_of_float_abs_tol_high",
        ),
        pytest.param(
            pl.Series([[[0.2, math.nan, 3.0]]]),
            pl.Series([[[0.2, math.nan, 3.00000001]]]),
            {"abs_tol": 0.1},
            id="nested_list_of_float_and_nan_abs_tol_high",
        ),
        pytest.param(
            pl.Series([[[[0.2, 3.0]]]]),
            pl.Series([[[[0.2, 3.00000001]]]]),
            {"abs_tol": 0.1},
            id="double_nested_list_of_float_abs_tol_high",
        ),
        pytest.param(
            pl.Series([[[[0.2, math.nan, 3.0]]]]),
            pl.Series([[[[0.2, math.nan, 3.00000001]]]]),
            {"abs_tol": 0.1},
            id="double_nested_list_of_float__and_nan_abs_tol_high",
        ),
        pytest.param(
            pl.Series([[[[[0.2, 3.0]]]]]),
            pl.Series([[[[[0.2, 3.00000001]]]]]),
            {"abs_tol": 0.1},
            id="triple_nested_list_of_float_abs_tol_high",
        ),
        pytest.param(
            pl.Series([[[[[0.2, math.nan, 3.0]]]]]),
            pl.Series([[[[[0.2, math.nan, 3.00000001]]]]]),
            {"abs_tol": 0.1},
            id="triple_nested_list_of_float_and_nan_abs_tol_high",
        ),
        pytest.param(
            pl.struct(a=0, b=1, eager=True),
            pl.struct(a=0, b=1, eager=True),
            {},
            id="struct_equal",
        ),
        pytest.param(
            pl.struct(a=0, b=1.1, eager=True),
            pl.struct(a=0, b=1.01, eager=True),
            {"abs_tol": 0.1, "rel_tol": 0},
            id="struct_approx_equal",
        ),
        pytest.param(
            pl.struct(a=0, b=[0.0, 1.1], eager=True),
            pl.struct(a=0, b=[0.0, 1.11], eager=True),
            {"abs_tol": 0.1},
            id="struct_with_list_approx_equal",
        ),
        pytest.param(
            pl.struct(a=0, b=[0.0, math.nan], eager=True),
            pl.struct(a=0, b=[0.0, math.nan], eager=True),
            {"abs_tol": 0.1},
            id="struct_with_list_with_nan_compare_equal_true",
        ),
    ],
)
def test_assert_series_equal_passes_assertion(
    s1: pl.Series,
    s2: pl.Series,
    kwargs: Any,
) -> None:
    assert_series_equal(s1, s2, **kwargs)
    with pytest.raises(AssertionError):
        assert_series_not_equal(s1, s2, **kwargs)


@pytest.mark.parametrize(
    ("s1", "s2", "kwargs"),
    [
        pytest.param(
            pl.Series([0.2, 0.3]),
            pl.Series([0.2, 0.39]),
            {"abs_tol": 0.09, "rel_tol": 0},
            id="approx_equal_float_high_abs_tol_zero_rel_tol",
        ),
        pytest.param(
            pl.Series([0.2, 1.3]),
            pl.Series([0.2, 2.31]),
            {"abs_tol": 1, "rel_tol": 0},
            id="approx_equal_float_integer_abs_tol_zero_rel_tol",
        ),
        pytest.param(
            pl.Series([0, 1, 2], dtype=pl.Float64),
            pl.Series([0, 1, 2], dtype=pl.Int64),
            {"check_dtypes": True},
            id="equal_int_float_integer_check_dtype",
        ),
        pytest.param(
            pl.Series([0, 1, 2], dtype=pl.Float64),
            pl.Series([0, 1, 2], dtype=pl.Float32),
            {"check_dtypes": True},
            id="equal_int_float_integer_check_dtype",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, nan]),
            pl.Series([1.005, 2.005, 3.005]),
            {"abs_tol": 1e-2, "rel_tol": 0.0},
            id="approx_equal_float_left_nan_abs_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, 3.0]),
            pl.Series([1.005, 2.005, nan]),
            {"abs_tol": 1e-2, "rel_tol": 0.0},
            id="approx_equal_float_right_nan_abs_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, nan]),
            pl.Series([1.005, 2.015, 3.025]),
            {"abs_tol": 0.0, "rel_tol": 1e-2},
            id="approx_equal_float_left_nan_rel_tol",
        ),
        pytest.param(
            pl.Series([1.0, 2.0, 3.0]),
            pl.Series([1.005, 2.015, nan]),
            {"abs_tol": 0.0, "rel_tol": 1e-2},
            id="approx_equal_float_right_nan_rel_tol",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.3, 0.4]]),
            {},
            id="list_of_float_different_lengths",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.3000000000000001]]),
            {"check_exact": True},
            id="list_of_float_check_exact",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.300001]]),
            {"abs_tol": 1e-15, "rel_tol": 0},
            id="list_of_float_too_low_abs_tol",
        ),
        pytest.param(
            pl.Series([[0.2, 0.3]]),
            pl.Series([[0.2, 0.30000001]]),
            {"abs_tol": -1, "rel_tol": 0},
            id="list_of_float_negative_abs_tol",
        ),
        pytest.param(
            pl.Series([[2.0, 3.0]]),
            pl.Series([[2, 3]]),
            {"check_exact": False, "check_dtypes": True},
            id="list_of_float_list_of_int_check_dtype_true",
        ),
        pytest.param(
            pl.struct(a=0, b=1.1, eager=True),
            pl.struct(a=0, b=1, eager=True),
            {"abs_tol": 0.1, "rel_tol": 0, "check_dtypes": True},
            id="struct_approx_equal_different_type",
        ),
        pytest.param(
            pl.struct(a=0, b=1.09, eager=True),
            pl.struct(a=0, b=1, eager=True),
            {"abs_tol": 0.1, "rel_tol": 0, "check_dtypes": False},
            id="struct_approx_equal_different_type",
        ),
    ],
)
def test_assert_series_equal_raises_assertion_error(
    s1: pl.Series,
    s2: pl.Series,
    kwargs: Any,
) -> None:
    with pytest.raises(AssertionError):
        assert_series_equal(s1, s2, **kwargs)
    assert_series_not_equal(s1, s2, **kwargs)


def test_assert_series_equal_categorical_vs_str() -> None:
    s1 = pl.Series(["a", "b", "a"], dtype=pl.Categorical)
    s2 = pl.Series(["a", "b", "a"], dtype=pl.String)

    with pytest.raises(AssertionError, match="dtype mismatch"):
        assert_series_equal(s1, s2, categorical_as_str=True)

    assert_series_equal(s1, s2, check_dtypes=False, categorical_as_str=True)
    assert_series_equal(s2, s1, check_dtypes=False, categorical_as_str=True)


def test_assert_series_equal_incompatible_data_types() -> None:
    s1 = pl.Series(["a", "b", "a"], dtype=pl.Categorical)
    s2 = pl.Series([0, 1, 0], dtype=pl.Int8)

    with pytest.raises(AssertionError, match="incompatible data types"):
        assert_series_equal(s1, s2, check_dtypes=False)


def test_assert_series_equal_full_series() -> None:
    s1 = pl.Series([1, 2, 3])
    s2 = pl.Series([1, 2, 4])
    with pytest.raises(
        AssertionError, match=r"Series are different \(exact value mismatch\)"
    ):
        assert_series_equal(s1, s2)


def test_assert_series_not_equal() -> None:
    s = pl.Series("a", [1, 2])
    with pytest.raises(
        AssertionError,
        match=r"Series are equal \(but are expected not to be\)",
    ):
        assert_series_not_equal(s, s)


def test_assert_series_equal_nested_list_float() -> None:
    # First entry has only integers
    s1 = pl.Series([[1.0, 2.0], [3.0, 4.0]], dtype=pl.List(pl.Float64))
    s2 = pl.Series([[1.0, 2.0], [3.0, 4.9]], dtype=pl.List(pl.Float64))

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(nested value mismatch\)",
    ):
        assert_series_equal(s1, s2)


def test_assert_series_equal_nested_struct_float() -> None:
    s1 = pl.Series(
        [{"a": 1.0, "b": 2.0}, {"a": 3.0, "b": 4.0}],
        dtype=pl.Struct({"a": pl.Float64, "b": pl.Float64}),
    )
    s2 = pl.Series(
        [{"a": 1.0, "b": 2.0}, {"a": 3.0, "b": 4.9}],
        dtype=pl.Struct({"a": pl.Float64, "b": pl.Float64}),
    )

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(nested value mismatch\)",
    ):
        assert_series_equal(s1, s2)


def test_assert_series_equal_all_null_different_dtypes_fails_with_check_dtypes_true() -> (
    None
):
    s1 = pl.Series([None, None], dtype=pl.Categorical)
    s2 = pl.Series([None, None], dtype=pl.Int16)

    with pytest.raises(
        AssertionError,
        match="dtype mismatch",
    ):
        assert_series_equal(s1, s2, check_dtypes=True)


def test_assert_series_equal_all_null_different_dtypes_passes_with_check_dtypes_false() -> (
    None
):
    s1 = pl.Series([None, None], dtype=pl.Categorical)
    s2 = pl.Series([None, None], dtype=pl.Int16)

    assert_series_equal(s1, s2, check_dtypes=False)


def test_assert_series_equal_full_null_nested_list() -> None:
    s = pl.Series([None, None], dtype=pl.List(pl.Float64))
    assert_series_equal(s, s)


def test_assert_series_equal_nested_list_nan() -> None:
    s = pl.Series([[1.0, 2.0], [3.0, nan]], dtype=pl.List(pl.Float64))
    assert_series_equal(s, s)


def test_assert_series_equal_nested_list_none() -> None:
    s1 = pl.Series([[1.0, 2.0], None], dtype=pl.List(pl.Float64))
    s2 = pl.Series([[1.0, 2.0], None], dtype=pl.List(pl.Float64))

    assert_series_equal(s1, s2)


def test_assert_series_equal_uint_overflow() -> None:
    s1 = pl.Series([1, 2, 3], dtype=pl.UInt8)
    s2 = pl.Series([2, 3, 4], dtype=pl.UInt8)

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(s1, s2, abs_tol=0)

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(s1, s2, abs_tol=1)

    left = pl.Series(
        values=[2810428175213635359],
        dtype=pl.UInt64,
    )
    right = pl.Series(
        values=[15807433754238349345],
        dtype=pl.UInt64,
    )
    with pytest.raises(AssertionError):
        assert_series_equal(left, right)


def test_assert_series_equal_uint_always_checked_exactly() -> None:
    s1 = pl.Series([1, 3], dtype=pl.UInt8)
    s2 = pl.Series([2, 4], dtype=pl.Int64)

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(s1, s2, abs_tol=1, check_dtypes=False)


def test_assert_series_equal_nested_int_always_checked_exactly() -> None:
    s1 = pl.Series([[1, 2], [3, 4]])
    s2 = pl.Series([[1, 2], [3, 5]])

    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(s1, s2, abs_tol=1)
    with pytest.raises(
        AssertionError,
        match=r"Series are different \(exact value mismatch\)",
    ):
        assert_series_equal(s1, s2, check_exact=True)


@pytest.mark.parametrize("check_exact", [True, False])
def test_assert_series_equal_array_equal(check_exact: bool) -> None:
    s1 = pl.Series([[1.0, 2.0], [3.0, 4.0]], dtype=pl.Array(pl.Float64, 2))
    s2 = pl.Series([[1.0, 2.0], [3.0, 4.2]], dtype=pl.Array(pl.Float64, 2))

    with pytest.raises(
        AssertionError, match=r"Series are different \(nested value mismatch\)"
    ):
        assert_series_equal(s1, s2, check_exact=check_exact)


def test_series_equal_nested_lengths_mismatch() -> None:
    s1 = pl.Series([[1.0, 2.0], [3.0, 4.0]], dtype=pl.List(pl.Float64))
    s2 = pl.Series([[1.0, 2.0, 3.0], [4.0]], dtype=pl.List(pl.Float64))

    with pytest.raises(AssertionError, match="nested value mismatch"):
        assert_series_equal(s1, s2)


@pytest.mark.parametrize("check_exact", [True, False])
def test_series_equal_decimals(check_exact: bool) -> None:
    s1 = pl.Series([D("1.00000"), D("2.00000")], dtype=pl.Decimal)
    s2 = pl.Series([D("1.00000"), D("2.00001")], dtype=pl.Decimal)

    assert_series_equal(s1, s1, check_exact=check_exact)
    assert_series_equal(s2, s2, check_exact=check_exact)

    with pytest.raises(AssertionError, match="exact value mismatch"):
        assert_series_equal(s1, s2, check_exact=check_exact)


def test_assert_series_equal_w_large_integers_12328() -> None:
    left = pl.Series([1577840521123000])
    right = pl.Series([1577840521123543])
    with pytest.raises(AssertionError):
        assert_series_equal(left, right)


def test_assert_series_equal_check_dtype_deprecated() -> None:
    s1 = pl.Series("a", [1, 2])
    s2 = pl.Series("a", [1.0, 2.0])
    s3 = pl.Series("a", [2, 1])

    with pytest.deprecated_call():
        assert_series_equal(s1, s2, check_dtype=False)  # type: ignore[call-arg]

    with pytest.deprecated_call():
        assert_series_not_equal(s1, s3, check_dtype=False)  # type: ignore[call-arg]


def test_assert_series_equal_nested_categorical_as_str_independently_constructed() -> (
    None
):
    # https://github.com/pola-rs/polars/issues/16196
    s1 = pl.Series(["c0"], dtype=pl.Categorical)
    s2 = pl.Series(["c1"], dtype=pl.Categorical)
    a = pl.DataFrame([s1, s2]).to_struct("col0")

    s1 = pl.Series(["c0"], dtype=pl.Categorical)
    s2 = pl.Series(["c1"], dtype=pl.Categorical)
    b = pl.DataFrame([s1, s2]).to_struct("col0")

    assert_series_equal(a, b, categorical_as_str=True)
    assert_series_equal(a, b, categorical_as_str=False)


@pytest.mark.parametrize(
    "s",
    [
        pl.Series([["a", "b"], ["a"]], dtype=pl.List(pl.Categorical)),
        pl.Series([{"a": "x"}, {"a": "y"}], dtype=pl.Struct({"a": pl.Categorical})),
    ],
)
def test_assert_series_equal_nested_categorical_as_str(s: pl.Series) -> None:
    assert_series_equal(s, s, categorical_as_str=True)


def test_tracebackhide(testdir: pytest.Testdir) -> None:
    testdir.makefile(
        ".py",
        test_path="""\
import polars as pl
from polars.testing import assert_series_equal, assert_series_not_equal

nan = float("nan")

def test_series_equal_fail():
    s1 = pl.Series([1, 2])
    s2 = pl.Series([1, 3])
    assert_series_equal(s1, s2)

def test_series_not_equal_fail():
    s1 = pl.Series([1, 2])
    s2 = pl.Series([1, 2])
    assert_series_not_equal(s1, s2)

def test_series_nested_fail():
    s1 = pl.Series([[1, 2], [3, 4]])
    s2 = pl.Series([[1, 2], [3, 5]])
    assert_series_equal(s1, s2)

def test_series_null_fail():
    s1 = pl.Series([1, 2])
    s2 = pl.Series([1, None])
    assert_series_equal(s1, s2)

def test_series_nan_fail():
    s1 = pl.Series([1.0, 2.0])
    s2 = pl.Series([1.0, nan])
    assert_series_equal(s1, s2)

def test_series_float_tolerance_fail():
    s1 = pl.Series([1.0, 2.0])
    s2 = pl.Series([1.0, 2.1])
    assert_series_equal(s1, s2)

def test_series_schema_fail():
    s1 = pl.Series([1, 2], dtype=pl.Int64)
    s2 = pl.Series([1, 2], dtype=pl.Int32)
    assert_series_equal(s1, s2)

def test_series_data_type_fail():
    s1 = pl.Series([1, 2])
    s2 = [1, 2]
    assert_series_equal(s1, s2)
""",
    )
    result = testdir.runpytest()
    result.assert_outcomes(passed=0, failed=8)
    stdout = "\n".join(result.outlines)

    assert "polars/py-polars/polars/testing" not in stdout

    # The above should catch any polars testing functions that appear in the
    # stack trace. But we keep the following checks (for specific function
    # names) just to double-check.

    assert "def assert_series_equal" not in stdout
    assert "def assert_series_not_equal" not in stdout

    # Make sure the tests are failing for the expected reason (e.g. not because
    # an import is missing or something like that):

    assert "AssertionError: Series are different (exact value mismatch)" in stdout
    assert "AssertionError: Series are equal" in stdout
    assert "AssertionError: Series are different (nan value mismatch)" in stdout
    assert "AssertionError: Series are different (dtype mismatch)" in stdout
    assert "AssertionError: inputs are different (unexpected input types)" in stdout


def test_assert_series_equal_inf() -> None:
    s1 = pl.Series([1.0, float("inf")])
    s2 = pl.Series([1.0, float("inf")])
    assert_series_equal(s1, s2)

    s1 = pl.Series([1.0, float("-inf")])
    s2 = pl.Series([1.0, float("-inf")])
    assert_series_equal(s1, s2)

    s1 = pl.Series([1.0, float("inf")])
    s2 = pl.Series([float("inf"), 1.0])
    assert_series_not_equal(s1, s2)

    s1 = pl.Series([1.0, float("inf")])
    s2 = pl.Series([1.0, float("-inf")])
    assert_series_not_equal(s1, s2)

    s1 = pl.Series([1.0, float("inf")])
    s2 = pl.Series([1.0, 2.0])
    assert_series_not_equal(s1, s2)

    s1 = pl.Series([1.0, float("inf")])
    s2 = pl.Series([1.0, float("nan")])
    assert_series_not_equal(s1, s2)
