---
title: Pre-release Archive Release Notes
description: Release notes for the 3.0 Alpha & Beta Releases
pubDate: 2026-08-17T09:53:44.266Z
antora:
  editUrl: https://github.com/couchbase/docs-sdk-python/edit/temp/4.5/modules/project-docs/pages/3.0-pre-release-notes.adoc
  xref: xref:4.5@python-sdk:project-docs:3.0-pre-release-notes.adoc[]
---

[Consult the llms.txt file for a full list of contents](/llms.txt)
[View original HTML](/python-sdk/4.5/project-docs/3.0-pre-release-notes.html)

# Pre-release Archive Release Notes

> Release notes for the 3.0 Alpha & Beta Releases 

In the run-up to the SDK 3.0 API releases, several αλφα and βετα releases were made. Their release notes are maintained here for archive purposes. The 3.0 series release notes proper can be found [here](sdk-release-notes.md), along with install instructions for all supported platforms. Please note that none of the pre-releases listed below are supported; all _supported_ (GA) releases can be found [here](sdk-release-notes.md).

> [!WARNING]
> These are the pre-release α & β Release Notes maintained purely for archive and information purposes. These releases are unsupported. Supported (GA) releases can be found [on the general 3.0 Release Notes page](sdk-release-notes.md).

## [](#python-sdk-3-0-0-beta-3-release-notes-january-20-2020)Python SDK 3.0.0 Beta 3 Release Notes (January 20 2020)

```bash
pip install couchbase==3.0.0b3
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-beta3/>

### [](#enhancements)Enhancements

* [PYCBC-766](https://issues.couchbase.com/browse/PYCBC-766): Bumped LCB requirement to 3.0.0.
* [PYCBC-757](https://issues.couchbase.com/browse/PYCBC-757): Refactored for FTS/N1QL/durability LCB changes.
* [PYCBC-758](https://issues.couchbase.com/browse/PYCBC-758): Reflected renaming of `lcb_wait3` to `lcb_wait` in LCB.
* [PYCBC-765](https://issues.couchbase.com/browse/PYCBC-765): Expose Collection properties and Datastructures in Sphinx docs.
* [PYCBC-610](https://issues.couchbase.com/browse/PYCBC-610): FTS Index Management for SDK3.
* [PYCBC-750](https://issues.couchbase.com/browse/PYCBC-750): Add Search Index manager for SDK3.

### [](#fixes)Fixes

* [PYCBC-760](https://issues.couchbase.com/browse/PYCBC-760)Fixed Collection.exists implementation.
* [PYCBC-640](https://issues.couchbase.com/browse/PYCBC-640)Implemented replica reads according to RFC.
* [PYCBC-768](https://issues.couchbase.com/browse/PYCBC-768): Refactored durability params to prevent impossible combinations.
* [PYCBC-639](https://issues.couchbase.com/browse/PYCBC-639): Example N1QL statements do seem to work in "Hello Couchbase" example.
* [PYCBC-667](https://issues.couchbase.com/browse/PYCBC-667): Fixed Upsert Group fails with 'roles: value must be supplied'.
* [PYCBC-674](https://issues.couchbase.com/browse/PYCBC-674): Fixed deprecation warnings from sdk2 when running sdk3.
* [PYCBC-675](https://issues.couchbase.com/browse/PYCBC-675): Brough Result objects in line with RFC, removed unidiomatic interfaces.
* [PYCBC-694](https://issues.couchbase.com/browse/PYCBC-694): Completed query implementation.
* [PYCBC-753](https://issues.couchbase.com/browse/PYCBC-753): Collection APIs marked volatile.
* [PYCBC-763](https://issues.couchbase.com/browse/PYCBC-763): Corrected MutateInResult.content\_as implementation.
* [PYCBC-764](https://issues.couchbase.com/browse/PYCBC-764): Delete or renamed remaining SDK2 references in main API: Renamed SDK2/sdk2 to Core/core where applicable. Removed classes & methods inapplicable to SDK3.
* [PYCBC-704](https://issues.couchbase.com/browse/PYCBC-704): Implemented `*CollectionOptions` for Collection management API.
* [PYCBC-716](https://issues.couchbase.com/browse/PYCBC-716): Tests should no longer try to do 6.5-specific tests against a 6.0 server.
* [PYCBC-686](https://issues.couchbase.com/browse/PYCBC-686): Applyed new naming convention for interfaces/protocols.
* [PYCBC-687](https://issues.couchbase.com/browse/PYCBC-687): Support added for Python 3.8.
* [PYCBC-761](https://issues.couchbase.com/browse/PYCBC-761): Added timeout to `lookup_in` operation.

## [](#python-sdk-3-0-0-beta-2-release-notes-december-30-2019)Python SDK 3.0.0 Beta 2 Release Notes (December 30 2019)

```bash
pip install couchbase==3.0.0b2
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-beta2/>

