quasarr 2.4.10__tar.gz → 2.4.11__tar.gz

{quasarr-2.4.10 → quasarr-2.4.11}/.github/workflows/PullRequests.yml

@@ -1,4 +1,4 @@
-name: CI/CD & Beta Build
+name: Pull Requests
 
 on:
   workflow_dispatch:
@@ -34,8 +34,9 @@ jobs:
         with:
           enable-cache: true
 
-      # We just install python here so uv run has something to target
-      - run: uv python install 3.12
+      - run: |
+          echo "🐍 Installing Python 3.12..."
+          uv python install 3.12
 
       - name: Run Maintenance
         id: manager
@@ -46,7 +47,9 @@ jobs:
           GITHUB_REPO: ${{ github.repository }}
           WORKFLOW_NAME: ${{ github.workflow }}
         run: |
-          uv run maintenance.py --ci
+          echo "🛠️ Running pre-commit.py..."
+          uv run pre-commit.py --ci
+          echo "✨ Maintenance complete."
 
   version:
     needs: [ quality-check ]
@@ -63,7 +66,10 @@ jobs:
         with:
           enable-cache: true
       - id: version
-        run: echo "version=$(uv run python quasarr/providers/version.py)" >> $GITHUB_OUTPUT
+        run: |
+          VERSION=$(uv run python quasarr/providers/version.py)
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "🏷️ Detected version: $VERSION"
 
   build-wheel:
     needs: [ quality-check, version ]
@@ -83,7 +89,9 @@ jobs:
       - uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-      - run: uv build
+      - run: |
+          echo "📦 Building Python Wheel..."
+          uv build
       - id: attest
         uses: actions/attest-build-provenance@v2
         with:
@@ -106,38 +114,32 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
-
       - uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-          cache-suffix: "win-build" # Isolate this cache from Linux builds if you share keys
-
-      # --- CACHE ---
+          cache-suffix: "win-build"
       - name: Cache PyInstaller Analysis
         uses: actions/cache@v4
         with:
           path: |
             build
             ~\AppData\Local\pyinstaller
-          # Invalidates cache only if dependencies (uv.lock) change
           key: pyinstaller-analysis-${{ runner.os }}-${{ hashFiles('uv.lock') }}
           restore-keys: |
             pyinstaller-analysis-${{ runner.os }}-
-
       - shell: powershell
-        run: Set-MpPreference -DisableRealtimeMonitoring $true
-
-      - run: uv sync --group build
-
-      # --- BUILD COMMAND ---
+        run: |
+          echo "🛡️ Disabling Real-time Monitoring..."
+          Set-MpPreference -DisableRealtimeMonitoring $true
+      - run: |
+          echo "📥 Syncing dependencies..."
+          uv sync --group build
       - run: |
+          echo "🪟 Starting PyInstaller build..."
           uv run python -c "from PIL import Image; Image.open('Quasarr.png').save('Quasarr.ico')"
           uv run python quasarr/providers/version.py --create-version-file
-          # 1. Removed '--clean'
-          # 2. Added '--workpath "build"' (Matches the cached path above)
-          # 3. Added '--distpath "dist"' (Explicit output folder)
           uv run pyinstaller --onefile -y --version-file "file_version_info.txt" --workpath "build" --distpath "dist" --icon "Quasarr.ico" "Quasarr.py" -n "quasarr-${{ needs.version.outputs.version }}-standalone-win64"
-
+          echo "✅ EXE build finished."
       - uses: actions/upload-artifact@v4
         with:
           name: exe-amd64
@@ -165,6 +167,7 @@ jobs:
           myToken: ${{ secrets.GITHUB_TOKEN }}
       - name: Create Release Body
         run: |
+          echo "📝 Generating Release Body..."
           echo "### Docker:" > release_body.md
           echo "\`docker pull ${{ env.GHCR_ENDPOINT }}:beta\`" >> release_body.md
           echo "### Python:" >> release_body.md
@@ -200,7 +203,8 @@ jobs:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-      - uses: docker/build-push-action@v6
+      - name: Build and Push
+        uses: docker/build-push-action@v6
         with:
           context: ./docker
           platforms: linux/amd64
@@ -231,7 +235,8 @@ jobs:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-      - uses: docker/build-push-action@v6
+      - name: Build and Push
+        uses: docker/build-push-action@v6
         with:
           context: ./docker
           platforms: linux/arm64
@@ -257,6 +262,7 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
       - run: |
