funbrew-pdf 1.0.0__tar.gz

funbrew_pdf-1.0.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: funbrew-pdf
+Version: 1.0.0
+Summary: FUNBREW PDF API client for Python
+License: MIT
+Project-URL: Homepage, https://pdf.funbrew.cloud
+Project-URL: Documentation, https://pdf.funbrew.cloud/docs
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.28

funbrew_pdf-1.0.0/README.md

@@ -0,0 +1,84 @@
+# funbrew-pdf
+
+Official Python client library for the [FUNBREW PDF API](https://pdf.funbrew.cloud). Type hints included.
+
+[日本語ドキュメント](README.ja.md)
+
+## Installation
+
+```bash
+pip install funbrew-pdf
+```
+
+## Quick Start
+
+```python
+from funbrew_pdf import FunbrewPdf
+
+pdf = FunbrewPdf("sk-your-api-key")
+
+# HTML to PDF
+result = pdf.from_html("<h1>Hello World</h1>")
+print(result["data"]["download_url"])
+
+# URL to PDF
+result = pdf.from_url("https://example.com")
+
+# Template to PDF
+result = pdf.from_template("invoice", {
+    "company_name": "Acme Inc.",
+    "amount": "1,000",
+})
+```
+
+## Features
+
+```python
+# Generate PDF and send via email
+result = pdf.from_html_with_email(
+    "<h1>Invoice</h1>",
+    "customer@example.com",
+    subject="Your invoice is ready",
+)
+
+# Test mode (no count, TEST watermark)
+result = pdf.test("<h1>Test</h1>")
+
+# File operations
+info = pdf.info("uuid.pdf")
+content = pdf.download("uuid.pdf")
+with open("output.pdf", "wb") as f:
+    f.write(content)
+pdf.delete("uuid.pdf")
+
+# Usage stats
+usage = pdf.usage()
+```
+
+## Options
+
+```python
+result = pdf.from_html("<h1>Hello</h1>",
+    options={"page-size": "A3"},
+    expiration_hours=168,
+    max_downloads=5,
+    password="secret",
+    watermark="CONFIDENTIAL",
+)
+```
+
+## Error Handling
+
+```python
+from funbrew_pdf import FunbrewPdf, FunbrewError
+
+try:
+    result = pdf.from_html("<h1>Hello</h1>")
+except FunbrewError as e:
+    print(e)               # Error message
+    print(e.status_code)   # HTTP status code
+```
+
+## License
+
+MIT

funbrew_pdf-1.0.0/funbrew_pdf/__init__.py

@@ -0,0 +1,3 @@
+from .client import FunbrewPdf, FunbrewError
+
+__all__ = ["FunbrewPdf", "FunbrewError"]

funbrew_pdf-1.0.0/funbrew_pdf/client.py

@@ -0,0 +1,127 @@
+"""FUNBREW PDF API client for Python."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import requests
+
+
+class FunbrewError(Exception):
+    """FUNBREW PDF API error."""
+
+    def __init__(self, message: str, status_code: int = 0):
+        super().__init__(message)
+        self.status_code = status_code
+
+
+class FunbrewPdf:
+    """FUNBREW PDF API client.
+
+    Args:
+        api_key: Your API key (sk-...)
+        base_url: API base URL (default: https://pdf.funbrew.cloud)
+    """
+
+    def __init__(self, api_key: str, base_url: str = "https://pdf.funbrew.cloud"):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.session = requests.Session()
+        self.session.headers.update(
+            {
+                "Authorization": f"Bearer {api_key}",
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            }
+        )
+        self.session.timeout = 60
+
+    def from_html(self, html: str, **options: Any) -> dict:
+        """Generate PDF from HTML content."""
+        return self._post("/api/pdf/generate-from-html", {"html": html, **options})
+
+    def from_url(self, url: str, **options: Any) -> dict:
+        """Generate PDF from URL."""
+        return self._post("/api/pdf/generate-from-url", {"url": url, **options})
+
+    def from_template(
+        self, slug: str, variables: dict | None = None, **options: Any
+    ) -> dict:
+        """Generate PDF from template."""
+        return self._post(
+            "/api/pdf/generate-from-template",
+            {"template": slug, "variables": variables or {}, **options},
+        )
+
+    def from_html_with_email(
+        self,
+        html: str,
+        to: str,
+        subject: str = "",
+        body: str = "",
+        **options: Any,
+    ) -> dict:
+        """Generate PDF and send via email."""
+        email: dict[str, str] = {"to": to}
+        if subject:
+            email["subject"] = subject
+        if body:
+            email["body"] = body
+        return self.from_html(html, email=email, **options)
+
+    def info(self, filename: str) -> dict:
+        """Get PDF file info."""
+        return self._get(f"/api/pdf/info/{filename}")
+
+    def download(self, filename: str) -> bytes:
+        """Download PDF file content as bytes."""
+        res = self.session.get(f"{self.base_url}/api/pdf/download/{filename}")
+        if not res.ok:
+            raise FunbrewError("Download failed", res.status_code)
+        return res.content
+
+    def delete(self, filename: str) -> dict:
+        """Delete PDF file."""
+        return self._request("DELETE", f"/api/pdf/delete/{filename}")
+
+    def batch(self, items: list[dict]) -> dict:
+        """Batch generate multiple PDFs."""
+        return self._post("/api/pdf/batch", {"items": items})
+
+    def batch_status(self, batch_uuid: str) -> dict:
+        """Get batch generation status."""
+        return self._get(f"/api/pdf/batch/{batch_uuid}")
+
+    def merge(self, filenames: list[str], **options: Any) -> dict:
+        """Merge multiple PDFs into one."""
+        return self._post("/api/pdf/merge", {"filenames": filenames, **options})
+
+    def usage(self) -> dict:
+        """Get usage information."""
+        return self._get("/api/usage")
+
+    def test(self, html: str, **options: Any) -> dict:
+        """Generate PDF in test mode (no count, TEST watermark)."""
+        return self.from_html(html, test=True, **options)
+
+    def _get(self, path: str) -> dict:
+        return self._request("GET", path)
+
+    def _post(self, path: str, data: dict) -> dict:
+        return self._request("POST", path, data)
+
+    def _request(self, method: str, path: str, data: dict | None = None) -> dict:
+        try:
+            res = self.session.request(
+                method,
+                f"{self.base_url}{path}",
+                json=data if method != "GET" else None,
+            )
+            body = res.json()
+            if not res.ok:
+                raise FunbrewError(
+                    body.get("message", "API request failed"), res.status_code
+                )
+            return body
+        except requests.RequestException as e:
+            raise FunbrewError(f"Network error: {e}") from e

funbrew_pdf-1.0.0/funbrew_pdf.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: funbrew-pdf
+Version: 1.0.0
+Summary: FUNBREW PDF API client for Python
+License: MIT
+Project-URL: Homepage, https://pdf.funbrew.cloud
+Project-URL: Documentation, https://pdf.funbrew.cloud/docs
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.28

funbrew_pdf-1.0.0/funbrew_pdf.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+funbrew_pdf/__init__.py
+funbrew_pdf/client.py
+funbrew_pdf.egg-info/PKG-INFO
+funbrew_pdf.egg-info/SOURCES.txt
+funbrew_pdf.egg-info/dependency_links.txt
+funbrew_pdf.egg-info/requires.txt
+funbrew_pdf.egg-info/top_level.txt

funbrew_pdf-1.0.0/funbrew_pdf.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

funbrew_pdf-1.0.0/funbrew_pdf.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28

funbrew_pdf-1.0.0/funbrew_pdf.egg-info/top_level.txt

@@ -0,0 +1 @@
+funbrew_pdf

funbrew_pdf-1.0.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "funbrew-pdf"
+version = "1.0.0"
+description = "FUNBREW PDF API client for Python"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+dependencies = ["requests>=2.28"]
+
+[project.urls]
+Homepage = "https://pdf.funbrew.cloud"
+Documentation = "https://pdf.funbrew.cloud/docs"

funbrew_pdf-1.0.0/setup.cfg

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