seamus 0.2.4 → 0.3.0

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Scott Burton
+Copyright (c) 2010 Scott Burton
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -4,37 +4,53 @@ Seamus is not an Irish monk. Instead, it inspects a file and returns whatever me
 
 == Usage
 
-Mix Seamus in to your class and get a hash of #file_attributes appropriate to the file type.
-Provide an instance of File, or any class that responds to #path, and include Seamus:
+Seamus inspects your file and discovers useful attributes. It is at its best with rich 
+digital media - video, audio and image files - but is suitable for use with any file type.
+Just provide a path to Seamus::Builder.new for an enhanced File object that knows about your
+file. 
 
-  class MyClass
+  movie = Seamus::Builder.new("/path/to/my/movie.mov")
+  
+  movie.width
+  # => 720
+  
+  movie.video_codec
+  # => 'h264'
+
+Or if you prefer, include Seamus in a class and use the has_file :file_attribute class 
+method for attachments.
+  
+  class Upload
     include Seamus
-    attr_accessor :file
-    
-    def initialize(path)
-      @path = File.open(path)
-    end
+    has_file :file
   end
   
-  my_file = MyClass.new("path/to/file.mov")
-  my_file.file_attributes
+  u = Upload.new
+  u.file = "/path/to/image.jpg"
+  u.file.width
+  # => 3284
   
-  # => {"video_codec"=>"h264", "bitrate_units"=>"kb/s", "container"=>"mov,mp4,m4a,3gp,3g2,mj2", "audio_channels_string"=>"stereo", "audio?"=>true, "audio_channels"=>2, "video?"=>true, "audio_sample_rate"=>44100, "bitrate"=>346, "audio_codec"=>"mpeg4aac", "video_colorspace"=>"yuv420p", "height"=>576, "audio_sample_units"=>"Hz", "fps"=>"7.00", "duration"=>84000, "width"=>1024}
-  
-
-Generate thumbnails automatically:
+Seamus supports thumbnail creation for visual media types. The #thumbnail method returns
+an IO instance.
 
-  my_file.thumbnail {|thumb| my_open_file_instance.write thumb.read }
+  u.file.thumbnail
+  # => #<IO:0x357898>
+  
+== Extending Seamus
 
-Files that probably can't generate thumbnails (audio, PDF, etc.) will raise ThumbnailError.
+Seamus dynamically generates classes for file types as it encounters them. Seamus::Builder
+will, for example, generate a Seamus::File::Mp4 class and instance when given a path to 
+an MPEG-4 file with .mp4 extension, which subclasses Seamus::File::Video.
 
-Video and audio file attributes are inspected using the RVideo gem.
+You can build custom behavior around a file type by defining a class Seamus::File::<extname> 
+that either subclasses File, subclasses one of Seamus::File's template classes, or implements
+a path handler of some kind.
 
 == Note on Patches/Pull Requests
  
-* I'd be very surprised if anyone wanted to do such a thing.
+* I'd be very surprised if anyone wanted to do such a thing. But if you really do, contact me and we'll work something out.
 
 
 == Copyright
 
-Copyright (c) 2009 Scott Burton. See LICENSE for details.
+Copyright (c) 2010 Scott Burton. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-0.2.4
+0.3.0

data/lib/mime_table.rb

@@ -85,6 +85,7 @@ MimeTable.register "text/UTF-8", :txt
 MimeTable.register "text/x-java-source", :jav
 MimeTable.register "text/x-script.python", :py
 MimeTable.register "text/x-script.sh", :sh
+MimeTable.register "text/x-ruby", :rb
 MimeTable.register "video/mp4", :f4v
 MimeTable.register "video/mp4", :mp4
 MimeTable.register "video/quicktime", :mov

data/lib/seamus.rb

@@ -1,11 +1,11 @@
-require 'rvideo'
 require 'digest/md5'
-
+require 'open3'
 require 'tempfile'
 
 $LOAD_PATH << './lib'
 
 require 'core/numeric'
+require 'seamus/standard_additions'
 require 'seamus/inspector'
 require 'seamus/inspector/video_inspector'
 require 'seamus/inspector/audio_inspector'
@@ -18,138 +18,67 @@ require 'seamus/processor/audio_processor'
 require 'seamus/processor/image_processor'
 require 'seamus/processor/application_processor'
 require 'seamus/processor/text_processor'
+require 'seamus/file/video'
+require 'seamus/file/audio'
+require 'seamus/file/text'
+require 'seamus/file/image'
+require 'seamus/file/application'
+require 'seamus/builder'
 require 'mime_table'
 
 
 ## Seamus - The File Inspector
-# Mix Seamus in to your class and get a hash of #file_attributes appropriate to the file type.
-# Provide an instance of File, or any class that responds to #path, and include Seamus:
-#
-#   class MyClass
+# 
+# Seamus inspects your file and discovers useful attributes. It is at its best with rich 
+# digital media - video, audio and image files - but is suitable for use with any file type.
+# Just provide a path to Seamus::Builder.new for an enhanced File object that knows about your
+# file. 
+# 
+#   movie = Seamus::Builder.new("/path/to/my/movie.mov")
+#   
+#   movie.width
+#   # => 720
+#   
+#   movie.video_codec
+#   # => 'h264'
+# 
+# Or if you prefer, include Seamus in a class and use the has_file :file_attribute class 
+# method for attachments.
+#   
+#   class Upload
 #     include Seamus
-#     attr_accessor :file
-#     
-#     def initialize(path)
-#       @path = File.open(path)
-#     end
+#     has_file :file
 #   end
 #   
-#   my_file = MyClass.new("path/to/file.mov")
-#   my_file.file_attributes
-#   
-#   # => {"video_codec"=>"h264", "bitrate_units"=>"kb/s", "container"=>"mov,mp4,m4a,3gp,3g2,mj2", "audio_channels_string"=>"stereo", "audio?"=>true, "audio_channels"=>2, "video?"=>true, "audio_sample_rate"=>44100, "bitrate"=>346, "audio_codec"=>"mpeg4aac", "video_colorspace"=>"yuv420p", "height"=>576, "audio_sample_units"=>"Hz", "fps"=>"7.00", "duration"=>84000, "width"=>1024}
+#   u = Upload.new
+#   u.file = "/path/to/image.jpg"
+#   u.file.width
+#   # => 3284
 #   
-#
-# Generate thumbnails automatically:
+# Seamus supports thumbnail creation for visual media types. The #thumbnail method returns
+# an IO instance.
 # 
-#   my_file.thumbnail {|thumb| my_open_file_instance.write thumb.read }
+#   u.file.thumbnail
+#   # => #<IO:0x357898>
 #   
-  
 
 module Seamus
 
   module ClassMethods
-
-  end
-
-  module InstanceMethods
-
-    def file_path
-      file.path
-    end
-
-    def file_name
-      File.basename(file_path)
-    end
-
-    def file_attributes
-      @file_attributes ||= inspect_file
-    end
-
-    def md5
-      @md5 ||= Digest::MD5.file(file_path)
-    end
-
-    def md5_hex_string
-      md5.to_s
-    end
-
-    def md5_base64_encoded
-      Base64.encode64(md5.digest).strip
-    end
-
-    def content_type
-       MimeTable.lookup_by_extension(extension).to_s
-    end
-
-    def thumbnail(&block)
-      @thumbnail ||= generate_thumbnail
-      if block_given?
-        begin
-          @thumbnail.open
-          yield @thumbnail
-        ensure
-          @thumbnail.close
+    def has_file(attribute)
+      self.class_eval(%Q(
+        def #{attribute.to_s}=(file)
+          @#{attribute.to_s} = Seamus::Builder.new(file)
         end
-      end
-      return @thumbnail
-    end
-
-    protected
-
-    def inspect_file
-      inspector = Seamus.const_get("#{file_type.classify}Inspector").new(file_path)
-      return inspector.stats
-    end
-
-    def generate_thumbnail
-      processor = Seamus.const_get("#{file_type.classify}Processor").new(file_path, file_attributes)
-      begin
-        processor.thumbnail
-      rescue ThumbnailError => e
-        return nil
-      rescue NameError
-        return nil
-      end
-    end
-
-    private
-
-    def file_type
-      # begin
-      #   @file_attributes["content-type"].split("/").first
-      # rescue
-        determine_type_from_extension
-      # end
-    end
-
-    def determine_type_from_extension
-      begin
-        Mime::Type.lookup_by_extension(extension).to_s.split("/").first
-      rescue NoMethodError
-        "application"
-      rescue NameError
-        if MimeTable
-          MimeTable.lookup_by_extension(extension).to_s.split("/").first
-        else
-          raise LoadError, "Mime module not loaded"
+        
+        def #{attribute.to_s}
+          @#{attribute.to_s}
         end
-      end
-    end
-
-    # returns the last segment of the filename, eg "foo.mov".extension => ".mov"
-    def extension
-      file_name.split('.').last.downcase
+      ))
     end
+  end
 
-    # Add file_attributes as getter methods
-    def method_missing(method, *args, &block)
-      if file_attributes.include?(method.to_s)
-        file_attributes[method.to_s]
-      else
-        super(method, *args, &block)
-      end
-    end
+  module InstanceMethods
 
   end
 

data/lib/seamus/builder.rb

@@ -0,0 +1,45 @@
+module Seamus
+  
+  module Builder
+    extend self
+    def new(file)
+      path = file.is_a?(File) ? Pathname.new(file.path) : Pathname.new(file)
+      type = file_type(path.extname)
+      extension = path.extname.gsub('.', '')
+      build_class(type, extension).new(path.to_s)
+    end
+
+    def file_type(extension)
+      determine_type_from_extension(extension)
+    end
+
+    private
+
+    def build_class(type, extension)
+      Seamus::File.module_eval %Q{
+        class #{extension.capitalize} < #{type}; end
+      } unless Seamus::File.const_defined?("#{extension.capitalize}")
+      Seamus::File.const_get("#{extension.capitalize}")
+    end
+
+    def determine_type_from_extension(extension)
+      begin
+        Mime::Type.lookup_by_extension(extension).to_s.split("/").first.capitalize
+      rescue NoMethodError
+        "Application"
+      rescue NameError
+        if MimeTable
+          MimeTable.lookup_by_extension(extension).to_s.split("/").first.capitalize
+        else
+          raise LoadError, "Mime module not loaded"
+        end
+      end
+    end
+    # 
+    # # returns the last segment of the filename, eg "foo.mov".extension => ".mov"
+    # def extension
+    #   file_name.split('.').last.downcase
+    # end
+    
+  end
+end

data/lib/seamus/file/application.rb

@@ -0,0 +1,13 @@
+module Seamus
+  module File    
+    class Application < ::File
+      include Seamus::ApplicationInspector
+      include Seamus::ApplicationProcessor
+      include Seamus::StandardAdditions
+      def initialize(*args, &block)
+        super(*args, &block)
+        # create_methods_for inspector
+      end
+    end
+  end
+end

data/lib/seamus/file/audio.rb

@@ -0,0 +1,13 @@
+module Seamus
+  module File    
+    class Audio < ::File
+      include Seamus::AudioInspector
+      include Seamus::AudioProcessor
+      include Seamus::StandardAdditions
+      def initialize(*args, &block)
+        super(*args, &block)
+        create_methods_for inspector, :except => "path"
+      end
+    end
+  end
+end

data/lib/seamus/file/image.rb

@@ -0,0 +1,13 @@
+module Seamus
+  module File    
+    class Image < ::File
+      include Seamus::ImageInspector
+      include Seamus::ImageProcessor
+      include Seamus::StandardAdditions
+      def initialize(*args, &block)
+        super(*args, &block)
+        create_methods_for inspector, :except => ["thumbnail", "thumbnail2"]
+      end
+    end
+  end
+end

data/lib/seamus/file/text.rb

@@ -0,0 +1,13 @@
+module Seamus
+  module File    
+    class Text < ::File
+      include Seamus::TextInspector
+      include Seamus::TextProcessor
+      include Seamus::StandardAdditions
+      def initialize(*args, &block)
+        super(*args, &block)
+        # create_methods_for inspector
+      end
+    end
+  end
+end

data/lib/seamus/file/video.rb

@@ -0,0 +1,13 @@
+module Seamus
+  module File
+    class Video < ::File
+      include Seamus::VideoInspector
+      include Seamus::VideoProcessor
+      include Seamus::StandardAdditions
+      def initialize(*args, &block)
+        super(*args, &block)
+        create_methods_for inspector, :except => "path"
+      end
+    end
+  end
+end

data/lib/seamus/inspector/application_inspector.rb

@@ -1,16 +1,5 @@
 module Seamus
-  class ApplicationInspector < Inspector
+  module ApplicationInspector
       
-    def stats
-      inspection_attributes
-    end
-    
-    private
-
-    def inspection_attributes
-      attr_hash = {"size" => file_stat.size}
-      return attr_hash
-    end
-    
   end
 end

data/lib/seamus/inspector/audio_inspector.rb

@@ -1,32 +1,9 @@
 module Seamus
