dynimg 0.1.14__tar.gz → 0.1.15__tar.gz

{dynimg-0.1.14 → dynimg-0.1.15}/.claude/settings.local.json

@@ -33,7 +33,9 @@
       "WebSearch",
       "Bash(.venv/bin/python:*)",
       "Bash(./scripts/snapshot-tests.sh:*)",
-      "Bash(bash -x scripts/snapshot-tests.sh:*)"
+      "Bash(bash -x scripts/snapshot-tests.sh:*)",
+      "Bash(head:*)",
+      "Bash(identify:*)"
     ]
   }
 }

dynimg-0.1.15/CLAUDE.md

@@ -0,0 +1,4 @@
+
+@.pearls/CLAUDE.md
+
+Use the ./output folder here to make test images and as an output location for all test images.

{dynimg-0.1.14 → dynimg-0.1.15}/Cargo.lock

@@ -26,6 +26,15 @@ dependencies = [
  "memchr",
 ]
 
+[[package]]
+name = "aligned-vec"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc890384c8602f339876ded803c97ad529f3842aba97f6392b3dba0dd171769b"
+dependencies = [
+ "equator",
+]
+
 [[package]]
 name = "alloc-no-stdlib"
 version = "2.0.4"
@@ -151,6 +160,27 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "archmage"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5778a98b0714014089227472fd4342aacbd581d58ab673cbba6f6bf9fb5b5cd"
+dependencies = [
+ "archmage-macros",
+ "bytemuck",
+]
+
+[[package]]
+name = "archmage-macros"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "80979662181a630a1e7a4f9f25174e990f44fc0c4e534e11c563fee10c9b8a1e"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
 [[package]]
 name = "arrayref"
 version = "0.3.9"
