Skip to content

1.0.1

Choose a tag to compare

@aarondodd aarondodd released this 31 Jan 19:40
· 7 commits to main since this release
003a936

Release Notes - Program Manager v1.0.1

Overview

Version 1.0.1 is a bug fix release that replaces the Windows program scanner's PowerShell-based .lnk parser with a pure Python implementation. The previous approach caused severe usability issues on Windows.

Bug Fixes

Windows Program Scanner Rewritten (Critical)

  • Problem: The "Scan for Programs" feature spawned a separate PowerShell process for every .lnk shortcut in the Start Menu. A typical Windows installation has 100+ shortcuts, resulting in hundreds of visible console windows that stole focus and rendered the system unusable during scanning.
  • Fix: Replaced with a pure Python binary parser that reads the MS-SHLLINK format directly using struct. Scanning is now instant with zero subprocess calls and zero visible windows.
  • Supports both ANSI and Unicode string encoding in .lnk files
  • Extracts target path, icon location, and working directory from raw bytes
  • Falls back to relative path when LinkInfo has no local base path

Build Script References Updated

  • Updater's find_build_script() now looks for build.ps1 instead of the removed build.cmd
  • Updater's run_build_script() invokes PowerShell with -ExecutionPolicy Bypass -File instead of cmd /c
  • Documentation references updated in README.md and CLAUDE.md

Build Scripts Modernized

  • build.sh and new build.ps1 now mirror s3browser's build logic:
    • Auto-create and activate .venv if not in a virtual environment
    • Install dependencies and PyInstaller automatically
    • Exclude unused PyQt6 modules to reduce binary size
    • Create ~/bin if it doesn't exist and install the built executable there
  • build.cmd replaced by build.ps1 (PowerShell) for Windows
  • Windows build handles in-use executable via rename-before-copy

Test Suite

  • 95 tests (up from 88 in v1.0.0), all passing
  • Added 7 tests for the .lnk binary parser:
    • Valid file with target path
    • Icon location extraction
    • Relative path fallback when no LinkInfo
    • Corrupt file handling (too small, bad header)
    • Missing file handling
    • ANSI string mode

Files Changed

Added

  • build.ps1 - Windows build script (PowerShell, replaces build.cmd)

Modified

  • progman/utils/scanner.py - Pure Python .lnk parser replacing PowerShell subprocess calls
  • progman/utils/updater.py - References build.ps1 and invokes via PowerShell
  • build.sh - Full-featured build with venv management and ~/bin install
  • tests/test_scanner.py - Added .lnk binary parser tests
  • README.md - Updated build script references
  • CLAUDE.md - Updated build script references

Removed

  • build.cmd - Replaced by build.ps1

Known Limitations

  • macOS icon extraction returns .icns paths which Qt may not render on all platforms
  • GitHub API rate limit: 60 requests/hour for unauthenticated access (sufficient for 7-day check interval)
  • The .lnk binary parser covers standard Shell Link formats; exotic or malformed shortcuts created by non-standard tools may not parse correctly (they are silently skipped)