Release 3.30.0: changelog and documentation by absurdfarce · Pull Request #1282 · apache/cassandra-python-driver

absurdfarce · 2026-03-20T17:45:54Z

Changelog entries plus a few changes related to things from this release. We don't have cassandra.version anymore so I tweaked that to use supported protocol versions instead.

Also yanked all the env var stuff we used to support in setup.py... that's all in pyproject.toml now.

…toml

Copilot

Pull request overview

Updates release-facing documentation and changelog for the 3.30.0 release, including Python version support changes and guidance around the new pyproject.toml-based build configuration.

Changes:

Add 3.30.0 changelog entry (features/bug fixes/other notes).
Update stated supported Python versions to 3.10–3.14.
Update installation docs to reference pyproject.toml build configuration instead of setup.py env vars / flags.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
docs/installation.rst	Updates supported Python versions; revises installation verification and build-configuration guidance to reference pyproject.toml.
README.rst	Updates supported Python versions statement for the release.
CHANGELOG.rst	Adds 3.30.0 release notes at the top of the changelog.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

docs/installation.rst

Copilot · 2026-03-20T17:53:37Z

docs/installation.rst

+    python -c 'import cassandra; print(cassandra.ProtocolVersion.SUPPORTED_VERSIONS)'

-It should print something like "3.29.3".
+This command should print something like "(66, 65, 6, 5, 4, 3, 2, 1)".


The new verification command prints ProtocolVersion.SUPPORTED_VERSIONS, which doesn’t indicate which driver version was installed and the tuple contents can vary as protocol support changes. Since cassandra.__version__ still exists (it’s set from importlib.metadata in cassandra/__init__.py), consider keeping the original print(cassandra.__version__) (or documenting importlib.metadata.version('cassandra-driver')) so users can confirm the installed package version.

I forgot that we kept cassandra.__version__ around... agree that this makes more sense. Also just re-tested against 3.30.0 to confirm that this usage still works without issue... and it does.

Copilot · 2026-03-20T17:53:37Z

docs/installation.rst

+You can also use ``build-concurrency`` key in the ``tool.cassandra-driver`` table of pyproject.toml to 
+increase the number of threads used to build the driver and any C extensions.


Line 102 has trailing whitespace, and the sentence is missing an article (“use the build-concurrency key…”). Also, build-concurrency is an integer in pyproject.toml (default 0); it would help to note that users should set it to a positive integer to override the default behavior.

Maybe: "Use the build-concurrency setting in pyproject.toml under [tool.cassandra-driver] to enable multi-threaded builds for the driver and C extensions."

+1 to adding the article. I use the terms "key" and "table" throughout this doc when referring to pyproject.toml since that's the terminology used within the pyproject.toml Python docs... so I'd kind of like to stick with that in order to help users translate between the two.

Actually this section could use another pass overall... working on that now.

Okay, re-worked this to hopefully make it clearer (and address the comments included here). Take another look @bschoening and see if you're good with what's here!

docs/installation.rst

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-23T19:25:28Z

docs/installation.rst

+Cython also supports concurrent builds of native extensions.  The ``build-concurrency`` key in the
+``tool.cassandra-driver`` table of pyproject.toml is an integer value which specifies the number of
+concurrent builds Cython may execute.  The value for this key must be a non-negative integer; the default is zero,
+indicating no concurrent builds.  The ``multiprocessing`` module must be installed if concurrent builds are used.


The docs say “The multiprocessing module must be installed if concurrent builds are used.” multiprocessing is part of the Python standard library for the supported runtimes (CPython/PyPy), so this is misleading. Consider rephrasing to note that concurrent builds rely on the standard-library multiprocessing module (and may be unavailable only in restricted/minimal Python builds).

Suggested change

indicating no concurrent builds. The ``multiprocessing`` module must be installed if concurrent builds are used.

indicating no concurrent builds. Concurrent builds rely on the standard-library ``multiprocessing`` module, which may be unavailable in restricted or minimal Python environments.

Noted and fixed.

Copilot · 2026-03-23T19:25:29Z

docs/installation.rst

-When installing manually through setup.py, you can disable both with
-the ``--no-extensions`` option, or selectively disable them with
-with ``--no-murmur3``, ``--no-libev``, or ``--no-cython``.
+When installing manually these options can be disabled by changing the corresponding


