v2.0.0-preview

changes since 2.0.0:

bugfix: receiving '$vector': null caused response parsing to break

These release notes list changes compared to version 1.5.2 (previous stable).

For more on each item, please consult the
API Reference
and the Documentation.

New features

API Tables

Added Table support in the clients

New Database methods: .get_table(), .create_table(), .list_tables(), .list_table_names(), .drop_table(), .drop_table_index().
New classes: Table, AsyncTable (with notable methods .definition(), .create_index(), .create_vector_index(), .list_index_names(), .alter() in addition to those similar as for Collections).
New classes TableFindCursor and AsyncTableFindCursor for find results iteration.
New classes TableInsertOneResult, TableInsertManyResult, TableInsertManyException for table-specific results and exceptions.
New classes to create/inspect tables: TableInfo, CreateTableDefinition, ListTableDescriptor, ListTableDefinition, TablePrimaryKeyDescriptor, TableValuedColumnType, TableKeyValuedColumnType, TableVectorColumnType, TableUnsupportedColumnType, TableColumnTypeDescriptor, TableScalarColumnTypeDescriptor, TableVectorColumnTypeDescriptor, TableValuedColumnTypeDescriptor, TableKeyValuedColumnTypeDescriptor, TableUnsupportedColumnTypeDescriptor, TableAPISupportDescriptor.
New classes to create/inspect table indexes: TableIndexType, TableIndexOptions, TableVectorIndexOptions, TableBaseIndexDefinition, TableIndexDefinition, TableVectorIndexDefinition, TableAPIIndexSupportDescriptor, TableUnsupportedIndexDefinition, TableIndexDescriptor.
New classes to alter tables: AlterTableOperation, AlterTableAddColumns, AlterTableDropColumns, AlterTableAddVectorize, AlterTableDropVectorize.

Maps in tables can be expressed as list of pairs (association lists):

Support for automatic handling of DataAPIMaps (+possibly dicts) in the proper table payload portions
Introduced serdes option encode_maps_as_lists_in_tables (default to "NEVER") to control this

Tables come with full typing support (usage is optional), much like is now for Collections.

Find-and-rerank for Collections

Added support for findAndRerank ("hybrid search") API command

Method .find_and_rerank() in Collection/AsyncCollection classes:

New cursor classes [Async]CollectionFindAndRerankCursor (returned by said method).
Introduced class RerankedResult, over which these cursors iterate (modulo custom mappings).

Support for reranker header-based authentication where needed:

New authentication classes RerankingHeadersProvider, RerankingAPIKeyHeaderProvider for collections.
Introduced reranking_api_key parameter for APIOptions, also exposed in:{get|create}_{table|collection} database methods; collection/table with_options; collection/table to_[a]sync methods.

Changes to .create_collection() method of [Async]Database:

New classes CollectionLexicalOptions, CollectionRerankOptions, RerankServiceOptions.
New lexical and rerank entries in CollectionDefinition (and associated builder interface management).

New [async_]find_reranking_providers methods in database admin class:

New class hierarchy introduced: RerankingProviderParameter, RerankingProviderModel, RerankingProviderToken, RerankingProviderAuthentication, RerankingProvider, FindRerankingProvidersResult to express the response.

Other new features

Introduced new astrapy-specific data types to fully express database values (see serdes_options below for fine control):

DataAPIVector data type.
DataAPIDate, DataAPITime, DataAPITimestamp, DataAPIDuration data types.
- (e.g. instead of 'datetime.datetime', instances of DataAPITimestamp are returned by default.)
DataAPISet, DataAPIMap collective data types.

Introduced a consistent API Options system:

An APIOptions object supplied at DataAPIClient() creation and inherited at each "spawn" operation, with overrides.
Sensible defaults if nothing supplied.
serdes_options to control data types accepted for writes and to select data types for reads.
- Defaults prefer custom data types for lossless expressivity (set serdes_options.custom_datatypes_in_reading = False to fall back to stdlib types).
- serdes_options.binary_encode_vectors, to control usage of binary-encoding for writing vectors (on by default for Collections).
- Numbers are treated by default as ints and floats. Set serdes_option.use_decimals_in_collections = True to switch to Decimal.
- Fine control over naive-datetime tolerance and timezone is introduced (see accept_naive_datetimes and
  datetime_tzinfo options). Acceptance of naive datetimes is off by default.
