aury-boot 0.0.12__py3-none-any.whl → 0.0.13__py3-none-any.whl

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.12'
-__version_tuple__ = version_tuple = (0, 0, 12)
+__version__ = version = '0.0.13'
+__version_tuple__ = version_tuple = (0, 0, 13)
 
 __commit_id__ = commit_id = None

aury/boot/commands/docs.py

@@ -83,8 +83,15 @@ def _detect_project_info(project_dir: Path) -> dict[str, str]:
 def _render_template(template_name: str, context: dict[str, str]) -> str:
     """渲染模板。
     
-    支持根目录模板和 aury_docs/ 子目录模板。
+    支持根目录模板、aury_docs/ 子目录模板，且 .env.example 复用 init.py 的 env_templates 逻辑。
     """
+    # 特殊处理 env.example.tpl（通过 init.py 的 env_templates 目录合并生成）
+    if template_name == "env.example.tpl":
+        from .init import _read_env_template  # 复用初始化脚手架的 env 生成逻辑
+
+        content = _read_env_template()
+        return content.format(**context)
+
     # 先在根目录找
     template_path = TEMPLATES_DIR / template_name
     if not template_path.exists():
@@ -173,6 +180,60 @@ def _get_aury_docs_templates() -> list[Path]:
     return sorted(AURY_DOCS_TPL_DIR.glob("*.md.tpl"))
 
 