-  class AudioInspector < Inspector
+  module AudioInspector
       
-    def stats
-      inspection_attributes
+    def inspector
+      @inspector ||= RVideo::Inspector.new(:file => self.path)
     end
-
-    private
-
-    def inspection_attributes
-      attr_hash = {}
-      ["audio?", "audio_bitrate", "audio_channels", "audio_channels_string", "audio_codec", "audio_sample_rate", "audio_sample_units", "bitrate", "bitrate_units", "container", "duration"].each do |attribute|
-        attr_hash[attribute.to_s] = media_stat.send(attribute) if media_stat.respond_to?(attribute)
-      end
-      attr_hash.merge!("size" => file_stat.size)
-      return attr_hash
-    end
-
-    def media_stat
-      RVideo::Inspector.new(:raw_response => raw_response)
-    end
-
-    def raw_response
-      process = IO.popen("ffmpeg -i '#{file.path}' 2>&1", "r")
-      response = process.read
-      process.close
-      return response
-    end
-  
     
   end
 end

data/lib/seamus/inspector/image_inspector.rb

@@ -1,24 +1,10 @@
 require 'devil'
 
 module Seamus
-  class ImageInspector < Inspector
-    def stats
-      inspection_attributes
-    end
-    
-    private
-    
-    def inspection_attributes
-      attr_hash = {}
-      ["width", "height"].each do |attribute|
-        attr_hash[attribute] ||= image.send(attribute.to_sym) if image.respond_to?(attribute)
-      end
-      attr_hash.merge!("size" => file_stat.size)      
-      return attr_hash
-    end
+  module ImageInspector
     
-    def image
-      @image ||= Devil.load_image(file.path)
+    def inspector
+      @inspector ||= Devil.load_image(self.path)
     end
     
   end

data/lib/seamus/inspector/text_inspector.rb

@@ -1,16 +1,26 @@
 module Seamus
-  class TextInspector < Inspector
+  module TextInspector
     
-    def stats
-      inspection_attributes
+    def words
+      characters.scan(/\S+/)
     end
-
+    
+    def word_count
+      words.size
+    end
+    
+    def lines
+      characters.scan(/.*\n/)
+    end
+    
+    def lines_count
+      lines.size
+    end
+    
     private
-
-    def inspection_attributes
-      attr_hash = {"size" => file_stat.size}
-      return attr_hash
+    
+    def characters
+      @characters ||= ::File.read(self.path)
     end
-
   end
 end

data/lib/seamus/inspector/video_inspector.rb

@@ -1,33 +1,11 @@
+require 'rvideo'
+require 'forwardable'
+
 module Seamus
-  class VideoInspector < Inspector
+  module VideoInspector
     
-    def stats
-      inspection_attributes
-    end
-
-    private
-
-    def inspection_attributes
-      attr_hash = {}
-      ["audio?", "audio_bitrate", "audio_channels", "audio_channels_string", "audio_codec", "audio_sample_rate", "audio_sample_units", "bitrate", "bitrate_units", "container", "duration", "fps", "height", "video?", "video_codec", "video_colorspace", "width"].each do |attribute|
-        attr_hash[attribute.to_s] = media_stat.send(attribute) if media_stat.respond_to?(attribute)
-      end
-      attr_hash.merge!("size" => file_stat.size)
-      return attr_hash
-    end
-
-    def media_stat
-      RVideo::Inspector.new(:raw_response => raw_response)
-    end
-
-    def raw_response
-      response = ffmpeg_response_process.read
-      ffmpeg_response_process.close
-      return response
-    end
-
-    def ffmpeg_response_process
-      IO.popen("ffmpeg -i '#{@file.path}' 2>&1", "r")
+    def inspector
+      @inspector ||= RVideo::Inspector.new(:file => self.path)
     end
 
   end

data/lib/seamus/processor/application_processor.rb

@@ -1,5 +1,5 @@
 module Seamus
-  class ApplicationProcessor < Processor
+  module ApplicationProcessor
 
     def thumbnail
       raise ThumbnailError, "invalid type for thumbnail"

data/lib/seamus/processor/audio_processor.rb

@@ -1,5 +1,5 @@
 module Seamus
-  class AudioProcessor < Processor
+  module AudioProcessor
     
     def thumbnail
       raise ThumbnailError, "invalid type for thumbnail"

data/lib/seamus/processor/image_processor.rb

@@ -1,21 +1,25 @@
 module Seamus
