Skip to content

Commit ee8dcb7

Browse files
Backport PR #71429 on branch 3.1.x (DOC: add dedicated 3.1 whatsnew section for dependencies/build related changes) (#71447)
Co-authored-by: Joris Van den Bossche <[email protected]>
1 parent d93e32c commit ee8dcb7

1 file changed

Lines changed: 99 additions & 83 deletions

File tree

‎doc/source/whatsnew/v3.1.0.rst‎

Lines changed: 99 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -178,7 +178,6 @@ Other enhancements
178178
- Improved the precision of float parsing in :func:`read_csv` (:issue:`64395`)
179179
- Improved the string ``repr`` of :class:`pd.core.arrays.SparseArray` (:issue:`64547`)
180180
- Improved type inference of comparison and arithmetic operators on :class:`Series` and :class:`DataFrame` for static type checkers (e.g. ``ser == "a"`` is now inferred as :class:`Series` instead of ``Any``) (:issue:`40762`)
181-
- Removed Hypothesis as a test dependency (:issue:`66675`).
182181
- Setting values with :meth:`DataFrame.at` or :meth:`Series.at` using a non-scalar indexer (e.g. a boolean mask, list, or array) now raises a clearer ``InvalidIndexError`` directing users to ``.loc`` (:issue:`51866`)
183182
- Time strings with a space before ``AM``/``PM`` (e.g. ``"3:25:00 PM"``) are now recognized; :meth:`Series.between_time` and :meth:`DataFrame.between_time` previously raised on them, and :meth:`Series.at_time` and :meth:`DataFrame.at_time` warned that they would raise in a future version. Casting such strings to a pyarrow time dtype (``time32``/``time64``) no longer silently gives a missing value (:issue:`18793`)
184183
- Vertical bar plots with a regular-frequency :class:`DatetimeIndex` or :class:`PeriodIndex` now format the x-axis with the same dynamic date tick labeling as line plots, instead of labeling every bar with the full string representation of its timestamp. The tick labels of such plots are no longer rotated by default, matching line plots; pass ``rot`` to override. Bar plots over a frequency the date ticks cannot be aligned to — a multiplied business-day, monthly, quarterly or annual frequency such as ``"3B"`` or ``"2ME"`` — keep the previous labeling (:issue:`1918`)
@@ -320,79 +319,6 @@ If you actually need the specific resolution from the input data, use the
320319
:meth:`~Timestamp.as_unit` (or :meth:`Series.dt.as_unit`) method after
321320
construction to convert to the desired resolution.
322321

