xgo-blockly 1.0.0__tar.gz

xgo_blockly-1.0.0/MANIFEST.in

@@ -0,0 +1,35 @@
+# 包含项目说明文件
+include README.md
+include requirements.txt
+include pyproject.toml
+
+# 包含许可证文件（如果存在）
+include LICENSE*
+include COPYING*
+
+# 包含前端构建资源
+recursive-include xgo_blockly/dist *
+recursive-include xgo_blockly/dist/assets *
+
+# 包含Python包的所有子包
+recursive-include xgo_blockly *.py
+recursive-include xgo_blockly *.txt
+recursive-include xgo_blockly *.md
+recursive-include xgo_blockly *.json
+recursive-include xgo_blockly *.yaml
+recursive-include xgo_blockly *.yml
+
+# 排除不需要的文件
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+global-exclude *.so
+global-exclude .DS_Store
+global-exclude Thumbs.db
+global-exclude *.log
+global-exclude .git*
+global-exclude .pytest_cache
+global-exclude *.egg-info
+global-exclude build
+global-exclude dist

xgo_blockly-1.0.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: xgo-blockly
+Version: 1.0.0
+Summary: XGO Blockly - 图形化编程Web服务器
+Home-page: https://github.com/xgo-robotics/xgo-blockly
+Author: XGO Team
+Author-email: XGO Team <support@xgo.com>
+License: MIT
+Project-URL: Homepage, https://github.com/xgo-robotics/xgo-blockly
+Project-URL: Bug Reports, https://github.com/xgo-robotics/xgo-blockly/issues
+Project-URL: Source, https://github.com/xgo-robotics/xgo-blockly
+Project-URL: Documentation, https://docs.xgo.com/
+Keywords: xgo,robot,blockly,programming,education
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: Flask
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: flask>=2.3.0
+Requires-Dist: flask-cors>=4.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: xgo-pythonlib
+Requires-Dist: agentscope
+Requires-Dist: mem0ai
+Requires-Dist: pyserial
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# 项目重构说明
+
+## 重构概述
+
+原来的 `app.py` 文件包含了所有的路由、业务逻辑和配置，不符合标准的Flask项目架构规范。现在已经将代码重构为更规范的项目结构，采用模块化设计和工厂模式。
+
+## 新的项目结构
+
+```
+xgo-blockly-server/
+├── app.py                 # 主应用文件（工厂模式）
+├── config.py              # 配置管理
+├── requirements.txt       # Python依赖
+├── services/              # 业务逻辑层
+│   ├── __init__.py
+│   └── code_executor.py   # 代码执行服务
+├── routes/                # 路由处理层
+│   ├── __init__.py
+│   ├── api.py            # API路由
+│   └── static.py         # 静态文件路由
+└── dist/                 # Vue3构建产物
+```
+
+## 模块说明
+
+### 1. `config.py` - 配置管理
+- 统一管理所有配置项
+- 支持不同环境配置（开发/生产/测试）
+- MIME类型配置管理
+
+### 2. `services/code_executor.py` - 业务逻辑层
+- `CodeExecutor` 类：负责Python代码执行
+- `ExecutionManager` 类：管理多个执行任务
+- 日志管理和任务调度
+
+### 3. `routes/api.py` - API路由处理
+- `/api/run-code` - Python代码执行接口
+- `/api/health` - 健康检查接口
+- 使用Flask Blueprint进行模块化管理
+
+### 4. `routes/static.py` - 静态文件路由
+- Vue3应用托管
+- 静态资源服务
+- MIME类型处理
+
+### 5. `app.py` - 应用工厂
+- 采用工厂模式创建Flask应用
+- 蓝图注册
+- 全局错误处理
+
+## 重构优势
+
+### 1. **代码组织更清晰**
+- 按功能模块分离代码
+- 单一职责原则
+- 便于维护和扩展
+
+### 2. **更好的可测试性**
+- 业务逻辑与路由分离
+- 依赖注入更容易
+- 单元测试更方便
+
+### 3. **配置管理标准化**
+- 环境配置分离
+- 配置项集中管理
+- 支持多环境部署
+
+### 4. **扩展性更强**
+- 新增功能只需添加新的蓝图
+- 业务逻辑模块化
+- 支持插件式架构
+
+## 兼容性保证
+
+**重要：所有原有的接口和功能保持不变**
+
+- ✅ `/api/run-code` - Python代码执行（SSE响应）
+- ✅ `/api/health` - 健康检查
+- ✅ `/` - Vue3应用主页
+- ✅ `/<path>` - 静态资源文件
+- ✅ 404错误处理（Vue路由支持）
+- ✅ CORS跨域支持
+- ✅ MIME类型配置
+
+## 启动方式
+
+启动方式完全保持不变：
+
+```bash
+cd xgo-blockly-server
+python app.py
+```
+
+## 后续开发建议
+
+1. **新增API接口**：在 `routes/` 目录下创建新的路由文件
+2. **新增业务逻辑**：在 `services/` 目录下创建新的服务类
+3. **配置修改**：统一在 `config.py` 中管理
+4. **测试开发**：为每个模块编写单独的单元测试
+
+这样的架构更符合Flask最佳实践，便于团队开发和项目维护。

