slidesync 0.1.0__tar.gz

slidesync-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Hails
+
+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.

slidesync-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: slidesync
+Version: 0.1.0
+Summary: Bidirectional sync between a Slidev markdown deck and Google Slides as native, editable objects
+Author-email: Daniel Hails <slidesync@hails.info>
+License: MIT
+Project-URL: Homepage, https://github.com/DJRHails/slidesync
+Project-URL: Bug Tracker, https://github.com/DJRHails/slidesync/issues
+Keywords: slidev,google-slides,markdown,presentations,slides
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-api-python-client>=2
+Requires-Dist: google-auth>=2
+Requires-Dist: python-frontmatter>=1
+Requires-Dist: loguru>=0.7
+Dynamic: license-file
+
+# slidesync
+
+Bidirectional sync between a [Slidev](https://sli.dev) markdown deck and **Google
+Slides** — as native, editable objects (title/body/bullets/tables/positioned
+images, brand-styled text boxes), not pasted screenshots.
+
+Version: 0.1.0
+
+```bash
+uvx slidesync --help            # run without installing
+pip install slidesync           # or install the CLI + library
+```
+
+## Why
+
+Exporting a deck to images gives you something you can't edit; pasting markdown
+by hand gives you something you can't version. `slidesync` keeps a `.slidev.md`
+file as the source of truth and renders it into **real** Slides objects, so the
+result stays fully editable in Google Slides — and `pull` reconstructs the
+markdown back from those objects, so the loop is reversible.
+
+- **`push`** — markdown → Slides (idempotent upsert, never a blind append).
+- **`pull`** — Slides → markdown (handles multi-text-box and externally-authored
+  decks, bullet nesting, tables, images, and speaker notes).
+- **`roundtrip`** — push a sample to a scratch deck, pull it back, assert the two
+  are semantically identical, delete the scratch deck.
+
+## Auth (no setup)
+
+Auth is **borrowed from the [`gog`](https://github.com/) CLI** — no separate
+OAuth client. `slidesync` reads the client id/secret from
+`~/Library/Application Support/gogcli/credentials.json` and the refresh token via
+`gog auth tokens export`, then mints a short-lived access token. The stored token
+already carries the `slides` + `drive` scopes; the Slides API must be enabled on
+the gog Cloud project. Override the account with `--account` or
+`$SLIDESYNC_ACCOUNT`. (Currently macOS-only — it reads gog's macOS Application
+Support path.)
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `slidesync push <file.slidev.md> [--deck ID] [--new "Title"] [--anchor SLIDE] [--prune] [--force]` | markdown → Slides |
+| `slidesync pull <deckId> --out <file.md> [--all]` | Slides → markdown (`--all` includes non-managed slides) |
+| `slidesync roundtrip [--keep]` | self-test: push a sample, pull, assert identical |
+| `slidesync layouts <deckId>` | list a deck's theme layouts + placeholders |
+| `slidesync make-templates <deckId>` | inject branded `{{token}}` template slides |
+
+`push` resolves the target deck from (in order) `--deck`, `--new`, or a top-level
+`deck:` frontmatter key. Relative image paths resolve against the markdown file's
+directory.
+
+```bash
+slidesync push deck.slidev.md            # targets `deck:` frontmatter
+slidesync push deck.slidev.md --new "Talk"
+slidesync pull <id> --out deck.slidev.md
+slidesync roundtrip
+```
+
+## Idempotent sync (upsert)
+
+Each managed slide is created with `objectId = s2g_<keyHash>_<contentHash>`.
+`keyHash` = per-slide `id:` frontmatter, else title slug, else index (survives
+edits/reorders); `contentHash` is over a canonical render, so push → pull → push
+is a no-op. Diff per run: identical hash → skip; same key, new content → replace;
+new key → create. Removed slides are **kept** unless `--prune`. **Only `s2g_`
+slides are ever touched** — hand-authored slides are invisible to the sync. A
+hidden `<!-- s2g {...} -->` marker in speaker notes carries the human id, image
+path, and template vars so `pull` can recover them.
+
+## Markdown dialect
+
+Top-level frontmatter: `theme:`, `deck:`. Slides separated by `---`; each slide
+may have its own frontmatter (`id:`, `template:`, `layout:`).
+
+- `# h1` = headline, `## h2` above an `# h1` = kicker; a lone `##` is the title.
+- Bullets `-`/`*`; ordered `1.` (nest with 2-space indent). Inline
+  `**bold**` / `*italic*` / `` `code` `` / `[link](url)`. GFM tables.
+  `![alt](path)` images (uploaded to Drive; `alt` becomes the accessibility
+  description, round-tripped on pull). Blank lines preserved as spacing.
+  `<!-- notes -->` become speaker notes.
+- **Internal links:** `[text](#slide-id)` becomes a native Slides link to the
+  slide whose `id:` (or title slug) is `slide-id`.
+
+### Built-in brand kit (IBM Plex; red `#C0392B` kicker)
+
+Select per slide via `template:` — native styled boxes, no in-deck templates:
+`dark`/`title`, `appendix`, `question`/`label`, `topic`, `content`,
+`graph`/`full` (single full-bleed image), `prompt`/`code` (verbatim monospace).
+Slides with no `template:` fall back to a generative path (section /
+title+body / table / image) that also brands the background + IBM Plex.
+
+### Custom slides (diagrams) — pull-authoritative
+
+Give a slide a fenced ```` ```gslides ```` block holding literal Slides API
+requests (use `__PAGE__` for the slide page id). Sync is **pull-authoritative /
+push-if-missing**: the Slides copy is the source of truth — `push` only creates
+the slide when missing, `pull` captures the live drawing back into the block.
+
+## Development
+
+```bash
+uv sync
+uv run pytest -q          # offline tests (no network/auth)
+```
+
+Releases publish to PyPI via Trusted Publishing (OIDC) on a `v*.*.*` tag — see
+`.github/workflows/release.yml`. Bump with `uvx bumpver update --patch`.
+
+## Caveats
+
+- Slidev-only constructs (`<v-clicks>`, `<div grid>`, CSS) are flattened/stripped
+  — this is a content mapper, not a CSS renderer.
+- On `pull`, the slide model holds a single image, so a slide with multiple
+  images keeps the first; image `contentUrl`s from foreign decks are ephemeral.
+
+## License
+
+MIT © Daniel Hails

slidesync-0.1.0/README.md

@@ -0,0 +1,119 @@
+# slidesync
+
+Bidirectional sync between a [Slidev](https://sli.dev) markdown deck and **Google
+Slides** — as native, editable objects (title/body/bullets/tables/positioned
+images, brand-styled text boxes), not pasted screenshots.
+
+Version: 0.1.0
+
+```bash
+uvx slidesync --help            # run without installing
+pip install slidesync           # or install the CLI + library
+```
+
+## Why
+
+Exporting a deck to images gives you something you can't edit; pasting markdown
+by hand gives you something you can't version. `slidesync` keeps a `.slidev.md`
+file as the source of truth and renders it into **real** Slides objects, so the
+result stays fully editable in Google Slides — and `pull` reconstructs the
+markdown back from those objects, so the loop is reversible.
+
+- **`push`** — markdown → Slides (idempotent upsert, never a blind append).
+- **`pull`** — Slides → markdown (handles multi-text-box and externally-authored
+  decks, bullet nesting, tables, images, and speaker notes).
+- **`roundtrip`** — push a sample to a scratch deck, pull it back, assert the two
+  are semantically identical, delete the scratch deck.
+
+## Auth (no setup)
+
+Auth is **borrowed from the [`gog`](https://github.com/) CLI** — no separate
+OAuth client. `slidesync` reads the client id/secret from
+`~/Library/Application Support/gogcli/credentials.json` and the refresh token via
+`gog auth tokens export`, then mints a short-lived access token. The stored token
+already carries the `slides` + `drive` scopes; the Slides API must be enabled on
+the gog Cloud project. Override the account with `--account` or
+`$SLIDESYNC_ACCOUNT`. (Currently macOS-only — it reads gog's macOS Application
+Support path.)
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `slidesync push <file.slidev.md> [--deck ID] [--new "Title"] [--anchor SLIDE] [--prune] [--force]` | markdown → Slides |
+| `slidesync pull <deckId> --out <file.md> [--all]` | Slides → markdown (`--all` includes non-managed slides) |
+| `slidesync roundtrip [--keep]` | self-test: push a sample, pull, assert identical |
+| `slidesync layouts <deckId>` | list a deck's theme layouts + placeholders |
+| `slidesync make-templates <deckId>` | inject branded `{{token}}` template slides |
+
+`push` resolves the target deck from (in order) `--deck`, `--new`, or a top-level
+`deck:` frontmatter key. Relative image paths resolve against the markdown file's
+directory.
+
+```bash
+slidesync push deck.slidev.md            # targets `deck:` frontmatter
+slidesync push deck.slidev.md --new "Talk"
+slidesync pull <id> --out deck.slidev.md
+slidesync roundtrip
+```
+
+## Idempotent sync (upsert)
+
+Each managed slide is created with `objectId = s2g_<keyHash>_<contentHash>`.
+`keyHash` = per-slide `id:` frontmatter, else title slug, else index (survives
+edits/reorders); `contentHash` is over a canonical render, so push → pull → push
+is a no-op. Diff per run: identical hash → skip; same key, new content → replace;
+new key → create. Removed slides are **kept** unless `--prune`. **Only `s2g_`
+slides are ever touched** — hand-authored slides are invisible to the sync. A
+hidden `<!-- s2g {...} -->` marker in speaker notes carries the human id, image
+path, and template vars so `pull` can recover them.
+
+## Markdown dialect
+
+Top-level frontmatter: `theme:`, `deck:`. Slides separated by `---`; each slide
+may have its own frontmatter (`id:`, `template:`, `layout:`).
+
+- `# h1` = headline, `## h2` above an `# h1` = kicker; a lone `##` is the title.
+- Bullets `-`/`*`; ordered `1.` (nest with 2-space indent). Inline
+  `**bold**` / `*italic*` / `` `code` `` / `[link](url)`. GFM tables.
+  `![alt](path)` images (uploaded to Drive; `alt` becomes the accessibility
+  description, round-tripped on pull). Blank lines preserved as spacing.
+  `<!-- notes -->` become speaker notes.
+- **Internal links:** `[text](#slide-id)` becomes a native Slides link to the
+  slide whose `id:` (or title slug) is `slide-id`.
+
+### Built-in brand kit (IBM Plex; red `#C0392B` kicker)
+
+Select per slide via `template:` — native styled boxes, no in-deck templates:
+`dark`/`title`, `appendix`, `question`/`label`, `topic`, `content`,
+`graph`/`full` (single full-bleed image), `prompt`/`code` (verbatim monospace).
+Slides with no `template:` fall back to a generative path (section /
+title+body / table / image) that also brands the background + IBM Plex.
+
+### Custom slides (diagrams) — pull-authoritative
+
+Give a slide a fenced ```` ```gslides ```` block holding literal Slides API
+requests (use `__PAGE__` for the slide page id). Sync is **pull-authoritative /
+push-if-missing**: the Slides copy is the source of truth — `push` only creates
+the slide when missing, `pull` captures the live drawing back into the block.
+
+## Development
+
+```bash
+uv sync
+uv run pytest -q          # offline tests (no network/auth)
+```
+
+Releases publish to PyPI via Trusted Publishing (OIDC) on a `v*.*.*` tag — see
+`.github/workflows/release.yml`. Bump with `uvx bumpver update --patch`.
+
+## Caveats
+
+- Slidev-only constructs (`<v-clicks>`, `<div grid>`, CSS) are flattened/stripped
+  — this is a content mapper, not a CSS renderer.
+- On `pull`, the slide model holds a single image, so a slide with multiple
+  images keeps the first; image `contentUrl`s from foreign decks are ephemeral.
+
+## License
+
+MIT © Daniel Hails

slidesync-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "slidesync"
+version = "0.1.0"
+authors = [
+    { name = "Daniel Hails", email = "slidesync@hails.info" },
+]
+description = "Bidirectional sync between a Slidev markdown deck and Google Slides as native, editable objects"
+requires-python = ">=3.10"
+dynamic = ["dependencies", "readme"]
+license = { text = "MIT" }
+keywords = ["slidev", "google-slides", "markdown", "presentations", "slides"]
+
+[project.scripts]
+slidesync = "slidesync:main"
+
+[project.urls]
+"Homepage" = "https://github.com/DJRHails/slidesync"
+"Bug Tracker" = "https://github.com/DJRHails/slidesync/issues"
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.dynamic]
+dependencies = { file = ["requirements.txt"] }
+readme = { file = ["README.md"], content-type = "text/markdown" }
+
+[tool.setuptools.packages.find]
+include = ["slidesync*"]
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[tool.bumpver]
+current_version = "0.1.0"
+version_pattern = "MAJOR.MINOR.PATCH"
+commit_message = "bump version {old_version} -> {new_version}"
+commit = true
+tag = true
+push = true
+
+[tool.bumpver.file_patterns]
+"pyproject.toml" = [
+    'current_version = "{version}"',
+    '^version = "{version}"',
+]
+"slidesync/__init__.py" = [
+    '__version__ = "{version}"',
+]
+"README.md" = [
+    "{version}",
+]

slidesync-0.1.0/requirements.txt

@@ -0,0 +1,4 @@
+google-api-python-client>=2
+google-auth>=2
+python-frontmatter>=1
+loguru>=0.7

slidesync-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

slidesync-0.1.0/slidesync/__init__.py

@@ -0,0 +1,48 @@
+"""slidesync — bidirectional Slidev markdown <-> Google Slides sync.
+
+`push` builds **native** Slides objects (title/body placeholders, bullets,
+tables, positioned images), so the result stays editable rather than a flat
+image; `pull` reconstructs Slidev markdown from those native objects;
+`roundtrip` proves the loop is stable. Auth is borrowed from the `gog` CLI.
+
+Library usage::
+
+    from slidesync import get_services, load_slides, push, pull_slides, write_slidev
+
+    slides_api, drive = get_services()
+    push(slides_api, drive, deck_id, load_slides(Path("deck.slidev.md")),
+         anchor=None, prune=False)
+
+CLI: ``slidesync push|pull|roundtrip|layouts|make-templates`` (see ``--help``).
+"""
+
+from slidesync._sync import (
+    Para,
+    Run,
+    Slide,
+    build_slides,
+    get_services,
+    load_slides,
+    main,
+    pull_slides,
+    push,
+    split_slides,
+    write_slidev,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Para",
+    "Run",
+    "Slide",
+    "__version__",
+    "build_slides",
+    "get_services",
+    "load_slides",
+    "main",
+    "pull_slides",
+    "push",
+    "split_slides",
+    "write_slidev",
+]