pancake-framework 0.1.0__py3-none-any.whl

pancake/__init__.py

@@ -0,0 +1,46 @@
+import sys
+import os
+
+disable_check = []
+
+current_dir = os.path.dirname(os.path.abspath(__file__))
+if current_dir not in sys.path:
+    sys.path.insert(0, current_dir)
+
+_initialized = False
+
+def init():
+    global _initialized
+    if _initialized:
+        return
+    _initialized = True
+
+    import initialize
+    initialize.print_ico()
+
+    init_rask = {"check_environment":initialize.check_environment, # 检查环境
+                 "check_struct":initialize.check_struct, # 检查项目结构完整性
+                }
+
+    # 检查运行环境
+    print("检查运行环境")
+    import tool
+    progress = tool.ProgressBar(len(init_rask), prefix="初始化环境")
+    for task in init_rask.keys():
+        if task in disable_check:
+            continue
+        init_rask[task]()
+        progress.update(1, f"{task} 完成")
+
+    progress.finish()
+
+    # 初始化 dotenv 和 logging
+    from resource import config  # noqa: F401
+    import resource.logging as resource_logging  # noqa: F401
+
+
+# 延迟导入，避免循环依赖
+def run():
+    init()
+    from .run import run as _run
+    _run()

pancake/builder/__init__.py

@@ -0,0 +1,11 @@
+import importlib
+import pkgutil
+
+# 当前包下的所有模块
+for _, module_name, _ in pkgutil.iter_modules(__path__):
+    module = importlib.import_module(f".{module_name}", __name__)
+
+    for attr_name in dir(module):
+        if not attr_name.startswith('_'):
+            attr = getattr(module, attr_name)
+            globals()[f"{module_name}.{attr_name}"] = attr

pancake/builder/build.py

@@ -0,0 +1,14 @@
+from pancake import oven
+
+
+def build():
+
+    # 构建所有服务实例
+    for classes in oven.pancake_dough["Service"]:
+        oven.pancake_pie["Service"][str(classes)] = oven.pancake_dough["Service"][classes].build()
+
+    for build_method_name in oven.muffin_egg["BuildOrder"]:
+        oven.muffin_egg["Builder"][build_method_name[0]]()
+
+
+

pancake/builder/load_dlc.py

