MIT-LICENSE README.rdoc lib/image_temp_file.rb mini_magick.gemspec test/command_builder_test.rb test/image_temp_file_test.rb test/image_test.rb @@ -1,4 +1,40 @@ -require 'config/requirements' -require 'config/hoe' # setup Hoe + all gem configuration - -Dir['tasks/**/*.rake'].each { |rake| load rake } \ No newline at end of file +require 'rake' +require 'rake/testtask' +require 'rake/rdoctask' + +$:.unshift(File.dirname(__FILE__) + "/lib") +require 'mini_magick' + +desc 'Default: run unit tests.' +task :default => :test + +desc 'Clean generated files.' +task :clean => :clobber_rdoc do + rm FileList['test/output/*.png'] +end + +desc 'Test the mini_magick plugin.' +Rake::TestTask.new(:test) do |t| + t.libs << 'lib' + t.pattern = 'test/**/*_test.rb' + t.verbose = true +end + +desc 'Generate documentation for the mini_magick plugin.' +Rake::RDocTask.new(:rdoc) do |rdoc| + rdoc.rdoc_dir = 'rdoc' + rdoc.title = 'MiniMagick' + rdoc.options << '--line-numbers' + rdoc.options << '--inline-source' + rdoc.rdoc_files.include('README.rdoc') + rdoc.rdoc_files.include('lib/**/*.rb') +end + +desc 'Update gemspec.' +task :update_gemspec => :clean do + files = `git-ls-files`.split + data = File.read('mini_magick.gemspec') + data.sub!(/^ s.version = .*$/, " s.version = #{MiniMagick::VERSION.inspect}") + data.sub!(/^ s.files = .*$/, " s.files = %w(#{files.join(' ')})") + open('mini_magick.gemspec', 'w'){|f| f.write(data)} +end Rakefile @@ -1,3 +1,178 @@ -$:.unshift File.dirname(__FILE__) +require "open-uri" +require "stringio" +require "fileutils" +require "open3" -require 'mini_magick/mini_magick' \ No newline at end of file +require File.join(File.dirname(__FILE__), '/image_temp_file') + +module MiniMagick + class MiniMagickError < RuntimeError; end + + VERSION = '1.2.5' + + class Image + attr :path + attr :tempfile + attr :output + + # Class Methods + # ------------- + class << self + def from_blob(blob, ext = nil) + begin + tempfile = ImageTempFile.new(ext) + tempfile.binmode + tempfile.write(blob) + ensure + tempfile.close if tempfile + end + + return self.new(tempfile.path, tempfile) + end + + # Use this if you don't want to overwrite the image file + def open(image_path) + File.open(image_path, "rb") do |f| + self.from_blob(f.read, File.extname(image_path)) + end + end + alias_method :from_file, :open + end + + # Instance Methods + # ---------------- + def initialize(input_path, tempfile=nil) + @path = input_path + @tempfile = tempfile # ensures that the tempfile will stick around until this image is garbage collected. + + # Ensure that the file is an image + run_command("identify", @path) + end + + # For reference see http://www.imagemagick.org/script/command-line-options.php#format + def [](value) + # Why do I go to the trouble of putting in newlines? Because otherwise animated gifs screw everything up + case value.to_s + when "format" + run_command("identify", "-format", format_option("%m"), @path).split("\n")[0] + when "height" + run_command("identify", "-format", format_option("%h"), @path).split("\n")[0].to_i + when "width" + run_command("identify", "-format", format_option("%w"), @path).split("\n")[0].to_i + when "dimensions" + run_command("identify", "-format", format_option("%w %h"), @path).split("\n")[0].split.map{|v|v.to_i} + when "size" + File.size(@path) # Do this because calling identify -format "%b" on an animated gif fails! + when "original_at" + # Get the EXIF original capture as a Time object + Time.local(*self["EXIF:DateTimeOriginal"].split(/:|\s+/)) rescue nil + when /^EXIF\:/i + run_command('identify', '-format', "\"%[#{value}]\"", @path).chop + else + run_command('identify', '-format', "\"#{value}\"", @path).split("\n")[0] + end + end + + # Sends raw commands to imagemagick's mogrify command. The image path is automatically appended to the command + def <<(*args) + run_command("mogrify", *args << @path) + end + + # This is a 'special' command because it needs to change @path to reflect the new extension + # Formatting an animation into a non-animated type will result in ImageMagick creating multiple + # pages (starting with 0). You can choose which page you want to manipulate. We default to the + # first page. + def format(format, page=0) + run_command("mogrify", "-format", format, @path) + + old_path = @path.dup + @path.sub!(/(\.\w+)?$/, ".#{format}") + File.unlink(old_path) unless old_path == @path + + unless File.exists?(@path) + begin + FileUtils.copy_file(@path.sub(".#{format}", "-#{page}.#{format}"), @path) + rescue => ex + raise MiniMagickError, "Unable to format to #{format}; #{ex}" unless File.exist?(@path) + end + end + ensure + Dir[@path.sub(/(\.\w+)?$/, "-[0-9]*.#{format}")].each do |fname| + File.unlink(fname) + end + end + + # Writes the temporary image that we are using for processing to the output path + def write(output_path) + FileUtils.copy_file @path, output_path + run_command "identify", output_path # Verify that we have a good image + end + + # Give you raw data back + def to_blob + f = File.new @path + f.binmode + f.read + ensure + f.close if f + end + + # If an unknown method is called then it is sent through the morgrify program + # Look here to find all the commands (http://www.imagemagick.org/script/mogrify.php) + def method_missing(symbol, *args) + args.push(@path) # push the path onto the end + run_command("mogrify", "-#{symbol}", *args) + self + end + + # You can use multiple commands together using this method + def combine_options(&block) + c = CommandBuilder.new + block.call c + run_command("mogrify", *c.args << @path) + end + + # Check to see if we are running on win32 -- we need to escape things differently + def windows? + !(RUBY_PLATFORM =~ /win32/).nil? + end + + # Outputs a carriage-return delimited format string for Unix and Windows + def format_option(format) + windows? ? "#{format}\\n" : "#{format}\\\\n" + end + + def run_command(command, *args) + args.collect! do |arg| + # values quoted because they can contain characters like '>', but don't quote switches + arg =~ /^\+|\-/) ? %|"#{arg}"| : arg.to_s + end + + command = "#{command} #{args.join(' ')}" + output = `#{command} 2>&1` + + if $?.exitstatus != 0 + raise MiniMagickError, "ImageMagick command (#{command.inspect}) failed: #{{:status_code => $?, :output => output}.inspect}" + else + output + end + end + end + + class CommandBuilder + attr :args + + def initialize + @args = [] + end + + def method_missing(symbol, *args) + @args << "-#{symbol}" + @args += args + end + + def +(value) + @args << "+#{value}" + end + end +end lib/mini_magick.rb test/animation.gif test/leaves.tiff test/not_an_image.php test/simple.gif test/trogdor.jpg History.txt License.txt Manifest.txt README.txt config/hoe.rb config/requirements.rb lib/mini_magick/image_temp_file.rb lib/mini_magick/mini_magick.rb lib/mini_magick/version.rb log/debug.log script/destroy script/generate script/txt2html setup.rb tasks/deployment.rake tasks/environment.rake tasks/website.rake test/test_helper.rb test/test_image_temp_file.rb test/test_mini_magick.rb 56a476171eaddaeb9e35d730d5a6310e9e2a3f81 Corey Johnson probablycorey@gmail.com http://github.com/probablycorey/mini_magick/commit/88f03280d0f499b3cd3437c99b964e72b3801882 88f03280d0f499b3cd3437c99b964e72b3801882 2009-05-26T18:04:57-07:00 2009-05-26T18:04:57-07:00 gobbled up a bunch of remvees patches 1332d32f779483eb764c2047611fd64ec17af2dc Corey Johnson probablycorey@gmail.com