phtools 0.15.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 78670fe468c1b5d9bbf25c5a5d8460a408354f36
-  data.tar.gz: 2566973828624a1aa604b02c0916d46cdec09b55
+SHA256:
+  metadata.gz: '07819be1531f4b0bca4d3387341a0be066b73c7fa57bed97b9103b8f112b9acf'
+  data.tar.gz: 0b6b8306c431d955ea55f507ab8fc843044e4fc15599e21d9fa664a20a2546b0
 SHA512:
-  metadata.gz: 9fac26d39ead526578a63fac032a39884dec6520b7220da590e476a86bc75013c4cd1490d90af61d22e0e36d49bd1b077bb4d5a40c7cca0db13b4c6cc6a66612
-  data.tar.gz: 59fe892d791534da62fbc2e94d675eb38b4fc230ab40ce801601d21d887c9fe47ebad22a99ad5b20237e52d47dc2f9496189888328f698852bff6efec75cfab2
+  metadata.gz: 3967e0b17bc660c2dabe9b507b1d9a7d7a0a5da4b3d7a260847930b847519ea29c5778c16bec12717db8c79058462d85cc889b40691e41f4b7a83706f0ed8c1a
+  data.tar.gz: 99d05fdd12e4e5d2d3cc28c1c5021fbe621d7b2feb43fc83ccf94c0e1ec71f944ea14c1a59e5ab06ec511943828a07357c06fd2e7242790bd3a18d5049468e5d

data/.gitignore

@@ -67,7 +67,6 @@ packer_cache/
 *.box
 
 # *** emacs
-*~
 \#*
 .\#*
 
@@ -78,7 +77,7 @@ packer_cache/
 *.un~
 Session.vim
 .netrwhist
-*~
+# *~
 
 # *** ruby
 *.gem
@@ -116,4 +115,5 @@ rerun.txt
 
 ## gem development with bundle
 /Gemfile.lock
-/pkg/
+
+/.idea/

data/.rubocop.yml

@@ -50,3 +50,6 @@ Style/UnneededInterpolation:
 
 Naming/AccessorMethodName:
   Enabled: false
+
+Performance/RangeInclude:
+  Enabled: false

data/History.md

@@ -1,5 +1,8 @@
 # RELEASED
 
+## [v0.16.0](https://github.com/andrewbiz/phtools/compare/v0.15.0...v0.16.0)
+* phtools now support Apple HEIC image file format (as exiftool it can only read tags)
+
 ## [v0.15.0](https://github.com/andrewbiz/phtools/compare/v0.14.0...v0.15.0)
 * phls now supports --range parameter allowing the user to filter files which name endings are not in the given range
 

data/README.md

