basic_operations.py

"""
Basic Operations Example using High-Level Utilities

This example demonstrates common Alfresco operations using the high-level
content_utils_highlevel and node_utils_highlevel modules. Shows dramatic
simplification for folder creation, node deletion, and basic file operations.

Original MCP implementation: 554 lines across multiple tools
High-level utilities: ~70 lines total (86% reduction)
"""

from python_alfresco_api.client_factory import ClientFactory
from python_alfresco_api.utils.content_utils_highlevel import (
    create_folder_highlevel,
    create_document_highlevel,
    get_node_info_highlevel
)
from python_alfresco_api.utils.node_utils_highlevel import (
    get_node_highlevel,
    list_children_highlevel,
    delete_node_highlevel,
    get_node_path_highlevel,
    bulk_delete_nodes_highlevel
)


def folder_operations_example():
    """Example of folder creation and management."""
    
    client_factory = ClientFactory()
    core_client = client_factory.create_core_client()
    
    print("Example 1: Folder operations")
    
    try:
        # Create a new folder
        print("[FOLDER] Creating folder...")
        folder_result = create_folder_highlevel(
            core_client=core_client,
            name="My Project Folder",
            parent_id="-shared-",
            description="Project documents and files"
        )
        print(f"[SUCCESS] Folder created: {folder_result}")
        
        # Create a subfolder (you'd extract the folder ID from previous result)
        folder_id = "your-folder-id-here"
        print("[FOLDER] Creating subfolder...")
        subfolder_result = create_folder_highlevel(
            core_client=core_client,
            name="Documents",
            parent_id=folder_id,
            description="Document storage"
        )
        print(f"[SUCCESS] Subfolder created: {subfolder_result}")
        
    except Exception as e:
        print(f"[ERROR] Folder operations failed: {e}")


def document_creation_example():
    """Example of creating documents from text content."""
    
    client_factory = ClientFactory()
    core_client = client_factory.create_core_client()
    
    print("\nExample 2: Document creation")
    
    try:
        # Create a text document (without content first)
        print("[DOCUMENT] Creating text document...")
        document_result = create_document_highlevel(
            core_client=core_client,
            name="Project Notes.txt",
            parent_id="-my-",
            description="Project planning notes"
        )
        print(f"[SUCCESS] Document created: {document_result}")
        
        # Note: To add content, you would use update_content_from_string_highlevel
        # or create_and_upload_file_highlevel for files with content
        
        # Create a markdown document (without content)  
        print("[DOCUMENT] Creating markdown document...")
        markdown_result = create_document_highlevel(
            core_client=core_client,
            name="Project Plan.md",
            parent_id="-shared-",
            title="Project Plan Document"
        )
        print(f"[SUCCESS] Markdown document created: {markdown_result}")
        
    except Exception as e:
        print(f"[ERROR] Document creation failed: {e}")


def browsing_operations_example():
    """Example of browsing and getting node information."""
    
    client_factory = ClientFactory()
    core_client = client_factory.create_core_client()
    
    print("\nExample 3: Browsing operations")
    
    try:
        # List children of shared folder
        print("[BROWSE] Listing shared folder contents...")
        children_result = list_children_highlevel(
            core_client=core_client,
            parent_id="-shared-",
            max_items=50
        )
        print(f"[RESULTS] Shared folder contents: {children_result}")
        
        # Get detailed node information
        node_id = "your-node-id-here"
        print("[INFO] Getting node details...")
        node_info = get_node_highlevel(core_client, node_id)
        print(f"[RESULTS] Node details: {node_info}")
        
        # Get node path
        print("[PATH] Getting node path...")
        node_path = get_node_path_highlevel(core_client, node_id)
        print(f"[RESULTS] Node path: {node_path}")
        
    except Exception as e:
        print(f"[ERROR] Browsing operations failed: {e}")


