pillowstrap 1.0.1

A Bootstrap-like semantic wrapper for Python Pillow

PillowStrap

Bootstrap-like semantics for Python Image Generation.

PillowStrap is a wrapper around the Python Pillow (PIL) library. It replaces imperative coordinate math (e.g., x=150, y=300) with declarative, web-like semantics (e.g., row, col-6, text-center, bg-primary).

Stop calculating pixels. Start building layouts.

---

Features

• 12-Column Grid System: Just like Bootstrap, organize content into rows and columns.
• Auto-Stacking Text: No more manual Y-coordinate tracking. Text blocks stack automatically like a Word document.
• Smart Word Wrapping: Text automatically breaks to the next line if it exceeds the column width.
• Image Fit Utilities: Easily place images with cover or contain logic.
• Theming: Centralized control over colors, fonts, and spacing.

---

Installation

1. Directory Setup: Ensure your project looks like this:

   my_project/
   ├── pillowstrap/           <-- Source Code Folder
   │   ├── __init__.py
   │   └── theme.py
   ├── setup.py
   └── README.md
   

2. Install: Run this command in your terminal from the root folder:

   pip install .
   

---

Quick Start

Here is how to create a simple dashboard layout in seconds.

from pillowstrap import PillowStrap

# 1. Initialize Canvas (Width x Height)
app = PillowStrap(width=1200, height=800, bg="white")

# 2. Header Row (Height: 100px)
with app.row(height=100) as row:
    row.col(12, bg="primary").text("Monthly Report", color="white", size=50, align="center")

# 3. Content Row (Height: 500px)
with app.row(height=500) as row:
    
    # Left Column: Text (Spans 4 columns)
    ctx = row.col(4, bg="light")
    
    # Stacking Headers
    ctx.text("Executive Summary", size=30, weight="bold")
    ctx.text("Prepared by: Gemini", size=20, color="secondary")
    
    # Auto-Wrapping Body Text
    ctx.text(
        "PillowStrap handles long text automatically. "
        "You do not need to calculate line breaks manually. "
        "It respects the column width and padding.",
        size=24
    )

    # Right Column: Image (Spans 8 columns)
    # Places an image and crops it to fill the area
    row.col(8).img("charts.png", fit="cover")

# 4. Save
app.save("dashboard.png")