image_sorcery 1.0.2

data/README.markdown

@@ -0,0 +1,27 @@
+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?
+
+Several other ImageMagick libraries exist for Ruby, but most have at least one of two issues:
+
+* Large memory consumption/leaking
+* Doesn't expose the entire ImageMagick library
+
+Due to the way Image Sorcery was written, it manages to avoid both of these issues.
+
+## 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
+
+Unit tests coming soon! And a few new convenience methods (like "dimensions").

data/lib/image_sorcery.rb

@@ -0,0 +1,66 @@
+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,58 @@
+--- !ruby/object:Gem::Specification
+name: image_sorcery
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Eric Rafaloff
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-09 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: subexec
+  requirement: &70141614869640 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70141614869640
+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: http://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: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A ruby ImageMagick library that doesn't suck.
+test_files: []