xgo_blockly-1.0.0/README.md

@@ -0,0 +1,101 @@
+# 项目重构说明
+
+## 重构概述
+
+原来的 `app.py` 文件包含了所有的路由、业务逻辑和配置，不符合标准的Flask项目架构规范。现在已经将代码重构为更规范的项目结构，采用模块化设计和工厂模式。
+
+## 新的项目结构
+
+```
+xgo-blockly-server/
+├── app.py                 # 主应用文件（工厂模式）
+├── config.py              # 配置管理
+├── requirements.txt       # Python依赖
+├── services/              # 业务逻辑层
+│   ├── __init__.py
+│   └── code_executor.py   # 代码执行服务
+├── routes/                # 路由处理层
+│   ├── __init__.py
+│   ├── api.py            # API路由
+│   └── static.py         # 静态文件路由
+└── dist/                 # Vue3构建产物
+```
+
+## 模块说明
+
+### 1. `config.py` - 配置管理
+- 统一管理所有配置项
+- 支持不同环境配置（开发/生产/测试）
+- MIME类型配置管理
+
+### 2. `services/code_executor.py` - 业务逻辑层
+- `CodeExecutor` 类：负责Python代码执行
+- `ExecutionManager` 类：管理多个执行任务
+- 日志管理和任务调度
+
+### 3. `routes/api.py` - API路由处理
+- `/api/run-code` - Python代码执行接口
+- `/api/health` - 健康检查接口
+- 使用Flask Blueprint进行模块化管理
+
+### 4. `routes/static.py` - 静态文件路由
+- Vue3应用托管
+- 静态资源服务
+- MIME类型处理
+
+### 5. `app.py` - 应用工厂
+- 采用工厂模式创建Flask应用
+- 蓝图注册
+- 全局错误处理
+
+## 重构优势
+
+### 1. **代码组织更清晰**
+- 按功能模块分离代码
+- 单一职责原则
+- 便于维护和扩展
+
+### 2. **更好的可测试性**
+- 业务逻辑与路由分离
+- 依赖注入更容易
+- 单元测试更方便
+
+### 3. **配置管理标准化**
+- 环境配置分离
+- 配置项集中管理
+- 支持多环境部署
+
+### 4. **扩展性更强**
+- 新增功能只需添加新的蓝图
+- 业务逻辑模块化
+- 支持插件式架构
+
+## 兼容性保证
+
+**重要：所有原有的接口和功能保持不变**
+
+- ✅ `/api/run-code` - Python代码执行（SSE响应）
+- ✅ `/api/health` - 健康检查
+- ✅ `/` - Vue3应用主页
+- ✅ `/<path>` - 静态资源文件
+- ✅ 404错误处理（Vue路由支持）
+- ✅ CORS跨域支持
+- ✅ MIME类型配置
+
+## 启动方式
+
+启动方式完全保持不变：
+
+```bash
+cd xgo-blockly-server
+python app.py
+```
+
+## 后续开发建议
+
+1. **新增API接口**：在 `routes/` 目录下创建新的路由文件
+2. **新增业务逻辑**：在 `services/` 目录下创建新的服务类
+3. **配置修改**：统一在 `config.py` 中管理
+4. **测试开发**：为每个模块编写单独的单元测试
+
+这样的架构更符合Flask最佳实践，便于团队开发和项目维护。

xgo_blockly-1.0.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=45", "wheel", "setuptools-scm[toml]>=6.2"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xgo-blockly"
+version = "1.0.0"
+description = "XGO Blockly - 图形化编程Web服务器"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+authors = [
+    {name = "XGO Team", email = "support@xgo.com"}
+]
+keywords = ["xgo", "robot", "blockly", "programming", "education"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Education",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Education",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Framework :: Flask",
+]
+dependencies = [
+    "flask>=2.3.0",
+    "flask-cors>=4.0.0",
+    "psutil>=5.9.0",
+    "xgo-pythonlib",
+    "agentscope",
+    "mem0ai",
+    "pyserial",
+]
+
+[project.urls]
+Homepage = "https://github.com/xgo-robotics/xgo-blockly"
+"Bug Reports" = "https://github.com/xgo-robotics/xgo-blockly/issues"
+"Source" = "https://github.com/xgo-robotics/xgo-blockly"
+"Documentation" = "https://docs.xgo.com/"
+
+[project.scripts]
+xgo-blockly = "xgo_blockly.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["xgo_blockly*"]
+
+[tool.setuptools.package-data]
+xgo_blockly = ["dist/**/*"]

