wagent-framework 1.4.0__py3-none-any.whl

wagent_framework-1.4.0.dist-info/METADATA

@@ -0,0 +1,309 @@
+Metadata-Version: 2.4
+Name: wagent-framework
+Version: 1.4.0
+Summary: Python enterprise agent framework with AOP, IOC, and sandbox security
+Home-page: https://github.com/LuckyStar2456/W-Agent-FrameWork
+Author: LuckyStar2456
+Author-email: lucky_star_2456@example.com
+License: MIT
+Project-URL: Bug Reports, https://github.com/LuckyStar2456/W-Agent-FrameWork/issues
+Project-URL: Source, https://github.com/LuckyStar2456/W-Agent-FrameWork
+Keywords: agent framework AOP IOC sandbox
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic
+Requires-Dist: structlog
+Requires-Dist: cryptography
+Requires-Dist: msgpack
+Requires-Dist: zstandard
+Requires-Dist: pyjwt
+Requires-Dist: asgiref
+Requires-Dist: redis
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: uvicorn; extra == "fastapi"
+Provides-Extra: langchain
+Requires-Dist: langchain; extra == "langchain"
+Provides-Extra: wasm
+Requires-Dist: wasmer; extra == "wasm"
+Provides-Extra: opentelemetry
+Requires-Dist: opentelemetry-api; extra == "opentelemetry"
+Requires-Dist: opentelemetry-sdk; extra == "opentelemetry"
+Requires-Dist: opentelemetry-exporter-otlp; extra == "opentelemetry"
+Provides-Extra: testing
+Requires-Dist: pytest; extra == "testing"
+Requires-Dist: pytest-asyncio; extra == "testing"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# W-Agent v1.4.0
+
+[English](./README_EN.md) | 简体中文
+
+Python 企业级智能体框架，完整技术架构方案。
+
+[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/LuckyStar2456/W-Agent-FrameWork?style=social)](https://github.com/LuckyStar2456/W-Agent-FrameWork/stargazers)
+
+## 📚 目录
+
+- [功能特性](#-功能特性)
+- [快速开始](#-快速开始)
+- [项目结构](#-项目结构)
+- [核心模块](#-核心模块)
+- [配置指南](#-配置指南)
+- [示例项目](#-示例项目)
+- [文档](#-文档)
+- [贡献指南](#-贡献指南)
+- [许可证](#-许可证)
+
+## ✨ 功能特性
+
+| 特性 | 描述 |
+|------|------|
+| **AOP 面向切面编程** | 支持 AspectJ 切点表达式（execution、within、@annotation、bean、args） |
+| **IOC 依赖注入** | 三级缓存、构造器/字段/setter 注入、@Autowired/@Qualifier 注解 |
+| **沙箱安全** | Wasm/nsjail 沙箱、seccomp 过滤、资源限制 |
+| **弹性模式** | 重试（带退避）、断路器（CLOSED/OPEN/HALF_OPEN 状态） |
+| **可观测性** | OpenTelemetry 集成、链路追踪、指标监控 |
+| **RAG 集成** | 向量检索（Redis/内存）、相似度搜索 |
+| **配置热更新** | 动态配置管理、配置变更事件 |
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 基础安装
+pip install -e .
+
+# 安装可选依赖
+pip install -e .[fastapi,langchain,redis]
+```
+
+### 创建你的第一个 Agent
+
+```python
+import asyncio
+from w_agent.core.agent import BaseAgent
+from w_agent.container.bean_factory import BeanFactory
+from w_agent.core.decorators import AgentComponent
+
+@AgentComponent(name="hello_agent")
+class HelloAgent(BaseAgent):
+    async def arun(self, prompt: str) -> str:
+        return f"Hello, {prompt}!"
+
+async def main():
+    # 创建 Bean 工厂
+    bean_factory = BeanFactory()
+
+    # 注册 Agent
+    agent = HelloAgent()
+    bean_factory.register_bean("hello_agent", agent)
+
+    # 使用 Agent
+    agent = await bean_factory.get_bean("hello_agent")
+    result = await agent.arun("World")
+    print(result)  # 输出: Hello, World!
+
+asyncio.run(main())
+```
+
+### 使用配置热更新
+
+```python
+import asyncio
+from w_agent.config.dynamic_config import DynamicConfigManager
+
+async def main():
+    config_manager = DynamicConfigManager()
+
+    # 设置配置
+    config_manager.set("api_key", "your-api-key")
+
+    # 绑定配置到属性
+    class MyService:
+        def __init__(self):
+            self.api_key = None
+            config_manager.bind("api_key", self, "api_key")
+
+        async def on_config_change(self, key, new_value, old_value):
+            print(f"Config changed: {key} = {new_value}")
+
+    service = MyService()
+    print(service.api_key)  # 输出: your-api-key
+
+    # 动态更新配置
+    await config_manager.update_batch({"api_key": "new-api-key"})
+    print(service.api_key)  # 输出: new-api-key
+
+asyncio.run(main())
+```
+
+## 📁 项目结构
+
+```
+w_agent/
+├── aop/                    # 面向切面编程
+│   ├── aspects.py          # 切面实现（重试、断路器）
+│   ├── joinpoint.py        # 连接点
+│   ├── pointcut.py         # 切点表达式解析
+│   └── proxy_factory.py    # 代理工厂
+├── config/                 # 配置管理
+│   └── dynamic_config.py   # 动态配置
+├── container/              # 依赖注入容器
+│   ├── bean_factory.py     # Bean 工厂
+│   └── reflection_cache.py # 反射缓存
+├── core/                   # 核心功能
+│   ├── agent.py           # Agent 基类
+│   ├── event_bus.py       # 事件总线
+│   └── decorators.py      # 装饰器
+├── observability/          # 可观测性
+│   ├── tracing.py         # 链路追踪
+│   ├── metrics.py         # 指标监控
+│   └── health.py          # 健康检查
+├── skills/                # 技能系统
+│   └── sandbox/           # 沙箱
+│       ├── wasm_sandbox.py
+│       └── nsjail_sandbox.py
+└── ...
+```
+
+## 🔧 核心模块
+
+### AOP 切面编程
+
+```python
+from w_agent.core.decorators import Retry, CircuitBreaker
+from w_agent.aop.pointcut import AspectJPointcut
+
+# 使用重试装饰器
+@Retry(max_attempts=3, delay=0.1, backoff=2.0)
+async def unreliable_operation():
+    pass
+
+# 使用断路器
+@CircuitBreaker(failure_threshold=5, recovery_timeout=30.0)
+async def protected_operation():
+    pass
+```
+
+### 依赖注入
+
+```python
+from w_agent.core.decorators import Autowired, Qualifier, ServiceComponent
+
+@ServiceComponent(name="user_service")
+class UserService:
+    @Qualifier(name="redis_client")
+    def set_cache(self, cache_client):
+        self.cache = cache_client
+```
+
+### 事件总线
+
+```python
+from w_agent.core.event_bus import EventBus, Event
+
+event_bus = EventBus()
+
+@event_bus.on("user.created")
+async def on_user_created(event):
+    print(f"User created: {event.payload}")
+
+await event_bus.emit(Event("user.created", {"user_id": 123}))
+```
+
+## ⚙️ 配置指南
+
+### 可配置项一览
+
+| 配置项 | 类型 | 默认值 | 描述 |
+|--------|------|--------|------|
+| `logging.level` | string | "INFO" | 日志级别 |
+| `container.scan_paths` | list | ["."] | 组件扫描路径 |
+| `sandbox.enabled` | bool | true | 是否启用沙箱 |
+| `resilience.retry.max_attempts` | int | 3 | 最大重试次数 |
+| `distributed.lock.redis.url` | string | "redis://localhost:6379" | Redis 连接 URL |
+
+### 配置文件
+
+创建 `config.json`：
+
+```json
+{
+  "logging": {
+    "level": "INFO",
+    "format": "json"
+  },
+  "container": {
+    "scan_paths": ["src"],
+    "skip_paths": ["__pycache__", ".git"]
+  }
+}
+```
+
+### 环境变量
+
+```bash
+export W_AGENT_LOGGING_LEVEL=DEBUG
+export W_AGENT_CONTAINER_SCAN_PATHS=src,components
+```
+
+## 📖 示例项目
+
+查看 [chat-agent](./chat-agent/) 目录获取完整的聊天智能体示例项目，包含：
+
+- Agent 实现
+- Skill 系统
+- RAG 检索增强
+- Redis/MySQL 集成
+- OpenTelemetry 可观测性
+
+## 📄 文档
+
+- [架构设计文档](./docs/architecture.md)
+- [API 文档](./docs/api.md)
+- [使用指南](./docs/guide.md)
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+本项目采用 [MIT 许可证](LICENSE)。
+
+---
+
+如果这个项目对你有帮助，请给我们一个 ⭐！

wagent_framework-1.4.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+wagent_framework-1.4.0.dist-info/licenses/LICENSE,sha256=kBvObOdHRQrfBkOmeNj-h2U_XmlU0ZAFwnQ-LrbiIOg,1091
+wagent_framework-1.4.0.dist-info/METADATA,sha256=SaKIJMs-kRsEdBCeXKfrpWHf-iefuFYlcojlsK8MBUo,9141
+wagent_framework-1.4.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+wagent_framework-1.4.0.dist-info/entry_points.txt,sha256=d-SKdVfLJIw5aRfClVzKb-RyqHP-oWPlv0CapJopOp4,45
+wagent_framework-1.4.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+wagent_framework-1.4.0.dist-info/RECORD,,

wagent_framework-1.4.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

wagent_framework-1.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+w-agent = w_agent.cli:main

wagent_framework-1.4.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LuckyStar2456
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wagent_framework-1.4.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+