#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Function Description: Switch to specified Zephyr version (SHA or tag) and run west update
功能描述: 切换到指定的Zephyr版本（SHA号或tag）并运行west update
"""
from typing import Dict, Any
import os
from src.utils.common_tools import check_tools
from src.utils.internal_helpers import _switch_zephyr_version_internal
def switch_zephyr_version(project_dir: str, ref: str) -> Dict[str, Any]:
"""
Function Description: Switch to specified Zephyr version (SHA or tag) and run west update
功能描述: 切换到指定的Zephyr版本（SHA号或tag）并运行west update
Parameters:
参数说明:
- project_dir (str): Required. Zephyr project directory
- project_dir (str): 必须。Zephyr项目目录
- ref (str): Required. Git reference (SHA, tag or branch name)
- ref (str): 必须。Git引用（SHA号、tag或分支名称）
Returns:
返回值:
- Dict[str, Any]: Contains status, log and error information
- Dict[str, Any]: 包含状态、日志和错误信息
Exception Handling:
异常处理:
- Tool detection failure or command execution exception will be reflected in the returned error information
- 工具检测失败或命令执行异常会体现在返回的错误信息中
"""
# Check if tools are installed
# 检查工具是否安装
tools_status = check_tools(["git", "west"])
if not tools_status.get("git", False):
return {"status": "error", "log": "", "error": "git工具未安装"}
if not tools_status.get("west", False):
return {"status": "error", "log": "", "error": "west工具未安装"}
# Check if project directory exists
# 检查项目目录是否存在
if not os.path.exists(project_dir):
return {"status": "error", "log": "", "error": f"项目目录不存在: {project_dir}"}
# Call internal function to switch version
# 调用内部函数执行版本切换
return _switch_zephyr_version_internal(project_dir, ref)