+          echo "🔗 Merging Docker manifests..."
           TAG_AMD64="${{ needs.version.outputs.version }}-beta-amd64"
           TAG_ARM64="${{ needs.version.outputs.version }}-beta-arm64"
           ANNOTATION="index:org.opencontainers.image.description=$DESCRIPTION"
@@ -274,15 +280,13 @@ jobs:
   notify:
     name: Notify Discord & PR
     needs: [ quality-check, version, beta-release, merge-docker-manifest ]
-    # Only run if the build wasn't skipped by the auto-fixer and the release succeeded
     if: needs.quality-check.outputs.changes_pushed != 'true' && needs.beta-release.result == 'success'
     runs-on: ubuntu-latest
     permissions:
-      pull-requests: write # Required to comment on the PR
+      pull-requests: write
       contents: read
     steps:
       - uses: actions/checkout@v6
-
       - name: Send Notifications
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -290,45 +294,48 @@ jobs:
           VERSION: ${{ needs.version.outputs.version }}
           REPO: ${{ github.repository }}
         run: |
-          echo "Fetching release details..."
-          # Get the body of the release we just created (beta tag)
+          echo "📢 Notifying stakeholders..."
           RELEASE_BODY=$(gh release view beta --json body --jq .body)
-          
-          # --- 1. DISCORD NOTIFICATION ---
           if [ -n "$DISCORD_WEBHOOK" ]; then
-            echo "Sending Discord Webhook..."
-          
-            # Construct a JSON payload safely using jq (handles escaping quotes/newlines)
-            # We create a simple embed with the version and the release body
-            jq -n \
-              --arg title "🚀 New Beta Build: $VERSION" \
-              --arg desc "$RELEASE_BODY" \
-              --arg url "https://github.com/$REPO/releases/tag/beta" \
-              '{content: null, embeds: [{title: $title, description: $desc, url: $url, color: 5814783}]}' \
-              > discord_payload.json
-          
-            curl -H "Content-Type: application/json" \
-                 -d @discord_payload.json \
-                 "$DISCORD_WEBHOOK"
-          else
-            echo "::warning::Skipping Discord notification (DISCORD_WEBHOOK secret not set)"
+            jq -n --arg title "🚀 New Beta Build: $VERSION" --arg desc "$RELEASE_BODY" --arg url "https://github.com/$REPO/releases/tag/beta" '{content: null, embeds: [{title: $title, description: $desc, url: $url, color: 5814783}]}' > discord_payload.json
+            curl -H "Content-Type: application/json" -d @discord_payload.json "$DISCORD_WEBHOOK"
           fi
-          
-          # --- 2. PR COMMENT FALLBACK ---
-          # Find the PR associated with the commit that triggered this push
-          echo "Looking for associated PR..."
           PR_NUMBER=$(gh pr list --search "${{ github.sha }}" --state merged --json number --jq '.[0].number')
-          
           if [ -n "$PR_NUMBER" ]; then
-            echo "Found PR #$PR_NUMBER. Posting comment..."
-          
             echo "## 🚀 Beta Release $VERSION is Live!" > pr_comment.md
-            echo "" >> pr_comment.md
             echo "$RELEASE_BODY" >> pr_comment.md
-            echo "" >> pr_comment.md
-            echo "[View Release on GitHub](https://github.com/$REPO/releases/tag/beta)" >> pr_comment.md
-          
             gh pr comment "$PR_NUMBER" --body-file pr_comment.md
+          fi
+
+  job-summary:
+    name: 📊 Beta Summary
+    runs-on: ubuntu-latest
+    needs: [ quality-check, version, beta-release ]
+    if: always()
+    steps:
+      - name: Generate Summary
+        run: |
+          echo "## 🧪 Beta Build Summary" >> $GITHUB_STEP_SUMMARY
+          
+          # Maintenance Outcome
+          if [[ "${{ needs.quality-check.outputs.changes_pushed }}" == "true" ]]; then
+            echo "### 🛠️ Maintenance Status: **Auto-Fixed**" >> $GITHUB_STEP_SUMMARY
+            echo "The script found formatting or dependency issues and pushed fixes directly. The current build was skipped to allow the new commit to run." >> $GITHUB_STEP_SUMMARY
           else
-            echo "No merged PR found for commit ${{ github.sha }}. Skipping PR comment."
+            echo "### ✨ Maintenance Status: **Clean**" >> $GITHUB_STEP_SUMMARY
+            echo "No formatting or maintenance issues were detected." >> $GITHUB_STEP_SUMMARY
           fi