@@ -0,0 +1,157 @@
+import sys
+
+from pancake import oven
+from pancake.initialize import check_dlc
+
+import importlib
+import inspect
+import logging
+import os
+
+logger = logging.getLogger(__name__)
+
+
+def _load_from_xml():
+    """从 XML 配置加载插件列表"""
+    plugins = oven.pancake_xml.get("plugins", [])
+    if not plugins:
+        return None  # 无 XML 配置，回退到目录扫描
+
+    main_classes = {}
+
+    for plugin_info in plugins:
+        name = plugin_info["name"]
+        source = plugin_info["source"]
+        enabled = plugin_info.get("enabled", True)
+        init_order = plugin_info.get("init_order", 0)
+        build_order = plugin_info.get("build_order", 0)
+
+        # 导入插件模块（无论是否启用都需要导入，以注册装饰器）
+        try:
+            plugin = importlib.import_module(source)
+        except ImportError as e:
+            if enabled:
+                logger.error(f"Failed to import plugin {name} ({source}): {e}")
+                sys.exit(1)
+            else:
+                logger.debug(f"Disabled plugin {name} not available: {e}")
+                continue
+
+        # 收集模块中的公开成员
+        all_items = {}
+        for attr_name, member in inspect.getmembers(plugin):
+            if (
+                (not attr_name.startswith("_"))
+                and (inspect.isclass(member) or inspect.isfunction(member))
+                and (member.__module__ == plugin.__name__ or member.__module__.startswith(plugin.__name__ + "."))
+            ):
+                all_items[attr_name] = member
+
+        # 注册装饰器（无论是否启用都注册）
+        for item_name, obj in all_items.items():
+            if item_name.startswith("_"):
+                continue
+            if inspect.isclass(obj) and hasattr(obj, 'build') and hasattr(obj, 'init_order'):
+                continue  # Main 类下面单独处理
+            oven.muffin_flour[item_name] = obj
+
+        # 注册 Main 类（仅启用时）
+        if enabled:
+            for item_name, obj in all_items.items():
+                if item_name.startswith("_"):
+                    continue
+                if inspect.isclass(obj) and hasattr(obj, 'build') and hasattr(obj, 'init_order'):
+                    effective_init = init_order
+                    effective_build = build_order
+
+                    oven.muffin_egg["BuildOrder"].append([name, effective_build])
+                    oven.muffin_egg["InitOrder"].append([name, effective_init])
+                    main_classes[name] = obj
+                    break
+            else:
+                logger.info(f"Plugin {name} loaded (no Main class)")
+        else:
+            logger.info(f"Plugin {name} disabled (decorators still loaded)")
+
+    return main_classes
+
+
+def _load_from_directory():
+    """从 ovenware 目录扫描加载插件（回退模式）"""
+    dlc_dir = os.path.join(os.path.dirname(__file__), "../", "ovenware")
+    entries = os.listdir(dlc_dir)
+    # 单文件插件
+    plugin_files = [f[:-3] for f in entries if f.endswith(".py") and f not in ["__init__.py"]]
+    # 子包插件（目录含 __init__.py）
+    plugin_dirs = [d for d in entries
+                   if os.path.isdir(os.path.join(dlc_dir, d))
+                   and os.path.exists(os.path.join(dlc_dir, d, "__init__.py"))
+                   and not d.startswith("_")]
+    plugin_names = plugin_files + plugin_dirs
+
+    main_classes = {}
+
+    for plugin_name in plugin_names:
+        if plugin_name in oven.pancake_yaml.get("framework.disable_dlc", []):
+            continue
+        plugin = importlib.import_module(f"ovenware.{plugin_name}")
+        all_items = {}
+        for name, member in inspect.getmembers(plugin):
+            if (
+                (not name.startswith("_"))
+                and (inspect.isclass(member) or inspect.isfunction(member))
+                and (member.__module__ == plugin.__name__ or member.__module__.startswith(plugin.__name__ + "."))
+            ):
+                all_items[name] = member
+
+        # 加载 all_items 中的所有 修饰器和 main 类
+        for decorator in all_items.keys():
+            if not decorator.startswith("_"):
+                obj = all_items[decorator]
+                if inspect.isclass(obj) and hasattr(obj, 'build') and hasattr(obj, 'init_order'):
+                    oven.muffin_egg["BuildOrder"].append([plugin_name, all_items[decorator].build_order])
+                    oven.muffin_egg["InitOrder"].append([plugin_name, all_items[decorator].init_order])
+                    main_classes[plugin_name] = all_items[decorator]
+                    continue
+                oven.muffin_flour[decorator] = all_items[decorator]
+
+    return main_classes
+
+
+def run():
+    """加载插件：优先 XML 配置，回退到目录扫描"""
+    has_xml = bool(oven.pancake_xml.get("plugins"))
+
+    if has_xml:
+        logger.info("Loading plugins from XML config")
+        main_classes = _load_from_xml()
+    else:
+        logger.info("No XML config, scanning ovenware directory")
+        main_classes = _load_from_directory()
+
+    oven.muffin_egg["BuildOrder"].sort(key=lambda x: x[1], reverse=True)
+    oven.muffin_egg["InitOrder"].sort(key=lambda x: x[1])
+
+    for plugin_name in oven.muffin_egg["InitOrder"]:
+        try:
+            check_dlc(main_classes[plugin_name[0]].check)
+        except AttributeError:
+            pass
+        except Exception as e:
+            logger.error(f"Plugin check failed for {plugin_name[0]}: {e}")
+            import sys
+            sys.exit(1)
+
+        new_main = main_classes[plugin_name[0]]()
+
+        oven.muffin_egg["Builder"][plugin_name[0]] = new_main.build
+
+        # 尝试获取 loop_method，verify_method
+        try:
+            oven.muffin_egg["LoopMethod"][plugin_name[0]] = new_main.loop_method
+        except AttributeError:
+            pass
+        try:
+            oven.muffin_egg["VerifyMethod"][plugin_name[0]] = new_main.verify
+        except AttributeError:
+            pass

pancake/builder/load_src.py

