@@ -4,9 +4,51 @@ Upgrading
44.. toctree ::
55 :maxdepth: 1
66
7+ Upgrading to 3.30.0
8+ -------------------
9+ Version 3.30.0 of the Python driver is the first release since the driver's donation
10+ to the Apache Software Foundation (ASF).
11+
12+ Supported Python Versions
13+ ^^^^^^^^^^^^^^^^^^^^^^^^^
14+ An individual version of the Python driver aims to officially support all Python runtimes
15+ that are not end-of-life (EOL) at the time of that version's release. For 3.30.0 this policy
16+ entails support for Python 3.10 through Python 3.14. The driver will likely continue to work
17+ reasonably well on older Python runtimes but only these versions are officially supported.
18+
19+ Conversion to pyproject.toml
20+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
21+ With this release we are moving away from the install and configuration process based on
22+ setup.py and towards the use of pyproject.toml. As a result of this change (and in keeping
23+ with the typical use of pyproject.toml) configuration of a driver build is now declarative. All
24+ build options should be specified in pyproject.toml and overrides via command-line flags or
25+ environment variables are no longer supported. Please consult
26+ `CASSPYTHON-7 <https://issues.apache.org/jira/browse/CASSPYTHON-7 >`_ for additional details.
27+
28+ Event Loop Deprecation
29+ ^^^^^^^^^^^^^^^^^^^^^^
30+ With this release the eventlet, gevent and Twisted event loops are considered deprecated. Use
31+ of these event loops in this version will generate a warning to this effect. We are planning on
32+ removing these event loops in their entirety in the next minor release. Please consult
33+ `CASSPYTHON-12 <https://issues.apache.org/jira/browse/CASSPYTHON-12 >`_ for additional details.
34+
35+ Removal of Win32 Wheels
36+ ^^^^^^^^^^^^^^^^^^^^^^^
37+ As of this release we will no longer be offering wheels for Win32 platforms. Wheels for other
38+ Windows platforms will continue to be deployed to PyPI. Please consult
39+ `CASSPYTHON-5 <https://issues.apache.org/jira/browse/CASSPYTHON-5 >`_ for additional details.
40+
41+ Change to DRIVER_NAME in STARTUP Messages
42+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
43+ The DRIVER_NAME property in STARTUP messages has been changed in this release to allow
44+ administrators to clearly distinguish between uses of the previous DataStax Python drivers
45+ and this driver. Any monitoring/management applications which were monitoring driver usage
46+ based on this string should be aware of this change and update accordingly. Please consult
47+ `CASSPYTHON-17 <https://issues.apache.org/jira/browse/CASSPYTHON-17 >`_ for additional details.
48+
49+
750Upgrading from dse-driver
851-------------------------
9-
1052Since 3.21.0, cassandra-driver fully supports DataStax products. dse-driver and
1153dse-graph users should now migrate to cassandra-driver to benefit from latest bug fixes
1254and new features. The upgrade to this new unified driver version is straightforward
0 commit comments