Function run_command

build.py:148–188

Execute command with comprehensive error handling

(cmd: str, cwd: Optional[str] = None, timeout: int = 300, 
                capture_output: bool = True, check: bool = True)

logger = BuildLogger()

def run_command(cmd: str, cwd: Optional[str] = None, timeout: int = 300, 
                capture_output: bool = True, check: bool = True) -> subprocess.CompletedProcess:
    """Execute command with comprehensive error handling"""
    logger.info(f"Executing: {cmd}")
    if cwd:
        logger.info(f"Working directory: {cwd}")
    
    try:
        result = subprocess.run(
            cmd, shell=True, cwd=cwd, capture_output=capture_output,
            text=True, timeout=timeout, encoding='utf-8', errors='replace'
        )
        
        if result.stdout and result.stdout.strip():
            clean_stdout = clean_text(result.stdout.strip())
            logger.info(f"Output: {clean_stdout}")

        if result.stderr and result.stderr.strip():
            clean_stderr = clean_text(result.stderr.strip())
            logger.warning(f"Stderr: {clean_stderr}")
        
        if check and result.returncode != 0:
            error_msg = f"Command failed (code {result.returncode}): {cmd}"
            if result.stderr:
                error_msg += f"\nError: {result.stderr}"
            raise BuildError(error_msg)
        
        logger.success(f"Command completed (code: {result.returncode})")
        return result
        
    except subprocess.TimeoutExpired as e:
        error_msg = f"Command timed out after {timeout}s: {cmd}"
        logger.error(error_msg)
        raise BuildError(error_msg) from e
    
    except Exception as e:
        error_msg = f"Command execution failed: {cmd} - {str(e)}"
        logger.error(error_msg)
        if check:
            raise BuildError(error_msg) from e
        return subprocess.CompletedProcess(cmd, 1, "", str(e))

class BuildEnvironment:
    """Build environment management and validation"""