pura-image 0.2.2 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ca9e140b2d7fe143248deaf1eea3d18264a45d0dc7bee03aa1548d20c78f1f7
-  data.tar.gz: 4a1e12756cf11641681ba7c3d9fad052b26743d343932c0f8270377d7d35647e
+  metadata.gz: 5349acbd820a01a5adce41d49add96c50a8e91adc2555629e62268c0876531a5
+  data.tar.gz: 293af000448458dbb3554cf203b0eeccc8432516a768116cb7dab56a3a9a3472
 SHA512:
-  metadata.gz: 559a878030a06ce938cb386d0635cb6f5bc308606609fe0ff5de560ba14c9d2388c3788be425e13c767a1db40f4ec58eb616234f1825298f012befe38d5ea75b
-  data.tar.gz: ff0728e7ad559949670393bc0085563a29b2195ab66f0761d3ecae4ea5d021d82d8dee51018fb31d1935c17ae5c6aa122735268689bd077d8c21bfda94fd28fc
+  metadata.gz: 06aca37f6a3f060428b1f61dc62ceb39b073b71b7b5f8c3337d451bdc1aa0e95bd3c5b6ffb2a4f9cd610ec73f6e51bf55cadbaa61b1f7a016a705173d2f97bfd
+  data.tar.gz: 1864fdfa00abf7767c15c755a4d89211639695448192a0cee09b487029ebefd8096b4fb95d00d9c88de776c44f24ba900060a918c0f18344717b489c6b8594df

data/README.md

@@ -2,6 +2,33 @@
 
 Pure Ruby image processing library with **zero C extension dependencies**. Bundles all **pura-*** format gems and provides an `ImageProcessing` adapter for Rails Active Storage.
 
