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.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| formfeed-0.3.18.tar.gz | 26.1 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| formfeed-0.3.18-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.0 kB
Release files / formfeed-0.3.18.tar.gz
| Download URL | formfeed-0.3.18.tar.gz |
|---|---|
| Size | 26.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bcec1ae2613d264b352ca95605a181cedbfa38fe2ac23a1289b1495b1936b7ea
|
|
BLAKE2b-256 checksum How to use checksums |
6ac58272e5c5bb5b72a16a330a579e87e686129cddf7ff814c27c550ca6284cb
|
| 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 19, 2026.
Transparency logRelease files / formfeed-0.3.18-py3-none-any.whl
| Download URL | formfeed-0.3.18-py3-none-any.whl |
|---|---|
| Size | 20.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
440791feba9db062d2cb015b048724bab91d705d69cab7acb3ef83cd0978fbe8
|
|
BLAKE2b-256 checksum How to use checksums |
b4ea2e4df48ff2a63682e6d31b5eee3e9d10546a4472c7a8186f110bb264f72d
|
| 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 19, 2026.
Transparency logSecurity for formfeed 0.3.18
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for formfeed-0.3.18.tar.gz
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 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
