Merge branch 'develop' of github.com:Morg42/plugins into develop

Author: Morg42

.github/workflows/builddevdoc.yml

@@ -1,5 +1,4 @@
-name: "Build doc from develop/plugins"
-#on: [workflow_dispatch, push]
+name: "Build doc from develop (plugins)"
 on:
   workflow_dispatch:
   push:
@@ -8,11 +7,14 @@ on:
 
 jobs:
   build:
+    # Only run on the upstream repository — forks have no dev_doc companion repo
+    # and lack the PAT_TOKEN secret required for the deploy step.
+    if: github.repository == 'smarthomeNG/plugins'
     runs-on: ubuntu-22.04 #latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ '3.11' ]
+        python-version: ['3.11']
     name: Python ${{ matrix.python-version }}
     steps:
       - name: update OS (Ubuntu)
@@ -22,54 +24,55 @@ jobs:
       - run: sudo apt-get install gcc --only-upgrade
       - run: sudo locale-gen de_DE.UTF-8
       - run: locale -a
-      - uses: actions/checkout@v2
+
+      - uses: actions/checkout@v4
+
       - name: Checkout SmartHomeNG DEVELOP Branch
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           repository: smarthomeNG/smarthome
           ref: develop
           path: smarthomeng
+
       - name: Checkout SmartHomeNG/plugins DEVELOP Branch
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           repository: smarthomeNG/plugins
           ref: develop
           path: smarthomeng/plugins
+
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           architecture: x64
+
       - name: Print Python Version
         run: python --version
-      - run: python3 -m pip install --upgrade pip #==19.3.1
-      #- run: pip install tox-travis virtualenv>=20.0.8 --upgrade
-      #- run: pip install sphinx sphinx_rtd_theme recommonmark ruamel.yaml pytest
+
+      - run: python3 -m pip install --upgrade pip
+
       - name: Install requirements for documentation build
         run: pip install -r smarthomeng/doc/requirements.txt
 
       - name: Build Requirements for SmartHomeNG
         run: python3 smarthomeng/tools/build_requirements.py
+
       - name: Install SmartHomeNG base requirements
         # base requirements are needed for building of documentation
         run: pip install -r smarthomeng/requirements/base.txt
+
       - name: List installed packages
         run: pip list
 
       - name: Build documentation
         working-directory: ./smarthomeng/doc
         run: bash ./build_doc_local.sh
 
-      #- name: Deploy documentation
-      #  uses: JamesIves/github-pages-deploy-action@v4.3.3
-      #  with:
-      #    branch: develop_doc # The branch the action should deploy to.
-      #    folder: ./smarthomeng/doc/user/build/html # The folder the action should deploy.
-
       - name: Deploy documentation to seperate repo dev_doc
         uses: JamesIves/github-pages-deploy-action@v4.3.3
         with:
-          branch: gh-pages # The branch the action should deploy to.
-          folder: ./smarthomeng/doc/user/build/html # The folder the action should deploy.
+          branch: gh-pages
+          folder: ./smarthomeng/doc/user/build/html
           repository-name: 'smarthomeNG/dev_doc'
           token: ${{ secrets.PAT_TOKEN }}

.github/workflows/unittests.yml

@@ -110,6 +110,14 @@ jobs:
         # all requirements are needed for pytest to run plugin tests
         run: pip install -r requirements/all.txt
 
+      # --- Linting ---
+      - name: Lint with ruff
+        run: |
+          pip install "ruff>=0.4.0"
+          ruff check plugins/ --output-format=github
+        # --output-format=github annotates violations inline on the PR diff.
+        # Uses plugins/pyproject.toml — see SYNC NOTE in both pyproject.toml files.
+
       - name: '>>> Run Python Unittests for PLUGINS <<<'
         working-directory: ./plugins
         run: pytest