kindleify 0.1.0__tar.gz

kindleify-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: kindleify
+Version: 0.1.0
+Summary: Convert URLs and PDFs to EPUB for Kindle
+Author-email: Your Name <your@email.com>
+License: MIT
+Keywords: kindle,epub,pdf,converter,ebook
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.3.2
+Requires-Dist: ebooklib>=0.20
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: pillow>=12.0.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: requests
+Requires-Dist: trafilatura
+Requires-Dist: twine>=6.2.0
+
+# Kindleify
+
+Convert URLs and PDFs to EPUB format for Kindle.
+
+## Installation
+
+```bash
+pip install kindleify
+```
+
+## Usage
+
+### Convert URL to EPUB
+
+```bash
+kindleify url "https://example.com/article" -o article.epub
+```
+
+### Convert PDF to EPUB
+
+```bash
+kindleify pdf document.pdf -o book.epub
+```
+
+### Send to Kindle
+
+First, configure your Kindle email:
+
+```bash
+kindleify config set
+```
+
+Then send EPUB to your Kindle:
+
+```bash
+kindleify send book.epub
+```
+
+### Commands
+
+- `kindleify url` - Convert URL to EPUB
+- `kindleify pdf` - Convert PDF to EPUB
+- `kindleify send` - Send EPUB to Kindle
+- `kindleify config set` - Configure Kindle credentials
+- `kindleify config show` - Show current configuration
+- `kindleify config clear` - Clear stored credentials
+
+## License
+
+MIT

kindleify-0.1.0/README.md

@@ -0,0 +1,50 @@
+# Kindleify
+
+Convert URLs and PDFs to EPUB format for Kindle.
+
+## Installation
+
+```bash
+pip install kindleify
+```
+
+## Usage
+
+### Convert URL to EPUB
+
+```bash
+kindleify url "https://example.com/article" -o article.epub
+```
+
+### Convert PDF to EPUB
+
+```bash
+kindleify pdf document.pdf -o book.epub
+```
+
+### Send to Kindle
+
+First, configure your Kindle email:
+
+```bash
+kindleify config set
+```
+
+Then send EPUB to your Kindle:
+
+```bash
+kindleify send book.epub
+```
+
+### Commands
+
+- `kindleify url` - Convert URL to EPUB
+- `kindleify pdf` - Convert PDF to EPUB
+- `kindleify send` - Send EPUB to Kindle
+- `kindleify config set` - Configure Kindle credentials
+- `kindleify config show` - Show current configuration
+- `kindleify config clear` - Clear stored credentials
+
+## License
+
+MIT

kindleify-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kindleify"
+version = "0.1.0"
+description = "Convert URLs and PDFs to EPUB for Kindle"
+readme = "README.md"
+requires-python = ">=3.14"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "your@email.com"}
+]
+keywords = ["kindle", "epub", "pdf", "converter", "ebook"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "click>=8.3.2",
+    "ebooklib>=0.20",
+    "pypdf>=4.0.0",
+    "pillow>=12.0.0",
+    "platformdirs>=4.0.0",
+    "requests",
+    "trafilatura",
+    "twine>=6.2.0",
+]
+
+[project.scripts]
+kindleify = "kindleify.cli:cli"

kindleify-0.1.0/setup.cfg

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

kindleify-0.1.0/src/kindleify/cli.py

