Merge remote-tracking branch 'upstream/main' into update-DataFrame.from_records

Author: loicdiridollou

.github/setup/action.yaml

@@ -13,7 +13,7 @@ runs:
   using: composite
   steps:
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ inputs.python-version }}
 

.github/workflows/comment_commands.yml

@@ -25,7 +25,7 @@ jobs:
         # get the sha of the last commit to attach the results of the tests
         if: always()
         id: get-branch-info
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -39,7 +39,7 @@ jobs:
             core.setOutput('repository', pr.data.head.repo.full_name)
 
       - name: Checkout code on the correct branch
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           # context is not aware which branch to checkout so it would otherwise
           # default to main (we also need repo name to source from the right user
@@ -61,7 +61,7 @@ jobs:
       - name: Report results of the tests and publish
         # publish the results to a check run no matter the pass or fail
         if: always()
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |

.github/workflows/optional.yml

@@ -12,7 +12,7 @@ jobs:
     timeout-minutes: 10
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
 
     - name: Install project dependencies
       uses: ./.github/setup
@@ -28,7 +28,7 @@ jobs:
     timeout-minutes: 10
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
 
     - name: Install project dependencies
       uses: ./.github/setup
@@ -44,7 +44,7 @@ jobs:
     timeout-minutes: 10
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
 
     - name: Install project dependencies
       uses: ./.github/setup

.github/workflows/test.yml

