feat: implement custom dependency manager and renovate preset (#106)

This PR introduces **scadm** - a standalone OpenSCAD dependency manager
published to PyPI, replacing legacy shell scripts with a modern Python
package.

## 🚀 New Features

### scadm Package (PyPI)
- **Published Package**: `cmd/scadm/` - Standalone Python package for
managing OpenSCAD installations and library dependencies
  - Install: `pip install scadm`
  - Zero external dependencies (stdlib only)
  - Cross-platform support (Windows, Linux, macOS)
  - Python 3.11+ required
- **CLI Interface**: Simple commands for installation management
  - `scadm install` - Install OpenSCAD (nightly default) + libraries
  - `scadm check` - Verify installation status
  - `scadm install --stable` - Install stable release
  - `scadm install --force` - Force reinstall
- **Configuration**: `scadm.json` in project root (moved from
`cmd/setup/dependencies.json`)
  - Defines library dependencies with Git SHAs or semver tags
  - Supports GitHub sources for libraries (BOSL2, MCAD, etc.)
  - Automatic workspace detection (searches parent dirs)

### Release & Publishing
- **Release-Please**: Configured monorepo support for dual releases
  - `homeracker` (main project) at root
  - `scadm` (Python package) at `cmd/scadm/`
- **GitHub Actions**: Automated PyPI publishing workflow
  - Triggers on `scadm-v*` tags
  - Uses PyPI trusted publishing (OIDC)
  - Manual dispatch option for testing

### Renovate Integration
- **Reusable Preset**: `renovate-dependencies.json` for tracking
`scadm.json` dependencies
- Other OpenSCAD projects can use: `"extends":
["github>kellervater/homeracker:renovate-dependencies"]`
  - Supports both Git commit SHAs and semver tags
- **Enhanced Tracking**: Updated `renovate.json5` to track:
  - OpenSCAD versions in `cmd/scadm/scadm/constants.py`
- Python versions in GitHub Actions (built-in Renovate support
confirmed)

## 🔧 Improvements

### Code Quality
- **Exception Handling**: Replaced broad `Exception` catches with
specific types
  - `OSError, subprocess.SubprocessError` for process execution
  - `zipfile.BadZipFile, tarfile.TarError` for archive operations
- Added debug logging for suppressed exceptions with explanatory
comments

### Documentation
- **README**: Comprehensive scadm documentation with Renovate
integration example
- **Copilot Instructions**: Updated with:
  - scadm usage guidelines
  - Renovate version pinning requirements (mandatory)
  - Pre-commit hooks in mandatory workflow
- **CONTRIBUTING.md**: Updated quick start to use `scadm install`

## 🗑️ Removed
- **Legacy Scripts**: Deleted `cmd/setup/install-dependencies.sh` and
`cmd/setup/install-openscad.sh`

## 📝 Updated
- **CI Workflows**: `pre-commit.yml` and `validate-models.yml` now use
`scadm install`
- **Git Ignore**: Added `cmd/scadm/dist/` and `*.egg-info/` (build
artifacts)

## 🧪 Testing
- All pre-commit hooks pass
- Package builds successfully with setuptools
- Metadata validated with twine
- Ready for PyPI publication after merge

Author: kellervater

.github/config/.release-please-manifest.json

@@ -1,3 +1,4 @@
 {
-  ".": "1.2.0"
+  ".": "1.2.0",
+  "cmd/scadm": "0.1.0"
 }

.github/config/release-please-config.json

@@ -15,7 +15,14 @@
   "extra-label": "automerge",
   "include-v-in-tag": true,
   "packages": {
-    ".": {}
-  },
-  "release-type": "simple"
+    ".": {
+      "release-type": "simple",
+      "package-name": "homeracker"
+    },
+    "cmd/scadm": {
+      "release-type": "python",
+      "package-name": "scadm",
+      "component": "scadm"
+    }
+  }
 }

.github/copilot-instructions.md

@@ -5,8 +5,14 @@ HomeRacker is a modular 3D-printable rack-building system. Core components use p
 
 ## Tools & Structure
 - **Languages**: OpenSCAD (.scad), Python, Bash
+- **Preferred Tooling**: GitHub MCP Server, Context7 MCP Server
 - **Key Dirs**: `/models/` (SCAD files), `/bin/` (tools), `/scripts/` (Fusion 360 automation)
 - **HomeRacker Standards**: 15mm base unit, 4mm lock pins, 2mm walls, 0.2mm tolerance. See `README.md` for details.
+- **Contribution Guide**: See `CONTRIBUTING.md` for setup and workflow instructions.
+- **Dependency Manager**: Use `scadm` to install OpenSCAD and libraries
+  - Install: `scadm` (installs OpenSCAD + libraries from `scadm.json`)
+  - Config: `scadm.json` in project root defines library dependencies
+  - Help: `scadm -h` for usage info
 
 ## Core Principles
 - **Test-Driven Development**: NO change without a test. EVERY change MUST be tested before completion. No exceptions for "simple" changes.
