pdf2epub 0.1.2 → 0.1.4

package/lib/cli.js

@@ -1,134 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const { spawnSync } = require('child_process');
-
-const paths = require('./paths');
-const setup = require('./setup');
-const { findPython, findUv } = require('./python');
-
-const WRAPPER_COMMANDS = new Set(['setup', 'info', 'clean', 'help', '--help', '-h', '--version', '-V']);
-
-function versionLine() {
-  const up = setup.upstreamInfo();
-  return `pdf2epub ${paths.pkg.version} (npm wrapper) / upstream ${up.repo}@${up.ref} ${String(up.commit).slice(0, 7)}`;
-}
-
-function usage() {
-  return `${versionLine()}
-
-Convert PDF files to structured Markdown and EPUB (via marker-pdf).
-
-Usage:
-  pdf2epub [input_path] [output_path] [options]
-  pdf2epub <command>
-
-Upstream options (passed through to pdf2epub's main.py):
-  input_path               PDF file or directory (default: ./input/*.pdf)
-  output_path              Output directory (default: directory named after the PDF)
-  --max-pages INT          Maximum number of pages to process
-  --start-page INT         Page number to start from (requires --max-pages)
-  --skip-epub              Only create Markdown; no interactive EPUB prompts
-  --skip-md                Reuse existing Markdown, only build the EPUB
-
-Wrapper commands:
-  setup [--force]          Create (or recreate) the Python environment now
-  info                     Show install location, Python, and upstream version
-  clean                    Delete the Python environment (${paths.homeDir()})
-  help, --help, -h         Show this help
-  --version, -V            Show versions
-
-  Use "pdf2epub -- <args>" to pass arguments straight to upstream, e.g.
-  "pdf2epub -- --help" or when your input path is literally named "setup".
-
-Environment:
-  PDF2EPUB_HOME            Where the Python venv lives (default: ~/.pdf2epub)
-  PDF2EPUB_PYTHON          Python interpreter (or version for uv) to use
-  PDF2EPUB_INSTALLER       "auto" (default: uv if available, else pip) or "pip"
-  HF_HOME                  Where marker-pdf caches its models (downloaded on first run)
-
-Notes:
-  The first run installs PyTorch and marker-pdf into a private venv and marker
-  downloads its models; both happen once. EPUB generation prompts for metadata
-  interactively, so it needs a terminal; use --skip-epub for non-interactive use.
-`;
-}
-
-function info() {
-  const up = setup.upstreamInfo();
-  const state = setup.readState();
-  const lines = [
-    versionLine(),
-    `home:       ${paths.homeDir()}`,
-    `venv:       ${paths.venvDir()}${fs.existsSync(paths.venvPython()) ? '' : ' (not created)'}`,
-    `installed:  ${setup.isInstalled() ? 'yes' : state ? 'stale (run: pdf2epub setup)' : 'no (runs automatically on first use)'}`,
-    `upstream:   https://github.com/${up.repo}/tree/${up.commit || up.ref}`,
-    `vendor:     ${paths.vendorDir}`,
-  ];
-  if (state) {
-    lines.push(`installer:  ${state.installer}`, `installedAt: ${state.installedAt}`);
-  } else {
-    const uv = findUv();
-    const py = findPython();
-    lines.push(`uv:         ${uv ? uv.version : 'not found'}`);
-    lines.push(`python:     ${py ? `${py.version} (${[py.cmd, ...py.args].join(' ')})` : 'no suitable interpreter found (need 3.10-3.13)'}`);
-  }
-  return lines.join('\n') + '\n';
-}
-
-function runUpstream(args) {
-  const python = setup.ensureInstalled();
-  const res = spawnSync(python, [paths.mainPy, ...args], {
-    stdio: 'inherit',
-    env: {
-      ...process.env,
-      PYTHONUNBUFFERED: process.env.PYTHONUNBUFFERED || '1',
-      // The vendored source may live in a read-only global node_modules; keep it pristine.
-      PYTHONDONTWRITEBYTECODE: process.env.PYTHONDONTWRITEBYTECODE || '1',
-    },
-  });
-  if (res.error) throw res.error;
-  if (res.signal) return 128 + (res.signal === 'SIGINT' ? 2 : 1);
-  return res.status == null ? 1 : res.status;
-}
-
-async function main(argv) {
-  const [first, ...rest] = argv;
-
-  if (first === '--') return runUpstream(rest);
-
-  if (!WRAPPER_COMMANDS.has(first)) return runUpstream(argv);
-
-  switch (first) {
-    case '--version':
-    case '-V':
-      process.stdout.write(versionLine() + '\n');
-      return 0;
-    case 'help':
-    case '--help':
-    case '-h':
-      process.stdout.write(usage());
-      return 0;
-    case 'info':
-      process.stdout.write(info());
-      return 0;
-    case 'setup': {
-      const force = rest.includes('--force');
-      if (!force && setup.isInstalled()) {
-        setup.log(`Already set up in ${paths.homeDir()} (use --force to reinstall).`);
-        return 0;
-      }
-      setup.ensureInstalled({ force });
-      return 0;
-    }
-    case 'clean': {
-      const removed = setup.clean();
-      setup.log(removed ? `Removed ${paths.homeDir()}` : `Nothing to remove at ${paths.homeDir()}`);
-      return 0;
-    }
-    default:
-      return runUpstream(argv);
-  }
-}
-
-module.exports = { main, usage, info, versionLine };