Support for arbitrary 'database' and 'admin' headers throughout the object chain.
Fully reworked timeout options through all abstractions:
- TimeoutOptions has six classes of timeouts, applying differently to various methods according to the kind of method. Timeouts can be overridden on a per-method-call basis
- Removal of the 'max_time_msparameter (keeping a quick migration path of replacing it withtimeout_ms` throughout).
- Timeout of 0 means completely disabled.

Typing support for Collections (optional):

Database .get_collection() and .create_collection() methods have a document_type parameter, for spawning instances matching a type hint of Collection[MyType].
If unspecified, fallback to DefaultCollection = Collection[dict[str, Any]].
Cursors from find also support strict typechecking.
Async collections mirror this typing behaviour.

Arbitrary field names and dot-escaping:

Utilities astrapy.utils.document_paths.escape_field_names and astrapy.utils.document_paths.unescape_field_path.
The distinct method can accept a list of (literal) str|int as well as whole (escaped) path-identifier strings.

Support for Astra DB "custom domain" endpoints for database (in which case: .id, .region, .get_database_admin(), .info() and .name() aren't available.)

Changes and improvements

Collections and Cursors

DataAPIMap, DataAPIDate accepted for writes. For dates, the same timezone caveats as for datetime.date apply.

Cursors' API changes (breaking changes):

Cursors are typed, similarly to Tables and Collections. The find method has an optional document_type parameter for typechecking.
Introduced .map() and .to_list() methods.
.state() now has values in the CursorState enum (for a string, use my_cursor.state.value).
'.address' is removed.
.rewind() returns None, mutates cursor in-place.
'.distinct()' removed: use the corresponding collection(/table) method.
'.keyspace' property removed.
'.retrieved' removed: use .consumed.
Added several cursor management methods (see docstrings for details).
The .clone() method does not strip the mapping anymore, rather retains it.
Removed the 'alive' property (replace with the check cursors.state != CursorState.CLOSED).
Class hierarchy around cursors revised:
- Renamed the abstract root-class 'FindCursor' to AbstractCursor (accommodating "find and rerank" cursors).
- Cursor classes renamed to [Async]CollectionFindCursor (likewise for table cursors).

Creation of collections with .create_collection() database method changed substantially:

A single definition: CollectionDefinition parameter with the whole structure, instead of a growing list of "flat" parameters.
- This parameter can also be a plain dictionary if desired.
- Replaces and removes 'dimension', 'metric', 'source_model', 'service', 'indexing', 'default_id_type' (all of them subsumed in definition).
CollectionDefinition: implemented fluent interface to build collection definition objects.
Removed parameters 'additional_options' and 'timeout_ms' from .create_collection() (the latter as part of the broader timeout rework).
This is also the return type of Collection.options() (formerly called 'CollectionOptions').
The database .list_collections() method returns a list of CollectionDescriptor items, one of whose attributes is the CollectionDefinition as used in creation.

Exceptions

Exception hierarchy revised in a breaking way:

Revised API and semantics for the "bulk operation" exceptions:

The four CollectionInsertManyException, CollectionUpdateManyException, CollectionDeleteManyException, TableInsertManyException classes now inherit directly from DataAPIResponseException.
New structure for [Collection|Table]InsertManyException: they have members inserted_ids(/inserted_id_tuples) and an exceptions list for the root cause(s).
New structure for Collection[Update|Delete]ManyException: they have members partial_result and a single-exception cause. They are now raised consistently for API exceptions occurring during the respective methods.

Introduced InvalidEnvironmentException for operations invalid on some Data API environments.

Removed several exceptions not needed anymore:

removed 'CursorIsStartedException': now CursorException raised for all state-related illegal calls in cursors.
removed 'CollectionNotFoundException', replaced by a ValueError in the few cases it's needed.
removed 'CollectionAlreadyExistsException' class (not used anymore once 'check_exists' parameter removed from create_collection).
removed 'DataAPIDetailedErrorDescriptor'.
removed 'CumulativeOperationException`.

Renamed some exceptions:

renamed 'InsertManyException' to CollectionInsertManyException.
renamed 'DeleteMan...

Cursors (class hierarchy revised to accommodate `find_and_rerank`, plus other changes):
    - renamed the 'FindCursorState' enum to `CursorState`
    - renamed the abstract ur-class 'FindCursor' => `AbstractCursor`
    - `clone` method does not strip the mapping anymore, rather retains it
    - removed the `alive` sugar property (use `cursors.state != CursorState.CLOSED`)
Support for reranker header-based authentication:
    - new authentication classes `RerankingHeadersProvider`, `RerankingAPIKeyHeaderProvider`
    - introduced `reranking_api_key` parameter for APIOptions, `{get|create}_{table|collection}` database methods, collection/table `with_options` and `to_[a]sync` methods
Support for "findRerankingProviders" API command in Database Admin classes:
    - classes class hierarchy: `RerankingProviderParameter`, `RerankingProviderModel`, `RerankingProviderToken`, `RerankingProviderAuthentication`, `RerankingProvider`, `FindRerankingProvidersResult` to express the response
    - database admin `find_reranking_providers`/`async_find_reranking_providers` methods implemented.
Support for findAndRerank in collections:
    - new classes `CollectionLexicalOptions`, `CollectionRerankOptions`, `RerankServiceOptions` for create_collection
    - new `lexical` and `rerank` entries in CollectionDefinition (+builder interface management)
    - `find_and_rerank` method for collections
    - cursor classes `[Async]CollectionFindAndRerankCursor` added
    - findAndRerank cursors return the new `RerankedResult` construct by default (modulo custom mappings)
Maps for tables expressed as list of pairs (association lists):
    - support for automatic handling of DataAPIMaps (+possibly dicts) in the proper table payload portions
    - introduced serdes option `encode_maps_as_lists_in_tables` (default to "NEVER") to control this
Exceptions, major rework of `[Table|Collection]InsertManyException`, `CollectionUpdateManyException` and `CollectionDeleteManyException` ("bulk operations")
    - All astrapy exceptions derive directly from `Exception` (and not 'ValueError` anymore)
    - better string representation of `DataAPIDetailedErrorDescriptor`
    - `DataAPIDetailedErrorDescriptor` removed.
    - 'CumulativeOperationException` removed.
    - The four `CollectionInsertManyException`, `CollectionUpdateManyException`, `CollectionDeleteManyException`, `TableInsertManyException` classes now inherit directly from `DataAPIResponseException`.
    - New semantics and structure for `[Collection|Table]InsertManyException`: they have members `inserted_ids`(/`inserted_id_tuples`) and an `exceptions` list for the root cause(s)
    - New semantics and structure for `Collection[Update|Delete]ManyException`: they have members `partial_result` and a single-exception `cause`. They are now raised consistently for API exceptions occurring during the respective methods.
Arbitrary field names and dot-escaping:
    - offering utilities `astrapy.utils.document_paths.escape_field_names/unescape_field_path`
    - `distinct` methods can accept a list of (literal) str|int as well as a(n escaped) identifier string
Improved StrEnum matching for e.g. better coercion of TableIndexType (and future enum with e.g. dashes in values)
Spawner methods for databases/admins standardized; they don't issue DevOps API calls.
    - removed `normalize_region_for_id` utility method, not used anymore.
    - `AstraDBAdmin.get_[async]_database()`:
        - does not run DevOps API calls anymore (for missing keyspace/region);
        - defers defaults to the [Async]Database class consistently;
        - removed `database_admin_timeout_ms`, `request_timeout_ms`, `timeout_ms` parameters;
        - `region` now required if `id` passed instead of endpoint.
    - `AstraDBDatabaseAdmin.get[_async]_database()`:
        - removed `database_admin_timeout_ms`, `request_timeout_ms`, `timeout_ms` parameters.
    - `AstraDBDatabaseAdmin.get_database_admin()` standardized and simplified:
        - does not run DevOps API calls anymore (for missing keyspace/region);
        - removed `database_admin_timeout_ms`, `request_timeout_ms`, `timeout_ms` parameters;
        - `region` now required if `id` passed instead of endpoint.
Support for Astra DB "custom domain" endpoints for database
    - in which case: `.id`, `.region`, `.get_database_admin()`, `.info()` and `.name()` aren't available.
Table indexes:
    - Support for the `indexType` field to describe table indexes (for compatibility, said field is not mandatory).
    - 'column' argument for create[Vector]Index table metods is now positional (after index name)
Collections write path now obeys the binary-encoding API Option (which in turn defaults to True. Formerly bin-encoding was always turned off.)
DataAPITime: support for "hh:mm" no-seconds format.
DataAPIDuration: improved parse performance by caching regexpes.
DataAPIDuration: support for "P4W"-type strings and for zeroes such as "P", "-PR".
Replaced the ValueErrors not directly coming from function calls/constructors with more appropriate exceptions.
Collection and Table `insert_many` methods employ returnDocumentResponses under the hood.
maintenance: switch to DSE6.9 for local non-Astra testing.

Changes w.r.t 2.0.0-preview:

Support for TIMEUUID and COUNTER columns:
    - enlarged ColumnType enum (used by the API to describe non-creatable columns)
    - readable through find/find_one operations (now returned by the API when reading)
shortened string representation of table column descriptors for improved readability
added 'filter' to the `TableAPISupportDescriptor` structure (now returned by the Data API)
added optional `api_support` member to all column descriptor (as the Data API returns it for various columns)
restore support for Python 3.8, 3.9
maintenance: full restructuring of tests and CI (tables+collections on same footing+other)
maintenance: adopt `blockbuster` in async tests to detect (and bust) any blocking call

v2.0.0-preview

Introduction of full Tables support.
Major revision of overall interface including Collection support.

Introduced new astrapy-specific data types for full expressivity (see `serdes_options` below):
    - `DataAPIVector` data type
    - `DataAPIDate`, `DataAPITime`, `DataAPITimestamp`, `DataAPIDuration`
    - `DataAPISet`, `DataAPIMap`

Typing support for Collections (optional):
    - `get_collection` and `create_collection` get a `document_type` parameter to go with the type hint `Collection[MyType]`
    - if unspecified fall back to `DefaultCollection = Collection[DefaultDocumentType]` (where `DefaultDocumentType = dict[str, Any]`)
    - cursors from `find` also allow strict typechecking

Introduced a consistent API Options system:
    - an APIOptions object inherited at each "spawn" operation, with overrides
    - environment-dependent defaults if nothing supplied
    - `serdes_options` to control data types accepted for writes and to select data types for reads
    - `serdes_options`: Collections default to using custom types for lossless and full-range expression of database content
        - `serdes_options.binary_encode_vectors`, to control usage of binary-encoding for writing vectors.
        - e.g. instead of 'datetime.datetime', instances of `DataAPITimestamp` are returned
        - Exception: numbers are treated by default as ints and floats. To have them all Decimal, set serdes_option.use_decimals_in_collections to True.
        - Use the options' serdes_option to opt out and revert to non-custom data types
        - For datetimes, fine control over naive-datetime tolerance and timezone is introduced. Usage of naive datetime is now OPT-IN.
    - Support for arbitrary 'database' and 'admin' headers throughout the object chain
    - Fully reworked timeout options through all abstractions:
        - `TimeoutOptions` has six classes of timeouts, applying differently to various methods according to the kind of method. Timeouts can be overridden per-method-call
        - removal of the 'max_time_ms` parameter ==> still a quick migration path is to replace it with `timeout_ms` throughout
        - timeout of 0 means that timeout is disabled

Re
8000
worked and enriched `FindCursor` interface:
    - Cursors are typed, similarly to Tables and Collections. The `find` method has an optional `document_type` parameter for typechecking.
    - Cursor classes renamed to `[Async]CollectionCursor`
    - Base class for all (find) cursors renamed to `FindCursor`
    - introduced `map` and `to_list` methods
    - `cursor.state` now has values in `FindCursorState` enum (take `cursor.state.value` for a string)
    - 'cursor.address' is removed from the API
    - `cursor.rewind()` returns None, mutates cursor in-place
    - removed 'cursor.distinct()': use the  corresponding collection(/table) method.
    - removed cursor '.keyspace' property
    - removed 'retrieved' for cursors: use `consumed`
    - added many cursor management methods (see docstrings for details)

Other changes to existing API:
    - `Database.create_collection`: signature change (now accepts a single "collection definition")
        - added parameter `definition` to method (a CollectionDefinition, plain dictionary or None)
        - (support for `source_model` vector index setting within the `definition` parameter)
        - removed 'dimension', 'metric', 'source_model', 'service', 'indexing', 'default_id_type' (all of them subsumed in `definition`)
        - removed parameters 'additional_options' and 'timeout_ms' as part of the broader timeout rework
    - renamed 'CollectionOptions' class to `CollectionDefinition` (return type of `Collection.options()`):
        - renamed its 'options' attribute into `definition` (although the API payload calls it "options")
        - removed its 'raw_options' attribute (redundant w.r.t `CollectionDescriptor.raw_descriptor`)
        - `CollectionDefinition`: implemented fluent interface to build collection definition objects
    - renamed `CollectionVectorServiceOptions` class to `VectorServiceOptions`
    - renamed `astrapy.constants.SortDocuments` to `SortMode`
    - renamed (collection-specific) "Result" classes like this:
        - 'DeleteResult' ==> `CollectionDeleteResult`
        - 'InsertOneResult' ==> `CollectionInsertOneResult`
        - 'InsertManyResult' ==> `CollectionInsertManyResult`
        - 'UpdateResult' ==> `CollectionUpdateResult`
    - signature change from `-> {"ok": 1}` to `-> None` for some admin and schema methods:
        - `AstraDBAdmin`: `drop_database` (+ async)
        - `AstraDBDatabaseAdmin`, `DataAPIDatabaseAdmin`: `create_keyspace`, `drop_keyspace`, `drop` (+ async)
        - `Database`, `AsyncDatabase`: `drop_collection`, `drop_table`
        - `Collection`, `AsyncCollection`: `drop`
    - renamed parameter 'collection_name' to `collection_or_table_name` and allow for `keyspace=None` in database `command()` method
    - [Async]Database `drop_collection` method now accepts a keyspace parameter.
    - `AsyncDatabase` methods `get_collection` and `get_table` are not async functions anymore (remove the await when calling them)
    - the following "info" methods are made async (= awaitable): `AsyncDatabase.info`, `AsyncDatabase.name`, `AsyncCollection.info`, `AsyncTable.info`, `AsyncDatabase.list_collections`, `AsyncDatabase.list_tables`
    - Database info structure: changed class name and reworked attributes of `AstraDBAdminDatabaseInfo` (formerly 'AdminDatabaseInfo') and `AstraDBDatabaseInfo` (formerly 'DatabaseInfo')
    - `[Async]Collection` and `[Async]Database`: `info` method now accepts the relevant timeout parameters
    - remove 'check_exists' from `[Async]Database.create_collection` method (the client does no checks now)
    - removed AstraDBDatabaseAdmin's `from_api_endpoint` static method (reason: unused)
    - remove 'database' parameter to the `to_sync()` and `to_async()` conversion methods for collections
    - `[Async]Database.drop_collection` method accepts only the string name of the target to drop (no collection objects anymore)
    - removed the 'CommandCursor'/'AsyncCommandCursor' classes:
        - `AstraDBAdmin`: `list_databases`, `async_list_databases` methods return regular lists
        - `[Async]Database`: `list_collections`, `list_tables` methods return regular lists
    - `[Async]Database`: added a `.region` property

Exceptions hierarchy reworked:
    - removed 'CursorIsStartedException': now `CursorException` raised for all state-related illegal calls in cursors
    - removed 'CollectionNotFoundException', replaced by a ValueError in the few cases it's needed
    - removed `CollectionAlreadyExistsException` class (not used anymore without `check_exists`)
    - introduced `InvalidEnvironmentException` for operations invalid on some Data API environments.
    - renamed 'InsertManyException' ==> `CollectionInsertManyException`
    - renamed 'DeleteManyException' ==> `CollectionDeleteManyException`
    - renamed 'UpdateManyException' ==> `CollectionUpdateManyException`
    - renamed 'DevOpsAPIFaultyResponseException' ==> `UnexpectedDevOpsAPIResponseException`
    - renamed 'DataAPIFaultyResponseException' ==> `UnexpectedDataAPIResponseException`
    - (improved string representation of DataAPIResponseException cases with multiple error descriptors)

Removal of deprecated modules, objects, patterns and parameters:
    - 'core' (i.e. pre-1.0) library
    - 'collection.bulk_write' and the associated result and exception classes
    - 'vector=', 'vectorize=' and 'vectors=' parameters from collection methods
    - 'set_caller' method of `DataAPIClient`, `AstraDBAdmin`, `DataAPIDatabaseAdmin`, `AstraDBDatabaseAdmin`, `[Async]Database`, `[Async]Collection`
    - 'caller_name' and 'caller_version' parameters. A single list-of-pairs `callers` is now expected
    - 'id' and 'region' to DataAPIClient's 'get_database' (and async version). Use `api_endpoint` which is now the one positional parameter.
    - Accordingly, the syntax `client[api_endpoint]` also does not accept a database ID anymore.
    - 'region' parameter of `AstraDBDatabaseAdmin.get[_async]_database` (was ignored already in the method)
    - 'namespace' parameter of several methods of: DataAPIClient, admin objects, Database and Collection (use `keyspace`)
    - 'namespace' property of CollectionInfo, DatabaseInfo, CollectionNotFoundException, CollectionAlreadyExistsException (use `keyspace`)
    - 'namespace' property of `Database` and `Collection` (switch to `keyspace`)
    - 'update_db_namespace' parameter for keyspace admin methods (use `update_db_keyspace`)
    - 'use_namespace' for `Databases` (switch to `use_keyspace`)
    - 'delete_all' method of `Collection` and `AsyncCollection` (use `delete_many({})`)

API payloads are encoded with full Unicode (not encoded in ASCII anymore) for HTTP requests

- Revision of all "spawning and copying" methods for abstractions. Parameters added/removed/renamed (switch to the corresponding parameters inside the APIOptions instead of the removed keyword parameters):
    - All the client/admin/database/table/collection classes have an `api_options` parameter in their `with_options/to_[a]sync` method
    - `DataAPIClient`
        - `_copy()`, `with_options()`: removed 'callers'
        - `get_..._database...()`: removed 'api_path', 'api_version'
        - `get_admin()`: removed 'dev_ops_url', 'dev_ops_api_version'
    - `AstraDBAdmin`
        - `(_copy)`: removed 'environment', 'dev_ops_url', 'dev_ops_api_version', 'callers'
        - `(with_options)`: removed 'callers'
        - `(create..._database)`: added `token`, `spawn_api_options`
        - `(get..._database)`: removed 'api_path', 'api_version', 'database_request_timeout_ms', 'database_timeout_ms'; renamed 'database_api_options' => `spawn_api_options`
        - `(get_da...

v1.5.2

Bugfix: Database.get_collection uses callers inheritance (same for async)

@cbornet

v. 1.5.1

Switching to endpoint as the only/primary way of specifying databases:

AstraDBClient tolerates (deprecated, removal in 2.0) id[/region] in get_database
(internal-use constructors and utilities only accept API Endpoint)
AstraDBAdmin is the only place where id[/region] will remain an allowed path in 2.0
all tests adapted to reflect this simplification

Admins: resilience against DevOps responses omitting 'keyspace'/'keyspaces'
AstraDBAdmin: added filters and automatic pagination to [async_]list_databases
Consistent handling of deletedCount=-1 from the API (always returned as-is)
Cursors: alignment and rework:

states are an enum; state names reworked for clarity (better cursor __repr__)
_copy and _to_sync methods always return a clean pristine cursor
"retrieved" property deprecated (removal 2.0). Use consumed.
"collection" property deprecated (removal 2.0). Use data_source.

Deprecation of all set_caller (=> to be set at constructor-time) (removal in 2.0)
Callers and user-agent string:

remove RAGStack automatic detection
Deprecate "caller_name/caller_version" parameters in favour of callers pair list
(minor) breaking change: passing only one of "caller_name/caller_version" to _copy/with_options will override the whole one-item
callers pair list
Repo housekeeping:
using ruff for imports and formatting (instead of isort+black) by @cbornet
add ruff rules UP(pyupgrade) by @cbornet
remove cassio unused dependency

v. 1.5.0

Deprecation of "namespace-" terminology, replaced by "keyspace-" (removal in 2.0)

deprecation of all namespace method names
deprecation of the namespace= named argument to all methods
deprecation of the update_db_namespace parameter to create_*space

Deprecation of collection bulk_write method (removal in 2.0)
APICommander logs warnings received from the Data API
Full removal of "core library" from the current API:

DevOps API accessed through APICommander everywhere
Admin objects use APICommander consistently
[Async]Database and [Async]Collection directly use APICommander
Cursor library uses APICommander directly
Core library imports triggers a submodule-wide deprecation warning
(simplification of the vector/vectorize deprecator utility)

Widened exception hierarchy with:

DevOpsAPIHttpException
DevOpsAPITimeoutException
DevOpsAPIFaultyResponseException

Rearrangement into separate modules for:

constants, strings, magic numbers and settings
request low-level tools
payload/response transformations
(sometimes with temporary duplication to avoid depending on 'core')

Testing:

testing on HCD targets Data API v 1.0.16
added tests for APICommander
improved tests for admin classes

Logging of API requests made more uniform and easier to read
Replaced collections.abc.Iterator => typing.Iterator for python3.8 compatibility

@cbornet

v. 1.4.2

Method 'update_one' of [Async]Collection: now invokes the corresponding API command.
Better URL-parsing error messages for the API endpoint (with guidance on expected format)
Improved __repr__ for: token/auth-related items, Database/Client classes, response+info objects
DataAPIErrorDescriptor can parse 'extend error' in the responses
Introduced DataAPIHttpException (subclass of both httpx.HTTPStatusError and DataAPIException)
testing on HCD:

DockerCompose tweaked to invoke docker compose
HCD 1.0.0 and Data API 1.0.15 as test targets

relaxed dependency on "uuid6" to most recent releases
core:

prefetched find iterators: fix second-thread hangups in some cases (by @cbornet)
added 'options' parameter to [Async]AstraDBCollection.update_one

@caseyclements

v. 1.4.1

FindEmbeddingProvidersResult and descendant dataclasses:
- add handling of optional 'hint' and 'displayName' fields for parameters
- knowedge of optional-as-null vs optional-as-possibly-absent ancillary fields
Replace bson dependency with pymongo (#297, by @caseyclements)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

New features

API Tables

Find-and-rerank for Collections

Other new features

Changes and improvements

Collections and Cursors

Exceptions

Uh oh!

Uh oh!

Uh oh!

v2.0.0-preview

Uh oh!

v1.5.2

Uh oh!

v. 1.5.1

Contributors

Uh oh!

v. 1.5.0

Uh oh!

v. 1.4.2

Contributors

Uh oh!

v. 1.4.1

Contributors

Uh oh!

Releases: datastax/astrapy

Release v2.0.1

Uh oh!

Release v2.0.0

New features

API Tables

Find-and-rerank for Collections

Other new features

Changes and improvements

Collections and Cursors

Exceptions

Uh oh!

Release v2.0.0rc2

Uh oh!

Release v2.0.0rc1

Uh oh!

Release v2.0.0-preview

v2.0.0-preview

Uh oh!

Release v1.5.2

v1.5.2

Uh oh!

Release v1.5.1

v. 1.5.1

Contributors

Uh oh!

Release v1.5.0

v. 1.5.0

Uh oh!

Release v1.4.2

v. 1.4.2

Contributors

Uh oh!

Release v1.4.1

v. 1.4.1

Contributors

Uh oh!