Initial support for iCloud Shared Libraries

[v0.62.0] - 20230812

This release contains a lot of changes some of which may be breaking depending on your workflow. If you use --sidecar-template, you should look at the help for this option as the options have changed from boolean flags to named flags.

If you use --report with --append and you use CSV reports, you should archive the existing report and start a new one as the report now contains additional fields for user files.

If you use --post-function, the called function may now return an ExportResults object with information about the files written, the files skipped, and any errors generated. If returned, these files will be included in --report and will be protected from cleanup with --cleanup.

Initial support for photos in Shared iCloud Libraries has been implemented. These photos can be queried via the --shared-library option. Still working on decoding the participant information (who is sharing the photos).

Merged PRs

Added

• Support for iCloud shared libraries, PhotoInfo.shared_library, PhotoInfo.share_participants, PhotoInfo.share_info (#860)
• Shared moment, syndicated, shared library support to osxphotos inspect(#860)
• --post-command-error option to configure error handling of --post-command (#1142)
• .osxphotos_keep file can now be used to specify keep patterns for --cleanup (#1135)
• Option to --sidecar-template to skip zero length files

Removed

Changed

• Changed --sidecar-template options to use named options instead of boolean
• Changed signature of --post-function function to enable it to work with --report, --cleanup (#1136)
• Now can catch template errors with catch_errors option to --sidecar-template

Fixed

• Fixed bug with PhotoInfo.path_raw on Photos <= 4.0

Contributors

• @RhetTbull - Code and testing
• @neilpa - The idea for custom sidecars and suggestions to improve the feature
• @kvisle - For user testing with iCloud shared libraries