323-
.. _whatsnew_310.api_breaking.deps:
324-
325-
Increased minimum versions for dependencies
326-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
327-
Some minimum supported versions of dependencies were updated.
328-
If installed, we now require:
329-
330-
+-----------------+-----------------+----------+---------+
331-
| Package | Minimum Version | Required | Changed |
332-
+=================+=================+==========+=========+
333-
| numpy | 2.0.2 | X | X |
334-
+-----------------+-----------------+----------+---------+
335-
| python-dateutil | 2.9.0 | X | X |
336-
+-----------------+-----------------+----------+---------+
337-
338-
For `optional libraries <https://pandas.pydata.org/docs/getting_started/install.html>`_ the general recommendation is to use the latest version.
339-
The following table lists the lowest version per library that is currently being tested throughout the development of pandas.
340-
Optional libraries below the lowest tested version may still work, but are not considered supported.
341-
342-
+------------------------+-----------------+---------+
343-
| Package | Minimum Version | Changed |
344-
+========================+=================+=========+
345-
| adbc-driver-postgresql | 1.7.0 | X |
346-
+------------------------+-----------------+---------+
347-
| adbc-driver-sqlite | 1.7.0 | X |
348-
+------------------------+-----------------+---------+
349-
| beautifulsoup4 | 4.13.4 | X |
350-
+------------------------+-----------------+---------+
351-
| bottleneck | 1.5.0 | X |
352-
+------------------------+-----------------+---------+
353-
| fsspec | 2025.7.0 | X |
354-
+------------------------+-----------------+---------+
355-
| gcsfs | 2025.7.0 | X |
356-
+------------------------+-----------------+---------+
357-
| Jinja2 | 3.1.6 | X |
358-
+------------------------+-----------------+---------+
359-
| lxml | 6.0.0 | X |
360-
+------------------------+-----------------+---------+
361-
| matplotlib | 3.10.5 | X |
362-
+------------------------+-----------------+---------+
363-
| numba | 0.61.2 | X |
364-
+------------------------+-----------------+---------+
365-
| numexpr | 2.11.0 | X |
366-
+------------------------+-----------------+---------+
367-
| pyarrow | 16.0.0 | X |
368-
+------------------------+-----------------+---------+
369-
| PyQt5 | 5.15.11 | X |
370-
+------------------------+-----------------+---------+
371-
| pyiceberg | 0.9.1 | X |
372-
+------------------------+-----------------+---------+
373-
| pyreadstat | 1.3.0 | X |
374-
+------------------------+-----------------+---------+
375-
| pytables | 3.10.2 | X |
376-
+------------------------+-----------------+---------+
377-
| python-calamine | 0.4.0 | X |
378-
+------------------------+-----------------+---------+
379-
| qtpy | 2.4.3 | X |
380-
+------------------------+-----------------+---------+
381-
| s3fs | 2025.7.0 | X |
382-
+------------------------+-----------------+---------+
383-
| SciPy | 1.16.1 | X |
384-
+------------------------+-----------------+---------+
385-
| sqlalchemy | 2.0.42 | X |
386-
+------------------------+-----------------+---------+
387-
| xarray | 2025.7.1 | X |
388-
+------------------------+-----------------+---------+
389-
| xlrd | 2.0.2 | X |
390-
+------------------------+-----------------+---------+
391-
| xlsxwriter | 3.2.5 | X |
392-
+------------------------+-----------------+---------+
393-
394-
See :ref:`install.dependencies` and :ref:`install.optional_dependencies` for more.
395-
396322
.. _whatsnew_310.api_breaking.other:
397323

398324
Other API changes
@@ -425,15 +351,6 @@ Other API changes
425351
- ``numexpr`` 2.14.1 is no longer used to accelerate arithmetic and comparisons; some builds of that release intermittently and silently returned incorrect results, such as an all-zero column, for operations on large objects. pandas now falls back to NumPy, warning the first time an operation would have used ``numexpr``, and :func:`eval`, :meth:`DataFrame.eval` and :meth:`DataFrame.query` raise ``ImportError`` when passed an explicit ``engine="numexpr"``; install ``numexpr`` 2.14.2 or newer to restore the acceleration. HDF5 ``where=`` queries are evaluated by PyTables, which imports ``numexpr`` itself, and are neither covered nor warned about (:issue:`65408`)
426352
-
427353

428-
.. _whatsnew_310.api_breaking.build:
429-
430-
Build
431-
^^^^^
432-
- Building from source no longer fails on a checkout with CRLF line endings, such as under WSL (:issue:`64272`)
433-
- C++20 is required to build from source (:issue:`66735`)
434-
- MSVC is no longer required to build on Windows, and build errors when using the MinGW compiler have been fixed (:issue:`63160`)
435-
- Building from source no longer fails when compiling the windowing extensions against C++ standard libraries that provide only ``std::signbit`` (:issue:`50979`, :issue:`51047`)
436-
437354
.. ---------------------------------------------------------------------------
438355
.. _whatsnew_310.deprecations:
439356

@@ -637,6 +554,105 @@ Other deprecations
637554
selecting multiple columns; use a list instead. In a future version,
638555
tuple keys will raise ``KeyError`` (:issue:`66266`)
639556

