immich-sdk/examples/album_management.rs

//! Example: Album management (CRUD operations)
//!
//! This example demonstrates creating, reading, updating, and deleting albums
//!
//! Environment variables:
//! - IMMICH_URL: The Immich server URL (defaults to http://localhost:2283)
//! - IMMICH_API_KEY: Your API key (required)

use immich_sdk::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Configure the client from environment variables
    let url = std::env::var("IMMICH_URL").unwrap_or_else(|_| "http://localhost:2283".to_string());
    let api_key =
        std::env::var("IMMICH_API_KEY").expect("IMMICH_API_KEY environment variable not set");

    // Create a client
    let client = Client::from_url(&url)?.with_api_key(api_key);

    println!("=== Album Management Example ===\n");

    // List all albums
    println!("1. Listing all albums...");
    let albums = client.albums().list().execute().await?;
    println!("   Found {} albums", albums.len());

    for album in &albums {
        println!(
            "   - {} (ID: {}, {} assets)",
            album.album_name, album.id, album.asset_count
        );
    }
    println!();

    // Get details of the first album if one exists
    let existing_album = albums.first().cloned();
    if let Some(ref album) = existing_album {
        println!("2. Getting album details...");
        let details = client.albums().get(album.id).execute().await?;
        println!("   Album: {}", details.album_name);
        println!("   Description: {}", details.description);
        println!("   Asset count: {}", details.asset_count);
        println!();
    }

    // Create a new album
    println!("3. Creating a new album...");
    let new_album = client
        .albums()
        .create()
        .name("SDK Test Album")
        .execute()
        .await?;
    println!(
        "   Created album: {} (ID: {})",
        new_album.album_name, new_album.id
    );
    println!();

    // If we have assets, add some to the album
    let asset_ids: Vec<_> = existing_album
        .as_ref()
        .map(|a| a.assets.iter().map(|asset| asset.id).collect())
        .unwrap_or_default();

    if !asset_ids.is_empty() {
        println!("4. Adding assets to the new album...");
        let asset_ids_to_add: Vec<_> = asset_ids.iter().take(2).copied().collect();
        let num_added = asset_ids_to_add.len();
        client
            .albums()
            .add_assets(new_album.id)
            .asset_ids(asset_ids_to_add.clone())
            .execute()
            .await?;
        println!("   Added {} assets to the album", num_added);

        // Get updated album details
        let updated_details = client.albums().get(new_album.id).execute().await?;
        println!("   Album now has {} assets", updated_details.asset_count);
        println!();

        // Remove assets from the album
        println!("5. Removing assets from the album...");
        client
            .albums()
            .remove_assets(new_album.id)
            .asset_ids(asset_ids_to_add)
            .execute()
            .await?;
        println!("   Removed {} assets from the album", num_added);

        let after_removal = client.albums().get(new_album.id).execute().await?;
        println!("   Album now has {} assets", after_removal.asset_count);
        println!();
    } else {
        println!("4. Skipping asset operations (no existing assets found)");
        println!();
    }

    // Update the album
    println!("6. Updating album name and description...");
    let updated = client
        .albums()
        .update(new_album.id)
        .name("Updated SDK Album")
        .description("This description was updated by the SDK example")
        .execute()
        .await?;
    println!("   Updated album name: {}", updated.album_name);
    println!("   Updated description: {}", updated.description);
    println!();

    // Delete the album
    println!("7. Deleting the album...");
    client.albums().delete(new_album.id).execute().await?;
    println!("   Album deleted successfully");
    println!();

    // Verify deletion by listing albums again
    println!("8. Verifying deletion...");
    let albums_after = client.albums().list().execute().await?;
    let still_exists = albums_after.iter().any(|a| a.id == new_album.id);
    if still_exists {
        println!("   Warning: Album still exists after deletion attempt");
    } else {
        println!("   Confirmed: Album no longer exists");
    }

    println!("\n=== Example completed successfully ===");
    Ok(())
}