Class CompositeCommand

src/commands/command_base.py:110–213

Command that groups multiple operations as a single undo unit. Useful for complex operations that involve multiple steps but should be undone/redone as a single logical operation.

class CompositeCommand(CommandBase):
    """
    Command that groups multiple operations as a single undo unit.
    
    Useful for complex operations that involve multiple steps but should
    be undone/redone as a single logical operation.
    """
    
    def __init__(self, description: str, commands: list['CommandBase']):
        """
        Initialize composite command.
        
        Args:
            description: Description of the composite operation
            commands: List of commands to execute as a group
        """
        super().__init__(description)
        self.commands = commands
        self.executed_commands = []
    
    def execute(self) -> bool:
        """Execute all commands, rolling back on failure."""
        print(f"\n=== COMPOSITE COMMAND EXECUTE START ===")
        print(f"DEBUG: Executing composite command with {len(self.commands)} commands")
        
        self.executed_commands = []
        
        for i, command in enumerate(self.commands):
            print(f"DEBUG: Executing command {i+1}/{len(self.commands)}: {command.get_description()}")
            result = command.execute()
            print(f"DEBUG: Command {i+1} returned: {result}")
            
            if result:
                command._mark_executed()
                self.executed_commands.append(command)
                print(f"DEBUG: Command {i+1} succeeded, added to executed list")
            else:
                print(f"DEBUG: Command {i+1} FAILED - rolling back {len(self.executed_commands)} executed commands")
                # Rollback executed commands on failure
                for j, executed in enumerate(reversed(self.executed_commands)):
                    print(f"DEBUG: Rolling back command {j+1}/{len(self.executed_commands)}: {executed.get_description()}")
                    rollback_result = executed.undo()
                    print(f"DEBUG: Rollback {j+1} returned: {rollback_result}")
                    executed._mark_undone()
                print(f"DEBUG: Rollback complete, composite command failed")
                print(f"=== COMPOSITE COMMAND EXECUTE END (FAILED) ===\n")
                return False
        
        self._mark_executed()
        print(f"DEBUG: All {len(self.commands)} commands succeeded")
        print(f"=== COMPOSITE COMMAND EXECUTE END (SUCCESS) ===\n")
        return True
    
    def undo(self) -> bool:
        """Undo all executed commands in reverse order."""
        if not self._executed:
            print(f"DEBUG: CompositeCommand.undo() - not executed, cannot undo")
            return False