leanpub-multi-action 2.0.1

GitHub Actions for Leanpub.com

Leanpub Multi Action

A GitHub Action to interact with the Leanpub API. Preview, publish, and check job status for your Leanpub books — directly from your GitHub workflows.

Quick Start

- name: "Preview Book"
  uses: "lykinsbd/leanpub-multi-action@v2"
  with:
    leanpub-api-key: "${{ secrets.LEANPUB_API_KEY }}"
    leanpub-book-slug: "mygreatbook"
    action: "preview"

Inputs

Name	Required	Default	Description
leanpub-api-key	Yes	—	Leanpub API key (requires a Pro plan). Store as a GitHub Secret.
leanpub-book-slug	Yes	—	Book slug — the path component after https://leanpub.com/.
action	Yes	—	Action to perform: preview, publish, or check-status.
email-readers	No	"false"	Email readers about a new publish. Only used with publish.
release-notes	No	—	Release notes for the publish. Only used with publish.
subset	No	"false"	Preview only the files listed in Subset.txt. Only used with preview.
single-file	No	—	Path to a Markdown file for single-file preview. Only used with preview.

Examples

Full preview on push

---
name: "Preview on Push"

"on":
  push:
    branches: ["preview"]

jobs:
  preview:
    runs-on: "ubuntu-latest"
    steps:
      - name: "Preview Book"
        uses: "lykinsbd/leanpub-multi-action@v2"
        with:
          leanpub-api-key: "${{ secrets.LEANPUB_API_KEY }}"
          leanpub-book-slug: "mygreatbook"
          action: "preview"

Subset preview

Preview only the files listed in your book's Subset.txt:

- name: "Subset Preview"
  uses: "lykinsbd/leanpub-multi-action@v2"
  with:
    leanpub-api-key: "${{ secrets.LEANPUB_API_KEY }}"
    leanpub-book-slug: "mygreatbook"
    action: "preview"
    subset: "true"

Single-file preview

Preview a single Markdown file without modifying Subset.txt. The output PDF is saved as {slug}-single-file.pdf in your Dropbox previews folder.

- name: "Checkout"
  uses: "actions/checkout@v4"
- name: "Single File Preview"
  uses: "lykinsbd/leanpub-multi-action@v2"
  with:
    leanpub-api-key: "${{ secrets.LEANPUB_API_KEY }}"
    leanpub-book-slug: "mygreatbook"
    action: "preview"
    single-file: "manuscript/chapter-05.md"

Publish with release notes

- name: "Publish"
  uses: "lykinsbd/leanpub-multi-action@v2"
  with:
    leanpub-api-key: "${{ secrets.LEANPUB_API_KEY }}"
    leanpub-book-slug: "mygreatbook"
    action: "publish"
    email-readers: "true"
    release-notes: "Chapter 5 added"

Check job status

- name: "Check Status"
  uses: "lykinsbd/leanpub-multi-action@v2"
  with:
    leanpub-api-key: "${{ secrets.LEANPUB_API_KEY }}"
    leanpub-book-slug: "mygreatbook"
    action: "check-status"

CLI Usage

The action also ships as a standalone CLI tool called lma.

uv tool install leanpub-multi-action

or with pip:

pip install leanpub-multi-action

lma --leanpub-api-key YOUR_KEY --book-slug mygreatbook preview
lma --leanpub-api-key YOUR_KEY --book-slug mygreatbook preview --subset
lma --leanpub-api-key YOUR_KEY --book-slug mygreatbook preview --single-file chapter.md
lma --leanpub-api-key YOUR_KEY --book-slug mygreatbook publish --email-readers --release-notes "v2"
lma --leanpub-api-key YOUR_KEY --book-slug mygreatbook check-status

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT