pdfwright 0.1.0__tar.gz

pdfwright-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+node_modules/
+data/
+dist/
+.env
+.env.local
+*.local.json
+test-output/
+*.pdf
+!docs/**/*.pdf
+.DS_Store
+Thumbs.db

pdfwright-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: pdfwright
+Version: 0.1.0
+Summary: Official Python client for PDFwright — the developer-first PDF API. HTML, URLs, Markdown, and JSON templates in; pixel-perfect PDFs out.
+Project-URL: Homepage, https://pdfwright.dev
+Project-URL: Documentation, https://pdfwright.dev/docs
+Author-email: PDFwright <hello@pdfwright.dev>
+License-Expression: MIT
+Keywords: html-to-pdf,invoice,markdown-to-pdf,pdf,pdf-api,pdf-generation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# pdfwright
+
+Official Python client for [PDFwright](https://pdfwright.dev) — the developer-first PDF API.
+Zero dependencies (stdlib only), Python 3.9+.
+
+```bash
+pip install pdfwright
+```
+
+(Package and module are both `pdfwright`.)
+
+```python
+from pdfwright import PDFwright
+
+client = PDFwright("pdfw_live_...")  # free key at pdfwright.dev
+
+# HTML → PDF
+open("hello.pdf", "wb").write(client.html("<h1>Hello!</h1>", format="Letter"))
+
+# JSON → invoice (totals & tax computed for you)
+pdf = client.invoice({
+    "brand": {"name": "Acme Studio", "color": "#0f766e"},
+    "invoiceNumber": "INV-2043",
+    "currency": "USD",
+    "to": {"name": "Northwind Traders"},
+    "items": [{"description": "Design work", "quantity": 10, "unitPrice": 95}],
+    "taxRate": 8.5,
+})
+
+# Markdown → styled PDF
+client.markdown("# Q2 Report\n\nRevenue grew **12%**.", theme="serif")
+
+# Check your quota
+print(client.usage())  # {'plan': ..., 'used': ..., 'remaining': ...}
+```
+
+Get a free API key (50 PDFs/month) at [pdfwright.dev](https://pdfwright.dev/#get-key).
+Full API reference: [pdfwright.dev/docs](https://pdfwright.dev/docs).
+
+## Publishing (maintainer note)
+
+```bash
+cd clients/python
+python -m pip install build twine
+python -m build
+python -m twine upload dist/*   # requires a PyPI account/token
+```

pdfwright-0.1.0/README.md

@@ -0,0 +1,47 @@
+# pdfwright
+
+Official Python client for [PDFwright](https://pdfwright.dev) — the developer-first PDF API.
+Zero dependencies (stdlib only), Python 3.9+.
+
+```bash
+pip install pdfwright
+```
+
+(Package and module are both `pdfwright`.)
+
+```python
+from pdfwright import PDFwright
+
+client = PDFwright("pdfw_live_...")  # free key at pdfwright.dev
+
+# HTML → PDF
+open("hello.pdf", "wb").write(client.html("<h1>Hello!</h1>", format="Letter"))
+
+# JSON → invoice (totals & tax computed for you)
+pdf = client.invoice({
+    "brand": {"name": "Acme Studio", "color": "#0f766e"},
+    "invoiceNumber": "INV-2043",
+    "currency": "USD",
+    "to": {"name": "Northwind Traders"},
+    "items": [{"description": "Design work", "quantity": 10, "unitPrice": 95}],
+    "taxRate": 8.5,
+})
+
+# Markdown → styled PDF
+client.markdown("# Q2 Report\n\nRevenue grew **12%**.", theme="serif")
+
+# Check your quota
+print(client.usage())  # {'plan': ..., 'used': ..., 'remaining': ...}
+```
+
+Get a free API key (50 PDFs/month) at [pdfwright.dev](https://pdfwright.dev/#get-key).
+Full API reference: [pdfwright.dev/docs](https://pdfwright.dev/docs).
+
+## Publishing (maintainer note)
+
+```bash
+cd clients/python
+python -m pip install build twine
+python -m build
+python -m twine upload dist/*   # requires a PyPI account/token
+```

pdfwright-0.1.0/pdfwright/__init__.py

@@ -0,0 +1,107 @@
+"""Official Python client for PDFwright — https://pdfwright.dev/docs
+
+Zero dependencies (stdlib urllib only), Python 3.9+.
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from typing import Any, Optional
+
+__all__ = ["PDFwright", "PDFwrightError"]
+__version__ = "0.1.0"
+
+
+class PDFwrightError(Exception):
+    """Raised when the API returns an error response."""
+
+    def __init__(self, message: str, status: Optional[int] = None, code: Optional[str] = None):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+
+class PDFwright:
+    """Client for the PDFwright rendering API.
+
+    >>> pdfwright = PDFwright("pdfw_live_...")
+    >>> pdf_bytes = pdfwright.html("<h1>Hello!</h1>")
+    >>> open("hello.pdf", "wb").write(pdf_bytes)
+    """
+
+    def __init__(self, api_key: str, base_url: str = "https://pdfwright.dev", timeout: float = 60.0):
+        if not api_key:
+            raise PDFwrightError("An API key is required (get one free at pdfwright.dev)")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    # ── core ──────────────────────────────────────────────────────────────
+
+    def render(self, **request: Any) -> bytes:
+        """Render a PDF. Provide exactly one of: html, url, markdown, template (+data)."""
+        req = urllib.request.Request(
+            f"{self.base_url}/v1/pdf",
+            data=json.dumps(request).encode("utf-8"),
+            headers={
+                "Authorization": f"Bearer {self.api_key}",
+                "Content-Type": "application/json",
+            },
+            method="POST",
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as res:
+                return res.read()
+        except urllib.error.HTTPError as e:
+            try:
+                body = json.loads(e.read().decode("utf-8"))
+            except Exception:
+                body = {}
+            raise PDFwrightError(
+                body.get("message", f"Render failed ({e.code})"),
+                status=e.code,
+                code=body.get("error"),
+            ) from None
+
+    # ── conveniences ──────────────────────────────────────────────────────
+
+    def html(self, html: str, **options: Any) -> bytes:
+        return self.render(html=html, options=options or None)
+
+    def url(self, url: str, **options: Any) -> bytes:
+        return self.render(url=url, options=options or None)
+
+    def markdown(self, markdown: str, theme: str = "clean", **options: Any) -> bytes:
+        return self.render(markdown=markdown, theme=theme, options=options or None)
+
+    def invoice(self, data: dict, **options: Any) -> bytes:
+        return self.render(template="invoice", data=data, options=options or None)
+
+    def receipt(self, data: dict, **options: Any) -> bytes:
+        return self.render(template="receipt", data=data, options=options or None)
+
+    def quote(self, data: dict, **options: Any) -> bytes:
+        return self.render(template="quote", data=data, options=options or None)
+
+    def report(self, data: dict, **options: Any) -> bytes:
+        return self.render(template="report", data=data, options=options or None)
+
+    def certificate(self, data: dict, **options: Any) -> bytes:
+        return self.render(template="certificate", data=data, options=options or None)
+
+    def usage(self) -> dict:
+        """Current plan/quota state."""
+        req = urllib.request.Request(
+            f"{self.base_url}/v1/usage",
+            headers={"Authorization": f"Bearer {self.api_key}"},
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as res:
+                return json.loads(res.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            body = json.loads(e.read().decode("utf-8"))
+            raise PDFwrightError(
+                body.get("message", "usage lookup failed"), status=e.code, code=body.get("error")
+            ) from None

pdfwright-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pdfwright"
+version = "0.1.0"
+description = "Official Python client for PDFwright — the developer-first PDF API. HTML, URLs, Markdown, and JSON templates in; pixel-perfect PDFs out."
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "PDFwright", email = "hello@pdfwright.dev" }]
+requires-python = ">=3.9"
+keywords = ["pdf", "html-to-pdf", "pdf-generation", "invoice", "pdf-api", "markdown-to-pdf"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://pdfwright.dev"
+Documentation = "https://pdfwright.dev/docs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["pdfwright"]