Running exiftool on an existing export

[RhetTbull]

I've added a new osxphotos exiftool command in v0.49.2. It solves the following problem:

1. You exported a large Photos library but did not use --exiftool to write metadata
2. You decided you do want to use exiftool to update the metadata.
3. But if you run osxphotos export --update --exiftool, every photo will get re-exported before exiftool is run because osxphotos will see that the existing file signature doesn't match the expected file signature (which now includes exiftool updates).

osxphotos exiftool will run exiftool on every file from a previous export then also update the database so the next time you run osxphotos export --update --exiftool, osxphotos will see the correct signature and not re-export all files. This is much faster than re-exporting your entire library.

Use osxphotos help exiftool for help options. It accepts all the same exiftool options and templates as osxphotos export does.

> osxphotos export ~/Desktop/export --name IMG_1994 --verbose
...
Exporting 1 photo to /Users/rhet/Desktop/export...
Exporting IMG_1994.JPG (A92D9C26-3A50-4197-9388-CB5F7DB9FA91.jpeg) as IMG_1994.JPG (1/1)
Exported /Users/rhet/Desktop/export/IMG_1994.JPG
Exported /Users/rhet/Desktop/export/IMG_1994.cr2
Exporting 1 photos ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
Processed: 1 photo, exported: 2, missing: 0, error: 0

> osxphotos exiftool ~/Desktop/export --verbose
...
Processing file /Users/rhet/Desktop/export/IMG_1994.JPG (1/2)
Writing metadata with exiftool for IMG_1994.JPG
Updated EXIF metadata for /Users/rhet/Desktop/export/IMG_1994.JPG
Processing file /Users/rhet/Desktop/export/IMG_1994.cr2 (2/2)
Writing metadata with exiftool for IMG_1994.cr2
Updated EXIF metadata for /Users/rhet/Desktop/export/IMG_1994.cr2
Processed: 2 photos, skipped: 0, updated EXIF data: 2,

>osxphotos export ~/Desktop/export --name IMG_1994 --verbose --exiftool --update
...
Exporting 1 photo to /Users/rhet/Desktop/export...
Exporting IMG_1994.JPG (A92D9C26-3A50-4197-9388-CB5F7DB9FA91.jpeg) as IMG_1994.JPG (1/1)
Skipped up to date file /Users/rhet/Desktop/export/IMG_1994.JPG
Skipped up to date file /Users/rhet/Desktop/export/IMG_1994.cr2
Exporting 1 photos ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
Processed: 1 photo, exported: 0, updated: 0, skipped: 2, updated EXIF data: 0, missing: 0, error: 0

> osxphotos help exiftool
Usage: osxphotos exiftool [OPTIONS] EXPORT_DIRECTORY

  Run exiftool on previously exported files to update metadata.

  If you previously exported photos with `osxphotos export` but did not
  include the `--exiftool` option and you now want to update the metadata of
  the exported files with exiftool, you can use this command to do so.

  If you simply re-run the `osxphotos export` with `--update` and
  `--exiftool`, osxphotos will re-export all photos because it will detect
  that the previously exported photos do not have the exiftool metadata
  updates.  This command will run exiftool on the previously exported photos
  to update all metadata then will update the export database so that using
  `--exiftool --update` with `osxphotos export` in the future will work
  correctly and not unnecessarily re-export photos.