+def generate_aury_docs(
+    *,
+    project_dir: Path,
+    context: dict[str, str],
+    force: bool = False,
+    dry_run: bool = False,
+    quiet: bool = False,
+) -> int:
+    """核心实现：根据 aury_docs 模板生成开发文档包。
+
+    被 `aury docs dev` 和 `aury init` 复用，确保生成逻辑一致。
+    返回成功生成的文档数量。
+    """
+    if not quiet:
+        console.print()
+
+    # 确保输出目录存在
+    aury_docs_dir = project_dir / "aury_docs"
+    if not dry_run:
+        aury_docs_dir.mkdir(parents=True, exist_ok=True)
+
+    success_count = 0
+    for tpl_path in _get_aury_docs_templates():
+        try:
+            output_name = tpl_path.stem  # 去掉 .tpl 后缀，保留 .md
+            output_path = aury_docs_dir / output_name
+            content = tpl_path.read_text(encoding="utf-8")
+            content = content.format(**context)
+            # init 直接写文件，不走 rich 提示
+            if quiet:
+                if output_path.exists() and not force and not dry_run:
+                    continue
+                if not dry_run:
+                    output_path.write_text(content, encoding="utf-8")
+                success_count += 1
+            else:
+                if _write_file(output_path, content, force=force, dry_run=dry_run):
+                    success_count += 1
+        except Exception as e:
+            if not quiet:
+                console.print(f"[red]❌ 生成 {tpl_path.name} 失败: {e}[/red]")
+            # 静默模式下（init）忽略单个文档失败
+            continue
+
+    if not quiet:
+        console.print()
+        if dry_run:
+            console.print(f"[dim]🔍 预览模式完成，将生成 {success_count} 个文档到 aury_docs/ 目录[/dim]")
+        else:
+            console.print(f"[green]✨ 完成！成功生成 {success_count} 个文档到 aury_docs/ 目录[/green]")
+
+    return success_count
+
+
 @app.command(name="dev")
 def generate_dev_doc(
     project_dir: Path = typer.Argument(
@@ -198,32 +259,16 @@ def generate_dev_doc(
 ) -> None:
     """生成/更新 aury_docs/ 开发文档包。"""
     context = _detect_project_info(project_dir)
-    
+
     console.print(f"[cyan]📚 检测到项目: {context['project_name']}[/cyan]")
-    console.print()
-    
-    # 确保输出目录存在
-    aury_docs_dir = project_dir / "aury_docs"
-    if not dry_run:
-        aury_docs_dir.mkdir(parents=True, exist_ok=True)
-    
-    success_count = 0
-    for tpl_path in _get_aury_docs_templates():
-        try:
-            output_name = tpl_path.stem  # 去掉 .tpl 后缀，保留 .md
-            output_path = aury_docs_dir / output_name
-            content = tpl_path.read_text(encoding="utf-8")
-            content = content.format(**context)
-            if _write_file(output_path, content, force=force, dry_run=dry_run):
-                success_count += 1
-        except Exception as e:
-            console.print(f"[red]❌ 生成 {tpl_path.name} 失败: {e}[/red]")
-    
-    console.print()
-    if dry_run:
-        console.print(f"[dim]🔍 预览模式完成，将生成 {success_count} 个文档到 aury_docs/ 目录[/dim]")
-    else:
-        console.print(f"[green]✨ 完成！成功生成 {success_count} 个文档到 aury_docs/ 目录[/green]")
+
+    generate_aury_docs(
+        project_dir=project_dir,
+        context=context,
+        force=force,
+        dry_run=dry_run,
+        quiet=False,
+    )
 
 
 @app.command(name="cli")

aury/boot/commands/init.py

@@ -836,25 +836,17 @@ def init(
     else:
         console.print("  [dim]ℹ️  migrations/ 目录已存在，跳过[/dim]")
 
-    # 5. 生成开发文档 (aury_docs/) - 动态扫描模板目录
+    # 5. 生成开发文档 (aury_docs/) - 复用 docs.generate_aury_docs
     console.print("\n[bold]📚 生成开发文档...[/bold]")
-    aury_docs_tpl_dir = TEMPLATES_DIR / "aury_docs"
-    aury_docs_dir = base_path / "aury_docs"
-    aury_docs_dir.mkdir(parents=True, exist_ok=True)
-    docs_count = 0
-    if aury_docs_tpl_dir.exists():
-        for tpl_path in sorted(aury_docs_tpl_dir.glob("*.md.tpl")):
-            output_name = tpl_path.stem  # 去掉 .tpl 后缀，保留 .md
-            output_path = aury_docs_dir / output_name
-            if output_path.exists() and not force:
-                continue
-            try:
-                content = tpl_path.read_text(encoding="utf-8")
-                content = content.format(**template_vars)
-                output_path.write_text(content, encoding="utf-8")
-                docs_count += 1
-            except Exception:
-                pass
+    from .docs import generate_aury_docs
+
+    docs_count = generate_aury_docs(
+        project_dir=base_path,
+        context=template_vars,
+        force=force,
+        dry_run=False,
+        quiet=True,
+    )
     console.print(f"  [green]✅ 已生成 {docs_count} 个文档到 aury_docs/[/green]")
 
     # 6. 生成 Docker 配置

aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl

@@ -52,7 +52,7 @@ class PaymentAdapter(BaseAdapter):
     async def query_order(self, transaction_id: str) -> dict:
         """查询支付订单。"""
         response = await self.http_client.get(
-            f"https://api.payment.com/orders/{transaction_id}"
+            f"https://api.payment.com/orders/{{transaction_id}}"
         )
         return response.json()
 
@@ -98,10 +98,10 @@ settings = AdapterSettings()
 # 方式 2：代码显式配置
 settings = AdapterSettings(
     mode="mock",
-    method_modes={
+    method_modes={{
         "query_order": "real",  # query_order 使用真实调用
         "create_order": "mock", # create_order 使用 Mock
-    },
+    }},
     debug=True,
 )
 
@@ -146,7 +146,7 @@ class WechatAdapter(HttpAdapter):
     @send_message.mock
     async def send_message_mock(self, openid: str, content: str) -> dict:
         """发送消息（Mock）。"""
-        return {"errcode": 0, "errmsg": "ok", "mock": True}
+        return {{"errcode": 0, "errmsg": "ok", "mock": True}}
 ```
 
 ## 16.5 方法级模式覆盖
@@ -272,7 +272,7 @@ class CompositePaymentAdapter(BaseAdapter):
         elif channel == "wechat":
             return await self.wechat.create_order(amount, order_id)
         else:
-            raise ValueError(f"不支持的支付渠道: {channel}")
+            raise ValueError(f"不支持的支付渠道: {{channel}}")
 
     @pay.mock
     async def pay_mock(self, channel: str, amount: int, order_id: str) -> dict:
@@ -350,7 +350,7 @@ THIRD_PARTY__DEBUG=true
 
 # 测试环境 (.env.testing)
 THIRD_PARTY__GATEWAY_MODE=mock
-THIRD_PARTY__METHOD_MODES={"query": "sandbox"}
+THIRD_PARTY__METHOD_MODES={{"query": "sandbox"}}
 
 # 生产环境 (.env.production)
 THIRD_PARTY__GATEWAY_MODE=real

{aury_boot-0.0.12.dist-info → aury_boot-0.0.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.12
+Version: 0.0.13
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2

{aury_boot-0.0.12.dist-info → aury_boot-0.0.13.dist-info}/RECORD

@@ -1,5 +1,5 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=AZGfWDETy7COMkzrSothvXJ8vYrPI7kp7_Tcfcp9hUQ,706
+aury/boot/_version.py,sha256=zL2ebKl28AIxVDJJ-NA0JydSncoMv-eXaYp14mDVF3Y,706
 aury/boot/application/__init__.py,sha256=0o_XmiwFCeAu06VHggS8I1e7_nSMoRq0Hcm0fYfCywU,3071
 aury/boot/application/adapter/__init__.py,sha256=e1bcSb1bxUMfofTwiCuHBZJk5-STkMCWPF2EJXHQ7UU,3976
 aury/boot/application/adapter/base.py,sha256=Ar_66fiHPDEmV-1DKnqXKwc53p3pozG31bgTJTEUriY,15763
@@ -45,9 +45,9 @@ aury/boot/commands/add.py,sha256=JRJir92oFHwIBtIKKEjQ7trUhfb9-kCH84x_7saV2gI,264
 aury/boot/commands/app.py,sha256=k0zHzR3ckt17laAYk6WwwS-lqzS-N8811XjKC-7lerg,7857
 aury/boot/commands/config.py,sha256=gPkG_jSWrXidjpyVdzABH7uRhoCgX5yrOcdKabtX5wY,4928
 aury/boot/commands/docker.py,sha256=7mKorZCPZgxH1XFslzo6W-uzpe61hGXz86JKOhOeBlo,9006
-aury/boot/commands/docs.py,sha256=-uCvrKj0_shdeBY08W6zx5vNpsBM3yc_IIOOQzoFbqE,11647
+aury/boot/commands/docs.py,sha256=7VaZyEuezmL28aM9y13ni-y-VYP-eNKff5-qb-9q1RQ,13066
 aury/boot/commands/generate.py,sha256=WZieSXuofxJOC7NBiVGpBigB9NZ4GMcF2F1ReTNun1I,44420
-aury/boot/commands/init.py,sha256=4JsQ6U48ZfH_Vzu83k3439gc77Zcmn9arKHgH_kq7HM,32808
+aury/boot/commands/init.py,sha256=vHg2Zhdoar1ANug9J8pT1tNGdH5S0GO19Rhsy-04mXQ,32262
 aury/boot/commands/pkg.py,sha256=SyHpeSh0vuGVHNmv97-0ZX7AjuSttfZkOs7T86Pq-NQ,14489
 aury/boot/commands/scheduler.py,sha256=BCIGQcGryXpsYNF-mncP6v5kNoz6DZ10DMzMKVDiXxA,3516
 aury/boot/commands/worker.py,sha256=qAcPdoKpMBLYoi45X_y2-nobuYKxscJpooEB_0HhM4o,4163
@@ -84,7 +84,7 @@ aury/boot/commands/templates/project/aury_docs/12-admin.md.tpl,sha256=6z3mN54qP2
 aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl,sha256=rdtlog3ajcSsT0fq9a_US3MPcZhTvDo72eT6hetg4aI,3376
 aury/boot/commands/templates/project/aury_docs/14-mq.md.tpl,sha256=4bxLQBbCi0Fue0VQWOPt6acZ5P00BoLkCoLPQe_8k4U,2396
 aury/boot/commands/templates/project/aury_docs/15-events.md.tpl,sha256=a4wQRgVPuYUGTGmw_lX1HJH_yFTbD30mBz7Arc4zgfs,3361
-aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl,sha256=mKLbvIJxHNQOIeDLJH_v5EYaZYEu54K4jGSk8kEianA,11444
+aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl,sha256=ILwUDaaSQ15W1OM4f8qq4zMi1eSimkT1279Hbw8hTYA,11454
 aury/boot/commands/templates/project/aury_docs/99-cli.md.tpl,sha256=_dXMK8V7HJAsA_6R1SboD8Rv63s7sDPolvQoSQvKXgA,3667
 aury/boot/commands/templates/project/env_templates/_header.tpl,sha256=Pt0X_I25o1th3CLR228L2-nlcC-lIkN8cPailohBEkU,513
 aury/boot/commands/templates/project/env_templates/admin.tpl,sha256=wWt3iybOpBHtuw6CkoUJ1bzEL0aNgOzKDEkMKhI2oag,2032
@@ -192,7 +192,7 @@ aury/boot/testing/client.py,sha256=KOg1EemuIVsBG68G5y0DjSxZGcIQVdWQ4ASaHE3o1R0,4
 aury/boot/testing/factory.py,sha256=8GvwX9qIDu0L65gzJMlrWB0xbmJ-7zPHuwk3eECULcg,5185
 aury/boot/toolkit/__init__.py,sha256=AcyVb9fDf3CaEmJPNkWC4iGv32qCPyk4BuFKSuNiJRQ,334
 aury/boot/toolkit/http/__init__.py,sha256=zIPmpIZ9Qbqe25VmEr7jixoY2fkRbLm7NkCB9vKpg6I,11039
-aury_boot-0.0.12.dist-info/METADATA,sha256=YB6RyOOKJdDaZbfk-RhHL041oPN8DZ0kZFRxlrR8mys,7981
-aury_boot-0.0.12.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.12.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.12.dist-info/RECORD,,
+aury_boot-0.0.13.dist-info/METADATA,sha256=s7J-sRJY-1E1Up1-_wM1dwgzgaK-CNo8wamMlxJjlFM,7981
+aury_boot-0.0.13.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.13.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.13.dist-info/RECORD,,