557+
.. ---------------------------------------------------------------------------
558+
.. _whatsnew_310.packaging:
559+
560+
Dependencies and build changes
561+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
562+
563+
.. _whatsnew_310.packaging.numpy:
564+
565+
Pandas now requires NumPy >= 2
566+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
567+
568+
Support for NumPy 1.26 (and 1.x in general) has been dropped, and pandas now requires
569+
NumPy >= 2.0.2. Users with older versions of NumPy will need to upgrade to meet this requirement.
570+
571+
.. _whatsnew_310.packaging.deps:
572+
573+
Increased minimum versions for dependencies
574+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
575+
Some minimum supported versions of dependencies were updated.
576+
If installed, we now require:
577+
578+
+-----------------+---------------------+
579+
| Package | New minimum version |
580+
+=================+=====================+
581+
| numpy | 2.0.2 |
582+
+-----------------+---------------------+
583+
| python-dateutil | 2.9.0 |
584+
+-----------------+---------------------+
585+
586+
For :ref:`optional libraries <install.optional_dependencies>` the general recommendation is to use the latest version.
587+
The following table lists the lowest version per library that is currently being tested throughout the development of pandas.
588+
Optional libraries below the lowest tested version may still work, but are not considered supported.
589+
590+
+------------------------+---------------------+
591+
| Package | New minimum version |
592+
+========================+=====================+
593+
| adbc-driver-postgresql | 1.7.0 |
594+
+------------------------+---------------------+
595+
| adbc-driver-sqlite | 1.7.0 |
596+
+------------------------+---------------------+
597+
| beautifulsoup4 | 4.13.4 |
598+
+------------------------+---------------------+
599+
| bottleneck | 1.5.0 |
600+
+------------------------+---------------------+
601+
| fsspec | 2025.7.0 |
602+
+------------------------+---------------------+
603+
| gcsfs | 2025.7.0 |
604+
+------------------------+---------------------+
605+
| Jinja2 | 3.1.6 |
606+
+------------------------+---------------------+
607+
| lxml | 6.0.0 |
608+
+------------------------+---------------------+
609+
| matplotlib | 3.10.5 |
610+
+------------------------+---------------------+
611+
| numba | 0.61.2 |
612+
+------------------------+---------------------+
613+
| numexpr | 2.11.0 |
614+
+------------------------+---------------------+
615+
| pyarrow | 16.0.0 |
616+
+------------------------+---------------------+
617+
| PyQt5 | 5.15.11 |
618+
+------------------------+---------------------+
619+
| pyiceberg | 0.9.1 |
620+
+------------------------+---------------------+
621+
| pyreadstat | 1.3.0 |
622+
+------------------------+---------------------+
623+
| pytables | 3.10.2 |
624+
+------------------------+---------------------+
625+
| python-calamine | 0.4.0 |
626+
+------------------------+---------------------+
627+
| qtpy | 2.4.3 |
628+
+------------------------+---------------------+
629+
| s3fs | 2025.7.0 |
630+
+------------------------+---------------------+
631+
| SciPy | 1.16.1 |
632+
+------------------------+---------------------+
633+
| sqlalchemy | 2.0.42 |
634+
+------------------------+---------------------+
635+
| xarray | 2025.7.1 |
636+
+------------------------+---------------------+
637+
| xlrd | 2.0.2 |
638+
+------------------------+---------------------+
639+
| xlsxwriter | 3.2.5 |
640+
+------------------------+---------------------+
641+
642+
See :ref:`install.dependencies` and :ref:`install.optional_dependencies` for more.
643+
644+
In addition, Hypothesis has been removed as a test dependency (:issue:`66675`).
645+
646+
.. _whatsnew_310.packaging.build:
647+
648+
Build
649+
^^^^^
650+
- C++20 is required to build from source (:issue:`66735`)
651+
652+
- Building from source no longer fails on a checkout with CRLF line endings, such as under WSL (:issue:`64272`)
653+
- MSVC is no longer required to build on Windows, and build errors when using the MinGW compiler have been fixed (:issue:`63160`)
654+
- Building from source no longer fails when compiling the windowing extensions against C++ standard libraries that provide only ``std::signbit`` (:issue:`50979`, :issue:`51047`)
655+
640656
.. ---------------------------------------------------------------------------
641657
.. _whatsnew_310.performance:
642658

0 commit comments

Comments
 (0)