xgo_blockly-1.0.0/requirements.txt

@@ -0,0 +1,6 @@
+flask>=2.3.0
+flask-cors>=4.0.0
+psutil>=5.9.0
+xgo-pythonlib
+agentscope
+mem0ai

xgo_blockly-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xgo_blockly-1.0.0/setup.py

@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+from setuptools import setup, find_packages
+import os
+
+# 读取README文件
+def read_readme():
+    with open("README.md", "r", encoding="utf-8") as fh:
+        return fh.read()
+
+# 读取requirements文件
+def read_requirements():
+    with open("requirements.txt", "r", encoding="utf-8") as fh:
+        return [line.strip() for line in fh if line.strip() and not line.startswith("#")]
+
+setup(
+    name="xgo-blockly",
+    version="1.0.0",
+    author="XGO Team",
+    author_email="support@xgo.com",
+    description="XGO Blockly - 图形化编程Web服务器",
+    long_description=read_readme(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/xgo-robotics/xgo-blockly",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Education",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Topic :: Education",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Framework :: Flask",
+    ],
+    python_requires=">=3.7",
+    install_requires=read_requirements(),
+    entry_points={
+        "console_scripts": [
+            "xgo-blockly=xgo_blockly.cli:main",
+        ],
+    },
+    package_data={
+        "xgo_blockly": [
+            "dist/**/*",
+            "dist/*",
+            "dist/assets/*",
+        ],
+    },
+    include_package_data=True,
+    zip_safe=False,
+    keywords="xgo robot blockly programming education",
+    project_urls={
+        "Bug Reports": "https://github.com/xgo-robotics/xgo-blockly/issues",
+        "Source": "https://github.com/xgo-robotics/xgo-blockly",
+        "Documentation": "https://docs.xgo.com/",
+    },
+)

xgo_blockly-1.0.0/xgo_blockly/__init__.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+XGO Blockly Package
+一个提供XGO机器人图形化编程的Web服务器包
+"""
+
+__version__ = "1.0.0"
+__author__ = "XGO Team"
+__description__ = "XGO Blockly - 图形化编程Web服务器"
+
+from .app import create_app
+
+__all__ = ['create_app']

xgo_blockly-1.0.0/xgo_blockly/app.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+XGO Blockly Server
+Flask服务器，提供Python代码执行和Vue3静态文件托管功能
+"""
+
+import os
+from flask import Flask
+from flask_cors import CORS
+from .config import get_config
+from .routes.api import api_bp
+from .routes.static import static_bp
+
+
+def create_app(config_name=None):
+    """应用工厂函数"""
+    # 获取配置
+    config_class = get_config(config_name)
+    
+    # 创建Flask应用
+    config_instance = config_class()
+    app = Flask(__name__, 
+                static_folder=config_instance.STATIC_FOLDER, 
+                static_url_path=config_class.STATIC_URL_PATH)
+    
+    # 加载配置
+    app.config.from_object(config_class)
+    
+    # 初始化MIME类型
+    config_class.init_mime_types()
+    
+    # 初始化扩展
+    CORS(app)  # 允许跨域请求
+    
+    # 注册蓝图
+    app.register_blueprint(api_bp)
+    app.register_blueprint(static_bp)
+    
+    # 注册全局错误处理器
+    @app.errorhandler(404)
+    def not_found(error):
+        """404错误处理，返回index.html用于Vue路由"""
+        from flask import send_from_directory
+        return send_from_directory(app.static_folder, 'index.html')
+    
+    return app
+
+
+if __name__ == '__main__':
+    # 检查dist目录是否存在
+    dist_path = os.path.join(os.path.dirname(__file__), 'dist')
+    if not os.path.exists(dist_path):
+        print("警告: dist目录不存在，请先构建Vue3项目")
+        print("运行命令: cd ../blockly-vue3 && npm run build")
+        print("然后将dist目录复制到当前目录")
+    
+    # 获取配置
+    config_class = get_config()
+    
+    print("启动XGO Blockly Server...")
+    print("API接口:")
+    print("  - POST /api/run-code - 运行Python代码（SSE响应）")
+    print("  - GET /api/health - 健康检查")
+    print("XGO状态读取接口:")
+    print("  - GET /api/xgo/motor - 读取舵机角度")
+    print("  - GET /api/xgo/battery - 读取电池电量")
+    print("  - GET /api/xgo/roll - 读取Roll姿态角度")
+    print("  - GET /api/xgo/pitch - 读取Pitch姿态角度")
+    print("  - GET /api/xgo/yaw - 读取Yaw姿态角度")
+    print("  - GET /api/xgo/status - 读取所有状态信息")
+    print("  - POST /api/xgo/reconnect - 重新连接XGO")
+    print("静态文件托管:")
+    print("  - / - Vue3应用主页")
+    print("  - /<path> - 静态资源文件")
+    
+    # 创建应用实例
+    app = create_app()
+    
+    # 启动Flask应用
+    app.run(
+        host=config_class.HOST,
+        port=config_class.PORT,
+        debug=config_class.DEBUG,
+        threaded=config_class.THREADED
+    )