@@ -0,0 +1,96 @@
+import click
+
+from kindleify import config as cfg
+from kindleify.converter.url import url_to_epub
+from kindleify.converter.pdf import pdf_to_epub
+from kindleify.delivery.kindle import send_to_kindle
+
+
+@click.group()
+def cli():
+    """Kindleify CLI"""
+    pass
+
+
+@cli.command()
+@click.argument("url")
+@click.option("-o", "--output", default=None, help="Output EPUB file")
+def url(url, output):
+    """Convert URL to EPUB"""
+    path = url_to_epub(url, output)
+    click.echo(f"Saved EPUB: {path}")
+
+
+@cli.command()
+@click.argument("pdf_path")
+@click.option("-o", "--output", default="output.epub", help="Output EPUB file")
+def pdf(pdf_path, output):
+    """Convert PDF to EPUB"""
+    pdf_to_epub(pdf_path, output)
+    click.echo(f"Saved EPUB: {output}")
+
+
+@cli.command()
+@click.argument("file")
+@click.option("--to", default=None, help="Kindle email address")
+@click.option("--from-email", default=None, help="Sender email")
+@click.option("--password", default=None, help="App password")
+def send(file, to, from_email, password):
+    """Send EPUB to Kindle"""
+    try:
+        send_to_kindle(file, to, from_email, password)
+        click.echo(f"Sent {file}")
+    except ValueError as e:
+        raise click.ClickException(str(e))
+
+
+@cli.group()
+def config():
+    """Manage Kindleify configuration"""
+    pass
+
+
+@config.command("set")
+def config_set():
+    """Set Kindle email credentials"""
+    click.echo("Configure your Kindle email settings:")
+
+    to_email = click.prompt("Kindle email address", type=str)
+    from_email = click.prompt("Sender email (Gmail)", type=str)
+    password = click.prompt("Gmail app password", type=str, hide_input=True)
+
+    cfg.set_kindle_config(to_email, from_email, password)
+    click.echo("Configuration saved!")
+
+
+@config.command("show")
+def config_show():
+    """Show current configuration"""
+    kindle_cfg = cfg.get_kindle_config()
+
+    if not kindle_cfg:
+        click.echo("No configuration found. Run: kindleify config set")
+        return
+
+    to_email = kindle_cfg.get("to_email", "")
+    from_email = kindle_cfg.get("from_email", "")
+    password = kindle_cfg.get("password", "")
+    masked = "•" * 8 if password else ""
+
+    click.echo(f"Kindle email: {to_email}")
+    click.echo(f"Sender email: {from_email}")
+    click.echo(f"Password: {masked}")
+
+
+@config.command("clear")
+def config_clear():
+    """Clear stored configuration"""
+    if not cfg.has_kindle_config():
+        click.echo("No configuration to clear.")
+        return
+
+    if click.confirm("Clear all stored credentials?"):
+        cfg.clear_kindle_config()
+        click.echo("Configuration cleared.")
+    else:
+        click.echo("Cancelled.")

kindleify-0.1.0/src/kindleify/config.py

