atfield 0.4.2__tar.gz

atfield-0.4.2/.github/workflows/ci.yml

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test (${{ matrix.os }} / Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Production target is Windows; cross-platform tests guard with skipif
+        # so the suite is green on Linux too. Two OS rows ensures we don't
+        # accidentally introduce a Windows-only or Linux-only regression.
+        os: [windows-latest, ubuntu-latest]
+        python-version: ['3.10', '3.11', '3.12']
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install package + dev deps
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check src/ tests/
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short
+
+  smoke:
+    # Fast end-to-end sanity check: build the wheel, install it into a fresh
+    # venv, run `atf inputs` (which exercises every collector probe) and `atf
+    # version`. Catches packaging regressions that pure pytest can miss.
+    name: Wheel + CLI smoke
+    runs-on: windows-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Build wheel
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build --wheel
+
+      - name: Install built wheel into a fresh venv
+        run: |
+          python -m venv ci-smoke-venv
+          ci-smoke-venv\Scripts\python.exe -m pip install --upgrade pip
+          $wheel = (Get-ChildItem -Path dist -Filter atfield-*.whl | Select-Object -First 1).FullName
+          ci-smoke-venv\Scripts\python.exe -m pip install $wheel
+        shell: pwsh
+
+      - name: atf version
+        run: ci-smoke-venv\Scripts\atf.exe version
+
+      - name: atf inputs (probes every collector)
+        # CI has no NVIDIA GPU and no LHM, so this is the
+        # capability-negotiation-on-bare-metal scenario. Should report system
+        # collector OK, NVML unavailable, LHM unavailable -- and exit 0.
+        run: ci-smoke-venv\Scripts\atf.exe inputs

atfield-0.4.2/.github/workflows/release.yml

@@ -0,0 +1,291 @@
+name: Release
+
+# Triggered on annotated tag pushes that match v* (semver tags).
+# Builds the Python wheel + the standalone PyInstaller bundle + the
+# Tauri tray app installer, then attaches everything to a GitHub
+# Release. Manual runs are also allowed via workflow_dispatch so you
+# can produce a draft release without tagging first.
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to publish (e.g. v0.2.0). Leave blank to draft from current main."
+        required: false
+        default: ""
+
+permissions:
+  # Need write access to publish a release + upload assets. The
+  # built-in GITHUB_TOKEN is used; no PAT.
+  contents: write
+
+# Avoid two concurrent release runs (e.g. tag push + manual dispatch
+# at the same time) racing for the same release upload.
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  # ─────────────────────────────────────────────────────────────────
+  # 1. Pure-Python wheel (cross-platform, no GPU deps in the build).
+  # ─────────────────────────────────────────────────────────────────
+  wheel:
+    name: Build wheel + sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Build wheel + sdist
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dists
+          path: dist/*
+          retention-days: 7
+
+  # ─────────────────────────────────────────────────────────────────
+  # 1b. Publish the wheel + sdist to PyPI via Trusted Publishing (OIDC).
+  #
+  #     No API token/secret: PyPI verifies the GitHub OIDC identity. This
+  #     requires a one-time "pending publisher" set up on PyPI pointing at
+  #     this repo + workflow + the `pypi` environment (see docs/packaging.md).
+  #     Runs only for real (non-prerelease) version tags. A failure here does
+  #     NOT block the GitHub Release job below -- they're independent.
+  # ─────────────────────────────────────────────────────────────────
+  publish-pypi:
+    name: Publish to PyPI
+    needs: wheel
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v') && !contains(github.ref_name, '-')
+    environment:
+      name: pypi
+      url: https://pypi.org/project/atfield/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheel + sdist
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dists
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # ─────────────────────────────────────────────────────────────────
+  # 2. Standalone PyInstaller bundle (Windows-only).
+  #    Produces dist/atfield/ with atfield-service.exe + atf.exe and
+  #    a shared _internal/. Zips it for the GitHub release.
+  # ─────────────────────────────────────────────────────────────────
+  standalone:
+    name: Standalone Windows bundle
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install package + PyInstaller
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -m pip install "pyinstaller>=6.20"
+
+      - name: Build standalone bundle
+        run: pyinstaller --noconfirm --clean packaging/pyinstaller/atfield.spec
+
+      # Vendor LHM into the bundle so the watchdog ships VRAM-junction
+      # and CPU-package temp support out of the box. fetch_lhm.ps1 drops
+      # LibreHardwareMonitor.exe + its DLLs into dist/atfield/ where
+      # find_lhm_executable() looks first (next to atfield-service.exe).
+      - name: Vendor LibreHardwareMonitor
+        shell: pwsh
+        run: pwsh scripts/fetch_lhm.ps1
+
+      # Compile the headless sensor helper (atfield-sensors.exe) against the
+      # LibreHardwareMonitorLib.dll just vendored. Uses the in-box .NET
+      # Framework csc.exe (present on windows-latest), so no SDK install.
+      # The tray installer's resources manifest REQUIRES this exe, so the
+      # tray-installer job would fail without it.
+      - name: Build headless sensor helper
+        shell: pwsh
+        run: pwsh scripts/build_helper.ps1
+
+      - name: Smoke-test bundled binaries
+        # Make sure the frozen exes at least respond to --help before we
+        # ship them. Catches missing hidden imports / data files, and that
+        # the sensor helper actually built.
+        shell: pwsh
+        run: |
+          dist/atfield/atf.exe version
+          dist/atfield/atf.exe inputs
+          if (-not (Test-Path dist/atfield/atfield-sensors.exe)) {
+            throw "atfield-sensors.exe missing -- build_helper.ps1 did not produce the sensor helper."
+          }
+
+      - name: Zip standalone bundle
+        shell: pwsh
+        run: |
+          $version = "${{ github.ref_name }}".TrimStart('v')
+          if (-not $version) { $version = "dev" }
+          Compress-Archive -Path dist/atfield/* -DestinationPath "dist/atfield-$version-windows-x64.zip"
+
+      - name: Upload standalone bundle
+        uses: actions/upload-artifact@v4
+        with:
+          name: standalone-bundle
+          path: dist/atfield-*-windows-x64.zip
+          retention-days: 7
+
+  # ─────────────────────────────────────────────────────────────────
+  # 3. Tauri tray app installer (Windows NSIS).
+  #
+  # Depends on `standalone` so we can stage dist/atfield/ -- the Tauri
+  # config references it as bundle.resources, producing a single
+  # installer that ships BOTH the tray app AND the watchdog binaries.
+  # ─────────────────────────────────────────────────────────────────
+  tray-installer:
+    name: Tauri tray installer
+    runs-on: windows-latest
+    needs: standalone
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: at-field-tray/package-lock.json
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: x86_64-pc-windows-msvc
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: "at-field-tray/src-tauri -> target"
+
+      # Re-stage the standalone bundle artifact at dist/atfield/ so
+      # bundle.resources in tauri.conf.json resolves correctly.
+      - name: Download standalone bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: standalone-bundle
+          path: standalone-zip
+
+      - name: Stage standalone at dist/atfield/
+        shell: pwsh
+        run: |
+          $zip = Get-ChildItem standalone-zip -Filter atfield-*-windows-x64.zip |
+                 Select-Object -First 1
+          if (-not $zip) { throw "Standalone bundle artifact missing." }
+          New-Item -ItemType Directory -Path dist/atfield -Force | Out-Null
+          Expand-Archive -Path $zip.FullName -DestinationPath dist/atfield -Force
+          Get-ChildItem dist/atfield | Format-Table -AutoSize
+
+      - name: Install npm deps
+        working-directory: at-field-tray
+        run: npm ci
+
+      - name: Build Tauri NSIS installer
+        working-directory: at-field-tray
+        run: npm run tauri build -- --bundles nsis
+
+      - name: Locate installer
+        id: locate
+        shell: pwsh
+        run: |
+          $exe = Get-ChildItem -Path at-field-tray/src-tauri/target/release/bundle/nsis -Filter *-setup.exe |
+                 Select-Object -First 1
+          if (-not $exe) { throw "No NSIS installer produced." }
+          "exe=$($exe.FullName)" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
+
+      - name: Upload tray installer
+        uses: actions/upload-artifact@v4
+        with:
+          name: tray-installer
+          path: ${{ steps.locate.outputs.exe }}
+          retention-days: 7
+
+  # ─────────────────────────────────────────────────────────────────
+  # 4. Publish: gather every artifact and create / update the release.
+  # ─────────────────────────────────────────────────────────────────
+  publish:
+    name: Publish GitHub Release
+    needs: [wheel, standalone, tray-installer]
+    runs-on: ubuntu-latest
+    # Only publish for real on actual tag pushes. workflow_dispatch
+    # runs upload artifacts but skip the release step (lets you
+    # validate the build without making noise).
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+        # Need full history so the release notes generator can walk
+        # since the previous tag.
+        with:
+          fetch-depth: 0
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: release-assets
+          merge-multiple: true
+
+      - name: List collected assets
+        run: ls -lh release-assets/
+
+      - name: Extract changelog section for this version
+        id: changelog
+        shell: bash
+        run: |
+          set -euo pipefail
+          version_tag="${GITHUB_REF_NAME}"     # e.g. v0.2.0
+          version_no_v="${version_tag#v}"      # e.g. 0.2.0
+          # Pull the section between `## [<version>]` and the next `## `.
+          # Falls back to a generic message if no matching section.
+          notes=$(awk -v ver="$version_no_v" '
+            BEGIN { inside=0 }
+            /^## \[/ {
+              if (inside) exit
+              if ($0 ~ "\\[" ver "\\]") { inside=1; next }
+            }
+            inside { print }
+          ' CHANGELOG.md || true)
+          if [ -z "$notes" ]; then
+            notes="See CHANGELOG.md for details."
+          fi
+          # Multi-line outputs go through GITHUB_OUTPUT with a delimiter.
+          delim=$(openssl rand -hex 8)
+          {
+            printf 'notes<<%s\n' "$delim"
+            printf '%s\n' "$notes"
+            printf '%s\n' "$delim"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create / update GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: AT-Field ${{ github.ref_name }}
+          body: ${{ steps.changelog.outputs.notes }}
+          files: release-assets/*
+          draft: false
+          prerelease: ${{ contains(github.ref_name, '-') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

atfield-0.4.2/.gitignore

@@ -0,0 +1,61 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.cursor/
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# AT-Field local artifacts
+local_state/
+*.log
+events.jsonl
+nssm.exe
+# ...but the vendored NSSM that ships in the installer IS tracked on purpose
+# (install_service.ps1 copies it so setup never depends on the flaky nssm.cc).
+!scripts/vendor/nssm.exe
+resources/LibreHardwareMonitor/
+
+# PyInstaller -- generated specs only. Keep our authored spec under packaging/.
+/*.spec
+/build/
+/dist/
+
+# Planning / handoff docs — kept local, not in git history
+/PLANNING.md
+/docs/chat-history.md
+/docs/planning/
+
+# Ad-hoc diagnostic scripts + reports (crash investigations, font A/Bs, etc.)
+/diag-*.ps1
+/diag-*-report.txt
+/font-comparison.html
+/nul