Merge branch 'master' into dependabot/pip/black-24.3.0

Author: yuce

.github/workflows/coverage_runner.yml

@@ -27,23 +27,28 @@ jobs:
         uses: hazelcast/hazelcast-tpm/membership@main
         with:
           organization-name: 'hazelcast'
-          member-name: ${{ github.event.pull_request.head.repo.owner.login }}
+          member-name: ${{ github.actor }}
           token: ${{ secrets.PAT }}
 
+  python-versions:
+    uses: ./.github/workflows/get-python-versions.yml
+
   run-tests:
     runs-on: ${{ matrix.os }}
-    needs: [check_for_membership]
+    needs: [check_for_membership, python-versions]
     if: github.event_name == 'push' || needs.check_for_membership.outputs.check-result == 'true' || github.event_name == 'workflow_dispatch'
     name: Run tests with Python ${{ matrix.python-version }} on ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [ '3.6', '3.12' ]
-        os: [ ubuntu-20.04, windows-latest ]
+        python-version:
+          - ${{ needs.python-versions.outputs.earliest-python-version }}
+          - ${{ needs.python-versions.outputs.latest-python-version }}
+        os: [ ubuntu-latest, windows-latest ]
       fail-fast: false
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -55,17 +60,17 @@ jobs:
 
       - name: Checkout code for PR
         if: github.event_name == 'pull_request_target'
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           ref: refs/pull/${{ github.event.pull_request.number }}/merge
 
       - name: Checkout repository for push event
         if: github.event_name == 'push'
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Checkout PR coming from community.
         if: github.event_name == 'workflow_dispatch'
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           ref: refs/pull/${{ github.event.inputs.pr_number }}/merge
 
@@ -75,31 +80,33 @@ jobs:
           
       - name: Run tests
         env:
-          HAZELCAST_ENTERPRISE_KEY: ${{ secrets.HAZELCAST_ENTERPRISE_KEY }}
+          HAZELCAST_ENTERPRISE_KEY: ${{ secrets.HAZELCAST_ENTERPRISE_KEY_V7 }}
+          HZ_SNAPSHOT_INTERNAL_USERNAME: ${{ secrets.HZ_SNAPSHOT_INTERNAL_USERNAME }}
+          HZ_SNAPSHOT_INTERNAL_PASSWORD: ${{ secrets.HZ_SNAPSHOT_INTERNAL_PASSWORD }}
         run: python run_tests.py
 
       - name: Publish results to Codecov for PR coming from hazelcast organization
-        if: ${{ matrix.python-version == '3.11' && matrix.os == 'ubuntu-20.04' &&  github.event_name == 'pull_request_target' }}
+        if: ${{ matrix.python-version == needs.python-versions.outputs.latest-python-version && matrix.os == 'ubuntu-latest' &&  github.event_name == 'pull_request_target' }}
         uses: codecov/codecov-action@v1
         with:
           files: ./coverage.xml
           override_pr: ${{ github.event.pull_request.number }}
 
       - name: Publish results to Codecov for Push
-        if: ${{ matrix.python-version == '3.11' && matrix.os == 'ubuntu-20.04' &&  github.event_name == 'push' }}
+        if: ${{ matrix.python-version == needs.python-versions.outputs.latest-python-version && matrix.os == 'ubuntu-latest' &&  github.event_name == 'push' }}
         uses: codecov/codecov-action@v1
         with:
           files: ./coverage.xml
 
       - name: Publish result to Codecov for PR coming from community
-        if: ${{ matrix.python-version == '3.11' && matrix.os == 'ubuntu-20.04' && github.event_name == 'workflow_dispatch' }}
+        if: ${{ matrix.python-version == needs.python-versions.outputs.latest-python-version && matrix.os == 'ubuntu-latest' && github.event_name == 'workflow_dispatch' }}
         uses: codecov/codecov-action@v1
         with:
           files: ./coverage.xml
           override_pr: ${{ github.event.inputs.pr_number }}
 
       - name: Upload remote controller logs if test run fails
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4
         if: failure()
         with:
           name: rc-logs-${{ matrix.python-version }}-${{ matrix.os }}

.github/workflows/get-python-versions.yml

@@ -0,0 +1,28 @@
+name: Get Python versions
+
+on:
+  workflow_call:
+    outputs:
+      python-versions:
+        value: ${{ jobs.get-python-versions.outputs.python-versions }}
+      earliest-python-version:
+        value: ${{ jobs.get-python-versions.outputs.earliest-python-version }}
+      latest-python-version:
+        value: ${{ jobs.get-python-versions.outputs.latest-python-version }}
+
+jobs:
+  get-python-versions:
+    runs-on: ubuntu-latest
+    outputs:
+      python-versions: ${{ steps.extract-versions.outputs.python-versions }}
+      earliest-python-version: ${{ steps.extract-versions.outputs.earliest-python-version }}
+      latest-python-version: ${{ steps.extract-versions.outputs.latest-python-version }}
+    steps:
+      - id: extract-versions
+        run: |
+          python_versions='[ "3.8", "3.9", "3.10", "3.11", "3.12", "3.13" ]'
+
+          echo "python-versions=${python_versions}" >> $GITHUB_OUTPUT
+          echo "earliest-python-version=$(echo "${python_versions}" | jq --raw-output '.[0]')" >> $GITHUB_OUTPUT
+          echo "latest-python-version=$(echo "${python_versions}" | jq --raw-output '.[-1]')" >> $GITHUB_OUTPUT
+      - run: exit 0

.github/workflows/linter_docs_mypy.yaml