-  class ImageProcessor < Processor
+  module ImageProcessor
     require 'devil'
     
     def thumbnail
-      tmp = thumb_tempfile
-      Devil.load_image(file.path) do |img|
+      tmp = Tempfile.new(::File.basename(path))
+      # io = IO.new
+      Devil.load_image(path) do |img|
         img.thumbnail(320)
-        img.save("#{file.path}_#{File.basename(file.path)}_thumb.jpg")
+        img.save("#{path}_#{::File.basename(path)}_thumb.jpg")
       end
-      File.open("#{file.path}_#{File.basename(file.path)}_thumb.jpg", "r") do |thumb|
+      ::File.open("#{path}_#{::File.basename(path)}_thumb.jpg", "r") do |thumb|
         tmp.write thumb.read
       end
-      tmp.close
-      File.unlink("#{file.path}_#{File.basename(file.path)}_thumb.jpg")
+       # tmp.close
+       tmp.rewind
+      # io.close
+      ::File.unlink("#{path}_#{::File.basename(path)}_thumb.jpg")
+      # return io
       return tmp
     end
-    
+      
     
   end
 end

data/lib/seamus/processor/text_processor.rb

@@ -1,5 +1,5 @@
 module Seamus
-  class TextProcessor < Processor
+  module TextProcessor
     
     def thumbnail
       raise ThumbnailError, "invalid type for thumbnail"

data/lib/seamus/processor/video_processor.rb

@@ -1,30 +1,18 @@
 module Seamus
-  class VideoProcessor < Processor
+  module VideoProcessor
     
     def thumbnail
-      thumb = thumb_tempfile
-      IO.popen("ffmpeg -y -ss #{start_time} -i '#{@file.path}' -t 00:00:01 -vcodec mjpeg -vframes 1 -an -f rawvideo -s #{dimensions_string} - 2> /dev/null") do |io|
-        thumb.write io.read
-      end
-      thumb.close
-      return thumb
+      Open3.popen3("ffmpeg -y -ss #{start_time} -i '#{self.path}' -t 00:00:01 -vcodec mjpeg -vframes 1 -an -f rawvideo -s #{dimensions_string} - ")[1]
     end
     
     private
     
     def start_time
-      (file_attributes["duration"] || 10000)/3333
-    end
-    
-    # nodoc
-    def thumb_tempfile
-      Tempfile.new("#{File.basename(@file.path, File.extname(@file.path))}_thumb.jpg")
+      (duration || 10000)/3333
     end
     
     def aspect_ratio
-      width = (file_attributes["width"]).to_f
-      height = (file_attributes["height"]).to_f
-      return (width/height)
+      width.to_r/height.to_r
     end
     
     # For ffmpeg dimensions to work, the dimension components have to be even numbers,

data/lib/seamus/standard_additions.rb

@@ -0,0 +1,44 @@
+module Seamus
+  module StandardAdditions
+    def md5
+      @md5 ||= Digest::MD5.file(self.path)
+    end
+
+    def md5_digest
+      md5.digest
+    end
+
+    def md5_base64_encoded
+      Base64.encode64(md5_digest).strip
+    end
+    
+    def size
+      stat.size
+    end
+    
+    def content_type
+       MimeTable.lookup_by_extension(extension).to_s
+    end
+    
+    private
+    
+    def create_method(method, method_binding)
+      self.class.send(:define_method, method.to_sym, method_binding)
+    end
+
+    def create_methods_for(object, options={})
+      options[:except] = options[:except].to_a unless options[:except].is_a?(Array)
+      object.public_methods(false).each do |method|
+        create_method(method, lambda {object.method(method.to_s).call}) unless options[:except].include?(method)
+      end
+    end
+
+    # def method_missing(method, *args, &block)
+    #   if file_attributes.has_key?(method.to_s)
+    #     file_attributes[method.to_s]
+    #   else
+    #     super(method, *args, &block)
+    #   end
+    # end
+  end
+end