+
+          # Decision Logic
+          echo "### 🚦 Workflow Decision" >> $GITHUB_STEP_SUMMARY
+          if [[ "${{ needs.version.result }}" == "success" ]]; then
+            echo "✅ **Proceeded:** The build moved to beta release (Dev branch detected)." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "🛑 **Stopped:** Build did not proceed to release (Not on dev or quality-check failed)." >> $GITHUB_STEP_SUMMARY
+          fi
+
+          echo "### 📦 Artifact Details" >> $GITHUB_STEP_SUMMARY
+          echo "| Metric | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "| --- | --- |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Version** | \`${{ needs.version.outputs.version || 'N/A' }}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Release Job** | ${{ needs.beta-release.result || 'Skipped' }} |" >> $GITHUB_STEP_SUMMARY

{quasarr-2.4.10 → quasarr-2.4.11}/.github/workflows/Release.yml

@@ -37,7 +37,9 @@ jobs:
       - name: Get Version
         id: version
         run: |
-          echo "version=$(uv run python quasarr/providers/version.py)" >> $GITHUB_OUTPUT
+          VERSION=$(uv run python quasarr/providers/version.py)
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "🏷️ Version: $VERSION"
 
   build-wheel:
     name: Build Wheel
@@ -58,7 +60,9 @@ jobs:
         with:
           enable-cache: true
       - name: Build wheel
-        run: uv build
+        run: |
+          echo "📦 Starting Wheel build..."
+          uv build
       - name: Generate artifact attestation
         id: attest
         uses: actions/attest-build-provenance@v2
@@ -74,26 +78,20 @@ jobs:
     runs-on: windows-latest
     needs: version
     env:
-      # We define a consistent build path to make caching reliable
       BUILD_PATH: "build"
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
-
-      # 1. Install uv with its own persistent cache
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
           cache-suffix: "win-build"
-
-      # 2. PyInstaller Caching
-      # We cache the local 'build' folder AND the global PyInstaller cache.
-      # The key invalidates if 'uv.lock' changes, forcing a re-analysis only when deps update.
       - name: Cache PyInstaller Analysis
         uses: actions/cache@v4
+        id: pyinstaller-cache
         with:
           path: |
             build
@@ -101,25 +99,20 @@ jobs:
           key: pyinstaller-analysis-${{ runner.os }}-${{ hashFiles('uv.lock') }}
           restore-keys: |
             pyinstaller-analysis-${{ runner.os }}-
-
       - name: Disable Windows Defender
         shell: powershell
         run: Set-MpPreference -DisableRealtimeMonitoring $true
-
       - name: Install dependencies
         run: |
+          echo "📥 Installing build dependencies..."
           uv sync --group build
-
       - name: Build exe
-        # CHANGES:
-        # 1. Removed '--clean' (Critical for speed)
-        # 2. Added '--workpath' to point to our cached folder
-        # 3. Added '--distpath' explicitly
         run: |
+          echo "🪟 Building Windows Binary..."
           uv run python -c "from PIL import Image; Image.open('Quasarr.png').save('Quasarr.ico')"
           uv run python quasarr/providers/version.py --create-version-file
           uv run pyinstaller --onefile -y --version-file "file_version_info.txt" --workpath "build" --distpath "dist" --icon "Quasarr.ico" "Quasarr.py" -n "quasarr-${{ needs.version.outputs.version }}-standalone-win64"
-
+          echo "✨ Windows binary created."
       - uses: actions/upload-artifact@v4
         with:
           name: exe-amd64
@@ -220,27 +213,14 @@ jobs:
           password: ${{ secrets.GITHUB_TOKEN }}
       - name: Create and Push Manifests
         run: |
+          echo "🔗 Linking Multi-arch images..."
           TAG_AMD64="${{ needs.version.outputs.version }}-amd64"
           TAG_ARM64="${{ needs.version.outputs.version }}-arm64"
           ANNOTATION="index:org.opencontainers.image.description=$DESCRIPTION"
-          
-          docker buildx imagetools create -t ${{ env.ENDPOINT }}:latest \
-            ${{ env.ENDPOINT }}:latest-amd64 \
-            ${{ env.ENDPOINT }}:latest-arm64
-
-          docker buildx imagetools create -t ${{ env.ENDPOINT }}:${{ needs.version.outputs.version }} \
-            ${{ env.ENDPOINT }}:${TAG_AMD64} \
-            ${{ env.ENDPOINT }}:${TAG_ARM64}
-
-          docker buildx imagetools create -t ${{ env.GHCR_ENDPOINT }}:latest \
-            --annotation "$ANNOTATION" \
-            ${{ env.GHCR_ENDPOINT }}:latest-amd64 \
-            ${{ env.GHCR_ENDPOINT }}:latest-arm64
-
-          docker buildx imagetools create -t ${{ env.GHCR_ENDPOINT }}:${{ needs.version.outputs.version }} \
-            --annotation "$ANNOTATION" \
-            ${{ env.GHCR_ENDPOINT }}:${TAG_AMD64} \
-            ${{ env.GHCR_ENDPOINT }}:${TAG_ARM64}
+          docker buildx imagetools create -t ${{ env.ENDPOINT }}:latest ${{ env.ENDPOINT }}:latest-amd64 ${{ env.ENDPOINT }}:latest-arm64
+          docker buildx imagetools create -t ${{ env.ENDPOINT }}:${{ needs.version.outputs.version }} ${{ env.ENDPOINT }}:${TAG_AMD64} ${{ env.ENDPOINT }}:${TAG_ARM64}
+          docker buildx imagetools create -t ${{ env.GHCR_ENDPOINT }}:latest --annotation "$ANNOTATION" ${{ env.GHCR_ENDPOINT }}:latest-amd64 ${{ env.GHCR_ENDPOINT }}:latest-arm64
+          docker buildx imagetools create -t ${{ env.GHCR_ENDPOINT }}:${{ needs.version.outputs.version }} --annotation "$ANNOTATION" ${{ env.GHCR_ENDPOINT }}:${TAG_AMD64} ${{ env.GHCR_ENDPOINT }}:${TAG_ARM64}
 
   release:
     name: Create Release
@@ -252,7 +232,6 @@ jobs:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
-
       - uses: actions/download-artifact@v4
         with:
           name: wheel
@@ -261,16 +240,15 @@ jobs:
         with:
           name: exe-amd64
           path: ./exe-amd64
-
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-
       - name: Publish to PyPI
         if: ${{ !inputs.skip_pypi }}
-        run: uv publish ./wheel/* --token ${{ secrets.PYPI_TOKEN }}
-
+        run: |
+          echo "🚀 Publishing to PyPI..."
+          uv publish ./wheel/* --token ${{ secrets.PYPI_TOKEN }}
       - name: Generate changelog
         id: changelog
         uses: metcalfc/changelog-generator@v4.6.2
@@ -281,25 +259,16 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           PR_BODY=$(gh pr list --search "${{ github.sha }}" --state merged --json body --jq '.[0].body // empty')
-          if [ -n "$PR_BODY" ]; then
-            echo -e "\n$PR_BODY" >> .github/Changelog.md
-          fi
+          if [ -n "$PR_BODY" ]; then echo -e "\n$PR_BODY" >> .github/Changelog.md; fi
       - name: Create Release Body
         run: |
           echo "### Docker:" > release_body.md
-          echo "" >> release_body.md
           echo "\`docker pull ${{ env.GHCR_ENDPOINT }}:latest\`" >> release_body.md
-          echo "" >> release_body.md
           echo "### Python:" >> release_body.md
-          echo "" >> release_body.md
           echo "\`uv tool upgrade quasarr\`" >> release_body.md
-          echo "" >> release_body.md
           echo "### Changelog:" >> release_body.md
-          echo "" >> release_body.md
           echo "${{ steps.changelog.outputs.changelog }}" >> release_body.md
-          echo "" >> release_body.md
           echo "[Attestation](https://github.com/${{ github.repository }}/attestations/${{ needs.build-wheel.outputs.attestation-id }})" >> release_body.md
-
       - name: Create Release
         uses: ncipollo/release-action@v1
         with:
@@ -315,7 +284,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
-
       - name: Send Discord Webhook
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -323,28 +291,31 @@ jobs:
           VERSION: ${{ needs.version.outputs.version }}
           REPO: ${{ github.repository }}
         run: |
-          # Use the exact tag format defined in the release job (v.X.X.X)
           TAG="v.$VERSION"
-          echo "Fetching release details for $TAG..."
-          
-          # Fetch the body from the release we just created
           RELEASE_BODY=$(gh release view "$TAG" --json body --jq .body)
-          
           if [ -n "$DISCORD_WEBHOOK" ]; then
-            echo "Sending notification..."
-          
-            # Construct JSON payload using jq
-            # Color 5763719 is 'Green'
-            jq -n \
-              --arg title "🚀 New Release: $TAG" \
-              --arg desc "$RELEASE_BODY" \
-              --arg url "https://github.com/$REPO/releases/tag/$TAG" \
-              '{content: null, embeds: [{title: $title, description: $desc, url: $url, color: 5763719}]}' \
-              > discord_payload.json
-
-            curl -H "Content-Type: application/json" \
-                 -d @discord_payload.json \
-                 "$DISCORD_WEBHOOK"
-          else
-            echo "::warning::Skipping Discord notification (DISCORD_WEBHOOK secret not set)"
+            jq -n --arg title "🚀 New Release: $TAG" --arg desc "$RELEASE_BODY" --arg url "https://github.com/$REPO/releases/tag/$TAG" '{content: null, embeds: [{title: $title, description: $desc, url: $url, color: 5763719}]}' > discord_payload.json
+            curl -H "Content-Type: application/json" -d @discord_payload.json "$DISCORD_WEBHOOK"
           fi
+
+  job-summary:
+    name: 📈 Build Report
+    runs-on: ubuntu-latest
+    needs: [ version, build-wheel, build-exe, build-docker-amd64, build-docker-arm64, release ]
+    if: always()
+    steps:
+      - name: Generate Job Summary
+        run: |
+          echo "## 📊 Release Production Report" >> $GITHUB_STEP_SUMMARY
+          echo "| Artifact | Status |" >> $GITHUB_STEP_SUMMARY
+          echo "| --- | --- |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Python Wheel** | ${{ needs.build-wheel.result == 'success' && '✅' || '❌' }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Windows Standalone** | ${{ needs.build-exe.result == 'success' && '✅' || '❌' }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Docker AMD64** | ${{ needs.build-docker-amd64.result == 'success' && '✅' || '❌' }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Docker ARM64** | ${{ needs.build-docker-arm64.result == 'success' && '✅' || '❌' }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| **GitHub Release** | ${{ needs.release.result == 'success' && '🚀 Published' || '⚠️ Failed' }} |" >> $GITHUB_STEP_SUMMARY
+          
+          echo "### ⚡ Cache Performance" >> $GITHUB_STEP_SUMMARY
+          # This assumes you use the default GITHUB_TOKEN permissions to read cache API if you wanted complex stats, 
+          # but for simplicity we report on the PyInstaller cache key match.
+          echo "* **PyInstaller Cache:** ${{ needs.build-exe.outputs.cache-hit == 'true' && 'Hit (Fast 🚀)' || 'Miss (Full Build 🐢)' }}" >> $GITHUB_STEP_SUMMARY

{quasarr-2.4.10 → quasarr-2.4.11}/.gitignore

@@ -10,6 +10,10 @@
 # PyCharm
 .idea
 
+# MacOS
+.DS_Store
+**/.DS_Store
+
 # Quasarr
 *.conf
 *.db

quasarr-2.4.11/.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: local
+    hooks:
+      - id: pre-commit
+        name: Pre-Commit Check
+        entry: uv run python pre-commit.py
+        language: system
+        pass_filenames: false
+        always_run: true

{quasarr-2.4.10 → quasarr-2.4.11}/CONTRIBUTING.md

@@ -10,6 +10,12 @@ Ensure you have the development tools (like `ruff`) installed and your environme
 uv sync --group dev
 ```
 
+Install the pre-commit hook that ensures linting, formatting and version upgrades through pre-commit.py
+
+```bash
+uv run pre-commit install
+```
+
 **2. Run Quasarr with the `--internal_address` parameter**
 
 ```bash
@@ -33,10 +39,10 @@ The `CONFIG_VOLUMES` environment variable is **mandatory**.
 ### Code Quality & Maintenance
 
 The CI pipeline enforces strict code styling and import optimization. Please run this commands before pushing your
-changes:
+changes. Alternatively, you should just set up the pre-commit hook as described above.
 
-**Format code AND upgrade dependencies:**
+**Format code AND upgrade dependencie manually:**
 
 ```bash
-uv run maintenance.py --upgrade
+uv run pre-commit.py --upgrade
 ```

{quasarr-2.4.10 → quasarr-2.4.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quasarr
-Version: 2.4.10
+Version: 2.4.11
 Summary: Quasarr connects JDownloader with Radarr, Sonarr and LazyLibrarian. It also decrypts links protected by CAPTCHAs.
 Author-email: rix1337 <rix1337@users.noreply.github.com>
 License-File: LICENSE