@@ -19,12 +19,12 @@ jobs:
       matrix:
         # macos-latest is arm
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     name: OS ${{ matrix.os }} - Python ${{ matrix.python-version }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Install project dependencies
         uses: ./.github/setup
@@ -55,6 +55,6 @@ jobs:
     timeout-minutes: 10
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
-      - uses: pre-commit/action@v3.0.0
+      - uses: pre-commit/action@v3.0.1

.pre-commit-config.yaml

@@ -2,29 +2,22 @@ minimum_pre_commit_version: 2.15.0
 ci:
     autofix_prs: false
 repos:
--   repo: https://github.com/python/black
-    rev: 25.1.0
-    hooks:
-    -   id: black
--   repo: https://github.com/PyCQA/isort
-    rev: 6.0.1
-    hooks:
-    -   id: isort
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.10
+    rev: v0.14.2
     hooks:
     -   id: ruff-check
-        args: [
-          --exit-non-zero-on-fix,
-          --target-version, py39,
-          --extend-select, "PYI,UP,RUF100",
-          --ignore, "E501,E731,F841,PYI042",
-          --per-file-ignores, "_*.pyi:PYI001",
-          --fix
-        ]
+        args: [--exit-non-zero-on-fix]
 -   repo: https://github.com/codespell-project/codespell
     rev: v2.4.1
     hooks:
     - id: codespell
       additional_dependencies: [ tomli ]
       args: [-L, "THIRDPARTY"]
+-   repo: https://github.com/PyCQA/isort
+    rev: 6.0.1
+    hooks:
+    -   id: isort
+-   repo: https://github.com/psf/black
+    rev: 25.9.0
+    hooks:
+    -   id: black

conftest.py

@@ -1,10 +1,11 @@
+from collections.abc import Generator
 import gc
 
 import pytest
 
 
 @pytest.fixture
-def mpl_cleanup():
+def mpl_cleanup() -> Generator[None, None, None]:
     """
     Ensure Matplotlib is cleaned up around a test.
 

docs/philosophy.md

@@ -55,12 +55,12 @@ revealed by `mypy` as follows:
 ```text
 ttest.py:5: note: Revealed type is "pandas.core.series.Series[pandas._libs.tslibs.timestamps.Timestamp]"
 ttest.py:7: note: Revealed type is "pandas.core.series.Series[pandas._libs.tslibs.timestamps.Timestamp]"
-ttest.py:9: note: Revealed type is "pandas.core.series.TimedeltaSeries"
+ttest.py:9: note: Revealed type is "pandas.core.series.Series[pandas._libs.tslibs.timestamps.Timedelta]"
 ttest.py:10: error: Unsupported operand types for + ("Series[Timestamp]" and "Series[Timestamp]")  [operator]
 ```
 
 The type `Series[Timestamp]` is the result of creating a series from `pd.to_datetime()`, while
-the type `TimedeltaSeries` is the result of subtracting two `Series[Timestamp]` as well as
+the type `Series[Timedelta]` is the result of subtracting two `Series[Timestamp]` as well as
 the result of `pd.to_timedelta()`.
 
 ### Progressive arithmetic typing for generic Series

pandas-stubs/__init__.pyi

@@ -94,7 +94,6 @@ from pandas._config import (
 )
 
 from pandas.util._print_versions import show_versions as show_versions
-from pandas.util._tester import test as test
 
 from pandas.io.api import (
     ExcelFile as ExcelFile,

pandas-stubs/_config/config.pyi

@@ -15,7 +15,7 @@ def reset_option(pat: str) -> None: ...
 @overload
 def describe_option(pat: str, _print_desc: Literal[False]) -> str: ...
 @overload
-def describe_option(pat: str, _print_desc: Literal[True] = ...) -> None: ...
+def describe_option(pat: str, _print_desc: Literal[True] = True) -> None: ...
 
 class DictWrapper:
     def __init__(self, d: dict[str, Any], prefix: str = ...) -> None: ...

pandas-stubs/_libs/interval.pyi

@@ -4,22 +4,21 @@ from typing import (
     Literal,
     TypeVar,
     overload,
+    type_check_only,
 )
 
-import numpy as np
 from pandas import (
     IntervalIndex,
     Series,
     Timedelta,
     Timestamp,
 )
-from pandas.core.series import TimedeltaSeries
 
 from pandas._typing import (
     IntervalClosedType,
     IntervalT,
-    np_1darray,
-    npt,
+    np_1darray_bool,
+    np_ndarray,
 )
 
 VALID_CLOSED: frozenset[str]
@@ -28,6 +27,7 @@ _OrderableScalarT = TypeVar("_OrderableScalarT", bound=int | float)
 _OrderableTimesT = TypeVar("_OrderableTimesT", bound=Timestamp | Timedelta)
 _OrderableT = TypeVar("_OrderableT", bound=int | float | Timestamp | Timedelta)
 
+@type_check_only
 class _LengthDescriptor:
     @overload
     def __get__(
@@ -38,8 +38,9 @@ class _LengthDescriptor:
         self, instance: Interval[_OrderableTimesT], owner: Any
     ) -> Timedelta: ...
     @overload
-    def __get__(self, instance: IntervalTree, owner: Any) -> np.ndarray: ...
+    def __get__(self, instance: IntervalMixin, owner: Any) -> np_ndarray: ...
 
+@type_check_only
 class _MidDescriptor:
     @overload
     def __get__(self, instance: Interval[_OrderableScalarT], owner: Any) -> float: ...
@@ -48,7 +49,7 @@ class _MidDescriptor:
         self, instance: Interval[_OrderableTimesT], owner: Any
     ) -> _OrderableTimesT: ...
     @overload
-    def __get__(self, instance: IntervalTree, owner: Any) -> np.ndarray: ...
+    def __get__(self, instance: IntervalMixin, owner: Any) -> np_ndarray: ...
 
 class IntervalMixin:
     @property
@@ -69,8 +70,8 @@ class Interval(IntervalMixin, Generic[_OrderableT]):
     def right(self: Interval[_OrderableT]) -> _OrderableT: ...
     @property
     def closed(self) -> IntervalClosedType: ...
-    mid: _MidDescriptor
-    length: _LengthDescriptor
+    mid = _MidDescriptor()
+    length = _LengthDescriptor()
     def __init__(
         self,
         left: _OrderableT,
@@ -167,78 +168,47 @@ class Interval(IntervalMixin, Generic[_OrderableT]):
     @overload
     def __gt__(self, other: Interval[_OrderableT]) -> bool: ...
     @overload
-    def __gt__(
-        self: IntervalT, other: IntervalIndex[IntervalT]
-    ) -> np_1darray[np.bool]: ...
+    def __gt__(self: IntervalT, other: IntervalIndex[IntervalT]) -> np_1darray_bool: ...
     @overload
     def __gt__(
         self,
-        other: Series[int] | Series[float] | Series[Timestamp] | TimedeltaSeries,
+        other: Series[int] | Series[float] | Series[Timestamp] | Series[Timedelta],
     ) -> Series[bool]: ...
     @overload
     def __lt__(self, other: Interval[_OrderableT]) -> bool: ...
     @overload
-    def __lt__(
-        self: IntervalT, other: IntervalIndex[IntervalT]
-    ) -> np_1darray[np.bool]: ...
+    def __lt__(self: IntervalT, other: IntervalIndex[IntervalT]) -> np_1darray_bool: ...
     @overload
     def __lt__(
         self,
-        other: Series[int] | Series[float] | Series[Timestamp] | TimedeltaSeries,
+        other: Series[int] | Series[float] | Series[Timestamp] | Series[Timedelta],
     ) -> Series[bool]: ...
     @overload
     def __ge__(self, other: Interval[_OrderableT]) -> bool: ...
     @overload
-    def __ge__(
-        self: IntervalT, other: IntervalIndex[IntervalT]
-    ) -> np_1darray[np.bool]: ...
+    def __ge__(self: IntervalT, other: IntervalIndex[IntervalT]) -> np_1darray_bool: ...
     @overload
     def __ge__(
         self,
-        other: Series[int] | Series[float] | Series[Timestamp] | TimedeltaSeries,
+        other: Series[int] | Series[float] | Series[Timestamp] | Series[Timedelta],
     ) -> Series[bool]: ...
     @overload
     def __le__(self, other: Interval[_OrderableT]) -> bool: ...
     @overload
-    def __le__(
-        self: IntervalT, other: IntervalIndex[IntervalT]
-    ) -> np_1darray[np.bool]: ...
+    def __le__(self: IntervalT, other: IntervalIndex[IntervalT]) -> np_1darray_bool: ...
     @overload
     def __eq__(self, other: Interval[_OrderableT]) -> bool: ...  # type: ignore[overload-overlap] # pyright: ignore[reportOverlappingOverload]
     @overload
-    def __eq__(
-        self: IntervalT, other: IntervalIndex[IntervalT]
-    ) -> np_1darray[np.bool]: ...
+    def __eq__(self: IntervalT, other: IntervalIndex[IntervalT]) -> np_1darray_bool: ...
     @overload
     def __eq__(self, other: Series[_OrderableT]) -> Series[bool]: ...  # type: ignore[overload-overlap]
     @overload
     def __eq__(self, other: object) -> Literal[False]: ...
     @overload
     def __ne__(self, other: Interval[_OrderableT]) -> bool: ...  # type: ignore[overload-overlap] # pyright: ignore[reportOverlappingOverload]
     @overload
-    def __ne__(
-        self: IntervalT, other: IntervalIndex[IntervalT]
-    ) -> np_1darray[np.bool]: ...
+    def __ne__(self: IntervalT, other: IntervalIndex[IntervalT]) -> np_1darray_bool: ...
     @overload
     def __ne__(self, other: Series[_OrderableT]) -> Series[bool]: ...  # type: ignore[overload-overlap]
     @overload
     def __ne__(self, other: object) -> Literal[True]: ...
-
-class IntervalTree(IntervalMixin):
-    def __init__(
-        self,
-        left: np.ndarray,
-        right: np.ndarray,
-        closed: IntervalClosedType = ...,
-        leaf_size: int = ...,
-    ) -> None: ...
-    def get_indexer(self, target) -> npt.NDArray[np.intp]: ...
-    def get_indexer_non_unique(
-        self, target
-    ) -> tuple[npt.NDArray[np.intp], npt.NDArray[np.intp]]: ...
-    _na_count: int
-    @property
-    def is_overlapping(self) -> bool: ...
-    @property
-    def is_monotonic_increasing(self) -> bool: ...
-    def clear_mapping(self) -> None: ...