Add OCC comand add-photo-to-album

[mchugh19]

Creates a simple CLI for creating an album and adding a photo file to an album.

# occ photos:albums:create xian "Picnic 2023"

# occ photos:albums:create --help
Description:
  Create a new album for a user

Usage:
  photos:albums:create [options] [--] <user> <album>

Arguments:
  user                     User to own album
  album                    Album name

Options:
  -l, --location=LOCATION  Set album location (optional) [default: ""]

# occ photos:albums:add xian "Picnic 2023" "Photos/2023/08/P1010138.JPG"

# occ photos:albums:add --help
Description:
  Add specified photo to album

Usage:
  photos:albums:add <user> <album> <file>

Arguments:
  user                  User owning the album
  album                 Album name
  file                  Path of file to add to the album. It must already be scanned and available in NextCloud. Example: Photos/picture1.jpg

[mchugh19]

Not sure what you'd like for the UI. It seems like a couple of commands would be useful from OCC. Right now there's creating an album and adding pictures to it. This covers my main scripting use-cases, but if more features should be exposed to to occ, perhaps it makes sense to define if you'd like them in a single command file vs the multiple I have done here.

[artonge]

The title is also misleading

[artonge]

Sorry, didn't see the other file, the title is not so misleading :)

[mchugh19]

I think I've addressed the comments and it's looking alright now.

[artonge]

Some CI steps are failing.

For php-cs, can you run:

composer run cs:fix

And then commit.

For DCO, can you run:

git rebase HEAD~8 --signoff

And then push.

[mchugh19]

Thanks for the instruction, I've never worked in a php environment before.
I think this is done.

[artonge]

You might have changed too many commits when running the DCO command :/

[mchugh19]

You might have changed too many commits when running the DCO command :/

Indeed! Alright, Nth time's the charm! DCO seems happy now, so I think this might be getting close.

[artonge]

Looks perfect 👍

[github-actions]

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the reviewing process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR reviewing process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

[RTechSn]

Hey, for anyone stumbled upon this - I made a bash script for adding a whole folder to an album.

#!/bin/bash

# Define the Nextcloud data directory (adjust this path as necessary)
nextcloud_data="/mnt/nextcloud/data"

# Set the user that has permissions to access the Nextcloud files
www_data_user="www-data"

# Set the occ command
occ_command="php /var/www/nextcloud/occ"

# Check if the correct number of arguments is provided
if [ "$#" -ne 3 ]; then
    echo "Usage: $0 <username> <album_name> <relative_path>"
    echo "Example: $0 myname \"Summer 2023\" \"Photos/Summer2023\""
    exit 1
fi

# Assign arguments to variables for better readability
username=$1
album_name=$2
relative_path=$3


# Construct the full path to the target directory
target_directory="$nextcloud_data/$username/files/$relative_path"

# Check if the directory is accessible by attempting to list its contents as www-data user
if sudo -u "$www_data_user" ls "$target_directory" >/dev/null 2>&1; then

    # List all image files and add them to the album
    image_files=$(sudo -u "$www_data_user" find "$target_directory" -type f \( -name "*.jpg" -o -name "*.jpeg" -o -name "*.png" -o -name "*.gif" \) 2>/dev/null)

    # Check if any image files were found
    if [ -z "$image_files" ]; then
        echo "No image files found in directory: $target_directory"
        exit 0
    fi

    sudo -u "$www_data_user" $occ_command photos:albums:create "$username" "$album_name"

    while IFS= read -r file; do  # Use read to handle spaces correctly
        # Construct the relative path including subdirectory structure
        relative_file_path="${file#$nextcloud_data/$username/files/}"  # Remove base path to get relative path from user files directory

        # Output which file is being added
        echo "Adding: \"$relative_file_path\""

        # Add the file to the album using occ command
        sudo -u "$www_data_user" $occ_command photos:albums:add "$username" "$album_name" "$relative_file_path"
    done <<< "$image_files"


    echo "All image files added to album '$album_name' for user '$username'."
else
    echo "Permission denied or directory not found: $target_directory"
    exit 1
fi