ofscraper-community 3.16.2__tar.gz

ofscraper_community-3.16.2/.dockerignore

@@ -0,0 +1,28 @@
+# Ignore Python's virtual environment directory (your 'info' folder)
+info/
+.venv/
+venv/
+env/
+
+# Ignore Python cache and artifacts
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+dist/
+build/
+wiki/
+*.egg-info/
+
+# Ignore editor and OS-specific files
+.vscode/
+.idea/
+*.DS_Store
+
+# Ignore test files if they aren't needed in the final image
+test/
+
+# Ignore local secrets or temp files
+.env
+.tempmedia/
+*.log

ofscraper_community-3.16.2/.gitattributes

@@ -0,0 +1 @@
+.git_archival.json  export-subst

ofscraper_community-3.16.2/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,66 @@
+---
+name: Bug report
+about: Report an issue with running the script
+title: "# Clear Description of issue"
+labels: ""
+assignees: ""
+---
+
+<!---
+Issues pertaining to the script not working
+Must have a log file and config, otherwhise they will be closed
+
+You may submit tickets privately on discord
+In other cases a log and config may be helpful
+-->
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+Hint: enter the command and args would be a good idea
+
+Example
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+## Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+## Screenshots/Logs
+
+Logs are required for any reports of any issue, unless the issue is related to setup of script
+Logs must be at least debug level
+
+Hint: Please make sure that the log formatting is readable, use a paste site
+like
+[Private Bin](https://privatebin.io/)
+
+## Config
+
+Please provide details about your correct config
+This is required for all reports
+
+Feel free to anonymize information
+
+- for example home directory
+- keydb api key
+
+## System Info
+
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
+- binary or python
+- python version if installed via pip or pypi
+
+## Additional context
+
+Add any other context about the problem here.

ofscraper_community-3.16.2/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ""
+labels: ""
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

ofscraper_community-3.16.2/.github/actions/retry-artifact-operation/action.yml

@@ -0,0 +1,186 @@
+# .github/actions/retry-artifact-operation/action.yml
+name: 'Retryable Artifact Operation (Fixed Attempts)'
+description: 'Uploads or downloads artifacts with a fixed number of retries.'
+
+inputs:
+  operation_type:
+    description: 'Specify "upload", "download-specific", or "download-all".' # Updated description for clarity
+    required: true
+    type: string
+  name:
+    description: 'Artifact name for upload or specific download. Omit/leave empty for "download-all".'
+    required: false # <--- CRITICAL: Set to false to allow omitting for "download-all"
+    type: string
+  path:
+    description: 'Paths for operation.'
+    required: true
+    type: string
+  if_no_files_found:
+    description: 'For upload: warn, error, ignore.'
+    required: false
+    default: 'warn'
+    type: string
+  overwrite:
+    description: 'For upload: true/false.'
+    required: false
+    default: 'true'
+    type: boolean
+
+runs:
+  using: "composite"
+  steps:
+    # --- ATTEMPT 1 ---
+    # Path 1: Upload Logic for Attempt 1
+    - name: Attempt 1 - Upload Artifact
+      id: upload_attempt_1
+      if: ${{ inputs.operation_type == 'upload' }}
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}
+        path: ${{ inputs.path }}
+        if-no-files-found: ${{ inputs.if_no_files_found }}
+        overwrite: ${{ inputs.overwrite }}
+      continue-on-error: true
+
+    # Path 2: Download Specific Artifact Logic for Attempt 1
+    - name: Attempt 1 - Download Specific Artifact
+      id: download_specific_attempt_1 # Unique ID for specific download
+      if: ${{ inputs.operation_type == 'download' && inputs.name != '' }} # Run if download AND name is provided
+      uses: actions/download-artifact@v8
+      with:
+        name: ${{ inputs.name }}
+        path: ${{ inputs.path }}
+      continue-on-error: true
+
+    # Path 3: Download All Artifacts Logic for Attempt 1
+    - name: Attempt 1 - Download All Artifacts
+      id: download_all_attempt_1 # Unique ID for download all
+      if: ${{ inputs.operation_type == 'download' && inputs.name == '' }} # Run if download AND name is empty (implying download all)
+      uses: actions/download-artifact@v8
+      with:
+        # NO 'name' input here to explicitly trigger download all behavior
+        path: ${{ inputs.path }}
+      continue-on-error: true
+
+    # --- ATTEMPT 2 ---
+    # Delay for Attempt 2 (checking outcomes of previous attempt for all 3 paths)
+    - name: Delay for Attempt 2
+      if: | # Multi-line if condition for readability
+        ${{ (inputs.operation_type == 'upload' && steps.upload_attempt_1.outcome == 'failure') ||
+           (inputs.operation_type == 'download' && inputs.name != '' && steps.download_specific_attempt_1.outcome == 'failure') ||
+           (inputs.operation_type == 'download' && inputs.name == '' && steps.download_all_attempt_1.outcome == 'failure') }}
+      run: |
+        echo "Previous attempt failed. Retrying in 10 seconds..." >&2
+        sleep 10
+      shell: bash
+
+    # Path 1: Upload Logic for Attempt 2
+    - name: Attempt 2 - Upload Artifact
+      id: upload_attempt_2
+      if: ${{ inputs.operation_type == 'upload' && steps.upload_attempt_1.outcome == 'failure' }}
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}
+        path: ${{ inputs.path }}
+        if-no-files-found: ${{ inputs.if_no_files_found }}
+        overwrite: ${{ inputs.overwrite }}
+      continue-on-error: true
+
+    # Path 2: Download Specific Artifact Logic for Attempt 2
+    - name: Attempt 2 - Download Specific Artifact
+      id: download_specific_attempt_2
+      if: ${{ inputs.operation_type == 'download' && inputs.name != '' && steps.download_specific_attempt_1.outcome == 'failure' }}
+      uses: actions/download-artifact@v8
+      with:
+        name: ${{ inputs.name }}
+        path: ${{ inputs.path }}
+      continue-on-error: true
+
+    # Path 3: Download All Artifacts Logic for Attempt 2
+    - name: Attempt 2 - Download All Artifacts
+      id: download_all_attempt_2
+      if: ${{ inputs.operation_type == 'download' && inputs.name == '' && steps.download_all_attempt_1.outcome == 'failure' }}
+      uses: actions/download-artifact@v8
+      with:
+        path: ${{ inputs.path }}
+      continue-on-error: true
+
+    # --- ATTEMPT 3 ---
+    # Delay for Attempt 3
+    - name: Delay for Attempt 3
+      if: |
+        ${{ (inputs.operation_type == 'upload' && steps.upload_attempt_2.outcome == 'failure') ||
+           (inputs.operation_type == 'download' && inputs.name != '' && steps.download_specific_attempt_2.outcome == 'failure') ||
+           (inputs.operation_type == 'download' && inputs.name == '' && steps.download_all_attempt_2.outcome == 'failure') }}
+      run: |
+        echo "Previous attempt failed. Retrying in 10 seconds..." >&2
+        sleep 10
+      shell: bash
+
+    # Path 1: Upload Logic for Attempt 3
+    - name: Attempt 3 - Upload Artifact
+      id: upload_attempt_3
+      if: ${{ inputs.operation_type == 'upload' && steps.upload_attempt_2.outcome == 'failure' }}
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}
+        path: ${{ inputs.path }}
+        if-no-files-found: ${{ inputs.if_no_files_found }}
+        overwrite: ${{ inputs.overwrite }}
+      continue-on-error: true
+
+    # Path 2: Download Specific Artifact Logic for Attempt 3
+    - name: Attempt 3 - Download Specific Artifact
+      id: download_specific_attempt_3
+      if: ${{ inputs.operation_type == 'download' && inputs.name != '' && steps.download_specific_attempt_2.outcome == 'failure' }}
+      uses: actions/download-artifact@v8
+      with:
+        name: ${{ inputs.name }}
+        path: ${{ inputs.path }}
+      continue-on-error: true
+
+    # Path 3: Download All Artifacts Logic for Attempt 3
+    - name: Attempt 3 - Download All Artifacts
+      id: download_all_attempt_3
+      if: ${{ inputs.operation_type == 'download' && inputs.name == '' && steps.download_all_attempt_2.outcome == 'failure' }}
+      uses: actions/download-artifact@v8
+      with:
+        path: ${{ inputs.path }}
+      continue-on-error: true
+
+    # --- FINAL STATUS CHECK ---
+    # This step will fail the composite action if all attempts for the chosen operation failed
+    - name: Final Check on Operation Status
+      run: |
+        if [ "${{ inputs.operation_type }}" == "upload" ]; then
+          if [ "${{ steps.upload_attempt_1.outcome }}" == "failure" ] && \
+             [ "${{ steps.upload_attempt_2.outcome }}" == "failure" ] && \
+             [ "${{ steps.upload_attempt_3.outcome }}" == "failure" ]; then
+            echo "::error::Artifact upload failed after all 3 attempts." >&2
+            exit 1
+          fi
+        elif [ "${{ inputs.operation_type }}" == "download" ]; then
+          DOWNLOAD_FAILED="false"
+          if [ "${{ inputs.name }}" != "" ]; then # Check specific download path if name was provided
+            if [ "${{ steps.download_specific_attempt_1.outcome }}" == "failure" ] && \
+               [ "${{ steps.download_specific_attempt_2.outcome }}" == "failure" ] && \
+               [ "${{ steps.download_specific_attempt_3.outcome }}" == "failure" ]; then
+              DOWNLOAD_FAILED="true"
+            fi
+          else # Check download all path if name was NOT provided
+            if [ "${{ steps.download_all_attempt_1.outcome }}" == "failure" ] && \
+               [ "${{ steps.download_all_attempt_2.outcome }}" == "failure" ] && \
+               [ "${{ steps.download_all_attempt_3.outcome }}" == "failure" ]; then
+              DOWNLOAD_FAILED="true"
+            fi
+          fi
+
+          if [ "$DOWNLOAD_FAILED" == "true" ]; then
+            echo "::error::Artifact download failed after all 3 attempts." >&2
+            exit 1
+          fi
+        else
+          echo "::error::Invalid operation_type specified. Must be 'upload' or 'download'." >&2
+          exit 1
+        fi
+      shell: bash

