mini_exiftool 1.5.1 → 1.6.0

data/test/test_save.rb

@@ -70,4 +70,16 @@ class TestSave < TestCase
     assert_equal special_string_latin1, @mini_exiftool.title
   end
 
+  def test_save_bang
+    @mini_exiftool.orientation = 'some value'
+    exception = false
+    begin
+      @mini_exiftool.save!
+    rescue MiniExiftool::Error => e
+      assert_match /Orientation/, e.message
+      exception = true
+    end
+    assert exception, "No exception when save! with error."
+  end
+
 end

metadata

@@ -1,104 +1,87 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: mini_exiftool
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 1.6.0
   prerelease: 
-  version: 1.5.1
 platform: ruby
-authors: 
+authors:
 - Jan Friedrich
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-05-31 00:00:00 Z
-dependencies: []
-
-description: This library is wrapper for the Exiftool command-line application (http://www.sno.phy.queensu.ca/~phil/exiftool).
+date: 2012-07-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rim
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+description: ''
 email: janfri26@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files: []
+files:
 - README.rdoc
-- Tutorial.rdoc
-- lib/mini_exiftool.rb
-files: 
-- COPYING
 - Changelog
-- Manifest
-- README.rdoc
+- COPYING
 - Rakefile
-- TODO
-- Tutorial.rdoc
-- .yardopts
-- examples/external_photo.rb
-- examples/print_portraits.rb
-- examples/shift_time.rb
 - lib/mini_exiftool.rb
-- setup.rb
+- test/data/Bad_PreviewIFD.jpg
 - test/data/Canon.jpg
 - test/data/INFORMATION
 - test/data/test.jpg
+- test/data/test.jpg.json
 - test/data/test_special_dates.jpg
 - test/helpers_for_test.rb
+- test/test_bad_preview_ifd.rb
 - test/test_class_methods.rb
 - test/test_composite.rb
 - test/test_dumping.rb
+- test/test_from_hash.rb
 - test/test_read.rb
 - test/test_read_numerical.rb
 - test/test_save.rb
 - test/test_special.rb
 - test/test_special_dates.rb
 - test/test_write.rb
-- mini_exiftool.gemspec
-- test/test_bad_preview_ifd.rb
 homepage: http://gitorious.org/mini_exiftool
 licenses: []
-
-post_install_message: "\n\
-  +-----------------------------------------------------------------------+\n\
-  | Please ensure you have installed exiftool and it's found in your PATH |\n\
-  | (Try \"exiftool -ver\" on your commandline). For more details see       |\n\
-  | http://www.sno.phy.queensu.ca/~phil/exiftool/install.html             |\n\
-  +-----------------------------------------------------------------------+\n  "
-rdoc_options: 
-- --line-numbers
-- --inline-source
-- --title
-- Mini_exiftool
-- --main
-- README.rdoc
-require_paths: 
+post_install_message: ! "\n+-----------------------------------------------------------------------+\n|
+  Please ensure you have installed exiftool and it's found in your PATH |\n| (Try
+  \"exiftool -ver\" on your commandline). For more details see       |\n| http://www.sno.phy.queensu.ca/~phil/exiftool/install.html
+  \            |\n+-----------------------------------------------------------------------+\n
+  \ "
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "1.2"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: mini_exiftool
-rubygems_version: 1.8.24
+rubyforge_project: 
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: This library is wrapper for the Exiftool command-line application (http://www.sno.phy.queensu.ca/~phil/exiftool).
-test_files: 
-- test/helpers_for_test.rb
-- test/test_bad_preview_ifd.rb
-- test/test_class_methods.rb
-- test/test_composite.rb
-- test/test_dumping.rb
-- test/test_read.rb
-- test/test_read_numerical.rb
-- test/test_save.rb
-- test/test_special.rb
-- test/test_special_dates.rb
-- test/test_write.rb
+test_files: []

data/.yardopts

@@ -1 +0,0 @@
---files Tutorial.rdoc,examples/*.rb

data/Manifest

@@ -1,27 +0,0 @@
-COPYING
-Changelog
-Manifest
-README.rdoc
-Rakefile
-TODO
-Tutorial.rdoc
-.yardopts
-examples/external_photo.rb
-examples/print_portraits.rb
-examples/shift_time.rb
-lib/mini_exiftool.rb
-setup.rb
-test/data/Canon.jpg
-test/data/INFORMATION
-test/data/test.jpg
-test/data/test_special_dates.jpg
-test/helpers_for_test.rb
-test/test_class_methods.rb
-test/test_composite.rb
-test/test_dumping.rb
-test/test_read.rb
-test/test_read_numerical.rb
-test/test_save.rb
-test/test_special.rb
-test/test_special_dates.rb
-test/test_write.rb

data/TODO

@@ -1,2 +0,0 @@
-* Tests for managing tags with pstore
-* Looking for a solution to dump and restore DateTime instances with YAML

data/Tutorial.rdoc

@@ -1,139 +0,0 @@
-= Mini Tutorial
-
-
-== Installation
-
-* Installing the Exiftool command-line application from Phil Harvey
-  (see http://www.sno.phy.queensu.ca/~phil/exiftool/install.html)
-* Installing the Ruby library (<code>gem install mini_exiftool</code>)
-
-
-== Lesson 1: Reading Meta Data
-
-=== A Simple Example
-
- require 'rubygems'
- require 'mini_exiftool'
-
- photo = MiniExiftool.new 'photo.jpg'
- puts photo['DateTimeOriginal']
-
-
-=== Smart Tag Names
-In the example above we use <code>photo['DateTimeOriginal']</code> to
-get the value for the time the photo was taken. But tag names are not
-case sensitive and additional underlines are also irrelevant. So
-following expressions are equivalent:
- photo['DateTimeOriginal']
- photo['datetimeoriginal']
- photo['date_time_original']
-
-It is also possible to use symbols:
- photo[:DateTimeOriginal]
- photo[:datetimeoriginal]
- photo[:date_time_original]
-
-=== Nicer Access Via Dynamic Methods
-
-Using the []-method is the safest way to access to values of tags
-(e. g. Self-timer you can only access this way) but the smarter way is
-using dynamic method access. You can write:
- photo.datetimeoriginal
-or also
- photo.date_time_original
-
-
-=== Value Types
-
-Following types of values are at the moment supported:
-* Array (e. g. Keywords => ['tree', 'gras'])
-* Fixnum (e. g. ISO => 400)
-* Float (e. g. FNumber => 9.5)
-* String (e. g. Model => DYNAX 7D)
-* Time (e. g. DateTimeOriginal => 2005:09:13 20:08:50)
-
-Be aware, if there is only one value in a tag which can hold multiple
-values the result is'nt an array! But you can get one with the Array
-method:
-  # only _one_ keyword
-  p1 = MiniExiftool.new 'p1.jpg'
-  p1.keywords # => 'red'
-  # _more than one_ keywords
-  p3 = MiniExiftool.new 'p3.jpg'
-  p3.keywords # => ['red', 'yellow', 'green']
-
-  # if we want to get an array in both cases and don't know
-  # if there is one ore more values set let's take Array()
-  Array(p1.keywords) # => ['red']
-  Array(p3.keywords) # => ['red', 'yellow', 'green']
-
-The Exiftool command-line application has an option (-n) to get values
-as numbers if possible, in MiniExiftool you can do this with setting
-the <code>:numerical</code> option to +true+ while generating a new
-instance with new or using the <code>numerical=</code>-method
-combining with calling <code>reload</code>.
-
-Let's look at an example:
- # standard: numerical is false
- photo = MiniExiftool.new 'photo.jpg'
- photo.exposure_time # => '1/60' (String)
- # now with numerical is true
- photo.numerical = true
- photo.reload
- photo.exposure_time # => 0.01666667 (Float)
-This behaviour can be useful if you want to do calculations on the
-value, if you only want to show the value the standard behaviour is
-maybe better.
-
-The Time class of Ruby cannot handle timestamps before 1st January 1970
-on some platforms. If there are timestamps in files before this date it
-will result in an error. In this case we can set the option
-<code>:timestamps</code> to +DateTime+ to use DateTime objects instead
-of Time objects.
-
-There is another option <code>:composite</code>. If this is set to
-+false+ the composite tags are not calculated by the exiftool
-command-line application (option -e).
-
-=== Further Example
-
-For understanding reading access to meta data also have a look at the
-example file <code>print_portraits.rb</code> in the +examples+
-directory.
-
-== Lesson 2: Writing Meta Data
-
-
-=== Also A Very Simple Example
-
- require 'rubygems'
- require 'mini_exiftool'
-
- photo = MiniExiftool.new 'photo.jpg'
- photo.comment = 'hello world'
- photo.save
-
-
-=== Save Is Atomar
-
-If you have changed serval values and call the +save+-method either
-all changes will be written to the file or nothing. The return value
-of the +save+-method is +true+ if all values are written to the file
-otherwise save returns +false+. In the last case you can use the
-+errors+-method which returns a hash of the tags which values couldn't
-be writed with an error message for each of them.
-
-
-=== Interesting Methods
-
-Have a look at the <code>changed?</code>-method for checking if the
-value of a specific tag is changed or a changing in general is
-done. In the same way the +revert+-method reverts the value of a
-specific tag or in general all changes.
-
-You should also look at the rdoc information of MiniExiftool.
-
-=== Further Examples
-
-See external_photo.rb[link://file.external_photo.html], print_portraits.rb[link://file.print_portraits.html] and shift_time.rb[link://file.shift_time.html]  in the +examples+ directory.
-

data/examples/external_photo.rb

@@ -1,22 +0,0 @@
-# -- encoding: utf-8 --
-require 'open-uri'
-require 'rubygems'
-require 'mini_exiftool'
-
-unless ARGV.size == 1
-  puts "usage: ruby #{__FILE__} URI"
-  puts " i.e.: ruby #{__FILE__} http://www.23hq.com/janfri/photo/1535332/large"
-  exit -1
-end
-
-# Fetch an external photo
-filename = open(ARGV.first).path
-
-# Read the metadata
-photo = MiniExiftool.new filename
-
-# Print the metadata
-photo.tags.sort.each do |tag|
-#  puts "#{tag}: #{photo[tag]}"
-  puts tag.ljust(28) + photo[tag].to_s
-end

data/examples/print_portraits.rb

@@ -1,27 +0,0 @@
-# -- encoding: utf-8 --
-require 'rubygems'
-require 'mini_exiftool'
-
-unless ARGV.size > 0
-  puts "usage: ruby #{__FILE__} FILES"
-  puts " i.e.: ruby #{__FILE__} *.jpg"
-  exit -1
-end
-
-# Loop at all given files
-ARGV.each do |filename|
-  # If a given file isn't a photo MiniExiftool new method will throw
-  # an exception this we will catch
-  begin
-    photo = MiniExiftool.new filename
-    height = photo.image_height
-    width  = photo.image_width
-    # We define portait as a photo wich ratio of height to width is 
-    # larger than 0.7
-    if height / width > 0.7
-      puts filename
-    end
-  rescue MiniExiftool::Error => e
-    $stderr.puts e.message
-  end
-end

data/examples/shift_time.rb

@@ -1,30 +0,0 @@
-# -- encoding: utf-8 --
-require 'rubygems'
-require 'mini_exiftool'
-
-if ARGV.size < 2
-  puts "usage: ruby #{__FILE__} [+|-]SECONDS FILES"
-  puts " i.e.: ruby #{__FILE__} 3600 *.jpg"
-  exit -1
-end
-
-delta = ARGV.shift.to_i
-
-ARGV.each do |filename|
-  begin
-    photo = MiniExiftool.new filename
-  rescue MiniExiftool::Error => e
-    $stderr.puts e.message
-    exit -1
-  end
-  time = photo.date_time_original
-  # time is a Time object, so we can use the methods of it :)
-  photo.date_time_original = time + delta
-  save_ok = photo.save
-  if save_ok
-    fmt = '%Y-%m-%d %H:%M:%S'
-    puts "#{filename} changed: #{time.strftime(fmt)} -> #{(time + delta).strftime(fmt)}"
-  else
-    puts "#{filename} could not be changed"
-  end
-end

data/mini_exiftool.gemspec

@@ -1,31 +0,0 @@
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = "mini_exiftool"
-  s.version = "1.5.1"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Jan Friedrich"]
-  s.date = "2012-05-31"
-  s.description = "This library is wrapper for the Exiftool command-line application (http://www.sno.phy.queensu.ca/~phil/exiftool)."
-  s.email = "janfri26@gmail.com"
-  s.extra_rdoc_files = ["README.rdoc", "Tutorial.rdoc", "lib/mini_exiftool.rb"]
-  s.files = ["COPYING", "Changelog", "Manifest", "README.rdoc", "Rakefile", "TODO", "Tutorial.rdoc", ".yardopts", "examples/external_photo.rb", "examples/print_portraits.rb", "examples/shift_time.rb", "lib/mini_exiftool.rb", "setup.rb", "test/data/Canon.jpg", "test/data/INFORMATION", "test/data/test.jpg", "test/data/test_special_dates.jpg", "test/helpers_for_test.rb", "test/test_class_methods.rb", "test/test_composite.rb", "test/test_dumping.rb", "test/test_read.rb", "test/test_read_numerical.rb", "test/test_save.rb", "test/test_special.rb", "test/test_special_dates.rb", "test/test_write.rb", "mini_exiftool.gemspec", "test/test_bad_preview_ifd.rb"]
-  s.homepage = "http://gitorious.org/mini_exiftool"
-  s.post_install_message = "\n+-----------------------------------------------------------------------+\n| Please ensure you have installed exiftool and it's found in your PATH |\n| (Try \"exiftool -ver\" on your commandline). For more details see       |\n| http://www.sno.phy.queensu.ca/~phil/exiftool/install.html             |\n+-----------------------------------------------------------------------+\n  "
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Mini_exiftool", "--main", "README.rdoc"]
-  s.require_paths = ["lib"]
-  s.rubyforge_project = "mini_exiftool"
-  s.rubygems_version = "1.8.24"
-  s.summary = "This library is wrapper for the Exiftool command-line application (http://www.sno.phy.queensu.ca/~phil/exiftool)."
-  s.test_files = ["test/helpers_for_test.rb", "test/test_bad_preview_ifd.rb", "test/test_class_methods.rb", "test/test_composite.rb", "test/test_dumping.rb", "test/test_read.rb", "test/test_read_numerical.rb", "test/test_save.rb", "test/test_special.rb", "test/test_special_dates.rb", "test/test_write.rb"]
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-    else
-    end
-  else
-  end
-end