@@ -1,61 +1,74 @@
 [![Version     ](https://img.shields.io/gem/v/phtools.svg?style=flat)](https://rubygems.org/gems/phtools)
+
 # PHTOOLS by ANB
+
 A bundle of small CLI tools for arranging, renaming, tagging of the photo and video files. Helps to keep photo-video assets in order.
 
 ## Rationale
+
 PHTOOLS is an instrument intended for photographers\photo enthusiasts who:
+
 * own tons of photo-video files and want to keep it in order
-* really don't like the way how digital cameras name the files: P1193691.JPG, IMP_1409.JPG, \_DSC1459.ARW etc.
-* for photo storage prefer usage of traditional File System (folder structure) instead of "black box" databases of media managers (like iPhoto, Photoshop etc.)
+* really don't like the way how digital cameras name the files: P1193691.JPG, IMP\_1409.JPG, \_DSC1459.ARW etc.
+* for photo storage prefer usage of traditional File System \(folder structure\) instead of "black box" databases of media managers \(like iPhoto, Photoshop etc.\)
 * would like to have date-time-original info in the name of the file
 * expects that sorting folder content "by name" will arrange photo-video assets in chronological order
-* for some events (wedding, holydays etc.) have photos from different authors and would like to keep visible author name (nik) in the file name
-* appreciate the use of internal metadata (EXIF, XMP etc.) beleiving it is the best way to keep context info of the picture
+* for some events \(wedding, holydays etc.\) have photos from different authors and would like to keep visible author name \(nik\) in the file name
+* 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.
-2. Install ExifTool by Phil Harvey (http://www.sno.phy.queensu.ca/~phil/exiftool/).
+
+1. Get the latest [ruby](https://www.ruby-lang.org/) \(>= 2.4\) installed.
+2. Install ExifTool by Phil Harvey \([http://www.sno.phy.queensu.ca/~phil/exiftool/](http://www.sno.phy.queensu.ca/~phil/exiftool/)\).
 3. `gem install phtools`
 4. Get list of phtools: `phtools`
 5. Get usage info for particular command: `phls -h`
 
 ### Install for development
+
 1. Fork or download from GitHub.
 2. Install dependencies: `bundle install`
 3. Develop.
 4. Test:
-```sh
-bundle exec rspec
-bundle exec cucumber
-```
-... or do testing automatically to get real Test Driven Development:
-```sh
-bundle exec guard
-```
+   ```sh
+   bundle exec rspec
+   bundle exec cucumber
+   ```
+
+   ... or do testing automatically to get real Test Driven Development:
+   ```sh
+   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` (lets call it _working folder_).
+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_.
+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:
+
 ```sh
 phls -R ~/Desktop/SDCard1 ~/Desktop/SDCard2 | phmove -a ~/Desktop/assets_staging
 ```
 
 #### Then
+
 I get all photos moved to `~/Desktop/assets_staging`.
 
 And all videos are moved to `~/Desktop/assets_staging/VIDEO`.
@@ -66,20 +79,25 @@ And all raw photo-files are moved to `~/Desktop/assets_staging/RAW`.
 
 ### 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)
+#### 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`.
 
-And my friend Alex it the author of the photos (nikname ALX).
+And my friend Alex it the author of the photos \(nikname ALX\).
 
 #### When
+
 I run:
+
 ```sh
 cd ~/Desktop/assets_staging
 phls | phbackup | phrename -a alx
 ```
 
 #### Then
+
 I get all photos in `~/Desktop/assets_staging` renamed according to PHTOOLS standard.
 
 And I have all original photo-files are backed-up to `~/Desktop/assets_staging/backup`.
@@ -87,72 +105,90 @@ And I have all original photo-files are backed-up to `~/Desktop/assets_staging/b
 ==========
 
 #### 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)
+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_)
+
+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 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._
+_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._
 
 ==========
 
 #### 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.
+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).
 
-**********
+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
-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 groups `DateTimeOriginal` or `CreateDate` for this purpose _(for more details see phrename help: `phrename -h`)_.
+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 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.
 
 **ORIGINAL.EXT** - original file name, created by digital camera.
 
-For example, the digital camera photo file `P1193691.JPG`, taken by AndrewBiz (aka ANB), after PHTOOLS processing will look like:
+For example, the digital camera photo file `P1193691.JPG`, taken by AndrewBiz \(aka ANB\), after PHTOOLS processing will look like:  
 `20160902-174939_ANB P1193691.JPG`
+

data/TODO.md

@@ -2,6 +2,7 @@
 - [x] core - runner.rb: print class instance variables in debug mode
 - [x] get rid of nesty
 - [x] switch to fresh MiniExiftool gem
+- [x] support of Apple HEIC files
 
 ### phls
 - [x] phls: use init method to initialize variables

data/extras/help-release.md

@@ -0,0 +1,8 @@
+# How to release a new gem version
+1. Develop and test the feature in a separate branch
+2. Merge branch in to master
+3. Bump a version (version.rb)
+4. Update TODO.md
+5. Update History.md
+6. Update README.md
+7. `rake release`

data/extras/logbook.md

@@ -0,0 +1,8 @@
+# Бортовой журнал проекта
+## 2018-01-22
+Стоит попробовать альтернативные утилиты работы с тегами:
+- [libexif/exif](https://github.com/libexif/exif)
+- [exiv2](http://www.exiv2.org/getting-started.html)
+- [jhead](http://www.sentex.net/~mwandel/jhead/)
+
+Надо бы подумать и сделать выбираемыми движки для работы с тегами - либо exiftool либо альтернатива

data/lib/phls.rb

@@ -49,7 +49,7 @@ module PhTools
     def output_file(phfile)
       return unless @file_type.include?(phfile.type)
       if @range
-        return unless (@range_start..@range_end).cover?(phfile.basename_clean.slice(-@ending_size, @ending_size))
+        return unless (@range_start..@range_end).include?(phfile.basename_clean.slice(-@ending_size, @ending_size))
       end
       @os.output(phfile)
     end

data/lib/phtools/ph_file.rb

@@ -10,7 +10,7 @@ require 'fileutils'
 
 module PhTools
   # media type constants
-  FILE_TYPE_IMAGE_NORMAL = %w[jpg jpeg tif tiff png].freeze
+  FILE_TYPE_IMAGE_NORMAL = %w[jpg jpeg tif tiff png heic].freeze
   FILE_TYPE_IMAGE_RAW = %w[orf arw dng].freeze
   FILE_TYPE_IMAGE = FILE_TYPE_IMAGE_NORMAL + FILE_TYPE_IMAGE_RAW
   FILE_TYPE_VIDEO = %w[avi mp4 mpg mts dv mov mkv m2t m2ts 3gp].freeze

data/lib/phtools/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PhTools
-  VERSION = '0.15.0'
+  VERSION = '0.16.1'
 end

data/phtools.gemspec

@@ -24,7 +24,7 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = '>= 2.0.0'
 
-  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'bundler'#, '~> 2.0'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'rspec-its'
@@ -35,6 +35,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard-rspec'
   spec.add_development_dependency 'guard-cucumber'
   spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'bigdecimal', '1.3.5'
 
   if RbConfig::CONFIG['target_os'] =~ /darwin/i
     spec.add_development_dependency 'terminal-notifier-guard'
@@ -49,6 +50,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'mini_exiftool', '~> 2.8'
   spec.add_runtime_dependency 'activesupport', '~> 3.2'
   spec.add_runtime_dependency 'i18n'
+  spec.add_runtime_dependency 'bigdecimal', '1.3.5'
 
   spec.post_install_message = %Q{***\n Thanks for installing phtools! Don't forget to get the ExifTool by Phil Harvey (http://www.sno.phy.queensu.ca/~phil/exiftool/) installed on your system.\n***}
 end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: phtools
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.1
 platform: ruby
 authors:
 - Andrew Bizyaev
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2017-11-04 00:00:00.000000000 Z
+date: 2022-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.12'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.12'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -164,6 +164,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
 - !ruby/object:Gem::Dependency
   name: terminal-notifier-guard
   requirement: !ruby/object:Gem::Requirement
@@ -234,6 +248,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
 description: A bundle of small CLI tools for arranging, renaming, tagging of the photo
   and video files. Helps to keep your photo-video assets in order.
 email:
@@ -273,6 +301,8 @@ files:
 - exe/phmove
 - exe/phrename
 - exe/phtools
+- extras/help-release.md
+- extras/logbook.md
 - lib/phbackup.rb
 - lib/phevent.rb
 - lib/phfixdto.rb
@@ -343,9 +373,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - ExifTool by Phil Harvey (http://www.sno.phy.queensu.ca/~phil/exiftool/)
-rubyforge_project: 
-rubygems_version: 2.6.13
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: A set of usefull tools to manipulate photo-video files.
 test_files: []