collapsarr 0.1.3__tar.gz

collapsarr-0.1.3/.dockerignore

@@ -0,0 +1,56 @@
+# Keep the build context small and reproducible. The frontend bundle and Python
+# wheel are rebuilt inside the image, so host-built artifacts are excluded.
+
+# VCS / tooling
+.git
+.gitignore
+.gitattributes
+.github
+.claude
+.agents
+
+# Python caches & local envs
+**/__pycache__
+*.py[cod]
+*.egg-info
+.venv
+venv
+env
+build
+dist
+.pytest_cache
+.mypy_cache
+.ruff_cache
+.coverage
+htmlcov
+
+# Node / frontend (deps + host build output rebuilt in-image)
+node_modules
+frontend/node_modules
+frontend/dist
+
+# Runtime data & secrets
+.env
+.env.*
+!.env.example
+/config
+*.db
+*.sqlite
+*.sqlite3
+*.sqlite3-journal
+logs
+*.log
+
+# Test media / scratch
+/samples
+/media
+
+# Docs & editor/OS junk
+docs
+*.md
+!README.md
+.idea
+.vscode
+*.swp
+.DS_Store
+Thumbs.db

collapsarr-0.1.3/.env.example

@@ -0,0 +1,16 @@
+# Collapsarr configuration.
+# Copy to `.env` and adjust as needed. All variables are optional — the values
+# below are the built-in defaults. Environment variables take precedence.
+
+# Filesystem path to the SQLite database file.
+COLLAPSARR_DATABASE_PATH=/config/collapsarr.db
+
+# Full SQLAlchemy database URL. When set, overrides COLLAPSARR_DATABASE_PATH.
+# COLLAPSARR_DATABASE_URL=sqlite:////config/collapsarr.db
+
+# API server bind address and port.
+COLLAPSARR_HOST=0.0.0.0
+COLLAPSARR_PORT=8282
+
+# Log level (DEBUG, INFO, WARNING, ERROR).
+COLLAPSARR_LOG_LEVEL=INFO

collapsarr-0.1.3/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

collapsarr-0.1.3/.github/brand/social-preview.svg

@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="640" viewBox="0 0 1280 640">
+  <rect x="0" y="0" width="1280" height="640" fill="#18151f"/>
+
+  <!-- glyph: Outer Survivors, scaled 1.3x -->
+  <g fill="#8B5CF6">
+    <rect x="176.0" y="203" width="44.2" height="130" rx="7.8"/>
+    <rect x="257.9" y="138" width="44.2" height="195" rx="7.8"/>
+    <rect x="339.8" y="203" width="44.2" height="130" rx="7.8"/>
+    <rect x="85.0"  y="203" width="62.4" height="299" rx="13"/>
+    <rect x="412.6" y="203" width="62.4" height="299" rx="13"/>
+  </g>
+
+  <text x="560" y="240" font-family="Menlo, ui-monospace, monospace" font-size="20"
+        letter-spacing="3" fill="#8B5CF6">AUDIO DOWNMIX FOR SONARR &amp; RADARR</text>
+
+  <text x="557" y="345" font-family="Futura, Avenir Next, sans-serif" font-weight="bold"
+        font-size="104" fill="#f3f1fa">Collapsarr</text>
+
+  <text x="560" y="392" font-family="Helvetica Neue, Helvetica, sans-serif" font-size="30"
+        fill="#9791ae">Enjoy your media on any speaker setup.</text>
+</svg>

collapsarr-0.1.3/.github/workflows/release.yml