ofscraper_community-3.16.2/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "" # See documentation for possible values
+    directory: / # Location of package manifests
+    schedule:
+      interval: weekly

ofscraper_community-3.16.2/.github/workflows/codecov.yml

@@ -0,0 +1,56 @@
+name: codecov
+permissions: read-all
+on:
+  push:
+    branches: main
+    # doc-only changes don't need a build or test run
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'media/**'
+      - 'LICENSE'
+      - '.github/ISSUE_TEMPLATE/**'
+  pull_request:
+    branches: main
+    # doc-only changes don't need a build or test run
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'media/**'
+      - 'LICENSE'
+      - '.github/ISSUE_TEMPLATE/**'
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # oldest supported and current
+        python-version: ["3.11", "3.15.2"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+        with:
+          # version-pioneer derives the package version from git tags
+          fetch-depth: 0
+          fetch-tags: true
+      - name: Set up uv and Python ${{ matrix.python-version }}
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      # --frozen installs exactly what uv.lock pins, so a new upstream release
+      # can't change what CI tests
+      - name: Install dependencies
+        run: uv sync --frozen --extra test
+      - name: create required folder
+        run: mkdir -p /home/runner/.config/ofscraper/main_profile
+      - name: Run tests and collect coverage
+        run: uv run --frozen pytest test --cov-report term --cov-report xml:coverage.xml --cov=ofscraper
+      - name: Upload coverage to Codecov
+        if: ${{ !cancelled() && matrix.python-version == '3.15.2' }}
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          fail_ci_if_error: false

ofscraper_community-3.16.2/.github/workflows/commit_bundler.yml

@@ -0,0 +1,302 @@
+name: Build and Package
+
+on:
+  push:
+    # Pushes to main build the binaries as a check. A version tag (e.g. 3.15.1)
+    # also publishes them as that version's release; path filters don't apply
+    # to tag pushes.
+    branches:
+      - main
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+    # doc-only changes don't need a build or test run
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'media/**'
+      - 'LICENSE'
+      - '.github/ISSUE_TEMPLATE/**'
+
+permissions:
+  contents: read # Required for git checkout and gh CLI to read workflow runs
+
+jobs:
+  generate_version:
+    name: Generate Version Info
+    runs-on: ubuntu-latest
+    env:
+          GH_TOKEN: ${{ github.token }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GITHUB_REF: ${{ github.ref }}
+          GITHUB_EVENT_BEFORE: ${{ github.event.before }}
+    outputs:
+      version: ${{ steps.version.outputs.VERSION }}
+      sanitized_version: ${{ steps.version.outputs.SANITIZED_VERSION }}
+      short_hash: ${{ steps.version.outputs.SHORT_HASH }}
+      long_hash: ${{ steps.version.outputs.LONG_HASH }}
+      commit_timestamp: ${{ steps.version.outputs.COMMIT_TIMESTAMP }}
+      base_version: ${{ steps.version.outputs.BASE_VERSION }}
+      push_type: ${{ steps.version.outputs.PUSH_TYPE }}
+      is_newer_than_last_successful_run: ${{ steps.version.outputs.IS_NEWER_THAN_LAST_SUCCESSFUL_RUN }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0 # Essential for git merge-base to compare full history
+          fetch-tags: true
+      
+      - name: Make script executable
+        run: chmod +x ./scripts/commit_version.sh
+      - name: Generate Version and Git Info
+        id: version # This step runs your commit_version.sh script
+        # Pass GitHub Actions context variables as environment variables to the script
+        run: ./scripts/commit_version.sh
+
+  build_binaries:
+    name: Build on ${{ matrix.os }}
+    needs: [generate_version]
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false # <-- ADDED: Allows all OS builds to complete even if one fails
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            artifact_suffix: linux
+            shell: bash
+          - os: windows-latest
+            artifact_suffix: windows
+            shell: pwsh
+          - os: macos-latest
+            artifact_suffix: macos
+            shell: bash
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: 3.15.1
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.1
+
+      - name: Set Version Environment Variables
+        shell: bash
+        run: |
+          echo "HATCH_VCS_PRETEND_VERSION=${{ needs.generate_version.outputs.version }}" >> $GITHUB_ENV
+
+      - name: Install Dependencies and Build Tools
+        shell: bash
+        run: |
+          uv venv
+          if [ "${{ runner.os }}" == "Windows" ]; then
+            . .venv/Scripts/activate
+          else
+            source .venv/bin/activate
+          fi
+          uv sync --verbose --extra ffmpeg --extra dev
+
+      - name: Set UTF-8 environment (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          echo "PYTHONUTF8=1" >> $env:GITHUB_ENV
+          echo "PYTHONLEGACYWINDOWSSTDIO=utf8" >> $env:GITHUB_ENV
+        shell: pwsh
+
+      - name: Build Executable using Spec Files (One-File)
+        id: build_onefile
+        shell: bash
+        continue-on-error: true # <-- ADDED: Allows this step to fail without stopping this OS matrix axis
+        run: |
+          SANITIZED_VERSION="${{ needs.generate_version.outputs.sanitized_version }}"
+          EXE_NAME="ofscraper_${{ matrix.artifact_suffix }}_${SANITIZED_VERSION}"
+          
+          if [ "${{ runner.os }}" == "Windows" ]; then
+              source .venv/Scripts/activate
+              EXE_EXT=".exe"
+          else
+              source .venv/bin/activate
+              EXE_EXT=""
+          fi
+          
+          echo "Building one-file executable from specs/onefile.spec..."
+          pyinstaller specs/onefile.spec
+          mv dist/ofscraper_file${EXE_EXT} dist/${EXE_NAME}${EXE_EXT}
+          echo "one_file_path=dist/${EXE_NAME}${EXE_EXT}" >> $GITHUB_OUTPUT
+          echo "one_file_name=${EXE_NAME}${EXE_EXT}" >> $GITHUB_OUTPUT
+
+      - name: Upload One-File Artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: ${{ steps.build_onefile.outputs.one_file_name }}
+          path: ${{ steps.build_onefile.outputs.one_file_path }}
+          if-no-files-found: ignore # Ensures upload step doesn't fail if previous build step failed
+
+      - name: Build and Zip One-Dir Bundle
+        id: build_onedir_zip
+        shell: bash
+        continue-on-error: true # Already present: Allows this step to fail without stopping this OS matrix axis
+        run: |
+          SANITIZED_VERSION="${{ needs.generate_version.outputs.sanitized_version }}"
+          DIR_NAME="ofscraper_${{ matrix.artifact_suffix }}_dir"
+          ZIP_NAME="ofscraper_${{ matrix.artifact_suffix }}_${SANITIZED_VERSION}.zip"
+
+          if [ "${{ runner.os }}" == "Windows" ]; then
+              source .venv/Scripts/activate
+          else
+              source .venv/bin/activate
+          fi
+
+          echo "Building one-dir bundle from specs/onedir.spec..."
+          pyinstaller specs/onedir.spec
+          mv dist/ofscraper_dir dist/${DIR_NAME}
+
+          echo "Zipping one-dir build..."
+          if [ "${{ runner.os }}" == "Windows" ]; then
+            powershell -Command "Compress-Archive -Path dist/${DIR_NAME} -DestinationPath dist/${ZIP_NAME} -Force"
+          else
+            zip -r "dist/${ZIP_NAME}" "dist/${DIR_NAME}"
+          fi
+          echo "zip_path=dist/${ZIP_NAME}" >> $GITHUB_OUTPUT
+          echo "zip_name=${ZIP_NAME}" >> $GITHUB_OUTPUT
+          echo "dir_path=dist/${DIR_NAME}" >> $GITHUB_OUTPUT
+          echo "dir_name=dist/${DIR_NAME}" >> $GITHUB_OUTPUT
+
+      - name: Upload Zipped One-Dir Artifact
+        if: success() && steps.build_onedir_zip.outcome == 'success'
+        uses: actions/upload-artifact@v7
+        with:
+          name: ${{ steps.build_onedir_zip.outputs.zip_name }}
+          path: ${{ steps.build_onedir_zip.outputs.zip_path }}
+          if-no-files-found: ignore # Ensures upload step doesn't fail if previous build step failed
+
+      - name: Upload One-Dir Folder (if zip failed)
+        if: failure() && steps.build_onedir_zip.outcome == 'failure'
+        uses: actions/upload-artifact@v7
+        with:
+          name: ${{ steps.build_onedir_zip.outputs.dir_name }}
+          path: ${{ steps.build_onedir_zip.outputs.dir_path }}
+          if-no-files-found: ignore # Ensures upload step doesn't fail if previous build step failed
+
+  publish_release:
+    name: Publish GitHub Release
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [build_binaries, generate_version] # Waits for version info AND all binary builds to complete (even partially)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # Required to create/update GitHub Releases
+    steps:
+      - name: Download all build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          path: artifacts/
+          # No specific `if-no-files-found` here on download-artifact, it will download what's available
+          # and log warnings for missing ones by default.
+
+      - name: List downloaded files for debugging
+        run: ls -R artifacts
+
+      - name: Create or Update Release
+        uses: ncipollo/release-action@v1.21.0
+
+        with:
+          artifacts: artifacts/*/* # Attach any downloaded artifacts (will include only those that were built successfully)
+          # One release per version tag; a re-run updates it
+          tag: ${{ github.ref_name }}
+          name: ${{ needs.generate_version.outputs.version }}
+          generateReleaseNotes: true
+          allowUpdates: true
+          prerelease: false
+          makeLatest: true
+
+  build_pypi_dist:
+    name: Build PyPI Packages
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [generate_version]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+          persist-credentials: false
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.1
+
+      - name: Build sdist and wheel
+        env:
+          # the plain tag version (e.g. 3.16.2); plugins.py would add +g<hash>
+          HATCH_VCS_PRETEND_VERSION: ${{ needs.generate_version.outputs.version }}
+        run: uv build --python 3.15
+
+      - name: Check the version is the plain tag
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          EXPECTED="${TAG#v}"
+          for f in dist/*; do echo "built: $f"; done
+          WHEELS=(dist/ofscraper_community-*-py3-none-any.whl)
+          SDISTS=(dist/ofscraper_community-*.tar.gz)
+          if [ ${#WHEELS[@]} -ne 1 ] || [ ! -f "${WHEELS[0]}" ] || [ ${#SDISTS[@]} -ne 1 ] || [ ! -f "${SDISTS[0]}" ]; then
+            echo "::error::expected one ofscraper-community wheel and one sdist"; exit 1
+          fi
+          BUILT=$(unzip -p "${WHEELS[0]}" '*.dist-info/METADATA' | sed -n 's/^Version: //p' | tr -d '\r')
+          NAME=$(unzip -p "${WHEELS[0]}" '*.dist-info/METADATA' | sed -n 's/^Name: //p' | tr -d '\r')
+          echo "name: $NAME, version: $BUILT, tag: $TAG"
+          if [ "$NAME" != "ofscraper-community" ]; then
+            echo "::error::package name is '$NAME', not 'ofscraper-community'"; exit 1
+          fi
+          case "$BUILT" in
+            *+*) echo "::error::version '$BUILT' has a local part, which PyPI rejects"; exit 1 ;;
+          esac
+          if [ "$BUILT" != "$EXPECTED" ]; then
+            echo "::error::version '$BUILT' doesn't match tag '$TAG'"; exit 1
+          fi
+          if [ "${SDISTS[0]}" != "dist/ofscraper_community-${EXPECTED}.tar.gz" ]; then
+            echo "::error::sdist '${SDISTS[0]}' doesn't match tag '$TAG'"; exit 1
+          fi
+
+      - name: Check the wheel installs and runs
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          uv venv --python 3.11 "$RUNNER_TEMP/smoke"
+          uv pip install --python "$RUNNER_TEMP/smoke" dist/*.whl
+          OUTPUT=$("$RUNNER_TEMP/smoke/bin/ofscraper" --version)
+          echo "$OUTPUT"
+          echo "$OUTPUT" | grep -qF "${TAG#v}"
+
+      - name: Upload packages
+        uses: actions/upload-artifact@v7
+        with:
+          name: pypi-dist
+          path: dist/
+          if-no-files-found: error
+
+  publish_pypi:
+    name: Publish to PyPI
+    if: startsWith(github.ref, 'refs/tags/')
+    # A PyPI version can't be replaced once uploaded, so publish last: only
+    # after the packages passed their checks and the GitHub release exists.
+    needs: [build_pypi_dist, publish_release]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/ofscraper-community/
+    permissions:
+      id-token: write # trusted publishing; no token or password is stored
+    steps:
+      - name: Download packages
+        uses: actions/download-artifact@v8
+        with:
+          name: pypi-dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.3