package/lib/paths.js

@@ -1,44 +0,0 @@
-'use strict';
-
-const os = require('os');
-const path = require('path');
-
-const pkg = require('../package.json');
-
-const isWindows = process.platform === 'win32';
-
-function homeDir() {
-  return process.env.PDF2EPUB_HOME || path.join(os.homedir(), '.pdf2epub');
-}
-
-function venvDir() {
-  return path.join(homeDir(), 'venv');
-}
-
-function venvPython() {
-  return isWindows
-    ? path.join(venvDir(), 'Scripts', 'python.exe')
-    : path.join(venvDir(), 'bin', 'python');
-}
-
-function stateFile() {
-  return path.join(homeDir(), 'state.json');
-}
-
-const vendorDir = path.resolve(__dirname, '..', 'vendor', 'pdf2epub');
-const mainPy = path.join(vendorDir, 'main.py');
-const requirementsFile = path.join(vendorDir, 'requirements.txt');
-const upstreamFile = path.join(vendorDir, 'UPSTREAM.json');
-
-module.exports = {
-  pkg,
-  isWindows,
-  homeDir,
-  venvDir,
-  venvPython,
-  stateFile,
-  vendorDir,
-  mainPy,
-  requirementsFile,
-  upstreamFile,
-};

package/lib/python.js

@@ -1,76 +0,0 @@
-'use strict';
-
-const { spawnSync } = require('child_process');
-const { isWindows } = require('./paths');
-
-// Upstream supports Python 3.10-3.14; 3.13 is recommended. On 3.14 Pillow has
-// to be built from source (marker-pdf pins Pillow<11), so treat it as a last
-// resort.
-const MIN = [3, 10];
-const PREFERRED_MAX = [3, 13];
-const HARD_MAX = [3, 14];
-
-function cmp(a, b) {
-  return a[0] - b[0] || a[1] - b[1];
-}
-
-function probe(cmd, args) {
-  const res = spawnSync(
-    cmd,
-    [...args, '-c', 'import sys; print("%d.%d.%d" % sys.version_info[:3])'],
-    { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 15000 }
-  );
-  if (res.error || res.status !== 0) return null;
-  const m = /^(\d+)\.(\d+)\.(\d+)/.exec((res.stdout || '').trim());
-  if (!m) return null;
-  return {
-    cmd,
-    args,
-    version: m[0],
-    tuple: [Number(m[1]), Number(m[2])],
-  };
-}
-
-function candidates() {
-  const list = [];
-  if (process.env.PDF2EPUB_PYTHON) {
-    list.push({ cmd: process.env.PDF2EPUB_PYTHON, args: [] });
-    return list;
-  }
-  for (const v of ['3.13', '3.12', '3.11', '3.10', '3.14']) {
-    list.push({ cmd: `python${v}`, args: [] });
-    if (isWindows) list.push({ cmd: 'py', args: [`-${v}`] });
-  }
-  list.push({ cmd: 'python3', args: [] });
-  list.push({ cmd: 'python', args: [] });
-  if (isWindows) list.push({ cmd: 'py', args: ['-3'] });
-  return list;
-}
-
-/**
- * Find a Python interpreter suitable for the upstream project.
- * Returns { cmd, args, version, tuple, fallback } or null.
- */
-function findPython() {
-  let fallback = null;
-  for (const c of candidates()) {
-    const p = probe(c.cmd, c.args);
-    if (!p) continue;
-    if (cmp(p.tuple, MIN) < 0) continue;
-    if (cmp(p.tuple, PREFERRED_MAX) <= 0) return { ...p, fallback: false };
-    if (cmp(p.tuple, HARD_MAX) <= 0 && !fallback) fallback = { ...p, fallback: true };
-  }
-  return fallback;
-}
-
-function findUv() {
-  const res = spawnSync('uv', ['--version'], {
-    encoding: 'utf8',
-    stdio: ['ignore', 'pipe', 'ignore'],
-    timeout: 15000,
-  });
-  if (res.error || res.status !== 0) return null;
-  return { cmd: 'uv', version: (res.stdout || '').trim() };
-}
-
-module.exports = { findPython, findUv, probe, MIN, PREFERRED_MAX, HARD_MAX };