@@ -26,7 +32,8 @@ HomeRacker is a modular 3D-printable rack-building system. Core components use p
 3. **Ask before proceeding** if requirements conflict with best practices
 4. **Provide outline** before implementation for confirmation
 5. **Make the change** and immediately test it - do NOT announce completion before testing
-6. **On errors**: Step back, check docs, ask user if stuck—don't iterate blindly
+6. **Run pre-commit hooks** to catch formatting/linting issues before commit. Fix any issues found (no ignores allowed).
+7. **On errors**: Step back, check docs, ask user if stuck—don't iterate blindly
 
 ## OpenSCAD Guidelines
 - Use BOSL2 for complex geometry
@@ -46,5 +53,9 @@ HomeRacker is a modular 3D-printable rack-building system. Core components use p
 - Add inline comments only for complex regex patterns or non-obvious logic
 
 ## Renovate Guidelines
+- **Version Pinning**: MANDATORY for all dependencies (Renovate manages updates)
+  - Pin exact versions, never use version ranges or `latest`
+  - New pinning patterns: Research Renovate docs first to ensure proper tracking
+  - Examples: Docker tags, Python packages, GitHub Actions, OpenSCAD versions
 - **Testing**: Run `cmd/test/test-renovate-local.sh` to verify config changes
 - **Important**: Changes MUST be pushed to the current branch before running the test (script runs in Docker context)

.github/workflows/pre-commit.yml

@@ -24,10 +24,10 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y xvfb libglu1-mesa libfuse2 libegl1 libxcb-cursor0
 
-      - name: Install OpenSCAD
+      - name: Install OpenSCAD and dependencies
         run: |
-          chmod +x cmd/setup/install-openscad.sh
-          ./cmd/setup/install-openscad.sh --nightly
+          pip install -e cmd/scadm
+          scadm
 
       - name: Make scripts executable
         run: chmod +x cmd/export/export-core-models.sh .githooks/makerworld-export

.github/workflows/publish-scadm.yml