@@ -0,0 +1,114 @@
+import ast
+import builtins
+import os
+import sys
+from pancake import oven
+
+# 所有 src 文件共享的全局命名空间
+_shared_globals = {
+    "__builtins__": builtins,
+    "__name__": "__not_main__",
+}
+
+
+def scan_py_files(folder="."):
+    files = []
+    for root, _, filenames in os.walk(folder):
+        for f in filenames:
+            if f.endswith(".py") and f != os.path.basename(__file__):
+                files.append(os.path.abspath(os.path.join(root, f)))
+    return files
+
+def parse_file(filepath):
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            tree = ast.parse(f.read())
+    except (OSError, IOError, SyntaxError):
+        return []
+
+    dirname = os.path.dirname(filepath)
+    if dirname not in sys.path:
+        sys.path.insert(0, dirname)
+
+    results = []
+    for node in ast.walk(tree):
+        # 扫描 类 + 函数（含 async def）
+        if not isinstance(node, (ast.ClassDef, ast.FunctionDef, ast.AsyncFunctionDef)):
+            continue
+
+        obj_type = "class" if isinstance(node, ast.ClassDef) else "function"
+        obj_name = node.name
+
+        # 遍历所有装饰器
+        for dec in node.decorator_list:
+            dec_name = None
+            if isinstance(dec, ast.Name):
+                dec_name = dec.id
+            elif isinstance(dec, ast.Call) and hasattr(dec.func, 'id'):
+                dec_name = dec.func.id
+
+            # 匹配 muffin_flour 中的装饰器
+            if dec_name in oven.muffin_flour.keys():
+                results.append((dec_name, obj_type, obj_name, filepath))
+    return results
+
+def safe_register(filepath):
+    """在共享命名空间中执行文件，所有定义对其他文件可见"""
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            source = f.read()
+    except (OSError, IOError):
+        return
+
+    try:
+        tree = ast.parse(source)
+    except SyntaxError:
+        return
+
+    # 收集所有顶级定义
+    definitions = []
+    for node in tree.body:
+        if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef, ast.Import, ast.ImportFrom)):
+            definitions.append(node)
+
+    if not definitions:
+        return
+
+    new_tree = ast.Module(body=definitions, type_ignores=[])
+    ast.fix_missing_locations(new_tree)
+
+    try:
+        code = compile(new_tree, filepath, 'exec')
+        exec(code, _shared_globals)
+    except Exception:
+        import traceback
+        traceback.print_exc()
+        return
+
+    # 将文件中定义的名称注入 builtins，实现跨文件零 import
+    for node in definitions:
+        if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)):
+            if node.name in _shared_globals:
+                builtins.__dict__[node.name] = _shared_globals[node.name]
+
+def run():
+    from pancake.settings import get_path
+    src_dir = get_path("src_dir")
+    files = scan_py_files(src_dir)
+
+    # 预解析所有文件，按装饰器的 _load_priority 排序（值越小越先加载，默认 50）
+    file_items = []
+    for f in files:
+        items = parse_file(f)
+        if items:
+            min_priority = 50
+            for dec_name, _, _, _ in items:
+                dec_obj = oven.muffin_flour.get(dec_name)
+                if dec_obj and hasattr(dec_obj, '_load_priority'):
+                    min_priority = min(min_priority, dec_obj._load_priority)
+            file_items.append((min_priority, f, items))
+
+    file_items.sort(key=lambda x: x[0])
+
+    for _, path, _ in file_items:
+        safe_register(path)

pancake/cli.py

