multi_exiftool 0.18.1 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c32c0754aa49fcb693d9c9f5b57cc97a8a12beb59cd7b68d58d02b33c86dc124
-  data.tar.gz: 67b5fd97eb0a6659e632bcd7f703aaf3ca6b847fc678a0afadf79345870710c3
+  metadata.gz: c0c11e4d78ddfece60352716273188dbdb365174be7215d2df1136de2a938ab1
+  data.tar.gz: 8258baf1ae7de0dc1c2d9b633e51f06b7b5e07417713cbcbbdba99960c591027
 SHA512:
-  metadata.gz: 5a238f428504a103a990003e2b10fd15f7d55b37a22f3f857a8bc90b66f0ad683e54d752be78f101f8a9527a9cc1c6b111ed330a8963ff1a2f3a7ecdf0a2971e
-  data.tar.gz: 1ff4a6dfe8516e0183476a6d3b526f012d6fb94ca95f3f6a91eefa57039d7c3421fff9561bce59eb3d7d985a3ea389addb44a7ea9b34a2438b875d2fd52888ef
+  metadata.gz: 82db0ba81f5259a4aa7f16edaac6a7cc25eefc8779f512edcdacff51fc503e8a08548be381e0c2643ebfe3357f15eda569945129d70aae81c1539ddb88ca7fbc
+  data.tar.gz: 1155c81594420037d1e12c3086346d47ccba93fc0a3d5be0f264f1855ecc48441d2a54aee9d166735f6517e1da8b049ccb6c6f83c6e6fd4e36621972df0fee6a

data/Changelog

@@ -1,3 +1,7 @@
+0.19.0
+Maintenance release: Upgrade to rim 3.0 for development and minimize gem file
+size.
+
 0.18.1
 Fix a bug with large output which causes the hanging when reading data.
 

data/examples/01_simple_reading.rb

@@ -0,0 +1,13 @@
+require 'multi_exiftool'
+
+if ARGV.empty?
+  $stderr.puts 'No filenames given.'
+  exit -1
+end
+
+reader = MultiExiftool::Reader.new
+reader.filenames = ARGV
+results = reader.read
+results.each do |values|
+ puts "#{values.file_name}: #{values.comment}"
+end

data/examples/02_simple_writing.rb

@@ -0,0 +1,19 @@
+require 'multi_exiftool'
+
+if ARGV.empty?
+  $stderr.puts 'No filenames given.'
+  exit -1
+end
+
+puts 'Please enter a comment for the given files:'
+comment = $stdin.gets.chomp
+
+writer = MultiExiftool::Writer.new
+writer.filenames = ARGV
+writer.overwrite_original = true
+writer.values = {comment: comment}
+if writer.write
+  puts 'ok'
+else
+  puts writer.errors.join
+end

data/examples/03_reading_using_groups.rb

@@ -0,0 +1,28 @@
+require 'multi_exiftool'
+
+if ARGV.empty?
+  $stderr.puts 'No filenames given.'
+  exit -1
+end
+
+reader = MultiExiftool::Reader.new
+reader.filenames = ARGV
+reader.group = 0
+results = reader.read
+results.each do |values|
+  # direct access
+  puts values.file.filename
+  # access via block without parameter
+  values.iptc do
+    self.keywords do
+      puts "  Keywords (IPCT): #{Array(self).join(', ')}"
+    end
+  end
+  # access via block with parameter
+  values.xmp do |xmp|
+    xmp.keywords do |kw|
+      puts "  Keywords (XMP): #{Array(kw).join(', ')}"
+    end
+  end
+end
+

data/examples/04_writing_using_groups.rb

@@ -0,0 +1,33 @@
+require 'multi_exiftool'
+require 'yaml'
+
+if ARGV.empty?
+  $stderr.puts 'No filenames given.'
+  exit -1
+end
+
+puts 'Please enter a description for the given files:'
+description = $stdin.gets.chomp
+
+puts 'Please enter a caption for the given files:'
+caption = $stdin.gets.chomp
+
+writer = MultiExiftool::Writer.new
+writer.filenames = ARGV
+
+# specifying group by prefix
+writer.values = {'exif:imagedescription' => description, 'xmp:description' => description}
+
+# specifying group hierarchical
+writer.values.merge! YAML.load <<-END
+iptc:
+  caption-abstract: #{caption}
+xmp:
+  caption: #{caption}
+END
+
+if writer.write
+  puts 'ok'
+else
+  puts writer.errors.join
+end

data/examples/05_functional_api.rb

