ezgo 0.0.7__py3-none-any.whl → 0.0.9__py3-none-any.whl

ezgo/__init__.py

@@ -8,28 +8,37 @@ ezgo - 宇树Go2机器狗Python控制库
 支持运动控制、视频流获取、UI界面等功能。
 """
 
-__version__ = "0.0.7"
+__version__ = "0.0.9"
 __author__ = "ezgo"
 __email__ = ""
 __license__ = "MIT"
 
-# 导入主要类
+# 懒加载模块 - 只在实际使用时才导入
+def _lazy_import(module_name, class_name):
+    """懒加载模块，避免导入时的依赖检查"""
+    def _import():
+        try:
+            module = __import__(f'.{module_name}', package=__name__, fromlist=[class_name])
+            return getattr(module, class_name)
+        except ImportError as e:
+            # 只在使用时才提示依赖缺失
+            raise ImportError(f"使用 {class_name} 需要安装额外依赖: {e}")
+    return _import
+
+# 定义懒加载函数
+_Go2 = _lazy_import('go2', 'Go2')
+_Camera = _lazy_import('camera', 'Camera')
+_APP = _lazy_import('ui', 'APP')
+_Go2Camera = _lazy_import('go2_camera', 'Go2Camera')
+_Go2VUI = _lazy_import('go2_vui', 'Go2VUI')
+
+# 直接导入不需要额外依赖的模块
 try:
-    from .go2 import Go2
-    from .camera import Camera
-    from .ui import APP
-    from .go2_camera import Go2Camera
-    from .go2_vui import Go2VUI
     from .eztk import EasyTk
     from .ezcamera import Camera as EzCamera
 except ImportError as e:
-    print(f"警告: 无法导入部分模块: {e}")
-    print("请确保已安装所有依赖包")
-    Go2 = None
-    Camera = None
-    APP = None
-    Go2Camera = None
-    Go2VUI = None
+    # 这些模块应该能正常导入，如果失败则显示错误
+    print(f"错误: 无法导入核心模块: {e}")
     EasyTk = None
     EzCamera = None
 
@@ -45,49 +54,26 @@ __all__ = [
     "__version__"
 ]
 
-# 依赖检查和提示
-def _check_dependencies():
-    """检查关键依赖是否安装，并给出安装提示"""
-    missing_deps = []
-    
-    try:
-        import cv2
-    except ImportError:
-        missing_deps.append("opencv-python")
-    
-    try:
-        import numpy
-    except ImportError:
-        missing_deps.append("numpy")
+# 懒加载属性访问器
+class _LazyModule:
+    def __init__(self, import_func):
+        self._import_func = import_func
+        self._module = None
     
-    try:
-        from PIL import Image
-    except ImportError:
-        missing_deps.append("Pillow")
+    def __call__(self, *args, **kwargs):
+        if self._module is None:
+            self._module = self._import_func()
+        return self._module(*args, **kwargs)
     
-    try:
-        import netifaces
-    except ImportError:
-        missing_deps.append("netifaces")
-    
-    try:
-        import unitree_sdk2py
-    except ImportError:
-        missing_deps.append("unitree-sdk2py")
-    
-    if missing_deps:
-        print("=" * 60)
-        print("警告: ezgo 缺少以下依赖包:")
-        for dep in missing_deps:
-            print(f"  - {dep}")
-        print()
-        print("请安装缺少的依赖包:")
-        print("  pip install opencv-python numpy Pillow netifaces")
-        print("  # unitree-sdk2py 需要从官方源安装")
-        print("=" * 60)
-        return False
-    
-    return True
+    def __getattr__(self, name):
+        if self._module is None:
+            self._module = self._import_func()
+        return getattr(self._module, name)
+
+# 创建懒加载对象
+Go2 = _LazyModule(_Go2)
+Camera = _LazyModule(_Camera)
+APP = _LazyModule(_APP)
+Go2Camera = _LazyModule(_Go2Camera)
+Go2VUI = _LazyModule(_Go2VUI)
 
-# 在导入时进行依赖检查
-_check_dependencies()

{ezgo-0.0.7.dist-info → ezgo-0.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ezgo
-Version: 0.0.7
+Version: 0.0.9
 Summary: 宇树Go2机器狗Python控制库
 Author-email: ezgo <noreply@example.com>
 License: MIT
@@ -49,8 +49,6 @@ Requires-Dist: unitree-sdk2py; extra == "full"
 - 📷 **摄像头控制**: 支持图片获取和视频流处理
 - 🔊 **声光控制**: 支持LED灯光和音量控制
 - 🎮 **UI界面**: 提供图形化控制界面
-- 🖼️ **EasyTk界面**: 简化的tkinter界面封装，适合教学使用
-- 📹 **EzCamera摄像头**: 优化的摄像头控制，支持多平台和硬件加速
 - 🔧 **易于使用**: 简洁的API设计，支持懒加载
 - 📦 **可选依赖**: 核心功能轻量，按需安装依赖
 
@@ -214,64 +212,6 @@ if robot.init():
     robot.AutoRecoverSet(False)
 ```
 
-### EasyTk 简化界面开发
-
-```python
-import ezgo
-
-# 创建EasyTk窗口（自动适配灵芯派480x800分辨率）
-app = ezgo.EasyTk(title="机器狗控制", size="480x800")
-
-# 添加标签
-label = app.add_label(text="欢迎使用ezgo", font=("SimHei", 24))
-
-# 添加按钮
-def on_click():
-    print("按钮被点击了!")
-
-button = app.add_button(text="点击我", command=on_click)
-
-# 添加图片显示（支持文件路径、OpenCV图像、PIL图像）
-image_label = app.add_label(image="path/to/image.jpg")
-
-# 运行主循环
-app.root.mainloop()
-```
-
-### EzCamera 优化摄像头控制
-
-```python
-import ezgo
-import cv2
-
-# 创建摄像头对象（自动适配平台）
-camera = ezgo.EzCamera(index=0, width=640, height=480, fps=30)
-
-# 打开摄像头
-if camera.open():
-    print("摄像头打开成功!")
-    
-    # 读取最新帧
-    frame = camera.read()
-    if frame is not None:
-        # 保存图片
-        camera.save_image(frame, "capture.jpg")
-        
-        # 调整尺寸
-        resized = camera.resize(frame, (224, 224))
-        
-        # 裁剪为正方形
-        square = camera.crop_to_square(frame)
-        
-        # 显示图像
-        cv2.imshow("Camera", frame)
-        cv2.waitKey(0)
-        cv2.destroyAllWindows()
-    
-    # 关闭摄像头
-    camera.close()
-```
-
 ## API 参考
 
 ### Go2 类
@@ -367,47 +307,6 @@ if camera.open():
 - `set_volume(level)`: 设置音量 (0-10)
 - `get_volume()`: 获取当前音量
 
-### EasyTk 类
-
-简化的tkinter界面封装，专为教学和快速开发设计。
-
-#### 主要方法
-
-- `__init__(title="APP", size=None)`: 初始化窗口，自动适配灵芯派
-- `add_frame(master=None, **kwargs)`: 添加框架容器
-- `add_label(master=None, **kwargs)`: 添加标签，支持文本和图片
-- `add_button(master=None, **kwargs)`: 添加按钮
-- `config(widget, **kwargs)`: 配置组件属性
-
-#### 特性
-
-- **自动适配**: 在Linux系统下自动设置480x800分辨率和全屏模式
-- **简化布局**: 使用pack布局，简化界面开发
-- **图片支持**: 直接支持文件路径、OpenCV图像、PIL图像
-- **教学友好**: 适合学生快速上手GUI开发
-
-### EzCamera 类
-
-优化的摄像头控制类，支持多平台和硬件加速。
-
-#### 主要方法
-
-- `__init__(index=0, width=640, height=480, fps=30)`: 初始化摄像头
-- `open(timeout=5)`: 打开摄像头，支持硬件加速
-- `read()`: 读取最新帧（非阻塞）
-- `save_image(frame, filename="frame.jpg")`: 保存图像
-- `resize(frame, size=(224, 224))`: 调整图像尺寸
-- `crop_to_square(frame)`: 裁剪为正方形
-- `close()`: 关闭摄像头
-
-#### 特性
-
-- **多平台支持**: Linux(V4L2)、Windows(DSHOW)、macOS自动适配
-- **硬件加速**: 支持MJPG格式和缓冲区优化
-- **双缓冲**: 使用双缓冲机制避免图像撕裂
-- **线程安全**: 独立读取线程，主线程非阻塞
-- **帧率控制**: 精确的帧率控制，避免累积误差
-
 ## 依赖要求
 
 ### 核心依赖
@@ -460,24 +359,27 @@ pip install opencv-python numpy Pillow netifaces
 
 ## 更新日志
 
-### v0.0.7 (2025-12-09)
-**新增功能**:
-- ✨ 新增EasyTk简化界面封装类，专为教学设计
-- ✨ 新增EzCamera优化摄像头控制类，支持多平台硬件加速
-- ✨ EasyTk自动适配灵芯派480x800分辨率和全屏模式
-- ✨ EzCamera支持双缓冲机制和线程安全读取
-- ✨ 完善图片处理功能：调整尺寸、裁剪正方形、保存图像
+### v0.0.9 (2025-12-09)
+**改进**:
+- 🔧 实现懒加载机制，避免导入时的依赖检查
+- 🔧 只在实际使用Go2相关功能时才检查依赖
+- 🔧 eztk和ezcamera模块可直接使用，无任何依赖警告
+- 🔧 优化模块导入结构，提升用户体验
+
+**修复**:
+- 🐛 修复导入ezgo时提示netifaces等依赖缺失的问题
+- 🐛 修复使用eztk/ezcamera时的不必要警告
+- 🐛 实现真正的按需依赖检查机制
 
+### v0.0.8 (2025-12-09)
 **改进**:
-- 🔧 优化模块导入结构，新增EasyTk和EzCamera到公开API
-- 🔧 增强平台兼容性，自动检测并适配不同操作系统
-- 🔧 完善文档，添加详细的使用示例和API说明
-- 🔧 改进错误处理，提供更友好的错误提示
-
-**特性**:
-- 🖼️ EasyTk支持直接显示文件路径、OpenCV图像、PIL图像
-- 📹 EzCamera支持MJPG硬件加速和V4L2优化
-- 🎯 教学友好，简化GUI开发和摄像头操作流程
+- 🔧 移除自动依赖检查逻辑，避免导入时的警告提示
+- 🔧 用户按需使用功能，不再强制检查所有依赖
+- 🔧 提升用户体验，减少不必要的警告信息
+
+**修复**:
+- 🐛 修复使用eztk时频繁提示unitree-sdk2py依赖的问题
+- 🐛 修复导入库时自动检查所有模块依赖的逻辑
 
 ### v0.0.5 (2025-12-04)
 **新增功能**:

{ezgo-0.0.7.dist-info → ezgo-0.0.9.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ezgo/__init__.py,sha256=oRflrSHwO_CTnNJ2ZvhNmW-ezZP1hh9RtJWOx7bkjIo,2120
+ezgo/__init__.py,sha256=jMO1jw9Xu2RG-6b1d3ce3yyL_bAF06JP3bct7knaJ9Y,2190
 ezgo/camera.py,sha256=Vsr44vFtaop4LE0DlWyOHyvxF-jHnVO8iMPUwp5mbsE,2538
 ezgo/ezcamera.py,sha256=6-3y-1X_L60QsWdsd5-caLoj7Quy9rpyHdp3Tq3JFbU,6536
 ezgo/eztk.py,sha256=MHWkkZYIL1AFjUXFu2Qq8U9idJV_E1VxFUBe82dvbyA,10463
@@ -6,8 +6,8 @@ ezgo/go2.py,sha256=lSZwpYRAljcV4bAalkZXvs9X-qMaEGcuaHSNegGcX6M,31610
 ezgo/go2_camera.py,sha256=nawUSLyvqTNiVRQ2sM-UdoJzqwZcySltLbCfUb0G9Qc,8614
 ezgo/go2_vui.py,sha256=52I4Y8uqGkW9muDEnDzQ236HqVVTIgNIN_2gW5RTC48,10161
 ezgo/ui.py,sha256=jUik6maaoemI2vsBM92OLZfJfskg54W7hwMls_gxppg,2777
-ezgo-0.0.7.dist-info/LICENSE,sha256=Zk4eZBT3KaBhqM3LB_xN7QquwnoWsEHAoA6eLdE6W5M,1060
-ezgo-0.0.7.dist-info/METADATA,sha256=dshHGchZ_YsggtBJPzcXzDNKaIgJysgOWMlizX7Hr_4,16626
-ezgo-0.0.7.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
-ezgo-0.0.7.dist-info/top_level.txt,sha256=BdCFEVD5V_4FxUtvH0BVlZKgxYnp7EKNsYs5OyFxj-g,5
-ezgo-0.0.7.dist-info/RECORD,,
+ezgo-0.0.9.dist-info/LICENSE,sha256=Zk4eZBT3KaBhqM3LB_xN7QquwnoWsEHAoA6eLdE6W5M,1060
+ezgo-0.0.9.dist-info/METADATA,sha256=ajPhXH35KqRk1Fr_sler7ZkTWFnafwhn5DmCTwluvPU,13559
+ezgo-0.0.9.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+ezgo-0.0.9.dist-info/top_level.txt,sha256=BdCFEVD5V_4FxUtvH0BVlZKgxYnp7EKNsYs5OyFxj-g,5
+ezgo-0.0.9.dist-info/RECORD,,