phtools 0.7.1 → 0.7.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a14a90150116d6d15d806bfbc9cbdee2c31529fe
-  data.tar.gz: 1dfe0672729732f267645b94ea15fc5a46f94ece
+  metadata.gz: fdb79b3f95706f20dc3105e159bba0228c5b7542
+  data.tar.gz: 976d6852897171998919dcbb3d771f46d729ae10
 SHA512:
-  metadata.gz: 0d2718da44ccfc5174cf1721c235905bfadae27b11714ee4e978e9389830052ecc069c1e8d61a989a0f72642146f1e995a57bf70ad6a08236b55317df383abae
-  data.tar.gz: 0885ca474c5040e1cb52285b003b5a39375b13df8c7c5f9dc2c2ef79775a7a8aa0ac50e06926706a9ed17c197de13f8c6b832e906bae3f7fbde02dc9a18e7198
+  metadata.gz: 5e996378046496d338500dfb1d8c4762b8f640684469db603c84a89a29f68d1219e96341c610254de6146785e2295b13caccae6ec64a97915c03bc10587c539b
+  data.tar.gz: 5214e3b953ef6dfd445df54f05115adb887cb4f595fed8f57b03cbafe875afa870d0aff7fee5176895d1fcf6015fae38830891d98e7dd5250e9ebf8a44fb6fe6

data/README.md

@@ -13,6 +13,8 @@ PHTOOLS is an instrument intended for photographers\photo enthusiasts who:
 * appreciate the use of internal metadata (EXIF, XMP etc.) beleiving it is the best way to keep context info of the picture
 * are Ok with the use of Command Line tools
 
