Implements Pillow image generation example

Author: dom96

12-image-gen/README.md

@@ -0,0 +1,54 @@
+# Image Generation with Pillow Example
+
+This example demonstrates how to build a Python Worker that dynamically generates images using the Pillow (PIL) library. It showcases various image generation techniques perfect for creating dynamic graphics, badges, placeholders, and charts on-the-fly.
+
+## What It Does
+
+The Worker provides four different image generation endpoints:
+1. **Gradient Generator** (`/gradient`) - Creates beautiful gradient images with customizable colors and dimensions
+2. **Badge Generator** (`/badge`) - Generates custom badges or buttons with text
+3. **Placeholder Generator** (`/placeholder`) - Creates placeholder images with dimensions displayed (like placehold.it)
+4. **Chart Generator** (`/chart`) - Produces simple bar charts with custom data
+
+This example showcases how to use the Pillow library in Python Workers to manipulate images, draw shapes, render text, and return binary image data.
+
+## How to Run
+
+First ensure that `uv` is installed:
+https://docs.astral.sh/uv/getting-started/installation/#standalone-installer
+
+Now, if you run `uv run pywrangler dev` within this directory, it should use the config
+in `wrangler.jsonc` to run the example.
+
+```bash
+uv run pywrangler dev
+```
+
+Then visit:
+- `http://localhost:8787/` - Interactive demo page with all examples
+- `http://localhost:8787/gradient?width=600&height=300&color1=FF6B6B&color2=4ECDC4` - Gradient image
+- `http://localhost:8787/badge?text=Python+Workers&bg_color=2196F3` - Custom badge
+- `http://localhost:8787/placeholder?width=500&height=300` - Placeholder image
+- `http://localhost:8787/chart?values=15,30,25,40,20&labels=Mon,Tue,Wed,Thu,Fri` - Bar chart
+
+## Deployment
+
+Deploy to Cloudflare Workers:
+
+```bash
+uv run pywrangler deploy
+```
+
+## Key Pillow Features Demonstrated
+
+- **Image Creation** - `Image.new()` for creating blank canvases
+- **Drawing Shapes** - `ImageDraw` for lines, rectangles, and more
+- **Text Rendering** - `ImageFont` and `draw.text()` for adding text
+- **Color Manipulation** - RGB color interpolation for gradients
+- **Binary Output** - Converting images to bytes for HTTP responses
+
+## Learn More
+
+- [Pillow Documentation](https://pillow.readthedocs.io/)
+- [Python Workers Documentation](https://developers.cloudflare.com/workers/languages/python/)
+- [ImageDraw Reference](https://pillow.readthedocs.io/en/stable/reference/ImageDraw.html)

12-image-gen/package.json

@@ -0,0 +1,13 @@
+{
+	"name": "python-image-gen",
+	"version": "0.0.0",
+	"private": true,
+	"scripts": {
+		"deploy": "uv run pywrangler deploy",
+		"dev": "uv run pywrangler dev",
+		"start": "uv run pywrangler dev"
+	},
+	"devDependencies": {
+		"wrangler": "^4.46.0"
+	}
+}

12-image-gen/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "python-image-gen"
+version = "0.1.0"
+description = "Python image generation example using Pillow"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "webtypy>=0.1.7",
+    "pillow",
+]
+
+[dependency-groups]
+dev = [
+    "workers-py",
+    "workers-runtime-sdk"
+]