+## Why this exists (in 30 seconds)
+
+Stop installing system libraries just to resize an image in Rails.
+
+```diff
+# Gemfile
+  gem "image_processing"
++ gem "pura-image"
+```
+
+```ruby
+# config/application.rb
+config.active_storage.variant_processor = :pura
+```
+
+```diff
+# Dockerfile
+- RUN apt-get install -y libvips-dev imagemagick
+```
+
+That's it. No `brew install vips`. No `apt install imagemagick`. No C compiler. Works on macOS, Linux, Windows, Docker, CI, ruby.wasm — anywhere Ruby runs.
+
+- ✅ **Drop-in** for `ImageProcessing::Vips` / `ImageProcessing::MiniMagick`
+- ✅ **7 formats** — JPEG, PNG, BMP, GIF, TIFF, ICO/CUR, WebP
+- ✅ **Some operations are faster than C** (no process-spawn overhead — see [Benchmark](#benchmark))
+- ✅ **Runs on ruby.wasm, JRuby, TruffleRuby**
+
 ## Supported Formats
 
 | Format | Decode | Encode | Gem |
@@ -29,7 +56,7 @@ require "pura-image"
 
 # Load any format (auto-detected from magic bytes)
 image = Pura::Image.load("photo.jpg")
-image = Pura::Image.load("icon.webp")
+image = Pura::Image.load("logo.png")
 image.width   #=> 800
 image.height  #=> 600
 
@@ -132,7 +159,6 @@ ImageProcessing::Pura.valid_image?("photo.jpg")  #=> true
 | BMP | **39 ms** | 59 ms | 🚀 **1.5× faster** |
 | GIF | 77 ms | 65 ms | ~1× (comparable) |
 | PNG | 111 ms | 60 ms | 1.9× slower |
-| WebP | 207 ms | 66 ms | 3.1× slower |
 | JPEG | 304 ms | 55 ms | 5.5× slower |
 
 ### Encode

data/lib/pura/image/operations.rb

@@ -19,7 +19,7 @@ module Pura
       end
 
       def grayscale
-        new_pixels = String.new(encoding: Encoding::BINARY, capacity: @pixels.bytesize)
+        new_pixels = String.new(encoding: Encoding::BINARY)
         i = 0
         size = @pixels.bytesize
         while i < size
@@ -98,7 +98,7 @@ module Pura
       def rotate90
         new_w = @height
         new_h = @width
-        new_pixels = String.new(encoding: Encoding::BINARY, capacity: new_w * new_h * 3)
+        new_pixels = String.new(encoding: Encoding::BINARY)
 
         new_h.times do |y|
           new_w.times do |x|
@@ -111,7 +111,7 @@ module Pura
       end
 
       def rotate180
-        new_pixels = String.new(encoding: Encoding::BINARY, capacity: @pixels.bytesize)
+        new_pixels = String.new(encoding: Encoding::BINARY)
         (@height - 1).downto(0) do |y|
           (@width - 1).downto(0) do |x|
             offset = ((y * @width) + x) * 3
@@ -124,7 +124,7 @@ module Pura
       def rotate270
         new_w = @height
         new_h = @width
-        new_pixels = String.new(encoding: Encoding::BINARY, capacity: new_w * new_h * 3)
+        new_pixels = String.new(encoding: Encoding::BINARY)
 
         new_h.times do |y|
           new_w.times do |x|

data/lib/pura/image/processor.rb

@@ -86,7 +86,7 @@ module Pura
           when :tiff then Pura::Tiff.decode(path)
           when :ico  then Pura::Ico.decode(path)
           when :webp
-            raise ArgumentError, "WebP support not available" unless defined?(Pura::Webp)
+            raise ArgumentError, "WebP support requires the pura-webp gem" unless defined?(Pura::Webp)
 
             Pura::Webp.decode(path)
           else
@@ -114,7 +114,7 @@ module Pura
             ico_img = Pura::Ico::Image.new(image.width, image.height, image.pixels)
             Pura::Ico.encode(ico_img, path)
           when :webp
-            raise ArgumentError, "WebP encoding not available" unless defined?(Pura::Webp)
+            raise ArgumentError, "WebP support requires the pura-webp gem" unless defined?(Pura::Webp)
 
             webp_img = Pura::Webp::Image.new(image.width, image.height, image.pixels)
             Pura::Webp.encode(webp_img, path, **options)

data/lib/pura/image/railtie.rb

@@ -1,50 +1,48 @@
 # frozen_string_literal: true
 
-begin
+# Only define railtie if Rails is available
+if defined?(Rails)
   require "rails/railtie"
-rescue LoadError
-  # Rails is not available, skip railtie functionality
-  return
-end
 
-module Pura
-  module Image
-    class Railtie < Rails::Railtie
-      initializer "pura_image.set_variant_processor", before: "active_storage.configs" do |app|
-        app.config.active_storage.variant_processor = :pura
-      end
+  module Pura
+    module Image
+      class Railtie < Rails::Railtie
+        initializer "pura_image.set_variant_processor", before: "active_storage.configs" do |app|
+          app.config.active_storage.variant_processor = :pura
+        end
 
-      initializer "pura_image.patch_active_storage_variation" do
-        ActiveSupport.on_load(:active_storage_blob) do
-          require "image_processing/pura"
+        initializer "pura_image.patch_active_storage_variation" do
+          ActiveSupport.on_load(:active_storage_blob) do
+            require "image_processing/pura"
 
-          variation_patch = Module.new do
-            private
+            variation_patch = Module.new do
+              private
 
-            def transformer
-              if ActiveStorage.variant_processor == :pura && ActiveStorage.variant_transformer.nil?
-                @pura_transformer ||= begin
-                  klass = Class.new(ActiveStorage::Transformers::ImageProcessingTransformer) do
-                    private
+              def transformer
+                if ActiveStorage.variant_processor == :pura && ActiveStorage.variant_transformer.nil?
+                  @pura_transformer ||= begin
+                    klass = Class.new(ActiveStorage::Transformers::ImageProcessingTransformer) do
+                      private
 
-                    def processor
-                      ImageProcessing::Pura
+                      def processor
+                        ImageProcessing::Pura
+                      end
                     end
-                  end
 
-                  klass.new(transformations.except(:format))
+                    klass.new(transformations.except(:format))
+                  end
+                else
+                  super
                 end
-              else
-                super
               end
             end
-          end
 
-          unless ActiveStorage::Variation.ancestors.include?(variation_patch)
-            ActiveStorage::Variation.prepend(variation_patch)
+            unless ActiveStorage::Variation.ancestors.include?(variation_patch)
+              ActiveStorage::Variation.prepend(variation_patch)
+            end
           end
         end
       end
     end
   end
-end
+end

data/lib/pura/image/version.rb

@@ -2,6 +2,6 @@
 
 module Pura
   module Image
-    VERSION = "0.2.2"
+    VERSION = "0.2.5"
   end
 end

data/lib/pura-image.rb

@@ -9,7 +9,7 @@ require "pura-ico"
 begin
   require "pura-webp"
 rescue LoadError
-  # pura-webp is optional
+  # pura-webp is optional — install the gem to enable WebP support.
 end
 
 require_relative "pura/image/version"

data/pura-image.gemspec

@@ -13,12 +13,12 @@ Gem::Specification.new do |spec|
                      "with image_processing gem compatible API for Rails Active Storage."
   spec.homepage = "https://github.com/komagata/pura-image"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.0.0"
+  spec.required_ruby_version = ">= 3.2.0"
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = spec.homepage
 
-  spec.files = Dir["lib/**/*.rb"] + ["pura-image.gemspec", "Gemfile", "Rakefile", "README.md", "LICENSE"]
+  spec.files = Dir["lib/**/*.rb"] + ["test/fixtures/test_64x64.jpg"] + ["pura-image.gemspec", "Gemfile", "Rakefile", "README.md", "LICENSE"]
 
   spec.add_dependency "pura-jpeg", "~> 0.1"
   spec.add_dependency "pura-png", "~> 0.1"
@@ -26,8 +26,8 @@ Gem::Specification.new do |spec|
   spec.add_dependency "pura-gif", "~> 0.1"
   spec.add_dependency "pura-tiff", "~> 0.1"
   spec.add_dependency "pura-ico", "~> 0.1"
-
-  spec.add_development_dependency "image_processing", "~> 1.2"
+  spec.add_dependency "pura-webp", "~> 0.2"
+  spec.add_dependency "image_processing", "~> 1.2"
   spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "rake", "~> 13.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pura-image
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.5
 platform: ruby
 authors:
 - komagata
@@ -93,6 +93,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: pura-webp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: image_processing
   requirement: !ruby/object:Gem::Requirement
@@ -100,7 +114,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -154,6 +168,7 @@ files:
 - lib/pura/image/railtie.rb
 - lib/pura/image/version.rb
 - pura-image.gemspec
+- test/fixtures/test_64x64.jpg
 homepage: https://github.com/komagata/pura-image
 licenses:
 - MIT
@@ -167,7 +182,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="