+**********
+
 ## Installation
 ### Install for usage
 1. Get the latest [ruby](https://www.ruby-lang.org/) (>= 2.3) installed.
@@ -35,13 +37,17 @@ bundle exec cucumber
 bundle exec guard
 ```
 
+**********
+
 ## PHTOOLS Use cases
-### Use Case 1. Collect photos, videos, raw-photos from different sources into one place (for further processing)
 
+### USE CASE 1. Collect photos, videos, raw-photos from different sources into one place (for further processing)
 #### Given
 I have copies of SD Cards with photos, videos taken with DSLR camera on my Hard Disk in `~/Desktop/SDCard1` and in `~/Desktop/SDCard2`.
 
-And I have empty folder `~/Desktop/assets_staging` I would like to collect all the photo-files to.
+And I have empty folder `~/Desktop/assets_staging` (lets call it _working folder_).
+
+And I want all the photo-video files from SD copies (including ones placed deep inside the folder structure of the SD card) to be moved to the _working folder_.
 
 #### When
 I run:
@@ -56,8 +62,11 @@ And all videos are moved to `~/Desktop/assets_staging/VIDEO`.
 
 And all raw photo-files are moved to `~/Desktop/assets_staging/RAW`.
 
-### Use Case 2. Mass rename photos in accordance with PHTOOLS standard (and don't forget to backup before)
+==========
 
+### USE CASE 2. Renaming files in accordance with PHTOOLS standard
+
+#### USE CASE 2.1 Mass rename photos in accordance with PHTOOLS standard (and don't forget to backup before)
 #### Given
 I have dozens of photo-files in my working folder `~/Desktop/assets_staging`.
 
@@ -75,6 +84,65 @@ I get all photos in `~/Desktop/assets_staging` renamed according to PHTOOLS stan
 
 And I have all original photo-files are backed-up to `~/Desktop/assets_staging/backup`.
 
+==========
+
+#### USE CASE 2.2 Rename photos back to it's original names
+#### Given
+I have several photo files in my working folder `~/Desktop/assets_staging` renamed to PHTOOLS standard.
+
+And I want to get all the files renamed back to it's original names (given by DSLR camera)
+
+#### When
+I run:
+```sh
+cd ~/Desktop/assets_staging
+phls | phrename --clean
+```
+
+#### Then
+I get all photos in `~/Desktop/assets_staging` renamed to it's original names.
+
+==========
+
+#### USE CASE 2.3 Change author nickname in the filenames
+#### Given
+I have several photo files in my working folder `~/Desktop/assets_staging` renamed to PHTOOLS standard. Some photos were made by ANB, some photos were made by Alex (nick _ALE_) 
+
+And I want to change the author NICKNAME _ALE_ to _ALX_.
+
+#### When
+I run:
+```sh
+cd ~/Desktop/assets_staging
+phls '*ALE*'| phrename -a alx
+```
+
+#### Then
+I get all _ALE_ photos in `~/Desktop/assets_staging` renamed to _ALX_ nickname.
+
+And all _ANB_ photos are kept unchanged.
+
+_Note. `phrename` is smart enough to let the user to run it several times on one file. Every time `phrename -a` invoked it overwrites information added by previuos `phrename` run._ 
+
+==========
+
+#### USE CASE 2.4 Adjust date-time in the filename
+#### Given
+I have several video files taken by iPhone in my working folder `~/Desktop/assets_staging` renamed to PHTOOLS standard.
+
+And I've found out that iPhone gives the wrong value to CreateDate tag (in my case the error is minus 2 hours to real time of creation). Because of that 'phrename' gives the wrong _YYYYmmdd-HHMMSS_ timestamp in the filename. I want to get the correct date-time info in the names of video files. 
+
+#### When
+I run:
+```sh
+cd ~/Desktop/assets_staging
+phls '*.mov'| phrename --shift_time 7200
+```
+
+#### Then
+I get all _mov_ files in `~/Desktop/assets_staging` renamed with correct _YYYYmmdd-HHMMSS_ timestamp (+ 7200 second = + 2 hours than it was before).
+
+**********
 
 ## PHTOOLS concepts
 ### PHTOOLS Standard file name

data/TODO.md

@@ -9,3 +9,8 @@
 - [ ] phmove: make options to set video, raw folder names
 - [x] phrename: add -c --clean option (based on ftclname functionality)
 - [x] phrename: add -s --shift_time option (based on ftfixdate functionality)
+- [x] phrename: by-default read tags for DateTime in this order: DateTimeOriginal, DateCreated, CreateDate, DigitalCreationDate, FileModifyDate (eqv to File::mtime). 1st non-zero value will be taken as a master photo creation timestamp. It means no longer names like '00000101-000000_ANB IMG_0183.PNG' will appear.
+- [x] phrename: make it safe and smart. Once the file was renamed to PHTOOL standard, re-run of phrename should not change the date-time info unless options -t or -s are used. If user wants to reset file name using exif tag - 1st clean it `phrename --clean`, then rename `phrename -a anb`
+- [ ] phrename: make new usage mode: `phrename -t TAG`. Useful if user wants to re-set date-time using TAG keeping author-nickname unchanged
+- [x] get rid of nesty
+- [x] switch to fresh MiniExiftool gem

data/exe/phrename

@@ -11,24 +11,38 @@ module PhTools
 ***************************************************
 phtools - *Keep Your Photos In Order* (c) ANB
 ***************************************************
-#{tool_name} renames the input files based on EXIF
-DateTimeOriginal (or CreateDate) tag and author NICKNAME provided.
-The target file name format is YYYYmmdd-HHMMSS_AAA ORIGINAL.EXT, where:
-  YYYYmmdd-HHMMSS - Date-Time of photo creation (DateTimeOriginal tag),
+#{tool_name} renames the input file to Standard Name:
+  YYYYmmdd-HHMMSS_AAA ORIGINAL.EXT, where:
+  YYYYmmdd-HHMMSS - Date-Time of photo creation,
   AAA - the author nickname,
   ORIGINAL.EXT - the photo name given by digital camera.
-Input file should be one of the types: #{file_type * ','}
+By default date-time information will be taken from EXIF area as the 1st non-zero
+value of the tags (shown in the order the program scans values):
+  EXIF:DateTimeOriginal -> IPTC:DateCreated + IPTC:TimeCreated -> XMP:DateCreated ->
+  -> EXIF:CreateDate -> XMP:CreateDate -> IPTC:DigitalCreationDate + IPTC:DigitalCreationTime ->
+  -> FileModifyDate
 Example: input file DSC03455.JPG will be renamed to 20130108-124145_ANB DSC03455.JPG
-#{tool_name} is optimized to be used with other *phtools* via pipes, e.g.:
-  phls | #{tool_name} -a anb
 
-This program uses external utility ExifTool by Phil Harvey
+Input file should be one of the supported types: #{file_type * ','}.
+#{tool_name} acts as a 'filter' meaning it expects the input files to be passed
+to STDIN and after the job is done it produces STDOUT with the list of renamed
+files. In other words this command is intended to be used with other programs
+connected via pipes, e.g.:
+  phls | #{tool_name} -a anb | phmove ~/targed/folder
+
+The program is designed to be safe to re-run on the same file several times
+- every re-run produces the same result (idempotent behaviour).
+Once the file was renamed to Standard Name, the date-time kept in the name
+is considered as a master date-time of the photo creation and will not be
+changed by re-running #{tool_name} unless user explicitly sets '-t' or '-s' option.
+
+This program uses external utility ExifTool created by Phil Harvey
 (http://www.sno.phy.queensu.ca/~phil/exiftool/).
 
 Usage:
-  #{tool_name} -a NICK [-D] [-t TAG]
-  #{tool_name} -c [-D]
+  #{tool_name} -a NICK [-t TAG] [-D]
   #{tool_name} -s DELTA [-D]
+  #{tool_name} -c [-D]
   #{tool_name} -h | --help
   #{tool_name} -v | --version
 
@@ -37,19 +51,20 @@ Options:
                          supports only latin ASCII chars (e.g. ANB).
                          No digits, no spaces, no other non-word chars allowed.
 
-  -t TAG --tag_date=TAG  Set the TAG name containing Date_Time creation
-                         info. The TAG value will be used instead of
-                         standard DateTimeOriginal tag. All existing tags you
-                         can get using command `phls filename|phmtags -f`
-
-  -c --clean             Rename file(s) back to original name(s)
+  -t TAG --tag_date=TAG  Force program to use TAG as a Date-Time creation
+                         info instead of standard phtools tags.
+                         You can retreive all existing tags using command:
+                         `phls filename|phmtags -f` OR
+                         `exiftool -s filename`
 
   -s DELTA --shift_time=DELTA  DELTA (in seconds) will be added to Date-Time value
-                         of the filename. If DELTA is positive the photo
+                         kept in the name. If DELTA is positive the photo
                          will become yonger: e.g. 20140720-100005, DELTA = 65
                          result = 20140720-100110. If DELTA is negative the photo
                          will get DELTA seconds older.
 
+  -c --clean             Rename file back to it's original name
+
   -D --debug    Turn on debugging (verbose) mode
   -h --help     Show this screen.
   -v --version  Show version.

data/lib/phbackup.rb

@@ -36,7 +36,7 @@ module PhTools
     def process_file(phfile)
       backup_path = File.join(@backup_dir,
                               phfile.basename + phfile.extname)
-      FileUtils.cp(phfile.filename, backup_path, verbose: PhTools.debug)
+      FileUtils.cp(phfile.filename, backup_path, preserve: true, verbose: PhTools.debug)
       phfile
     rescue
       raise PhTools::Error, "file copying to #{@backup_dir}"

data/lib/phmove.rb

@@ -51,7 +51,7 @@ module PhTools
         phfile_out.dirname = @target_folder
       end
 
-      FileUtils.mv(phfile.filename, phfile_out.filename) unless phfile == phfile_out
+      FileUtils.mv(phfile.filename, phfile_out.filename, verbose: PhTools.debug) unless phfile == phfile_out
       phfile_out
     rescue SystemCallError => e
       raise PhTools::Error, 'file moving - ' + e.message

data/lib/phrename.rb

@@ -3,8 +3,8 @@
 # (c) ANB Andrew Bizyaev
 
 require 'date'
+require 'mini_exiftool'
 require 'phtools/runner'
-require 'phtools/mini_exiftool-2.3.0anb'
 
 module PhTools
   class Phrename < Runner
@@ -32,31 +32,81 @@ module PhTools
 
     def process_file(phfile)
       phfile_out = phfile.clone
+      info_msg = ''
       case @mode
       when :rename
-        begin
-          tag = MiniExiftool.new(phfile.filename, timestamps: DateTime)
-        rescue
-          raise PhTools::Error, 'EXIF tags reading'
-        end
-        if @user_tag_date.empty?
-          dto = tag.date_time_original || tag.create_date || PhFile::ZERO_DATE
-        else
-          fail PhTools::Error, "tag #{@user_tag_date} is not found" unless tag[@user_tag_date]
-          fail PhTools::Error, "tag #{@user_tag_date} is not a DateTime type" unless               tag[@user_tag_date].kind_of?(DateTime)
-          dto = tag[@user_tag_date] || PhFile::ZERO_DATE
+        if phfile_out.basename_is_standard? and @user_tag_date.empty?
+          # change only author, keeping date-time safe
+          phfile_out.standardize!(author: @author)
+          info_msg = "'#{phfile.basename+phfile.extname}' already standard name. Keeping date-time part unchanged"
+        else #full rename
+          begin
+            tags = MiniExiftool.new(phfile.filename,
+                                    replace_invalid_chars: true,
+                                    composite: true,
+                                    timestamps: DateTime)
+          rescue
+            raise PhTools::Error, 'EXIF tags reading'
+          end
+          if @user_tag_date.empty?
+            # searching for DateTime stamp value in the tags using priority:
+            # EXIF:DateTimeOriginal -> IPTC:DateCreated + IPTC:TimeCreated -> XMP:DateCreated -> EXIF:CreateDate -> XMP:CreateDate -> IPTC:DigitalCreationDate + IPTC:DigitalCreationTime -> FileModifyDate
+            if !tags.date_time_original.nil? && tags.date_time_original.kind_of?(DateTime)
+              # EXIF:DateTimeOriginal or IPTC:DateCreated + IPTC:TimeCreated
+              dto = tags.date_time_original
+              tag_used = "DateTimeOriginal"
+
+            elsif !tags.date_created.nil? && tags.date_created.kind_of?(DateTime)
+              # XMP:DateCreated
+              dto = tags.date_created
+              tag_used = "DateCreated"
+
+            elsif !tags.create_date.nil? && tags.create_date.kind_of?(DateTime)
+              # EXIF:CreateDate or XMP:CreateDate
+              dto = tags.create_date
+              tag_used = "CreateDate"
+
+            elsif !tags.digital_creation_date.nil? &&
+                  !tags.digital_creation_time.nil? &&
+                  tags.digital_creation_date.kind_of?(String) &&
+                  tags.digital_creation_time.kind_of?(String)
+              # IPTC:DigitalCreationDate + IPTC:DigitalCreationTime
+              dcdt = tags.digital_creation_date + " " + tags.digital_creation_time
+              begin
+                s = dcdt.sub(/^(\d+):(\d+):/, '\1-\2-')
+                dto = DateTime.parse(s)
+              rescue ArgumentError
+                dto = PhFile::ZERO_DATE
+              end
+              tag_used = "DigitalCreationDate + DigitalCreationTime"
+
+            else
+              # FileModifyDate
+              dto = File.mtime(phfile.filename).to_datetime
+              tag_used = "FileModifyDate"
+            end
+
+          else
+            # tag is set by the user
+            fail PhTools::Error, "tag #{@user_tag_date} is not found in a file" unless tags[@user_tag_date]
+            fail PhTools::Error, "tag #{@user_tag_date} is not a DateTime type" unless tags[@user_tag_date].kind_of?(DateTime)
+            dto = tags[@user_tag_date] || PhFile::ZERO_DATE
+            tag_used = "#{@user_tag_date}"
+          end
+          phfile_out.standardize!(date_time: dto, author: @author)
+          info_msg = "'#{phfile.basename+phfile.extname}' using tag '#{tag_used}' for date-time"
         end
-        phfile_out.standardize!(date_time: dto, author: @author)
 
       when :clean
         phfile_out.cleanse!
 
       when :shift_time
-        fail PhTools::Error, 'incorrect file name' unless phfile_out.basename_is_standard?
+        fail PhTools::Error, 'non-standard file name' unless phfile_out.basename_is_standard?
         phfile_out.standardize!(date_time: phfile_out.date_time + @shift_seconds*(1.0/86400))
       end
 
-      FileUtils.mv(phfile.filename, phfile_out.filename) unless phfile == phfile_out
+      FileUtils.mv(phfile.filename, phfile_out.filename, verbose: PhTools.debug) unless phfile == phfile_out
+      PhTools.puts_error info_msg unless info_msg.empty?
       phfile_out
 
     rescue => e

data/lib/phtools/error.rb

@@ -2,9 +2,6 @@
 # encoding: UTF-8
 # (c) ANB Andrew Bizyaev
 
-require 'nesty'
-
-# Foto tools
 module PhTools
   @debug = false
   def self.debug=(val)
@@ -15,19 +12,24 @@ module PhTools
     @debug
   end
 
+  def self.drill_down_error(e, level, prefix)
+    return if e.nil?
+    STDERR.puts "#{prefix}: CAUSE#{level}: #{e.class} - #{e.message}"
+    e.backtrace.each do |b|
+      STDERR.puts "#{prefix}: CAUSE#{level} BACKTRACE: #{b}"
+    end
+    drill_down_error(e.cause, level+1, prefix)
+  end
+
   def self.puts_error(msg, e = nil)
     prefix = File.basename($PROGRAM_NAME, '.rb')
     STDERR.puts "#{prefix}: #{msg}"
-    if @debug && !e.nil?
-      if e.respond_to?(:cause) && !e.cause.nil?
-        STDERR.puts "#{prefix}: CAUSE: #{e.cause} - #{e.cause.message}"
-      end
-      e.backtrace.each do |b|
-        STDERR.puts "#{prefix}: BACKTRACE: #{b}"
-      end
-    end
+    drill_down_error(e, 0, prefix) if @debug
+  end
+
+  class Error < StandardError
   end
 
-  class Error < Nesty::NestedStandardError; end
-  class ExiftoolTagger < Error; end
+  class ExiftoolTagger < Error
+  end
 end

data/lib/phtools/runner.rb

@@ -51,8 +51,8 @@ module PhTools
         filename = line.chomp
         begin
           PhFile.validate_file!(filename, @file_type)
-          ftfile = PhFile.new(filename)
-          @os.output process_file(ftfile)
+          phfile = PhFile.new(filename)
+          @os.output process_file(phfile)
         rescue PhTools::Error => e
           PhTools.puts_error "ERROR: '#{filename}' - #{e.message}", e
         end

data/lib/phtools/version.rb

@@ -1,4 +1,4 @@
 
 module PhTools
-  VERSION = '0.7.1'
+  VERSION = '0.7.7'
 end

data/phtools.gemspec

@@ -47,9 +47,8 @@ Gem::Specification.new do |spec|
     spec.add_development_dependency 'rb-notifu', '>= 0'
   end
 
-  spec.add_runtime_dependency 'nesty', '~> 1.0'
   spec.add_runtime_dependency 'docopt', '~> 0.5'
-  # spec.add_runtime_dependency 'mini_exiftool', '~> 2.4'
+  spec.add_runtime_dependency 'mini_exiftool', '~> 2.8'
   spec.add_runtime_dependency 'activesupport', '~> 3.2'
   spec.add_runtime_dependency 'i18n'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phtools
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.7.7
 platform: ruby
 authors:
 - Andrew Bizyaev
@@ -179,33 +179,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: nesty
+  name: docopt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
-  name: docopt
+  name: mini_exiftool
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '2.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -276,7 +276,6 @@ files:
 - lib/phtagset.rb
 - lib/phtools.rb
 - lib/phtools/error.rb
-- lib/phtools/mini_exiftool-2.3.0anb.rb
 - lib/phtools/ph_file.rb
 - lib/phtools/runner.rb
 - lib/phtools/utils.rb

data/lib/phtools/mini_exiftool-2.3.0anb.rb

@@ -1,703 +0,0 @@
-# -- encoding: utf-8 --
-#
-# MiniExiftool
-#
-# This library is wrapper for the Exiftool command-line
-# application (http://www.sno.phy.queensu.ca/~phil/exiftool/)
-# written by Phil Harvey.
-# Read and write access is done in a clean OO manner.
-#
-# Author: Jan Friedrich
-# Copyright (c) 2007-2013 by Jan Friedrich
-# Licensed under the GNU LESSER GENERAL PUBLIC LICENSE,
-# Version 2.1, February 1999
-#
-
-require 'fileutils'
-require 'json'
-require 'pstore'
-require 'rational'
-require 'rbconfig'
-require 'set'
-require 'tempfile'
-require 'time'
-require 'nesty' # ANB
-
-# Simple OO access to the Exiftool command-line application.
-class MiniExiftool
-
-  VERSION = '2.3.0'
-
-  # Name of the Exiftool command-line application
-  @@cmd = 'exiftool'
-
-  # Hash of the standard options used when call MiniExiftool.new
-  @@opts = { :numerical => false, :composite => true, :ignore_minor_errors => false,
-   :replace_invalid_chars => false, :timestamps => Time }
-
-  # Encoding of the filesystem (filenames in command line)
-  @@fs_enc = Encoding.find('filesystem')
-
-  def self.opts_accessor *attrs
-    attrs.each do |a|
-      define_method a do
-        @opts[a]
-      end
-      define_method "#{a}=" do |val|
-        @opts[a] = val
-      end
-    end
-  end
-
-  attr_reader :filename, :errors
-
-  opts_accessor :numerical, :composite, :ignore_minor_errors,
-    :replace_invalid_chars, :timestamps
-
-  @@encoding_types = %w(exif iptc xmp png id3 pdf photoshop quicktime aiff mie vorbis)
-
-  def self.encoding_opt enc_type
-    (enc_type.to_s + '_encoding').to_sym
-  end
-
-  @@encoding_types.each do |enc_type|
-    opts_accessor encoding_opt(enc_type)
-  end
-
-  # +opts+ support at the moment
-  # * <code>:numerical</code> for numerical values, default is +false+
-  # * <code>:composite</code> for including composite tags while loading,
-  #   default is +true+
-  # * <code>:ignore_minor_errors</code> ignore minor errors (See -m-option
-  #   of the exiftool command-line application, default is +false+)
-  # * <code>:coord_format</code> set format for GPS coordinates (See
-  #   -c-option of the exiftool command-line application, default is +nil+
-  #   that means exiftool standard)
-  # * <code>:replace_invalid_chars</code> replace string for invalid
-  #   UTF-8 characters or +false+ if no replacing should be done,
-  #   default is +false+
-  # * <code>:timestamps</code> generating DateTime objects instead of
-  #   Time objects if set to <code>DateTime</code>, default is +Time+
-  #
-  #   <b>ATTENTION:</b> Time objects are created using <code>Time.local</code>
-  #   therefore they use <em>your local timezone</em>, DateTime objects instead
-  #   are created <em>without timezone</em>!
-  # * <code>:exif_encoding</code>, <code>:iptc_encoding</code>,
-  #   <code>:xmp_encoding</code>, <code>:png_encoding</code>,
-  #   <code>:id3_encoding</code>, <code>:pdf_encoding</code>,
-  #   <code>:photoshop_encoding</code>, <code>:quicktime_encoding</code>,
-  #   <code>:aiff_encoding</code>, <code>:mie_encoding</code>,
-  #   <code>:vorbis_encoding</code> to set this specific encoding (see
-  #   -charset option of the exiftool command-line application, default is
-  #   +nil+: no encoding specified)
-  def initialize filename=nil, opts={}
-    @opts = @@opts.merge opts
-    if @opts[:convert_encoding]
-      warn 'Option :convert_encoding is not longer supported!'
-      warn 'Please use the String#encod* methods.'
-    end
-    @values = TagHash.new
-    @changed_values = TagHash.new
-    @errors = TagHash.new
-    load filename unless filename.nil?
-  end
-
-  def initialize_from_hash hash # :nodoc:
-    set_values hash
-    set_opts_by_heuristic
-    self
-  end
-
-  def initialize_from_json json # :nodoc:
-    @output = json
-    @errors.clear
-    parse_output
-    self
-  end
-
-  # Load the tags of filename.
-  def load filename
-    MiniExiftool.setup
-    unless filename && File.exist?(filename)
-      raise MiniExiftool::Error.new("File '#{filename}' does not exist.")
-    end
-    if File.directory?(filename)
-      raise MiniExiftool::Error.new("'#{filename}' is a directory.")
-    end
-    @filename = filename
-    @values.clear
-    @changed_values.clear
-    params = '-j '
-    params << (@opts[:numerical] ? '-n ' : '')
-    params << (@opts[:composite] ? '' : '-e ')
-    params << (@opts[:coord_format] ? "-c \"#{@opts[:coord_format]}\"" : '')
-    @@encoding_types.each do |enc_type|
-      if enc_val = @opts[MiniExiftool.encoding_opt(enc_type)]
-        params << "-charset #{enc_type}=#{enc_val} "
-      end
-    end
-    if run(cmd_gen(params, @filename))
-      parse_output
-    else
-      raise MiniExiftool::Error.new(@error_text)
-    end
-    self
-  end
-
-  # Reload the tags of an already read file.
-  def reload
-    load @filename
-  end
-
-  # Returns the value of a tag.
-  def [] tag
-    @changed_values[tag] || @values[tag]
-  end
-
-  # Set the value of a tag.
-  def []= tag, val
-    @changed_values[tag] = val
-  end
-
-  # Returns true if any tag value is changed or if the value of a
-  # given tag is changed.
-  def changed? tag=false
-    if tag
-      @changed_values.include? tag
-    else
-      !@changed_values.empty?
-    end
-  end
-
-  # Revert all changes or the change of a given tag.
-  def revert tag=nil
-    if tag
-      val = @changed_values.delete(tag)
-      res = val != nil
-    else
-      res = @changed_values.size > 0
-      @changed_values.clear
-    end
-    res
-  end
-
-  # Returns an array of the tags (original tag names) of the read file.
-  def tags
-    @values.keys.map { |key| MiniExiftool.original_tag(key) }
-  end
-
-  # Returns an array of all changed tags.
-  def changed_tags
-    @changed_values.keys.map { |key| MiniExiftool.original_tag(key) }
-  end
-
-  # Save the changes to the file.
-  def save
-    MiniExiftool.setup
-    return false if @changed_values.empty?
-    @errors.clear
-    temp_file = Tempfile.new('mini_exiftool')
-    temp_file.close
-    temp_filename = temp_file.path
-    FileUtils.cp filename.encode(@@fs_enc), temp_filename
-    all_ok = true
-    @changed_values.each do |tag, val|
-      original_tag = MiniExiftool.original_tag(tag)
-      arr_val = val.kind_of?(Array) ? val : [val]
-      arr_val.map! {|e| convert_before_save(e)}
-      params = '-q -P -overwrite_original '
-      params << (arr_val.detect {|x| x.kind_of?(Numeric)} ? '-n ' : '')
-      params << (@opts[:ignore_minor_errors] ? '-m ' : '')
-      arr_val.each do |v|
-        params << %Q(-#{original_tag}=#{escape(v)} )
-      end
-      result = run(cmd_gen(params, temp_filename))
-      unless result
-        all_ok = false
-        @errors[tag] = @error_text.gsub(/Nothing to do.\n\z/, '').chomp
-      end
-    end
-    if all_ok
-      FileUtils.cp temp_filename, filename.encode(@@fs_enc)
-      reload
-    end
-    temp_file.delete
-    all_ok
-  end
-
-  def save!
-    unless save
-      err = []
-      @errors.each do |key, value|
-        err << "(#{key}) #{value}"
-      end
-      raise MiniExiftool::Error.new("MiniExiftool couldn't save. The following errors occurred: #{err.empty? ? "None" : err.join(", ")}")
-    end
-  end
-
-  # Returns a hash of the original loaded values of the MiniExiftool
-  # instance.
-  def to_hash
-    result = {}
-    @values.each do |k,v|
-      result[MiniExiftool.original_tag(k)] = v
-    end
-    result
-  end
-
-  # Returns a YAML representation of the original loaded values of the
-  # MiniExiftool instance.
-  def to_yaml
-    to_hash.to_yaml
-  end
-
-  # Create a MiniExiftool instance from a hash. Default value
-  # conversions will be applied if neccesary.
-  def self.from_hash hash, opts={}
-    instance = MiniExiftool.new nil, opts
-    instance.initialize_from_hash hash
-    instance
-  end
-
-  # Create a MiniExiftool instance from JSON data. Default value
-  # conversions will be applied if neccesary.
-  def self.from_json json, opts={}
-    instance = MiniExiftool.new nil, opts
-    instance.initialize_from_json json
-    instance
-  end
-
-  # Create a MiniExiftool instance from YAML data created with
-  # MiniExiftool#to_yaml
-  def self.from_yaml yaml, opts={}
-    MiniExiftool.from_hash YAML.load(yaml), opts
-  end
-
-  # Returns the command name of the called Exiftool application.
-  def self.command
-    @@cmd
-  end
-
-  # Setting the command name of the called Exiftool application.
-  def self.command= cmd
-    @@cmd = cmd
-  end
-
-  # Returns the options hash.
-  def self.opts
-    @@opts
-  end
-
-  # Returns a set of all known tags of Exiftool.
-  def self.all_tags
-    unless defined? @@all_tags
-      @@all_tags = pstore_get :all_tags
-    end
-    @@all_tags
-  end
-
-  # Returns a set of all possible writable tags of Exiftool.
-  def self.writable_tags
-    unless defined? @@writable_tags
-      @@writable_tags = pstore_get :writable_tags
-    end
-    @@writable_tags
-  end
-
-  # Returns the original Exiftool name of the given tag
-  def self.original_tag tag
-    unless defined? @@all_tags_map
-      @@all_tags_map = pstore_get :all_tags_map
-    end
-    @@all_tags_map[tag]
-  end
-
-  # Returns the version of the Exiftool command-line application.
-  def self.exiftool_version
-    output = `#{MiniExiftool.command} -ver 2>&1`
-    unless $?.exitstatus == 0
-      raise MiniExiftool::Error.new("Command '#{MiniExiftool.command}' not found")
-    end
-    output.chomp!
-  end
-
-  def self.unify tag
-    tag.to_s.gsub(/[-_]/,'').downcase
-  end
-
-  # Exception class
-  class MiniExiftool::Error < Nesty::NestedStandardError; end # ANB
-
-  ############################################################################
-  private
-  ############################################################################
-
-  @@setup_done = false
-  def self.setup
-    return if @@setup_done
-    @@error_file = Tempfile.new 'errors'
-    @@error_file.close
-    @@setup_done = true
-  end
-
-  def cmd_gen arg_str='', filename
-    [@@cmd, arg_str.encode('UTF-8'), escape(filename.encode(@@fs_enc))].map {|s| s.force_encoding('UTF-8')}.join(' ')
-  end
-
-  def run cmd
-    if $DEBUG
-      $stderr.puts cmd
-    end
-    @output = `#{cmd} 2>#{@@error_file.path}`
-    @status = $?
-    unless @status.exitstatus == 0
-      @error_text = File.readlines(@@error_file.path).join
-      @error_text.force_encoding('UTF-8')
-      return false
-    else
-      @error_text = ''
-      return true
-    end
-  end
-
-  def convert_before_save val
-    case val
-    when Time
-      val = val.strftime('%Y:%m:%d %H:%M:%S')
-    end
-    val
-  end
-
-  def method_missing symbol, *args
-    tag_name = symbol.id2name
-    if tag_name.sub!(/=$/, '')
-      self[tag_name] = args.first
-    else
-      self[tag_name]
-    end
-  end
-
-  def parse_output
-    adapt_encoding
-    set_values JSON.parse(@output).first
-  end
-
-  def adapt_encoding
-    @output.force_encoding('UTF-8')
-    if @opts[:replace_invalid_chars] && !@output.valid_encoding?
-      @output.encode!('UTF-16le', invalid: :replace, replace: @opts[:replace_invalid_chars]).encode!('UTF-8')
-    end
-  end
-
-  def convert_after_load tag, value
-    return value unless value.kind_of?(String)
-    return value unless value.valid_encoding?
-    case value
-    when /^\d{4}:\d\d:\d\d \d\d:\d\d:\d\d/
-      s = value.sub(/^(\d+):(\d+):/, '\1-\2-')
-      begin
-        if @opts[:timestamps] == Time
-          value = Time.parse(s)
-        elsif @opts[:timestamps] == DateTime
-          value = DateTime.parse(s)
-        else
-          raise MiniExiftool::Error.new("Value #{@opts[:timestamps]} not allowed for option timestamps.")
-        end
-      rescue ArgumentError
-        value = false
-      end
-    when /^\+\d+\.\d+$/
-      value = value.to_f
-    when /^0+[1-9]+$/
-      # nothing => String
-    when /^-?\d+$/
-      value = value.to_i
-    when %r(^(\d+)/(\d+)$)
-      value = Rational($1.to_i, $2.to_i)
-    when /^[\d ]+$/
-      # nothing => String
-    end
-    value
-  end
-
-  def set_values hash
-    hash.each_pair do |tag,val|
-      @values[tag] = convert_after_load(tag, val)
-    end
-    # Remove filename specific tags use attr_reader
-    # MiniExiftool#filename instead
-    # Cause: value of tag filename and attribute
-    # filename have different content, the latter
-    # holds the filename with full path (like the
-    # sourcefile tag) and the former the basename
-    # of the filename also there is no official
-    # "original tag name" for sourcefile
-    %w(directory filename sourcefile).each do |t|
-      @values.delete(t)
-    end
-  end
-
-  def set_opts_by_heuristic
-    @opts[:composite] = tags.include?('ImageSize')
-    @opts[:numerical] = self.file_size.kind_of?(Integer)
-    @opts[:timestamps] = self.FileModifyDate.kind_of?(DateTime) ? DateTime : Time
-  end
-
-  def self.pstore_get attribute
-    load_or_create_pstore unless defined? @@pstore
-    result = nil
-    @@pstore.transaction(true) do |ps|
-      result = ps[attribute]
-    end
-    result
-  end
-
-  @@running_on_windows = /mswin|mingw|cygwin/ === RbConfig::CONFIG['host_os']
-
-  def self.load_or_create_pstore
-    # This will hopefully work on *NIX and Windows systems
-    home = ENV['HOME'] || ENV['HOMEDRIVE'] + ENV['HOMEPATH'] || ENV['USERPROFILE']
-    subdir = @@running_on_windows ? '_mini_exiftool' : '.mini_exiftool'
-    FileUtils.mkdir_p(File.join(home, subdir))
-    pstore_filename = File.join(home, subdir, 'exiftool_tags_' << exiftool_version.gsub('.', '_') << '.pstore')
-    @@pstore = PStore.new pstore_filename
-    if !File.exist?(pstore_filename) || File.size(pstore_filename) == 0
-      @@pstore.transaction do |ps|
-        ps[:all_tags] = all_tags = determine_tags('list')
-        ps[:writable_tags] = determine_tags('listw')
-        map = {}
-        all_tags.each { |k| map[unify(k)] = k }
-        ps[:all_tags_map] = map
-      end
-    end
-  end
-
-  def self.determine_tags arg
-    output = `#{@@cmd} -#{arg}`
-    lines = output.split(/\n/)
-    tags = Set.new
-    lines.each do |line|
-      next unless line =~ /^\s/
-      tags |= line.chomp.split
-    end
-    tags
-  end
-
-  if @@running_on_windows
-    def escape val
-      '"' << val.to_s.gsub(/([\\"])/, "\\\\\\1") << '"'
-    end
-  else
-    def escape val
-      '"' << val.to_s.gsub(/([\\"$])/, "\\\\\\1") << '"'
-    end
-  end
-
-  # Hash with indifferent access:
-  # DateTimeOriginal == datetimeoriginal == date_time_original
-  class TagHash < Hash # :nodoc:
-    def[] k
-      super(unify(k))
-    end
-    def []= k, v
-      super(unify(k), v)
-    end
-    def delete k
-      super(unify(k))
-    end
-
-    def unify tag
-      MiniExiftool.unify tag
-    end
-  end
-end
-
-# ANB - dump of real @values:
-# exiftoolversion=9.41
-# filesize=128 kB
-# filemodifydate=2014-04-02T23:00:50+04:00
-# fileaccessdate=2014-04-02T23:00:51+04:00
-# fileinodechangedate=2014-04-02T23:00:50+04:00
-# filepermissions=rw-r--r--
-# filetype=JPEG
-# mimetype=image/jpeg
-# jfifversion=1.01
-# exifbyteorder=Little-endian (Intel, II)
-# imagedescription=
-# make=SONY
-# model=SLT-A65V
-# xresolution=350
-# yresolution=350
-# resolutionunit=inches
-# software=SLT-A65V v1.05
-# modifydate=2014-04-02T20:50:32+00:00
-# artist=Andrey Bizyaev (photographer); Andrey Bizyaev (camera owner)
-# ycbcrpositioning=Co-sited
-# copyright=2013 (c) Andrey Bizyaev. All Rights Reserved.
-# exposuretime=1/100
-# fnumber=5.6
-# exposureprogram=Program AE
-# iso=160
-# sensitivitytype=Recommended Exposure Index
-# recommendedexposureindex=160
-# exifversion=230
-# datetimeoriginal=2013-01-03T15:39:08+00:00
-# createdate=2013-01-03T15:39:08+00:00
-# componentsconfiguration=Y, Cb, Cr, -
-# compressedbitsperpixel=2
-# brightnessvalue=6.3375
-# exposurecompensation=0
-# maxaperturevalue=5.6
-# meteringmode=Multi-segment
-# lightsource=Unknown
-# flash=Off, Did not fire
-# focallength=55.0 mm
-# quality=Fine
-# flashexposurecomp=0
-# teleconverter=None
-# whitebalancefinetune=0
-# rating=0
-# brightness=0
-# longexposurenoisereduction=On (unused)
-# highisonoisereduction=Normal
-# hdr=Off; Uncorrected image
-# multiframenoisereduction=Off
-# pictureeffect=Off
-# softskineffect=Off
-# vignettingcorrection=Auto
-# lateralchromaticaberration=Auto
-# distortioncorrection=Off
-# wbshiftabgm=0 0
-# faceinfooffset=94
-# sonydatetime=2013-01-03T15:39:08+00:00
-# sonyimagewidth=6000
-# facesdetected=0
-# faceinfolength=37
-# metaversion=DC7303320222000
-# maxaperture=5.3
-# minaperture=33
-# flashstatus=Built-in Flash present
-# imagecount=8330
-# lensmount=A-Mount
-# lensformat=APS-C
-# sequenceimagenumber=1
-# sequencefilenumber=1
-# releasemode2=Normal
-# shotnumbersincepowerup=2
-# sequencelength=1 shot
-# cameraorientation=Horizontal (normal)
-# quality2=JPEG
-# sonyimageheight=4000
-# modelreleaseyear=2011
-# batterylevel=18%
-# afpointsselected=(all)
-# fileformat=ARW 2.3
-# sonymodelid=SLT-A65 / SLT-A65V
-# creativestyle=Standard
-# colortemperature=Auto
-# colorcompensationfilter=0
-# scenemode=Auto
-# zonematching=ISO Setting Used
-# dynamicrangeoptimizer=Auto
-# imagestabilization=On
-# lenstype=Sony DT 16-105mm F3.5-5.6 (SAL16105)
-# colormode=Standard
-# lensspec=DT 16-105mm F3.5-5.6
-# fullimagesize=6000x4000
-# previewimagesize=1616x1080
-# flashlevel=Normal
-# releasemode=Normal
-# sequencenumber=Single
-# antiblur=On (Shooting)
-# intelligentauto=On
-# whitebalance=Auto
-# usercomment=
-# flashpixversion=100
-# colorspace=sRGB
-# exifimagewidth=800
-# exifimageheight=534
-# interopindex=R98 - DCF basic file (sRGB)
-# interopversion=100
-# relatedimagewidth=6000
-# relatedimageheight=4000
-# filesource=Digital Camera
-# scenetype=Directly photographed
-# customrendered=Normal
-# exposuremode=Auto
-# focallengthin35mmformat=82 mm
-# scenecapturetype=Standard
-# contrast=Normal
-# saturation=Normal
-# sharpness=Normal
-# imageuniqueid=20140402-205030-0001
-# lensinfo=16-105mm f/3.5-5.6
-# lensmodel=DT 16-105mm F3.5-5.6
-# gpsversionid=2.3.0.0
-# gpslatituderef=North
-# gpslongituderef=East
-# gpsaltituderef=Above Sea Level
-# gpstimestamp=11:39:09.588
-# gpsstatus=Measurement Active
-# gpsmeasuremode=3-Dimensional Measurement
-# gpsdop=2.0026
-# gpsspeedref=km/h
-# gpsspeed=1.097
-# gpstrackref=True North
-# gpstrack=357.15
-# gpsmapdatum=WGS-84
-# gpsdatestamp=2013:01:03
-# gpsdifferential=No Correction
-# printimversion=300
-# compression=JPEG (old-style)
-# orientation=Horizontal (normal)
-# thumbnailoffset=21840
-# thumbnaillength=5859
-# xmptoolkit=Image::ExifTool 9.41
-# location=Дворцовая пл.
-# locationshowncity=Санкт-Петербург
-# locationshowncountrycode=RU
-# locationshowncountryname=Russia
-# locationshownprovincestate=Санкт-Петербург
-# locationshownsublocation=Дворцовая пл.
-# locationshownworldregion=Europe
-# creator=["Andrey Bizyaev (photographer)", "Andrey Bizyaev (camera owner)"]
-# rights=2013 (c) Andrey Bizyaev. All Rights Reserved.
-# subject=["before-what-travel", "before-who-Andrew", "before-where-Baltic", "before-when-day", "before-why-vacation", "before-how-fine", "before-method-digicam"]
-# collectionname=S-Peterburg Travel
-# collectionuri=anblab.net
-# country=Russia
-# state=Санкт-Петербург
-# iptcdigest=1569c0bffab4b64cb1107134254cf97d
-# currentiptcdigest=7be9172b29568717f9bc0976c93ba53d
-# codedcharacterset=UTF8
-# enveloperecordversion=4
-# keywords=["before-what-travel", "before-who-Andrew", "before-where-Baltic", "before-when-day", "before-why-vacation", "before-how-fine", "before-method-digicam"]
-# byline=["Andrey Bizyaev (photographer)", "Andrey Bizyaev (camera owner)"]
-# city=Санкт-Петербург
-# sublocation=Дворцовая пл.
-# provincestate=Санкт-Петербург
-# countryprimarylocationname=Russia
-# copyrightnotice=2013 (c) Andrey Bizyaev. All Rights Reserved.
-# applicationrecordversion=4
-# imagewidth=800
-# imageheight=534
-# encodingprocess=Baseline DCT, Huffman coding
-# bitspersample=8
-# colorcomponents=3
-# ycbcrsubsampling=YCbCr4:4:4 (1 1)
-# aperture=5.6
-# gpsaltitude=0.5 m Above Sea Level
-# gpsdatetime=2013-01-03T11:39:09+00:00
-# gpslatitude=60 deg 0' 0.00" N
-# gpslongitude=25 deg 0' 0.00" E
-# gpsposition=60 deg 0' 0.00" N, 25 deg 0' 0.00" E
-# imagesize=800x534
-# lensid=Sony DT 16-105mm F3.5-5.6 (SAL16105)
-# scalefactor35efl=1.5
-# shutterspeed=1/100
-# thumbnailimage=(Binary data 5859 bytes)
-# circleofconfusion=0.020 mm
-# fov=24.8 deg
-# focallength35efl=55.0 mm (35 mm equivalent: 82.0 mm)
-# hyperfocaldistance=26.80 m
-# lightvalue=10.9