Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Couchbase Python SDK Release Notes and Archives

    +
    Release notes, installation instructions, and download archive for the Couchbase Python Client.

    The Couchbase Python SDK 3.x is a complete rewrite of the API, reducing the number of overloads to present a simplified surface area, and adding support for Couchbase Server features like Collections and Scopes (available from Couchbase Server 7.0).

    The 3.x Python SDK introduces comprehensive PEP-484 style type annotations.

    Requirements

    Couchbase Python SDK bundles libcouchbase automatically, so no need to install it separately. You may need CMake to install, although the installer will attempt to download it from PyPI automatically.

    The Python SDK 3.x requires Python 3, with Python 3.5, Python 3.6, Python 3.7, Python 3.8 and Python 3.9 supported. See the Compatibility section for details.

    The Couchbase Python SDK will drop support for Python 3.5 and Python 3.6 with the 4.0.0 release, tentatively April 2022.
    Because the Python SDK is written primarily in C using the CPython API, the official SDK will not work on PyPy.

    Installation

    You may install previous versions of the SDK using pip (after installing the required dependencies)

    $ python3 -m pip install git+https://github.com/couchbase/couchbase-python-client@VERSION

    where VERSION is the version you wish to install. For example, to install version 2.5.4:

    $ python3 -m pip install git+http://github.com/couchbase/couchbase-python-client@2.5.4

    Currently the Python Client source distribution requires the OpenSSL headers and libraries that the Python client itself was built against to be installed prior to the client itself for TLS support to be provided. Additionally the installer relies on PEP517 which older versions of PIP do not support. If you experience issues installing it is advised to upgrade your PIP/setuptools installation as follows:

    $ python3 -m pip install --upgrade pip setuptools wheel

    Linux

    Best practice is to use a Python virtual environment such as venv or pyenv to manage multible versions of Python. See pyenv docs for details.

    • Debian and Ubuntu

    • RHEL and CentOS

    During first-time setup:

    $ sudo apt-get install git-all python3-dev python3-pip python3-setuptools cmake build-essential

    For TLS/SSL support (recommended):

    Connecting to Couchbase Capella requires TLS support. 
    $ sudo apt-get install libssl-dev

    During first-time setup:

    $ sudo yum install gcc gcc-c++ git python3-devel python3-pip cmake
    You may need to update your installed version of CMake. For example, by following the steps here.

    For TLS/SSL support (recommended):

    Connecting to Couchbase Capella requires TLS support. 
    $ sudo yum install openssl-devel
    RHEL/CentOS distributions may not provide the python3-pip package in the base repositories. It may be found in the EPEL repository.

    Mac OS

    Best practice is to use a Python virtual environment such as venv or pyenv to manage multible versions of Python, but in cases where this is not practicable follow the brew steps below, and also modify your $PATH as shown.

    There can be a problem when using the Python (3.8.2) that ships with Xcode on Catalina. It is advised to install Python via pyenv (see the Python SDK Github README for further details on pyenv installation), Homebrew, or python.org

    To install the library on Mac OS, first install Homebrew.

    Later versions of Mac OS can break the python3 homebrew installer. Simple mitigating steps may be found here.

    The following example uses the Python supplied by the Homebrew package manager and not the vendor-supplied Python which ships with Mac OS. Once Homebrew is configured:

    Get a list of the latest packages
    $ brew update
    Install compatible Python 3
    $ brew install python3
    For ZSH (MacOS 10.15 Catalina and newer)
    $ echo 'export PATH="/usr/local/bin:"$PATH' >> ~/.zshrc
    For BASH (MacOS 10.14 Mojave and older)
    $ echo 'export PATH="/usr/local/bin:"$PATH' >> ~/.bash_profile
    For TLS/SSL support - recommended

    Best practice is to use a secure connection. However, since some scenarios don’t require a secure connection, TLS support is recommended but not required.

    Connecting to Couchbase Capella requires TLS support. 
    $ brew install openssl

    Microsoft Windows

    Download and install Python from python.org. Best practice is to use a Python virtual environment such as venv or pyenv.

    Checkout the pyenv-win project to manage multiple versions of Python.

    Wheels are available on Windows for Python 3.7, 3.8 and 3.9.

    Installing on Linux

    First, make sure the requirements have been installed.

    Install the latest Python SDK:

    $ python3 -m pip install couchbase

    Installation on Mac OS

    First, make sure the requirements have been installed.

    Install the latest Python SDK:

    $ sudo -H python3 -m pip install couchbase

    Installing on Microsoft Windows

    First, make sure the requirements have been installed.

    Commands assume user is working within a virtual environment.

    Install the latest Python SDK (if using Python 3.7, 3.8 or 3.9):

    python -m pip install couchbase

    The standard Python distributions for Windows include OpenSSL DLLs, as PIP and the inbuilt ssl module require it for correct operation. The binary wheels for Windows are packaged as a binary wheel built against the relevant version OpenSSL (which is fixed per Windows version of Python).

    If you require a version without OpenSSL support, or that doesn’t have a suitable binary wheel on PyPi, follow the build instructions on the GitHub repo.

    Installing with Anaconda/Miniconda

    To use the SDK within the Anaconda/Miniconda platform, make sure the prerequisites for the desired Operating System are met:

    In the Anaconda Prompt, create a new environment:

    conda create -n test_env python=3.9

    Activate the environment:

    conda activate test_env

    Install the SDK:

    python -m pip install couchbase
    If using Windows, and no wheel is available, see the alternate installlation methods on the Github README. The same process should work within the Anaconda/Miniconda platform.

    Upgrading to 3.x

    Python SDK 3.x automatically bundles libcouchbase (downloading and building it if necessary). Generally, there is no need to download and install it separately, and we recommend using the built-in libcouchbase. There are binary Python wheels provided for Windows.

    Version 3.2.7 (23 March 2022)

    pip install couchbase==3.2.7

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.7/

    Behavioral Change

    The Couchbase Python SDK will drop support for Python 3.5 and Python 3.6 with the 4.0.0 release (tentatively April 2022) as Python 3.5 and 3.6 have already reached end of life. The Couchbase Python SDK is tested with Python versions that have not reached end of life according to the Python Software Foundation. Other Python versions might work but are not tested and are not supported.

    Fixes

    • PYCBC-1178: Fixed iops modify_event method signature.

    • PYCBC-1277: Updated eventing function management to ignore new fields in JSON responses from server.

    Enhancements

    • PYCBC-1222: Improved Query error handling by adding an error_response_body field to QueryErrorContext.

    • PYCBC-1228: Bumped LCB version to 3.2.5.

    • PYCBC-1229: Handled dependabot pull-request to bump Twisted from 21.2.0 to 22.1.0.

    • PYCBC-1226: Changed the acouchbase API to get server version after connect callback completes.

    • PYCBC-1227: Updated rate limit tests to use new index management with collections.

    • PYCBC-1281: Updated test suite to better handle 7.1 situations.

    Version 3.2.6 (2 February 2022)

    pip install couchbase==3.2.6

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.6/

    Behavioral Change

    The Couchbase Python SDK will drop support for Python 3.5 and Python 3.6 with the 4.0.0 release (tentatively April 2022) as Python 3.5 and 3.6 have already reached end of life. The Couchbase Python SDK is tested with Python versions that have not reached end of life according to the Python Software Foundation. Other Python versions might work but are not tested and are not supported.

    Fixes

    Enhancements

    • PYCBC-1182: Added index management for collections to Index Management API.

    • PYCBC-1223: Added environment config to allow for optional custom OpenSSL path.

    Version 3.2.5 (12 January 2022)

    python3 -m pip install couchbase==3.2.5

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.5/

    Behavioral Change

    The Couchbase Python SDK will drop support for Python 3.5 and Python 3.6 with the 4.0.0 release (tentatively April 2022) as Python 3.5 and 3.6 have already reached end of life. The Couchbase Python SDK is tested with Python versions that have not reached end of life according to the Python Software Foundation. Other Python versions might work but are not tested and are not supported.

    Fixes

    • PYCBC-1214: Added check to cancel event prior to destroying event for asynchronous APIs.

    • PYCBC-1218: Added rate limit exceptions to Bucket, User, and Views Management APIs.

    Enhancements

    • PYCBC-1215: Updated txcouchbase tests to check for Alpine OS.

    • PYCBC-1217: Updated regular expression used to match search rate limit errors.

    • PYCBC-1160: Added custom conflict to Bucket Management API’s ConflictResolutionType Enum.

    • PYCBC-1164: Added support to include locations in SearchOptions and added match operator property to MatchQuery.

    • PYCBC-1175: Added preserve_expiry option to QueryOptions.

    Version 3.2.4 (7 December 2021)

    python3 -m pip install couchbase==3.2.4

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.4/

    Behavioral Change

    The Couchbase Python SDK will drop support for Python 3.5 and Python 3.6 with the 4.0.0 release (tentatively April 2022) as Python 3.5 has already reached end of life and Python 3.6 will reach end of life in December 2021. The Couchbase Python SDK is tested with Python versions that have not reached end of life according to the Python Software Foundation. Other Python versions might work but are not tested and are not supported.

    Fixes

    • PYCBC-1029: Fixed memory leak for KV multi() methods

    • PYCBC-1200: Added support for raw option in N1QL QueryOptions

    • PYCBC-1207: Fixed QueryIndexManager create_primary_index() method to correctly handle CreatePrimaryQueryIndexOptions

    Enhancements

    • PYCBC-1162: Added support for rate limiting errors

    • PYCBC-1177; PYCBC-1185; PYCBC-1187: Removed deprecated expiry duration logic and deprecated legacy IxmgmtRequest and BucketManager classes

    • PYCBC-1210: Added Binary Collection API to asynchronous acouchbase interface

    • PYCBC-1212: Updated included libcouchbase version to 3.2.4

    • PYCBC-1181: Added backend storage option to Bucket Management API

    • PYCBC-1206: Replaced git:// protocol references with more secure https:// protocol

    • PYCBC-1208: Updated dependencies to use compatible release version scheme

    • PYCBC-1209: Updated version scheme to allow dev, rc and post suffixes

    Version 3.2.3 (3 November 2021)

    Version 3.2.3 is the fourth release of the 3.2 series.

    python3 -m pip install couchbase==3.2.3

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.3/

    Behavioral Change

    This release deprecates the legacy IxmgmtRequest and BucketManager classes. The updated Management APIs should be used instead. Both the IxmgmtRequest and BucketManager classes will be removed with next release.

    Fixes

    • PYCBC-787: Added is_active flag to GetReplicaResult to check if result of get_all_replicas is replica or active.

    • PYCBC-853: Added ping() diagnostics to acouchbase.

    • PYCBC-1077: Fixed libcouchbase callback on connect when bootstrap has previously been called. Now, after a failed connection, the user can retry connecting with the same Cluster object.

    Enhancements

    Version 3.2.2 (12 October 2021)

    Version 3.2.2 is the third release of the 3.2 series.

    python3 -m pip install couchbase==3.2.2

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.2/

    Enhancements

    • PYCBC-1141; PYCBC-767; PYCBC-811: Added support for Transcoders and Non-JSON documents to KV.

    • PYCBC-1176: Applied standard PEP8 formatting to Couchbase Python project.

    • PYCBC-1161; PYCBC-1169: Added ARM Support for Apple Silicon and AWS Graviton2.

    • PYCBC-1163: Improved client side error message when TLS is enforced on the server side.

    • PYCBC-1184: Updated QueryIndexManagement API to use libcouchbase HTTP methods instead of deprecated APIs.

    • PYCBC-1189: Added redeploy_required property to EventingFunctionStatus.

    Version 3.2.1 (10 September 2021)

    Version 3.2.1 is the second release of the 3.2 series.

    $ python3 -m pip install couchbase==3.2.1

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.1/

    Fixes

    • PYCBC-1159: The acouchbase API has been updated to handle iterating over non-kv result sets greater than 1000.

    • PYCBC-1171: Updated how the txcouchbase API handles setting and clearing callbacks for AsyncResult to avoid unbounded memory increases.

    • PYCBC-1172: For basic GET operations, the Python client was incorrectly setting the get_mode enum in libcouchbase to with_touch. This change fixes this to ensure the SDK uses the correct get_mode (normal) for KV GET operations.

    Enhancements

    • PYCBC-1147: Updated search bindings since CCBC-1428 has been resolved.

    • PYCBC-1157: Cloud Connection sample code updated.

    • PYCBC-1173: The libcouchbase version bundled in the Python SDK has been updated to 3.2.1.

    • PYCBC-1174: The QueryScanConsistency class was initially moved to couchbase/n1ql.py as part of the Eventing Management API additions, however, to prevent breaking changes, the class has been returned to its previous location at couchbase/cluster.py.

    • PYCBC-1064: Users can now manage the Couchbase Eventing Service from the Python SDK client.

    • PYCBC-1144: FTS sort options can be a list of strings, or a list of child classes derived from the Sort() base class. In order to align with the RFC, the search API sort functionality can now use the child classes derived from the Sort() base class.

    Version 3.2.0 (26 July 2021)

    $ python3 -m pip install couchbase==3.2.0

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.2.0/

    Fixes

    • PYCBC-560: Fixed travel-sample to work on Python 3.7.

    • PYCBC-1022: Propagated 'lockmode' option to Bucket **kwargs.

    • PYCBC-1075: Exposed partition information in query management API.

    • PYCBC-1110: Fixed subdocument array_insert() method definition.

    Enhancements

    Version 3.1.3 (14 June 2021)

    Version 3.1.3 is the fourth release of the 3.1 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.1.3

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.1.3/

    Fixes

    • PYCBC-993: acouchbase and txcouchbase inheritance trees have been updated, as a first step to bring them in line with the Couchbase Cluster Creation API.

    • PYCBC-1114; PYCBC-1127; PYCBC-1128: Corrected acouchbase API Collection creation and Query operations.

    • PYCBC-1120; PYCBC-1121: Corrected typing imports on Python versions < 3.8.

    • PYCBC-1125: Updated dependency to LCB 3.1.4, to pull in LCB fixes & enhancements.

    • PYCBC-1126: Added mutation token to MutationResult object.

    Enhancements

    • PYCBC-966: Enhanced build support for Ubuntu 20.04.

    • PYCBC-1008: Updated parsing method of N1QL duration to ms.

    • PYCBC-1129: Added method to close event loop in acouchbase API.

    Version 3.1.2 (12 May 2021)

    Version 3.1.2 is the third release of the 3.1 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.1.2

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.1.2/

    Fixes

    Enhancements

    • PYCBC-965: Added N1QL Support for Collections.

    • PYCBC-967: Added Analytics Support for Collections.

    • PYCBC-1065: Added FTS Support for Collections.

    Version 3.1.1 (26 April 2021)

    Version 3.1.1 is the second release of the 3.1 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.1.1

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.1.1/

    Fixes

    • PYCBC-1116: Installing Python SDK 3.1.0 gives an error that libcouchbase files are missing (although upgrading to 3.1.0 worked fine). Libcouchbase (LCB) is now retrieved from the GitHub repo, rather than an archive, and the problem is fixed.

    Enhancements

    • PYCBC-1111: Get correct LCB version burned in when building.

    Version 3.1.0 (22 April 2021)

    This is the first GA release of the 3.1 series Python SDK.

    $ python3 -m pip install couchbase==3.1.0

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.1.0/

    Behavioral Change

    This release brings significant changes to the User Management API. Specifically, the domain_name should be passed in as part of the operation’s optional Options object (or overridden with the domain_name keyword argument) and the use of namedtuple for certain objects were removed to to bring the API in line with the original specification. Please see User Management Docs for how to use the updated User Management API.

    Fixes

    • PYCBC-945: Docs: Ensured all references to variadic subdoc op lists become iterables.

    • PYCBC-971: Updated docs for Diagnostics/health.

    • PYCBC-1028: 'content', 'content_as', etc. now shown in web API docs.

    • PYCBC-1032: FTS search does not return fields.

    • PYCBC-1105: FTS - Facet result missing terms.

    • PYCBC-1113: Forward compat with python issue.

    Enhancements

    • PYCBC-1074: Docs: User Management quick snippets.

    • PYCBC-956: Added Bucket Durability Creation Support.

    • PYCBC-1007: Enhanced User Management for Collections/RBAC.

    • PYCBC-1009: Added support to pass Score as FTS parameter.

    • PYCBC-1053: Docs: Threshold Logging and Orphan Response Logging.

    Known Issues

    • PYCBC-1116: Installing this verion of the Python 3 SDK (3.1) gives an error that libcouchbase files are missing. Upgrading to this version is fine. However, more recent versions are now available — please install the latest.

    Version 3.0.10 (4 March 2021)

    $ python3 -m pip install couchbase==3.0.10

    API Docs: http://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.10/

    Fixes

    • PYCBC-865: Cluster-level ping will now use cluster, instead of open bucket.

    Enhancements

    • PYCBC-1073: SDK now supports the Scopes & Collections API Changes in Server 7.0 beta.

    Version 3.0.9 (2 February 2021)

    $ python3 -m pip install couchbase==3.0.9

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.9/

    Behavioral Change

    This release deprecates a field on responses that show the expiration as a duration replacing it with an expiryTime which represents an instant point in time as a UNIX timestamp. It also introduces warnings when the duration specfied is likely an incorrect use of the API.

    Fixes

    • PYCBC-968: Refactored Document Expiry Duration.

    • PYCBC-999: Deprecated GetResult.expiry().

    Known Issues

    • PYCBC-1094: The new expiryTime field is returning a float to represent the expiration, rather than a datetime. Discovered too late for 3.0.9, this will be fixed in the next release.

    Version 3.0.8 (13 January 2021)

    $ python3 -m pip install couchbase==3.0.8

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.8/

    Fixes

    • PYCBC-949: PasswordAuthenticator no longer fails with the optional cert_path argument.

    • PYCBC-969: Implemented SearchScanConsistency to replace QueryScanConsistency in the Search Service.

    • PYCBC-1078: Design doc unprefix was trimming off too many characters. A change in the unprefix method has fixed this.

    Enhancements

    Known Issues

    • PYCBC-1037: KV and Query latency are ~30% higher than SDK 2.x with external libcouchbase installed. Workaround: Remove any externally-installed libcouchbase releases from the system; when run with the built-in libcouchbase, the higher latency is not observed.

    Version 3.0.7 (8 December 2020)

    $ python3 -m pip install couchbase==3.0.7

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.7/

    Fixes

    • PYCBC-587: Flask references returned to the introductory docs.

    • PYCBC-797, PYCBC-836, PYCBC-1045: Bucket.ping timeout can now be set as an option, following use of new lcb_cmdping_timeout from libcouchbase. Bucket.ping timeout on some remote nodes also fixed by this, as is the previous lack of an error enum status for PingState.

    • PYCBC-1030: collection_name and scope_name added to User Roles.

    • PYCBC-1033: Exception on six import fixed.

    • PYCBC-1038: Fix to handle change in how existing scope is reported by Couchbase Server 7.0.

    • PYCBC-1056: MutateIn was broken for all flavors of async. Now fixed for asyncio and for tested twisted uses.

    Enhancements

    • PYCBC-1063: Intermittent fail in CollectionsTests.test_unlock_wrong_cas has been fixed.

    Version 3.0.6 (3 November 2020)

    Version 3.0.6 is the seventh release of the 3.0 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.0.6

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.6/

    Fixes

    • PYCBC-976: Added AnalyticsScanConsistency.

    • PYCBC-1019: Fixed a memory leak in N1QL Query.

    • PYCBC-1047: Updated namespace key for ping test to match change in libcouchbase. Ping test now works again.

    • PYCBC-1048: Collection tests were failing against upcoming 7.0 Server owing to changes in how the exceptions are structured or nested. Changed now to parse the HTTP error context’s result_body first, and improved the test suite for these and other services.

    Enhancements

    • PYCBC-822: Added documentation on Certificate Authentication and LDAP.

    • PYCBC-1057: Subdoc expiry intermittent test fails fixed.

    • PYCBC-961: Added Options To Use FTS Hints (Flex Index).

    • PYCBC-963: Added Ephemeral Bucket Management Support.

    Version 3.0.5 (4 September 2020)

    Version 3.0.5 is the sixth release of the 3.0 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.0.5

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.5/

    Fixes

    Enhancements

    • PYCBC-1011: If tests.ini not in current dir, now uses base path of PYCBC distro.

    • PYCBC-1016: Reenabled non-hybrid build for CLion.

    Version 3.0.4 (11 August 2020)

    Version 3.0.4 is the fifth release of the 3.0 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.0.4

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.4/

    Fixes

    • PYCBC-915: Remove support for Python <3.5.

    • PYCBC-951: The MutateInOptions don’t have durability.

    • PYCBC-986: Expose and document 'condition' parameter used to create partial N1QL indices.

    • PYCBC-989: Add xattr flag to SD.upsert.

    • PYCBC-954: Can’t query in the cloud.

    • PYCBC-983: Make Conan/PyGithub deps contingent on build reqs, enable 3.5 support.

    • PYCBC-984: Some N1QL query settings may not get set.

    • PYCBC-987: ImportError: DLL load failed: The specified module could not be found. - SSL.

    • PYCBC-988: Update release notes generator.

    • PYCBC-994: Remove error_map test as fetching is now automatic

    • PYCBC-1001: "Could NOT find PythonLibs (missing: PYTHON_LIBRARIES)" causing PEP517 install error.

    • PYCBC-1002: Explicitly set adhoc to off with lcb_cmdquery_adhoc and prepared statements.

    Enhancements

    • PYCBC-671: Add Amazon Linux 2 verification testing.

    • PYCBC-933: Review docs for update items, identify/file issues.

    • PYCBC-992: Pin LCB to 3.0.3

    • PYCBC-998: SSL install notes update.

    Version 3.0.3 (15 July 2020)

    Version 3.0.3 is the fourth release of the 3.0 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.0.3

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.3/

    Fixes

    Version 3.0.2 (14 July 2020)

    Version 3.0.2 is the third release of the 3.0 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.0.2

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.2/

    Fixes

    • PYCBC-920: Twisted api seeing lots of timeouts.

    • PYCBC-941: Build against correct OpenSSL version on Windows.

    • PYCBC-950: N1QL query connections remain open after completion.

    • PYCBC-970: Python SDK assumes docstrings are available.

    Enhancements

    • PYCBC-885: FTS Doc for Python 3.0.

    • PYCBC-929: Document how to get encrypted connections to clusters.

    • PYCBC-591: Document analytics using the Python SDK at draft level.

    Version 3.0.1 (12 June 2020)

    Version 3.0.1 is the second release of the 3.0 series, bringing enhancements and bug fixes over the last stable release.

    $ python3 -m pip install couchbase==3.0.1

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.1/

    Enhancements

    Bug Fixes

    • PYCBC-714: Python SDK throwing SystemError.

    • PYCBC-833: get_all_replicas segfaults.

    • PYCBC-834: Intermittent segfault in collection.exists.

    • PYCBC-912: Generated docs need a second pass.

    • PYCBC-918: Version 3 needs access to bucket "default" to connect.

    • PYCBC-924: CBCollection.new invoking type superconstructor on some platforms.

    • PYCBC-928: Bootstrap timing out on Centos.

    • PYCBC-930: Using cert_path= in ClusterOptions hit inner_cause='cert_path' is an invalid keyword argument for this function, C Source=(src/bucket.c,1047).

    • PYCBC-934: Some Query OptionBlocks not passing kwargs to constructor.

    • PYCBC-936: QueryScanConsistency object should be an Enum.

    • PYCBC-937: Rename CBAS to ANALYTICS/Analytics to match LCB/RFC.

    • PYCBC-939: Unpin some dev_requirements entries.

    Version 3.0.0 (1 May 2020)

    This is the first GA release of the third generation Python SDK.

    $ python3 -m pip install couchbase==3.0.0

    API Docs: https://docs.couchbase.com/sdk-api/couchbase-python-client-3.0.0/

    Whilst we have made our best efforts to update the API documentation to accurately reflect the functionality provided, there are still some known documentation issues to be resolved. We aim to fix these as soon as possible.

    Known issues

    • PYCBC-912 Generated docs need a second pass.

    • PYCBC-834 Intermittent segfault in collection.exists.

    • PYCBC-833 get_all_replicas segfaults.

    And an issue in libcouchbase that impacts upon the Python Client:

    • CCBC-128 Segfault in lcbtrace_span_add_tag_uint64.

    Enhancements

    • PYCBC-816: Migrate txcouchbase to SDK3.

    • PYCBC-805: Provide async access to Cluster.

    • PYCBC-658: Provide txcouchbase support for durability.

    • PYCBC-826: Implement acouchbase for Windows.

    • PYCBC-622: Document/configure Git dependency.

    • PYCBC-673: Prefer locally bundled lcb include for installs.

    • PYCBC-681: Make OptionBlock arguments discoverable.

    • PYCBC-698: Fixed test failures against real servers.

    • PYCBC-711: Create AnalyticsIndexManager, fix analytics queries, with v3 tests.

    • PYCBC-719: The ViewIteratorTests all are skipping when they should not.

    • PYCBC-723: bucket.ping needs to be implemented.

    • PYCBC-732: QueryIndexManager interface work, plus fixes for failing tests.

    • PYCBC-746: Remove NodeManager from API.

    • PYCBC-747: Remove generic Manager API.

    • PYCBC-752: ViewIndexManager needs proper SDK3 interface.

    • PYCBC-754: Fix invalid named args in Collection.get.

    • PYCBC-771: Mark multi-operations as volatile until sdk-rfc done.

    • PYCBC-785: Expose ErrorContexts.

    • PYCBC-794: Implement Cluster.disconnect.

    • PYCBC-798: Ping is returning 'scope' instead of 'namespace'.

    • PYCBC-801: Reflect optional nature of parameters in OptionBlock constructors.

    • PYCBC-803: Reinstate non-hybrid (pure CMake) build.

    • PYCBC-815: Share lcb_INSTANCE objects between collections.

    • PYCBC-817: Collection get_and_touch, get_and_lock need to be SDK3-ized.

    • PYCBC-838: Client Durability support.

    • PYCBC-473: Add FTS Index Management.

    • PYCBC-691: Set up Combination Testing for SDK 3 - Server 5.5, 6.0, 6.5.

    • PYCBC-729: Add necessary build tools to the readme.md.

    • PYCBC-777: Complete KV doc for GA.

    • PYCBC-779: Getting Started docs Tidy Up.

    • PYCBC-781: Managing Connections doc.

    • PYCBC-841: Update integration testing Jenkins node labels.

    • PYCBC-844: Convert integration tests to nightlies.

    • PYCBC-743: Mark all ErrorContexts as Uncommitted.

    • PYCBC-751: AnalyticsIndexes manager missing on Cluster.

    • PYCBC-775: Migrate collection attributes to use timedelta for durations.

    • PYCBC-744: Ensure precedence between named param and option block is described.

    • PYCBC-864: Provide asyncio access to Cluster, also analytics and search.

    • PYCBC-707: Sweep through tests, examine why some are skipped.

    • PYCBC-840: Add testing for 6.5 with DP enabled.

    • PYCBC-845: Nightlies need to build and test (against mock) on more platforms.

    • PYCBC-847: Consolidate exceptions into one place.

    • PYCBC-870: Testing on MacOS.

    • PYCBC-873: CMake: Skip PythonLibs search for Hybrid builds, remove -pthreads.

    • PYCBC-886: Expiry not properly returned or set.

    • PYCBC-895: Improve navigability/API docs for async, remove factories.

    • PYCBC-896: Remove unused code (unshared collection, v2 async code).

    Fixes

    • PYCBC-774: Proper implementation for Collection.get_all_replicas.

    • PYCBC-782: Fix durability_level on collection.remove.

    • PYCBC-789: N1QL query request to create index appears to fail.

    • PYCBC-792: Cluster.diagnostics always times out.

    • PYCBC-795: ViewManager needs to wrap http calls for proper exceptions.

    • PYCBC-799: Ensure v3 tests all pass on Jenkins against real servers.

    • PYCBC-800: Fix BucketMissingException when trying to connect to Cluster.

    • PYCBC-807: Correct CollectionManager docstrings.

    • PYCBC-808: Fix AnalyticsOptions code.

    • PYCBC-818: Collection.exists always returning true.

    • PYCBC-829: Collection.get_and_lock should not get and lock in 2 commands.

    • PYCBC-850: CBCollectionShared not passing through collection name.

    • PYCBC-855: ViewResult recurses infinitely on some platforms.

    • PYCBC-857: Address some missing error context types.

    • PYCBC-859: Bucket exception parsing broken by server message change.

    • PYCBC-756: Append, Prepend, Increment, Decrement need to move to BinaryCollection.

    • PYCBC-749: Remove additional overloads for query and search.

    • PYCBC-806: Various PEP8 formatting fixes.

    • PYCBC-809: PEP8/MyPy warning removal.

    • PYCBC-839: CreateCollection CollectionSpec must include MaxTTL.

    • PYCBC-760 Fixed Collection.exists implementation.

    • PYCBC-640 Implemented replica reads according to RFC.

    • PYCBC-768: Refactored durability params to prevent impossible combinations.

    • PYCBC-639: Example N1QL statements don’t seem to work in "Hello Couchbase" example.

    • PYCBC-667: Fixed Upsert Group fails with 'roles: value must be supplied'.

    • PYCBC-674: Fixed deprecation warnings from sdk2 when running sdk3.

    • PYCBC-675: Brough Result objects in line with RFC, removed unidiomatic interfaces.

    • PYCBC-694: Completed query implementation.

    • PYCBC-753: Collection APIs marked volatile.

    • PYCBC-763: Corrected MutateInResult.content_as implementation.

    • 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: Implemented *CollectionOptions for Collection management API.

    • PYCBC-716: Tests should no longer try to do 6.5-specific tests against a 6.0 server.

    • PYCBC-686: Applied new naming convention for interfaces/protocols.

    • PYCBC-687: Support added for Python 3.8.

    • PYCBC-761: Added timeout to lookup_in operation.

    • PYCBC-784: Remove/move/mark "internal" Admin methods/class.

    • PYCBC-793: Cluster.bucket needs kwargs for the tests to work against the mock.

    • PYCBC-796: Move some tests on sdk2 to sdk3.

    • PYCBC-797: Bucket.ping needs to respect the timeout in the options if any.

    • PYCBC-824: QueryResult has a few fields that are not implemented yet.

    • PYCBC-831: Cluster settings like compression, tracing, etc.. should be set at Cluster initialisation only.

    • PYCBC-832: Test issues with cluster and opening new buckets.

    • PYCBC-835: Diagnostics hangs on any server < 6.5.

    • PYCBC-854: ping() needs to be at the cluster level as well.

    • PYCBC-860: Don’t pass a bucket name for cluster connections by default.

    • PYCBC-863: iterable_wrapper failing for some async operations.

    • PYCBC-869: Cattrs library doesn’t work with python 3.5.2.

    • PYCBC-874: Do cluster ops on 6.5-DP.

    • PYCBC-875: ViewQuery segfaults in bindings.

    • PYCBC-878: Tx stuff seems to have broken imports recently.

    • PYCBC-881: Make (txcouchbase|acouchbase).cluster.Cluster.connect return an instance of the relevant class.

    • PYCBC-882: Fix dropped imports.

    • PYCBC-883: Some remaining exceptions not listed in Error Handling RFC.

    • PYCBC-898: Correct threshold naming for search and query.

    • PYCBC-899: Import error in search tests.

    • PYCBC-902: Add more coverage to integration tests.

    • PYCBC-903: Further improve Async API/docstrings.

    • PYCBC-905: Pip install fails for latest sdk commits on python 3.5.x.

    • PYCBC-908: Add some missing View result types.

    • PYCBC-897: Update 'long_description' settings to conform with PyPi.

    • PYCBC-910: Factor CBCollectionShared into CBCollectionBase.

    • PYCBC-911: Remove content_as_array as not in RFC.

    Pre-releases

    Numerous Alpha and Beta releases were made in the run-up to the 3.0 release, and although unsupported, the release notes and download links are retained for archive purposes here.

    Older Releases

    Although no longer supported, documentation for older releases continues to be available in our docs archive.