ezgo 0.0.8__tar.gz → 0.0.10__tar.gz

{ezgo-0.0.8 → ezgo-0.0.10}/PKG-INFO

@@ -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)
 **改进**:
 - 🔧 移除自动依赖检查逻辑，避免导入时的警告提示