Support python >=3.10 to <4 (#1662)

Author: cptartur

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -40,7 +40,7 @@ body:
     id: python-version
     attributes:
       label: Python version
-      description: What version of Python are you using? Note that the currently supported Python version is 3.9.
+      description: What version of Python are you using? Note that the lowest currently supported Python version is 3.10.
     validations:
       required: true
 

.github/workflows/checks.yml

@@ -37,12 +37,16 @@ jobs:
           python -m pip install --upgrade pip
           pip install poetry
 
-      - name: Set up Python 3.12
+      - name: Set up Python 3.14
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'poetry'
 
+      - name: Install dependencies needed for HIDAPI and Pillow
+        run: |
+          sudo apt install python3-dev libusb-1.0-0-dev libudev-dev libjpeg-dev
+
       - name: Install dependencies
         run: |
           poetry install -E ledger
@@ -72,7 +76,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [ "3.12" ]
+        python-version: [ "3.14" ]
     steps:
 
       # ====================== SETUP ====================== #
@@ -81,7 +85,7 @@ jobs:
       - uses: asdf-vm/actions/setup@v3
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'pip'
 
       - name: Install poetry
@@ -143,7 +147,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.9", "3.12" ]
+        python-version: [ "3.10", "3.14" ]
     env:
       LEDGER_PROXY_ADDRESS: 127.0.0.1
       LEDGER_PROXY_PORT: 9999
@@ -159,7 +163,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'pip'
 
       # ====================== SETUP PYTHON ====================== #
@@ -175,6 +179,10 @@ jobs:
           python-version: ${{ matrix.python-version }}
           cache: 'poetry'
 
+      - name: Install dependencies needed for HIDAPI and Pillow
+        run: |
+          sudo apt install python3-dev libusb-1.0-0-dev libudev-dev libjpeg-dev
+
       - name: Install dependencies
         run: |
           poetry install -E ledger
@@ -285,7 +293,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'pip'
 
       # ====================== SETUP PYTHON ====================== #
@@ -295,12 +303,16 @@ jobs:
           python -m pip install --upgrade pip
           pip install poetry
 
-      - name: Set up Python 3.12
+      - name: Set up Python 3.14
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'poetry'
 
+      - name: Install dependencies needed for HIDAPI and Pillow
+        run: |
+          sudo apt install python3-dev libusb-1.0-0-dev libudev-dev libjpeg-dev
+
       - name: Install dependencies
         run: |
           poetry install -E ledger
@@ -344,7 +356,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.9", "3.12" ]
+        python-version: [ "3.10", "3.14" ]
     env:
       SEPOLIA_RPC_URL: ${{ secrets.SEPOLIA_RPC_URL }}
     steps:
@@ -361,7 +373,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'pip'
 
       # ====================== SETUP DEVNET ====================== #
@@ -394,7 +406,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          poetry install -E ledger
+          poetry install
 
       # ====================== RUN TESTS ====================== #
 
@@ -425,7 +437,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.9", "3.12" ]
+        python-version: [ "3.10", "3.14" ]
     steps:
       - uses: actions/checkout@v4
 
@@ -437,7 +449,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'pip'
 
       # ====================== SETUP PYTHON ====================== #
@@ -496,7 +508,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.9", "3.12" ]
+        python-version: [ "3.10", "3.14" ]
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@dc6353516c68da0f06325f42ad880f76a5e77ec9
@@ -511,7 +523,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
           cache: 'pip'
 
       # ====================== SETUP PYTHON ====================== #

.github/workflows/package.yml

@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.10'
 
       - name: Install poetry
         run: python -X utf8 -m pip install poetry

.pylintrc

@@ -52,7 +52,7 @@ persistent=yes
 
 # Minimum Python version to use for version dependent checks. Will default to
 # the version used to run pylint.
-py-version=3.9
+py-version=3.10
 
 # When enabled, pylint would attempt to guess common misconfiguration and emit
 # user-friendly hints instead of false-positive error messages.

.python-version

@@ -1 +1 @@
-3.9.12
+3.10

.readthedocs.yml

@@ -5,7 +5,7 @@ build:
   apt_packages:
     - libgmp3-dev
   tools:
-    python: "3.9"
+    python: "3.10"
   jobs:
     pre_install:
       - pip install poetry

docs/api/signer.rst

@@ -36,12 +36,20 @@ KeyPair
 LedgerSigner
 ------------
 
-To use LedgerSigner, you need to install starknetpy with `ledger` extra like this:
+To use LedgerSigner, you need to install starknetpy with ``ledger`` extra like this:
 
 .. code-block:: bash
 
     poetry add starknet_py[ledger]
 
+Under a Debian or Ubuntu based system, you will need to install additional packages:
+
+.. code-block:: bash
+
+    sudo apt install python3-dev libusb-1.0-0-dev libudev-dev
+
+They are needed for compiling HIDAPI. Read official `ledgerctl installation guide <https://github.com/LedgerHQ/ledgerctl?tab=readme-ov-file#quick-install)>`_ for more details.
+
 .. py:module:: starknet_py.net.signer.ledger_signer
 
 .. autoclass:: LedgerSigner

docs/migration_guide.rst

@@ -1,6 +1,26 @@
 Migration guide
 ===============
 
+****************************
+<unreleased> Migration guide
+****************************
+
+Version <unreleased> changes the supported Python version.
+The **lowest** supported version Python is now 3.10.
+
+<unreleased> Dependency changes
+-------------------------------
+
+.. py:currentmodule:: starknet_py.net.signer.ledger_signer
+
+1. When installing extra dependencies needed for :class:`LedgerSigner`, Linux users may have to install additional packages:
+
+.. code-block:: bash
+
+    sudo apt install python3-dev libusb-1.0-0-dev libudev-dev
+
+These packages are needed for HIDAPI compilation. Read official `ledgerctl installation guide <https://github.com/LedgerHQ/ledgerctl?tab=readme-ov-file#quick-install)>`_ for more details.
+
 ***************************
 0.29.0-rc.1 Migration guide
 ***************************

poetry.lock

@@ -29,6 +29,6 @@ def process_tokens(self, tokens):
             if token.type == tokenize.COMMENT:
                 quotes_stripped = token.string.strip('"').strip("'")
                 if "TODO" in quotes_stripped and not re.match(
-                    "#\s*TODO\s*\(#\d+\):.*", quotes_stripped
+                    r"#\s*TODO\s*\(#\d+\):.*", quotes_stripped
                 ):
                     self.add_message(self.name, line=token.start[0])