### [](#enhancements-2)Enhancements

* [PYCBC-680](https://issues.couchbase.com/browse/PYCBC-680): UpsertOptions should use 'expiry' rather than 'expiration'.
* [PYCBC-692](https://issues.couchbase.com/browse/PYCBC-692): Implement Collection.exists
* [PYCBC-693](https://issues.couchbase.com/browse/PYCBC-693): Fix UpsertOptions constructor
* [PYCBC-697](https://issues.couchbase.com/browse/PYCBC-697): Migrate to timedelta/datetime from FiniteDuration/Seconds etc
* [PYCBC-709](https://issues.couchbase.com/browse/PYCBC-709): Convert from lcb\_strerror to lcb\_strerror\_short
* [PYCBC-717](https://issues.couchbase.com/browse/PYCBC-717): Tighten up lookup test with nonexistent path
* [PYCBC-721](https://issues.couchbase.com/browse/PYCBC-721): Implement collection.drop\_collection and drop\_scope
* [PYCBC-647](https://issues.couchbase.com/browse/PYCBC-647): Support View design documents for SDK3
* [PYCBC-725](https://issues.couchbase.com/browse/PYCBC-725): Adjust to latest error name refactorings in LCB3
* [PYCBC-631](https://issues.couchbase.com/browse/PYCBC-631): Add query service fast prepare support
* [PYCBC-646](https://issues.couchbase.com/browse/PYCBC-646): View management
* [PYCBC-666](https://issues.couchbase.com/browse/PYCBC-666): Add timeouts to management/get/store calls
* [PYCBC-678](https://issues.couchbase.com/browse/PYCBC-678): Update sphinx-autodoc-typehints to attempt to use type comments
* [PYCBC-679](https://issues.couchbase.com/browse/PYCBC-679): Get rid of obsolete coll/scope injection calls
* [PYCBC-683](https://issues.couchbase.com/browse/PYCBC-683): N1QL Query Index Management
* [PYCBC-718](https://issues.couchbase.com/browse/PYCBC-718): Refactor error handling for libcouchbase 3.0.0 Beta 2
* [PYCBC-720](https://issues.couchbase.com/browse/PYCBC-720): Parameterise patch type for libcouchbase
* [PYCBC-728](https://issues.couchbase.com/browse/PYCBC-728): Make CouchbaseError.Params constructor type-safe

### [](#fixes-2)Fixes

* [PYCBC-699](https://issues.couchbase.com/browse/PYCBC-699): Operate on non-default collection again
* [PYCBC-705](https://issues.couchbase.com/browse/PYCBC-705): Fix segfault in test\_importworks
* [PYCBC-708](https://issues.couchbase.com/browse/PYCBC-708): Several similar admin test failures
* [PYCBC-712](https://issues.couchbase.com/browse/PYCBC-712): Don't test collections on older servers
* [PYCBC-715](https://issues.couchbase.com/browse/PYCBC-715): Fix cluster arguments for analytics operations
* [PYCBC-727](https://issues.couchbase.com/browse/PYCBC-727): Analytics test fixes
* [PYCBC-690](https://issues.couchbase.com/browse/PYCBC-690): Set up Combination Testing for SDK 3 - Python 3.x Win and Linux
* [PYCBC-700](https://issues.couchbase.com/browse/PYCBC-700): Fix Python 2/3 compatibility issues
* [PYCBC-724](https://issues.couchbase.com/browse/PYCBC-724): Fix PYCBC git tag detection code for x.y.z where z>9

## [](#python-sdk-3-0-0-beta-1-release-notes-october-11-2019)Python SDK 3.0.0 Beta 1 Release Notes (October 11 2019)

```bash
pip install couchbase==3.0.0b1
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-beta1/>

### [](#enhancements-3)Enhancements

* [PYCBC-637](https://issues.couchbase.com/browse/PYCBC-637): Added static `Cluster.connect` factory method.
* [PYCBC-630](https://issues.couchbase.com/browse/PYCBC-630): Added Datastructures v2 for SDK3.
* [PYCBC-660](https://issues.couchbase.com/browse/PYCBC-660): Renamed `lcb_cmdfts_query` to `lcb_cmdfts_payload`.
* [PYCBC-661](https://issues.couchbase.com/browse/PYCBC-661): Safeguards added for property access when debugging partially constructed `Client` instances.
* [PYCBC-664](https://issues.couchbase.com/browse/PYCBC-664): Added create bucket management API
* [PYCBC-665](https://issues.couchbase.com/browse/PYCBC-665): Added create user management API

## [](#python-sdk-3-0-0-alpha-6-release-notes-september-27-2019)Python SDK 3.0.0 Alpha 6 Release Notes (September 27 2019)

```bash
pip install couchbase==3.0.0a6
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-alpha6/>

### [](#enhancements-4)Enhancements

* [PYCBC-638](https://issues.couchbase.com/browse/PYCBC-638): `scope` and `collection` methods now marked as "uncommitted".
* [PYCBC-584](https://issues.couchbase.com/browse/PYCBC-584): fulldoc insert with subdoc upsert now supported with LCB V4 API.
* [PYCBC-644](https://issues.couchbase.com/browse/PYCBC-644): Updates to reflect C code changes for logging, subdocs, `LCB_STORE_**`, `lcb_*3`, and `enable_mutation_tokens` refactorings.
* [PYCBC-645](https://issues.couchbase.com/browse/PYCBC-645): Changes made to handle new safety checks in LCB for bad hostname.
* [PYCBC-652](https://issues.couchbase.com/browse/PYCBC-652): Refactored for new `lcb_createopts_**` API.
* [PYCBC-654](https://issues.couchbase.com/browse/PYCBC-654): Refactored for temporary removal of `observe`/`endure`/`mctx` code from LCB3 for client-side durability changes.
* [PYCBC-657](https://issues.couchbase.com/browse/PYCBC-657): Refactored for libcouchbase 3.0.0 Beta 1.

## [](#python-sdk-3-0-0-alpha-5-release-notes-august-23-2019)Python SDK 3.0.0 Alpha 5 Release Notes (August 23 2019)

```bash
pip install couchbase==3.0.0a5
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-alpha5/>

### [](#enhancements-5)Enhancements

* [PYCBC-616](https://issues.couchbase.com/browse/PYCBC-616): Migrate `acouchbase` module to SDK3
* [PYCBC-621](https://issues.couchbase.com/browse/PYCBC-621): Update Cluster constructor docs to indicate mandatory authenticator
* [PYCBC-623](https://issues.couchbase.com/browse/PYCBC-623): Document Git dependency
* [PYCBC-624](https://issues.couchbase.com/browse/PYCBC-624): Update Hello World example to indicate mandatory authenticator argument
* [PYCBC-625](https://issues.couchbase.com/browse/PYCBC-625): Make multi-ops explicitly visible in Collection class
* [PYCBC-627](https://issues.couchbase.com/browse/PYCBC-627): Fix eager\_resources setting, fix 2.7 numpydoc incompatibility
* [PYCBC-570](https://issues.couchbase.com/browse/PYCBC-570): Python: Author docs for SubDocument LookupIn
* [PYCBC-603](https://issues.couchbase.com/browse/PYCBC-603): Python: SubDoc mutateIn Docs authoring
* [PYCBC-626](https://issues.couchbase.com/browse/PYCBC-626): Add durability to subdoc, touch and counter operations
* [PYCBC-606](https://issues.couchbase.com/browse/PYCBC-606): Synchronous Replication snippets
* [PYCBC-633](https://issues.couchbase.com/browse/PYCBC-633): Rename KV-style Bucket classes to `Client` for SDK3 code

## [](#python-sdk-3-0-0-alpha-4-release-notes-july-12-2019)Python SDK 3.0.0 Alpha 4 Release Notes (July 12 2019)

```bash
pip install couchbase==3.0.0a4
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-alpha4/>

### [](#enhancements-6)Enhancements

* [PYCBC-611](https://issues.couchbase.com/browse/PYCBC-611): Diagnostics for SDK3.
* [PYCBC-612](https://issues.couchbase.com/browse/PYCBC-612): FTS for SDK3.
* [PYCBC-613](https://issues.couchbase.com/browse/PYCBC-613): Analytics for SDK3.
* [PYCBC-614](https://issues.couchbase.com/browse/PYCBC-614): Run service commands directly from bootstrapped cluster.
* [PYCBC-571](https://issues.couchbase.com/browse/PYCBC-571): Services for SDK3.

### [](#fixes-3)Fixes

* [PYCBC-607](https://issues.couchbase.com/browse/PYCBC-607): Ensure `couchbase_core` is bootstrapped.
* [PYCBC-609](https://issues.couchbase.com/browse/PYCBC-609): Fix RPATH install for distutils.

## [](#python-sdk-3-0-0-alpha-3-release-notes-july-5-2019)Python SDK 3.0.0 Alpha 3 Release Notes (July 5 2019)

```bash
pip install couchbase==3.0.0a3
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-alpha3/>

### [](#enhancements-7)Enhancements

* [PYCBC-585](https://issues.couchbase.com/browse/PYCBC-585): Refined collections support for SDK3.
* [PYCBC-589](https://issues.couchbase.com/browse/PYCBC-589): Migrated datastructures to SDK3.
* [PYCBC-595](https://issues.couchbase.com/browse/PYCBC-595): Implemented multi-ops in Collection class.
* [PYCBC-596](https://issues.couchbase.com/browse/PYCBC-596): Centralised Collections/Bucket functionality, giving 'legacy style' behavior within the context of a Collection.
* [PYCBC-597](https://issues.couchbase.com/browse/PYCBC-597): Added buckets\_list function to documentation index.
* [PYCBC-601](https://issues.couchbase.com/browse/PYCBC-601): Use correct RPATH when using legacy build option (distutils).

## [](#python-sdk-3-0-0-alpha-2-release-notes-june-18-2019)Python SDK 3.0.0 Alpha 2 Release Notes (June 18 2019)

```bash
pip install couchbase==3.0.0a2
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-alpha2/>

### [](#fixes-4)Fixes

* [PYCBC-592](https://issues.couchbase.com/browse/PYCBC-592): Fixed manifest to include extra files for distribution.
* [PYCBC-593](https://issues.couchbase.com/browse/PYCBC-593): Restrict LCB versions to tagged >=2.10.3, >=3.0.0-alpha.3.

## [](#python-sdk-3-0-0-alpha-1-release-notes-june-14-2019)Python SDK 3.0.0 Alpha 1 Release Notes (June 14 2019)

```bash
pip install couchbase==3.0.0a1
```

**API Docs:** <http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0-alpha1/>

### [](#enhancements-8)Enhancements

* [PYCBC-540](https://issues.couchbase.com/browse/PYCBC-540): Added Basic CRUD for SDK 3.0.
* [PYCBC-541](https://issues.couchbase.com/browse/PYCBC-541): Added Basic Query for SDK 3.0.
* [PYCBC-564](https://issues.couchbase.com/browse/PYCBC-564): Added Synchronous Durability Operations.
* [PYCBC-566](https://issues.couchbase.com/browse/PYCBC-566): KV Operations Doc at draft level.
* [PYCBC-583](https://issues.couchbase.com/browse/PYCBC-583): Python Doc on Error Handling for SDK 3 (v1).
* [PYCBC-546](https://issues.couchbase.com/browse/PYCBC-546): Update CMakeLists.txt to pull in libcouchbase and other deps.
* [PYCBC-561](https://issues.couchbase.com/browse/PYCBC-561): Update Error Handling for SDK3 Python.
* [PYCBC-562](https://issues.couchbase.com/browse/PYCBC-562): Move to libcouchbase 3.0.0 and LCB API v4.
* [PYCBC-582](https://issues.couchbase.com/browse/PYCBC-582): Made touch tests more reliable.
* [PYCBC-588](https://issues.couchbase.com/browse/PYCBC-588): Fixed Centos compilation.

## [](#upgrading-2-x)Upgrading 2.x

Versions of the Python SDK prior to 3.0.0 do not bundle libcouchbase. Be sure to [upgrade your LCB installation](../../../c-sdk/current/project-docs/sdk-release-notes.md) before making a major upgrade to the Couchbase Python client.