ezgo 0.0.8__py3-none-any.whl → 0.0.10__py3-none-any.whl

ezgo/__init__.py

@@ -8,26 +8,41 @@ ezgo - 宇树Go2机器狗Python控制库
 支持运动控制、视频流获取、UI界面等功能。
 """
 
-__version__ = "0.0.8"
+__version__ = "0.0.10"
 __author__ = "ezgo"
 __email__ = ""
 __license__ = "MIT"
 
-# 导入主要类
+# 懒加载模块 - 只在实际使用时才导入
+def _lazy_import(module_name, class_name):
+    """懒加载模块，避免导入时的依赖检查"""
+    def _import():
+        try:
+            # 使用importlib代替__import__，更可靠
+            import importlib
+            module = importlib.import_module(f'.{module_name}', package=__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
 
 # 定义公开的API
 __all__ = [
@@ -36,6 +51,31 @@ __all__ = [
     "APP",
     "Go2Camera",
     "Go2VUI",
+    "EasyTk",
+    "EzCamera",
     "__version__"
 ]
 
+# 懒加载属性访问器
+class _LazyModule:
+    def __init__(self, import_func):
+        self._import_func = import_func
+        self._module = None
+    
+    def __call__(self, *args, **kwargs):
+        if self._module is None:
+            self._module = self._import_func()
+        return self._module(*args, **kwargs)
+    
+    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)
+

{ezgo-0.0.8.dist-info → ezgo-0.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ezgo
-Version: 0.0.8
+Version: 0.0.10
 Summary: 宇树Go2机器狗Python控制库
 Author-email: ezgo <noreply@example.com>
 License: MIT
@@ -83,7 +83,7 @@ pip install ezgo[basic]
 ```python
 import ezgo
 
-# 创建Go2控制对象
+# 创建Go2控制对象（需要安装unitree-sdk2py）
 robot = ezgo.Go2()
 
 # 初始化连接
@@ -96,16 +96,16 @@ if robot.init():
     robot.StopMove()       # 停止移动
 ```
 
-### 摄像头控制
+### Go2摄像头控制
 
 ```python
 import ezgo
 
-# 方法1: 通过Go2对象获取摄像头
+# 方法1: 通过Go2对象获取摄像头（需要unitree-sdk2py）
 robot = ezgo.Go2()
 camera = robot.get_camera()
 
-# 方法2: 直接使用摄像头类
+# 方法2: 直接使用Go2摄像头类（需要unitree-sdk2py）
 camera = ezgo.Go2Camera()
 
 # 初始化摄像头
@@ -118,16 +118,16 @@ if camera.init():
         frame = camera.read_frame()
 ```
 
-### 声光控制
+### Go2声光控制
 
 ```python
 import ezgo
 
-# 方法1: 通过Go2对象获取VUI控制
+# 方法1: 通过Go2对象获取VUI控制（需要unitree-sdk2py）
 robot = ezgo.Go2()
 vui = robot.get_vui()
 
-# 方法2: 直接使用VUI类
+# 方法2: 直接使用VUI类（需要unitree-sdk2py）
 vui = ezgo.Go2VUI()
 
 # 初始化VUI
@@ -142,12 +142,70 @@ if vui.init():
     vui.set_volume(3)
 ```
 
+### 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()
+```
+
 ### 高级运动模式
 
 ```python
 import ezgo
 
-robot = ezgo.Go2()
+robot = ezgo.Go2()  # 需要unitree-sdk2py
 if robot.init():
     # 步态模式切换
     robot.FreeWalk(True)        # 开启灵动模式
@@ -173,7 +231,7 @@ if robot.init():
 ```python
 import ezgo
 
-robot = ezgo.Go2()
+robot = ezgo.Go2()  # 需要unitree-sdk2py
 if robot.init():
     # 表演动作
     robot.Hello()               # 打招呼
@@ -197,7 +255,7 @@ if robot.init():
 ```python
 import ezgo
 
-robot = ezgo.Go2()
+robot = ezgo.Go2()  # 需要unitree-sdk2py
 if robot.init():
     # 设置自动翻身
     success = robot.AutoRecoverSet(True)
@@ -359,6 +417,29 @@ pip install opencv-python numpy Pillow netifaces
 
 ## 更新日志
 
+### v0.0.10 (2025-12-09)
+**修复**:
+- 🐛 修复懒加载模块导入错误，解决TypeError问题
+- 🐛 修复使用importlib替代__import__，提高兼容性
+- 🐛 修复Go2相关模块无法正确实例化的问题
+
+**改进**:
+- 🔧 更新README中的使用示例，明确标注依赖要求
+- 🔧 为每个工具类添加独立的使用示例
+- 🔧 优化文档结构，区分Go2相关和独立功能
+
+### v0.0.9 (2025-12-09)
+**改进**:
+- 🔧 实现懒加载机制，避免导入时的依赖检查
+- 🔧 只在实际使用Go2相关功能时才检查依赖
+- 🔧 eztk和ezcamera模块可直接使用，无任何依赖警告
+- 🔧 优化模块导入结构，提升用户体验
+
+**修复**:
+- 🐛 修复导入ezgo时提示netifaces等依赖缺失的问题
+- 🐛 修复使用eztk/ezcamera时的不必要警告
+- 🐛 实现真正的按需依赖检查机制
+
 ### v0.0.8 (2025-12-09)
 **改进**:
 - 🔧 移除自动依赖检查逻辑，避免导入时的警告提示

{ezgo-0.0.8.dist-info → ezgo-0.0.10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ezgo/__init__.py,sha256=SmjryJFLe9pyCHe62Kk0USHpz9V2e7Btn30k46Hd4kM,838
+ezgo/__init__.py,sha256=RJRxE28ZkbxrPqZY5siOikj6wLBXxbaTWVOSE8iNumI,2268
 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.8.dist-info/LICENSE,sha256=Zk4eZBT3KaBhqM3LB_xN7QquwnoWsEHAoA6eLdE6W5M,1060
-ezgo-0.0.8.dist-info/METADATA,sha256=ri12uqjYaCo_s3UEjukU6LDhBKKjtgAOhw1eURlTjlw,13088
-ezgo-0.0.8.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
-ezgo-0.0.8.dist-info/top_level.txt,sha256=BdCFEVD5V_4FxUtvH0BVlZKgxYnp7EKNsYs5OyFxj-g,5
-ezgo-0.0.8.dist-info/RECORD,,
+ezgo-0.0.10.dist-info/LICENSE,sha256=Zk4eZBT3KaBhqM3LB_xN7QquwnoWsEHAoA6eLdE6W5M,1060
+ezgo-0.0.10.dist-info/METADATA,sha256=9k7D5jZ5vCJ_Fbjgsic9jA97EAF7MBmSgg2UAtBbgiA,15565
+ezgo-0.0.10.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+ezgo-0.0.10.dist-info/top_level.txt,sha256=BdCFEVD5V_4FxUtvH0BVlZKgxYnp7EKNsYs5OyFxj-g,5
+ezgo-0.0.10.dist-info/RECORD,,