formfeed (Python)
Client for the Formfeed API: template-based PDF and image
generation. Sync and async, built on httpx, pydantic models, retries on 429 and 503 with the
server's Retry-After, an Idempotency-Key on every render, typed errors and webhook verification.
pip install formfeed
from formfeed import Formfeed
client = Formfeed("ff_test_…") # region="us" or base_url="…" for other hosts
render = client.renders.create(template="invoice-de", data={"invoice": {"number": "2026-001"}})
open("invoice.pdf", "wb").write(client.renders.download(render))
job = client.renders.batch([{"data": d} for d in rows], template="invoice-de", zip=True)
job = client.jobs.wait_for(job.id)
from formfeed import AsyncFormfeed
async with AsyncFormfeed("ff_test_…") as client:
render = await client.renders.create(html="<h1>Hello</h1>", output="png")
Word and PowerPoint:
# a template is a .docx or .pptx with tags such as {{ customer.name }} in its text
with open("offer.docx", "rb") as f:
client.templates.create(name="Offer", slug="offer", kind="docx", engine="jinja2", file=f, publish=True)
filled = client.renders.create(template="offer", output="docx", data={"customer": {"name": "Olvarest GmbH"}})
# a new version with a new document; without file= the latest document is kept
with open("offer-v2.docx", "rb") as f:
client.templates.create_version("offer", file=f, change_note="New terms")
docx = client.templates.version_file("offer", "latest") # the document's bytes
# any office document to PDF (Word, Excel, PowerPoint, OpenDocument, RTF)
with open("report.xlsx", "rb") as f:
pdf = client.pdf.convert(file=f, single_page_sheets=True)
Webhooks:
from formfeed import parse_webhook_event
event = parse_webhook_event(secret, request.headers["Webhook-Signature"], request.body)
Errors raise FormfeedError with code, status, problem and request_id. Templates:
client.templates.all(), .version("invoice-de", "latest"), .create_version(...), .publish(...).
Documentation: https://docs.formfeed.dev/api/sdks/python
1 maintainer
Metadata
1 maintainer
Release files for formfeed 0.3.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| formfeed-0.3.17.tar.gz | 26.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| formfeed-0.3.17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.0 kB
Release files / formfeed-0.3.17.tar.gz
| Download URL | formfeed-0.3.17.tar.gz |
|---|---|
| Size | 26.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
022ac0e720b60faf21bd7b3c184a4df23d38dc4edb49baa386fc247f8dc16af5
|
|
BLAKE2b-256 checksum How to use checksums |
fde9080f8334d524b5dd98035ef3a32fe6460ea5bac690c98319984d98fd82e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logRelease files / formfeed-0.3.17-py3-none-any.whl
| Download URL | formfeed-0.3.17-py3-none-any.whl |
|---|---|
| Size | 20.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4d8406f9f15650f3355453e54741ed2b9b6f6e88bd079944a3e6aff69818a96f
|
|
BLAKE2b-256 checksum How to use checksums |
82c819ab0e4f479522055a1cb4b41c57b59054c87e9761a7d94b0c615c44bf4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency log
