[common] Add optional Byparr challenge solver

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[**.py]
+indent_size = 4
+indent_style = space
+max_line_length = 79
+
+[Makefile]
+indent_style = tab

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+ko_fi: mikefaehrmann
+custom: https://www.paypal.me/mikefaehrmann

.github/workflows/docker.yml

@@ -0,0 +1,69 @@
+name: Docker Images
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+    - master
+    tags:
+    - v[0-9]+.[0-9]+.[0-9]+
+
+
+permissions:
+  packages: write
+
+concurrency:
+  group: docker
+  cancel-in-progress: false
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    # on release commits, run only for tag event
+    if: ${{
+        github.repository == 'mikf/gallery-dl' &&
+        ( ! startsWith( github.event.head_commit.message , 'release version ' ) ||
+            startsWith( github.ref , 'refs/tags/v' ) )
+      }}
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - uses: docker/metadata-action@v5
+      id: metadata
+      with:
+        images: |
+          mikf123/gallery-dl
+          ghcr.io/mikf/gallery-dl
+        tags: |
+          type=ref,event=tag
+          type=raw,value=dev
+          type=sha,format=long,prefix=
+          type=raw,priority=500,value={{date 'YYYY.MM.DD'}}
+
+    - uses: docker/setup-qemu-action@v3
+
+    - uses: docker/setup-buildx-action@v3
+
+    - name: Login to DockerHub
+      uses: docker/login-action@v3
+      with:
+        username: ${{ secrets.DOCKERHUB_USERNAME }}
+        password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+    - name: Login to GitHub Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GHCR_TOKEN }}
+
+    - uses: docker/build-push-action@v5
+      with:
+        context: .
+        push: true
+        tags: ${{ steps.metadata.outputs.tags }}
+        labels: ${{ steps.metadata.outputs.labels }}
+        platforms: linux/amd64,linux/arm64

.github/workflows/executables.yml

@@ -0,0 +1,108 @@
+name: Executables
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+    - master
+    tags-ignore:
+    - "*"
+
+env:
+  DATE_FORMAT: "%Y.%m.%d"
+
+jobs:
+  build:
+
+    if: github.repository == 'mikf/gallery-dl'
+    runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        shell: bash
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ["windows-latest", "macOS-latest"]
+        architecture: ["x64"]
+        python-version: ["3.13"]
+        python-packages: [""]
+        include:
+        - os: "ubuntu-latest"
+          architecture: "x64"
+          python-version: "3.13"
+          python-packages: "secretstorage"
+        - os: "windows-2022"
+          architecture: "x86"
+          python-version: "3.8"
+          python-packages: "toml"
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Set up Python ${{ matrix.python-version }} ${{ matrix.architecture }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+        architecture: ${{ matrix.architecture }}
+
+    - name: Environment Variables
+      run: |
+        echo "DATE=$(date '+${{ env.DATE_FORMAT }}')" >> "$GITHUB_ENV"
+        echo "LABEL=$(python ./scripts/pyinstaller.py --print --os '${{ matrix.os }}' --arch '${{ matrix.architecture }}')" >> "$GITHUB_ENV"
+
+    - name: Update Version
+      # use Python since its behavior is consistent across operating systems
+      shell: python
+      run: |
+        import re
+        path = "./gallery_dl/version.py"
+        with open(path) as fp:
+            content = fp.read()
+        content = re.sub(
+            r'\b(__version__ = "[^"]+)',
+            r"\1:${{ env.DATE }}",
+            content)
+        content = re.sub(
+            r'\b(__variant__ =).+',
+            r'\1 "dev/${{ env.LABEL }}"',
+            content)
+        with open(path, "w") as fp:
+            fp.write(content)
+
+    - name: Build executable
+      run: |
+        pip install requests requests[socks] yt-dlp[default] pyyaml ${{ matrix.python-packages }} pyinstaller
+        pip install truststore || true
+        python ./scripts/pyinstaller.py --label '${{ env.LABEL }}'
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: executable-${{ matrix.os }}-${{ matrix.architecture }}-${{ matrix.python-version }}
+        path: dist/*
+        retention-days: 1
+        compression-level: 0
+
+  release:
+
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/download-artifact@v4
+
+    - name: Environment Variables
+      run: echo "DATE=$(date '+${{ env.DATE_FORMAT }}')" >> "$GITHUB_ENV"
+
+    - name: Body
+      run: printf 'https://github.com/%s/commit/%s' '${{ github.repository }}' '${{ github.sha }}' > body.md
+
+    - uses: ncipollo/release-action@v1
+      with:
+        owner: gdl-org
+        repo: builds
+        tag: ${{ env.DATE }}
+        bodyFile: body.md
+        artifacts: "executable-*/*"
+        allowUpdates: true
+        makeLatest: true
+        token: ${{ secrets.REPO_TOKEN }}

.github/workflows/pages.yml

@@ -0,0 +1,58 @@
+name: GitHub Pages
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+    - master
+    paths:
+    - docs/**
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  dispatch:
+
+    if: github.repository == 'mikf/gallery-dl'
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Dispatch to gdl-org/docs
+      run: >
+        curl -L
+        -X POST
+        -H "Accept: application/vnd.github+json"
+        -H "Authorization: Bearer ${{ secrets.REPO_TOKEN }}"
+        -H "X-GitHub-Api-Version: 2022-11-28"
+        https://api.github.com/repos/gdl-org/docs/actions/workflows/pages.yml/dispatches
+        -d '{"ref":"master"}'
+
+  deploy:
+
+    if: github.repository == 'mikf/gallery-dl'
+    runs-on: ubuntu-latest
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+    - uses: actions/checkout@v5
+    - uses: actions/configure-pages@v4
+
+    - name: Copy static files
+      run: |
+        mkdir --parents -- ./_site
+        cp --archive --target-directory=./_site -- \
+          ./docs/oauth-redirect.html
+
+    - uses: actions/upload-pages-artifact@v3
+    - uses: actions/deploy-pages@v4
+      id: deployment

.github/workflows/tests.yml

@@ -0,0 +1,70 @@
+name: Tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+    - master
+  pull_request:
+    branches:
+    - master
+
+jobs:
+  test:
+
+    runs-on: ubuntu-22.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+        - "3.8"
+        - "3.9"
+        - "3.10"
+        - "3.11"
+        - "3.12"
+        - "3.13"
+        - "3.14"
+        - "pypy3.9"
+        - "pypy3.11"
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Check file permissions
+      run: |
+        if [[ "$(find ./gallery_dl -type f -not -perm 644)" ]]; then exit 1; fi
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        pip install -r requirements.txt
+        pip install flake8 youtube-dl
+
+    - name: Install yt-dlp
+      run: |
+        case "${{ matrix.python-version }}" in
+            3.8|3.9|pypy3.9)
+                # install from PyPI
+                pip install yt-dlp
+                ;;
+            *)
+                # install from master
+                pip install https://github.com/yt-dlp/yt-dlp/archive/refs/heads/master.tar.gz
+                ;;
+        esac
+
+    - name: Lint with flake8
+      run: |
+        flake8 .
+
+    - name: Run tests
+      run: |
+        make test
+
+    - name: Test autogeneration of man pages, bash/zsh/fish completion, etc
+      run: |
+        make

.gitignore

@@ -0,0 +1,70 @@
+archive/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+data/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# 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/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Snap packaging specific
+/snap/.snapcraft/
+/parts/
+/stage/
+/prime/
+
+/*.snap
+/*_source.tar.bz2
+/gallery-dl