@@ -0,0 +1,35 @@
+require 'multi_exiftool'
+
+if ARGV.empty?
+  $stderr.puts 'No filenames given.'
+  exit -1
+end
+
+# Reading only the tags Orientation and Rotation using the -n option of exiftool
+results, errors = MultiExiftool.read(ARGV, tags: %w[orientation rotation], numerical: true)
+
+unless errors.empty?
+  $stderr.puts reader.errors
+  exit 1
+end
+
+# Ensuring that for all files with EXIF rotation value of 76 the EXIF value orientation is 6
+# and for EXIF rotation value 82 the EXIF orientation value is 8
+
+# Determine the filenames
+update_orientation_to_6 = results.select {|r| r.rotation == 76 && r.orientation != 6}.map {|r| r.sourcefile}
+update_orientation_to_8 = results.select {|r| r.rotation == 82 && r.orientation != 8}.map {|r| r.sourcefile}
+
+# Update
+errors = []
+unless update_orientation_to_6.empty?
+  errors += MultiExiftool.write(update_orientation_to_6, {orientation: 6}, numerical: true, overwrite_original: true)
+end
+unless update_orientation_to_8.empty?
+  errors += MultiExiftool.write(update_orientation_to_8, {orientation: 8}, numerical: true, overwrite_original: true)
+end
+
+unless errors.empty?
+  $stderr.puts reader.errors
+  exit 1
+end

data/lib/multi_exiftool.rb

@@ -8,7 +8,7 @@ require_relative 'multi_exiftool/batch'
 
 module MultiExiftool
 
-  VERSION = '0.18.1'
+  VERSION = '0.19.0'
 
   @exiftool_command = 'exiftool'
 

metadata

@@ -1,14 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: multi_exiftool
 version: !ruby/object:Gem::Version
-  version: 0.18.1
+  version: 0.19.0
 platform: ruby
+original_platform: ''
 authors:
 - Jan Friedrich
 bindir: bin
 cert_chain: []
-date: 2024-05-23 00:00:00.000000000 Z
+date: 2024-11-23 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: contest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: fileutils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.3
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -24,33 +53,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rim
+  name: regtest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.17'
+        version: '2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.17'
+        version: '2'
 - !ruby/object:Gem::Dependency
