pytest-dsl 0.9.1__tar.gz → 0.11.0__tar.gz

{pytest_dsl-0.9.1 → pytest_dsl-0.11.0}/MANIFEST.in

@@ -5,6 +5,7 @@ include MANIFEST.in
 
 recursive-include pytest_dsl/examples *.auto *.csv *.yaml *.yml
 recursive-include pytest_dsl/docs *.md *.rst *.txt *.png *.jpg
+recursive-include pytest_dsl/templates *.html
 recursive-include tests *.py *.auto *.csv *.yaml *.yml
 
 prune .venv

{pytest_dsl-0.9.1/pytest_dsl.egg-info → pytest_dsl-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytest-dsl
-Version: 0.9.1
+Version: 0.11.0
 Summary: A DSL testing framework based on pytest
 Author: Chen Shuanglin
 License: MIT
@@ -27,6 +27,7 @@ Requires-Dist: requests>=2.28.0
 Requires-Dist: lxml>=4.9.0
 Requires-Dist: jsonschema>=4.17.0
 Requires-Dist: pytz>=2023.3
+Requires-Dist: Jinja2>=3.0.0
 Dynamic: license-file
 
 # pytest-dsl: 强大的关键字驱动测试自动化框架
@@ -42,11 +43,12 @@ pytest-dsl是一个革命性的关键字驱动测试框架，基于pytest构建
 ## ✨ 核心特性
 
 - 🎯 **门槛上手低** - 自然语言风格，只需少量编程基础
-- 🔧 **高度可扩展** - 轻松创建自定义关键字
+- 🔧 **高度可扩展** - 轻松创建自定义关键字，支持参数默认值
 - 🌐 **分布式执行** - 支持远程关键字调用
 - 🔄 **无缝集成** - 完美兼容pytest生态
 - 📊 **丰富报告** - 集成Allure测试报告
 - 🛡️ **企业级** - 支持变量管理、环境隔离
+- ⚡ **智能简化** - 参数默认值让DSL更加简洁易读
 
 ## 🚀 5分钟快速开始
 
@@ -850,17 +852,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 +878,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 +1102,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 +1137,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.1 → pytest_dsl-0.11.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.1 → pytest_dsl-0.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytest-dsl"
-version = "0.9.1"
+version = "0.11.0"
 description = "A DSL testing framework based on pytest"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -33,6 +33,7 @@ dependencies = [
     "lxml>=4.9.0",
     "jsonschema>=4.17.0",
     "pytz>=2023.3",
+    "Jinja2>=3.0.0",
 ]
 
 [project.entry-points.pytest11]