@@ -0,0 +1,212 @@
+"""
+Pancake CLI - 命令行工具
+支持 create / check / run / build 等子命令
+"""
+
+import argparse
+import os
+import sys
+import shutil
+import subprocess
+
+
+def cmd_create(args):
+    """创建新项目"""
+    name = args.name
+    project_dir = os.path.join(os.getcwd(), name)
+
+    if os.path.exists(project_dir):
+        print(f"错误: 目录 '{name}' 已存在")
+        sys.exit(1)
+
+    print(f"创建项目: {name}")
+
+    # 创建目录结构
+    dirs = [
+        os.path.join(project_dir, "src", "resource", "yaml"),
+        os.path.join(project_dir, "src", "resource", "json"),
+        os.path.join(project_dir, "src", "mapper"),
+        os.path.join(project_dir, "src", "controller"),
+    ]
+    for d in dirs:
+        os.makedirs(d)
+
+    # 创建 main.py
+    with open(os.path.join(project_dir, "main.py"), "w", encoding="utf-8") as f:
+        f.write('import pancake\n\npancake.run()\n')
+
+    # 创建 pancake.xml
+    with open(os.path.join(project_dir, "pancake.xml"), "w", encoding="utf-8") as f:
+        f.write('''<?xml version="1.0" encoding="UTF-8"?>
+<pancake>
+    <global>
+        <service.title>''' + name + '''</service.title>
+        <service.version>1.0.0</service.version>
+        <service.host>127.0.0.1</service.host>
+        <service.port>8080</service.port>
+    </global>
+    <plugins>
+        <plugin name="embed" init-order="0"/>
+        <plugin name="mybatis" init-order="1"/>
+        <plugin name="web" init-order="2"/>
+    </plugins>
+</pancake>
+''')
+
+    # 创建 service.yaml
+    with open(os.path.join(project_dir, "src", "resource", "yaml", "service.yaml"), "w", encoding="utf-8") as f:
+        f.write('''service:
+  title: ''' + name + '''
+  version: 1.0.0
+  host: 127.0.0.1
+  port: 8080
+''')
+
+    # 创建 pyproject.toml
+    with open(os.path.join(project_dir, "pyproject.toml"), "w", encoding="utf-8") as f:
+        f.write('''[tool.poetry]
+name = "''' + name + '''"
+version = "0.1.0"
+description = "A Pancake framework project"
+authors = ["Your Name <you@example.com>"]
+
+[tool.poetry.dependencies]
+python = "^3.13"
+pancake = "*"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+''')
+
+    print(f"项目 '{name}' 创建成功!")
+    print(f"  cd {name}")
+    print(f"  pip install pancake")
+    print(f"  python main.py")
+
+
+def cmd_check(args):
+    """检查项目结构和环境"""
+    print("检查项目结构...")
+
+    errors = []
+    warnings = []
+
+    # 检查 main.py
+    if not os.path.exists("main.py"):
+        errors.append("缺少 main.py")
+    else:
+        with open("main.py", "r", encoding="utf-8") as f:
+            content = f.read()
+            if "import pancake" not in content:
+                warnings.append("main.py 中未找到 'import pancake'")
+
+    # 检查 pancake.xml
+    if not os.path.exists("pancake.xml"):
+        warnings.append("缺少 pancake.xml（可选，用于插件配置）")
+
+    # 检查 src 目录
+    if not os.path.isdir("src"):
+        errors.append("缺少 src 目录")
+    else:
+        yaml_dir = os.path.join("src", "resource", "yaml")
+        if not os.path.isdir(yaml_dir):
+            warnings.append(f"缺少 {yaml_dir} 目录")
+        else:
+            yaml_files = [f for f in os.listdir(yaml_dir) if f.endswith(('.yaml', '.yml'))]
+            if not yaml_files:
+                warnings.append(f"{yaml_dir} 中没有 YAML 配置文件")
+
+    # 检查 pancake 是否安装
+    try:
+        import pancake  # noqa: F401
+        print("  [OK] pancake 已安装")
+    except ImportError:
+        errors.append("pancake 未安装，请运行: pip install pancake")
+
+    # 输出结果
+    if errors:
+        print("\n错误:")
+        for e in errors:
+            print(f"  [ERROR] {e}")
+
+    if warnings:
+        print("\n警告:")
+        for w in warnings:
+            print(f"  [WARN] {w}")
+
+    if not errors and not warnings:
+        print("  项目结构正常!")
+
+    return len(errors) == 0
+
+
+def cmd_run(args):
+    """运行项目"""
+    if not os.path.exists("main.py"):
+        print("错误: 当前目录没有 main.py，请在项目根目录运行")
+        sys.exit(1)
+
+    print("启动 Pancake 项目...")
+    import pancake
+    pancake.run()
+
+
+def cmd_build(args):
+    """打包项目为 wheel"""
+    if not os.path.exists("pyproject.toml"):
+        print("错误: 当前目录没有 pyproject.toml")
+        sys.exit(1)
+
+    print("打包项目...")
+    result = subprocess.run(
+        [sys.executable, "-m", "poetry", "build"],
+        capture_output=True, text=True
+    )
+    if result.returncode == 0:
+        print("打包成功!")
+        print(result.stdout)
+    else:
+        print("打包失败:")
+        print(result.stderr)
+        sys.exit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="pancake",
+        description="Pancake Framework - 命令行工具",
+    )
+    subparsers = parser.add_subparsers(dest="command", help="可用命令")
+
+    # create
+    create_parser = subparsers.add_parser("create", help="创建新项目")
+    create_parser.add_argument("name", help="项目名称")
+
+    # check
+    subparsers.add_parser("check", help="检查项目结构和环境")
+
+    # run
+    subparsers.add_parser("run", help="运行项目")
+
+    # build
+    subparsers.add_parser("build", help="打包项目为 wheel")
+
+    args = parser.parse_args()
+
+    if args.command is None:
+        parser.print_help()
+        sys.exit(0)
+
+    commands = {
+        "create": cmd_create,
+        "check": cmd_check,
+        "run": cmd_run,
+        "build": cmd_build,
+    }
+
+    commands[args.command](args)
+
+
+if __name__ == "__main__":
+    main()