package/lib/setup.js

@@ -1,152 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const crypto = require('crypto');
-const { spawnSync } = require('child_process');
-
-const paths = require('./paths');
-const { findPython, findUv } = require('./python');
-
-function log(msg) {
-  process.stderr.write(`[pdf2epub] ${msg}\n`);
-}
-
-function readJson(file, fallback) {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return fallback;
-  }
-}
-
-function upstreamInfo() {
-  return readJson(paths.upstreamFile, paths.pkg.pdf2epub.upstream);
-}
-
-/** Hash of everything that, when changed, requires reinstalling the venv. */
-function installHash() {
-  const h = crypto.createHash('sha256');
-  h.update(fs.readFileSync(paths.requirementsFile));
-  h.update('\n');
-  h.update(String(upstreamInfo().commit || ''));
-  return h.digest('hex');
-}
-
-function readState() {
-  return readJson(paths.stateFile(), null);
-}
-
-function isInstalled() {
-  const state = readState();
-  return Boolean(state && fs.existsSync(paths.venvPython()) && state.hash === installHash());
-}
-
-function run(cmd, args, opts = {}) {
-  log(`$ ${[cmd, ...args].join(' ')}`);
-  const res = spawnSync(cmd, args, { stdio: 'inherit', ...opts });
-  if (res.error) throw res.error;
-  return res.status;
-}
-
-function installWithUv(uv) {
-  const pyArg = process.env.PDF2EPUB_PYTHON || '3.13';
-  if (run(uv.cmd, ['venv', '--python', pyArg, paths.venvDir()]) !== 0) return false;
-  return (
-    run(uv.cmd, [
-      'pip',
-      'install',
-      '--python',
-      paths.venvPython(),
-      '-r',
-      paths.requirementsFile,
-    ]) === 0
-  );
-}
-
-function installWithPip(python) {
-  if (run(python.cmd, [...python.args, '-m', 'venv', paths.venvDir()]) !== 0) return false;
-  const vp = paths.venvPython();
-  // Failing to upgrade pip is not fatal.
-  run(vp, ['-m', 'pip', 'install', '--upgrade', 'pip']);
-  return run(vp, ['-m', 'pip', 'install', '-r', paths.requirementsFile]) === 0;
-}
-
-/**
- * Make sure the Python environment exists and matches the bundled upstream.
- * Returns the path to the venv's python executable.
- */
-function ensureInstalled({ force = false } = {}) {
-  if (!force && isInstalled()) return paths.venvPython();
-
-  const up = upstreamInfo();
-  log(`Setting up Python environment in ${paths.homeDir()}`);
-  log(`Upstream: ${up.repo}@${up.ref} (${String(up.commit).slice(0, 7)})`);
-  log('This installs PyTorch and marker-pdf (several hundred MB); it only happens once.');
-
-  if (fs.existsSync(paths.venvDir())) {
-    log('Removing existing environment');
-    fs.rmSync(paths.venvDir(), { recursive: true, force: true });
-  }
-  fs.mkdirSync(paths.homeDir(), { recursive: true });
-
-  const installer = (process.env.PDF2EPUB_INSTALLER || 'auto').toLowerCase();
-  let ok = false;
-  let used = null;
-
-  const uv = installer === 'pip' ? null : findUv();
-  if (uv) {
-    log(`Using ${uv.version}`);
-    ok = installWithUv(uv);
-    used = 'uv';
-    if (!ok) {
-      log('uv install failed; falling back to venv + pip');
-      fs.rmSync(paths.venvDir(), { recursive: true, force: true });
-    }
-  }
-
-  if (!ok) {
-    const python = findPython();
-    if (!python) {
-      throw new Error(
-        'No suitable Python found. pdf2epub needs Python 3.10-3.13 (3.13 recommended).\n' +
-          '  Install Python 3.13 (https://www.python.org/downloads/) or uv (https://docs.astral.sh/uv/),\n' +
-          '  or point PDF2EPUB_PYTHON at an interpreter.'
-      );
-    }
-    if (python.fallback) {
-      log(
-        `Warning: using Python ${python.version}; 3.13 is recommended. ` +
-          'Pillow will be built from source, which needs a C toolchain and image headers.'
-      );
-    }
-    log(`Using Python ${python.version} (${[python.cmd, ...python.args].join(' ')})`);
-    ok = installWithPip(python);
-    used = 'pip';
-  }
-
-  if (!ok) {
-    throw new Error(`Python dependency installation failed. See output above. Retry with: pdf2epub setup --force`);
-  }
-
-  const state = {
-    hash: installHash(),
-    upstream: up,
-    wrapperVersion: paths.pkg.version,
-    installer: used,
-    python: paths.venvPython(),
-    installedAt: new Date().toISOString(),
-  };
-  fs.writeFileSync(paths.stateFile(), JSON.stringify(state, null, 2) + '\n');
-  log('Setup complete.');
-  return paths.venvPython();
-}
-
-function clean() {
-  if (fs.existsSync(paths.homeDir())) {
-    fs.rmSync(paths.homeDir(), { recursive: true, force: true });
-    return true;
-  }
-  return false;
-}
-
-module.exports = { ensureInstalled, isInstalled, installHash, readState, upstreamInfo, clean, log };

