glideshow 0.1.2__tar.gz

glideshow-0.1.2/.github/workflows/checks.yml

@@ -0,0 +1,16 @@
+# Every push: the type and lint checks (about a minute; no build step, they read the plain JS and Python).
+# Locally: tools/check.sh. The browser tests are tests.yml.
+name: checks
+on: [push, pull_request]
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - run: tools/check.sh

glideshow-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,56 @@
+# A version tag (v0.2.0) on main: the quick checks (the browser tests are run locally before tagging, and nightly), glideshow.org runs it, and a GitHub Release with notes from the commits
+# since the last one, and the package on PyPI. The tag must match pyproject.toml's version. Staging is staging.yml.
+name: release
+on:
+  push:
+    tags: ['v*.*.*']
+permissions:
+  contents: write   # the GitHub Release
+concurrency: { group: production, cancel-in-progress: false }
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - name: The tag is pyproject.toml's version, on main
+        run: |
+          v=$(sed -n 's/^version = "\(.*\)"/\1/p' pyproject.toml)
+          [ "v$v" = "$GITHUB_REF_NAME" ] || { echo "tag $GITHUB_REF_NAME but pyproject.toml says $v"; exit 1; }
+          git merge-base --is-ancestor "$GITHUB_SHA" origin/main || { echo "$GITHUB_REF_NAME isn't on main"; exit 1; }
+      - uses: astral-sh/setup-uv@v5
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - run: tools/check.sh
+  deploy:
+    needs: checks
+    runs-on: ubuntu-latest
+    environment: { name: production, url: https://glideshow.org }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
+          wranglerVersion: "4.152.0"   # as locally (the action's own default is older)
+          workingDirectory: cloud
+          command: deploy
+  release:
+    needs: deploy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv build
+      - env: { GH_TOKEN: '${{ github.token }}' }
+        run: gh release create "$GITHUB_REF_NAME" dist/* --title "Glideshow $GITHUB_REF_NAME" --generate-notes $([[ "$GITHUB_REF_NAME" == v0.* ]] && echo --prerelease)
+  pypi:   # the package on PyPI as "glideshow" (trusted publishing: the PyPI project trusts this workflow; no token stored)
+    needs: release
+    runs-on: ubuntu-latest
+    environment: { name: pypi, url: https://pypi.org/p/glideshow }
+    permissions: { contents: read, id-token: write }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv build && uv publish --trusted-publishing always

glideshow-0.1.2/.github/workflows/staging.yml

@@ -0,0 +1,33 @@
+# Every push to main: the checks, then dev.glideshow.org (the nightly channel) runs it. Production is release.yml.
+# Needs the repo secret CLOUDFLARE_API_TOKEN and the variable CLOUDFLARE_ACCOUNT_ID (README → Releasing).
+name: staging
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency: { group: staging, cancel-in-progress: true }   # only the newest push deploys
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - run: tools/check.sh
+  deploy:
+    needs: checks
+    runs-on: ubuntu-latest
+    environment: { name: staging, url: https://dev.glideshow.org }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
+          wranglerVersion: "4.152.0"   # as locally (the action's own default is older)
+          workingDirectory: cloud
+          command: deploy --env dev

glideshow-0.1.2/.github/workflows/tests.yml

@@ -0,0 +1,62 @@
+# The end-to-end tests in headless Chrome (about 10 minutes on macOS): on pull requests, every night on main, and by hand
+# (Actions → tests → Run workflow, or `gh workflow run tests.yml`). They gate nothing: a failure is a heads-up to look
+# at. Before tagging a release, run `uv run test/smoke.py` locally.
+name: tests
+on:
+  pull_request:
+  schedule:
+    - cron: '0 7 * * *'   # 07:00 UTC, every night
+  workflow_dispatch:
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: macos-latest   # the tests are macOS's: ⌘ shortcuts (docs/shortcuts.md), its fonts in the text-fitting checks
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: git config --global user.name ci && git config --global user.email ci@example.org   # the tests make git commits
+      - run: uv run --with playwright python -m playwright install chromium   # tools/gslides2deck.py renders with Playwright's own Chromium
+      - run: uv run test/smoke.py   # drives the installed Google Chrome (playwright channel "chrome")
+      - if: ${{ !cancelled() }}   # (each test runs even when one before it failed)
+        run: uv run test/keys.py
+      - if: ${{ !cancelled() }}
+        run: uv run test/agent.py   # the `glideshow` command as an agent uses it (skills/glideshow), in a library of its own
+      - if: failure()
+        uses: actions/upload-artifact@v4
+        with: { name: screenshots, path: "test/*.png", if-no-files-found: ignore }
+
+  cloud:   # glideshow.org (cloud/) on a local Worker: browser mode, a Google account's library in a stand-in Drive, sharing
+    runs-on: macos-latest   # (the sandbox, passes, comments), reports and takedowns. No real accounts: the secrets are made up.
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with: { prune-cache: false }   # (its cleanup failed on uv's cache, held by the background fake Drive)
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - name: made-up secrets for wrangler dev
+        run: |
+          cat > cloud/.dev.vars <<VARS
+          SESSION_KEY=$(openssl rand -hex 32)
+          GITHUB_APP_ID=1
+          GITHUB_APP_SLUG=glideshow-ci
+          GITHUB_CLIENT_ID=ci
+          GITHUB_CLIENT_SECRET=ci
+          GITHUB_APP_KEY=ci
+          DEV_LOGIN=1
+          DEV_REPO=ci/decks
+          DEV_DRIVE=1
+          DRIVE_API=http://localhost:8791
+          GOOGLE_TOKEN_URL=http://localhost:8791/token
+          GOOGLE_CLIENT_ID=ci
+          GOOGLE_CLIENT_SECRET=ci
+          VARS
+      - run: uv run test/fake_drive.py 8791 > fake_drive.log 2>&1 &
+      - run: cd cloud && npx --yes wrangler@4 dev --port 8790 --local-upstream localhost:8790 > ../wrangler.log 2>&1 &
+      - run: for i in $(seq 1 90); do curl -s -o /dev/null http://localhost:8790/ && exit 0; sleep 1; done; cat wrangler.log; exit 1
+      - run: uv run test/cloud.py --drive
+      - if: failure()
+        run: tail -50 wrangler.log fake_drive.log

glideshow-0.1.2/.gitignore

@@ -0,0 +1,24 @@
+__pycache__/
+*.pyc
+.venv/
+.DS_Store
+# local only: Google Slides screenshots used as the visual reference, and generated test output
+reference/
+test/shots/*.png
+test/*.png
+replicate/
+dist/
+# secrets for `wrangler dev` (cloud/)
+cloud/.dev.vars
+cloud/.wrangler/
+
+# fidelity study: the images are re-made from the code and from Google (summary.json and report.md are kept)
+fidelity/results/*/google/
+fidelity/results/*/ours/
+
+# mobile study: captures of Google Slides' iPhone app stay on this Mac (only the checklist is kept)
+mobile/reference/*
+!mobile/reference/CAPTURE.md
+test/shots/mobile/
+test/shots/media/
+test/shots/share/