data/seamus.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{seamus}
-  s.version = "0.2.4"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Scott Burton"]
-  s.date = %q{2010-01-26}
+  s.date = %q{2010-02-10}
   s.description = %q{Seamus is not an Irish monk. Instead, it inspects a file and returns whatever metadata it can determine.}
   s.email = %q{scottburton11@gmail.com}
   s.extra_rdoc_files = [
@@ -29,22 +29,33 @@ Gem::Specification.new do |s|
      "lib/core/numeric.rb",
      "lib/mime_table.rb",
      "lib/seamus.rb",
-     "lib/seamus/inspector.rb",
+     "lib/seamus/builder.rb",
+     "lib/seamus/file/application.rb",
+     "lib/seamus/file/audio.rb",
+     "lib/seamus/file/image.rb",
+     "lib/seamus/file/text.rb",
+     "lib/seamus/file/video.rb",
      "lib/seamus/inspector/application_inspector.rb",
      "lib/seamus/inspector/audio_inspector.rb",
      "lib/seamus/inspector/image_inspector.rb",
      "lib/seamus/inspector/text_inspector.rb",
      "lib/seamus/inspector/video_inspector.rb",
-     "lib/seamus/processor.rb",
      "lib/seamus/processor/application_processor.rb",
      "lib/seamus/processor/audio_processor.rb",
      "lib/seamus/processor/image_processor.rb",
      "lib/seamus/processor/text_processor.rb",
      "lib/seamus/processor/video_processor.rb",
+     "lib/seamus/standard_additions.rb",
      "seamus.gemspec",
+     "spec/factories.rb",
+     "spec/fixtures/test.jpg",
+     "spec/fixtures/test.mov",
+     "spec/fixtures/test.mp4",
      "spec/lib/core/numeric_spec.rb",
      "spec/lib/seamus/inspector/image_inspector_spec.rb",
+     "spec/lib/seamus/inspector/video_inspector_spec.rb",
      "spec/lib/seamus/processor/image_processor_spec.rb",
+     "spec/lib/seamus/processor/video_processor_spec.rb",
      "spec/seamus_spec.rb",
      "spec/spec_helper.rb"
   ]
@@ -54,9 +65,12 @@ Gem::Specification.new do |s|
   s.rubygems_version = %q{1.3.5}
   s.summary = %q{Seamus is not an Irish monk}
   s.test_files = [
-    "spec/lib/core/numeric_spec.rb",
+    "spec/factories.rb",
+     "spec/lib/core/numeric_spec.rb",
      "spec/lib/seamus/inspector/image_inspector_spec.rb",
+     "spec/lib/seamus/inspector/video_inspector_spec.rb",
      "spec/lib/seamus/processor/image_processor_spec.rb",
+     "spec/lib/seamus/processor/video_processor_spec.rb",
      "spec/seamus_spec.rb",
      "spec/spec_helper.rb"
   ]

data/spec/factories.rb

@@ -0,0 +1,13 @@
+module Factories
+  def mov
+    File.open(File.expand_path(File.dirname(__FILE__) + "/fixtures/test.mov"))
+  end
+  
+  def mp4
+    File.open(File.expand_path(File.dirname(__FILE__) + "/fixtures/test.mp4"))
+  end
+  
+  def jpg
+    File.open(File.expand_path(File.dirname(__FILE__) + "/fixtures/test.jpg"))
+  end
+end

data/spec/lib/seamus/inspector/image_inspector_spec.rb

@@ -1,43 +1,13 @@
 require File.expand_path(File.dirname(__FILE__)) + "/../../../spec_helper.rb"
 
 describe Seamus::ImageInspector do
-
-  include FakeFS::SpecHelpers
-  
   before(:each) do
-    FileUtils.touch("./image.jpg")
-    @inspector = Seamus::ImageInspector.new("./image.jpg")
+    @image = mock(Seamus::File::Image, :path => "/path/to/image.jpg")
+    @image.extend Seamus::ImageInspector
   end
   
-  it "responds to #stats" do
-    @inspector.should respond_to(:stats)
+  it "loads an image inspector using Devil.load_image" do
+    Devil.should_receive(:load_image).with("/path/to/image.jpg")
+    @image.inspector
   end
-  
-  describe "stats" do
-    
-    before(:each) do
-      @image = mock(Devil::Image, :width => 100, :height => 100)
-      @file_stat = mock(File::Stat, :size => 100)
-      @inspector.should_receive(:image).any_number_of_times.and_return(@image)
-      @inspector.should_receive(:file_stat).and_return(@file_stat)
-    end
-    
-    it "returns a hash" do
-      @inspector.stats.should be_an_instance_of(Hash)
-    end
-    
-    it "assigns :width" do
-      @inspector.stats["width"].should eql(100)
-    end
-    
-    it "assigns :height" do
-      @inspector.stats["height"].should eql(100)
-    end
-    
-    it "assigns :size" do
-      @inspector.stats["size"].should eql(100)
-    end
-    
-  end
-  
 end

