phtools 0.7.7 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fdb79b3f95706f20dc3105e159bba0228c5b7542
-  data.tar.gz: 976d6852897171998919dcbb3d771f46d729ae10
+  metadata.gz: 35103e10dc96a7315a527248a7e295f5b336b52e
+  data.tar.gz: c0a2fcd464db08183e823fc1759d423f885d5843
 SHA512:
-  metadata.gz: 5e996378046496d338500dfb1d8c4762b8f640684469db603c84a89a29f68d1219e96341c610254de6146785e2295b13caccae6ec64a97915c03bc10587c539b
-  data.tar.gz: 5214e3b953ef6dfd445df54f05115adb887cb4f595fed8f57b03cbafe875afa870d0aff7fee5176895d1fcf6015fae38830891d98e7dd5250e9ebf8a44fb6fe6
+  metadata.gz: 6012cc53aeda379d7cb75f6df82378998044bdac8d3a5276036953490a5fb54c3e1844575c0a4b6d4cc86de0f3cdd583799955aaeb47f30abeca6f33fafe8756
+  data.tar.gz: 639149c172010838bd0972e7356f30fce64350035bf42c63b45fdda471e4be4fa2ff67901cac424a607dfe6e662c515cf918c8e75a0413f94d9fd6dd2e217de6

data/History.md

@@ -1,5 +1,15 @@
 # RELEASED
 
+## [v0.8.0](https://github.com/andrewbiz/phtools/compare/v0.7.7...v0.8.0)
+
+## [v0.7.7](https://github.com/andrewbiz/phtools/compare/v0.6.0...v0.7.7)
+* phrename: added --shift_time option
+* phrename is idempotent (safe to be re-run several times on one file)
+* phrename: by-default now it scans several EXIF tags to retreive date-time creation info. If no tags are found - File ModifyDate (mtime) is used to rename file. See more details in `phrename -h`
+* phrename becomes more informative: reports which EXIF tag was taken, or if the date-time in name was kept unchanged. This flow goes to STDERR to keep STDOUT clean
+* phbackup now preserves FileModify dates
+* internal improvements: switch to mini_exiftool gem, get rid of nesty gem (using standard Ruby *cause* for Exceptions)
+
 ## [v0.6.0](https://github.com/andrewbiz/phtools/compare/v0.4.0...v0.6.0)
 * phmove: does not keep unused empty VIDEO and RAW folders
 * phrename: --clean option renames files back to original state

data/README.md

@@ -106,7 +106,7 @@ 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_) 
+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_.
 
@@ -122,7 +122,7 @@ 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._ 
+_Note. `phrename` is smart enough to let the user to re-run it several times on one file. Every time `phrename -a` re-runs it only overwrites author nickname (if it is different) keeping date-time-in-the-name unchanged._
 
 ==========
 
@@ -130,7 +130,7 @@ _Note. `phrename` is smart enough to let the user to run it several times on one
 #### 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. 
+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:
@@ -148,7 +148,7 @@ I get all _mov_ files in `~/Desktop/assets_staging` renamed with correct _YYYYmm
 ### PHTOOLS Standard file name
 PHTOOLS standard file name looks like this: **`YYYYmmdd-HHMMSS_AAA ORIGINAL.EXT`**, where
 
-**YYYYmmdd-HHMMSS** - photo creation datestamp (year-month-day-hours-minutes-seconds). By default PHTOOLS use the value of EXIF tag `DateTimeOriginal` or `CreateDate` for this purpose.
+**YYYYmmdd-HHMMSS** - photo creation datestamp (year-month-day-hours-minutes-seconds). By default PHTOOLS use the value of EXIF tag groups `DateTimeOriginal` or `CreateDate` for this purpose _(for more details see phrename help: `phrename -h`)_.
 
 **AAA** - author nikname. 3 character long, only latin alphabet supported.
 

data/TODO.md

@@ -1,16 +1,42 @@
+### PHTOOLS Core
 - [x] core - runner.rb: print class instance variables in debug mode
