fix: set grpcio minimum version to 1.71.0

.github/workflows/ci.yml

@@ -0,0 +1,75 @@
+name: build package
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    tags:
+      - '*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+      - run: |
+          pip install tox
+      - name: Run linters
+        run: |
+          tox -e genproto
+          tox -e build || true
+
+  test:
+    runs-on: ubuntu-latest
+    needs: build
+    strategy:
+      matrix:
+        pyversion:
+          - '3.8'
+          - '3.10'
+          - '3.12'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/[email protected]
+        with:
+          python-version: ${{ matrix.pyversion }}
+      - run: |
+          pip install tox
+      - name: Run unittests
+        run: |
+          tox -e genproto
+          tox -e unittests
+
+  lint:
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+      - run: |
+          pip install tox
+      - name: Run linters
+        run: |
+          tox -e genproto
+          tox -e lint || true
+
+  doc:
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+      - run: |
+          pip install tox
+      - name: Run linters
+        run: |
+          tox -e genproto
+          tox -e doc

.github/workflows/publish.yml

@@ -0,0 +1,95 @@
+name: build
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  publish:
+    runs-on: public-ledgerhq-shared-small
+    permissions:
+      id-token: write
+      contents: read
+      attestations: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+      - run: |
+          pip install tox
+          tox -e genproto
+          tox -e build
+      # initiate jfrog login and install jf
+      - name: Login to JFrog Ledger
+        uses: LedgerHQ/actions-security/actions/jfrog-login@actions/jfrog-login-1
+      # upload package to jfrog
+      - name: upload package
+        run: jf rt u --build-name=python-etcd3-release --build-number=1 --module=etcd3 'dist/*.tar.gz' enclave-pypi-prod-green
+      # attest that the delivered package is authenticated as a CI build
+      - name: Attest
+        id: attest
+        uses: LedgerHQ/actions-security/actions/attest@actions/attest-1
+        with:
+          subject-path: 'dist/*.tar.gz'
+          push-to-registry: false
+      - uses: LedgerHQ/actions/gemfury/publish@main
+        env:
+          PUSH_TOKEN: ${{ secrets.PYPI_PUSH_TOKEN }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ github.run_id }}
+          path: |
+            dist
+          retention-days: 2
+
+  validate:
+    runs-on: public-ledgerhq-shared-small
+    permissions:
+      id-token: write
+      contents: read
+    needs:
+      - publish
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist-${{ github.run_id }}
+          path: dist
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+          cache: 'pip'
+      - run: |
+          pip install build twine wheel-filename blob
+      # in order to allow test pip install after publish, get back pkg version
+      - name: get back local build version
+        id: get_pkg_version
+        run: |
+          from wheel_filename import parse_wheel_filename
+          import glob
+          import os
+          from random import choices
+          from string import ascii_letters
+
+          whl = str(glob.glob('dist/*.whl')[0]);
+          pwf = parse_wheel_filename('dist/' + whl);
+          with open(os.environ["GITHUB_OUTPUT"], "a") as gh_output:
+             delimiter = "".join(choices(ascii_letters, k=16))
+             gh_output.writelines([
+             f"pkg_version<<{delimiter}\n",
+             f"{pwf.version}\n",
+             delimiter + "\n",
+          ])
+        shell: python
+      - name: Login to JFrog Ledger
+        uses: LedgerHQ/actions-security/actions/jfrog-login@actions/jfrog-login-1
+      # configure jfrog repo and test pip install from it for the delivered package
+      - name: set jfrog Repo URL
+        run: jf pipc --global --repo-resolve=enclave-pypi-virtual-green
+      - name: test install from jfrog
+        run: |
+          jf pip install etcd3==${{ steps.get_pkg_version.outputs.pkg_version }}
+          pip show etcd3
+        shell: bash

MANIFEST.in

@@ -5,11 +5,7 @@ include CONTRIBUTING.rst
 include HISTORY.rst
 include LICENSE
 include README.rst
-include requirements/base.txt
-include requirements/test.txt
 
 recursive-include tests *
-recursive-exclude * __pycache__
-recursive-exclude * *.py[co]
 
 recursive-include docs *.rst conf.py Makefile make.bat *.jpg *.png *.gif

README.rst

@@ -30,7 +30,29 @@ If you're interested in using this library, please get involved.
 * Free software: Apache Software License 2.0
 * Documentation: https://python-etcd3.readthedocs.io.
 
-Basic usage:
+
+Building python package
+-----------------------
+
+The package build is made using the ToX orchestrator.
+It is required to generate python files before building the package as they are
+not kept in gconf.
+You only need the ToX orchestrator to produce the package:
+
+```
+pip install tox
+```
+
+A typical build sequence is the folling:
+
+```
+tox -e genproto
+tox -e build
+```
+
+
+Basic usage
+-----------
 
 .. code-block:: python