@@ -754,7 +784,7 @@ dependencies = [
 
 [[package]]
 name = "dynimg"
-version = "0.1.14"
+version = "0.1.15"
 dependencies = [
  "anyhow",
  "anyrender",
@@ -766,7 +796,6 @@ dependencies = [
  "blitz-traits",
  "bytes",
  "clap",
- "image",
  "kurbo",
  "libc",
  "peniko",
@@ -776,6 +805,7 @@ dependencies = [
  "tokio",
  "tracing-subscriber",
  "webp",
+ "zenjpeg",
 ]
 
 [[package]]
@@ -793,6 +823,32 @@ dependencies = [
  "cfg-if",
 ]
 
+[[package]]
+name = "enough"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65641ff0923e45cf34a4cb0115080cb7fc8bf4fd419c2207670d5722bab4c581"
+
+[[package]]
+name = "equator"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4711b213838dfee0117e3be6ac926007d7f433d7bbe33595975d4190cb07e6fc"
+dependencies = [
+ "equator-macro",
+]
+
+[[package]]
+name = "equator-macro"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "44f23cf4b44bfce11a86ace86f8a73ffdec849c9fd00a386a53d278bd9e81fb3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
 [[package]]
 name = "equivalent"
 version = "1.0.2"
@@ -1522,6 +1578,12 @@ version = "0.14.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "09e54e57b4c48b40f7aec75635392b12b3421fa26fe8b4332e63138ed278459c"
 
+[[package]]
+name = "imgref"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7c5cedc30da3a610cac6b4ba17597bdf7152cf974e8aab3afb3d54455e371c8"
+
 [[package]]
 name = "indexmap"
 version = "2.13.0"
@@ -1659,6 +1721,19 @@ dependencies = [
  "glob",
 ]
 
+[[package]]
+name = "linear-srgb"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "153732436b90b689934ad2d2997d5f0d2416163017ac76e6c0475dce9e7999c3"
+dependencies = [
+ "bytemuck",
+ "multiversed",
+ "multiversion",
+ "num-traits",
+ "wide",
+]
+
 [[package]]
 name = "linebender_resource_handle"
 version = "0.1.1"
@@ -1698,6 +1773,16 @@ version = "0.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "112b39cec0b298b6c1999fee3e31427f74f676e4cb9879ed1a121b43661a4154"
 
+[[package]]
+name = "magetypes"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79bcaaebc5420c1dfb6a2db979cf86c7f852fea4013de3920d0f0395ac9ea5a7"
+dependencies = [
+ "archmage",
+ "bytemuck",
+]
+
 [[package]]
 name = "malloc_size_of_derive"
 version = "0.1.3"
@@ -1803,6 +1888,39 @@ dependencies = [
  "windows-sys 0.61.2",
 ]
 
+[[package]]
+name = "multiversed"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "31eede710ee60ecb1708685a9d948d25a67ee3940ee8a1096431590cb21eef7d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "multiversion"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7edb7f0ff51249dfda9ab96b5823695e15a052dc15074c9dbf3d118afaf2c201"
+dependencies = [
+ "multiversion-macros",
+ "target-features",
+]
+
+[[package]]
+name = "multiversion-macros"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b093064383341eb3271f42e381cb8f10a01459478446953953c75d24bd339fc0"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "target-features",
+]
+
 [[package]]
 name = "new_debug_unreachable"
 version = "1.0.6"
@@ -1851,6 +1969,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
 dependencies = [
  "autocfg",
+ "libm",
 ]
 
 [[package]]
@@ -2444,6 +2563,15 @@ dependencies = [
  "tower-service",
 ]
 
+[[package]]
+name = "rgb"
+version = "0.8.52"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c6a884d2998352bb4daf0183589aec883f16a6da1f4dde84d8e2e9a5409a1ce"
+dependencies = [
+ "bytemuck",
+]
+
 [[package]]
 name = "ring"
 version = "0.17.14"
@@ -2566,6 +2694,21 @@ version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a50f4cf475b65d88e057964e0e9bb1f0aa9bbb2036dc65c64596b42932536984"
 
+[[package]]
+name = "safe_arch"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f7caad094bd561859bcd467734a720c3c1f5d1f338995351fefe2190c45efed"
+dependencies = [
+ "bytemuck",
+]
+
+[[package]]
+name = "safe_unaligned_simd"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c1d612ce01a584cfab72164fb3f689112249fafeab7b4181c14601d19b34cb0a"
+
 [[package]]
 name = "same-file"
 version = "1.0.6"
@@ -3098,6 +3241,12 @@ dependencies = [
  "slotmap",
 ]
 
+[[package]]
+name = "target-features"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c1bbb9f3c5c463a01705937a24fdabc5047929ac764b2d5b9cf681c1f5041ed5"
+
 [[package]]
 name = "target-lexicon"
 version = "0.13.4"
@@ -3784,6 +3933,22 @@ version = "0.1.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a28ac98ddc8b9274cb41bb4d9d4d5c425b6020c50c46f25559911905610b4a88"
 
+[[package]]
+name = "whereat"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ec598a1ade4224cfe3c5dace0d5d7deec9ed670503ff99d4946973c8c094534"
+
+[[package]]
+name = "wide"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac11b009ebeae802ed758530b6496784ebfee7a87b9abfbcaf3bbe25b814eb25"
+dependencies = [
+ "bytemuck",
+ "safe_arch",
+]
+
 [[package]]
 name = "winapi-util"
 version = "0.1.11"
@@ -4210,6 +4375,39 @@ dependencies = [
  "synstructure",
 ]
 
+[[package]]
+name = "yuv"
+version = "0.8.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "447d8234fba933a5198401c673607dd75758bab32136766da61711cc362294e9"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "zenjpeg"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7bbccbe8dcf2cc21579981070905b6120ec82a45aa92b1715d28e05941390c50"
+dependencies = [
+ "aligned-vec",
+ "archmage",
+ "bytemuck",
+ "enough",
+ "imgref",
+ "linear-srgb",
+ "magetypes",
+ "multiversed",
+ "multiversion",
+ "rgb",
+ "safe_unaligned_simd",
+ "thiserror 2.0.18",
+ "tinyvec",
+ "whereat",
+ "wide",
+ "yuv",
+]
+
 [[package]]
 name = "zeno"
 version = "0.3.3"

{dynimg-0.1.14 → dynimg-0.1.15}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dynimg"
-version = "0.1.14"
+version = "0.1.15"
 edition = "2024"
 description = "A fast library and CLI for rendering HTML/CSS to images"
 license = "MIT"
@@ -48,7 +48,7 @@ clap = { version = "4", features = ["derive"] }
 
 # Image encoding
 png = "0.18"
-image = { version = "0.25", default-features = false, features = ["jpeg"] }
+zenjpeg = "0.4"
 webp = "0.3"
 
 # Async runtime (needed for blitz-net)

{dynimg-0.1.14 → dynimg-0.1.15}/Makefile

@@ -11,7 +11,7 @@ dev:
 # Run tests
 test: install
 	cargo test
-	python test_wheels/test_dynimg.py
+	.venv/bin/python test_wheels/test_dynimg.py
 	./scripts/snapshot-tests.sh
 
 # Run lints

{dynimg-0.1.14 → dynimg-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dynimg
-Version: 0.1.14
+Version: 0.1.15
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -28,10 +28,20 @@ A fast library and CLI for rendering HTML/CSS to images. Use from Python, Rust,
 
 Perfect for generating dynamic images like Open Graph (OG) images, social media cards, email headers, and more.
 
+## Example Output
+
+<table>
+<tr>
+<td><img src="tests/snapshots/og-image.png" width="400" alt="OG Image Example"></td>
+<td><img src="tests/snapshots/social-card.png" width="400" alt="Social Card Example"></td>
+</tr>
+</table>
+
 ## Features
 
 - **Python + Rust + CLI**: Use from Python, as a Rust library, or command-line tool
 - **Multiple output formats**: PNG, WebP (lossless), and JPEG
+- **Transparent backgrounds**: PNG and WebP support transparency (JPEG uses white)
 - **High-quality rendering**: Configurable scale factor for retina displays
 - **Fast**: Native Rust performance with no browser overhead
 - **Secure by default**: Network and filesystem access disabled unless explicitly enabled
@@ -103,7 +113,8 @@ let options = RenderOptions::default()
     .height(630)
     .scale(2.0)
     .allow_net()
-    .assets_dir("./assets");
+    .assets_dir("./assets")
+    .background("#ffffff");  // CSS hex color (default: transparent)
 
 // Or struct initialization
 let options = RenderOptions {
@@ -113,6 +124,7 @@ let options = RenderOptions {
     allow_net: true,
     assets_dir: Some("./assets".into()),
     base_url: None,
+    background: Some("#ffffff".into()),  // None = transparent
 };
 ```
 
@@ -138,16 +150,32 @@ dynimg input.html -o output.png
 ### Output Formats
 
 ```bash
-# PNG (lossless)
+# PNG (lossless, supports transparency)
 dynimg input.html -o image.png
 
-# WebP (lossless)
+# WebP (lossless, supports transparency)
 dynimg input.html -o image.webp
 
-# JPEG (lossy)
+# JPEG (lossy, no transparency - uses white background)
 dynimg input.html -o image.jpg --quality 90
 ```
 
+### Transparent Backgrounds
+
+PNG and WebP output supports transparent backgrounds. Simply don't set a background on your HTML body:
+
+```html
+<body style="padding: 20px;">
+  <div style="background: white; border-radius: 8px; padding: 20px;">
+    Content with transparent surrounding area
+  </div>
+</body>
+```
+
+<img src="tests/snapshots/transparent.png" width="300" alt="Transparent background example">
+
+JPEG doesn't support transparency, so it automatically uses a white background.
+
 ### Image Dimensions
 
 The `--width` and `--height` options set the **viewport size** (CSS layout dimensions). The actual output image is scaled by the `--scale` factor (default: 2x for high-DPI/retina displays).
@@ -279,6 +307,7 @@ options = dynimg.RenderOptions(
     allow_net=True,      # Allow network requests (default: False)
     assets_dir="./assets",  # Local assets directory (default: None)
     base_url="https://example.com",  # Base URL for relative URLs (default: None)
+    background="#ffffff",  # CSS hex color (default: transparent)
 )
 
 image = dynimg.render(html, options)
@@ -318,7 +347,14 @@ You can configure rendering options directly in your HTML using meta tags. CLI f
 
 This is useful for templates that should always render at specific dimensions. Remember: the output image size is viewport × scale.
 
-## Example HTML Template
+## Example Templates
+
+### OG Image
+
+<img src="tests/snapshots/og-image.png" width="500" alt="OG Image Example">
+
+<details>
+<summary>View HTML</summary>
 
 ```html
 <!DOCTYPE html>
@@ -327,40 +363,99 @@ This is useful for templates that should always render at specific dimensions. R
   <meta name="dynimg:width" content="1200">
   <meta name="dynimg:height" content="630">
   <style>
-    * {
-        margin: 0;
-        padding: 0;
-        box-sizing: border-box;
-    }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: system-ui, -apple-system, sans-serif; }
     .container {
       width: 1200px;
       height: 630px;
       display: flex;
       flex-direction: column;
       justify-content: center;
-      align-items: center;
+      padding: 80px;
       background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-      font-family: system-ui, sans-serif;
     }
-    h1 {
+    h1 { color: white; font-size: 72px; font-weight: 700; line-height: 1.1; margin-bottom: 24px; }
+    p { color: rgba(255, 255, 255, 0.85); font-size: 32px; }
+    .footer { position: absolute; bottom: 40px; left: 80px; color: rgba(255, 255, 255, 0.6); font-size: 24px; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>Your Blog Post Title Here</h1>
+    <p>A compelling subtitle that captures attention</p>
+    <div class="footer">yoursite.com</div>
+  </div>
+</body>
+</html>
+```
+</details>
+
+### Social Card
+
+<img src="tests/snapshots/social-card.png" width="500" alt="Social Card Example">
+
+<details>
+<summary>View HTML</summary>
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta name="dynimg:width" content="1200">
+  <meta name="dynimg:height" content="675">
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: system-ui, -apple-system, sans-serif; }
+    .card {
+      width: 1200px;
+      height: 675px;
+      background: #0f172a;
+      display: flex;
+      padding: 60px;
+    }
+    .content { flex: 1; display: flex; flex-direction: column; justify-content: center; }
+    .tag {
+      display: inline-block;
+      background: #3b82f6;
       color: white;
-      font-size: 64px;
-      margin: 0;
+      padding: 8px 16px;
+      border-radius: 20px;
+      font-size: 18px;
+      font-weight: 600;
+      margin-bottom: 24px;
+      width: fit-content;
     }
-    p {
-      color: rgba(255,255,255,0.8);
-      font-size: 32px;
+    h1 { color: white; font-size: 56px; font-weight: 700; line-height: 1.2; margin-bottom: 20px; }
+    p { color: #94a3b8; font-size: 24px; line-height: 1.5; }
+    .avatar {
+      width: 200px;
+      height: 200px;
+      background: linear-gradient(135deg, #06b6d4, #3b82f6);
+      border-radius: 100px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      align-self: center;
+      margin-left: 60px;
     }
+    .avatar-text { color: white; font-size: 72px; font-weight: 700; }
   </style>
 </head>
 <body>
-  <div class="container">
-    <h1>Hello World</h1>
-    <p>Welcome to my site</p>
+  <div class="card">
+    <div class="content">
+      <span class="tag">Tutorial</span>
+      <h1>Getting Started with Rust</h1>
+      <p>Learn the fundamentals of Rust programming language with practical examples.</p>
+    </div>
+    <div class="avatar">
+      <span class="avatar-text">RS</span>
+    </div>
   </div>
 </body>
 </html>
 ```
+</details>
 
 ## Supported CSS Features
 
@@ -410,20 +505,23 @@ cargo fmt -- --check
 
 ## Releasing
 
-Releases are automated via GitHub Actions. To create a new release:
-
-1. Update the version in `Cargo.toml`
-2. Create and push a git tag:
+Releases are automated via a release script and GitHub Actions. To create a new release:
 
 ```bash
-git tag v0.1.0
-git push origin v0.1.0
+./scripts/release.sh
 ```
 
-This triggers the release workflow which:
+The script will:
+1. Verify you're on the main branch with a clean working directory
+2. Check that you're up to date with the remote
+3. Bump the patch version in `Cargo.toml` and `pyproject.toml`
+4. Commit the version changes and create an annotated tag
+5. Push the commit and tag to origin
+
+This triggers the GitHub Actions release workflow which:
 - Builds wheels for Linux (x86_64, aarch64) and macOS (x86_64, aarch64)
 - Creates a GitHub Release with all artifacts
-- (Optional) Publishes to PyPI (when enabled)
+- Publishes to PyPI
 
 ## License