Metadata-Version: 2.4
Name: inkpdf-client
Version: 0.1.0
Summary: Official Python client for InkPDF — the developer-first PDF API. HTML, URLs, Markdown, and JSON templates in; pixel-perfect PDFs out.
Project-URL: Homepage, https://inkpdf.dev
Project-URL: Documentation, https://inkpdf.dev/docs
Author-email: InkPDF <hello@inkpdf.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

# inkpdf-client

Official Python client for [InkPDF](https://inkpdf.dev) — the developer-first PDF API.
Zero dependencies (stdlib only), Python 3.9+.

```bash
pip install inkpdf-client
```

(The PyPI name is `inkpdf-client`; the import is still `inkpdf`.)

```python
from inkpdf import InkPDF

client = InkPDF("ink_live_...")  # free key at inkpdf.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 [inkpdf.dev](https://inkpdf.dev/#get-key).
Full API reference: [inkpdf.dev/docs](https://inkpdf.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
```