@@ -0,0 +1,219 @@
+# Tag-triggered release pipeline (COL-41).
+#
+# Fires on a semver tag (v*.*.*) that lives on `main`, then:
+#   1. guard        — refuse to release a tag that is not contained in main.
+#   2. test-*       — backend (pytest/ruff/mypy) + frontend (vitest/tsc/eslint);
+#                     any failure fails the pipeline before anything is published.
+#   3. build-wheel  — build the frontend FIRST, then `python -m build` so the
+#                     wheel bundles frontend/dist -> collapsarr/static (COL-40).
+#   4. docker       — multi-arch (amd64+arm64) image build & push to Docker Hub.
+#   5. pypi-publish — publish the wheel/sdist to PyPI via OIDC Trusted Publishing.
+#   6. github-release — cut a GitHub Release with the built artifacts attached.
+#
+# Credentials come from GitHub Actions secrets / OIDC that the HITL epic (COL-9)
+# populates; this workflow only wires them up. It is intentionally reviewable and
+# dry-runnable before those secrets exist — nothing here is evaluated until a real
+# tag is pushed.
+#
+# Named secrets / tokens this workflow reads:
+#   - Docker Hub push : secrets.DOCKERHUB_USERNAME + secrets.DOCKERHUB_TOKEN
+#   - GitHub Release  : secrets.GITHUB_TOKEN (auto-provided by Actions)
+#   - PyPI push       : OIDC Trusted Publishing (no secret; requires a PyPI
+#                       "pending publisher" configured for this repo/workflow).
+
+name: release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: read
+
+env:
+  IMAGE_NAME: odxnsson/collapsarr
+  PYTHON_VERSION: '3.12'
+  NODE_VERSION: '20'
+
+jobs:
+  # ---- Guard: enforce the "tag pushed to main" acceptance criterion -----------
+  guard:
+    name: Verify tag is on main
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Ensure the tagged commit is contained in main
+        run: |
+          git fetch origin main
+          if git merge-base --is-ancestor "${GITHUB_SHA}" FETCH_HEAD; then
+            echo "Tag ${GITHUB_REF_NAME} (${GITHUB_SHA}) is on main — proceeding."
+          else
+            echo "::error::Tag ${GITHUB_REF_NAME} is not on main; refusing to release."
+            exit 1
+          fi
+
+  # ---- Test suite (must pass before any build/publish) ------------------------
+  test-backend:
+    name: Backend tests (pytest / ruff / mypy)
+    needs: guard
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install FFmpeg
+        run: sudo apt-get update && sudo apt-get install -y ffmpeg
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install backend with dev extras
+        run: pip install -e ".[dev]"
+      - name: Ruff
+        run: ruff check collapsarr tests
+      - name: Mypy
+        run: mypy
+      - name: Pytest
+        run: pytest
+
+  test-frontend:
+    name: Frontend tests (vitest / tsc / eslint)
+    needs: guard
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+      - name: Install dependencies
+        run: npm ci
+      - name: Lint
+        run: npm run lint
+      - name: Typecheck
+        run: npm run typecheck
+      - name: Test
+        run: npm run test
+
+  # ---- Build the wheel + sdist ------------------------------------------------
+  # Order matters: the frontend is built FIRST so frontend/dist exists when
+  # `python -m build` runs, otherwise the wheel ships without the UI (COL-40).
+  build-wheel:
+    name: Build wheel + sdist
+    needs: [test-backend, test-frontend]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+      - name: Build frontend (produces frontend/dist)
+        working-directory: frontend
+        run: |
+          npm ci
+          npm run build
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Stamp package version from the git tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "Releasing version ${VERSION}"
+          sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" pyproject.toml
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Verify the frontend was bundled into the wheel
+        run: |
+          python - <<'PY'
+          import glob, zipfile, sys
+          wheels = glob.glob("dist/*.whl")
+          if not wheels:
+              sys.exit("no wheel produced")
+          names = zipfile.ZipFile(wheels[0]).namelist()
+          if not any(n.startswith("collapsarr/static/") for n in names):
+              sys.exit("frontend assets missing from wheel (collapsarr/static/ not found)")
+          print("OK: frontend bundled into", wheels[0])
+          PY
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  # ---- Multi-arch Docker image build & push -----------------------------------
+  docker:
+    name: Build & push multi-arch image
+    needs: [test-backend, test-frontend]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Derive image version from tag
+        id: meta
+        run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      - name: Set up Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: |
+            ${{ env.IMAGE_NAME }}:${{ steps.meta.outputs.version }}
+            ${{ env.IMAGE_NAME }}:latest
+          provenance: false
+
+  # ---- Publish to PyPI (OIDC Trusted Publishing — no API token needed) --------
+  pypi-publish:
+    name: Publish to PyPI
+    needs: build-wheel
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  # ---- Cut the GitHub Release -------------------------------------------------
+  github-release:
+    name: Create GitHub Release
+    needs: [build-wheel, docker, pypi-publish]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

collapsarr-0.1.3/.gitignore

