iopenpod 1.0.47__tar.gz

iopenpod-1.0.47/.flake8

@@ -0,0 +1,3 @@
+[flake8]
+# Preserve existing ignores and add W503 (allow line break before operator)
+ignore = E501, F541, W503

iopenpod-1.0.47/.gitattributes

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

iopenpod-1.0.47/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug Report
+about: Report a bug with iOpenPod
+title: "[Bug] "
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**iPod model**
+e.g., iPod Classic 6th Gen (160GB), iPod Nano 3G
+
+**To reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '...'
+3. See error
+
+**Expected behavior**
+What you expected to happen.
+
+**Screenshots / logs**
+If applicable, add screenshots or paste the logs from `~/iOpenPod/`.
+
+**Environment**
+- OS: [e.g., Windows 11, Ubuntu 24.04, macOS 15]
+- Python version: [e.g., 3.13.1]
+- iOpenPod version/commit: [e.g., v1.0.0 or commit hash]

iopenpod-1.0.47/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature Request
+about: Suggest an idea for iOpenPod
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem?**
+A clear description of the problem. e.g., "I'm frustrated when..."
+
+**Describe the solution you'd like**
+What you'd like to see happen.
+
+**Describe alternatives you've considered**
+Any alternative solutions or workarounds.
+
+**Additional context**
+Any other context, screenshots, or references.

iopenpod-1.0.47/.github/workflows/flatpak.yml

@@ -0,0 +1,114 @@
+name: Flatpak
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag_name:
+        description: "Release tag (for example: v1.2.3)"
+        required: true
+        type: string
+
+permissions:
+  contents: write   # needed to upload assets to the GitHub Release
+
+jobs:
+  flatpak:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.inputs.tag_name }}
+
+      - name: Update metainfo release version/date
+        run: |
+          python -c "
+          from datetime import datetime, timezone
+          import xml.etree.ElementTree as ET
+
+          path = 'flatpak/io.github.therealsavi.iOpenPod.metainfo.xml'
+          version = '${{ github.event.inputs.tag_name }}'.lstrip('v.')
+          date = datetime.now(timezone.utc).strftime('%Y-%m-%d')
+
+          tree = ET.parse(path)
+          root = tree.getroot()
+          releases = root.find('releases')
+          if releases is None:
+              releases = ET.SubElement(root, 'releases')
+          release = releases.find('release')
+          if release is None:
+              release = ET.SubElement(releases, 'release')
+
+          release.set('version', version)
+          release.set('date', date)
+          tree.write(path, encoding='UTF-8', xml_declaration=True)
+
+          print(f'Updated {path} -> version={version}, date={date}')
+          "
+
+      # ── Python + uv ───────────────────────────────────────────────────
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      # Qt runtime libraries required for the PyInstaller build step.
+      - name: Install Linux system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libegl1 libxkbcommon0 libdbus-1-3
+
+      - name: Install project dependencies
+        run: uv sync
+
+      # ── Build the PyInstaller one-folder bundle ───────────────────────
+      - name: Build with PyInstaller
+        run: uv run pyinstaller iOpenPod.spec --noconfirm
+
+      # ── Package as a Flatpak bundle ───────────────────────────────────
+      - name: Install Flatpak tooling
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y flatpak flatpak-builder xvfb
+          sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+          sudo flatpak remote-modify --enable flathub
+          flatpak --system remotes --show-details
+
+      - name: Install Flatpak SDK/runtime
+        run: |
+          sudo flatpak install -y --system flathub \
+            org.freedesktop.Sdk//25.08 \
+            org.freedesktop.Sdk.Locale//25.08 \
+            org.freedesktop.Platform//25.08 \
+            org.freedesktop.Platform.GL.default//25.08 \
+            org.freedesktop.Platform.openh264//2.5.1
+
+      - name: Build Flatpak bundle
+        uses: flatpak/flatpak-github-actions/flatpak-builder@v6
+        with:
+          bundle: iOpenPod-Linux.flatpak
+          manifest-path: flatpak/io.github.therealsavi.iOpenPod.yml
+          cache-key: flatpak-builder-${{ github.sha }}
+
+      # ── Checksum ──────────────────────────────────────────────────────
+      - name: Generate SHA-256 checksum
+        run: |
+          python -c "
+          import hashlib, pathlib
+          p = pathlib.Path('iOpenPod-Linux.flatpak')
+          h = hashlib.sha256(p.read_bytes()).hexdigest()
+          out = f'{h}  {p.name}\n'
+          pathlib.Path(p.name + '.sha256').write_text(out)
+          print(out.strip())
+          "
+
+      # ── Attach to GitHub Release ──────────────────────────────────────
+      - name: Upload Flatpak bundle to release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.inputs.tag_name }}
+          files: |
+            iOpenPod-Linux.flatpak
+            iOpenPod-Linux.flatpak.sha256