-  name: contest
+  name: rim
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -65,20 +94,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: regtest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2'
 description: This library is a wrapper for the ExifTool command-line application (https://exiftool.org)
   written by Phil Harvey. It is designed for dealing with multiple files at once by
   creating commands to call exiftool with various arguments, call it and parsing the
@@ -88,46 +103,31 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- "./.aspell.pws"
 - Changelog
-- Gemfile
 - LICENSE
 - README.md
-- Rakefile
+- examples/01_simple_reading.rb
+- examples/02_simple_writing.rb
+- examples/03_reading_using_groups.rb
+- examples/04_writing_using_groups.rb
+- examples/05_functional_api.rb
 - lib/multi_exiftool.rb
 - lib/multi_exiftool/batch.rb
 - lib/multi_exiftool/executable.rb
 - lib/multi_exiftool/reader.rb
 - lib/multi_exiftool/values.rb
 - lib/multi_exiftool/writer.rb
-- multi_exiftool.gemspec
-- regtest/read_all_tags.rb
-- regtest/read_all_tags.yml
-- regtest/test.jpg
-- test/data/a.jpg
-- test/data/b.jpg
-- test/data/c.jpg
-- test/data/example.config
-- test/helper.rb
-- test/test_batch.rb
-- test/test_executable.rb
-- test/test_exiftool_stuff.rb
-- test/test_functional_api.rb
-- test/test_reader.rb
-- test/test_values.rb
-- test/test_values_using_groups.rb
-- test/test_writer.rb
-- test/test_writer_groups.rb
 homepage: https://github.com/janfri/multi_exiftool
 licenses:
 - MIT
 metadata: {}
-post_install_message: "\n+-----------------------------------------------------------------------+\n|
-  Please ensure you have installed exiftool version 11.10 or higher and |\n| it's
-  found in your PATH (Try \"exiftool -ver\" on your commandline).    |\n| For more
-  details see                                                  |\n| https://exiftool.org/install.html
-  \                                    |\n+-----------------------------------------------------------------------+\n
-  \ "
+post_install_message: |
+  +-----------------------------------------------------------------------+
+  | Please ensure you have installed exiftool version 11.10 or higher and |
+  | it's found in your PATH (Try "exiftool -ver" on your commandline).    |
+  | For more details see                                                  |
+  | https://exiftool.org/install.html                                     |
+  +-----------------------------------------------------------------------+
 rdoc_options: []
 require_paths:
 - lib

data/.aspell.pws

@@ -1,35 +0,0 @@
-personal_ws-1.1 en 34 
-Coenen
-ExifTool
-Friedrich
-Gemfile
-Gitorious
-MERCHANTABILITY
-MultiExiftool
-MyConversion
-NONINFRINGEMENT
-PartOfSet
-README
-SemVer
-SemVerTag
-api
-config
-dir
-exiftool
-filenames
-gemspec
-gittycat
-gmail
-janfri
-jpg
-multi
-ok
-prepend
-refactoring
-stderr
-stdin
-sublicense
-szTheory
-timestamps
-tmpdir
-utc

data/Gemfile

@@ -1,3 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec

data/Rakefile

@@ -1,31 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-
-require_relative 'lib/multi_exiftool'
-require 'rim/tire'
-require 'rim/version'
-require 'rim/regtest'
-
-Rim.setup do |p|
-  p.name = 'multi_exiftool'
-  p.version = MultiExiftool::VERSION
-  p.authors = 'Jan Friedrich'
-  p.email = 'janfri26@gmail.com'
-  p.summary = 'This library is a wrapper for the ExifTool command-line application (https://exiftool.org).'
-  p.description = 'This library is a wrapper for the ExifTool command-line application (https://exiftool.org) written by Phil Harvey. It is designed for dealing with multiple files at once by creating commands to call exiftool with various arguments, call it and parsing the results.'
-  p.ruby_version = '>=1.9.1'
-  p.license = 'MIT'
-  p.homepage = 'https://github.com/janfri/multi_exiftool'
-  p.install_message = %q{
-+-----------------------------------------------------------------------+
-| Please ensure you have installed exiftool version 11.10 or higher and |
-| it's found in your PATH (Try "exiftool -ver" on your commandline).    |
-| For more details see                                                  |
-| https://exiftool.org/install.html                                     |
-+-----------------------------------------------------------------------+
-  }
-  p.development_dependencies << %w(contest ~>0.1)
-  p.development_dependencies << 'test-unit'
-  p.requirements << 'exiftool, version 11.10 or higher'
-  p.test_warning = false
-end

data/multi_exiftool.gemspec

@@ -1,34 +0,0 @@
-# -*- encoding: utf-8 -*-
-# stub: multi_exiftool 0.18.1 ruby lib
-#
-# This file is automatically generated by rim.
-# PLEASE DO NOT EDIT IT DIRECTLY!
-# Change the values in Rim.setup in Rakefile instead.
-
-Gem::Specification.new do |s|
-  s.name = "multi_exiftool"
-  s.version = "0.18.1"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.require_paths = ["lib"]
-  s.authors = ["Jan Friedrich"]
-  s.date = "2024-05-23"
-  s.description = "This library is a wrapper for the ExifTool command-line application (https://exiftool.org) written by Phil Harvey. It is designed for dealing with multiple files at once by creating commands to call exiftool with various arguments, call it and parsing the results."
-  s.email = "janfri26@gmail.com"
-  s.files = ["./.aspell.pws", "Changelog", "Gemfile", "LICENSE", "README.md", "Rakefile", "lib/multi_exiftool", "lib/multi_exiftool.rb", "lib/multi_exiftool/batch.rb", "lib/multi_exiftool/executable.rb", "lib/multi_exiftool/reader.rb", "lib/multi_exiftool/values.rb", "lib/multi_exiftool/writer.rb", "multi_exiftool.gemspec", "regtest/read_all_tags.rb", "regtest/read_all_tags.yml", "regtest/test.jpg", "test/data", "test/data/a.jpg", "test/data/b.jpg", "test/data/c.jpg", "test/data/example.config", "test/helper.rb", "test/test_batch.rb", "test/test_executable.rb", "test/test_exiftool_stuff.rb", "test/test_functional_api.rb", "test/test_reader.rb", "test/test_values.rb", "test/test_values_using_groups.rb", "test/test_writer.rb", "test/test_writer_groups.rb"]
-  s.homepage = "https://github.com/janfri/multi_exiftool"
-  s.licenses = ["MIT"]
-  s.post_install_message = "\n+-----------------------------------------------------------------------+\n| Please ensure you have installed exiftool version 11.10 or higher and |\n| it's found in your PATH (Try \"exiftool -ver\" on your commandline).    |\n| For more details see                                                  |\n| https://exiftool.org/install.html                                     |\n+-----------------------------------------------------------------------+\n  "
-  s.required_ruby_version = Gem::Requirement.new(">= 1.9.1")
-  s.requirements = ["exiftool, version 11.10 or higher"]
-  s.rubygems_version = "3.6.0.dev"
-  s.summary = "This library is a wrapper for the ExifTool command-line application (https://exiftool.org)."
-
-  s.specification_version = 4
-
-  s.add_development_dependency(%q<rake>, [">= 0"])
-  s.add_development_dependency(%q<rim>, ["~> 2.17"])
-  s.add_development_dependency(%q<contest>, ["~> 0.1"])
-  s.add_development_dependency(%q<test-unit>, [">= 0"])
-  s.add_development_dependency(%q<regtest>, ["~> 2"])
-end

data/regtest/read_all_tags.rb

@@ -1,6 +0,0 @@
-require 'regtest'
-require 'multi_exiftool'
-
-Regtest.sample 'read all tags' do
-  MultiExiftool.read('regtest/test.jpg', tags: %w(-filemodifydate -fileaccessdate -fileinodechangedate -filepermissions))
-end

data/regtest/read_all_tags.yml

@@ -1,112 +0,0 @@
----
-sample: read all tags
-result:
-- - !ruby/object:MultiExiftool::Values
-    values:
-      sourcefile: regtest/test.jpg
-      exiftoolversion: 12.26
-      filename: test.jpg
-      directory: regtest
-      filesize: 43 KiB
-      filetype: JPEG
-      filetypeextension: jpg
-      mimetype: image/jpeg
-      jfifversion: 1.01
-      exifbyteorder: Big-endian (Motorola, MM)
-      imagedescription: KONICA MINOLTA DIGITAL CAMERA
-      make: KONICA MINOLTA
-      model: DYNAX 7D
-      orientation: Horizontal (normal)
-      xresolution: 72
-      yresolution: 72
-      resolutionunit: inches
-      software: DYNAX 7D v1.10
-      modifydate: 2005:09:13 20:08:50
-      ycbcrpositioning: Centered
-      exposuretime: 1/60
-      fnumber: 9.5
-      exposureprogram: Program AE
-      iso: 400
-      exifversion: '0221'
-      datetimeoriginal: 2005:09:13 20:08:50
-      createdate: 2005:09:13 20:08:50
-      componentsconfiguration: Y, Cb, Cr, -
-      brightnessvalue: 4.5
-      exposurecompensation: -1
-      maxaperturevalue: 4.5
-      meteringmode: Multi-segment
-      lightsource: Unknown
-      flash: Off, Did not fire
-      focallength: 75.0 mm
-      subjectarea: 1504 1000 256 304
-      makernoteversion: MLT0
-      minoltaimagesize: Large
-      whitebalance: Auto
-      focusmode: AF-A
-      afpoints: Center
-      flashmode: Normal
-      isosetting: 400
-      freememorycardimages: 202
-      hueadjustment: 0
-      rotation: Horizontal (normal)
-      imagenumber: 6
-      noisereduction: Unknown (2)
-      imagenumber2: 50
-      zonematchingon: 'Off'
-      compressedimagesize: 1598477
-      previewimagestart: 39146
-      previewimagelength: 0
-      scenemode: Standard
-      colormode: Natural sRGB
-      minoltaquality: Fine
-      flashexposurecomp: 0
-      teleconverter: None
-      imagestabilization: 'On'
-      zonematching: ISO Setting Used
-      colortemperature: 0
-      lenstype: Minolta AF 28-135mm F4-4.5 or Other Lens
-      usercomment: ''
-      flashpixversion: '0100'
-      colorspace: sRGB
-      exifimagewidth: 3008
-      exifimageheight: 2000
-      customrendered: Normal
-      exposuremode: Auto
-      digitalzoomratio: 0
-      focallengthin35mmformat: 112 mm
-      scenecapturetype: Standard
-      gaincontrol: Low gain up
-      contrast: Normal
-      saturation: Normal
-      sharpness: Normal
-      printimversion: '0300'
-      compression: JPEG (old-style)
-      thumbnailoffset: 39268
-      thumbnaillength: 1820
-      currentiptcdigest: e5ef1faceaa3d410961c63ab090136c7
-      applicationrecordversion: 4
-      supplementalcategories: Natur
-      keywords:
-      - Orange
-      - Rot
-      xmptoolkit: Image::ExifTool 9.45
-      title: Abenddämmerung
-      imagewidth: 1
-      imageheight: 1
-      encodingprocess: Baseline DCT, Huffman coding
-      bitspersample: 8
-      colorcomponents: 3
-      ycbcrsubsampling: YCbCr4:2:0 (2 2)
-      aperture: 9.5
-      imagesize: 1x1
-      lensid: Tokina AT-X 242 AF 24-200mm F3.5-5.6
-      megapixels: 1.0e-06
-      scalefactor35efl: 1.5
-      shutterspeed: 1/60
-      thumbnailimage: "(Binary data 1820 bytes, use -b option to extract)"
-      circleofconfusion: 0.020 mm
-      fov: 18.3 deg
-      focallength35efl: '75.0 mm (35 mm equivalent: 112.0 mm)'
-      hyperfocaldistance: 29.43 m
-      lightvalue: 10.4
-- []