pioarduino v1.4.0

v1.4.0

Author: Jason2866

.github/workflows/main.yml

@@ -4,51 +4,70 @@ on:
   workflow_dispatch:      # Start a workflow
   push:
 
-
 jobs:
-  build:
+   build:
+    permissions:
+      contents: write
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        os: [ubuntu-latest, ubuntu-24.04-arm, windows-latest, macos-13, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Check Python
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+          cache-dependency-path: |
+            pyproject.toml
+            uv.lock
+      - name: Check Python and uv
         run: |
-          python -V
-          which python
+          uv run python -V
+          uv run python -c "import sys,shutil;print(sys.executable);print(shutil.which('python') or '')"
+          uv --version
           echo $PATH
-      - name: Install dependencies
+      - name: Install dependencies with uv
         run: |
-          python -m pip install --upgrade pip
-          pip install -U tox pytest
-          pip install -e .
+          uv sync --dev
       - name: Python Lint
         run: |
-          tox -e lint
+          uv run make lint
       - name: Integration Tests
         run: |
-          make test
+          uv run make test
       - name: Pack Installer Script
         run: |
-          make pack
+          uv run make pack
+      - name: Copy Installer Script to Parent Directory
+        run: |
+          cp dist/*.py .
+        shell: bash
       - name: Commit changed `get-platformio.py`
-        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
         uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: "Github Action: Updated `get-platformio.py`"
       - name: Install PlatformIO Core
         run: |
-          python3 get-platformio.py
+          uv run python get-platformio.py
           if [ "$RUNNER_OS" == "Windows" ]; then
             ~/.platformio/penv/Scripts/pio.exe system info
           else
             ~/.platformio/penv/bin/pio system info
           fi
         shell: bash
+      - name: Verify uv is installed in PlatformIO penv
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            ~/.platformio/penv/Scripts/uv.exe --version
+          else
+            ~/.platformio/penv/bin/uv --version
+          fi
+        shell: bash

.github/workflows/test-get-platformio-no-uv.yml

@@ -0,0 +1,44 @@
+name: Test get-platformio.py without uv
+
+on:
+  workflow_dispatch:      # Start a workflow
+  push:
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-24.04, ubuntu-24.04-arm, windows-latest, macos-13, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Ensure uv is not installed
+        run: |
+          pip uninstall -y uv || true
+          if python -m uv --version 2>/dev/null; then exit 1; fi
+        shell: bash
+      - name: Run get-platformio.py
+        run: |
+          python get-platformio.py
+        shell: bash
+      - name: Install PlatformIO Core
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            ~/.platformio/penv/Scripts/pio.exe system info
+          else
+            ~/.platformio/penv/bin/pio system info
+          fi
+        shell: bash
+      - name: Verify uv is installed in PlatformIO penv
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            ~/.platformio/penv/Scripts/uv.exe --help
+          else
+            ~/.platformio/penv/bin/uv --help
+          fi
+        shell: bash

.vscode/tasks.json

@@ -0,0 +1,11 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+	     {
+         "label": "lint",
+         "type": "shell",
+         "command": "make lint",
+         "group": { "kind": "test", "isDefault": true }
+         }
+    ]
+}

Makefile

@@ -1,26 +1,37 @@
+# Use uv for all operations
+
+# Always use phony targets
+.PHONY: all lint isort format test install-dev pack before-commit clean publish
+
+# Default target
+all: before-commit
+
 lint:
-	pylint --rcfile=./.pylintrc ./pioinstaller
+	uv run pylint --rcfile=./.pylintrc ./pioinstaller
 
 isort:
-	isort ./tests
-	isort ./pioinstaller
+	uv run isort ./pioinstaller ./tests
 
 format:
-	black ./pioinstaller
-	black ./tests
+	uv run black ./pioinstaller ./tests
 
 test:
-	py.test --verbose --capture=no --exitfirst tests
+	uv run pytest --verbose --capture=no --exitfirst tests
+
+install-dev:
+	uv sync --dev
 
 pack:
-	pioinstaller pack
+	mkdir -p dist
+	uv run pioinstaller pack dist/
 
-before-commit: isort format lint
+before-commit: isort format lint test
 
 clean:
 	find . -name \*.pyc -delete
 	find . -name __pycache__ -delete
 	rm -rf .cache
 
 publish:
-	python setup.py sdist upload
+	uv build
+	uv publish

README.rst

@@ -1,4 +1,47 @@
 pioarduino Core Installer
 =========================
 
-A standalone installer for `pioarduino Core`
+A standalone installer for `pioarduino Core` using modern Python packaging tools.
+
+**Important:** The installer checks for Python 3.10–3.13 and uses `uv` to install pioarduino core. If no compatible Python is found, it will install Python 3.13.
+
+Features
+--------
+
+* Fast installation using `uv` package manager
+* Isolated virtual environment creation
+* Cross-platform compatibility (Windows, macOS, Linux)
+* Python 3.10+ support
+
+Requirements
+------------
+
+* Python 3.9 or newer for install
+* Internet connection for downloading packages
+
+Development
+-----------
+
+This project uses modern Python packaging with `pyproject.toml` and `uv`.
+
+Quick start for development (Linux and macOS)::
+
+    # Install uv if not already installed
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    
+    # Clone and setup development environment
+    git clone https://github.com/Jason2866/pioarduino-core-installer.git
+    cd pioarduino-core-installer
+    
+    # Install dependencies with uv
+    uv sync --dev
+    
+    # Run tests
+    uv run pytest
+    
+    # Format code
+    uv run black pioinstaller tests
+    uv run isort pioinstaller tests
+    
+    # Run linter
+    uv run pylint pioinstaller

pioinstaller/__init__.py

@@ -1,4 +1,5 @@
 # Copyright (c) 2014-present PlatformIO <[email protected]>
+# Copyright (c) 2024-present pioarduino
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,20 +15,19 @@
 
 import logging.config
 
-VERSION = (1, 2, 3)
-__version__ = ".".join([str(s) for s in VERSION])
+__version__ = "1.4.0"
 
 __title__ = "pioarduino-installer"
-__description__ = "An installer for PlatformIO pioarduino Core"
+__description__ = "An installer for pioarduino Core"
 
-__url__ = "https://pioarduino.org"
+__url__ = "https://github.com/pioarduino/pioarduino-core-installer"
 
 __author__ = "PlatformIO Labs and pioarduino"
-__email__ = "[email protected]"
+__contact__ = "https://discord.gg/Nutz9crnZr"
 
 
 __license__ = "Apache-2.0"
-__copyright__ = "Copyright 2014-present PlatformIO and pioarduino"
+__copyright__ = "Copyright 2014-present PlatformIO and 2024-present pioarduino"
 
 
 logging.basicConfig(format="%(levelname)s: %(message)s")

pioinstaller/__main__.py

@@ -36,18 +36,12 @@
     multiple=True,
     help="A path to Python to be ignored (multiple options and unix wildcards are allowed)",
 )
-@click.option(
-    "--pypi-index-url",
-    help="Custom base URL of the Python Package Index (default `https://pypi.org/simple`)",
-)
 @click.pass_context
 def cli(
-    ctx, verbose, shutdown_piohome, dev, ignore_python, pypi_index_url
+    ctx, verbose, shutdown_piohome, dev, ignore_python
 ):  # pylint: disable=too-many-arguments,too-many-positional-arguments
     if verbose:
         logging.getLogger("pioinstaller").setLevel(logging.DEBUG)
-    if pypi_index_url:
-        os.environ["PIP_INDEX_URL"] = pypi_index_url
     ctx.obj["dev"] = dev
     if ctx.invoked_subcommand:
         return
@@ -90,7 +84,7 @@ def python():
             % (platform.python_version(), util.get_pythonexe_path()),
             fg="green",
         )
-    except (exception.IncompatiblePythonError, exception.PythonVenvModuleNotFound) as e:
+    except exception.IncompatiblePythonError as e:
         raise click.ClickException(
             "The Python %s (%s) interpreter is not compatible.\nReason: %s"
             % (platform.python_version(), util.get_pythonexe_path(), str(e))