iopenpod-1.0.47/.github/workflows/health.yml

@@ -0,0 +1,38 @@
+name: Health
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  health:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install project and dev dependencies
+        run: uv sync --all-groups
+
+      - name: Ruff
+        run: uv run ruff check app_core scripts tests main.py SyncEngine/contracts.py SyncEngine/quick_writes.py
+
+      - name: Mypy
+        run: uv run mypy
+
+      - name: Pytest
+        run: uv run pytest
+
+      - name: Architecture checks
+        run: uv run python scripts/check_architecture.py
+
+      - name: Packaging smoke test
+        run: uv build

iopenpod-1.0.47/.github/workflows/release.yml

@@ -0,0 +1,286 @@
+# Build multi-platform binaries and publish a GitHub Release on every tag.
+#
+# Trigger: push a tag like v1.0.0 (or v1.2.3-beta.1, etc.)
+#
+#   git tag v1.0.0
+#   git push origin v1.0.0
+
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  actions: write           # needed to dispatch the Flatpak workflow
+  contents: write          # needed to create GitHub Releases
+
+jobs:
+  # ── Build matrix ────────────────────────────────────────────────────────
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            artifact: iOpenPod-Windows
+            archive_name: iOpenPod-Windows.zip
+
+          - os: macos-14          # Apple Silicon (arm64); Intel Macs use Rosetta 2
+            artifact: iOpenPod-macOS
+            archive_name: iOpenPod-macOS.zip
+
+          - os: ubuntu-22.04
+            artifact: iOpenPod-Linux
+            archive_name: iOpenPod-Linux.tar.gz
+            appimage_name: iOpenPod-Linux-x86_64.AppImage
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # ── Python + uv ─────────────────────────────────────────────────
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      # Linux: install Qt runtime deps (no display needed for build)
+      - name: Install Linux system dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libegl1 libxkbcommon0 libdbus-1-3
+
+      - name: Install project dependencies
+        run: uv sync
+
+      # ── PyInstaller build ───────────────────────────────────────────
+      - name: Build with PyInstaller
+        run: uv run pyinstaller iOpenPod.spec --noconfirm
+
+      # ── Package archive ─────────────────────────────────────────────
+      # macOS: ad-hoc sign all binaries so Gatekeeper doesn't kill the app
+      - name: Ad-hoc codesign (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          # Re-sign every Mach-O binary inside the bundle (inside-out).
+          # --options runtime is intentionally omitted: Hardened Runtime
+          # triggers strict PAC checks in CoreFoundation on macOS 26+
+          # that crash PyInstaller-frozen Qt apps during bundle init.
+          # Hardened Runtime is only needed for notarization (we don't notarize).
+          find dist/iOpenPod.app/Contents/Frameworks \
+               dist/iOpenPod.app/Contents/Resources \
+               -type f -perm +111 -print0 \
+            | xargs -0 file \
+            | grep -i 'mach-o' \
+            | cut -d: -f1 \
+            | while read f; do
+                codesign --force --sign - "$f"
+              done
+          codesign --force --sign - dist/iOpenPod.app/Contents/MacOS/iOpenPod
+          codesign --force --sign - dist/iOpenPod.app
+          # Verify
+          codesign --verify --deep --strict dist/iOpenPod.app
+          echo "Code signing verified OK"
+
+      - name: Create archive (Windows)
+        if: runner.os == 'Windows'
+        run: Compress-Archive -Path dist\iOpenPod\* -DestinationPath iOpenPod-Windows.zip
+        shell: pwsh
+
+      - name: Create archive (macOS)
+        if: runner.os == 'macOS'
+        run: cd dist && ditto -c -k --keepParent --sequesterRsrc iOpenPod.app ../${{ matrix.archive_name }}
+
+      - name: Create archive (Linux)
+        if: runner.os == 'Linux'
+        run: cd dist && tar czf ../${{ matrix.archive_name }} iOpenPod/
+
+      - name: Build AppImage (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          curl -L --fail -o appimagetool-x86_64.AppImage \
+            https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
+          chmod +x appimagetool-x86_64.AppImage
+
+          rm -rf AppDir
+          mkdir -p AppDir/usr/bin AppDir/usr/share/applications
+
+          # Preserve PyInstaller one-folder layout so the binary can load _internal/*.
+          cp -a dist/iOpenPod/. AppDir/usr/bin/
+
+          cat > AppDir/iOpenPod.desktop <<'EOF'
+          [Desktop Entry]
+          Type=Application
+          Name=iOpenPod
+          Exec=iOpenPod
+          Icon=iOpenPod
+          Categories=AudioVideo;Utility;
+          Terminal=false
+          EOF
+          cp AppDir/iOpenPod.desktop AppDir/usr/share/applications/iOpenPod.desktop
+
+          cat > AppDir/AppRun <<'EOF'
+          #!/bin/sh
+          HERE="$(dirname "$(readlink -f "$0")")"
+          APPBIN="$HERE/usr/bin"
+
+          export PATH="$APPBIN:$PATH"
+          export LD_LIBRARY_PATH="$APPBIN/_internal:$APPBIN/_internal/Qt/lib:$APPBIN/_internal/lib:${LD_LIBRARY_PATH:-}"
+          export QT_PLUGIN_PATH="$APPBIN/_internal/plugins:${QT_PLUGIN_PATH:-}"
+          export QML2_IMPORT_PATH="$APPBIN/_internal/qml:${QML2_IMPORT_PATH:-}"
+
+          exec "$APPBIN/iOpenPod" "$@"
+          EOF
+          chmod +x AppDir/AppRun
+
+          cp assets/icons/icon-256.png AppDir/iOpenPod.png
+
+          ARCH=x86_64 ./appimagetool-x86_64.AppImage --appimage-extract-and-run \
+            AppDir "${{ matrix.appimage_name }}"
+
+      # ── Checksums ───────────────────────────────────────────────────
+      - name: Generate SHA-256 checksum
+        run: |
+          python -c "
+          import hashlib, pathlib, sys
+          p = pathlib.Path('${{ matrix.archive_name }}')
+          h = hashlib.sha256(p.read_bytes()).hexdigest()
+          out = f'{h}  {p.name}\n'
+          pathlib.Path(p.name + '.sha256').write_text(out)
+          print(out.strip())
+          "
+
+      - name: Generate SHA-256 checksum (Linux AppImage)
+        if: runner.os == 'Linux'
+        run: |
+          python -c "
+          import hashlib, pathlib
+          p = pathlib.Path('${{ matrix.appimage_name }}')
+          h = hashlib.sha256(p.read_bytes()).hexdigest()
+          out = f'{h}  {p.name}\n'
+          pathlib.Path(p.name + '.sha256').write_text(out)
+          print(out.strip())
+          "
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: |
+            ${{ matrix.archive_name }}
+            ${{ matrix.archive_name }}.sha256
+
+      - name: Upload AppImage artifact (Linux)
+        if: runner.os == 'Linux'
+        uses: actions/upload-artifact@v4
+        with:
+          name: iOpenPod-Linux-AppImage
+          path: |
+            ${{ matrix.appimage_name }}
+            ${{ matrix.appimage_name }}.sha256
+
+  # ── Build Python distributions for PyPI ─────────────────────────────────
+  python-dist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Verify tag matches package version
+        run: |
+          python - <<'PY'
+          import os
+          import pathlib
+          import tomllib
+
+          pyproject = tomllib.loads(pathlib.Path("pyproject.toml").read_text(encoding="utf-8"))
+          version = pyproject["project"]["version"]
+          tag_name = os.environ["GITHUB_REF_NAME"]
+          expected_tag = f"v{version}"
+          if tag_name != expected_tag:
+              raise SystemExit(
+                  f"Refusing to publish: tag {tag_name!r} does not match pyproject version {version!r}"
+              )
+          print(f"Publishing Python package version {version} from tag {tag_name}")
+          PY
+
+      - name: Build Python distributions
+        run: uv build
+
+      - name: Upload Python distribution artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: iopenpod-python-dist
+          if-no-files-found: error
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+
+  # ── Publish GitHub Release ──────────────────────────────────────────────
+  release:
+    needs:
+      - build
+      - python-dist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: iOpenPod-*
+          merge-multiple: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            *.zip
+            *.tar.gz
+            *.AppImage
+            *.sha256
+
+  # ── Publish to PyPI via Trusted Publishing ──────────────────────────────
+  pypi-publish:
+    needs: release
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: iopenpod-python-dist
+          path: dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  trigger-flatpak:
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Flatpak workflow
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.actions.createWorkflowDispatch({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              workflow_id: 'flatpak.yml',
+              ref: context.ref.replace('refs/tags/', ''),
+              inputs: {
+                tag_name: context.ref.replace('refs/tags/', '')
+              }
+            })

iopenpod-1.0.47/.gitignore

@@ -0,0 +1,179 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+.tmp/
+pytest-tmp/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+/iTunes
+/testData
+/ipodTestData
+/compendium
+
+# macOS
+.DS_Store
+
+# VS Code
+.vscode/
+
+# GitHub Copilot
+.github/copilot-instructions.md
+
+# Claude Code
+.claude/
+CLAUDE.md

iopenpod-1.0.47/ArtworkDB_Parser/__init__.py

@@ -0,0 +1,3 @@
+from .parser import parse_artworkdb
+
+__all__ = ["parse_artworkdb"]