BUG: Fix OverflowError in lib.maybe_indices_to_slice()

[swt2c]

This fixes this error when slicing massive dataframes:

Traceback (most recent call last):
File "", line 1, in
File "/opt/anaconda3/lib/python3.12/site-packages/pandas/core/frame.py", line 4093, in getitem
return self._getitem_bool_array(key)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/anaconda3/lib/python3.12/site-packages/pandas/core/frame.py", line 4155, in _getitem_bool_array
return self._take_with_is_copy(indexer, axis=0)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/anaconda3/lib/python3.12/site-packages/pandas/core/generic.py", line 4153, in _take_with_is_copy
result = self.take(indices=indices, axis=axis)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/anaconda3/lib/python3.12/site-packages/pandas/core/generic.py", line 4133, in take
new_data = self._mgr.take(
^^^^^^^^^^^^^^^
File "/opt/anaconda3/lib/python3.12/site-packages/pandas/core/internals/managers.py", line 893, in take
new_labels = self.axes[axis].take(indexer)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/anaconda3/lib/python3.12/site-packages/pandas/core/indexes/datetimelike.py", line 839, in take
maybe_slice = lib.maybe_indices_to_slice(indices, len(self))
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "lib.pyx", line 522, in pandas._libs.lib.maybe_indices_to_slice
OverflowError: value too large to convert to int

• closes BUG: OverflowError: value too large to convert to int when manipulating very large dataframes #59531
• Tests added and passed if fixing a bug or adding a new feature (test not added because it requires a large amount of memory to reproduce this problem)
• All code checks passed.
• Added type annotations to new arguments/methods/functions (left the existing type-hint as-is because it seems int is correct from a Python perspective)
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature.

[swt2c]

This is a squash and rebase of #59537.

[mroeschke]

Can you also update pandas/_libs/lib.pyi like in https://github.com/pandas-dev/pandas/pull/59537/files?

[swt2c]

Can you also update pandas/_libs/lib.pyi like in https://github.com/pandas-dev/pandas/pull/59537/files?

If I do that, the CI fails. See the CI run for the "Sort whatsnew entries" commit for the errors. It seems like the type hint needs to stay as int?

[mroeschke]

I guess it's OK that the stubs aren't _perfectly aligned with the Cython signature.

[mroeschke]

Thanks @swt2c