@@ -0,0 +1,50 @@
+name: Publish scadm to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run (build but do not publish)'
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+  id-token: write  # Required for PyPI trusted publishing
+
+jobs:
+  publish:
+    # Only publish scadm releases (tagged as scadm-v*)
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.event.release.tag_name, 'scadm-v')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        working-directory: cmd/scadm
+        run: python -m build
+
+      - name: Check package
+        working-directory: cmd/scadm
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        if: ${{ !inputs.dry_run }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: cmd/scadm/dist/
+          print-hash: true

.github/workflows/validate-models.yml

@@ -6,8 +6,8 @@ on:
     paths:
       - 'models/**/*.scad'
       - '.github/workflows/validate-models.yml'
-      - 'cmd/setup/install-openscad.sh'
-      - 'cmd/setup/install-dependencies.sh'
+      - 'cmd/scadm/**'
+      - 'scadm.json'
       - 'cmd/test/openscad-render.sh'
 
 jobs:
@@ -27,8 +27,8 @@ jobs:
 
       - name: Install OpenSCAD and dependencies
         run: |
-          chmod +x cmd/setup/install-openscad.sh
-          ./cmd/setup/install-openscad.sh --nightly
+          pip install -e cmd/scadm
+          scadm
 
       - name: Validate models
         run: |

.gitignore

@@ -5,3 +5,9 @@ bin/openscad/
 bin/openscad-nightly/
 renovate_cache/
 renovate_base/
+
+# Python
+__pycache__/
+*.py[cod]
+cmd/scadm/dist/
+cmd/scadm/*.egg-info/

CONTRIBUTING.md

@@ -9,9 +9,12 @@ Thanks for your interest in contributing! Even getting this far is already worth
 git clone https://github.com/kellervater/homeracker.git
 cd homeracker
 
-# Install OpenSCAD (Windows/Linux/macOS)
-./cmd/setup/install-openscad.sh
-./cmd/setup/install-dependencies.sh
+# Install scadm package (openscad dependency manager)
+pip install -e cmd/scadm
+
+# Install OpenSCAD (Windows/Linux/macOS) + Dependencies
+scadm
+
 # Optional (VSCode Integration)
 ./cmd/setup/install-vscode-openscad.sh
 

README.md

@@ -26,11 +26,11 @@ The parametric models are available in the [HomeRacker GitHub Repository](https:
 - [❓ Why the name?](#-why-the-name)
 - [📜 Licensing](#-licensing)
 - [🤝 Contributing](CONTRIBUTING.md)
+- [🛠️ Developer Tools](#%EF%B8%8F-developer-tools)
 - [🚀 Releases](#-releases)
 - [🧪 Tests](#-tests)
   - [⚠️ Disclaimer](#%EF%B8%8F-disclaimer)
   - [🔬 How I tested](#-how-i-tested)
-- [📋 Todos](#-todos)
 
 # 🔧 Use Cases
 I created HomeRacker because I was dissatisfied with the existing solutions available online.
@@ -221,6 +221,23 @@ These licenses apply to the `HomeRacker - Core` system and customizable rackmoun
 
 HomeRacker is an unregistered trademark of Patrick Pötz (), first used publicly on 12.04.2025.
 
+# 🛠️ Developer Tools
+
+HomeRacker includes custom tooling to streamline development:
+
+- **[scadm](cmd/scadm/README.md)** - OpenSCAD + library dependency manager
+  - Zero-dependency Python package for installing OpenSCAD (nightly/stable) and libraries
+  - Cross-platform: Windows, Linux, macOS (might work, dunno)
+  - Install: `pip install scadm` → `scadm`
+  - Manages dependencies from `scadm.json`
+
+- **[Renovate Preset](renovate-dependencies.json)** - Automated dependency updates
+  - Tracks OpenSCAD versions, GitHub releases, and Python packages
+  - Custom rules for this project's specific needs
+  - Extend in your project: `"extends": ["github>kellervater/homeracker:renovate-dependencies"]`
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions.
+
 # 🚀 Releases
 
 HomeRacker uses automated releases powered by Camunda's GitHub actions:

cmd/README.md

@@ -1,43 +1,67 @@
-# 🔧 OpenSCAD Installation Scripts
+# 🔧 OpenSCAD Installation and Testing
 
-Automated installation of OpenSCAD for the HomeRacker workspace (Windows/Linux/macOS).
+This directory contains testing scripts for OpenSCAD models.
+
+For installation, use the **scadm** package (see `cmd/scadm/` or install via `pip install scadm`).
 
 ## 📦 Quick Start
 
 ```bash
-# Install or upgrade to latest nightly release (default)
-./cmd/setup/install-openscad.sh
-
-# Install nightly build (default)
-./cmd/setup/install-openscad.sh --nightly
+# Install scadm (if not already installed)
+pip install -e cmd/scadm
 
-# Install dependencies (BOSL2 library) - already done on a fresh install-openscad call
-./cmd/setup/install-dependencies.sh
+# Install OpenSCAD + dependencies from scadm.json
+scadm
 
-# Check if update is available
-./cmd/setup/install-openscad.sh --check
+# Check if updates are available
+scadm --check
 
 # Run smoke test - validates the current openscad installation against local models
-./cmd/setup/install-openscad.sh --test
-
-# Test specific model files (e.g., after export or during development)
 ./cmd/test/openscad-render.sh models/core/parts/connector.scad
 
 # Run automated test suite (all models in test/ and makerworld/ directories)
 ./cmd/test/test-models.sh
-
-# Force reinstall
-./cmd/setup/install-openscad.sh --force
 ```
 
 ## 🤖 Automatic Updates
 
-Versions are tracked in the scripts and managed by Renovate Bot. When new releases are available, Renovate creates a PR to update the versions. After merging, run the install scripts to upgrade.
+OpenSCAD versions are managed by Renovate Bot in `cmd/scadm/scadm/constants.py`. When new releases are available, Renovate creates a PR to update the versions.
+
+## 📦 Dependency Management
+
+Dependencies are defined in `scadm.json` at the repository root. The installer supports both Git commit hashes (SHAs) and SemVer tags.
 
-## 📝 Notes
+### Configuration Format (`scadm.json`)
 
-- **Default**: Nightly snapshots - latest features and fixes
-- **Stable**: Release 2021.01 - use `--stable` flag for BOSL2 compatibility
-- **Platform Support**: Windows, Linux, and macOS (macOS treated as Linux using AppImage - untested)
-- **BOSL2**: Installed to bundled libraries directory
-- **Source**: https://files.openscad.org/
+```json
+{
+  "dependencies": [
+    {
+      "name": "BOSL2",
+      "repository": "BelfrySCAD/BOSL2",
+      "version": "266792b2a4bbf7514e73225dfadb92da95f2afe1",
+      "source": "github"
+    },
+    {
+      "name": "homeracker",
+      "repository": "kellervater/homeracker",
+      "version": "v1.1.0",
+      "source": "github"
+    }
+  ]
+}
+```
+
+### Renovate Integration
+
+To enable Renovate to update these dependencies, extend the configuration from this repository in your `renovate.json`:
+
+> **Note**: Use `github>...` for external repositories. Internally, this repository uses `local>...`.
+
+```json
+{
+  "extends": [
+    "github>kellervater/homeracker:renovate-dependencies.json"
+  ]
+}
+```