> ## Documentation Index
> Fetch the complete documentation index at: https://docs.featherframework.org/llms.txt
> Use this file to discover all available pages before exploring further.
# PDF generation
> WeasyPrint turns HTML and CSS into PDFs, so document layout uses the same skills as the rest of your app.
WeasyPrint ships with the `pdf` extra. It converts HTML and CSS to PDF, letting you use
familiar web technologies for document layout.
```bash theme={null}
pip install "feather-framework[pdf]"
```
## Basic usage
```python theme={null}
from io import BytesIO
from weasyprint import HTML
def generate_report(title, data):
html_content = f"""
{title}
| Item |
|---|
{''.join(f'| {row} |
' for row in data)}
"""
buffer = BytesIO()
HTML(string=html_content).write_pdf(buffer)
buffer.seek(0)
return buffer
```
Render the HTML with a Jinja2 template instead of an f-string once the document grows
past a few elements. You get the same escaping and partials as the rest of your views.
## Saving to storage
```python theme={null}
from feather.storage import get_storage
@api.get('/reports//pdf')
@auth_required
def download_report(id):
pdf_buffer = generate_report("Report", get_data(id))
storage = get_storage()
filename = f'reports/{id}.pdf'
storage.upload(pdf_buffer, filename, content_type='application/pdf')
url = storage.get_url(filename, expires_in=3600)
return {'url': url}
```
## Generating in the background
PDF rendering is slow enough to be worth moving off the request.
```python theme={null}
from feather import job
@job
def generate_report_async(report_id, user_id):
pdf_buffer = generate_report("Report", get_data(report_id))
storage = get_storage()
filename = f'reports/{user_id}/{report_id}.pdf'
storage.upload(pdf_buffer, filename, content_type='application/pdf')
return {'filename': filename}
result = generate_report_async.enqueue(report_id, user_id)
```