EPUB command options, error handling, and testing

[mphstudios]

Adds a quire epub command option to specify the output path

Examples:

quire epub --output the-digital-book.epub
quire epub -o the-digital-book.epub

See the updated [lib/epub documentation in this pull-request()

Added

• EPUB engines (epub.js, Pandoc) output debug statements when --debug flag is used
• Adds a quire epub command option to specify the output path

Usage

# Use project config default location
quire epub

# Custom absolute path (overrides project config)
quire epub --output /path/to/publication-ebook.epub

# Custom relative path (resolved from project root, overrides project config)
quire epub --output downloads/publication.epub

# Combined with other options
quire pdf --build --engine pandoc --output final-ebook.epub

Changed

• Lib EPUB throws custom EpubGenerationError errors
• Use lib/reporter to provide user feedback during the EPUB generation progress

Example EPUB command output

Success case:

❯ quire epub
⠋ Generating EPUB using Epub.js... (0.0s)
  Input: /path/to/project/_epub
  Output: /path/to/project/epubjs.epub
✔ EPUB saved to /path/to/project/epubjs.epub (2.3s)

Success with Pandoc:

❯ quire epub --engine pandoc
⠋ Generating EPUB using Pandoc... (0.0s)
  Input: /path/to/project/_epub
  Output: /path/to/project/pandoc.epub
✔ EPUB saved to /path/to/project/pandoc.epub (1.8s)

Custom output path:

❯ quire epub --output my-book.epub
⠋ Generating EPUB using Epub.js... (0.0s)
  Input: /path/to/project/_epub
  Output: /path/to/project/my-book.epub
✔ EPUB saved to /path/to/project/my-book.epub (2.1s)

Failure case:

❯ quire epub
⠋ Generating EPUB using Epub.js... (0.0s)
  Input: /path/to/project/_epub
  Output: /path/to/project/epubjs.epub
✖ EPUB generation failed (0.5s)

With --build flag:

❯ quire epub --build
⠋ Building site... (0.0s)
✔ Site built (45.2s)
⠋ Generating EPUB using Epub.js... (0.0s)
  Input: /path/to/project/_epub
  Output: /path/to/project/epubjs.epub
✔ EPUB saved to /path/to/project/epubjs.epub (2.3s)