@@ -0,0 +1,61 @@
+import os
+import tomllib
+from pathlib import Path
+
+import platformdirs
+
+CONFIG_DIR = Path(platformdirs.user_config_dir("kindleify"))
+CONFIG_FILE = CONFIG_DIR / "config.toml"
+
+
+def load_config() -> dict:
+    """Load config from file, return empty dict if not found."""
+    if not CONFIG_FILE.exists():
+        return {}
+    with open(CONFIG_FILE, "rb") as f:
+        return tomllib.load(f)
+
+
+def save_config(config: dict):
+    """Save config to file."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    lines = []
+    for section, values in config.items():
+        if isinstance(values, dict):
+            lines.append(f"[{section}]")
+            for key, value in values.items():
+                lines.append(f'{key} = "{value}"')
+            lines.append("")
+    with open(CONFIG_FILE, "w") as f:
+        f.write("\n".join(lines))
+
+
+def get_kindle_config() -> dict:
+    """Get Kindle-specific config (kindle section)."""
+    config = load_config()
+    return config.get("kindle", {})
+
+
+def set_kindle_config(to_email: str, from_email: str, password: str):
+    """Save Kindle credentials to config."""
+    config = load_config()
+    config["kindle"] = {
+        "to_email": to_email,
+        "from_email": from_email,
+        "password": password,
+    }
+    save_config(config)
+
+
+def clear_kindle_config():
+    """Remove Kindle credentials from config."""
+    config = load_config()
+    if "kindle" in config:
+        del config["kindle"]
+        save_config(config)
+
+
+def has_kindle_config() -> bool:
+    """Check if Kindle credentials are configured."""
+    cfg = get_kindle_config()
+    return bool(cfg.get("to_email") and cfg.get("from_email") and cfg.get("password"))

kindleify-0.1.0/src/kindleify/converter/epub_builder.py

@@ -0,0 +1,33 @@
+from ebooklib import epub
+
+
+class EpubBuilder:
+    def __init__(self, title: str):
+        self.book = epub.EpubBook()
+        self.book.set_identifier("kindleify")
+        self.book.set_title(title)
+        self.book.set_language("en")
+        self.chapters = []
+
+    def add_chapter(self, title: str, content: str):
+        chapter = epub.EpubHtml(title=title, file_name=f"{title}.xhtml", lang="en")
+        chapter.set_content(content)
+
+        self.book.add_item(chapter)
+        self.chapters.append(chapter)
+
+    def build(self, output_path: str):
+        # Create nav first
+        nav = epub.EpubNav(file_name="nav.xhtml")
+        self.book.add_item(nav)
+
+        # Set TOC
+        self.book.toc = tuple(self.chapters)
+
+        # Set spine - reading order (nav first, then chapters)
+        self.book.spine = [nav] + self.chapters
+
+        # Add NCX for backward compatibility
+        self.book.add_item(epub.EpubNcx())
+
+        epub.write_epub(output_path, self.book)

kindleify-0.1.0/src/kindleify/converter/pdf.py

@@ -0,0 +1,51 @@
+from pypdf import PdfReader
+from ebooklib import epub
+
+from kindleify.converter.epub_builder import EpubBuilder
+
+
+def pdf_to_epub(input_path: str, output_path: str) -> str:
+    """
+    Convert PDF to EPUB using pypdf.
+    """
+    reader = PdfReader(input_path)
+
+    title = reader.metadata.get("/Title", "") if reader.metadata else ""
+    if not title:
+        title = "Untitled"
+
+    book = epub.EpubBook()
+    book.set_identifier("kindleify")
+    book.set_title(title)
+    book.set_language("en")
+
+    chapters = []
+    for i, page in enumerate(reader.pages):
+        text = page.extract_text()
+        if not text.strip():
+            continue
+
+        chapter = epub.EpubHtml(
+            title=f"Page {i + 1}", file_name=f"page_{i + 1}.xhtml", lang="en"
+        )
+
+        html_content = f"""<html>
+<head><title>Page {i + 1}</title></head>
+<body>
+<pre style="font-family: Georgia, serif; font-size: 1em; line-height: 1.6;">{text}</pre>
+</body>
+</html>"""
+        chapter.set_content(html_content)
+
+        book.add_item(chapter)
+        chapters.append(chapter)
+
+    nav = epub.EpubNav(file_name="nav.xhtml")
+    book.add_item(nav)
+
+    book.toc = tuple(chapters)
+    book.spine = [nav] + chapters
+    book.add_item(epub.EpubNcx())
+
+    epub.write_epub(output_path, book)
+    return output_path

kindleify-0.1.0/src/kindleify/converter/url.py

@@ -0,0 +1,55 @@
+import trafilatura
+from trafilatura.metadata import extract_metadata
+
+from kindleify.converter.epub_builder import EpubBuilder
+from kindleify.utils import sanitize_filename
+
+
+def url_to_epub(url: str, output_path: str | None = None) -> str:
+    """
+    Convert a URL into an EPUB file.
+    Returns the output file path.
+    """
+
+    downloaded = trafilatura.fetch_url(url)
+    if not downloaded:
+        raise ValueError("Failed to fetch URL content")
+
+    text = trafilatura.extract(downloaded, output_format="html", include_comments=False)
+    if not text:
+        raise ValueError("Failed to extract readable content")
+
+    body_content = (
+        text.replace("<html>", "")
+        .replace("</html>", "")
+        .replace("<body>", "")
+        .replace("</body>", "")
+        .strip()
+    )
+
+    metadata = extract_metadata(downloaded)
+    title = metadata.title if metadata and metadata.title else "Untitled"
+
+    html_content = f"""<html>
+<head>
+    <title>{title}</title>
+    <style>
+        body {{ font-family: Georgia, serif; font-size: 1em; line-height: 1.6; padding: 1em; }}
+        p {{ margin-bottom: 1em; }}
+        li {{ margin-bottom: 0.5em; }}
+    </style>
+</head>
+<body>
+{body_content}
+</body>
+</html>"""
+
+    if not output_path:
+        filename = sanitize_filename(title) or "book"
+        output_path = f"{filename}.epub"
+
+    builder = EpubBuilder(title)
+    builder.add_chapter("Content", html_content)
+    builder.build(output_path)
+
+    return output_path

kindleify-0.1.0/src/kindleify/delivery/kindle.py

@@ -0,0 +1,42 @@
+import smtplib
+from email.message import EmailMessage
+
+from kindleify import config as cfg
+
+
+def send_to_kindle(
+    file_path: str,
+    to_email: str | None = None,
+    from_email: str | None = None,
+    app_password: str | None = None,
+):
+    """
+    Send EPUB file to Kindle via email.
+    Uses stored credentials if not provided as arguments.
+    """
+    stored = cfg.get_kindle_config()
+
+    to_email = to_email or stored.get("to_email")
+    from_email = from_email or stored.get("from_email")
+    app_password = app_password or stored.get("password")
+
+    if not to_email:
+        raise ValueError("Kindle email not configured. Run: kindleify config")
+    if not from_email or not app_password:
+        raise ValueError("Sender credentials not configured. Run: kindleify config")
+
+    msg = EmailMessage()
+    msg["Subject"] = "Kindleify Book"
+    msg["From"] = from_email
+    msg["To"] = to_email
+
+    msg.set_content("Sent via Kindleify")
+
+    with open(file_path, "rb") as f:
+        msg.add_attachment(
+            f.read(), maintype="application", subtype="epub+zip", filename="book.epub"
+        )
+
+    with smtplib.SMTP_SSL("smtp.gmail.com", 465) as smtp:
+        smtp.login(from_email, app_password)
+        smtp.send_message(msg)

kindleify-0.1.0/src/kindleify/utils.py

@@ -0,0 +1,15 @@
+import re
+
+def text_to_html(text: str) -> str:
+    """
+    Convert plain text into basic HTML paragraphs.
+    """
+    paragraphs = text.split("\n\n")
+    html = "".join(f"<p>{p.strip()}</p>" for p in paragraphs if p.strip())
+    return html
+
+def sanitize_filename(name: str) -> str:
+    """
+    Remove invalid filename characters.
+    """
+    return re.sub(r'[<>:"/\\|?*]+', "", name).strip().replace(" ", "_")

kindleify-0.1.0/src/kindleify.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: kindleify
+Version: 0.1.0
+Summary: Convert URLs and PDFs to EPUB for Kindle
+Author-email: Your Name <your@email.com>
+License: MIT
+Keywords: kindle,epub,pdf,converter,ebook
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.3.2
+Requires-Dist: ebooklib>=0.20
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: pillow>=12.0.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: requests
+Requires-Dist: trafilatura
+Requires-Dist: twine>=6.2.0
+
+# Kindleify
+
+Convert URLs and PDFs to EPUB format for Kindle.
+
+## Installation
+
+```bash
+pip install kindleify
+```
+
+## Usage
+
+### Convert URL to EPUB
+
+```bash
+kindleify url "https://example.com/article" -o article.epub
+```
+
+### Convert PDF to EPUB
+
+```bash
+kindleify pdf document.pdf -o book.epub
+```
+
+### Send to Kindle
+
+First, configure your Kindle email:
+
+```bash
+kindleify config set
+```
+
+Then send EPUB to your Kindle:
+
+```bash
+kindleify send book.epub
+```
+
+### Commands
+
+- `kindleify url` - Convert URL to EPUB
+- `kindleify pdf` - Convert PDF to EPUB
+- `kindleify send` - Send EPUB to Kindle
+- `kindleify config set` - Configure Kindle credentials
+- `kindleify config show` - Show current configuration
+- `kindleify config clear` - Clear stored credentials
+
+## License
+
+MIT

kindleify-0.1.0/src/kindleify.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+src/kindleify/cli.py
+src/kindleify/config.py
+src/kindleify/utils.py
+src/kindleify.egg-info/PKG-INFO
+src/kindleify.egg-info/SOURCES.txt
+src/kindleify.egg-info/dependency_links.txt
+src/kindleify.egg-info/entry_points.txt
+src/kindleify.egg-info/requires.txt
+src/kindleify.egg-info/top_level.txt
+src/kindleify/converter/epub_builder.py
+src/kindleify/converter/pdf.py
+src/kindleify/converter/url.py
+src/kindleify/delivery/kindle.py

kindleify-0.1.0/src/kindleify.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kindleify-0.1.0/src/kindleify.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kindleify = kindleify.cli:cli

kindleify-0.1.0/src/kindleify.egg-info/requires.txt

@@ -0,0 +1,8 @@
+click>=8.3.2
+ebooklib>=0.20
+pypdf>=4.0.0
+pillow>=12.0.0
+platformdirs>=4.0.0
+requests
+trafilatura
+twine>=6.2.0

kindleify-0.1.0/src/kindleify.egg-info/top_level.txt

@@ -0,0 +1 @@
+kindleify