exiftoolr 0.0.4

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in exiftoolr.gemspec
+gemspec

data/README.md

@@ -0,0 +1,75 @@
+# Ruby wrapper for ExifTool
+
+This gem is the simplest thing that could possibly work that
+reads the output of [exiftool](http://www.sno.phy.queensu.ca/~phil/exiftool)
+and renders it into a ruby hash, with correctly typed values and symbolized keys.
+
+## Want constitutes "correct"?
+
+* GPS latitude and longitude are rendered as signed floats,
+  where north and east are positive, and west and south are negative.
+* Values like shutter speed and exposure time are rendered as Rationals,
+  which lets the caller show them as fractions (1/250) or as comparable.
+* String values like "interop" and "serial number" are kept as strings
+  (which preserves zero prefixes)
+
+## Installation
+
+You'll want to [install ExifTool](http://www.sno.phy.queensu.ca/~phil/exiftool/install.html), then
+
+```
+gem install exiftoolr
+```
+
+or add to your Gemfile:
+
+```
+gem 'exiftoolr'
+```
+
+and run ```bundle```.
+
+## Usage
+
+```ruby
+require 'exiftoolr'
+e = Exiftoolr.new("path/to/iPhone 4S.jpg")
+e.to_hash
+# => {:make => "Apple", :gps_longitude => -122.47566667, …
+e.to_display_hash
+# => {"Make" => "Apple", "GPS Longitude" => -122.47566667, …
+```
+
+### Multiple file support
+
+Supply an array to the Exiftoolr initializer, then use ```.result_for```:
+
+```ruby
+require 'exiftoolr'
+e = Exiftoolr.new(Dir["**/*.jpg"])
+result = e.result_for("path/to/iPhone 4S.jpg")
+result.to_hash
+# => {:make => "Apple", :gps_longitude => -122.47566667, …
+result[:gps_longitude]
+# => -122.47566667
+
+e.files_with_results
+# => ["path/to/iPhone 4S.jpg", "path/to/Droid X.jpg", …
+```
+
+### When things go wrong
+
+* ```Exiftoolr::NoSuchFile``` is raised if the provided filename doesn't exist.
+* ```Exiftoolr::ExiftoolNotInstalled``` is raised if ```exiftool``` isn't in your ```PATH```.
+* If ExifTool has a problem reading EXIF data, no exception is raised, but ```#errors?``` will return true:
+
+```ruby
+Exiftoolr.new("Gemfile").errors?
+#=> true
+```
+
+## Change history
+
+### 0.0.4
+
+Added support for multiple file fetching (which is *much* faster for large directories)

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new
+task :default => :test

data/exiftoolr.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "exiftoolr/version"
+
+Gem::Specification.new do |s|
+  s.name        = "exiftoolr"
+  s.version     = Exiftoolr::VERSION
+  s.authors     = ["Matthew McEachen"]
+  s.email       = ["matthew-github@mceachen.org"]
+  s.homepage    = "https://github.com/mceachen/exif_tooler"
+  s.summary     = %q{Multiget ExifTool wrapper for ruby}
+  s.description = %q{Multiget ExifTool wrapper for ruby}
+
+  s.rubyforge_project = "exiftoolr"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.requirements << "ExifTool (see http://www.sno.phy.queensu.ca/~phil/exiftool/)"
+
+  s.add_dependency "json"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec"
+end

data/lib/exiftoolr.rb

@@ -0,0 +1,64 @@
+require "exiftoolr/version"
+require "exiftoolr/result"
+
+require 'json'
+require 'shellwords'
+
+class Exiftoolr
+  class NoSuchFile < StandardError; end
+  class NotAFile < StandardError; end
+  class ExiftoolNotInstalled < StandardError; end
+
+  def self.exiftool_installed?
+    `exiftool -ver 2> /dev/null`.to_f > 0
+  end
+
+  def self.expand_path(filename)
+    raise NoSuchFile, filename unless File.exist?(filename)
+    raise NotAFile, filename unless File.file?(filename)
+    File.expand_path(filename)
+  end
+
+  def initialize(filenames, exiftool_opts = "")
+    escaped_filenames = filenames.to_a.collect do |f|
+      Shellwords.escape(self.class.expand_path(f))
+    end.join(" ")
+    json = `exiftool #{exiftool_opts} -j −coordFormat "%.8f" -dateFormat "%Y-%m-%d %H:%M:%S" #{escaped_filenames} 2> /dev/null`
+    raise ExiftoolNotInstalled if json == ""
+    @file2result = { }
+    JSON.parse(json).each do |raw|
+      @file2result[r.source_file] = Result.new(raw)
+    end
+  end
+
+  def result_for(filename)
+    @file2result[self.class.expand_path(filename)]
+  end
+
+  def files_with_results
+    @file2result.values.collect{|r|r.source_file unless r.errors?}.compact
+  end
+
+  def to_hash
+    first.to_hash
+  end
+
+  def to_display_hash
+    first.to_display_hash
+  end
+
+  def symbol_display_hash
+    first.symbol_display_hash
+  end
+
+  def errors?
+    @file2result.values.any? { |ea| ea.errors? }
+  end
+
+  private
+
+  def first
+    raise InvalidArgument, "use #result_for when multiple filenames are used" if @file2result.size > 1
+    @file2result.values.first
+  end
+end

data/lib/exiftoolr/result.rb

@@ -0,0 +1,47 @@
+require 'time'
+require 'rational'
+
+class Exiftoolr
+  class Result
+    attr_reader :to_hash, :to_display_hash, :symbol_display_hash
+
+    WORD_BOUNDARY_RES = [/([A-Z\d]+)([A-Z][a-z])/, /([a-z\d])([A-Z])/]
+    FRACTION_RE = /\d+\/\d+/
+
+    def initialize(raw_hash)
+      @raw_hash = raw_hash
+      @to_hash = { }
+      @to_display_hash = { }
+      @symbol_display_hash = { }
+
+      @raw_hash.each do |k, v|
+        display_key = WORD_BOUNDARY_RES.inject(k) { |key, regex| key.gsub(regex, '\1 \2') }
+        sym_key = display_key.downcase.gsub(' ', '_').to_sym
+        if sym_key == :gps_latitude || sym_key == :gps_longitude
+          value, direction = v.split(" ")
+          v = value.to_f
+          v *= -1 if direction == 'S' || direction == 'W'
+        elsif display_key =~ /\bdate\b/i
+          v = Time.parse(v)
+        elsif v =~ FRACTION_RE
+          v = Rational(*v.split('/').collect { |ea| ea.to_i })
+        end
+        @to_hash[sym_key] = v
+        @to_display_hash[display_key] = v
+        @symbol_display_hash[sym_key] = display_key
+      end
+    end
+
+    def [](key)
+      @to_hash[key]
+    end
+
+    def source_file
+      self[:source_file]
+    end
+
+    def errors?
+      self[:error] == "Unknown file type" || self[:warning] == "Unsupported file type"
+    end
+  end
+end

data/lib/exiftoolr/version.rb

@@ -0,0 +1,3 @@
+class Exiftoolr
+  VERSION = "0.0.4"
+end

data/test/Canon 20D.jpg.yaml

@@ -0,0 +1,225 @@
+--- 
+:color_temp_custom2: 4792
+:sensor_left_border: 84
+:flash_activity: 0
+:measured_rggb: 674 1024 1024 670
+:photo_effect: "Off"
+:digital_zoom: None
+:af_points_in_focus: 4
+:color_temp_shade: 7000
+:y_cb_cr_sub_sampling: YCbCr4:2:2 (2 1)
+:metering_mode: Evaluative
+:image_size: 3504x2336
+:canon_model_id: EOS 20D
+:bracket_mode: "Off"
+:camera_type: EOS Mid-range
+:exposure_mode: Auto
+:tone_curve: Standard
+:af_area_x_positions: 8 -555 571 -931 8 947 -555 571 8
+:color_tone: Normal
+:af_image_width: 3504
+:max_aperture: 5.6
+:aeb_bracket_value: 0
+:shutter_curtain_sync: 1st-curtain sync
+:aeb_sequence_auto_cancel: 0,-,+/Enabled
+:scale_factor35efl: 1.6
+:lens_af_stop_button: AF stop
+:add_original_decision_data: "Off"
+:thumbnail_image: (Binary data 11259 bytes)
+:flash_sync_speed_av: Auto
+:black_mask_right_border: 0
+:base_iso: 200
+:image_width: 3504
+:focal_plane_x_resolution: 2886.363636
+:exposure_program: Program AE
+:safety_shift_in_av_or_tv: Disable
+:measured_ev: 13.25
+:continuous_drive: Single
+:red_balance: 1.943842
+:file_name: Canon 20D.jpg
+:white_balance_blue: 0
+:lens: 17.0 - 85.0 mm
+:digital_gain: 0
+:macro_mode: Normal
+:wb_rggb_levels_flash: 2187 1023 1023 1333
+:menu_button_display_position: Previous (top if power off)
+:sensor_height: 2360
+:file_size: 2.9 MB
+:black_mask_top_border: 0
+:ettlii: Evaluative
+:af_area_width: 78
+:f_number: 9.0
+:directory: test
+:black_mask_bottom_border: 0
+:focal_plane_y_size: 15.37 mm
+:toning_effect: None
+:af_area_y_positions: 504 270 270 4 4 4 -262 -262 -496
+:focal_plane_y_resolution: 2885.805763
+:target_aperture: 9
+:focus_mode: One-shot AF
+:mirror_lockup: Disable
+:color_temp_flash: 6309
+:make: Canon
+:set_function_when_shooting: Image replay
+:wb_bracket_value_gm: 0
+:exposure_time: !ruby/object:Rational 
+  denominator: 250
+  numerator: 1
+:thumbnail_offset: 9728
+:canon_flash_mode: "Off"
+:serial_number: 0330113864
+:fov: 15.4 deg
+:thumbnail_image_valid_area: 0 159 7 112
+:af_point_selection_method: Normal
+:color_space: sRGB
+:original_decision_data_offset: 0
+:lens_id: Unknown 17-85mm
+:shutter_speed: !ruby/object:Rational 
+  denominator: 250
+  numerator: 1
+:light_value: 13.3
+:superimposed_display: "On"
+:exposure_compensation: 0
+:orientation: Horizontal (normal)
+:components_configuration: Y, Cb, Cr, -
+:"shutter-ae_lock": AF/AE lock
+:focal_length: 85.0 mm
+:focal_length35efl: "85.0 mm (35 mm equivalent: 132.8 mm)"
+:bracket_shot_number: 0
+:model: Canon EOS 20D
+:aperture_value: 9.0
+:flash_guide_number: 0
+:long_exposure_noise_reduction2: "Off"
+:focal_plane_x_size: 23.04 mm
+:sequence_number: 0
+:long_exposure_noise_reduction: "Off"
+:white_balance: Auto
+:file_type: JPEG
+:canon_exposure_mode: Program AE
+:interop_version: "0100"
+:canon_image_width: 3504
+:color_temp_fluorescent: 3952
+:canon_firmware_version: Firmware 1.0.2
+:sharpness: "+1"
+:color_temp_auto: 4662
+:af_assist_beam: Emits
+:iso: 200
+:black_mask_left_border: 0
+:color_temp_custom1: 6163
+:focal_plane_resolution_unit: inches
+:wb_rggb_levels_custom1: 2095 1023 1023 1316
+:flash_bits: (none)
+:sensor_right_border: 3587
+:bracket_value: 0
+:canon_image_type: Canon EOS 20D
+:exif_version: "0221"
+:exif_image_width: 3504
+:encoding_process: Baseline DCT, Huffman coding
+:contrast: "+1"
+:file_modify_date: 2012-02-19 21:49:48 -08:00
+:white_balance_red: 0
+:auto_rotate: None
+:scene_capture_type: Standard
+:compression: JPEG (old-style)
+:sensor_red_level: 0
+:control_mode: Camera Local Control
+:sensor_width: 3596
+:shooting_mode: Program AE
+:lens_type: Unknown (-1)
+:sensor_blue_level: 0
+:file_permissions: rw-r--r--
+:num_af_points: 9
+:focus_continuous: Single
+:color_temp_tungsten: 3196
+:thumbnail_length: 11259
+:target_exposure_time: !ruby/object:Rational 
+  denominator: 251
+  numerator: 1
+:valid_af_points: 9
+:long_focal: 85 mm
+:wb_rggb_levels_daylight: 1995 1023 1023 1509
+:interop_index: R98 - DCF basic file (sRGB)
+:canon_image_height: 2336
+:create_date: 2004-09-19 12:25:20 -07:00
+:wb_bracket_mode: "Off"
+:focal_units: 1/mm
+:serial_number_format: Format 2
+:short_focal: 17 mm
+:sensor_top_border: 19
+:measured_ev2: 13.5
+:image_height: 2336
+:color_temp_as_shot: 4662
+:flash: Off, Did not fire
+:iso_expansion: "On"
+:record_mode: JPEG
+:flashpix_version: "0100"
+:wb_rggb_levels_tungsten: 1410 1023 1023 2408
+:blue_balance: 1.638424
+:sensor_bottom_border: 2354
+:circle_of_confusion: 0.019 mm
+:exif_byte_order: Little-endian (Intel, II)
+:custom_rendered: Normal
+:drive_mode: Single-frame Shooting
+:color_components: 3
+:x_resolution: 72
+:exif_image_height: 2336
+:aperture: 9.0
+:easy_mode: Manual
+:nd_filter: n/a
+:exposure_level_increments: !ruby/object:Rational 
+  denominator: 3
+  numerator: 1
+:auto_exposure_bracketing: "Off"
+:af_area_height: 78
+:flash_firing: Fires
+:wb_rggb_levels_custom2: 1912 1023 1023 1627
+:self_timer2: 0
+:lens35efl: "17.0 - 85.0 mm (35 mm equivalent: 26.6 - 132.8 mm)"
+:mime_type: image/jpeg
+:wb_rggb_levels_shade: 2292 1023 1023 1267
+:canon_image_size: Large
+:hyperfocal_distance: 41.74 m
+:wb_rggb_levels_auto: 1973 1023 1023 1663
+:zoom_source_width: 0
+:auto_iso: 100
+:vrd_offset: 0
+:wb_shift_gm: 0
+:wb_rggb_levels_fluorescent: 1797 1023 1023 2058
+:color_temperature: 4800
+:wb_rggb_levels: 1973 1015 1015 1663
+:wb_shift_ab: 0
+:user_comment: ""
+:zoom_target_width: 0
+:quality: Fine
+:color_temp_cloudy: 6000
+:af_image_height: 2336
+:manual_flash_output: n/a
+:flash_exposure_comp: 0
+:wb_rggb_levels_cloudy: 2160 1023 1023 1373
+:source_file: test/Canon 20D.jpg
+:color_temp_daylight: 5200
+:sharpness_frequency: n/a
+:slow_shutter: None
+:modify_date: 2004-09-19 12:25:20 -07:00
+:bulb_duration: 0
+:bits_per_sample: 8
+:focus_range: Not Known
+:saturation: "+1"
+:focal_type: Zoom
+:wb_rggb_levels_as_shot: 1973 1015 1015 1663
+:min_aperture: 32
+:exif_tool_version: 8.59
+:y_resolution: 72
+:date_time_original: 2004-09-19 12:25:20 -07:00
+:shutter_speed_value: !ruby/object:Rational 
+  denominator: 250
+  numerator: 1
+:filter_effect: None
+:resolution_unit: inches
+:y_cb_cr_positioning: Co-sited
+:picture_style: None
+:file_number: 793-9390
+:self_timer: "Off"
+:wb_bracket_value_ab: 0
+:optical_zoom_code: n/a
+:owner_name: unknown

data/test/Droid X.jpg.yaml

@@ -0,0 +1,87 @@
+--- 
+:exposure_compensation: 0
+:model: DROIDX 6d460001fff80000015d7d330e01c011
+:color_space: sRGB
+:components_configuration: Cb, Y, Cr, Y
+:exif_byte_order: Little-endian (Intel, II)
+:sensing_method: One-chip color area
+:create_date: 2010-12-08 01:15:37 -08:00
+:bits_per_sample: 8
+:date_time_original: 2010-12-08 01:15:37 -08:00
+:source_file: test/Droid X.jpg
+:thumbnail_length: 32586
+:exif_image_width: 3264
+:scene_type: Directly photographed
+:contrast: Normal
+:exposure_program: Program AE
+:compression: JPEG (old-style)
+:image_size: 3264x1840
+:max_aperture_value: 2.8
+:mime_type: image/jpeg
+:x_resolution: 300
+:interop_version: "0100"
+:orientation: Rotate 90 CW
+:software: 2.2
+:thumbnail_offset: 2150
+:shutter_speed: !ruby/object:Rational 
+  denominator: 15
+  numerator: 1
+:directory: test
+:flashpix_version: "0100"
+:y_cb_cr_positioning: Centered
+:flash: Auto, Did not fire
+:f_number: 2.8
+:saturation: Normal
+:file_modify_date: 2012-02-19 21:49:48 -08:00
+:y_resolution: 300
+:encoding_process: Baseline DCT, Huffman coding
+:subject_distance: 0 m
+:thumbnail_image: (Binary data 32586 bytes)
+:white_balance: Auto
+:metering_mode: Center-weighted average
+:exposure_mode: Auto
+:compressed_bits_per_pixel: 4
+:circle_of_confusion: 0.004 mm
+:color_components: 3
+:image_height: 1840
+:exif_tool_version: 8.59
+:subject_distance_range: Unknown
+:exposure_time: !ruby/object:Rational 
+  denominator: 15
+  numerator: 1
+:resolution_unit: inches
+:scene_capture_type: Standard
+:file_name: Droid X.jpg
+:image_unique_id: ""
+:hyperfocal_distance: 2.24 m
+:focal_length35efl: "5.0 mm (35 mm equivalent: 38.0 mm)"
+:light_source: Standard Light A
+:y_cb_cr_sub_sampling: YCbCr4:2:0 (2 2)
+:aperture: 2.8
+:interop_index: R98 - DCF basic file (sRGB)
+:fov: 50.7 deg
+:brightness_value: -0.8203125
+:file_permissions: rwxr-xr-x
+:exif_version: "0220"
+:digital_zoom_ratio: 0
+:sharpness: Normal
+:custom_rendered: Custom
+:aperture_value: 2.8
+:exif_image_height: 1840
+:focal_length: 5.0 mm
+:gain_control: High gain up
+:light_value: 4.2
+:modify_date: 2010-12-08 01:15:37 -08:00
+:shutter_speed_value: !ruby/object:Rational 
+  denominator: 15
+  numerator: 1
+:make: Motorola
+:exposure_index: 637
+:file_size: 2023 kB
+:focal_length_in35mm_format: 38 mm
+:image_width: 3264
+:user_comment: ""
+:file_type: JPEG
+:scale_factor35efl: 7.6
+:iso: 637
+:file_source: Digital Camera

data/test/faces.jpg.yaml

@@ -0,0 +1,327 @@
+--- 
+:black_mask_bottom_border: 0
+:red_trc: (Binary data 14 bytes)
+:wb_rggb_levels_custom2: 1734 1023 1023 1901
+:serial_number: 0720413239
+:fov: 68.3 deg
+:self_timer2: 0
+:file_size: 3.8 MB
+:wb_rggb_levels: 1822 1015 1015 1709
+:wb_shift_ab: 0
+:lens35efl: "17.0 - 40.0 mm (35 mm equivalent: 26.6 - 62.5 mm)"
+:thumbnail_image_valid_area: 0 159 7 112
+:"profile_description_ml-zh-cn": !binary |
+  55u45py6IFJHQiDmj4/ov7Dmlofku7Y=
+
+:current_iptc_digest: b443520a10119da99c2550175e6d0efb
+:model: Canon EOS 20D
+:af_point_selection_method: Normal
+:aperture_value: 4.0
+:coded_character_set: UTF8
+:user_comment: ""
+:color_space: sRGB
+:focus_range: Not Known
+:"profile_description_ml-ja-jp": !binary |
+  44Kr44Oh44OpIFJHQiDjg5fjg63jg5XjgqHjgqTjg6s=
+
+:zoom_target_width: 0
+:device_model: ""
+:flash_guide_number: 0
+:focal_plane_x_size: 23.04 mm
+:saturation: Normal
+:quality: Fine
+:"profile_description_ml-it-it": Profilo RGB Fotocamera
+:focal_type: Zoom
+:iso: 400
+:sequence_number: 0
+:profile_file_signature: acsp
+:wb_rggb_levels_as_shot: 1822 1015 1015 1709
+:black_mask_left_border: 0
+:long_exposure_noise_reduction2: "Off"
+:color_temp_custom2: 4301
+:blue_trc: (Binary data 14 bytes)
+:color_temp_custom1: 2694
+:compression: JPEG (old-style)
+:exif_tool_version: 8.59
+:focal_plane_resolution_unit: inches
+:sensor_left_border: 84
+:sensor_red_level: 0
+:wb_rggb_levels_custom1: 1096 1023 1023 2793
+:"profile_description_ml-ko-kr": !binary |
+  7Lm066mU6528IFJHQiDtlITroZztjIzsnbw=
+
+:photo_effect: "Off"
+:af_area_x_positions: 8 -555 571 -931 8 947 -555 571 8
+:profile_version: 2.2.0
+:control_mode: Camera Local Control
+:flash_activity: 0
+:connection_space_illuminant: 0.9642 1 0.82491
+:sensor_width: 3596
+:color_tone: Normal
+:measured_rggb: 641 1024 1024 660
+:create_date: 2005-11-26 14:20:34 -08:00
+:shooting_mode: Depth-of-field AE
+:application_record_version: 4
+:af_image_width: 3504
+:wb_bracket_mode: "Off"
+:lens_type: Unknown (-1)
+:focal_units: 1/mm
+:make: Canon
+:safety_shift_in_av_or_tv: Enable
+:aeb_bracket_value: 0
+:profile_id: 0
+:software: Picasa
+:serial_number_format: Format 2
+:measured_ev: 14.12
+:shutter_curtain_sync: 1st-curtain sync
+:white_balance_blue: 0
+:exif_byte_order: Little-endian (Intel, II)
+:short_focal: 17 mm
+:device_attributes: Reflective, Glossy, Positive, Color
+:region_area_y: 
+- 0.248716
+- 0.486301
+- 0.243365
+- 0.360873
+- 0.466182
+:custom_rendered: Normal
+:sensor_top_border: 19
+:focal_plane_y_size: 15.37 mm
+:continuous_drive: Single
+:profile_cmm_type: appl
+:drive_mode: Single-frame Shooting
+:toning_effect: None
+:red_balance: 1.795074
+:af_area_y_positions: 504 270 270 4 4 4 -262 -262 -496
+:mime_type: image/jpeg
+:color_components: 3
+:region_area_x: 
+- 0.549658
+- 0.858162
+- 0.730736
+- 0.453196
+- 0.118579
+:wb_rggb_levels_shade: 2215 1023 1023 1341
+:x_resolution: 72
+:cmm_flags: Not Embedded, Independent
+:focus_mode: One-shot AF
+:"profile_description_ml-fi-fi": Kameran RGB-profiili
+:blue_matrix_column: 0.15662 0.08336 0.71953
+:canon_image_size: Large
+:original_decision_data_offset: 3968887
+:focal_plane_y_resolution: 3959.322034
+:hyperfocal_distance: 3.76 m
+:lens_id: Unknown 17-40mm
+:target_aperture: 4
+:color_temp_cloudy: 6000
+:wb_rggb_levels_auto: 1822 1023 1023 1709
+:envelope_record_version: 4
+:shutter_speed: !ruby/object:Rational 
+  denominator: 4000
+  numerator: 1
+:color_space_data: "RGB "
+:af_image_height: 2336
+:zoom_source_width: 0
+:exposure_compensation: 0
+:long_exposure_noise_reduction: "On"
+:light_value: 14.0
+:region_applied_to_dimensions_unit: pixel
+:manual_flash_output: n/a
+:y_resolution: 72
+:white_balance: Auto
+:flash_exposure_comp: !ruby/object:Rational 
+  denominator: 3
+  numerator: 2
+:superimposed_display: "On"
+:date_time_original: 2005-11-26 14:20:34 -08:00
+:wb_rggb_levels_cloudy: 2087 1023 1023 1459
+:region_applied_to_dimensions_h: 2336
+:interop_version: "0100"
+:flash_bits: (none)
+:shutter_speed_value: !ruby/object:Rational 
+  denominator: 4000
+  numerator: 1
+:source_file: test/faces.jpg
+:file_type: JPEG
+:file_name: faces.jpg
+:iptc_digest: b443520a10119da99c2550175e6d0efb
+:filter_effect: None
+:sensor_right_border: 3587
+:canon_exposure_mode: Depth-of-field AE
+:"profile_description_ml-es-es": "Perfil RGB para C\xC3\xA1mara"
+:profile_description_ml: Camera RGB Profile
+:resolution_unit: inches
+:region_area_w: 
+- 0.0667808
+- 0.103881
+- 0.0687785
+- 0.0753424
+- 0.11387
+:bracket_value: 0
+:digital_zoom: None
+:y_cb_cr_positioning: Co-sited
+:exif_image_width: 3504
+:af_points_in_focus: 0,1,2,3,4,5,6,7,8
+:color_temp_shade: 7000
+:sensor_blue_level: 0
+:canon_image_type: Canon EOS 20D
+:region_applied_to_dimensions_w: 3504
+:num_af_points: 9
+:exif_version: "0221"
+:y_cb_cr_sub_sampling: YCbCr4:2:2 (2 1)
+:color_temp_tungsten: 3203
+:aeb_sequence_auto_cancel: 0,-,+/Enabled
+:metering_mode: Center-weighted average
+:thumbnail_length: 12170
+:green_matrix_column: 0.35332 0.67441 0.09042
+:scale_factor35efl: 1.6
+:image_size: 3504x2336
+:measured_ev2: 14.125
+:focus_continuous: Single
+:primary_platform: Apple Computer Inc.
+:lens_af_stop_button: ONE SHOT <-> AI SERVO
+:media_white_point: 0.95047 1 1.0891
+:image_height: 2336
+:file_permissions: rw-r--r--
+:lens: 17.0 - 40.0 mm
+:add_original_decision_data: "On"
+:"profile_description_ml-nl-nl": RGB-profiel Camera
+:profile_class: Input Device Profile
+:flash: Off, Did not fire
+:digital_gain: 0
+:thumbnail_image: (Binary data 12170 bytes)
+:exif_image_height: 2336
+:iso_expansion: "Off"
+:red_matrix_column: 0.45427 0.24263 0.01482
+:macro_mode: Normal
+:aperture: 4.0
+:color_temp_as_shot: 4599
+:rendering_intent: Perceptual
+:directory: test
+:wb_rggb_levels_flash: 2112 1023 1023 1414
+:mirror_lockup: Disable
+:menu_button_display_position: Previous (top if power off)
+:profile_copyright: Copyright 2003 Apple Computer Inc., all rights reserved.
+:easy_mode: Manual
+:auto_exposure_bracketing: "Off"
+:color_temp_flash: 6303
+:sensor_height: 2360
+:auto_iso: 100
+:nd_filter: n/a
+:set_function_when_shooting: Change quality
+:green_trc: (Binary data 14 bytes)
+:vrd_offset: 0
+:exposure_level_increments: !ruby/object:Rational 
+  denominator: 3
+  numerator: 1
+:wb_bracket_value_gm: 0
+:region_area_h: 
+- 0.119007
+- 0.1875
+- 0.12286
+- 0.101884
+- 0.189212
+:wb_rggb_levels_fluorescent: 1743 1023 1023 2205
+:orientation: Horizontal (normal)
+:exposure_time: !ruby/object:Rational 
+  denominator: 4000
+  numerator: 1
+:components_configuration: Y, Cb, Cr, -
+:color_temp_daylight: 5200
+:region_area_unit: 
+- normalized
+- normalized
+- normalized
+- normalized
+- normalized
+:color_temperature: 4300
+:thumbnail_offset: 4036
+:sharpness_frequency: n/a
+:wb_shift_gm: 0
+:"profile_description_ml-da-dk": RGB-beskrivelse til Kamera
+:region_name: 
+- Matthew McEachen
+- Karen McEachen
+- Ruth McEachen
+- James McEachen
+- Jamie McEachen
+:focal_length: 17.0 mm
+:device_manufacturer: appl
+:slow_shutter: None
+:canon_image_width: 3504
+:focal_length35efl: "17.0 mm (35 mm equivalent: 26.6 mm)"
+:warning: Invalid original decision data
+:bulb_duration: 0
+:color_temp_fluorescent: 3961
+:bracket_shot_number: 0
+:"profile_description_ml-pt-br": "Perfil RGB de C\xC3\xA2mera"
+:picture_style: None
+:bits_per_sample: 8
+:region_type: 
+- Face
+- Face
+- Face
+- Face
+- Face
+:canon_firmware_version: Firmware 2.0.3
+:sharpness: 0
+:file_number: 326-2647
+:modify_date: 2012-02-15 22:58:07 -08:00
+:"profile_description_ml-zh-tw": !binary |
+  5pW45L2N55u45qmfIFJHQiDoibLlvanmj4/ov7A=
+
+:self_timer: "Off"
+:encoding_process: Baseline DCT, Huffman coding
+:color_temp_auto: 4599
+:profile_creator: appl
+:af_assist_beam: Emits
+:optical_zoom_code: n/a
+:contrast: Normal
+:white_balance_red: 0
+:owner_name: unknown
+:xmp_toolkit: XMP Core 5.1.2
+:canon_model_id: EOS 20D
+:wb_bracket_value_ab: 0
+:target_exposure_time: !ruby/object:Rational 
+  denominator: 4008
+  numerator: 1
+:auto_rotate: None
+:bracket_mode: "Off"
+:valid_af_points: 9
+:scene_capture_type: Standard
+:exposure_mode: Auto
+:tone_curve: Standard
+:chromatic_adaptation: 1.04788 0.02292 -0.0502 0.02957 0.99049 -0.01706 -0.00923 0.01508 0.75165
+:long_focal: 40 mm
+:file_modify_date: 2012-02-19 21:49:48 -08:00
+:flash_sync_speed_av: Auto
+:"profile_description_ml-sv-se": "RGB-profil f\xC3\xB6r Kamera"
+:profile_connection_space: "XYZ "
+:wb_rggb_levels_daylight: 1933 1023 1023 1607
+:black_mask_right_border: 0
+:camera_type: EOS Mid-range
+:"profile_description_ml-de-de": "RGB-Profil f\xC3\xBCr Kameras"
+:record_mode: JPEG
+:interop_index: R98 - DCF basic file (sRGB)
+:profile_date_time: 2003-07-01 00:00:00 -07:00
+:base_iso: 400
+:focal_plane_x_resolution: 3959.322034
+:flashpix_version: "0100"
+:canon_image_height: 2336
+:"profile_description_ml-no-no": RGB-kameraprofil
+:profile_description: Camera RGB Profile
+:wb_rggb_levels_tungsten: 1382 1023 1023 2574
+:black_mask_top_border: 0
+:exposure_program: Not Defined
+:"profile_description_ml-fr-fu": "Profil RVB de l\xE2\x80\x99appareil-photo"
+:blue_balance: 1.683744
+:ettlii: Evaluative
+:image_width: 3504
+:"shutter-ae_lock": AF/AE lock
+:af_area_height: 78
+:sensor_bottom_border: 2354
+:af_area_width: 78
+:flash_firing: Fires
+:circle_of_confusion: 0.019 mm
+:canon_flash_mode: "Off"
+:f_number: 4.0

data/test/iPhone 4S.jpg.yaml

@@ -0,0 +1,80 @@
+--- 
+:gps_latitude_ref: North
+:model: iPhone 4S
+:color_space: sRGB
+:components_configuration: Y, Cb, Cr, -
+:exif_byte_order: Big-endian (Motorola, MM)
+:sensing_method: One-chip color area
+:create_date: 2011-11-23 09:39:52 -08:00
+:bits_per_sample: 8
+:date_time_original: 2011-11-23 09:39:52 -08:00
+:source_file: test/iPhone 4S.jpg
+:gps_img_direction: 121.9838275
+:thumbnail_length: 5987
+:exif_image_width: 3264
+:exposure_program: Program AE
+:compression: JPEG (old-style)
+:image_size: 3264x2448
+:mime_type: image/jpeg
+:gps_longitude: -122.47566667
+:x_resolution: 72
+:orientation: Horizontal (normal)
+:software: 5.0.1
+:thumbnail_offset: 914
+:gps_altitude_ref: Above Sea Level
+:shutter_speed: !ruby/object:Rational 
+  denominator: 6135
+  numerator: 1
+:directory: test
+:flashpix_version: "0100"
+:y_cb_cr_positioning: Centered
+:flash: Auto, Did not fire
+:f_number: 2.4
+:gps_altitude: 14.2 m Above Sea Level
+:file_modify_date: 2012-02-19 21:49:48 -08:00
+:y_resolution: 72
+:encoding_process: Baseline DCT, Huffman coding
+:thumbnail_image: (Binary data 5987 bytes)
+:exposure_mode: Auto
+:white_balance: Auto
+:circle_of_confusion: 0.004 mm
+:metering_mode: Multi-segment
+:gps_latitude: 37.50233333
+:color_components: 3
+:image_height: 2448
+:exif_tool_version: 8.59
+:exposure_time: !ruby/object:Rational 
+  denominator: 6135
+  numerator: 1
+:gps_longitude_ref: West
+:resolution_unit: inches
+:scene_capture_type: Standard
+:gps_position: 37.50233333 N, 122.47566667 W
+:file_name: iPhone 4S.jpg
+:hyperfocal_distance: 2.08 m
+:focal_length35efl: "4.3 mm (35 mm equivalent: 35.0 mm)"
+:y_cb_cr_sub_sampling: YCbCr4:2:0 (2 2)
+:aperture: 2.4
+:fov: 54.4 deg
+:brightness_value: 11.27442702
+:file_permissions: rw-r--r--
+:gps_img_direction_ref: True North
+:exif_version: "0221"
+:sharpness: Normal
+:gps_time_stamp: "19:03:32"
+:aperture_value: 2.4
+:exif_image_height: 2448
+:focal_length: 4.3 mm
+:light_value: 15.8
+:modify_date: 2011-11-23 09:39:52 -08:00
+:shutter_speed_value: !ruby/object:Rational 
+  denominator: 6135
+  numerator: 1
+:make: Apple
+:file_size: 1954 kB
+:subject_area: 1631 1223 881 881
+:focal_length_in35mm_format: 35 mm
+:image_width: 3264
+:file_type: JPEG
+:scale_factor35efl: 8.2
+:iso: 64

data/test/test_exiftoolr.rb

@@ -0,0 +1,62 @@
+require "test/unit"
+require "exiftoolr"
+require "yaml"
+
+class TestExiftoolr < Test::Unit::TestCase
+
+  DUMP_RESULTS = false
+
+  def test_missing
+    assert_raise Exiftoolr::NoSuchFile do
+      Exiftoolr.new("no/such/file")
+    end
+  end
+
+  def test_directory
+    assert_raise Exiftoolr::NotAFile do
+      Exiftoolr.new("lib")
+    end
+  end
+
+  def test_invalid_exif
+    assert Exiftoolr.new("Gemfile").errors?
+  end
+
+  def test_matches
+    Dir["**/*.jpg"].each do |filename|
+      e = Exiftoolr.new(filename)
+      validate_result(e, filename)
+    end
+  end
+
+  def validate_result(result, filename)
+    yaml_file = "#{filename}.yaml"
+    if File.exist?(yaml_file)
+      assert !result.errors?
+    else
+      assert result.errors?
+      return
+    end
+    exif = result.to_hash
+    File.open(yaml_file, 'w') { |out| YAML.dump(exif, out) } if DUMP_RESULTS
+    e = File.open(yaml_file) { |f| YAML::load(f) }
+    exif.keys.each do |k|
+      next if [:file_modify_date, :directory, :source_file].include? k
+      assert_equal e[k], exif[k], "Key '#{k}' was incorrect for #{filename}"
+    end
+  end
+
+  def test_multi_matches
+    filenames = Dir["**/*.jpg"].to_a
+    e = Exiftoolr.new(filenames)
+    filenames.each { |f| validate_result(e.result_for(f), f) }
+  end
+
+  def test_error_filtering
+    filenames = Dir["**/*.*"].to_a
+    e = Exiftoolr.new(filenames)
+    expected_files = Dir["**/*.jpg"].to_a.collect{|f|File.expand_path(f)}.sort
+    assert_equal expected_files, e.files_with_results.sort
+    filenames.each { |f| validate_result(e.result_for(f), f) }
+  end
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: exiftoolr
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 4
+  version: 0.0.4
+platform: ruby
+authors: 
+- Matthew McEachen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-23 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  name: json
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  name: rake
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  name: rspec
+  version_requirements: *id003
+description: Multiget ExifTool wrapper for ruby
+email: 
+- matthew-github@mceachen.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- exiftoolr.gemspec
+- lib/exiftoolr.rb
+- lib/exiftoolr/result.rb
+- lib/exiftoolr/version.rb
+- test/Canon 20D.jpg
+- test/Canon 20D.jpg.yaml
+- test/Droid X.jpg
+- test/Droid X.jpg.yaml
+- test/faces.jpg
+- test/faces.jpg.yaml
+- test/iPhone 4S.jpg
+- test/iPhone 4S.jpg.yaml
+- test/test_exiftoolr.rb
+homepage: https://github.com/mceachen/exif_tooler
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- ExifTool (see http://www.sno.phy.queensu.ca/~phil/exiftool/)
+rubyforge_project: exiftoolr
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Multiget ExifTool wrapper for ruby
+test_files: 
+- test/Canon 20D.jpg
+- test/Canon 20D.jpg.yaml
+- test/Droid X.jpg
+- test/Droid X.jpg.yaml
+- test/faces.jpg
+- test/faces.jpg.yaml
+- test/iPhone 4S.jpg
+- test/iPhone 4S.jpg.yaml
+- test/test_exiftoolr.rb