@@ -0,0 +1,61 @@
+# ---- Secrets & local config (NEVER commit these) ----
+.env
+.env.*
+!.env.example
+*.local
+docker-compose.override.yml
+
+# ---- App runtime data (arr apps store a SQLite DB + config) ----
+/config/
+*.db
+*.sqlite
+*.sqlite3
+*.sqlite3-journal
+logs/
+*.log
+
+# ---- Test media / FFmpeg scratch output ----
+# keep small committed fixtures under tests/fixtures/, ignore the rest
+/samples/
+/media/
+*.mkv
+*.mp4
+*.srt
+!tests/fixtures/**
+
+# ---- Python ----
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+.venv/
+venv/
+env/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# ---- Node / frontend ----
+node_modules/
+.npm
+npm-debug.log*
+yarn-error.log*
+.pnp.*
+.vite/
+coverage/
+
+# ---- Editors / OS junk ----
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.swp
+
+# ---- Agents ----
+.agents/
+.claude/
+docs/

collapsarr-0.1.3/Dockerfile

@@ -0,0 +1,85 @@
+# Collapsarr container image (COL-39).
+#
+# Multi-stage, multi-arch (linux/amd64 + linux/arm64) build:
+#   1. `frontend`  — Node stage that builds the Vite/React UI into /frontend/dist.
+#   2. `builder`   — Python stage that builds the collapsarr wheel via hatchling,
+#                    bundling the frontend stage's output into it (COL-40).
+#   3. final       — python:3.12-slim + FFmpeg that installs the wheel (UI
+#                    included) and runs as a PUID/PGID-adjustable user
+#                    (linuxserver.io convention).
+#
+# Build for one arch locally:
+#   docker build -t collapsarr:dev .
+# Build/push multi-arch via buildx:
+#   docker buildx build --platform linux/amd64,linux/arm64 -t <repo>/collapsarr:tag --push .
+
+# ---- Stage 1: build the frontend ------------------------------------------------
+FROM node:20-slim AS frontend
+WORKDIR /frontend
+
+# Install deps against the lockfile first so this layer caches across source edits.
+COPY frontend/package.json frontend/package-lock.json ./
+RUN npm ci
+
+COPY frontend/ ./
+RUN npm run build
+
+# ---- Stage 2: build the Python wheel -------------------------------------------
+FROM python:3.12-slim AS builder
+WORKDIR /build
+
+RUN pip install --no-cache-dir build
+
+# pyproject reads README.md (readme) and LICENSE (license-files) at build time.
+# hatch_build.py is the custom build hook that bundles frontend/dist into the
+# wheel as collapsarr/static (COL-40) — it requires frontend/dist to exist,
+# hence copying the frontend stage's output in before building.
+COPY pyproject.toml README.md LICENSE hatch_build.py ./
+COPY collapsarr/ ./collapsarr/
+COPY --from=frontend /frontend/dist ./frontend/dist
+
+RUN python -m build --wheel --outdir /dist
+
+# ---- Stage 3: runtime image ----------------------------------------------------
+FROM python:3.12-slim
+
+# FFmpeg is the core dependency (downmix pipeline); gosu drops privileges to the
+# PUID/PGID user at start-up. --no-install-recommends + apt-list cleanup keep the
+# layer small.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends ffmpeg gosu \
+    && rm -rf /var/lib/apt/lists/*
+
+# Non-root run user (linuxserver.io "abc"); the entrypoint remaps it to the
+# requested PUID/PGID at container start.
+RUN groupadd -g 1000 abc \
+    && useradd -o -m -u 1000 -g abc -d /config -s /usr/sbin/nologin abc
+
+# Install the app from the wheel built in the previous stage. The wheel already
+# bundles the built UI as collapsarr/static (COL-40) and FastAPI serves it
+# directly from there — no separate copy of the frontend build needed here.
+COPY --from=builder /dist/*.whl /tmp/
+RUN pip install --no-cache-dir /tmp/*.whl && rm -rf /tmp/*.whl
+
+COPY docker-entrypoint.sh /docker-entrypoint.sh
+RUN chmod +x /docker-entrypoint.sh
+
+# Runtime configuration. COLLAPSARR_* mirror the app defaults (collapsarr/config.py);
+# PUID/PGID are consumed by the entrypoint.
+ENV COLLAPSARR_HOST=0.0.0.0 \
+    COLLAPSARR_PORT=8282 \
+    COLLAPSARR_DATABASE_PATH=/config/collapsarr.db \
+    PUID=1000 \
+    PGID=1000
+
+# Persistent data (SQLite DB + config) lives here.
+VOLUME /config
+
+EXPOSE 8282
+
+# Liveness probe using the stdlib so no extra packages are needed.
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD python -c "import sys,urllib.request; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8282/health').status==200 else 1)"
+
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["collapsarr"]