# What changed in astrapy

> 24 changes in astrapy 2 from its official release notes, upgrade guides and advisories: 3 breaking, 9 deprecations, 8 new APIs and options. Each one cited. Sources checked 2026-10-31. HTML: https://unstale.sh/pypi/astrapy/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## astrapy 2

### Breaking changes

- Calling has_next on an IDLE cursor activates it, and it may close the cursor when no next items are detected. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Python 3.9 is no longer supported; supported versions are 3.10 to 3.14. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- The deprecated alias for name was removed from AstraDBAdminDatabaseRegionInfo and AstraDBAvailableRegionInfo. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)

### Deprecations

- The old CollectionDefinition set_* methods remain available as deprecated aliases, scheduled for removal in 3.0.0. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_default_id to with_default_id; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_indexing to with_indexing; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_lexical to with_lexical; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_rerank to with_rerank; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_vector_dimension to with_vector_dimension; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_vector_metric to with_vector_metric; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_vector_service to with_vector_service; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Renamed the CollectionDefinition fluent method from set_vector_source_model to with_vector_source_model; the old method remains as a deprecated alias. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)

### New APIs and options

- AstraDBAdmin.create_database accepts db_type="non_vector" in DatabaseDefinition to create a non-vector database. (2.3.1) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.1)
- Added the ca_cert_path parameter to support custom CA certificates in PEM format. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- The method accepts a DatabaseDefinition parameter and supports PCU group ID, tier, database type, and capacity units; it validates a provided PCU Group ID before proceeding. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- The method call now supports the Reranker Override feature. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Added synchronous and asynchronous methods for listing PCU Groups. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Added a descriptor class for PCU Groups. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Added a descriptor class for PCU Group types. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)
- Added a descriptor class for PCU Group type details. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)

### Behavior and default changes

- The method now handles PCU Type information in its response. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)

### Fixes and other changes

- Adds support for Python 3.15. (2.3.2) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.2)
- The dimension parameter is optional, which is useful when using this class in a Table.alter invocation. (2.3.1) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.1)
- Fixed normalization of empty or null indexing targets. (2.3.0) — [release notes](https://github.com/datastax/astrapy/releases/tag/v2.3.0)