def deletion_operations_example():
    """Example of deleting nodes and cleanup operations."""
    
    client_factory = ClientFactory()
    core_client = client_factory.create_core_client()
    
    print("\nExample 4: Deletion operations")
    
    try:
        # Delete a single node
        node_to_delete = "your-node-id-here"
        print("[DELETE] Deleting single node...")
        delete_result = delete_node_highlevel(
            core_client=core_client,
            node_id=node_to_delete,
            permanent=False  # Move to trash (can be restored)
        )
        print(f"[SUCCESS] Node deleted: {delete_result}")
        
        # Bulk delete multiple nodes
        nodes_to_delete = [
            "node-id-1",
            "node-id-2", 
            "node-id-3"
        ]
        print("[DELETE] Bulk deleting nodes...")
        bulk_delete_result = bulk_delete_nodes_highlevel(
            core_client=core_client,
            node_ids=nodes_to_delete,
            permanent=False
        )
        print(f"[SUCCESS] Bulk delete completed: {bulk_delete_result}")
        
        # Permanent deletion (cannot be restored)
        print("[WARNING] Permanent deletion...")
        permanent_delete_result = delete_node_highlevel(
            core_client=core_client,
            node_id="node-to-permanently-delete",
            permanent=True
        )
        print(f"[SUCCESS] Permanently deleted: {permanent_delete_result}")
        
    except Exception as e:
        print(f"[ERROR] Deletion operations failed: {e}")


def workspace_organization_example():
    """Example of organizing a workspace with folders and documents."""
    
    client_factory = ClientFactory()
    core_client = client_factory.create_core_client()
    
    print("\nExample 5: Workspace organization")
    
    try:
        # Create main project folder
        print("[WORKSPACE] Creating project workspace...")
        project_folder = create_folder_highlevel(
            core_client=core_client,
            name="New Project 2024",
            parent_id="-my-",
            description="Main project folder for 2024 initiative"
        )
        print(f"[SUCCESS] Project folder: {project_folder}")
        
        # Assume we extracted the folder ID
        project_id = "extracted-project-folder-id"
        
        # Create organized subfolders
        subfolders = [
            {"name": "Documents", "desc": "Project documentation"},
            {"name": "Resources", "desc": "Reference materials"},
            {"name": "Meeting Notes", "desc": "Meeting recordings and notes"},
            {"name": "Deliverables", "desc": "Final project outputs"}
        ]
        
        created_folders = []
        for folder_info in subfolders:
            print(f"[FOLDER] Creating {folder_info['name']} folder...")
            subfolder_result = create_folder_highlevel(
                core_client=core_client,
                name=folder_info["name"],
                parent_id=project_id,
                description=folder_info["desc"]
            )
            created_folders.append(subfolder_result)
            print(f"[SUCCESS] Created: {folder_info['name']}")
        
        # Create initial project documents
        print("[DOCUMENT] Creating project README...")
        readme_content = """# New Project 2024

## Project Overview
This is the main project folder for our 2024 initiative.

## Folder Structure
- Documents/: Project documentation
- Resources/: Reference materials  
- Meeting Notes/: Meeting recordings and notes
- Deliverables/: Final project outputs

## Getting Started
1. Review project charter in Documents/
2. Check meeting notes for latest updates
3. Add your work to appropriate folders
"""
        
        readme_result = create_document_highlevel(
            core_client=core_client,
            name="README.md",
            parent_id=project_id,
            title="Project README"
        )
        print(f"[SUCCESS] README created: {readme_result}")
        
    except Exception as e:
        print(f"[ERROR] Workspace organization failed: {e}")


if __name__ == "__main__":
    print(">>> High-Level Basic Operations Examples")
    print("=" * 55)
    
    print("\n[FOLDER] Folder Management:")
    folder_operations_example()
    
    print("\n[DOCUMENT] Document Creation:")
    document_creation_example()
    
    print("\n[BROWSE] Browsing & Information:")
    browsing_operations_example()
    
    print("\n[DELETE] Deletion Operations:")
    deletion_operations_example()
    
    print("\n[WORKSPACE] Workspace Organization:")
    workspace_organization_example()
    
    print("\n[BENEFITS] Key Benefits:")
    print("- One-line operations for complex tasks")
    print("- Built-in error handling and validation")
    print("- Type safety with Pydantic models")
    print("- Consistent return formats")
    print("- 86% code reduction vs raw API calls")
    
    print("\n[SUMMARY] Common Operations Summary:")
    print("- create_folder_highlevel(): Create folders with metadata")
    print("- create_document_highlevel(): Create text documents")
    print("- list_children_highlevel(): Browse folder contents")
    print("- delete_node_highlevel(): Delete with trash/permanent options")
    print("- bulk_delete_nodes_highlevel(): Delete multiple items")