@@ -9,17 +9,21 @@ on:
       - master
       - '[45].*.z'
 jobs:
+  python-versions:
+    uses: ./.github/workflows/get-python-versions.yml
+
   run-linter:
     runs-on: ubuntu-latest
+    needs: python-versions
     name: Run black to check the code style
     steps:
       - name: Setup Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: ${{ needs.python-versions.outputs.latest-python-version }}
 
       - name: Checkout to code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Install dependencies
         run: |
@@ -31,15 +35,16 @@ jobs:
           
   generate_docs:
     runs-on: ubuntu-latest
+    needs: python-versions
     name: Generate documentation
     steps:
       - name: Setup Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: ${{ needs.python-versions.outputs.latest-python-version }}
 
       - name: Checkout to code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Install dependencies
         run: |
@@ -52,15 +57,16 @@ jobs:
           
   run-mypy:
     runs-on: ubuntu-latest
+    needs: python-versions
     name: Run mypy to check type annotations
     steps:
       - name: Setup Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: ${{ needs.python-versions.outputs.latest-python-version }}
 
       - name: Checkout to code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Install dependencies
         run: |

.github/workflows/nightly_runner.yml

@@ -4,20 +4,21 @@ on:
   schedule:
     - cron: '0 2 * * *'
 jobs:
+  python-versions:
+    uses: ./.github/workflows/get-python-versions.yml
+
   run-tests:
+    needs: python-versions
     runs-on: ${{ matrix.os }}
     name: Run tests with Python ${{ matrix.python-version }} on ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [ '3.6', '3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.9']
-        os: [ ubuntu-20.04, windows-latest ]
-        exclude:
-          - os: windows-latest
-            python-version: pypy-3.9
+        python-version: ${{ fromJSON(needs.python-versions.outputs.python-versions) }}
+        os: [ ubuntu-latest, windows-latest ]
       fail-fast: false
     steps:
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install JDK
@@ -26,16 +27,18 @@ jobs:
           distribution: 'temurin'
           java-version: '17'
       - name: Checkout to code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Install dependencies
         run: |
           pip install -r requirements-test.txt
       - name: Run tests
         env:
-          HAZELCAST_ENTERPRISE_KEY: ${{ secrets.HAZELCAST_ENTERPRISE_KEY }}
+          HAZELCAST_ENTERPRISE_KEY: ${{ secrets.HAZELCAST_ENTERPRISE_KEY_V7 }}
+          HZ_SNAPSHOT_INTERNAL_USERNAME: ${{ secrets.HZ_SNAPSHOT_INTERNAL_USERNAME }}
+          HZ_SNAPSHOT_INTERNAL_PASSWORD: ${{ secrets.HZ_SNAPSHOT_INTERNAL_PASSWORD }}
         run: python run_tests.py
       - name: Upload remote controller logs on test failure
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4
         if: failure()
         with:
           name: rc-logs-${{ matrix.python-version }}-${{ matrix.os }}

.readthedocs.yaml

@@ -0,0 +1,16 @@
+# Read the Docs configuration file for Sphinx projects
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: latest
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - requirements: requirements-dev.txt

Makefile

@@ -5,6 +5,9 @@ check:
 	black --check --config black.toml .
 
 test:
+	pytest -m "not enterprise"
+
+test-enterprise:
 	pytest
 
 test-cover:

README.rst

@@ -143,7 +143,8 @@ Features
 -  Distributed, CRDT based counter, called **PNCounter**
 -  Distributed concurrency primitives from CP Subsystem such as
    **FencedLock**, **Semaphore**, **AtomicLong**
--  Integration with `Hazelcast Viridian <https://viridian.hazelcast.com/>`__
+-  Similarity search using **VectorCollection** (Beta)
+-  Integration with `Hazelcast Cloud <https://cloud.hazelcast.com/>`__
 -  Support for serverless and traditional web service architectures with
    **Unisocket** and **Smart** operation modes
 -  Ability to listen to client lifecycle, cluster state, and distributed
@@ -161,9 +162,6 @@ development/usage issues:
    repository <https://github.com/hazelcast/hazelcast-python-client/issues/new>`__
 -  `Documentation <https://hazelcast.readthedocs.io>`__
 -  `Slack <https://slack.hazelcast.com>`__
--  `Google Groups <https://groups.google.com/g/hazelcast>`__
--  `Stack
-   Overflow <https://stackoverflow.com/questions/tagged/hazelcast>`__
 
 Contributing
 ------------
@@ -218,11 +216,18 @@ following:
 -  `Supported Java virtual machine <https://docs.hazelcast.com/hazelcast/latest/deploy/versioning-compatibility#supported-java-virtual-machines>`
 -  `Apache Maven <https://maven.apache.org/>`
 
-Following commands starts the tests:
+Set the environment variables for credentials:
 
 .. code:: bash
 
-    python run_tests.py
+    export HZ_SNAPSHOT_INTERNAL_USERNAME=YOUR_MAVEN_USERNAME
+    export HZ_SNAPSHOT_INTERNAL_PASSWORD=YOUR_MAVEN_PASSWORD
+
+Following command starts the tests:
+
+.. code:: bash
+
+    python3 run_tests.py
 
 Test script automatically downloads ``hazelcast-remote-controller`` and
 Hazelcast. The script uses Maven to download those.
@@ -235,7 +240,7 @@ License
 Copyright
 ---------
 
-Copyright (c) 2008-2023, Hazelcast, Inc. All Rights Reserved.
+Copyright (c) 2008-2023, Hazelcast, Inc. All Rights Reserved.
 
 Visit `hazelcast.com <https://hazelcast.com>`__ for more
 information.