pdfmd 0.1.0__tar.gz

pdfmd-0.1.0/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv sync:*)"
+    ]
+  }
+}

pdfmd-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.venv/
+uv.lock

pdfmd-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

pdfmd-0.1.0/CLAUDE.md

@@ -0,0 +1,26 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+pdf2md is a Python CLI tool that converts PDF files to Markdown using `pymupdf4llm`. Packaged with `hatchling`, managed with `uv`.
+
+## Development
+
+```bash
+uv sync                     # install dependencies
+uv run pdf2md --help         # run the CLI
+uv run python -m pdf2md      # alternative invocation
+uv build                     # build distributable
+uv publish                   # publish to PyPI
+```
+
+## Architecture
+
+src layout package (`src/pdf2md/`):
+- `cli.py` — CLI entry point using argparse; `parse_pages()` converts 1-indexed page specs to 0-indexed lists, `main()` delegates to `pymupdf4llm.to_markdown()`
+- `__main__.py` — enables `python -m pdf2md`
+- `__init__.py` — version string
+
+Console script entry point: `pdf2md = "pdf2md.cli:main"` (defined in `pyproject.toml`).

pdfmd-0.1.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: pdfmd
+Version: 0.1.0
+Summary: Convert PDF files to Markdown using pymupdf4llm
+Requires-Python: >=3.10
+Requires-Dist: pymupdf4llm
+Description-Content-Type: text/markdown
+
+# pdf2md
+
+Convert PDF files to Markdown using [pymupdf4llm](https://github.com/pymupdf/RAG).
+
+## Installation
+
+```bash
+# With uv
+uv sync
+
+# Or with pip
+pip install .
+```
+
+## Usage
+
+```bash
+pdf2md input.pdf                          # writes input.md
+pdf2md input.pdf -o output.md             # explicit output path
+pdf2md input.pdf -o -                     # stdout
+pdf2md input.pdf -p "1,3,5-8"            # specific pages (1-indexed)
+pdf2md input.pdf --images --dpi 200       # extract images
+```
+
+Run `pdf2md --help` for all options.
+
+## Build & Publish
+
+```bash
+uv build      # creates dist/*.whl and dist/*.tar.gz
+uv publish    # publish to PyPI
+```

pdfmd-0.1.0/README.md

@@ -0,0 +1,32 @@
+# pdf2md
+
+Convert PDF files to Markdown using [pymupdf4llm](https://github.com/pymupdf/RAG).
+
+## Installation
+
+```bash
+# With uv
+uv sync
+
+# Or with pip
+pip install .
+```
+
+## Usage
+
+```bash
+pdf2md input.pdf                          # writes input.md
+pdf2md input.pdf -o output.md             # explicit output path
+pdf2md input.pdf -o -                     # stdout
+pdf2md input.pdf -p "1,3,5-8"            # specific pages (1-indexed)
+pdf2md input.pdf --images --dpi 200       # extract images
+```
+
+Run `pdf2md --help` for all options.
+
+## Build & Publish
+
+```bash
+uv build      # creates dist/*.whl and dist/*.tar.gz
+uv publish    # publish to PyPI
+```

pdfmd-0.1.0/pdfmd.spec

@@ -0,0 +1,38 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+
+a = Analysis(
+    ['src\\pdfmd\\cli.py'],
+    pathex=[],
+    binaries=[],
+    datas=[],
+    hiddenimports=[],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='pdfmd',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=True,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)

pdfmd-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pdfmd"
+version = "0.1.0"
+description = "Convert PDF files to Markdown using pymupdf4llm"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "pymupdf4llm",
+]
+
+[project.scripts]
+pdfmd = "pdfmd.cli:main"

pdfmd-0.1.0/src/pdfmd/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

pdfmd-0.1.0/src/pdfmd/__main__.py

@@ -0,0 +1,4 @@
+from pdf2md.cli import main
+import sys
+
+sys.exit(main())

pdfmd-0.1.0/src/pdfmd/cli.py

@@ -0,0 +1,95 @@
+"""pdf2md - Convert PDF files to Markdown using pymupdf4llm."""
+
+import argparse
+import sys
+from pathlib import Path
+
+import pymupdf4llm
+
+
+def parse_pages(spec: str) -> list[int]:
+    """Parse a page spec like '1,3,5-8' into a 0-indexed list."""
+    pages = set()
+    for part in spec.split(","):
+        part = part.strip()
+        if "-" in part:
+            start, end = part.split("-", 1)
+            pages.update(range(int(start) - 1, int(end)))
+        else:
+            pages.add(int(part) - 1)
+    return sorted(pages)
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(
+        description="Convert a PDF to Markdown.",
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    )
+    ap.add_argument("input", type=Path, help="input PDF file")
+    ap.add_argument(
+        "-o", "--output", type=Path,
+        help="output .md file (default: input with .md extension, '-' for stdout)",
+    )
+    ap.add_argument(
+        "-p", "--pages", type=str,
+        help="pages to extract, e.g. '1,3,5-8' (1-indexed). default: all",
+    )
+    ap.add_argument(
+        "--images", action="store_true",
+        help="extract embedded images alongside the markdown",
+    )
+    ap.add_argument(
+        "--image-dir", type=Path, default=Path("images"),
+        help="directory for extracted images",
+    )
+    ap.add_argument(
+        "--image-format", default="png", choices=["png", "jpg"],
+        help="image format",
+    )
+    ap.add_argument(
+        "--dpi", type=int, default=150,
+        help="DPI for rendered/extracted images",
+    )
+    ap.add_argument(
+        "--table-strategy", default="lines", choices=["lines", "lines_strict"],
+        help="table detection strategy",
+    )
+    ap.add_argument(
+        "-q", "--quiet", action="store_true",
+        help="suppress progress output",
+    )
+    args = ap.parse_args()
+
+    if not args.input.is_file():
+        sys.exit(f"error: {args.input} not found")
+
+    kwargs = {
+        "table_strategy": args.table_strategy,
+        "dpi": args.dpi,
+        "show_progress": not args.quiet,
+    }
+    if args.pages:
+        try:
+            kwargs["pages"] = parse_pages(args.pages)
+        except ValueError:
+            sys.exit(f"error: invalid page spec: {args.pages!r}")
+    if args.images:
+        args.image_dir.mkdir(parents=True, exist_ok=True)
+        kwargs["write_images"] = True
+        kwargs["image_path"] = str(args.image_dir)
+        kwargs["image_format"] = args.image_format
+
+    try:
+        md = pymupdf4llm.to_markdown(str(args.input), **kwargs)
+    except Exception as e:
+        sys.exit(f"error: conversion failed: {e}")
+
+    if args.output and str(args.output) == "-":
+        sys.stdout.write(md)
+    else:
+        out = args.output or args.input.with_suffix(".md")
+        out.write_text(md, encoding="utf-8")
+        if not args.quiet:
+            print(f"wrote {out} ({len(md):,} chars)", file=sys.stderr)
+
+    return 0