pytest-dsl 0.9.0__tar.gz → 0.10.0__tar.gz

{pytest_dsl-0.9.0/pytest_dsl.egg-info → pytest_dsl-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytest-dsl
-Version: 0.9.0
+Version: 0.10.0
 Summary: A DSL testing framework based on pytest
 Author: Chen Shuanglin
 License: MIT
@@ -42,11 +42,12 @@ pytest-dsl是一个革命性的关键字驱动测试框架，基于pytest构建
 ## ✨ 核心特性
 
 - 🎯 **门槛上手低** - 自然语言风格，只需少量编程基础
-- 🔧 **高度可扩展** - 轻松创建自定义关键字
+- 🔧 **高度可扩展** - 轻松创建自定义关键字，支持参数默认值
 - 🌐 **分布式执行** - 支持远程关键字调用
 - 🔄 **无缝集成** - 完美兼容pytest生态
 - 📊 **丰富报告** - 集成Allure测试报告
 - 🛡️ **企业级** - 支持变量管理、环境隔离
+- ⚡ **智能简化** - 参数默认值让DSL更加简洁易读
 
 ## 🚀 5分钟快速开始
 
@@ -850,17 +851,19 @@ def database_query(**kwargs):
 
 @keyword_manager.register('发送邮件', [
     {'name': '收件人', 'mapping': 'to_email', 'description': '收件人邮箱'},
-    {'name': '主题', 'mapping': 'subject', 'description': '邮件主题'},
-    {'name': '内容', 'mapping': 'content', 'description': '邮件内容'}
+    {'name': '主题', 'mapping': 'subject', 'description': '邮件主题', 'default': '测试邮件'},
+    {'name': '内容', 'mapping': 'content', 'description': '邮件内容', 'default': '这是一封测试邮件'},
+    {'name': '优先级', 'mapping': 'priority', 'description': '邮件优先级', 'default': 'normal'}
 ])
 def send_email(**kwargs):
     """发送邮件通知"""
     to_email = kwargs.get('to_email')
-    subject = kwargs.get('subject')
-    content = kwargs.get('content')
+    subject = kwargs.get('subject', '测试邮件')
+    content = kwargs.get('content', '这是一封测试邮件')
+    priority = kwargs.get('priority', 'normal')
 
     # 实现邮件发送逻辑
-    print(f"发送邮件到 {to_email}: {subject}")
+    print(f"发送邮件到 {to_email}: {subject} (优先级: {priority})")
 
     return True
 ```
@@ -874,10 +877,71 @@ def send_email(**kwargs):
 users = [数据库查询], 查询语句: "SELECT * FROM users WHERE active = 1"
 [打印], 内容: "查询到 ${len(users)} 个活跃用户"
 
-# 发送测试报告邮件
-[发送邮件], 收件人: "admin@example.com", 主题: "测试报告", 内容: "测试已完成"
+# 发送测试报告邮件 - 使用默认值
+[发送邮件], 收件人: "admin@example.com"  # 主题和内容使用默认值
+
+# 发送自定义邮件 - 覆盖默认值
+[发送邮件], 收件人: "dev@example.com", 主题: "部署完成", 内容: "系统已成功部署到生产环境"
+```
+
+### 5. 参数默认值功能 🆕
+
+pytest-dsl 现在支持为关键字参数设置默认值，让DSL编写更加简洁：
+
+#### 定义带默认值的关键字
+
+```python
+from pytest_dsl.core.keyword_manager import keyword_manager
+
+@keyword_manager.register('HTTP请求', [
+    {'name': '地址', 'mapping': 'url', 'description': '请求地址'},
+    {'name': '方法', 'mapping': 'method', 'description': 'HTTP方法', 'default': 'GET'},
+    {'name': '超时', 'mapping': 'timeout', 'description': '超时时间（秒）', 'default': 30},
+    {'name': '重试次数', 'mapping': 'retries', 'description': '重试次数', 'default': 3},
+    {'name': '验证SSL', 'mapping': 'verify_ssl', 'description': '是否验证SSL证书', 'default': True}
+])
+def http_request(**kwargs):
+    """HTTP请求关键字，支持默认值"""
+    url = kwargs.get('url')
+    method = kwargs.get('method', 'GET')  # 默认值也会自动应用
+    timeout = kwargs.get('timeout', 30)
+    retries = kwargs.get('retries', 3)
+    verify_ssl = kwargs.get('verify_ssl', True)
+    
+    # 执行HTTP请求逻辑
+    return {"status": "success", "method": method, "url": url}
 ```
 
+#### 在DSL中使用默认值
+
+```python
+@name: "默认值功能演示"
+
+# 只传递必需参数，其他使用默认值
+response1 = [HTTP请求], 地址: "https://api.example.com/users"
+# 等价于：方法: "GET", 超时: 30, 重试次数: 3, 验证SSL: True
+
+# 部分覆盖默认值
+response2 = [HTTP请求], 地址: "https://api.example.com/users", 方法: "POST", 超时: 60
+# 只覆盖方法和超时，重试次数和SSL验证仍使用默认值
+
+# 内置关键字也支持默认值
+random_num = [生成随机数]  # 使用默认范围 0-100，整数
+custom_num = [生成随机数], 最大值: 50  # 只修改最大值，其他保持默认
+
+# 生成随机字符串
+default_string = [生成随机字符串]  # 长度8，字母数字混合
+custom_string = [生成随机字符串], 长度: 12, 类型: "letters"  # 自定义长度和类型
+```
+
+#### 默认值的优势
+
+- **🎯 简化调用** - 只需传递关键参数，常用配置自动应用
+- **🔧 灵活覆盖** - 可选择性地覆盖任何默认值
+- **📖 提高可读性** - DSL更加简洁，重点突出
+- **🛡️ 减少错误** - 避免重复配置常用参数
+- **🌐 远程支持** - 远程关键字也完整支持默认值功能
+
 #### 支持远程模式的关键字
 
 ```python
@@ -1037,20 +1101,6 @@ CMD ["pytest-dsl", "tests/", "--yaml-vars", "config/prod.yaml"]
 - **集成测试** - 跨系统测试协调
 - **性能测试** - 结合其他工具进行性能测试
 
-## 🤝 贡献与支持
-
-我们欢迎您的贡献和反馈！
-
-- 🐛 [报告问题](https://github.com/your-repo/pytest-dsl/issues)
-- 💡 [功能建议](https://github.com/your-repo/pytest-dsl/discussions)
-- 🔧 [提交PR](https://github.com/your-repo/pytest-dsl/pulls)
-
-## 📄 许可证
-
-MIT License - 详见 [LICENSE](LICENSE) 文件
-
----
-
 ## 📋 示例验证
 
 本README.md中的大部分示例都已经过验证，确保可以正常运行。验证示例位于 `examples/readme_validation/` 目录中。
@@ -1086,3 +1136,18 @@ pytest-dsl api_basic.dsl
 ---
 
 🚀 **开始使用pytest-dsl，让测试自动化变得简单而强大！**
+
+
+## 🤝 贡献与支持
+
+我们欢迎您的贡献和反馈！
+
+- 🐛 [报告问题](https://github.com/felix-1991/pytest-dsl/issues)
+- 💡 [功能建议](https://github.com/felix-1991/pytest-dsl/discussions)
+- 🔧 [提交PR](https://github.com/felix-1991/pytest-dsl/pulls)
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE) 文件
+
+---

{pytest_dsl-0.9.0 → pytest_dsl-0.10.0}/README.md

@@ -11,11 +11,12 @@ pytest-dsl是一个革命性的关键字驱动测试框架，基于pytest构建
 ## ✨ 核心特性
 
 - 🎯 **门槛上手低** - 自然语言风格，只需少量编程基础
-- 🔧 **高度可扩展** - 轻松创建自定义关键字
+- 🔧 **高度可扩展** - 轻松创建自定义关键字，支持参数默认值
 - 🌐 **分布式执行** - 支持远程关键字调用
 - 🔄 **无缝集成** - 完美兼容pytest生态
 - 📊 **丰富报告** - 集成Allure测试报告
 - 🛡️ **企业级** - 支持变量管理、环境隔离
+- ⚡ **智能简化** - 参数默认值让DSL更加简洁易读
 
 ## 🚀 5分钟快速开始
 
@@ -819,17 +820,19 @@ def database_query(**kwargs):
 
 @keyword_manager.register('发送邮件', [
     {'name': '收件人', 'mapping': 'to_email', 'description': '收件人邮箱'},
-    {'name': '主题', 'mapping': 'subject', 'description': '邮件主题'},
-    {'name': '内容', 'mapping': 'content', 'description': '邮件内容'}
+    {'name': '主题', 'mapping': 'subject', 'description': '邮件主题', 'default': '测试邮件'},
+    {'name': '内容', 'mapping': 'content', 'description': '邮件内容', 'default': '这是一封测试邮件'},
+    {'name': '优先级', 'mapping': 'priority', 'description': '邮件优先级', 'default': 'normal'}
 ])
 def send_email(**kwargs):
     """发送邮件通知"""
     to_email = kwargs.get('to_email')
-    subject = kwargs.get('subject')
-    content = kwargs.get('content')
+    subject = kwargs.get('subject', '测试邮件')
+    content = kwargs.get('content', '这是一封测试邮件')
+    priority = kwargs.get('priority', 'normal')
 
     # 实现邮件发送逻辑
-    print(f"发送邮件到 {to_email}: {subject}")
+    print(f"发送邮件到 {to_email}: {subject} (优先级: {priority})")
 
     return True
 ```
@@ -843,10 +846,71 @@ def send_email(**kwargs):
 users = [数据库查询], 查询语句: "SELECT * FROM users WHERE active = 1"
 [打印], 内容: "查询到 ${len(users)} 个活跃用户"
 
-# 发送测试报告邮件
-[发送邮件], 收件人: "admin@example.com", 主题: "测试报告", 内容: "测试已完成"
+# 发送测试报告邮件 - 使用默认值
+[发送邮件], 收件人: "admin@example.com"  # 主题和内容使用默认值
+
+# 发送自定义邮件 - 覆盖默认值
+[发送邮件], 收件人: "dev@example.com", 主题: "部署完成", 内容: "系统已成功部署到生产环境"
+```
+
+### 5. 参数默认值功能 🆕
+
+pytest-dsl 现在支持为关键字参数设置默认值，让DSL编写更加简洁：
+
+#### 定义带默认值的关键字
+
+```python
+from pytest_dsl.core.keyword_manager import keyword_manager
+
+@keyword_manager.register('HTTP请求', [
+    {'name': '地址', 'mapping': 'url', 'description': '请求地址'},
+    {'name': '方法', 'mapping': 'method', 'description': 'HTTP方法', 'default': 'GET'},
+    {'name': '超时', 'mapping': 'timeout', 'description': '超时时间（秒）', 'default': 30},
+    {'name': '重试次数', 'mapping': 'retries', 'description': '重试次数', 'default': 3},
+    {'name': '验证SSL', 'mapping': 'verify_ssl', 'description': '是否验证SSL证书', 'default': True}
+])
+def http_request(**kwargs):
+    """HTTP请求关键字，支持默认值"""
+    url = kwargs.get('url')
+    method = kwargs.get('method', 'GET')  # 默认值也会自动应用
+    timeout = kwargs.get('timeout', 30)
+    retries = kwargs.get('retries', 3)
+    verify_ssl = kwargs.get('verify_ssl', True)
+    
+    # 执行HTTP请求逻辑
+    return {"status": "success", "method": method, "url": url}
 ```
 
+#### 在DSL中使用默认值
+
+```python
+@name: "默认值功能演示"
+
+# 只传递必需参数，其他使用默认值
+response1 = [HTTP请求], 地址: "https://api.example.com/users"
+# 等价于：方法: "GET", 超时: 30, 重试次数: 3, 验证SSL: True
+
+# 部分覆盖默认值
+response2 = [HTTP请求], 地址: "https://api.example.com/users", 方法: "POST", 超时: 60
+# 只覆盖方法和超时，重试次数和SSL验证仍使用默认值
+
+# 内置关键字也支持默认值
+random_num = [生成随机数]  # 使用默认范围 0-100，整数
+custom_num = [生成随机数], 最大值: 50  # 只修改最大值，其他保持默认
+
+# 生成随机字符串
+default_string = [生成随机字符串]  # 长度8，字母数字混合
+custom_string = [生成随机字符串], 长度: 12, 类型: "letters"  # 自定义长度和类型
+```
+
+#### 默认值的优势
+
+- **🎯 简化调用** - 只需传递关键参数，常用配置自动应用
+- **🔧 灵活覆盖** - 可选择性地覆盖任何默认值
+- **📖 提高可读性** - DSL更加简洁，重点突出
+- **🛡️ 减少错误** - 避免重复配置常用参数
+- **🌐 远程支持** - 远程关键字也完整支持默认值功能
+
 #### 支持远程模式的关键字
 
 ```python
@@ -1006,20 +1070,6 @@ CMD ["pytest-dsl", "tests/", "--yaml-vars", "config/prod.yaml"]
 - **集成测试** - 跨系统测试协调
 - **性能测试** - 结合其他工具进行性能测试
 
-## 🤝 贡献与支持
-
-我们欢迎您的贡献和反馈！
-
-- 🐛 [报告问题](https://github.com/your-repo/pytest-dsl/issues)
-- 💡 [功能建议](https://github.com/your-repo/pytest-dsl/discussions)
-- 🔧 [提交PR](https://github.com/your-repo/pytest-dsl/pulls)
-
-## 📄 许可证
-
-MIT License - 详见 [LICENSE](LICENSE) 文件
-
----
-
 ## 📋 示例验证
 
 本README.md中的大部分示例都已经过验证，确保可以正常运行。验证示例位于 `examples/readme_validation/` 目录中。
@@ -1055,3 +1105,18 @@ pytest-dsl api_basic.dsl
 ---
 
 🚀 **开始使用pytest-dsl，让测试自动化变得简单而强大！**
+
+
+## 🤝 贡献与支持
+
+我们欢迎您的贡献和反馈！
+
+- 🐛 [报告问题](https://github.com/felix-1991/pytest-dsl/issues)
+- 💡 [功能建议](https://github.com/felix-1991/pytest-dsl/discussions)
+- 🔧 [提交PR](https://github.com/felix-1991/pytest-dsl/pulls)
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE) 文件
+
+---

{pytest_dsl-0.9.0 → pytest_dsl-0.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytest-dsl"
-version = "0.9.0"
+version = "0.10.0"
 description = "A DSL testing framework based on pytest"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -41,8 +41,13 @@ pytest_dsl = "pytest_dsl.plugin"
 [project.scripts]
 pytest-dsl = "pytest_dsl.cli:main"
 pytest-dsl-server = "pytest_dsl.remote.keyword_server:main"
-pytest-dsl-list = "pytest_dsl.cli:main"
+pytest-dsl-list = "pytest_dsl.cli:main_list_keywords"
 
 [project.urls]
 "Homepage" = "https://github.com/felix-1991/pytest-dsl"
 "Bug Tracker" = "https://github.com/felix-1991/pytest-dsl/issues"
+
+
+[[tool.uv.index]]
+name = "tuna"
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"

{pytest_dsl-0.9.0 → pytest_dsl-0.10.0}/pytest_dsl/cli.py

@@ -64,8 +64,12 @@ def parse_args():
         )
         list_parser.add_argument(
             '--format', choices=['text', 'json'],
-            default='text',
-            help='输出格式：text(默认) 或 json'
+            default='json',
+            help='输出格式：json(默认) 或 text'
+        )
+        list_parser.add_argument(
+            '--output', '-o', type=str, default=None,
+            help='输出文件路径（仅对 json 格式有效，默认为 keywords.json）'
         )
         list_parser.add_argument(
             '--filter', type=str, default=None,
@@ -88,7 +92,10 @@ def parse_args():
         if '--list-keywords' in argv:
             parser.add_argument('--list-keywords', action='store_true')
             parser.add_argument(
-                '--format', choices=['text', 'json'], default='text'
+                '--format', choices=['text', 'json'], default='json'
+            )
+            parser.add_argument(
+                '--output', '-o', type=str, default=None
             )
             parser.add_argument('--filter', type=str, default=None)
             parser.add_argument(
@@ -178,13 +185,22 @@ def format_keyword_info_text(keyword_name, keyword_info, show_category=True):
             param_name = getattr(param, 'name', str(param))
             param_mapping = getattr(param, 'mapping', '')
             param_desc = getattr(param, 'description', '')
+            param_default = getattr(param, 'default', None)
 
+            # 构建参数描述
+            param_info = []
             if param_mapping and param_mapping != param_name:
-                lines.append(
-                    f"    {param_name} ({param_mapping}): {param_desc}"
-                )
+                param_info.append(f"{param_name} ({param_mapping})")
             else:
-                lines.append(f"    {param_name}: {param_desc}")
+                param_info.append(param_name)
+            
+            param_info.append(f": {param_desc}")
+            
+            # 添加默认值信息
+            if param_default is not None:
+                param_info.append(f" (默认值: {param_default})")
+            
+            lines.append(f"    {''.join(param_info)}")
     else:
         lines.append("  参数: 无")
 
@@ -221,6 +237,12 @@ def format_keyword_info_json(keyword_name, keyword_info):
             'mapping': getattr(param, 'mapping', ''),
             'description': getattr(param, 'description', '')
         }
+        
+        # 添加默认值信息
+        param_default = getattr(param, 'default', None)
+        if param_default is not None:
+            param_data['default'] = param_default
+        
         keyword_data['parameters'].append(param_data)
 
     # 函数文档
@@ -231,8 +253,8 @@ def format_keyword_info_json(keyword_name, keyword_info):
     return keyword_data
 
 
-def list_keywords(output_format='text', name_filter=None,
-                  category_filter='all'):
+def list_keywords(output_format='json', name_filter=None,
+                  category_filter='all', output_file=None):
     """罗列所有关键字信息"""
     import json
 
@@ -319,7 +341,25 @@ def list_keywords(output_format='text', name_filter=None,
             keyword_data = format_keyword_info_json(name, info)
             keywords_data['keywords'].append(keyword_data)
 
-        print(json.dumps(keywords_data, ensure_ascii=False, indent=2))
+        json_output = json.dumps(keywords_data, ensure_ascii=False, indent=2)
+        
+        # 确定输出文件名
+        if output_file is None:
+            output_file = 'keywords.json'
+        
+        # 写入到文件
+        try:
+            with open(output_file, 'w', encoding='utf-8') as f:
+                f.write(json_output)
+            print(f"关键字信息已保存到文件: {output_file}")
+            print(f"共 {total_count} 个关键字")
+            for cat, count in category_counts.items():
+                cat_names = {'builtin': '内置', 'custom': '自定义', 'remote': '远程'}
+                print(f"  {cat_names.get(cat, cat)}: {count} 个")
+        except Exception as e:
+            print(f"保存文件失败: {e}")
+            # 如果写入文件失败，则回退到打印
+            print(json_output)
 
 
 def load_yaml_variables(args):
@@ -433,16 +473,19 @@ def main():
         list_keywords(
             output_format=args.format,
             name_filter=args.filter,
-            category_filter=args.category
+            category_filter=args.category,
+            output_file=args.output
         )
     elif args.command == 'run':
         run_dsl_tests(args)
     elif args.command == 'list-keywords-compat':
         # 向后兼容：旧的--list-keywords格式
+        output_file = getattr(args, 'output', None)
         list_keywords(
             output_format=args.format,
             name_filter=args.filter,
-            category_filter=args.category
+            category_filter=args.category,
+            output_file=output_file
         )
     elif args.command == 'run-compat':
         # 向后兼容：默认执行DSL测试
@@ -453,5 +496,38 @@ def main():
         sys.exit(1)
 
 
+def main_list_keywords():
+    """关键字列表命令的专用入口点"""
+    parser = argparse.ArgumentParser(description='查看pytest-dsl可用关键字列表')
+    parser.add_argument(
+        '--format', choices=['text', 'json'],
+        default='json',
+        help='输出格式：json(默认) 或 text'
+    )
+    parser.add_argument(
+        '--output', '-o', type=str, default=None,
+        help='输出文件路径（仅对 json 格式有效，默认为 keywords.json）'
+    )
+    parser.add_argument(
+        '--filter', type=str, default=None,
+        help='过滤关键字名称（支持部分匹配）'
+    )
+    parser.add_argument(
+        '--category',
+        choices=['builtin', 'custom', 'remote', 'all'],
+        default='all',
+        help='关键字类别：builtin(内置)、custom(自定义)、remote(远程)、all(全部，默认)'
+    )
+
+    args = parser.parse_args()
+
+    list_keywords(
+        output_format=args.format,
+        name_filter=args.filter,
+        category_filter=args.category,
+        output_file=args.output
+    )
+
+
 if __name__ == '__main__':
     main()

{pytest_dsl-0.9.0 → pytest_dsl-0.10.0}/pytest_dsl/core/keyword_manager.py

@@ -1,13 +1,14 @@
-from typing import Dict, Any, Callable, List
+from typing import Dict, Any, Callable, List, Optional
 import functools
 import allure
 
 
 class Parameter:
-    def __init__(self, name: str, mapping: str, description: str):
+    def __init__(self, name: str, mapping: str, description: str, default: Any = None):
         self.name = name
         self.mapping = mapping
         self.description = description
+        self.default = default
 
 
 class KeywordManager:
@@ -34,6 +35,7 @@ class KeywordManager:
 
             param_list = [Parameter(**p) for p in parameters]
             mapping = {p.name: p.mapping for p in param_list}
+            defaults = {p.mapping: p.default for p in param_list if p.default is not None}
             
             # 自动添加 step_name 到 mapping 中
             mapping["步骤名称"] = "step_name"
@@ -41,7 +43,8 @@ class KeywordManager:
             self._keywords[name] = {
                 'func': wrapper,
                 'mapping': mapping,
-                'parameters': param_list
+                'parameters': param_list,
+                'defaults': defaults  # 存储默认值
             }
             return wrapper
         return decorator
@@ -51,7 +54,19 @@ class KeywordManager:
         keyword_info = self._keywords.get(keyword_name)
         if not keyword_info:
             raise KeyError(f"未注册的关键字: {keyword_name}")
-        return keyword_info['func'](**params)
+        
+        # 应用默认值
+        final_params = {}
+        defaults = keyword_info.get('defaults', {})
+        
+        # 首先设置所有默认值
+        for param_key, default_value in defaults.items():
+            final_params[param_key] = default_value
+        
+        # 然后用传入的参数覆盖默认值
+        final_params.update(params)
+        
+        return keyword_info['func'](**final_params)
 
     def get_keyword_info(self, keyword_name: str) -> Dict:
         """获取关键字信息"""
@@ -99,8 +114,9 @@ class KeywordManager:
                     description="自定义的步骤名称，用于在报告中显示"
                 ))
             for param in info['parameters']:
+                default_info = f" (默认值: {param.default})" if param.default is not None else ""
                 docs.append(
-                    f"  {param.name} ({param.mapping}): {param.description}")
+                    f"  {param.name} ({param.mapping}): {param.description}{default_info}")
             docs.append("")
         return "\n".join(docs)
 

{pytest_dsl-0.9.0 → pytest_dsl-0.10.0}/pytest_dsl/keywords/assertion_keywords.py

@@ -48,7 +48,8 @@ def _compare_values(actual: Any, expected: Any, operator: str = "==") -> bool:
     Args:
         actual: 实际值
         expected: 预期值
-        operator: 比较运算符 (==, !=, >, <, >=, <=, contains, not_contains, matches, and, or, not)
+        operator: 比较运算符 (==, !=, >, <, >=, <=, contains, not_contains, 
+                 matches, and, or, not)
 
     Returns:
         比较结果 (True/False)
@@ -96,8 +97,9 @@ def _compare_values(actual: Any, expected: Any, operator: str = "==") -> bool:
 
 
 @keyword_manager.register('断言', [
-    {'name': '条件', 'mapping': 'condition', 'description': '断言条件表达式，例如: "${value} == 100" 或 "1 + 1 == 2"'},
-    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息'},
+    {'name': '条件', 'mapping': 'condition', 
+     'description': '断言条件表达式，例如: "${value} == 100" 或 "1 + 1 == 2"'},
+    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息', 'default': '断言失败'},
 ])
 def assert_condition(**kwargs):
     """执行表达式断言
@@ -116,9 +118,11 @@ def assert_condition(**kwargs):
     message = kwargs.get('message', '断言失败')
     context = kwargs.get('context')
 
-    # 简单解析表达式，支持 ==, !=, >, <, >=, <=, contains, not_contains, matches, in, and, or, not
+    # 简单解析表达式，支持 ==, !=, >, <, >=, <=, contains, not_contains, 
+    # matches, in, and, or, not
     # 格式: "left_value operator right_value" 或 "boolean_expression"
-    operators = ["==", "!=", ">", "<", ">=", "<=", "contains", "not_contains", "matches", "in", "and", "or", "not"]
+    operators = ["==", "!=", ">", "<", ">=", "<=", "contains", "not_contains", 
+                 "matches", "in", "and", "or", "not"]
 
     # 先检查是否包含这些操作符
     operator_used = None
@@ -132,7 +136,8 @@ def assert_condition(**kwargs):
         try:
             # 对条件进行变量替换
             if '${' in condition:
-                condition = context.executor.variable_replacer.replace_in_string(condition)
+                condition = context.executor.variable_replacer.replace_in_string(
+                    condition)
             # 尝试直接求值
             result = eval(condition)
             if not isinstance(result, bool):
@@ -141,7 +146,8 @@ def assert_condition(**kwargs):
                 raise AssertionError(f"{message}. 布尔表达式求值为假: {condition}")
             return True
         except Exception as e:
-            raise AssertionError(f"{message}. 无法解析条件表达式: {condition}. 错误: {str(e)}")
+            raise AssertionError(
+                f"{message}. 无法解析条件表达式: {condition}. 错误: {str(e)}")
 
     # 解析左值和右值
     left_value, right_value = condition.split(f" {operator_used} ", 1)
@@ -351,8 +357,8 @@ def assert_condition(**kwargs):
     {'name': 'JSON数据', 'mapping': 'json_data', 'description': 'JSON数据（字符串或对象）'},
     {'name': 'JSONPath', 'mapping': 'jsonpath', 'description': 'JSONPath表达式'},
     {'name': '预期值', 'mapping': 'expected_value', 'description': '预期的值'},
-    {'name': '操作符', 'mapping': 'operator', 'description': '比较操作符，默认为"=="'},
-    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息'},
+    {'name': '操作符', 'mapping': 'operator', 'description': '比较操作符', 'default': '=='},
+    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息', 'default': 'JSON断言失败'},
 ])
 def assert_json(**kwargs):
     """执行JSON断言
@@ -476,7 +482,7 @@ def extract_json(**kwargs):
 @keyword_manager.register('类型断言', [
     {'name': '值', 'mapping': 'value', 'description': '要检查的值'},
     {'name': '类型', 'mapping': 'type', 'description': '预期的类型 (string, number, boolean, list, object, null)'},
-    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息'},
+    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息', 'default': '类型断言失败'},
 ])
 def assert_type(**kwargs):
     """断言值的类型
@@ -545,8 +551,8 @@ def assert_type(**kwargs):
 @keyword_manager.register('数据比较', [
     {'name': '实际值', 'mapping': 'actual', 'description': '实际值'},
     {'name': '预期值', 'mapping': 'expected', 'description': '预期值'},
-    {'name': '操作符', 'mapping': 'operator', 'description': '比较操作符，默认为"=="'},
-    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息'},
+    {'name': '操作符', 'mapping': 'operator', 'description': '比较操作符', 'default': '=='},
+    {'name': '消息', 'mapping': 'message', 'description': '断言失败时的错误消息', 'default': '数据比较失败'},
 ])
 def compare_values(**kwargs):
     """比较两个值