ImageSorcery 1.0.3

data/README.markdown

@@ -0,0 +1,28 @@
+Image Sorcery allows you to leverage all three of ImageMagick's command line tools, [mogrify](http://www.imagemagick.org/script/mogrify.php), [convert](http://www.imagemagick.org/script/convert.php), and [identify](http://www.imagemagick.org/script/identify.php), for maximum magickal power and minimum memory consumption!
+
+## Why?
+
+At [Fol.io](http://fol.io), we need server-side image processing to work well and bend to our will. I wrote this because the ImageMagick libraries we tried suffered from at least one of two problems:
+
+* Large memory consumption/leaking
+* Didn't expose the entire ImageMagick library
+
+Due to the way Image Sorcery was written, it manages to avoid both of these problems.
+
+## Installation
+
+    gem install image_sorcery
+
+## Code Examples
+```ruby
+image = Sorcery.new("image.png")
+image.identify # => "image.png PNG 500x500 500x500+0+0 8-bit DirectClass 236KB 0.010u 0:00.010\n"
+image.manipulate!(scale: "50%") # => true
+image.dimensions # => { x: 250, y: 250 }
+image.convert("thumbnail.jpg", quality: 80, crop: "100x100>") # => true
+```
+
+## Todo
+
+* More unit tests
+* A few more convenience methods (like "dimensions").

data/lib/image_sorcery.rb

@@ -0,0 +1,68 @@
+require 'subexec'
+
+class Sorcery
+  def initialize(file)
+    @file = file
+  end
+
+  # Runs ImageMagick's 'mogrify'.
+  # See http://www.imagemagick.org/script/mogrify.php
+  #
+ def manipulate!(args={})
+    tokens  = ["mogrify"]
+    tokens << convert_to_arguments(args) if args
+    tokens << " '#{@file}#{"[#{args[:layer].to_s}]" if args[:layer]}'"
+    tokens  = convert_to_command(tokens)
+    success = run(tokens)[1]
+    success
+  end
+
+  # Runs ImageMagick's 'convert'.
+  # See http://www.imagemagick.org/script/convert.php
+  #
+  def convert(output, args={})
+    tokens  = ["convert"]
+    tokens << convert_to_arguments(args) if args
+    tokens << " '#{@file}#{"[#{args[:layer].to_s}]" if args[:layer]}'"
+    tokens << " #{output}"
+    tokens  = convert_to_command(tokens)
+    success = run(tokens)[1]
+    success
+  end
+
+  # Runs ImageMagick's 'identify'.
+  # See http://www.imagemagick.org/script/identify.php
+  #
+  def identify(args={})
+    tokens = ["identify"]
+    tokens << convert_to_arguments(args) if args
+    tokens << " '#{@file}#{"[#{args[:layer].to_s}]" if args[:layer]}'"
+    tokens  = convert_to_command(tokens)
+    output  = run(tokens)[0]
+    output
+  end
+
+  # Return the x and y dimensions of an image as a hash.
+  #
+  def dimensions
+    dimensions = identify(layer: 0, format: "%wx%h").chomp.split("x")
+    { x: dimensions[0],
+      y: dimensions[1] }
+  end
+
+  private
+
+  def convert_to_command(tokens)
+    tokens.flatten.join("")
+  end
+
+  def convert_to_arguments(args)
+    args.reject {|k, v| k == :layer }.map {|k, v| " -#{k} '#{v}'"}
+  end
+
+  def run(cmds)
+    sub = Subexec.run(cmds.to_s)
+    success = sub.exitstatus == 0 ? true : false
+    [sub.output,success]
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: ImageSorcery
+version: !ruby/object:Gem::Version
+  version: 1.0.3
+  prerelease: 
+platform: ruby
+authors:
+- Eric Rafaloff
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: subexec
+  requirement: &70240589735500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70240589735500
+description: A ruby ImageMagick library that doesn't suck
+email:
+- hello@ericrafaloff.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/image_sorcery.rb
+- README.markdown
+homepage: https://github.com/ericr/image_sorcery
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- ImageMagick
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A ruby ImageMagick library that doesn't suck
+test_files: []