dycw-utilities 0.166.15__tar.gz → 0.166.17__tar.gz

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.166.15
+Version: 0.166.17
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -18,13 +18,13 @@ Requires-Dist: pytest-cov<6.3,>=6.2.1; extra == 'test'
 Requires-Dist: pytest-instafail<0.6,>=0.5.0; extra == 'test'
 Requires-Dist: pytest-lazy-fixtures<1.4,>=1.3.4; extra == 'test'
 Requires-Dist: pytest-randomly<3.17,>=3.16.0; extra == 'test'
-Requires-Dist: pytest-regressions<2.9,>=2.8.2; extra == 'test'
+Requires-Dist: pytest-regressions<2.9,>=2.8.3; extra == 'test'
 Requires-Dist: pytest-repeat<0.10,>=0.9.4; extra == 'test'
 Requires-Dist: pytest-rerunfailures<16.1,>=16.0.1; extra == 'test'
 Requires-Dist: pytest-rng<1.1,>=1.0.0; extra == 'test'
 Requires-Dist: pytest-timeout<2.5,>=2.4.0; extra == 'test'
 Requires-Dist: pytest-xdist<3.9,>=3.8.0; extra == 'test'
-Requires-Dist: pytest<8.5,>=8.4.1; extra == 'test'
+Requires-Dist: pytest<8.5,>=8.4.2; extra == 'test'
 Requires-Dist: testbook<0.5,>=0.4.2; extra == 'test'
 Description-Content-Type: text/markdown
 

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/pyproject.toml

