couchbase · thejcfactor · Aug 7, 2025 · Aug 7, 2025
diff --git a/README.md b/README.md
@@ -7,16 +7,25 @@ The Analytics SDK supports static typing.  Currently only [mypy](https://github.
 
 # Installing the SDK<a id="installing-the-sdk"></a>
 
-Until a version is available on PyPI, the SDK can be installed via pip with the following command (note the `dev` branch in the url).
+>Note: It is strongly recommended to update pip, setuptools and wheel prior to installing the SDK: `python3 -m pip install --upgrade pip setuptools wheel`
 
 Install the SDK via `pip`:
 ```console
-python3 -m pip install git+https://github.com/couchbaselabs/analytics-python-client@dev
+python3 -m pip install couchbase-analytics
+```
+
+# Installing the SDK from source
+
+The SDK can be installed from source via pip with the following command.
+
+Install the SDK via `pip`:
+```console
+python3 -m pip install git+https://github.com/couchbase/analytics-python-client.git
 ```
 
 # Using the SDK<a id="using-the-sdk"></a>
 
-Some more examples are provided in the [examples directory](https://github.com/couchbaselabs/analytics-python-client/tree/dev/examples).
+Some more examples are provided in the [examples directory](https://github.com/couchbase/analytics-python-client/tree/main/examples).
 
 **Connecting and executing a query**
 ```python

diff --git a/acouchbase_analytics/__init__.py b/acouchbase_analytics/__init__.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");

diff --git a/acouchbase_analytics/cluster.py b/acouchbase_analytics/cluster.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import sys

diff --git a/acouchbase_analytics/cluster.pyi b/acouchbase_analytics/cluster.pyi
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");

diff --git a/acouchbase_analytics/credential.py b/acouchbase_analytics/credential.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,4 +13,5 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from couchbase_analytics.common.credential import Credential as Credential  # noqa: F401
diff --git a/acouchbase_analytics/database.py b/acouchbase_analytics/database.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import sys

diff --git a/acouchbase_analytics/database.pyi b/acouchbase_analytics/database.pyi
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");

diff --git a/acouchbase_analytics/deserializer.py b/acouchbase_analytics/deserializer.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from couchbase_analytics.common.deserializer import DefaultJsonDeserializer as DefaultJsonDeserializer  # noqa: F401
 from couchbase_analytics.common.deserializer import Deserializer as Deserializer  # noqa: F401
 from couchbase_analytics.common.deserializer import PassthroughDeserializer as PassthroughDeserializer  # noqa: F401
diff --git a/acouchbase_analytics/errors.py b/acouchbase_analytics/errors.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from couchbase_analytics.common.errors import AnalyticsError as AnalyticsError  # noqa: F401
 from couchbase_analytics.common.errors import InternalSDKError as InternalSDKError  # noqa: F401
 from couchbase_analytics.common.errors import InvalidCredentialError as InvalidCredentialError  # noqa: F401

diff --git a/acouchbase_analytics/options.py b/acouchbase_analytics/options.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from couchbase_analytics.common.options import ClusterOptions as ClusterOptions  # noqa: F401
 from couchbase_analytics.common.options import ClusterOptionsKwargs as ClusterOptionsKwargs  # noqa: F401
 from couchbase_analytics.common.options import QueryOptions as QueryOptions  # noqa: F401

diff --git a/acouchbase_analytics/protocol/__init__.py b/acouchbase_analytics/protocol/__init__.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 import asyncio
 import selectors
 from typing import Optional

diff --git a/acouchbase_analytics/protocol/_core/__init__.py b/acouchbase_analytics/protocol/_core/__init__.py
@@ -0,0 +1,14 @@
+#  Copyright 2016-2025. Couchbase, Inc.
+#  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
diff --git a/acouchbase_analytics/protocol/_core/anyio_utils.py b/acouchbase_analytics/protocol/_core/anyio_utils.py
@@ -1,3 +1,19 @@
+#  Copyright 2016-2025. Couchbase, Inc.
+#  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+
 from __future__ import annotations
 
 from asyncio import AbstractEventLoop

diff --git a/acouchbase_analytics/protocol/_core/async_json_stream.py b/acouchbase_analytics/protocol/_core/async_json_stream.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 from typing import AsyncIterator, Callable, Optional

diff --git a/acouchbase_analytics/protocol/_core/async_json_token_parser.py b/acouchbase_analytics/protocol/_core/async_json_token_parser.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 from typing import Any, Callable, Coroutine, List, Optional

diff --git a/acouchbase_analytics/protocol/_core/client_adapter.py b/acouchbase_analytics/protocol/_core/client_adapter.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import logging

diff --git a/acouchbase_analytics/protocol/_core/net_utils.py b/acouchbase_analytics/protocol/_core/net_utils.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import socket

diff --git a/acouchbase_analytics/protocol/_core/request_context.py b/acouchbase_analytics/protocol/_core/request_context.py
@@ -1,3 +1,19 @@
+#  Copyright 2016-2025. Couchbase, Inc.
+#  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+
 from __future__ import annotations
 
 import json

diff --git a/acouchbase_analytics/protocol/_core/retries.py b/acouchbase_analytics/protocol/_core/retries.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 from asyncio import CancelledError

diff --git a/acouchbase_analytics/protocol/cluster.py b/acouchbase_analytics/protocol/cluster.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import sys

diff --git a/acouchbase_analytics/protocol/cluster.pyi b/acouchbase_analytics/protocol/cluster.pyi
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");

diff --git a/acouchbase_analytics/protocol/database.py b/acouchbase_analytics/protocol/database.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import sys

diff --git a/acouchbase_analytics/protocol/database.pyi b/acouchbase_analytics/protocol/database.pyi
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");

diff --git a/acouchbase_analytics/protocol/errors.py b/acouchbase_analytics/protocol/errors.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import socket

diff --git a/acouchbase_analytics/protocol/scope.py b/acouchbase_analytics/protocol/scope.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import sys

diff --git a/acouchbase_analytics/protocol/scope.pyi b/acouchbase_analytics/protocol/scope.pyi
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");

diff --git a/acouchbase_analytics/protocol/streaming.py b/acouchbase_analytics/protocol/streaming.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 from typing import Any, Optional

diff --git a/acouchbase_analytics/query.py b/acouchbase_analytics/query.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from couchbase_analytics.common.enums import QueryScanConsistency as QueryScanConsistency  # noqa: F401
 from couchbase_analytics.common.query import QueryMetadata as QueryMetadata  # noqa: F401
 from couchbase_analytics.common.query import QueryMetrics as QueryMetrics  # noqa: F401

diff --git a/acouchbase_analytics/result.py b/acouchbase_analytics/result.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,5 +13,6 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from couchbase_analytics.common.result import AsyncQueryResult as AsyncQueryResult  # noqa: F401
 from couchbase_analytics.common.result import QueryResult as QueryResult  # noqa: F401
diff --git a/acouchbase_analytics/scope.py b/acouchbase_analytics/scope.py
@@ -1,4 +1,4 @@
-#  Copyright 2016-2024. Couchbase, Inc.
+#  Copyright 2016-2025. Couchbase, Inc.
 #  All Rights Reserved.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,6 +13,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+
 from __future__ import annotations
 
 import sys