pancake-embed 0.1.0__tar.gz

pancake_embed-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: pancake-embed
+Version: 0.1.0
+Summary: Pancake Embed Plugin - 零 import 机制，将所有装饰器注入 builtins
+License: MIT
+Author: drayee
+Author-email: 1473443474@qq.com
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: pancake_framework (>=0.2.0)
+Description-Content-Type: text/markdown
+
+# Pancake Embed
+
+> 零 import 插件 — 配合 DoughMeta 实现框架 API 自动注入
+
+## 工作原理
+
+1. **Embed 插件**加载时（`init_order=-10`，最先执行），将装饰器注册到 `muffin_flour`
+2. 用户定义 `Dough` 子类时，**DoughMeta** 自动从 `muffin_flour`/`muffin_water` 注入已注册的名称到模块命名空间
+3. 用户代码无需 `import` 即可使用所有装饰器和基类
+
+```python
+from pancake.dough import Dough
+
+# 定义子类后，Singleton、Service、DoughFactory 等自动可用
+@Singleton
+class UserService(Service):
+    async def on_init(self):
+        self.db = DoughFactory.get().resolve("DatabaseService")
+```
+
+## 注册的名称
+
+### 装饰器 (muffin_flour)
+- `@Singleton` / `@Prototype` / `@Lazy` — 作用域
+- `@DoughDecorator` — 标记类为 Bean
+- `@DependsOn("A", "B")` — 声明依赖
+- `@Import(Cls)` — 自动注册外部类
+- `@Maker` / `@noMaker` — 控制方法 Bean 注册
+- `@inject` — 自动注入依赖
+- `@Config` — 从配置注入字段
+
+### 基类 (muffin_water)
+- `Configuration` — 配置类
+- `Service` — 服务类
+- `Function` — 方法类
+- `Struct` — 数据结构类
+- `DoughFactory` — Bean 工厂
+
+## 安装
+
+```bash
+pip install pancake-embed
+```
+
+或在 `pancake.xml` 中添加：
+
+```xml
+<dependency>
+    <groupId>io.pancake</groupId>
+    <artifactId>embed</artifactId>
+</dependency>
+```
+
+## 开源协议
+
+MIT
+

pancake_embed-0.1.0/README.md

@@ -0,0 +1,56 @@
+# Pancake Embed
+
+> 零 import 插件 — 配合 DoughMeta 实现框架 API 自动注入
+
+## 工作原理
+
+1. **Embed 插件**加载时（`init_order=-10`，最先执行），将装饰器注册到 `muffin_flour`
+2. 用户定义 `Dough` 子类时，**DoughMeta** 自动从 `muffin_flour`/`muffin_water` 注入已注册的名称到模块命名空间
+3. 用户代码无需 `import` 即可使用所有装饰器和基类
+
+```python
+from pancake.dough import Dough
+
+# 定义子类后，Singleton、Service、DoughFactory 等自动可用
+@Singleton
+class UserService(Service):
+    async def on_init(self):
+        self.db = DoughFactory.get().resolve("DatabaseService")
+```
+
+## 注册的名称
+
+### 装饰器 (muffin_flour)
+- `@Singleton` / `@Prototype` / `@Lazy` — 作用域
+- `@DoughDecorator` — 标记类为 Bean
+- `@DependsOn("A", "B")` — 声明依赖
+- `@Import(Cls)` — 自动注册外部类
+- `@Maker` / `@noMaker` — 控制方法 Bean 注册
+- `@inject` — 自动注入依赖
+- `@Config` — 从配置注入字段
+
+### 基类 (muffin_water)
+- `Configuration` — 配置类
+- `Service` — 服务类
+- `Function` — 方法类
+- `Struct` — 数据结构类
+- `DoughFactory` — Bean 工厂
+
+## 安装
+
+```bash
+pip install pancake-embed
+```
+
+或在 `pancake.xml` 中添加：
+
+```xml
+<dependency>
+    <groupId>io.pancake</groupId>
+    <artifactId>embed</artifactId>
+</dependency>
+```
+
+## 开源协议
+
+MIT

pancake_embed-0.1.0/pancake_embed/__init__.py

@@ -0,0 +1,41 @@
+"""
+Pancake Embed — 零 import 插件
+将框架装饰器注册到 muffin_flour，配合 DoughMeta 实现自动注入。
+DoughMeta 在用户定义 Dough 子类时，自动从 muffin_flour/muffin_water
+注入已注册的名称到模块命名空间。
+"""
+
+import logging
+
+from pancake.ovenware import InitAction
+
+logger = logging.getLogger(__name__)
+
+
+class Main(InitAction):
+    """Embed 插件入口
+
+    init_order=-10 确保最先加载，
+    在用户代码加载前完成装饰器注册。
+    """
+
+    init_order = -10
+    build_order = 0
+
+    def check(self) -> bool:
+        return True
+
+    def build(self):
+        """确保所有装饰器已注册到 muffin_flour"""
+        # 触发 decorators 模块加载（会自动注册到 muffin_flour）
+        import pancake.decorators  # noqa: F401
+        # 触发 base 模块加载（会自动注册到 muffin_water）
+        import pancake.base  # noqa: F401
+        # 触发 factory 模块加载（会自动注册到 muffin_water）
+        import pancake.factory  # noqa: F401
+
+        from pancake.oven.muffin import muffin_flour, muffin_water
+        logger.info(
+            f"Embed: 已注册 {len(muffin_flour)} 个装饰器, "
+            f"{len(muffin_water)} 个类"
+        )

pancake_embed-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[tool.poetry]
+name = "pancake-embed"
+version = "0.1.0"
+description = "Pancake Embed Plugin - 零 import 机制，将所有装饰器注入 builtins"
+authors = ["drayee <1473443474@qq.com>"]
+license = "MIT"
+readme = "README.md"
+packages = [{include = "pancake_embed"}]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+pancake_framework = ">=0.2.0"
+
+[tool.poetry.plugins."pancake.plugins"]
+embed = "pancake_embed:Main"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"