+- [x] get rid of nesty
+- [x] switch to fresh MiniExiftool gem
+
+### phls
 - [x] phls: use init method to initialize variables
 - [x] phls: change -r to -R
 - [ ] phls: make it work with .folders (like ftls did)
+
+### phmove
 - [x] phmove: create phmove tool based on ftarrange code (see ftools repo)
 - [x] phmove: make target_folder as parameter not an option
 - [x] phmove: -a (--arrange) parameter means to put photo, video, raw files into separate folders inside target. If -a is not set all files are moved to root of target directory (plain collection of files)
 - [x] phmove: delete unused empty RAW and VIDEO folders
 - [ ] phmove: make options to set video, raw folder names
+
+### phrename
 - [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
+
+### phgettags
+- [ ] create phgettags (based on ftmtags)
+
+### phfixfmd
+- [x] create phfixfmd - fix FileModifyDate to get equal to date-time-in-the-name
+
+### phfixdto
+- [ ] create phfixdto - fix MWG:DateTimeOriginal = date-time-in-name
+- [ ] phfixdto: make -N --no_run option = no running exiftool script, only preparation
+
+### phevent
+- [ ] create phevent  (based on ftevent)
+- [ ] phevent: -T --template - gets empty template for event.yaml
+
+### phsettags
+- [ ] create phsettags (based on fttagset)
+- [ ] phsettags: make -N --no_run option = no running exiftool script, only preparation
+- [ ] phsettags: -T --template - gets empty templates for authors.yaml and places.yaml

data/exe/phfixfmd

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# (c) ANB Andrew Bizyaev
+
+module PhTools
+  tool_name = File.basename(__FILE__)
+  require "#{tool_name}"
+
+  file_type = FILE_TYPE_IMAGE + FILE_TYPE_VIDEO + FILE_TYPE_AUDIO
+  usage = <<DOCOPT
+***************************************************
+phtools - *Keep Your Photos In Order* (c) ANB
+***************************************************
+  #{tool_name} changes an input file modify-date according to the date encoded
+in the filename (date-time-in-the-name). Therefore the file should be renamed
+to phtools Standard Name before using this command (use phrename for this).
+  #{tool_name} acts as a 'filter' program meaning it expects the input files
+to be passed to STDIN and after the job is done it produces STDOUT with the list
+of processed files. In other words this command is intended to be used with
+other programs connected via pipes, e.g.:
+  phls | phrename -a anb | #{tool_name} | phmove ~/targed/folder
+
+Usage:
+  #{tool_name} [-D]
+  #{tool_name} -h | --help
+  #{tool_name} -v | --version
+
+Options:
+  -D --debug    Turn on debugging (verbose) mode
+  -h --help     Show this screen.
+  -v --version  Show version.
+DOCOPT
+
+  PhTools.const_get(tool_name.capitalize).new(usage, file_type).run!
+end

data/lib/phfixfmd.rb

@@ -6,8 +6,22 @@ require 'phtools/runner'
 
 module PhTools
   class Phfixfmd < Runner
+
     def self.about
-      "!UNDER CONSTRUCTION!"
+      "fixes FileModifyDate to be equal to date-time-in-the-name"
+    end
+
+    private
+
+    def process_file(phfile)
+      fail PhTools::Error, 'wrong date-time in the name' unless
+        phfile.date_time_ok?
+      begin
+        File.utime(Time.now, phfile.date_time_to_time, phfile.filename)
+      rescue
+        raise PhTools::Error.new, 'setting file modify date'
+      end
+      phfile
     end
   end
 end

data/lib/phtools/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phtools
 version: !ruby/object:Gem::Version
-  version: 0.7.7
+  version: 0.8.0
 platform: ruby
 authors:
 - Andrew Bizyaev
@@ -240,6 +240,7 @@ email:
 - andrew.bizyaev@gmail.com
 executables:
 - phbackup
+- phfixfmd
 - phls
 - phmove
 - phrename
@@ -261,6 +262,7 @@ files:
 - bin/setup
 - bin/stmux
 - exe/phbackup
+- exe/phfixfmd
 - exe/phls
 - exe/phmove
 - exe/phrename