Merge branch 'main' into oclyke/docs-typo

Author: bednar

.circleci/config.yml

@@ -1,5 +1,37 @@
 version: 2.1
 
+parameters:
+  default-python-image:
+    type: string
+    default: "cimg/python:3.8"
+
+executors:
+  docker-amd64-image:
+    parameters:
+      python-image:
+        type: string
+        default: << pipeline.parameters.default-python-image >>
+    docker:
+      - image: <<parameters.python-image>>
+      - image: influxdb:3-core
+        environment:
+          - INFLUXDB3_NODE_IDENTIFIER_PREFIX=node01
+          - INFLUXDB3_OBJECT_STORE=file
+          - INFLUXDB3_DB_DIR=/var/lib/influxdb3/data
+  docker-arm64-image:
+    parameters:
+      python-image:
+        type: string
+        default: << pipeline.parameters.default-python-image >>
+    docker:
+      - image: <<parameters.python-image>>
+      - image: influxdb:3-core
+        environment:
+          - INFLUXDB3_NODE_IDENTIFIER_PREFIX=node01
+          - INFLUXDB3_OBJECT_STORE=file
+          - INFLUXDB3_DB_DIR=/var/lib/influxdb3/data
+    resource_class: arm.medium
+
 commands:
   client-test:
     description: "Run tests"
@@ -31,40 +63,74 @@ commands:
             - "~/.cache/pip"
             - "/usr/local/lib/site-python"
           when: always
+  upload-codecov-amd64:
+    steps:
+      - run:
+          name: Collecting coverage reports
+          command: |
+            curl -Os https://uploader.codecov.io/latest/linux/codecov
+            curl -Os https://uploader.codecov.io/latest/linux/codecov.SHA256SUM
+            curl -Os https://uploader.codecov.io/latest/linux/codecov.SHA256SUM.sig
+            curl -s https://keybase.io/codecovsecurity/pgp_keys.asc | gpg --no-default-keyring --keyring trustedkeys.gpg --import
+            gpgv codecov.SHA256SUM.sig codecov.SHA256SUM
+            shasum -a 256 -c codecov.SHA256SUM
+            chmod +x ./codecov
+            ./codecov
+  upload-codecov-arm64:
+    steps:
+      - run:
+          name: Collecting coverage reports
+          command: |
+            curl -k https://keybase.io/codecovsecurity/pgp_keys.asc | gpg --no-default-keyring --keyring trustedkeys.gpg --import
+            curl -Os https://uploader.codecov.io/v0.8.0/aarch64/codecov
+            curl -Os https://uploader.codecov.io/v0.8.0/aarch64/codecov.SHA256SUM
+            curl -Os https://uploader.codecov.io/v0.8.0/aarch64/codecov.SHA256SUM.sig
+            gpgv codecov.SHA256SUM.sig codecov.SHA256SUM
+            shasum -a 256 -c codecov.SHA256SUM
+            sudo chmod +x codecov        
+
 jobs:
   tests-python:
     parameters:
       python-image:
         type: string
-        default: &default-python "cimg/python:3.8"
+        default: <<pipeline.parameters.default-python-image>>>>
+      exe:
+        type: string
+        default: docker-amd64-image
       pytest-marker:
         type: string
         default: "not integration"
-    docker:
-      - image: << parameters.python-image >>
-        environment:
-          PIPENV_VENV_IN_PROJECT: true
+    executor:
+      name: << parameters.exe >>
+      python-image: << parameters.python-image >>
     steps:
       - checkout
+      - run:
+          name: Setup InfluxDB service
+          command: |
+            ./scripts/influxdb-setup.sh \
+              --export-url-as TESTING_INFLUXDB_URL \
+              --export-db-as TESTING_INFLUXDB_DATABASE \
+              --export-token-as TESTING_INFLUXDB_TOKEN
       - client-test:
           python-image: << parameters.python-image >>
           pytest-marker: << parameters.pytest-marker >>
       - store_test_results:
           path: test-reports
-      - run:
-          name: Collecting coverage reports
-          command: |
-            curl -Os https://uploader.codecov.io/latest/linux/codecov
-            curl -Os https://uploader.codecov.io/latest/linux/codecov.SHA256SUM
-            curl -Os https://uploader.codecov.io/latest/linux/codecov.SHA256SUM.sig
-            curl -s https://keybase.io/codecovsecurity/pgp_keys.asc | gpg --no-default-keyring --keyring trustedkeys.gpg --import
-            gpgv codecov.SHA256SUM.sig codecov.SHA256SUM
-            shasum -a 256 -c codecov.SHA256SUM
-            chmod +x ./codecov
-            ./codecov
+      - when:
+          condition:
+            equal: [ docker-amd64-image, << parameters.exe >> ]
+          steps:
+            - upload-codecov-amd64
+      - when:
+          condition:
+            equal: [ docker-arm64-image, << parameters.exe >> ]
+          steps:
+            - upload-codecov-arm64
   check-code-style:
     docker:
-      - image: *default-python
+      - image: <<pipeline.parameters.default-python-image>>
         environment:
           PIPENV_VENV_IN_PROJECT: true
     steps:
@@ -91,7 +157,7 @@ jobs:
             flake8 Examples/
   check-twine:
     docker:
-      - image: *default-python
+      - image: <<pipeline.parameters.default-python-image>>
         environment:
           PIPENV_VENV_IN_PROJECT: true
     steps:
@@ -105,7 +171,7 @@ jobs:
             twine check dist/*
   check-docstyle:
     docker:
-      - image: *default-python
+      - image: <<pipeline.parameters.default-python-image>>
         environment:
           PIPENV_VENV_IN_PROJECT: true
     steps:
@@ -116,6 +182,7 @@ jobs:
             pip install pydocstyle --user
             pydocstyle --count influxdb_client_3
 
+
 workflows:
   version: 2
   build:
@@ -124,36 +191,18 @@ workflows:
         equal: [ scheduled_pipeline, << pipeline.trigger_source >> ]
     jobs:
       - check-code-style
-#      - check-docstyle
+      #      - check-docstyle
       - check-twine
       - tests-python:
-          name: test-3.8
-          python-image: "cimg/python:3.8"
-      - tests-python:
-          name: test-3.9
-          python-image: "cimg/python:3.9"
-      - tests-python:
-          name: test-3.10
-          python-image: "cimg/python:3.10"
-      - tests-python:
-          name: test-3.11
-          python-image: "cimg/python:3.11"
-      - tests-python:
-          name: test-3.12
-          python-image: "cimg/python:3.12"
-      - tests-python:
-          name: test-3.13
-          python-image: "cimg/python:3.13"
+          matrix:
+            parameters:
+              exe: [ docker-amd64-image, docker-arm64-image ]
+              python-image: [ << pipeline.parameters.default-python-image >>, "cimg/python:3.9", "cimg/python:3.10", "cimg/python:3.11", "cimg/python:3.12", cimg/python:3.13 ]
       - tests-python:
           requires:
-            - test-3.8
-            - test-3.9
-            - test-3.10
-            - test-3.11
-            - test-3.12
-            - test-3.13
+            - tests-python
           name: test-integration
-          python-image: *default-python
+          python-image: <<pipeline.parameters.default-python-image>>
           pytest-marker: "integration"
 
   nightly:

.readthedocs.yaml

@@ -0,0 +1,13 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
+
+mkdocs:
+  configuration: docs/mkdocs.yml
+
+python:
+  install:
+    - requirements: docs/requirements.txt

CHANGELOG.md

@@ -1,7 +1,57 @@
 # Change Log
 
-## 0.13.0 [unreleased]
+# 0.17.0 [unreleased]
 
+### CI
+
+1. [#164](https://github.com/InfluxCommunity/influxdb3-python/pull/164): Fix pipelines not downloading the correct python images.
+
+## 0.16.0 [2025-09-15]
+
+### Features
+
+1. [#158](https://github.com/InfluxCommunity/influxdb3-python/pull/158)  Improved parameters for setting timeouts
+   - `InfluxDB3Client()` constructor now directly specifies
+      - `write_timeout` - timeout in milliseconds to be used when writing data.
+      - `query_timeout` - timeout in milliseconds to be used when querying data.
+   - Timeouts can be specifically overridden in direct method calls.
+      - `client.write()` now propagates the argument  `_request_timeout` as an `int` in milliseconds on the call stack 
+         even in batching mode.
+      - `client.query()` now propagates the argument `timeout` as a `float` in seconds on the call stack.
+
+### CI
+
+1. [#153](https://github.com/InfluxCommunity/influxdb3-python/pull/153) Add tests for arm64 CircleCI.
+
+## 0.15.0 [2025-08-12]
+
+### Features
+
+1. [#146](https://github.com/InfluxCommunity/influxdb3-python/pull/146): Add function to get InfluxDB version.
+2. [#149](https://github.com/InfluxCommunity/influxdb3-python/pull/149): Run integration tests against a locally started InfluxDB 3 Core server.
+
+## 0.14.0 [2025-06-18]
+
+### Features
+
+1. [#141](https://github.com/InfluxCommunity/influxdb3-python/pull/141) Move "setuptools" package to build dependency.
+2. [#142](https://github.com/InfluxCommunity/influxdb3-python/pull/142):  Support fast writes without waiting for WAL
+   persistence:
+   - New write option (`WriteOptions.no_sync`) added: `True` value means faster write but without the confirmation that
+     the data was persisted. Default value: `False`.
+   - **Supported by self-managed InfluxDB 3 Core and Enterprise servers only!**
+   - Also configurable via environment variable (`INFLUX_WRITE_NO_SYNC`).
+   - Long precision string values added from v3 HTTP API: `"nanosecond"`, `"microsecond"`, `"millisecond"`,
+     `"second"` (     in addition to the existing `"ns"`, `"us"`, `"ms"`, `"s"`).
+3. [#145](https://github.com/InfluxCommunity/influxdb3-python/pull/145): Improve the document wording for README.md
+
+## 0.13.0 [2025-05-20]
+
+### Features
+
+1. [#130](https://github.com/InfluxCommunity/influxdb3-python/pull/130): Remove org parameters from the example code because It is not mandatory in Influxdb3
+2. [#139](https://github.com/InfluxCommunity/influxdb3-python/pull/139): Supports environment variables with the same name as other clients
+3. [#140](https://github.com/InfluxCommunity/influxdb3-python/pull/140): Query api will throw `InfluxdbClientQueryError` when receiving `ArrowException` from gRPC servers
 
 ## 0.12.0 [2025-03-26] 
 

Examples/basic_ssl_example.py

@@ -70,7 +70,6 @@ def write_and_query_with_explicit_sys_cert(conf):
     print("\nwrite and query with typical linux system cert\n")
     with InfluxDBClient3(token=conf.token,
                          host=conf.host,
-                         org=conf.org,
                          database=conf.database,
                          ssl_ca_cert="/etc/ssl/certs/ca-certificates.crt",
                          verify_ssl=True) as _client:
@@ -90,7 +89,6 @@ def query_with_verify_ssl_off(conf, cert):
     # Switch verify_ssl to True to throw SSL_ERROR_SSL
     with InfluxDBClient3(token=conf.token,
                          host=conf.host,
-                         org=conf.org,
                          database=conf.database,
                          ssl_ca_cert=cert,
                          verify_ssl=False) as _client:

Examples/batching_example.py

@@ -70,7 +70,6 @@ def main() -> None:
     # of 10k ms and gzip compression
     with InfluxDBClient3.InfluxDBClient3(token=conf.token,
                                          host=conf.host,
-                                         org=conf.org,
                                          database=conf.database,
                                          enable_gzip=True,
                                          write_client_options=wco) as _client:

Examples/cloud_dedicated_query.py

@@ -6,7 +6,6 @@
 client = InfluxDBClient3.InfluxDBClient3(
     token=config.token,
     host=config.host,
-    org=config.org,
     database=config.database)
 
 table = client.query(

Examples/cloud_dedicated_write.py

@@ -9,7 +9,6 @@
 client = InfluxDBClient3.InfluxDBClient3(
     token=config.token,
     host=config.host,
-    org=config.org,
     database=config.database,
     write_options=WriteOptions(
         batch_size=500,

Examples/community/custom_url.py

@@ -36,7 +36,6 @@ def retry(self, conf, data: str, exception: InfluxDBError):
 client = InfluxDBClient3(
     token="",
     host="https://eu-central-1-1.aws.cloud2.influxdata.com:442",
-    org="6a841c0c08328fb1",
     database="pokemon-codex", enable_gzip=True, write_client_options=wco, write_port_overwrite=443,
     query_port_overwrite=443)
 

Examples/community/database_transfer.py

@@ -18,7 +18,6 @@ def retry(self, conf, data: str, exception: InfluxDBError):
 
 # InfluxDB connection details
 token = ""
-org = "6a841c0c08328fb1"
 dbfrom = "a"
 dbto = "b"
 url = "eu-central-1-1.aws.cloud2.influxdata.com"
@@ -44,7 +43,6 @@ def retry(self, conf, data: str, exception: InfluxDBError):
 # of 10k ms and gzip compression
 with InfluxDBClient3.InfluxDBClient3(token=token,
                                      host=url,
-                                     org=org,
                                      enable_gzip=True, write_client_options=wco) as _client:
     query = f"SHOW TAG KEYS FROM {measurement}"
     tags = _client.query(query=query, language="influxql", database=dbfrom)

Examples/config.py

@@ -6,7 +6,6 @@ class Config:
     def __init__(self):
         self.host = os.getenv('INFLUXDB_HOST') or 'https://us-east-1-1.aws.cloud2.influxdata.com/'
         self.token = os.getenv('INFLUXDB_TOKEN') or 'my-token'
-        self.org = os.getenv('INFLUXDB_ORG') or 'my-org'
         self.database = os.getenv('INFLUXDB_DATABASE') or 'my-db'
 
     def __str__(self):