pura-jpeg 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b497cc2d62e912f13269111752139cdede385a5a4f0fb0a020743c9270f969a6
-  data.tar.gz: 6712cb8189a06cfd4ea1fe4af6c0dbd713d286f79acd29e24f0e9123c4f09843
+  metadata.gz: d1b5a78d34756e46d68ef37832cba567cf899b60d35d7a02e995a97bf51c8fb9
+  data.tar.gz: adbfcacde61c32ffae7f65bdc8cc362a811f03591815581d98548e977d761814
 SHA512:
-  metadata.gz: 533b5753fb406eac2f2590b719cba7d1ab282ccbadf333fbb16b51bc35432b9e436552f85d9fd30336f6028b46f98fcfa879ce40d4957ee006591c60d99fa1d8
-  data.tar.gz: a4f52d7145e529abd3c12ea8363d5f36fc3853f3095c1f82f953dbe098eeabd4859422678a5bc68755beca89c4577e9c6571ee90ef8fd4d201fb0de4a422ed9b
+  metadata.gz: 5bf8ab077fcd23611500408b81ae7b2f378e53eab58032672b4d43804bf9976e6a8c1080821416b278a4b995077c7d4ba67b1b84f9f9c54f2a82a67cf3acfe26
+  data.tar.gz: 7530e39696e9ede62cfade0d890b5f2c963d8d984d70cbe174818126987cffd7478a8e233ae3193df3364cd2304c63e64434ff88dfe218c45611a110acf01e27

data/README.md

@@ -1,6 +1,6 @@
 # pura-jpeg
 
-A pure Ruby JPEG decoder/encoder with zero C extension dependencies.
+A pure Ruby JPEG decoder/encoder without additional image-processing libraries.
 
 Part of the **pura-*** series — pure Ruby image codec gems.
 
@@ -10,7 +10,7 @@ Part of the **pura-*** series — pure Ruby image codec gems.
 - Image resizing (bilinear / nearest-neighbor interpolation)
 - Huffman coding, fast integer IDCT/FDCT, YCbCr ↔ RGB conversion
 - 4:2:0, 4:2:2, and 4:4:4 chroma subsampling
-- No native extensions, no FFI, no external dependencies
+- No image-specific native extension or FFI dependency
 - CLI tool included
 
 ## Installation
@@ -48,6 +48,8 @@ pura-jpeg resize input.jpg --fit 800x600 --out fitted.jpg
 
 ## Benchmark
 
+These historical measurements include ffmpeg process startup. They do not compare against an in-process C codec or establish Rails pipeline throughput.
+
 400×400 image, Ruby 4.0.2 + YJIT.
 
 ### Decode
@@ -75,13 +77,10 @@ pura-jpeg resize input.jpg --fit 800x600 --out fitted.jpg
 | Encode (quality 85) | 243 ms |
 | Full pipeline | ~547 ms |
 
-pura-jpeg is **2× faster than ptjd** (Tcl) and within **2× of jpeg-js running without JIT**. These are the only three pure scripting-language JPEG implementations that exist — Python, Perl, PHP, and Lua all rely on C extensions.
 
 ## Why pure Ruby?
 
 - **`gem install` and go** — no `brew install`, no `apt install`, no C compiler needed
-- **Works everywhere Ruby works** — CRuby, ruby.wasm, mruby, JRuby, TruffleRuby
-- **Edge/Wasm ready** — runs in Cloudflare Workers, browsers (via ruby.wasm), sandboxed environments where you can't install system libraries
 - **Perfect for dev/CI** — no ImageMagick or libvips setup. `rails new` → image upload → it just works
 - **Unix philosophy** — one format, one gem, composable
 
@@ -98,6 +97,12 @@ pura-jpeg is **2× faster than ptjd** (Tcl) and within **2× of jpeg-js running
 | [pura-webp](https://github.com/komagata/pura-webp) | WebP | ✅ Available |
 | [pura-image](https://github.com/komagata/pura-image) | All formats | ✅ Available |
 
+## Pixel model and limitations
+
+Images contain 8-bit RGB pixels. Baseline JPEG only; progressive JPEG is unsupported. EXIF orientation and color profiles are not applied or retained. `decode` accepts a file path or a binary JPEG string.
+
+`crop(x, y, width, height)` requires integer coordinates, positive dimensions, and a region entirely inside the image; invalid regions raise `ArgumentError`.
+
 ## License
 
 MIT

data/lib/pura/jpeg/decoder.rb

@@ -29,7 +29,11 @@ module Pura
       end
 
       def self.decode(input)
-        data = input.is_a?(String) && File.exist?(input) ? File.binread(input) : input
+        data = if input.is_a?(String) && !input.include?("\0") && input.bytesize < 4096 && File.exist?(input)
+                 File.binread(input)
+               else
+                 input
+               end
         new(data).decode
       end
 
@@ -527,7 +531,7 @@ module Pura
         0,  1, 8, 16, 9, 2, 3, 10,
         17, 24, 32, 25, 18, 11, 4, 5,
         12, 19, 26, 33, 40, 48, 41, 34,
-        27, 20, 13,  6,  7, 14, 21, 28,
+        27, 20, 13, 6,  7, 14, 21, 28,
         35, 42, 49, 56, 57, 50, 43, 36,
         29, 22, 15, 23, 30, 37, 44, 51,
         58, 59, 52, 45, 38, 31, 39, 46,

data/lib/pura/jpeg/encoder.rb

@@ -5,12 +5,12 @@ module Pura
     class Encoder
       # Standard JPEG luminance quantization table (ITU-T T.81, Annex K)
       LUMINANCE_QUANT_TABLE = [
-        16, 11, 10, 16,  24,  40,  51,  61,
-        12, 12, 14, 19,  26,  58,  60,  55,
-        14, 13, 16, 24,  40,  57,  69,  56,
-        14, 17, 22, 29,  51,  87,  80,  62,
-        18, 22, 37, 56,  68, 109, 103,  77,
-        24, 35, 55, 64,  81, 104, 113,  92,
+        16, 11, 10, 16, 24, 40, 51, 61,
+        12, 12, 14, 19, 26, 58, 60, 55,
+        14, 13, 16, 24, 40, 57, 69, 56,
+        14, 17, 22, 29, 51, 87, 80, 62,
+        18, 22, 37, 56, 68, 109, 103, 77,
+        24, 35, 55, 64, 81, 104, 113, 92,
         49, 64, 78, 87, 103, 121, 120, 101,
         72, 92, 95, 98, 112, 100, 103, 99
       ].freeze

data/lib/pura/jpeg/image.rb

@@ -87,6 +87,11 @@ module Pura
 
       # Crop a region from the image
       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/jpeg/version.rb

@@ -2,6 +2,6 @@
 
 module Pura
   module Jpeg
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pura-jpeg
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - komagata