data/spec/lib/seamus/inspector/video_inspector_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path(File.dirname(__FILE__)) + "/../../../spec_helper.rb"
+
+describe Seamus::VideoInspector do
+  before(:each) do
+    @video = mock(Seamus::File::Video, :path => "/path/to/video.jpg")
+    @video.extend Seamus::VideoInspector
+  end
+  
+  it "loads an video inspector using RVideo::Inspector" do
+    RVideo::Inspector.should_receive(:new).with(:file => "/path/to/video.jpg")
+    @video.inspector
+  end
+end

data/spec/lib/seamus/processor/video_processor_spec.rb

@@ -0,0 +1,66 @@
+require File.expand_path(File.dirname(__FILE__)) + "/../../../spec_helper.rb"
+
+describe Seamus::VideoProcessor do
+  # include FakeFS::SpecHelpers
+  
+  before(:each) do
+    # File.new("/path/to/movie.mov", "w+") {|file| file << "MovieData"}
+    # file = File.open("/path/to/movie.mov", "r")
+    # @video = file.dup.extend Seamus::VideoProcessor
+    @video = mock(Seamus::File::Video, :path => "/path/to/movie.mov")
+    @video.extend Seamus::VideoProcessor
+  end
+  
+  describe "thumbnail creation" do
+    before(:each) do
+      @video.stub!(:start_time => 3333, :dimensions_string => "320x180")
+    end
+    
+    it "uses Open3 to capture the stdout of ffmpeg in an IO instance" do
+      @stdin, @stdout, @stderr = mock(IO), mock(IO), mock(IO)
+      Open3.should_receive(:popen3).
+            with("ffmpeg -y -ss 3333 -i '/path/to/movie.mov' -t 00:00:01 -vcodec mjpeg -vframes 1 -an -f rawvideo -s 320x180 - ").
+            and_return([@stdin, @stdout, @stderr])
+      @video.thumbnail.should eql(@stdout)
+    end
+    
+  end
+  
+  describe "thumbnail capture start time" do
+    it "defaults to 10000/3333 - roughly 3 seconds in - when the #duration attribute is nil" do
+      @video.stub!(:duration => nil)
+      @video.send(:start_time).should eql(10000/3333)
+    end
+    
+    it "equals one third of the duration (in milliseconds)" do
+      @video.stub!(:duration => 20000)
+      @video.send(:start_time).should eql(20000/3333)
+    end
+  end
+  
+  describe "aspect ratio" do
+    before(:each) do
+      @video.stub!(:width => 640, :height => 480)
+    end
+    
+    it "is a rational number calculated from #width divided by #height" do
+      @video.send(:aspect_ratio).should == Rational(4,3)
+    end
+  end
+  
+  describe "dimensions string" do
+    before(:each) do
+      @video.stub!(:aspect_ratio => Rational(4,3))
+    end
+    
+    it "is a formatted 'WxH' string, using the aspect ratio to calculate the height constant width" do
+      @video.send(:dimensions_string).should eql("320x240")
+    end
+    
+    it "can be provided with an alternate width" do
+      @video.send(:dimensions_string, 240).should eql("240x180")
+    end
+    
+  end
+  
+end

data/spec/seamus_spec.rb

@@ -1,16 +1,53 @@
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
-describe Seamus do
+describe Seamus::Builder do
   
-  describe "thumbnail" do
-
-    describe "failure" do
-
-      class InspectableFile
-        include Seamus
-      end
+  describe "md5 hashcode calculation" do
+    
+    before(:each) do
+      @movie = Seamus::Builder.new(Factories::mov.path)
+    end
+    
+    it "creates a md5 instance" do
+      Digest::MD5.should_receive(:file).
+                  with(@movie.path).
+                  and_return("Digest_MD5_instance")
+      @movie.md5.should eql("Digest_MD5_instance")
+    end
 
+    it "Base64 encodes a md5 hex string" do
+      @movie.stub!(:md5_digest).
+             and_return("md5-hexdigest-string")
+         
+      Base64.should_receive(:encode64).
+             with("md5-hexdigest-string").
+             and_return("base64-encoded")
+      @movie.md5_base64_encoded.should eql("base64-encoded")
+    end
+  end
+  
+  describe "on-demand classes" do
+    it "creates a ::Mov class for .mov files" do
+      @movie = Seamus::Builder.new(Factories::mov.path)      
+      @movie.should be_an_instance_of(Seamus::File::Mov)
     end
     
