From 955cd0cf169224d3b0da3dd534879b2bc03ce278 Mon Sep 17 00:00:00 2001 From: wangqiang Date: Tue, 3 Jun 2025 10:31:07 +0800 Subject: [PATCH] Docs: Update code comments for Jailhouse configuration UI component. This commit updates code comments in the JailhouseWidget UI component, including module-level documentation for the Jailhouse configuration management interface, class-level comments describing component functionalities such as cell configuration, memory/CPU allocation, and device management, method comments for initialization and resource setup, logging setup documentation, and descriptions of features like system state monitoring and real-time statistics display. Signed-off-by: wangqiang --- jailhouse_widget.py | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/jailhouse_widget.py b/jailhouse_widget.py index a100b2f..b77d16e 100755 --- a/jailhouse_widget.py +++ b/jailhouse_widget.py @@ -1,3 +1,17 @@ +""" +Jailhouse配置管理界面模块。 + +本模块提供了用于显示和管理Jailhouse虚拟化管理程序配置的图形界面组件，包括： +- Jailhouse系统状态监控 +- Cell配置管理 +- 内存和CPU分配管理 +- 设备分配和PCI直通配置 +- 实时统计信息显示 + +主要类: +- JailhouseWidget: Jailhouse配置管理界面主组件 +""" + import logging from PySide2 import QtWidgets from forms.ui_jailhouse_widget import Ui_JailhouseWidget @@ -5,13 +19,42 @@ from jh_resource import ResourceJailhouse, ResourceMgr class JailhouseWidget(QtWidgets.QWidget): + """ + Jailhouse配置管理界面主组件。 + + 提供完整的Jailhouse虚拟化管理程序配置界面，包括： + - Jailhouse系统信息和状态显示 + - Cell配置列表和编辑功能 + - 内存分配和CPU亲和性设置 + - 设备分配和PCI直通配置 + - 统计信息和性能监控 + + 属性: + logger: 类级别的日志记录器 + """ logger = logging.getLogger("JailhouseWidget") def __init__(self, parent=None): + """ + 初始化Jailhouse配置管理界面。 + + 设置UI并初始化组件。 + + Args: + parent: 父窗口部件，默认为None + """ super().__init__(parent) self._ui = Ui_JailhouseWidget() self._ui.setupUi(self) def set_jailhosue(self, rsc: ResourceJailhouse): + """ + 设置并显示指定的Jailhouse资源配置。 + + 根据提供的Jailhouse资源对象更新界面显示内容。 + + Args: + rsc: 要显示的Jailhouse资源对象 + """ pass -- Gitee