pancake/initialize/__init__.py

@@ -0,0 +1,10 @@
+"""
+初始化环境
+- 检查环境
+- 初始化项目结构
+"""
+
+from .check_struct import check_struct
+from .check_env import check_environment
+from .print_ico import print_ico
+from .check_dlc import check_dlc

pancake/initialize/check_dlc.py

@@ -0,0 +1,10 @@
+import os
+import logging
+
+def check_dlc(check_method):
+    logger = logging.getLogger("check")
+    try:
+        check_method()
+    except ValueError as e:
+        logger.error(e)
+        raise e

pancake/initialize/check_env.py

@@ -0,0 +1,111 @@
+import subprocess
+import sys
+import os
+import platform
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+def check_poetry_installed() -> bool:
+    """检查 Poetry 是否已安装"""
+    try:
+        subprocess.run(
+            ["poetry", "--version"],
+            check=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True
+        )
+        return True
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return False
+
+
+def install_poetry():
+    """跨平台自动安装 Poetry"""
+    print("正在安装 Poetry...")
+    os_name = platform.system()
+
+    try:
+        if os_name == "Windows":
+            install_cmd = "(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -"
+            subprocess.run(["powershell", "-Command", install_cmd], check=True, shell=True)
+        else:
+            subprocess.run(["curl", "-sSL", "https://install.python-poetry.org"], check=True)
+        print("Poetry 安装成功！")
+    except subprocess.CalledProcessError:
+        try:
+            subprocess.run([sys.executable, "-m", "pip", "install", "poetry"], check=True)
+        except subprocess.CalledProcessError as e:
+            print(f"安装失败: {e}")
+            sys.exit(1)
+
+
+def setup_current_directory(dependencies: list):
+    """直接在当前目录初始化环境"""
+    current_dir = os.getcwd()
+    print(f"当前工作目录: {current_dir}")
+
+    # 1. 初始化 Poetry
+    print("正在初始化 Poetry...")
+    subprocess.run(["poetry", "init", "-n"],
+        capture_output=True,
+        text=True)
+
+    # 2. 配置虚拟环境在当前目录下 (.venv)
+    print("配置虚拟环境路径...")
+    subprocess.run(["poetry", "config", "virtualenvs.in-project", "true", "--local"], check=True)
+
+    # 3. 安装依赖
+    if dependencies:
+        print(f"正在安装依赖: {dependencies}")
+        subprocess.run(["poetry", "add"] + dependencies, capture_output=True, text=True)
+
+    print("\n环境配置完成！")
+    print(f"虚拟环境位置: {os.path.join(current_dir, '.venv')}")
+
+def find_module(module_names: list) -> bool:
+    """检查模块是否已安装"""
+    import importlib.util
+
+    for module_name in module_names:
+        spec = importlib.util.find_spec(module_name)
+
+        if spec is None:
+            return False
+    return True
+
+
+def check_environment():
+    """检查运行环境"""
+    REQUIRED_LIBRARIES = ["python-dotenv", "pyyaml"]
+    REQUIRED_MODULES = ["dotenv", "yaml"]
+    if not find_module(REQUIRED_MODULES):
+        # Check for non-interactive mode
+        if os.getenv("PANCAKE_AUTO_INSTALL", "").lower() in ("1", "true", "yes"):
+            auto_install = True
+        elif not sys.stdin.isatty():
+            logger.error("Missing required libraries and running in non-interactive mode. Set PANCAKE_AUTO_INSTALL=1 to auto-install.")
+            sys.exit(1)
+        else:
+            auto_install = input("缺少必要的库，是否自动安装？ (y/n)").lower().startswith("y")
+
+        if not auto_install:
+            sys.exit(1)
+
+        # 1. 检查 Poetry
+        if not check_poetry_installed():
+            install_poetry()
+            if platform.system() == "Windows":
+                import ctypes
+                ctypes.windll.user32.SendMessageTimeoutW(0xFFFF, 0x1A, 0, "Environment", 0x0002, 5000, None)
+            else:
+                os.environ["PATH"] = f"{os.path.expanduser('~/.local/bin')}:{os.environ['PATH']}"
+
+        # 2. 直接在当前目录搭建
+        setup_current_directory(REQUIRED_LIBRARIES)
+
+        print("环境配置完成！", f"虚拟环境位置: {os.path.join(os.getcwd(), '.venv')}")
+        print("请重新启动项目 例如: poetry run python main.py")
+        sys.exit(1)