Skip to content

Commit 6fbcacb

Browse files
committed
CASSPYTHON-17 Update DRIVER_NAME after donation to ASF
patch by Bret McGuire; reviewed by Bret McGuire and Brad Schoening
1 parent 65b26fe commit 6fbcacb

3 files changed

Lines changed: 45 additions & 2 deletions

File tree

CHANGELOG.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ Others
2020
* Remove ez_setup for compatibility with setuptools v82 (PR 1268)
2121
* Replace usage of with await lock (PR 1270)
2222
* Update cassandra.util.Version to better support Cassandra version strings (CASSPYTHON-10)
23+
* Update DRIVER_NAME after donation to ASF (CASSPYTHON-17)
2324

2425
3.29.3
2526
======

cassandra/connection.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ def decompress(byts):
107107
return snappy.decompress(byts)
108108
locally_supported_compressions['snappy'] = (snappy.compress, decompress)
109109

110-
DRIVER_NAME, DRIVER_VERSION = 'DataStax Python Driver', sys.modules['cassandra'].__version__
110+
DRIVER_NAME, DRIVER_VERSION = 'Apache Cassandra Python Driver', sys.modules['cassandra'].__version__
111111

112112
PROTOCOL_VERSION_MASK = 0x7f
113113

docs/upgrading.rst

Lines changed: 43 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -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+
750
Upgrading from dse-driver
851
-------------------------
9-
1052
Since 3.21.0, cassandra-driver fully supports DataStax products. dse-driver and
1153
dse-graph users should now migrate to cassandra-driver to benefit from latest bug fixes
1254
and new features. The upgrade to this new unified driver version is straightforward

0 commit comments

Comments
 (0)