pura-webp 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 02daf4b19a84439a95985701909b9a269cfa02c74932440abe0cb2e369c66669
-  data.tar.gz: addad87ed565e4f4ffb906f03a50894737829dabf598180b76240c586b847266
+  metadata.gz: 2538adf66ffb7ef7b402415e4fa5d652bd9cea83047161bedf9238e360f8410c
+  data.tar.gz: 8811664f3f74080d52de15245dd4f53d42e02103a4b6d182aeaf82fae06573aa
 SHA512:
-  metadata.gz: 3ec5fd7e14f33bea4582eeee83462b2ae6eaf880f45822a073df095ed0720dff8716740a94570a17a5c903b5cce5eac0cc378b602626ea2aea9e27a1fae003bf
-  data.tar.gz: 3e4d23bcd37b0bcfd1c5f2728affb2d8ab1425cbeeb658f1a92a0a26a428377d58a538007d26ee5193686b42ba1abf4c5f78cbaffa49aa5190671ffc34598ebb
+  metadata.gz: 59521cfe02f81816a6920d8db080f68cdc610571ac9281046fd8aecb858646e781fc017d9a208c8ce859d4a853fedd4db86f72e73a61930d25388d6cfd577a11
+  data.tar.gz: 2568ea7c17827bac6dad8dabf95e93d11505c9bd78be2ea43fe1b4657860ae15a33561b74123481aa58b605f9adc12cb576b2b269178124322c1e9c853edb3ea

data/README.md

@@ -1,6 +1,6 @@
 # pura-webp
 
-A pure Ruby WebP decoder and encoder with zero C extension dependencies.
+A pure Ruby WebP decoder and encoder without additional image-processing libraries.
 
 Part of the **pura-*** series — pure Ruby image codec gems.
 
@@ -8,7 +8,7 @@ Part of the **pura-*** series — pure Ruby image codec gems.
 
 - VP8 lossy WebP decoding
 - VP8L lossless WebP encoding
-- No native extensions, no FFI, no external dependencies
+- No image-specific native extension or FFI dependency
 - CLI tool included
 
 ## Installation
@@ -39,6 +39,8 @@ Pura::Webp.encode(thumb, "thumb.webp")
 
 ## Benchmark
 
+These historical measurements include ffmpeg process startup. They do not compare against an in-process C codec or establish Rails pipeline throughput.
+
 Decode performance on a 400×400 WebP image, Ruby 4.0.2 + YJIT:
 
 | Operation | pura-webp | ffmpeg (C + SIMD) | vs ffmpeg |
@@ -48,8 +50,6 @@ Decode performance on a 400×400 WebP image, Ruby 4.0.2 + YJIT:
 ## Why pure Ruby?
 
 - **`gem install` and go** — no `brew install webp`, no `apt install libwebp-dev`
-- **Works everywhere Ruby works** — CRuby, ruby.wasm, mruby, JRuby, TruffleRuby
-- **Edge/Wasm ready** — browsers (ruby.wasm), sandboxed environments
 - **No system library needed** — unlike every other Ruby WebP solution
 
 ## Current Limitations
@@ -71,6 +71,12 @@ Decode performance on a 400×400 WebP image, Ruby 4.0.2 + YJIT:
 | **pura-webp** | **WebP** | ✅ |
 | [pura-image](https://github.com/komagata/pura-image) | All formats | ✅ |
 
+## Pixel model and limitations
+
+Images contain 8-bit RGB pixels. The encoder produces VP8L, which this decoder cannot read back yet. Decoded pixels are RGB and do not retain alpha. Multi-partition VP8 frames are also unsupported.
+
+`crop(x, y, width, height)` requires integer coordinates, positive dimensions, and a region entirely inside the image; invalid regions raise `ArgumentError`.
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

data/lib/pura/webp/image.rb

@@ -81,6 +81,11 @@ module Pura
       end
 
       def crop(x, y, w, h)
+        unless [x, y, w, h].all?(Integer) &&
+               x >= 0 && y >= 0 && w.positive? && h.positive? && x + w <= @width && y + h <= @height
+          raise ArgumentError, "crop must be a positive integer region within the image"
+        end
+
         out = String.new(encoding: Encoding::BINARY, capacity: w * h * 3)
         h.times do |row|
           src_offset = (((y + row) * @width) + x) * 3

data/lib/pura/webp/version.rb

@@ -2,6 +2,6 @@
 
 module Pura
   module Webp
-    VERSION = "0.2.0"
+    VERSION = "0.2.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pura-webp
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - komagata