package/vendor/pdf2epub/LICENSE

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) 2024 overcuriousity
-
-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.

package/vendor/pdf2epub/README.md

@@ -1,217 +0,0 @@
-# PDF2EPUB 📚
-
-Convert PDF files to nicely structured Markdown and EPUB format with intelligent layout detection.
-
-## ✨ Features
-
-- 📖 Smart layout detection for books and academic papers
-- 🔍 Advanced text extraction and OCR capabilities
-- 📊 Table detection and formatting
-- 🖼️ Image extraction and optimization
-- 📝 Clean markdown output with preserved structure
-- 📱 EPUB generation with customizable styling
-- 🌍 Multi-language support
-- 🚀 GPU acceleration support (NVIDIA & AMD)
-- 🍎 Apple Silicon support
-
-## 🛠️ Dependencies
-
-- Python 3.10–3.14 (3.13 recommended, see below)
-- PyTorch (with CUDA/ROCm support for GPU acceleration)
-- marker-pdf==1.10.2
-- transformers==4.57.6
-- markdown==3.10.2
-- latex2mathml==3.81.0
-
-### ⚠️ Python version
-
-Python 3.13 is recommended.
-
-`marker-pdf` constrains `Pillow<11.0.0`, and Pillow only ships Python 3.14
-wheels from 11.3.0 onward. On Python 3.10–3.13 every dependency installs as a
-prebuilt wheel. On 3.14, pip has to build Pillow from source instead: this
-works, but it is slower and requires a working C toolchain plus the image
-library headers Pillow links against. On Debian/Ubuntu install them first:
-
-```bash
-sudo apt install libjpeg-dev zlib1g-dev libtiff-dev libfreetype6-dev libwebp-dev
-```
-
-Without these headers the install fails with
-`RequiredDependencyException: The headers or library files could not be found for jpeg`.
-
-## 💻 Installation
-
-1. Create and activate a virtual environment.
-
-On Linux/Mac:
-```bash
-python3.13 -m venv .venv
-source .venv/bin/activate
-```
-
-On Windows:
-```powershell
-py -3.13 -m venv .venv
-.venv\Scripts\activate
-```
-
-2. Install Python dependencies (this installs PyTorch as well):
-```bash
-pip install -r requirements.txt
-```
-
-3. GPU acceleration (optional):
-
-PyTorch is installed as a dependency in step 2. On Apple Silicon that wheel
-already supports MPS, so no further action is needed. For a specific CUDA or
-ROCm build, reinstall PyTorch using the selector at
-[pytorch.org/get-started/locally](https://pytorch.org/get-started/locally/).
-For example, for AMD GPUs with ROCm:
-```bash
-pip uninstall torch torchvision torchaudio
-pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.2
-```
-
-4. Verify GPU support:
-```python
-import torch
-print(torch.__version__)  # PyTorch version
-print(torch.cuda.is_available())  # Should return True for NVIDIA
-print(torch.backends.mps.is_available())  # Should return True for Apple Silicon
-print(torch.version.hip)  # Should print ROCm version for AMD
-```
-
-### 🐳 Docker
-
-A CPU-only image can be built from the included `Dockerfile`:
-
-```bash
-docker build -t pdf2epub .
-```
-
-Run it with your PDFs mounted at `/data` and a model cache volume (marker-pdf
-downloads its models on first run):
-
-```bash
-docker run -it --rm \
-  -v "$(pwd)":/data \
-  -v pdf2epub-models:/models \
-  pdf2epub input.pdf
-```
-
-`-it` is required for EPUB generation because metadata is prompted
-interactively; with `--skip-epub` it can run non-interactively.
-
-Tagged releases are also published to
-`ghcr.io/overcuriousity/pdf2epub` by the Docker workflow.
-
-## 🚀 Usage
-
-### Basic Usage
-
-Convert a single PDF file:
-```bash
-python main.py input.pdf
-```
-
-Convert all PDFs in a directory:
-```bash
-python main.py input_directory/
-```
-
-EPUB generation prompts interactively for metadata (title, author, language,
-and so on; press Enter to accept each default). It therefore needs a terminal —
-run it non-interactively and it will fail with `EOFError`. Use `--skip-epub` to
-produce only markdown without any prompts.
-
-### Advanced Options
-
-```bash
-python main.py [input_path] [output_path] [options]
-
-Options:
-  --max-pages INT          Maximum number of pages to process
-  --start-page INT         Page number to start from
-  --skip-epub              Skip EPUB generation, only create markdown
-  --skip-md                Skip markdown generation, use existing markdown files
-```
-
-If `input_path` is omitted, all PDFs in `./input/` are processed.
-
-### Examples
-
-Process a specific range of pages:
-```bash
-python main.py book.pdf --start-page 10 --max-pages 50
-```
-
-Convert to markdown only:
-```bash
-python main.py thesis.pdf --skip-epub
-```
-
-### Output Structure
-
-```
-output_directory/
-├── document_name/
-│   ├── document_name.md
-│   ├── document_name.epub
-│   ├── document_name_metadata.json
-│   └── images/
-│       ├── image1.png
-│       ├── image2.jpg
-│       └── ...
-```
-
-## 🤝 Contributing
-
-Contributions are welcome! Here's how you can help:
-
-1. Fork the repository
-2. Create a new branch for your feature
-3. Commit your changes
-4. Push to your branch
-5. Create a Pull Request
-
-Please ensure your code follows the existing style and includes appropriate tests.
-
-### Development Setup
-
-1. Clone the repository:
-```bash
-git clone https://github.com/overcuriousity/pdf2epub.git
-cd pdf2epub
-```
-
-2. Create a virtual environment:
-```bash
-python -m venv venv
-source venv/bin/activate  # Linux/Mac
-venv\Scripts\activate     # Windows
-```
-
-3. Install development dependencies:
-```bash
-pip install -r requirements.txt
-```
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🐛 Known Issues
-
-- Some image embedding might need manual adjustment
-- Some complex mathematical equations might not be perfectly converted
-- Certain PDF layouts with multiple columns may require manual adjustment
-- Font detection might be imperfect in some cases
-
-## 🙏 Acknowledgments
-
-This project builds upon several excellent open-source libraries:
-- [marker-pdf](https://github.com/VikParuchuri/marker) for PDF processing
-- [mark2epub](https://github.com/AlexPof/mark2epub) for markdown conversion
-- [PyTorch](https://pytorch.org/) for GPU acceleration
-- [Transformers](https://huggingface.co/transformers) for advanced text processing

package/vendor/pdf2epub/UPSTREAM.json

@@ -1,8 +0,0 @@
-{
-  "repo": "overcuriousity/pdf2epub",
-  "ref": "v1.1.0",
-  "commit": "5eae669d1c897b4735f369fb2ff4086237db3a81",
-  "commitDate": "2026-07-16T18:17:11Z",
-  "url": "https://github.com/overcuriousity/pdf2epub/tree/5eae669d1c897b4735f369fb2ff4086237db3a81",
-  "syncedAt": "2026-09-07T09:36:39.940Z"
-}