Batch edit photo metadata

[RhetTbull]

I'm working on implementing #949 to add a batch edit tool for batch editing photo titles, keywords, description, etc. There's a commercial product Photos Workbench that sells for 29 USD that does this (along with a couple other things). I've implemented most of the batch-edit functionality in about 100 lines of python using osxphotos -- took me about an hour. The current code is in examples/batch_edit.py if you'd like to play with it. I'll be adding this as a feature command in osxphotos eventually. In the meantime you can run it with osxphotos run batch_edit.py. See osxphotos run batch_edit.py --help for help. This command operates on photos currently selected in Photos.

The commercial product has a GUI and is certainly easy and my intent is not to malign this product but simply to showcase how powerful osxphotos is and how easy it is (especially using the new command line tools like @selection_command) to make powerful tools in just a little bit of code.

For example:

    osxphotos run batch_edit.py \
    --verbose \
    --title "California vacation 2023 {created.year}-{created.dd}-{created.mm} {counter:03d}" \
    --description "{place.name}" \
    --keyword "Family" --keyword "Travel" --keyword "{keyword}"

This will set the title to "California vacation 2023 2023-02-20 001", and so on, the description to the reverse geolocation place name, and the keywords to "Family", "Travel", and any existing keywords of the photo.

[RhetTbull]

In v0.58.0, there's a new osxphotos batch-edit command that implements all the functionality of the example code in examples/batch_edit.py and even adds an undo. Let me know what you think!

Usage: osxphotos [OPTIONS] COMMAND [ARGS]...

  osxphotos: the multi-tool for your Photos library

Options:
  -v, --version                   Show the version and exit.

  For example:

      osxphotos batch-edit \
      --verbose \
      --title "California vacation 2023 {created.year}-{created.dd}-{created.mm} {counter:03d}" \
      --description "{place.name}" \
      --keyword "Family" --keyword "Travel" --keyword "{keyword}"

  This will set the title to "California vacation 2023 2023-02-20 001", and so
  on, the description to the reverse geolocation place name,  and the keywords
  to "Family", "Travel", and any existing keywords of the photo.

  --title, --description, and --keyword may be any valid template string. See
  https://rhettbull.github.io/osxphotos/template_help.html  or `osxphotos
  docs` for more information on the osxphotos template system.

Options:
  --title TITLE_TEMPLATE          Set title of photo.
  --description DESCRIPTION_TEMPLATE
                                  Set description of photo.
  --keyword KEYWORD_TEMPLATE      Set keywords of photo. May be specified
                                  multiple times.
  --location LATITUDE LONGITUDE   Set location of photo. Must be specified as
                                  a pair of numbers with latitude in the range
                                  -90 to 90 and longitude in the range -180 to
                                  180.
  --dry-run                       Don't actually change anything.
  --undo                          Restores photo metadata to what it was prior
                                  to the last batch edit. May be combined with
                                  --dry-run.
  -V, --verbose                   Print verbose output; may be specified
                                  multiple times for more verbose output.
  --timestamp                     Add time stamp to verbose output
  --theme THEME                   Specify the color theme to use for output.
                                  Valid themes are 'dark', 'light', 'mono',
                                  and 'plain'. Defaults to 'dark' or 'light'
                                  depending on system dark mode setting.
  --library, --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.