Minor grammar: “When installing manually these options…” reads as missing a comma after “manually”, which makes the sentence harder to parse.

Suggested change

When installing manually these options can be disabled by changing the corresponding

When installing manually, these options can be disabled by changing the corresponding

Copilot · 2026-03-23T19:25:29Z

README.rst

 DataStax Enterprise (4.7+) using exclusively Cassandra's binary protocol and Cassandra Query Language v3.

-The driver supports Python 3.9 through 3.13.
+The driver supports Python 3.10 through 3.14.


Support range was updated here, but other prominent docs still state the old range (e.g., docs/index.rst says Python 3.9–3.13 and README-dev.rst mentions testing 3.9–3.13). Consider updating those references in the same PR to keep the documentation consistent.

Suggested change

The driver supports Python 3.10 through 3.14.

The driver supports the Python versions listed on the project's PyPI page.

Good catch, fixing

Copilot · 2026-03-23T19:25:29Z

docs/installation.rst

+Python 3.10 through 3.14 are supported.  Both CPython (the standard Python
 implementation) and `PyPy <http://pypy.org>`_ are supported and tested.


Supported Python versions were updated here, but the documentation landing page still advertises the previous range (docs/index.rst currently says Python 3.9–3.13). Consider updating that page as well to avoid conflicting guidance.

Copilot · 2026-03-23T19:25:29Z

CHANGELOG.rst

+------
+* Remove obsolete __future__ import absolute_import (PR 1263)
+* Remove ez_setup for compatibility with setuptools v82 (PR 1268)
+* Replace usage of with await lock (PR 1270)


This changelog bullet is difficult to parse (“Replace usage of with await lock”). Consider rewording to explicitly state what was replaced (e.g., replacing a with <lock> usage with awaiting an async lock) so readers can understand the change without context from the PR.

Suggested change

* Replace usage of with await lock (PR 1270)

* Replace with-statement based lock usage with awaiting an async lock (PR 1270)

Changelog entries are almost always taken directly from the PR title... I'm not convinced there's much need to deviate from that here.

bschoening · 2026-03-23T21:18:30Z

+1

absurdfarce added 3 commits March 19, 2026 16:37

Changelog updates for 3.30.0

02e93d6

Update install notes to be consistent with introduction of pyproject.…

b152bef

…toml

Update supported Python versions

f0b50c0

absurdfarce requested a review from bschoening March 20, 2026 17:45

bschoening requested a review from Copilot March 20, 2026 17:50

Copilot started reviewing on behalf of bschoening March 20, 2026 17:51 View session

Copilot AI reviewed Mar 20, 2026

View reviewed changes

absurdfarce added 3 commits March 23, 2026 13:45

Code review feedback

690c1dc

Revert back to testing cassandra.__version__

9dc7bc9

Update source install command to work with pyproject.toml

dbf808e

absurdfarce requested a review from Copilot March 23, 2026 19:20

Copilot started reviewing on behalf of absurdfarce March 23, 2026 19:21 View session

Copilot AI reviewed Mar 23, 2026

View reviewed changes

Code review feedback

8c60315

bschoening approved these changes Mar 23, 2026

View reviewed changes

		You can also use ``build-concurrency`` key in the ``tool.cassandra-driver`` table of pyproject.toml to
		increase the number of threads used to build the driver and any C extensions.

	indicating no concurrent builds. The ``multiprocessing`` module must be installed if concurrent builds are used.
	indicating no concurrent builds. Concurrent builds rely on the standard-library ``multiprocessing`` module, which may be unavailable in restricted or minimal Python environments.

	When installing manually these options can be disabled by changing the corresponding
	When installing manually, these options can be disabled by changing the corresponding

	The driver supports Python 3.10 through 3.14.
	The driver supports the Python versions listed on the project's PyPI page.

		Python 3.10 through 3.14 are supported. Both CPython (the standard Python
		implementation) and `PyPy <http://pypy.org>`_ are supported and tested.

	* Replace usage of with await lock (PR 1270)
	* Replace with-statement based lock usage with awaiting an async lock (PR 1270)

Conversation

absurdfarce commented Mar 20, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

bschoening Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

absurdfarce Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

bschoening commented Mar 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

absurdfarce Mar 23, 2026 •

edited

Loading