+    it "creates a ::Mp4 class for .mp4 files" do
+      @mpeg4 = Seamus::Builder.new(Factories::mp4.path)
+      @mpeg4.should be_an_instance_of(Seamus::File::Mp4)
+    end
+    
+    it "creates a ::Jpg class for .jpg files" do
+      @image = Seamus::Builder.new(Factories::jpg.path)  
+      @image.should be_an_instance_of(Seamus::File::Jpg)
+    end
+    
+    it "includes Seamus::File::Video into Mov" do
+      Seamus::File::Mov.superclass.should be(Seamus::File::Video)
+    end
+    
+    #etc
+    
   end
-end
+  
+end

data/spec/spec_helper.rb

@@ -1,10 +1,12 @@
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'rubygems'
 require 'Seamus'
 require 'spec'
 require 'spec/autorun'
 require 'fakefs/spec_helpers'
+require 'factories'
 
 Spec::Runner.configure do |config|
-  
+  include Factories
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: seamus
 version: !ruby/object:Gem::Version 
-  version: 0.2.4
+  version: 0.3.0
 platform: ruby
 authors: 
 - Scott Burton
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-26 00:00:00 -08:00
+date: 2010-02-10 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
@@ -35,22 +35,33 @@ files:
 - lib/core/numeric.rb
 - lib/mime_table.rb
 - lib/seamus.rb
-- lib/seamus/inspector.rb
+- lib/seamus/builder.rb
+- lib/seamus/file/application.rb
+- lib/seamus/file/audio.rb
+- lib/seamus/file/image.rb
+- lib/seamus/file/text.rb
+- lib/seamus/file/video.rb
 - lib/seamus/inspector/application_inspector.rb
 - lib/seamus/inspector/audio_inspector.rb
 - lib/seamus/inspector/image_inspector.rb
 - lib/seamus/inspector/text_inspector.rb
 - lib/seamus/inspector/video_inspector.rb
-- lib/seamus/processor.rb
 - lib/seamus/processor/application_processor.rb
 - lib/seamus/processor/audio_processor.rb
 - lib/seamus/processor/image_processor.rb
 - lib/seamus/processor/text_processor.rb
 - lib/seamus/processor/video_processor.rb
+- lib/seamus/standard_additions.rb
 - seamus.gemspec
+- spec/factories.rb
+- spec/fixtures/test.jpg
+- spec/fixtures/test.mov
+- spec/fixtures/test.mp4
 - spec/lib/core/numeric_spec.rb
 - spec/lib/seamus/inspector/image_inspector_spec.rb
+- spec/lib/seamus/inspector/video_inspector_spec.rb
 - spec/lib/seamus/processor/image_processor_spec.rb
+- spec/lib/seamus/processor/video_processor_spec.rb
 - spec/seamus_spec.rb
 - spec/spec_helper.rb
 has_rdoc: true
@@ -82,8 +93,11 @@ signing_key:
 specification_version: 3
 summary: Seamus is not an Irish monk
 test_files: 
+- spec/factories.rb
 - spec/lib/core/numeric_spec.rb
 - spec/lib/seamus/inspector/image_inspector_spec.rb
+- spec/lib/seamus/inspector/video_inspector_spec.rb
 - spec/lib/seamus/processor/image_processor_spec.rb
+- spec/lib/seamus/processor/video_processor_spec.rb
 - spec/seamus_spec.rb
 - spec/spec_helper.rb

data/lib/seamus/inspector.rb

@@ -1,20 +0,0 @@
-module Seamus
-  class Inspector
-    attr_reader :file
-
-    def initialize(file_path)
-      @file = File.open(file_path, "r")
-    end
-    
-    def stats
-      raise RuntimeError, "method called on base class"
-    end
-    
-    private    
-    
-    def file_stat
-      File::Stat.new(file.path)
-    end
-
-  end
-end

data/lib/seamus/processor.rb

@@ -1,16 +0,0 @@
-module Seamus
-  class Processor
-    attr_reader :file, :file_attributes
-
-    def initialize(file_path, file_attributes)
-      @file = File.open(file_path, "r")
-      @file_attributes = file_attributes
-    end
-    
-    # nodoc
-    def thumb_tempfile
-      Tempfile.new("#{File.basename(@file.path, File.extname(@file.path))}_thumb.jpg")
-    end
-    
-  end
-end