pandrator 0.6.1__tar.gz

pandrator-0.6.1/.github/workflows/manager-ci.yml

@@ -0,0 +1,143 @@
+name: Pandrator Manager
+
+on:
+  push:
+    paths:
+      - ".github/workflows/manager-ci.yml"
+      - "pandrator_manager/**"
+      - "pandrator_manager_bootstrap.py"
+      - "pandrator_manager_bootstrap.spec"
+      - "scripts/build_manager_*.py"
+      - "scripts/generate_manager_release_key.py"
+      - "scripts/qualify_manager_lifecycle.py"
+      - "scripts/sign_manager_release.py"
+      - "tests/test_manager_*.py"
+  pull_request:
+    paths:
+      - ".github/workflows/manager-ci.yml"
+      - "pandrator_manager/**"
+      - "pandrator_manager_bootstrap.py"
+      - "pandrator_manager_bootstrap.spec"
+      - "scripts/build_manager_*.py"
+      - "scripts/generate_manager_release_key.py"
+      - "scripts/qualify_manager_lifecycle.py"
+      - "scripts/sign_manager_release.py"
+      - "tests/test_manager_*.py"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test (${{ matrix.os }}, Python ${{ matrix.python }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-22.04]
+        python: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+          cache-dependency-path: pandrator_manager/pyproject.toml
+
+      - name: Install manager test environment
+        run: >-
+          python -m pip install --disable-pip-version-check
+          -e "./pandrator_manager[dev]"
+          "alembic>=1.14,<2"
+          "argon2-cffi>=23.1,<26"
+          "authlib>=1.7,<2"
+          "pydub>=0.25,<1"
+          "sqlalchemy>=2.0,<3"
+
+      - name: Check manager source
+        shell: bash
+        run: |
+          ruff check --config pandrator_manager/pyproject.toml \
+            pandrator_manager \
+            scripts/build_manager_appimage.py \
+            scripts/build_manager_bootstrap.py \
+            scripts/build_manager_release_bundle.py \
+            scripts/generate_manager_release_key.py \
+            scripts/qualify_manager_lifecycle.py \
+            scripts/sign_manager_release.py
+          python -m compileall -q pandrator_manager pandrator_manager_bootstrap.py
+
+      - name: Run manager tests
+        shell: bash
+        run: python -m pytest -q tests/test_manager_*.py
+
+  package:
+    name: Package and lifecycle (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-22.04]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pandrator_manager/pyproject.toml
+
+      - name: Install isolated build environment
+        run: python -m pip install --disable-pip-version-check -e "./pandrator_manager[build,dev]"
+
+      - name: Build PyPI artifacts
+        run: python -m build pandrator_manager --outdir manager-dist
+
+      - name: Smoke-test the built wheel without Qt
+        shell: bash
+        run: |
+          python -m venv wheel-smoke
+          if [[ "$RUNNER_OS" == "Windows" ]]; then
+            PYTHON="wheel-smoke/Scripts/python.exe"
+            MANAGER="wheel-smoke/Scripts/pandrator-manager.exe"
+          else
+            PYTHON="wheel-smoke/bin/python"
+            MANAGER="wheel-smoke/bin/pandrator-manager"
+          fi
+          "$PYTHON" -m pip install --disable-pip-version-check \
+            manager-dist/pandrator_manager-*.whl
+          "$PYTHON" -c \
+            "import importlib.util, pandrator_manager; assert importlib.util.find_spec('PyQt5') is None; assert importlib.util.find_spec('PySide6') is None"
+          "$MANAGER" --help >/dev/null
+
+      - name: Build and self-check native bootstrap
+        run: python scripts/build_manager_bootstrap.py --wheel-dir manager-dist
+
+      - name: Build native manager release bundle
+        run: python scripts/build_manager_release_bundle.py
+
+      - name: Build Linux manager AppImage
+        if: runner.os == 'Linux'
+        run: >-
+          python scripts/build_manager_appimage.py
+          --bootstrap dist/PandratorManagerBootstrap
+
+      - name: Exercise bootstrap, signed handoff, and uninstall
+        run: python scripts/qualify_manager_lifecycle.py
+
+      - name: Upload qualification artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: pandrator-manager-${{ matrix.os }}
+          if-no-files-found: error
+          path: |
+            manager-dist/*
+            dist/PandratorManagerBootstrap*
+            dist/PandratorManager-*.AppImage*
+            dist/pandrator-manager-*.zip

pandrator-0.6.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,134 @@
+name: Publish Python packages
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-pypi
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build and verify distributions
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-22.04
+    timeout-minutes: 15
+
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+
+      - name: Install packaging tools
+        run: python -m pip install --disable-pip-version-check "build>=1.2,<2" "twine>=6,<7"
+
+      - name: Build Pandrator
+        run: python -m build --sdist --wheel --outdir package-dist/pandrator .
+
+      - name: Build Pandrator Manager
+        run: >-
+          python -m build --sdist --wheel
+          --outdir package-dist/pandrator-manager
+          pandrator_manager
+
+      - name: Build Pandrator MCP
+        run: >-
+          python -m build --sdist --wheel
+          --outdir package-dist/pandrator-mcp
+          pandrator_mcp
+
+      - name: Check package metadata and descriptions
+        run: python -m twine check package-dist/*/*
+
+      - name: Audit release archive contents
+        run: >-
+          python scripts/audit_python_distributions.py
+          --project .
+          --project pandrator_manager
+          --project pandrator_mcp
+          package-dist/*/*
+
+      - name: Upload verified distributions
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: pypi-distributions
+          if-no-files-found: error
+          path: package-dist/
+          retention-days: 7
+
+  publish-pandrator:
+    name: Publish Pandrator to PyPI
+    needs: build
+    runs-on: ubuntu-22.04
+    timeout-minutes: 10
+    environment:
+      name: pypi
+      url: https://pypi.org/project/pandrator/
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: pypi-distributions
+          path: dist
+
+      - name: Publish Pandrator
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
+        with:
+          packages-dir: dist/pandrator
+
+  publish-manager:
+    name: Publish Pandrator Manager to PyPI
+    needs: build
+    runs-on: ubuntu-22.04
+    timeout-minutes: 10
+    environment:
+      name: pypi-manager
+      url: https://pypi.org/project/pandrator-manager/
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: pypi-distributions
+          path: dist
+
+      - name: Publish Pandrator Manager
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
+        with:
+          packages-dir: dist/pandrator-manager
+
+  publish-mcp:
+    name: Publish Pandrator MCP to PyPI
+    needs: build
+    runs-on: ubuntu-22.04
+    timeout-minutes: 10
+    environment:
+      name: pypi-mcp
+      url: https://pypi.org/project/pandrator-mcp/
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: pypi-distributions
+          path: dist
+
+      - name: Publish Pandrator MCP
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
+        with:
+          packages-dir: dist/pandrator-mcp

pandrator-0.6.1/.github/workflows/runtime-ci.yml

@@ -0,0 +1,48 @@
+name: Pandrator locked runtime
+
+on:
+  push:
+    paths:
+      - ".github/workflows/runtime-ci.yml"
+      - "pandrator/**"
+      - "pixi.toml"
+      - "pixi.lock"
+      - "pyproject.toml"
+      - "tests/test_dependency_manifests.py"
+  pull_request:
+    paths:
+      - ".github/workflows/runtime-ci.yml"
+      - "pandrator/**"
+      - "pixi.toml"
+      - "pixi.lock"
+      - "pyproject.toml"
+      - "tests/test_dependency_manifests.py"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  locked-runtime:
+    name: Locked runtime (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-22.04]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: prefix-dev/setup-pixi@v0.10.0
+        with:
+          pixi-version: v0.72.0
+          locked: true
+          cache: true
+
+      - name: Check the canonical dependency projection
+        run: pixi run --locked python -m unittest tests.test_dependency_manifests
+
+      - name: Import the Manager-launched application runtime
+        run: pixi run --locked python -m pandrator --help

pandrator-0.6.1/.github/workflows/web-preview.yml

@@ -0,0 +1,83 @@
+name: Web migration preview
+
+on:
+  push:
+    branches: [codex/webui-migration, codex/webui-**]
+  pull_request:
+    branches: [codex/webui-migration, main]
+
+permissions:
+  contents: read
+
+jobs:
+  preview:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: pip
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+      - name: Install Linux Qt runtime libraries
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes \
+            ffmpeg \
+            libdbus-1-3 \
+            libegl1 \
+            libfontconfig1 \
+            libgl1 \
+            libx11-xcb1 \
+            libxcb-cursor0 \
+            libxcb-icccm4 \
+            libxcb-keysyms1 \
+            libxcb-randr0 \
+            libxcb-render-util0 \
+            libxcb-shape0 \
+            libxcb-xinerama0 \
+            libxcb-xkb1 \
+            libxkbcommon-x11-0
+      - name: Install Windows FFmpeg
+        if: runner.os == 'Windows'
+        run: choco install ffmpeg --yes --no-progress
+      - name: Install Python preview dependencies
+        run: python -m pip install -e ".[dev]" -e "./pandrator_installer[gui]" build
+      - name: Install frontend dependencies
+        run: npm ci --prefix web
+      - name: Check generated API contract
+        shell: bash
+        run: |
+          python scripts/generate_web_contract.py
+          npm --prefix web run generate-api
+          git diff --exit-code -- openapi.json web/src/lib/api.generated.ts
+      - name: Check and build frontend
+        run: |
+          npm --prefix web run check
+          npm --prefix web run build
+      - name: Run Python tests
+        run: python -m pytest -q tests
+      - name: Install Playwright browsers
+        run: npx --prefix web playwright install chromium firefox
+      - name: Run Chromium and Firefox workflows
+        run: npm --prefix web run test:e2e
+      - name: Build Pandrator and installer wheels
+        run: |
+          python -m build
+          python -m build pandrator_installer
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pandrator-web-preview-${{ matrix.os }}
+          path: |
+            dist/*.whl
+            pandrator_installer/dist/*.whl
+          if-no-files-found: error

pandrator-0.6.1/.gitignore

@@ -0,0 +1,106 @@
+# Python bytecode and caches
+__pycache__/
+*.py[cod]
+*.pyd
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+conda/
+
+# Build and packaging artifacts
+build/
+dist/
+/manager-dist*/
+/*.whl
+.release_blocks/
+.release_staging/
+.release_sources/
+release_packages/
+package_release/
+.appimage-tools/
+*.egg-info/
+.eggs/
+pip-wheel-metadata/
+*.spec
+!pandrator_installer_launcher.spec
+!pandrator_installer_launcher_linux.spec
+!pandrator_manager_bootstrap.spec
+
+# Test and tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.pyre/
+.hypothesis/
+.tox/
+.nox/
+graphify-out/
+.pixi/
+.pixi-cache/
+.pixi-home/
+.coverage
+.coverage.*
+htmlcov/
+web/node_modules/
+web/.svelte-kit/
+
+# Runtime data
+Outputs/
+rvc_models/
+logs/*
+!logs/.gitkeep
+*.log
+*.tmp
+pandrator_settings.json
+pandrator_state.sqlite3
+pandrator_state.sqlite3.*
+pandrator_state.sqlite3-*
+pandrator.sqlite3
+pandrator.sqlite3.*
+pandrator.sqlite3-*
+migration-web-v1.json
+
+# User-provided voices (keep repository samples)
+tts_voices/**/*.wav
+tts_voices/voice_library.json
+!tts_voices/sample_male_new.wav
+!tts_voices/VoiceCraft/sample_male_16k.wav
+
+# Local environment files
+.env
+.env.*
+!.env.example
+
+# Local planning, architecture, and qualification notes
+*[Pp][Ll][Aa][Nn]*.md
+/BACKEND_ARCHITECTURE.md
+/FRONTEND_ARCHITECTURE.md
+/INSTALLER_MANAGER_ARCHITECTURE.md
+/AGENTIC_TEXT_AND_SPEECH.md
+/FUTURE_TTS_OPTIMIZATION_NOTES.md
+
+# Local development and research scratch files
+/inspect_db.py
+/test_hash_logic.py
+/test_hashes.py
+/scripts/tts_speech_plan_scratch/
+
+# IDE and OS files
+.vscode/
+.idea/
+.antigravity/
+*.code-workspace
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Linux compatibility documentation (untracked locally)
+LINUX_COMPATIBILITY.md
+
+# Local documentation and qualification records
+docs/
+web/playwright-report/
+web/test-results/

pandrator-0.6.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Lukasz Liniewicz and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.