@@ -160,14 +160,14 @@ pyinstrument = [
   "pyinstrument >=5.1.0, <5.2",
 ]
 pytest = [
-  "pytest >=8.4.1, <8.5",
+  "pytest >=8.4.2, <8.5",
   "pytest-asyncio >=1.1.0, <1.2",
   "pytest-randomly >=3.16.0, <3.17",
   "pytest-timeout >=2.4.0, <2.5",
   "pytest-xdist >=3.8.0, <3.9",
 ]
 pytest-regressions = [
-  "pytest-regressions >=2.8.2, <2.9",
+  "pytest-regressions >=2.8.3, <2.9",
 ]
 pytest-regressions-test = [
   "orjson",
@@ -246,7 +246,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.166.15"
+version = "0.166.17"
 
 [project.entry-points.pytest11]
 pytest-randomly = "utilities.pytest_plugins.pytest_randomly"
@@ -259,13 +259,13 @@ logging = [
 test = [
   "dycw-pytest-only >=2.1.1, <2.2",
   "hypothesis >=6.138.13, <6.139",
-  "pytest >=8.4.1, <8.5",
+  "pytest >=8.4.2, <8.5",
   "pytest-asyncio >=1.1.0, <1.2",
   "pytest-cov >=6.2.1, <6.3",
   "pytest-instafail >=0.5.0, <0.6",
   "pytest-lazy-fixtures >=1.3.4, <1.4",
   "pytest-randomly >=3.16.0, <3.17",
-  "pytest-regressions >=2.8.2, <2.9",
+  "pytest-regressions >=2.8.3, <2.9",
   "pytest-repeat >=0.9.4, <0.10",
   "pytest-rerunfailures >=16.0.1, <16.1",
   "pytest-rng >=1.0.0, <1.1",
@@ -279,7 +279,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.166.15"
+current_version = "0.166.17"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/src/tests/test_polars.py

@@ -6,7 +6,7 @@ import itertools
 import math
 from dataclasses import dataclass, field
 from enum import auto
-from itertools import chain, repeat
+from itertools import chain
 from math import isfinite, nan
 from random import Random
 from typing import TYPE_CHECKING, Any, ClassVar, Literal, assert_never, cast
@@ -49,6 +49,7 @@ from polars import (
     col,
     concat,
     date_range,
+    datetime_range,
     int_range,
     lit,
     struct,
@@ -58,7 +59,14 @@ from polars.schema import Schema
 from polars.testing import assert_frame_equal, assert_series_equal
 from pytest import mark, param, raises
 from scipy.stats import norm
-from whenever import DateDelta, DateTimeDelta, PlainDateTime, TimeDelta, ZonedDateTime
+from whenever import (
+    Date,
+    DateDelta,
+    DateTimeDelta,
+    PlainDateTime,
+    TimeDelta,
+    ZonedDateTime,
+)
 
 import tests.test_math
 import utilities.polars
@@ -168,6 +176,9 @@ from utilities.polars import (
     ensure_expr_or_series,
     ensure_expr_or_series_many,
     expr_to_series,
+    false_like,
+    filter_date,
+    filter_time,
     finite_ewm_mean,
     first_true_horizontal,
     get_data_type_or_series_time_zone,
@@ -208,6 +219,7 @@ from utilities.polars import (
     to_not_true,
     to_true,
     touch,
+    true_like,
     try_reify_expr,
     uniform,
     unique_element,
@@ -1479,6 +1491,42 @@ class TestExprToSeries:
         assert_series_equal(series, expected)
 
 
+class TestComputeDateFilter:
+    def test_main(self) -> None:
+        series = datetime_range(
+            start=ZonedDateTime(2024, 1, 1, tz=UTC.key).py_datetime(),
+            end=ZonedDateTime(2024, 1, 4, 12, tz=UTC.key).py_datetime(),
+            interval="12h",
+            eager=True,
+        ).alias("datetime")
+        assert len(series) == 8
+        result = filter_date(series, include=[Date(2024, 1, 2), Date(2024, 1, 3)])
+        expected = Series(
+            name="datetime",
+            values=[False, False, True, True, True, True, False, False],
+            dtype=Boolean,
+        )
+        assert_series_equal(result, expected)
+
+
+class TestComputeTimeFilter:
+    def test_main(self) -> None:
+        series = datetime_range(
+            start=ZonedDateTime(2024, 1, 1, tz=UTC.key).py_datetime(),
+            end=ZonedDateTime(2024, 1, 3, 0, tz=UTC.key).py_datetime(),
+            interval="6h",
+            eager=True,
+        ).alias("datetime")
+        assert len(series) == 9
+        result = filter_time(series, include=[(whenever.Time(6), whenever.Time(12))])
+        expected = Series(
+            name="datetime",
+            values=[False, True, True, False, False, True, True, False, False],
+            dtype=Boolean,
+        )
+        assert_series_equal(result, expected)
+
+
 class TestFiniteEWMMean:
     alpha_0_75_values: ClassVar[list[float]] = [
         -8.269850726503885,
@@ -1838,7 +1886,9 @@ class TestIsNearEvent:
     def test_no_exprs(self) -> None:
         result = self.df.with_columns(is_near_event().alias("z"))["z"]
         expected = Series(
-            name="z", values=list(repeat(object=False, times=10)), dtype=Boolean
+            name="z",
+            values=list(itertools.repeat(object=False, times=10)),
+            dtype=Boolean,
         )
         assert_series_equal(result, expected)
 
@@ -2783,6 +2833,60 @@ class TestToTrueAndFalse:
         assert_series_equal(result, exp_series)
 
 
+class TestTrueLikeAndFalseLike:
+    @given(length=hypothesis.strategies.integers(0, 10), name=text_ascii())
+    def test_true_expr(self, *, length: int, name: str) -> None:
+        expr = int_range(end=length).alias(name)
+        result = true_like(expr)
+        assert isinstance(result, Expr)
+        result2 = (
+            int_range(end=length, eager=True)
+            .alias(f"_{name}")
+            .to_frame()
+            .with_columns(result)[name]
+        )
+        expected = pl.repeat(value=True, n=length, dtype=Boolean, eager=True).alias(
+            name
+        )
+        assert_series_equal(result2, expected)
+
+    @given(length=hypothesis.strategies.integers(0, 10), name=text_ascii())
+    def test_true_series(self, *, length: int, name: str) -> None:
+        series = int_range(end=length, eager=True).alias(name)
+        result = true_like(series)
+        assert isinstance(result, Series)
+        expected = pl.repeat(value=True, n=length, dtype=Boolean, eager=True).alias(
+            name
+        )
+        assert_series_equal(result, expected)
+
+    @given(length=hypothesis.strategies.integers(0, 10), name=text_ascii())
+    def test_false_expr(self, *, length: int, name: str) -> None:
+        expr = int_range(end=length).alias(name)
+        result = false_like(expr)
+        assert isinstance(result, Expr)
+        result2 = (
+            int_range(end=length, eager=True)
+            .alias(f"_{name}")
+            .to_frame()
+            .with_columns(result)[name]
+        )
+        expected = pl.repeat(value=False, n=length, dtype=Boolean, eager=True).alias(
+            name
+        )
+        assert_series_equal(result2, expected)
+
+    @given(length=hypothesis.strategies.integers(0, 10), name=text_ascii())
+    def test_false_series(self, *, length: int, name: str) -> None:
+        series = int_range(end=length, eager=True).alias(name)
+        result = false_like(series)
+        assert isinstance(result, Series)
+        expected = pl.repeat(value=False, n=length, dtype=Boolean, eager=True).alias(
+            name
+        )
+        assert_series_equal(result, expected)
+
+
 class TestTryReifyExpr:
     # expr
 

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/src/tests/test_pydantic_settings.py

@@ -8,12 +8,17 @@ import yaml
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 from utilities.os import temp_environ
-from utilities.pydantic_settings import CustomBaseSettings, load_settings
+from utilities.pydantic_settings import (
+    CustomBaseSettings,
+    PathLikeOrWithSection,
+    load_settings,
+)
 
 if TYPE_CHECKING:
+    from collections.abc import Sequence
     from pathlib import Path
 
-    from utilities.types import MaybeIterable, PathLike
+    from utilities.types import PathLike
 
 
 class TestCustomBaseSettings:
@@ -22,7 +27,7 @@ class TestCustomBaseSettings:
         _ = file.write_text(json.dumps({"x": 1}))
 
         class Settings(CustomBaseSettings):
-            json_files: ClassVar[MaybeIterable[PathLike]] = file
+            json_files: ClassVar[Sequence[PathLike]] = [file]
             x: int
 
         settings = load_settings(Settings)
@@ -33,7 +38,31 @@ class TestCustomBaseSettings:
         _ = file.write_text(tomlkit.dumps({"x": 1}))
 
         class Settings(CustomBaseSettings):
-            toml_files: ClassVar[MaybeIterable[PathLike]] = file
+            toml_files: ClassVar[Sequence[PathLikeOrWithSection]] = [file]
+            x: int
+
+        settings = load_settings(Settings)
+        assert settings.x == 1
+
+    def test_toml_section_str(self, *, tmp_path: Path) -> None:
+        file = tmp_path.joinpath("settings.toml")
+        _ = file.write_text(tomlkit.dumps({"outer": {"x": 1}}))
+
+        class Settings(CustomBaseSettings):
+            toml_files: ClassVar[Sequence[PathLikeOrWithSection]] = [(file, "outer")]
+            x: int
+
+        settings = load_settings(Settings)
+        assert settings.x == 1
+
+    def test_toml_section_nested(self, *, tmp_path: Path) -> None:
+        file = tmp_path.joinpath("settings.toml")
+        _ = file.write_text(tomlkit.dumps({"outer": {"middle": {"x": 1}}}))
+
+        class Settings(CustomBaseSettings):
+            toml_files: ClassVar[Sequence[PathLikeOrWithSection]] = [
+                (file, ["outer", "middle"])
+            ]
             x: int
 
         settings = load_settings(Settings)
@@ -44,7 +73,7 @@ class TestCustomBaseSettings:
         _ = file.write_text(yaml.dump({"x": 1}))
 
         class Settings(CustomBaseSettings):
-            yaml_files: ClassVar[MaybeIterable[PathLike]] = file
+            yaml_files: ClassVar[Sequence[PathLike]] = [file]
             x: int
 
         settings = load_settings(Settings)

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/src/tests/test_pydantic_settings_sops.py

@@ -13,9 +13,10 @@ from utilities.pydantic_settings_sops import SopsBaseSettings
 from utilities.re import extract_group
 
 if TYPE_CHECKING:
+    from collections.abc import Sequence
     from pathlib import Path
 
-    from utilities.types import MaybeIterable, PathLike
+    from utilities.types import PathLike
 
 
 class TestSOPSBaseSettings:
@@ -39,7 +40,7 @@ class TestSOPSBaseSettings:
             _ = check_call(["sops", "encrypt", str(unencrypted_file)], stdout=file)
 
         class Settings(SopsBaseSettings):
-            secret_files: ClassVar[MaybeIterable[PathLike]] = encrypted_file
+            secret_files: ClassVar[Sequence[PathLike]] = [encrypted_file]
             x: int
             y: int
 

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.166.15"
+__version__ = "0.166.17"

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/src/utilities/polars.py

@@ -70,6 +70,7 @@ from utilities.iterables import (
     check_supermapping,
     is_iterable_not_str,
     one,
+    resolve_include_and_exclude,
 )
 from utilities.json import write_formatted_json
 from utilities.math import (
@@ -1269,6 +1270,111 @@ def expr_to_series(expr: Expr, /) -> Series:
 ##
 
 
+@overload
+def filter_date(
+    column: ExprLike = "datetime",
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[whenever.Date] | None = None,
+    exclude: MaybeIterable[whenever.Date] | None = None,
+) -> Expr: ...
+@overload
+def filter_date(
+    column: Series,
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[whenever.Date] | None = None,
+    exclude: MaybeIterable[whenever.Date] | None = None,
+) -> Series: ...
+@overload
+def filter_date(
+    column: IntoExprColumn = "datetime",
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[whenever.Date] | None = None,
+    exclude: MaybeIterable[whenever.Date] | None = None,
+) -> ExprOrSeries: ...
+def filter_date(
+    column: IntoExprColumn = "datetime",
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[whenever.Date] | None = None,
+    exclude: MaybeIterable[whenever.Date] | None = None,
+) -> ExprOrSeries:
+    """Compute the filter based on a set of dates."""
+    column = ensure_expr_or_series(column)
+    if time_zone is not None:
+        column = column.dt.convert_time_zone(time_zone.key)
+    keep = true_like(column)
+    date = column.dt.date()
+    include, exclude = resolve_include_and_exclude(include=include, exclude=exclude)
+    if include is not None:
+        keep &= date.is_in([d.py_date() for d in include])
+    if exclude is not None:
+        keep &= ~date.is_in([d.py_date() for d in exclude])
+    return try_reify_expr(keep, column)
+
+
+@overload
+def filter_time(
+    column: ExprLike = "datetime",
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+    exclude: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+) -> Expr: ...
+@overload
+def filter_time(
+    column: Series,
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+    exclude: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+) -> Series: ...
+@overload
+def filter_time(
+    column: IntoExprColumn = "datetime",
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+    exclude: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+) -> ExprOrSeries: ...
+def filter_time(
+    column: IntoExprColumn = "datetime",
+    /,
+    *,
+    time_zone: ZoneInfo | None = None,
+    include: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+    exclude: MaybeIterable[tuple[whenever.Time, whenever.Time]] | None = None,
+) -> ExprOrSeries:
+    """Compute the filter based on a set of times."""
+    column = ensure_expr_or_series(column)
+    if time_zone is not None:
+        column = column.dt.convert_time_zone(time_zone.key)
+    keep = true_like(column)
+    time = column.dt.time()
+    include, exclude = resolve_include_and_exclude(include=include, exclude=exclude)
+    if include is not None:
+        keep &= any_horizontal(
+            time.is_between(s.py_time(), e.py_time()) for s, e in include
+        )
+    if exclude is not None:
+        keep &= ~any_horizontal(
+            time.is_between(s.py_time(), e.py_time()) for s, e in exclude
+        )
+    return try_reify_expr(keep, column)
+
+
+##
+
+
 @overload
 def finite_ewm_mean(
     column: ExprLike,
@@ -2643,6 +2749,33 @@ def to_not_false(column: IntoExprColumn, /) -> ExprOrSeries:
 ##
 
 
+@overload
+def true_like(column: ExprLike, /) -> Expr: ...
+@overload
+def true_like(column: Series, /) -> Series: ...
+@overload
+def true_like(column: IntoExprColumn, /) -> ExprOrSeries: ...
+def true_like(column: IntoExprColumn, /) -> ExprOrSeries:
+    """Compute a column of `True` values."""
+    column = ensure_expr_or_series(column)
+    return column.is_null() | column.is_not_null()
+
+
+@overload
+def false_like(column: ExprLike, /) -> Expr: ...
+@overload
+def false_like(column: Series, /) -> Series: ...
+@overload
+def false_like(column: IntoExprColumn, /) -> ExprOrSeries: ...
+def false_like(column: IntoExprColumn, /) -> ExprOrSeries:
+    """Compute a column of `False` values."""
+    column = ensure_expr_or_series(column)
+    return column.is_null() & column.is_not_null()
+
+
+##
+
+
 def try_reify_expr(
     expr: IntoExprColumn, /, *exprs: IntoExprColumn, **named_exprs: IntoExprColumn
 ) -> ExprOrSeries:
@@ -2798,6 +2931,9 @@ __all__ = [
     "ensure_expr_or_series",
     "ensure_expr_or_series_many",
     "expr_to_series",
+    "false_like",
+    "filter_date",
+    "filter_time",
     "finite_ewm_mean",
     "first_true_horizontal",
     "get_data_type_or_series_time_zone",
@@ -2838,6 +2974,7 @@ __all__ = [
     "to_not_true",
     "to_true",
     "touch",
+    "true_like",
     "try_reify_expr",
     "uniform",
     "unique_element",

dycw_utilities-0.166.17/src/utilities/pydantic_settings.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+from functools import reduce
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, ClassVar, assert_never, override
+
+from pydantic_settings import (
+    BaseSettings,
+    JsonConfigSettingsSource,
+    PydanticBaseSettingsSource,
+    SettingsConfigDict,
+    TomlConfigSettingsSource,
+    YamlConfigSettingsSource,
+)
+from pydantic_settings.sources import DEFAULT_PATH
+
+from utilities.iterables import always_iterable
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator, Sequence
+
+    from pydantic_settings.sources import PathType
+
+    from utilities.types import MaybeSequenceStr, PathLike
+
+
+type PathLikeOrWithSection = PathLike | tuple[PathLike, MaybeSequenceStr]
+
+
+class CustomBaseSettings(BaseSettings):
+    """Base settings for loading JSON files."""
+
+    # paths
+    json_files: ClassVar[Sequence[PathLike]] = []
+    toml_files: ClassVar[Sequence[PathLikeOrWithSection]] = []
+    yaml_files: ClassVar[Sequence[PathLike]] = []
+
+    # config
+    model_config: ClassVar[SettingsConfigDict] = SettingsConfigDict(
+        env_nested_delimiter="__"
+    )
+
+    @classmethod
+    @override
+    def settings_customise_sources(
+        cls,
+        settings_cls: type[BaseSettings],
+        init_settings: PydanticBaseSettingsSource,
+        env_settings: PydanticBaseSettingsSource,
+        dotenv_settings: PydanticBaseSettingsSource,
+        file_secret_settings: PydanticBaseSettingsSource,
+    ) -> tuple[PydanticBaseSettingsSource, ...]:
+        _ = (init_settings, dotenv_settings, file_secret_settings)
+        return tuple(cls._yield_base_settings_sources(settings_cls, env_settings))
+
+    @classmethod
+    def _yield_base_settings_sources(
+        cls,
+        settings_cls: type[BaseSettings],
+        env_settings: PydanticBaseSettingsSource,
+        /,
+    ) -> Iterator[PydanticBaseSettingsSource]:
+        yield env_settings
+        for file in cls.json_files:
+            yield JsonConfigSettingsSource(settings_cls, json_file=file)
+        for path_or_pair in cls.toml_files:
+            match path_or_pair:
+                case Path() | str() as file:
+                    yield TomlConfigSettingsSource(settings_cls, toml_file=file)
+                case Path() | str() as file, str() | list() | tuple() as section:
+                    yield TomlConfigSectionSettingsSource(
+                        settings_cls, toml_file=file, section=section
+                    )
+                case never:
+                    assert_never(never)
+        for file in cls.yaml_files:
+            yield YamlConfigSettingsSource(settings_cls, yaml_file=file)
+
+
+def load_settings[T: BaseSettings](cls: type[T], /) -> T:
+    """Load a set of settings."""
+    return cls()
+
+
+class TomlConfigSectionSettingsSource(TomlConfigSettingsSource):
+    @override
+    def __init__(
+        self,
+        settings_cls: type[BaseSettings],
+        toml_file: PathType | None = DEFAULT_PATH,
+        *,
+        section: MaybeSequenceStr,
+    ) -> None:
+        super().__init__(settings_cls, toml_file=toml_file)
+        self.section = section
+
+    @override
+    def __call__(self) -> dict[str, Any]:
+        return reduce(
+            lambda acc, el: acc.get(el, {}),
+            always_iterable(self.section),
+            super().__call__(),
+        )
+
+
+__all__ = ["CustomBaseSettings", "TomlConfigSectionSettingsSource", "load_settings"]

{dycw_utilities-0.166.15 → dycw_utilities-0.166.17}/src/utilities/pydantic_settings_sops.py

@@ -4,22 +4,21 @@ from typing import TYPE_CHECKING, ClassVar, override
 
 from pydantic_settings_sops import SOPSConfigSettingsSource
 
-from utilities.iterables import always_iterable
 from utilities.pydantic_settings import CustomBaseSettings
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Iterator, Sequence
 
     from pydantic_settings import BaseSettings, PydanticBaseSettingsSource
 
-    from utilities.types import MaybeIterable, PathLike
+    from utilities.types import PathLike
 
 
 class SopsBaseSettings(CustomBaseSettings):
     """Base settings for loading secrets using `sops/age`."""
 
     # paths
-    secret_files: ClassVar[MaybeIterable[PathLike]] = ()
+    secret_files: ClassVar[Sequence[PathLike]] = ()
 
     @classmethod
     @override
@@ -30,7 +29,7 @@ class SopsBaseSettings(CustomBaseSettings):
         /,
     ) -> Iterator[PydanticBaseSettingsSource]:
         yield from super()._yield_base_settings_sources(settings_cls, env_settings)
-        for file in always_iterable(cls.secret_files):
+        for file in cls.secret_files:
             yield SOPSConfigSettingsSource(
                 settings_cls,  # pyright: ignore[reportArgumentType],
                 json_file=file,