xgo_blockly-1.0.0/xgo_blockly/cli.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+XGO Blockly CLI
+命令行入口点，用于启动XGO Blockly服务器
+"""
+
+import os
+import sys
+import argparse
+from .app import create_app
+
+
+def main():
+    """主函数"""
+    parser = argparse.ArgumentParser(description='XGO Blockly Server')
+    parser.add_argument('--host', default='0.0.0.0', help='主机地址 (默认: 0.0.0.0)')
+    parser.add_argument('--port', type=int, default=8000, help='端口号 (默认: 8000)')
+    parser.add_argument('--debug', action='store_true', help='启用调试模式')
+    parser.add_argument('--config', choices=['development', 'production', 'testing'], 
+                       default='production', help='配置环境 (默认: production)')
+    
+    args = parser.parse_args()
+    
+    # 设置环境变量
+    os.environ['FLASK_ENV'] = args.config
+    
+    # 创建应用
+    app = create_app(args.config)
+    
+    print("启动XGO Blockly Server...")
+    print("API接口:")
+    print("  - POST /api/run-code - 运行Python代码（SSE响应）")
+    print("  - GET /api/health - 健康检查")
+    print("XGO状态读取接口:")
+    print("  - GET /api/xgo/motor - 读取舵机角度")
+    print("  - GET /api/xgo/battery - 读取电池电量")
+    print("  - GET /api/xgo/roll - 读取Roll姿态角度")
+    print("  - GET /api/xgo/pitch - 读取Pitch姿态角度")
+    print("  - GET /api/xgo/yaw - 读取Yaw姿态角度")
+    print("  - GET /api/xgo/status - 读取所有状态信息")
+    print("  - POST /api/xgo/reconnect - 重新连接XGO")
+    print("静态文件托管:")
+    print("  - / - Vue3应用主页")
+    print("  - /<path> - 静态资源文件")
+    print(f"服务器地址: http://{args.host}:{args.port}")
+    
+    try:
+        # 启动服务器
+        app.run(
+            host=args.host,
+            port=args.port,
+            debug=args.debug,
+            threaded=True
+        )
+    except KeyboardInterrupt:
+        print("\n服务器已停止")
+    except Exception as e:
+        print(f"启动服务器时出错: {e}")
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

xgo_blockly-1.0.0/xgo_blockly/config.py

@@ -0,0 +1,77 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+配置文件
+包含Flask应用的所有配置项
+"""
+
+import os
+import mimetypes
+
+
+class Config:
+    """基础配置类"""
+    # Flask基础配置
+    SECRET_KEY = 'xgo-blockly-secret-key'
+    MAX_CONTENT_LENGTH = 16 * 1024 * 1024  # 16MB max file size
+    
+    # 静态文件配置
+    @property
+    def STATIC_FOLDER(self):
+        """获取静态文件夹路径"""
+        # 直接使用相对路径
+        return os.path.join(os.path.dirname(__file__), 'dist')
+    
+    STATIC_URL_PATH = ''
+    
+    # 服务器配置
+    HOST = '0.0.0.0'
+    PORT = 8000
+    DEBUG = False
+    THREADED = True
+    
+    # MIME类型配置
+    MIME_TYPES = {
+        '.js': 'application/javascript',
+        '.css': 'text/css',
+        '.json': 'application/json',
+        '.svg': 'image/svg+xml'
+    }
+    
+    @staticmethod
+    def init_mime_types():
+        """初始化MIME类型"""
+        for ext, mime_type in Config.MIME_TYPES.items():
+            mimetypes.add_type(mime_type, ext)
+
+
+class DevelopmentConfig(Config):
+    """开发环境配置"""
+    DEBUG = True
+
+
+class ProductionConfig(Config):
+    """生产环境配置"""
+    DEBUG = False
+
+
+class TestingConfig(Config):
+    """测试环境配置"""
+    TESTING = True
+    DEBUG = True
+
+
+# 配置映射
+config = {
+    'development': DevelopmentConfig,
+    'production': ProductionConfig,
+    'testing': TestingConfig,
+    'default': DevelopmentConfig
+}
+
+
+def get_config(env=None):
+    """获取配置类"""
+    if env is None:
+        env = os.environ.get('FLASK_ENV', 'default')
+    return config.get(env, config['default'])