Options:
  --db-config                     Load configuration options from the export
                                  database to match the last export; If any
                                  other command line options are used in
                                  conjunction with --db-config, they will
                                  override the corresponding values loaded
                                  from the export database; see also --load-
                                  config.
  --load-config CONFIG_FILE       Load options from file as written with
                                  --save-config. If any other command line
                                  options are used in conjunction with --load-
                                  config, they will override the corresponding
                                  values in the config file; see also --db-
                                  config.
  --save-config CONFIG_FILE       Save options to file for use with --load-
                                  config. File format is TOML.
  --exiftool-path EXIFTOOL_PATH   Optionally specify path to exiftool; if not
                                  provided, will look for exiftool in $PATH.
  --exiftool-option OPTION        Optional flag/option to pass to exiftool
                                  when using --exiftool. For example,
                                  --exiftool-option '-m' to ignore minor
                                  warnings. Specify these as you would on the
                                  exiftool command line. See exiftool docs at
                                  https://exiftool.org/exiftool_pod.html for
                                  full list of options. More than one option
                                  may be specified by repeating the option,
                                  e.g. --exiftool-option '-m' --exiftool-
                                  option '-F'.
  --exiftool-merge-keywords       Merge any keywords found in the original
                                  file with keywords used for '--exiftool' and
                                  '--sidecar'.
  --exiftool-merge-persons        Merge any persons found in the original file
                                  with persons used for '--exiftool' and '--
                                  sidecar'.
  --ignore-date-modified          If used with --exiftool or --sidecar, will
                                  ignore the photo modification date and set
                                  EXIF:ModifyDate to EXIF:DateTimeOriginal;
                                  this is consistent with how Photos handles
                                  the EXIF:ModifyDate tag.
  --person-keyword                Use person in image as keyword/tag when
                                  exporting metadata.
  --album-keyword                 Use album name as keyword/tag when exporting
                                  metadata.
  --keyword-template TEMPLATE     For use with --exiftool, --sidecar; specify
                                  a template string to use as keyword in the
                                  form '{name,DEFAULT}' This is the same
                                  format as --directory.  For example, if you
                                  wanted to add the full path to the folder
                                  and album photo is contained in as a keyword
                                  when exporting you could specify --keyword-
                                  template "{folder_album}" You may specify
                                  more than one template, for example
                                  --keyword-template "{folder_album}"
                                  --keyword-template "{created.year}". See '--
                                  replace-keywords' and Templating System
                                  below.
  --replace-keywords              Replace keywords with any values specified
                                  with --keyword-template. By default,
                                  --keyword-template will add keywords to any
                                  keywords already associated with the photo.
                                  If --replace-keywords is specified, values
                                  from --keyword-template will replace any
                                  existing keywords instead of adding
                                  additional keywords.
  --description-template TEMPLATE
                                  For use with --exiftool, --sidecar; specify
                                  a template string to use as description in
                                  the form '{name,DEFAULT}' This is the same
                                  format as --directory.  For example, if you
                                  wanted to append 'exported with osxphotos on
                                  [today's date]' to the description, you
                                  could specify --description-template
                                  "{descr} exported with osxphotos on
                                  {today.date}" See Templating System below.
  --exportdb EXPORTDB             Optional path to export database (if not in
                                  the default location in the export
                                  directory).
  --report REPORT_FILE            Write a report of all files that were
                                  exported. The extension of the report
                                  filename will be used to determine the
                                  format. Valid extensions are: .csv (CSV
                                  file), .json (JSON), .db and .sqlite (SQLite
                                  database). REPORT_FILE may be a template
                                  string (see Templating System), for example,
                                  --report 'export_{today.date}.csv' will
                                  write a CSV report file named with today's
                                  date. See also --append.
  --append                        If used with --report, add data to existing
                                  report file instead of overwriting it. See
                                  also --report.
  -V, --verbose                   Print verbose output.
  --timestamp                     Add time stamp to verbose output
  --dry-run                       Run in dry-run mode (don't actually update
                                  files), e.g. for use with --update-
                                  signatures.
  --theme THEME                   Specify the color theme to use for --verbose
                                  output. Valid themes are 'dark', 'light',
                                  'mono', and 'plain'. Defaults to 'dark' or
                                  'light' depending on system dark mode
                                  setting.
  --db PHOTOS_LIBRARY_PATH        Specify Photos database path. Path to Photos
                                  library/database can be specified using
                                  either --db or directly as PHOTOS_LIBRARY
                                  positional argument. If neither --db or
                                  PHOTOS_LIBRARY provided, will attempt to
                                  find the library to use in the following
                                  order: 1. last opened library, 2. system
                                  library, 3. ~/Pictures/Photos
                                  Library.photoslibrary
  -h, --help                      Show this message and exit.