当前位置：首页 > news >正文

Pytest-Bdd-Playwright 系列教程（14）：Docstring 参数

news 来源：原创 2025/6/28 4:02:17

Pytest-Bdd-Playwright 系列教程（14）：Docstring 参数

前言
一、什么是docstring?
二、基本语法
三、主要特点
四、实际例子
五、注意事项
六、使用建议
总结

前言

在自动化测试的过程中，我们经常需要处理复杂的测试数据或需要输入多行文本。Pytest-Bdd
提供了一种解决方案——Docstring 参数，它能够有效地解决这些问题；
Docstring 参数允许在 Gherkin 语法的步骤中嵌入多行文本，这在多种测试场景下都非常有用，包括但不限于复杂业务规则的描述、长文本输入的测试、详细测试步骤的记录、复杂预期结果与API 响应内容的验证以及文本内容的比对等。

一、什么是docstring?

在 Python 中，Docstring 是指位于函数、模块或类定义开头的字符串，通常用于描述其用途和参数等信息。而在 Pytest-BDD 中，Docstring 被赋予了新的含义，它是指在 Gherkin 步骤中定义的多行文本，这些文本使用三重引号 (“”") 来包围。这种特性使得测试编写者能够在测试步骤中直接嵌入大量文本数据，而无需通过外部文件加载或硬编码的方式。

二、基本语法

在 Pytest-BDD 中使用 Docstring 的基本语法如下所示：

When 这是一个简单的docstring:"""这是一个测试文本包含两行内容"""

上述示例中，When 关键字后面的步骤定义了一个 Docstring，其中包含了两行文本。这些文本将作为一个整体传递给相应的步骤函数。

三、主要特点

单个字符串传递：无论 Docstring 包含多少行文本，它都会作为一个单个的字符串传递给步骤函数；
多行支持：多行文本之间通过换行符 \n 分隔；
自动处理缩进：Pytest-BDD 会自动移除 Docstring 内部的前导缩进，确保文本格式的一致性；
专属性质：只有在定义了 Docstring 的步骤中，才能使用 Docstring 参数。

四、实际例子

# features/docstring_demo.feature
Feature: 文档字符串演示Scenario: 带有docstring的场景Given 准备测试docstringWhen 这是一个简单的docstring:"""这是一个测试文本包含两行内容"""

# tests/test_docstring_demo.py
from functools import partial
from pytest_bdd import given, when, parsers, scenarioscenario = partial(scenario, 'docstring_demo.feature')@scenario('带有docstring的场景')
def test_docstring_demo():pass@given('准备测试docstring')
def _():pass@when(parsers.parse('这是一个简单的docstring:\n{docstring}'))
def step_with_docstring(docstring):# docstring参数将包含完整的文档字符串内容assert docstring == "这是一个测试文本\n包含两行内容"

运行命令：

pytest ./tests/test_docstring_demo.py

运行结果如下：

在这里插入图片描述

五、注意事项

如果步骤没有定义docstring但在函数中使用了docstring参数，会抛出错误。
docstring的缩进会被自动处理，例如：

Then 步骤
"""即使有缩进也会被去除
"""

实际得到的字符串会是：“即使有缩进\n也会被去除”

六、使用建议

长文本数据：当需要传递较长的测试数据时，使用 Docstring 可以使代码更加简洁和易读；
多行文本内容：适合用于测试多行文本内容，如日志文件、配置文件等；
复杂输出结果：可以用于验证复杂的输出结果，特别是当输出结果包含多行文本或结构化数据时；
API 响应验证：在测试 API 接口时，使用 Docstring 可以方便地定义和验证复杂的 JSON 响应。

总结

通过合理使用 Docstring 参数，我们可以更好地组织和管理 BDD 测试用例，使测试代码更加清晰和专业。在实际项目中，建议根据具体需求灵活运用这一功能，以提升自动化测试的效率和可维护性。

Pytest-Bdd-Playwright 系列教程（14）：Docstring 参数

Pytest-Bdd-Playwright 系列教程（14）：Docstring 参数前言一、什么是docstring?二、基本语法三、主要特点四、实际例子五、注意事项六、使用建议总结前言在自动化测试的过程中，我们经常需要处理复杂的测试数据或需要输入多行文…...

编程日记 2025/6/28 4:02:17

Docker部署WebRTC-Streamer

文章目录 WebRTC-Streamer概述Docker部署WebRTC-StreamerVue使用WebRTC-Streamer一些问题 WebRTC-Streamer概述 WebRTC-Streamer是一个基于WebRTC技术的流媒体传输工具，它可以通过Web浏览器实现实时音视频流的传输和播放。它提供了一种简单而强大的方式&#xff…...

编程日记 2025/6/28 3:32:11

linux-16 关于shell（十五）date，clock，hwclock，man，时间管理，命令帮助

想显示一下当前系统上的时间该怎么显示？有一个命令叫做date，来看date命令，如下图， 第一个星期几对吧？然后是月日小时分钟秒，最后一个是年对吧？CST指的是它的时间格式，我这个可以先姑…...

编程日记 2025/6/28 3:44:35

厦门凯酷全科技有限公司深耕抖音电商运营

在数字经济飞速发展的今天，抖音电商平台以其独特的社交属性和庞大的用户基础，迅速成为众多品牌和商家的新战场。在这个充满机遇与挑战的市场中，厦门凯酷全科技有限公司凭借其专业的服务、创新的理念和卓越的执行力，成为了抖音电商…...

编程日记 2025/6/28 3:48:18

C++多线程实战：掌握图像处理高级技巧

文章结尾有最新热度的文章，感兴趣的可以去看看。本文是经过严格查阅相关权威文献和资料，形成的专业的可靠的内容。全文数据都有据可依，可回溯。特别申明：数据和资料已获得授权。本文内容，不涉及任何偏颇观点，用中立态度客观事实描述事情本身导读在当今的计算世界中，…...

编程日记 2025/6/28 3:26:07

上回书说到了： 3、RULES/COMPONENTS/MASSING/SUBURBAN_BLOCK DETACHED_HOUSES.CGA ROWHOUSES.CGA SEMI_DETACHED_HOUSES.CGA 4、RULES/COMPONENTS/MASSING/URBAN_BLOCK MONOBLOCK.CGA PERIMETER_8_SHAPE.CGA PERIMETER_MULTIPART.CGA 这个cga挺有意思&#xff0c…...

编程日记 2025/6/22 20:19:46

【人工智能】因果推断与数据分析：用Python探索数据间的因果关系

解锁Python编程的无限可能：《奇妙的Python》带你漫游代码世界因果推断是数据科学领域的一个重要方向，旨在发现变量间的因果关系，而不仅仅是相关性。本篇文章将从因果推断的理论基础出发，介绍因果关系的定义与建模方法，涵盖因果图（Causal Graph）、d-分离、反事实估计等…...

编程日记 2025/6/28 2:38:41

depth wisepoint wise

文章目录 1. Description2. code 1. Description point wise 1. function: for the separated pixel without pixel confusion 2. kernel size : 3x3 ,star matrix [[0,0,0],[0,1,0],[0,0,0]] depth wise 1. fuction: for the separated channel without channel confusion 2.…...

编程日记 2025/6/28 2:34:29

AI大模型学习笔记｜神经网络与注意力机制（逐行解读）

来源分享链接：通过网盘分享的文件：详解神经网络是如何训练的链接: https://pan.baidu.com/s/12EF7y0vJfH5x6X-0QEVezg 提取码: k924 内容摘要：本文深入探讨了神经网络与注意力机制的基础，以及神经网络参数训练的过程。以鸢尾花数…...

编程日记 2025/6/28 2:31:53

2025软考中级《数据库系统工程师》案例模拟题合集

1.【说明】某销售企业正在实施电商平台项目，主要功能模块包括用户中心、商品中心、交易中心、支付中心、营销中心等。其中支付中心模块包括了一个账户表：Account (ano, aname, balance)，其中属性含义分别为：账户号，账户…...

编程日记 2025/6/28 3:29:07

12.10深度学习_经典神经网络_GoogleNet自我理解

为了更清晰地展示 GoogLeNet 中每个卷积层及其相关参数，我们可以将这些信息整理成表格形式。这不仅有助于理解每一层的输入和输出尺寸，还能直观地看到卷积核的数量、大小、步长以及填充方式等关键参数。以下是 GoogLeNet 前几层（包括两个卷积…...

编程日记 2025/6/28 3:52:48

CTFshow-命令执行(Web58-77)

CTFshow-命令执行(Web58-77) Web58 <?php if(isset($_POST[c])){$c $_POST[c];eval($c); }else{highlight_file(__FILE__); }Warning: system() has been disabled for security reasons in /var/www/html/index.php(17) : eval()d code on line 1 本题对于passthru&…...

编程日记 2025/6/28 3:27:45

android全局拖拽效果实现startDragAndDrop

有多种方式实现全角拖拽，我们基于系统标准的api startDragAndDrop 来做介绍实现步骤： 一、应用的的拖拽 1.1 通过长按触发 holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {Overridepublic boolean onLongClick(View v) {C…...

编程日记 2025/6/28 2:53:29

MySQL之索引与事务

一、索引索引是一种特殊的文件，包含着对数据表里所有记录的引用指针。可以对表中的一列或多列创建索引，并指定索引的类型，各类索引有各自的数据结构实现。索引主要的目的是为了加快查找速度作用 1、数据库中的表、数据、索引之间的关系&am…...

编程日记 2025/6/28 2:33:02

【OpenCV】基于分水岭算法的图像分割

介绍分水岭算法（Watershed Algorithm）是一种基于形态学的图像分割方法，它模仿了地理学中的分水岭概念。在图像处理中，分水岭算法通过模拟水流从山顶流向谷底的过程来分割图像，其中局部极小值点被视为“山谷”&#x…...

编程日记 2025/6/28 2:46:46

深度学习：CPU和GPU算力

一、算力 “算力”（Computing Power）通常是指计算机或计算系统执行计算任务的能力。它是衡量系统处理数据、运行算法以及执行计算任务效率的重要指标。根据上下文，算力可以在以下几种场景中具体化： 1. 单机算力 CPU算力&#x…...

编程日记 2025/6/28 3:35:30

android studio 模拟器不能联网？

模拟器路径： C:\Users\Administrator\AppData\Local\Android\Sdk\emulator\emulator.exe.关闭所有AVD设备实例导航至： C:\Users\userName\AppData\Local\Android\Sdk\emulator查看模拟器名称 AdministratorDESKTOP-6JB1OGC MINGW64 ~/AppData/Local/…...

编程日记 2025/6/28 3:12:24

php.ini 文件上传/执行时间/部分配置新手教程

1、上传文件大小配置一般需要同时配置“upload_max_filesize”、“post_max_size”，配置格式如下： file_uploads On ;是否允许HTTP文件上传 upload_max_filesize 2M ;设置单个文件上传的最大尺寸 post_max_size 8M ;设置 POST 请求体的最大尺寸&am…...

编程日记 2025/6/25 23:28:47

大模型Qwen面试内容整理-应用场景与案例分析

Qwen模型凭借其强大的自然语言理解和生成能力，在多个实际应用场景中得到了广泛应用。以下是Qwen模型的主要应用场景及一些典型的案例分析，展示了它如何解决具体问题和带来实际价值。智能对话系统 ● 应用场景 ○ 客服机器人：Qwen被用于开发智能客服机器人，能够理解客户的问…...

编程日记 2025/6/28 3:22:45

网易游戏分享游戏场景中MongoDB运行和分析实践

在游戏行业中，数据库的稳定和性能直接影响了游戏质量和用户满意度。在竞争激烈的游戏市场中，一个优秀的数据库产品无疑能为游戏的开发和后期的运营奠定良好的基础。伴随着MongoDB在不同类型游戏场景中的应用越来越广泛，许多知名的游戏公司都在…...

编程日记 2025/6/22 5:24:56

子查询与嵌套查询

title: 子查询与嵌套查询 date: 2024/12/13 updated: 2024/12/13 author: cmdragon excerpt: 子查询和嵌套查询是关系型数据库中强大的查询工具，允许用户在一个查询的结果中再进行查询。通过使用子查询，用户能够简化复杂的SQL语句，增强查询的灵活性和可读性。本节将探讨子…...

编程日记 2025/6/28 3:03:37

智星云技术文档：GPU测速教程

安装gpu burn git clone https://github.com/wilicc/gpu-burn cd gpu-burn/ make测试 ./gpu_burn 60100.0% procd: 14280 (7373 Gflop/s) - 13390 (6997 Gflop/s) - 15912 (7110 Gflop/s) - 13184 (7055 Gflop/s) - 13464 (7369 Gflop/s) - 13974 (7351 Gflop/s) - 16626 (7…...

编程日记 2025/6/28 3:24:34

（二）多智能体强化学习

目录前言一、多智能体强化学习的概念二、多智能体面临的问题三、现有算法简介总结前言基于上一篇文章对于强化学习基础概念的介绍，本篇文章针对多智能体强化学习进行介绍和总结，帮助大家了解多智能体的基本概念以及算法，方便大家…...

编程日记 2025/6/23 21:06:53

Unity屏幕截图、区域截图、读取图片、WebGL长截屏并下载到本地jpg

Unity屏幕截图、区域截图、读取图片、WebGL长截屏并下载到本地jpg 一、全屏截图并保存到StreamingAssets路径下 Texture2D screenShot;//保存截取的纹理public Image image; //显示截屏的Imagepublic void Jietu(){StartCoroutine(ScrrenCapture(new Rect(0, 0, Screen.width…...

编程日记 2025/6/22 14:12:39

linux中给某个文件切换成www用户

要将某个文件的拥有者切换为 www 用户（通常是用于 Web 服务的用户），你可以使用 chown 命令来更改文件的所有者和所属组。以下是相关步骤： ### 1. 确认 www 用户存在首先确认 www 用户已经存在。可以使用以下命令检查&#xff1a…...

编程日记 2025/6/26 1:22:11

运维实战：K8s 上的 Doris 高可用集群最佳实践

今天我们将深入探讨：：如何在 K8s 集群上部署 Compute storage coupled（存算耦合） 模式的 Doris 高可用集群？ 本文，我将为您提供一份全面的实战指南，逐步引导您完成以下关键任务： 配…...

编程日记 2025/6/25 23:10:30

家庭网络防御系统搭建-将EDR系统的sysmon和Windows event log集成到security onion

在前面的文章中安装了sysmon,这里，安装了securityonion，这里，本文讲述如何将sysmon以及Windows生成的event log发送到siem security onion之中，供后续的分析，威胁狩猎之用。通常日志集成的步骤分为如下几步&#xff1…...

编程日记 2025/6/23 9:04:01

Ubuntu boot-repair安装过程

本教程只是在UBuntu系统无法引导才使用的方法，有可能需要提前使用U盘刻录UBuntu镜像去引导。假如winUBuntu双系统，找不到紫色的UBuntu界面了，请参考：windows10ubuntu双系统开机引导界面不见的解决办法_双系统不出现引导界面-CSD…...

编程日记 2025/6/26 16:45:09

图计算之科普：BSP计算模型、Pregel计算模型、

一、BSP计算模型 BSP计算模型，即整体同步并行计算模型（Bulk Synchronous Parallel Computing Model），又名大同步模型或BSP模型，是由哈佛大学L.G. Valiant教授（2010年图灵奖得主）在1992年提出的…...

编程日记 2025/6/27 15:32:04

Kafka Stream实战教程

Kafka Stream实战教程 1. Kafka Streams 基础入门 1.1 什么是 Kafka Streams Kafka Streams 是 Kafka 生态中用于处理实时流数据的一款轻量级流处理库。它利用 Kafka 作为数据来源和数据输出，可以让开发者轻松地对实时数据进行处理，比如计数、聚合、…...

编程日记 2025/6/24 1:37:02

数据仓库-基于角色的权限管理(RBAC)

什么是基于角色的用户管理？ 基于角色的用户管理(Role-Based Access Control，简称RBAC)是通过为角色赋予权限，用户通过成为适当的角色而得到这些角色的权限。角色是一组权限的抽象。使用RBAC可以极大简化对权限的管理。什么是RBAC模型&…...

编程日记 2025/6/24 14:19:05

如何使用ERC404协议

ERC404 ERC404协议的性质 ERC404不是一个开发代码工具包，而是一种智能合约标准规范。它就像是一份蓝图或者规则手册，规定了在以太坊区块链上开发特定智能合约应该遵循的接口、函数和事件等规则。如何使用ERC404协议定义合约接口首先，在开发智能合约时，要根据ERC404标准定…...

编程日记 2025/5/21 14:55:33

Spring Boot 工程分层实战（五个分层维度）

1、分层思想计算机领域有一句话：计算机中任何问题都可通过增加一个虚拟层解决。这句体现了分层思想重要性，分层思想同样适用于Java工程架构。分层优点是每层只专注本层工作，可以类比设计模式单一职责原则，或者经济学比较优势原…...

编程日记 2025/6/27 5:56:21

IIS部署程序https是访问出现403或ERR_HTTP2_PROTOCOL_ERROR

一、说明在windows server 2016中的IIS程序池里部署一套系统，通过https访问站点，同时考虑到安全问题以及防攻击等行为，就用上了WAF云盾功能，能有效的抵挡部分攻击，加强网站的安全性和健壮性。应用系统一直能够正常…...

编程日记 2025/6/26 16:10:33

【深度学习入门】深度学习介绍

1.1 深度学习介绍学习目标目标知道深度学习与机器学习的区别了解神经网络的结构组成知道深度学习效果特点应用无区别特征提取方面机器学习的特征工程步骤是要靠手动完成的，而且需要大量领域专业知识深度学习通常由多个层组成，它们通常将更简…...

编程日记 2025/6/27 11:52:56

node_modules文件夹删除失败解决办法

在前端开发过程中，node_modules 文件夹是一个必不可少的组成部分，里面存放着项目所需的各种依赖包。然而，随着项目的发展，node_modules 文件夹可能会变得异常庞大，甚至有时需要删除它来解决一些依赖冲突或清理空间。但…...

编程日记 2025/6/25 22:41:23

360智脑张向征：共建可信可控AI生态应对大模型安全挑战

发布 | 大力财经人工智能的加速发展，有力推动了社会的数智化转型；与此同时，带来的相关安全风险也日益凸显。近日，在北京市举办的通明湖人工智能开发与应用大会上，360智脑总裁张向征以“大模型安全研究与实践”为主题&…...

编程日记 2025/6/27 10:20:20

adb 常用命令笔记

adb connect <ip> #连接指定ip adb disconnect <ip> #断开连接指定ip adb devices #查看连接中的设备 adb install <flie> #安装apk adb uninstall <packageName> #卸载app adb -s install <flie> #指定设备安装 adb shell pm list package…...

编程日记 2025/6/22 17:31:49

uniapp中打包应用后，组件在微信小程序和其他平台实现不同的样式

今天，我们来介绍一下，uniapp中如何实现打包应用后，组件在微信小程序和其他平台不同的样式，在这里，我们使用背景颜色进行演示，使用 UniApp 提供的 uni.getSystemInfoSync() 方法来获取系统信息，包…...

编程日记 2025/6/27 22:48:11

代码随想录算法训练营第三天 | 链表理论基础 | 206.反转链表

从老链表第一个元素开始，逐个取出第一个取出的元素，让其next指向nullptr。由于改变其指向，会导致后续链表没有指向消失，所以要在这步之前将其后续元素的指向放在一个新变量中再将后续结点的指向当前结点，不断反复运行…...

编程日记 2025/6/24 8:04:58

《数据结构》（非408代码题）

链表设单链表的表头指针为L，结点结构由data和next两个域构成，其中data域为字符型。试设计算法判断该链表的全部n个字符是否中心对称。例如xyx、xyyx都是中心对称。分析： 这题完全可以参考19年那题，我们直接找到中间结点然后将后…...

编程日记 2025/6/25 15:31:39

springboot427民航网上订票系统设计和实现(论文+源码)_kaic

摘要传统办法管理信息首先需要花费的时间比较多，其次数据出错率比较高，而且对错误的数据进行更改也比较困难，最后，检索数据费事费力。因此，在计算机上安装民航网上订票系统软件来发挥其高效地信息处理的作用&#x…...

编程日记 2025/6/23 18:02:07

UE4_控件蓝图_制作3D生命血条

一：效果图如下： 二、实现步骤： 1、新建敌人右键蓝图类选择角色， 重命名为BP_Enemytest。双击打开，配置敌人网格体修改位置及朝向效果如下： 选择合适的动画蓝图类： 人物就有了动作&#x…...

编程日记 2025/6/26 8:19:35

欧拉计划 Project Euler 21题解

欧拉计划21 Project Euler Problem21题干亲和数约数和的计算定义对于任何素数 $ p $:考虑 p a p^a pa:示例可乘性回到示例 Project Euler Problem21 题干亲和数记 d ( n ) d(n) d(n) 为 n 的所有真约数(小于 n 且整除 n 的正整数)之和。如果 d(a) b , d(b) a &…...

编程日记 2025/6/25 10:06:16

python中的Counter函数

在 Python 中，Counter 是 collections 模块中的一个类，用于统计可迭代对象中元素的出现次数，并以字典的形式返回，键为元素，值为对应的计数。它非常适合处理频率统计问题。用之前必须先导入 from collections import…...

编程日记 2025/6/22 18:27:40

WPF+MVVM案例实战与特效（三十七）- 实现带有水印和圆角的自定义 TextBox 控件

文章目录 1、概述2、案例实现1、基本功能2、代码实现3、控件应用4、案例效果5、源代码下载4、总结1、概述在开发用户界面时，TextBox 是最常见的输入控件之一。为了提升用户体验，我们经常需要为 TextBox 添加一些额外的功能，例如显示提示文本（水印）和设置圆角边框。本文将…...

编程日记 2025/6/25 5:22:05

SQLServer到MySQL的数据高效迁移方案分享

SQL Server数据集成到MySQL的技术案例分享在企业级数据管理中，跨平台的数据集成是一个常见且关键的任务。本次我们将探讨如何通过轻易云数据集成平台，将巨益OMS系统中的退款单明细表从SQL Server高效、安全地迁移到MySQL数据库中。具体方案名称为“7--…...

编程日记 2025/6/24 7:34:32

docker快速实现ELK的安装和使用

目录一、ELK功能原理二、项目功能展示三、日志查询展示四、ELK安装步骤 1、创建elasticsearch、kibana、filebeat相关data、log、conf目录 2、进入/usr/local/elk目录，并创建一个docker网络 3、启动 elasticsearch容器 4、运行kibana容器 5、启动f…...

编程日记 2025/6/27 21:08:30

hbase读写操作后hdfs内存占用太大的问题

hbase读写操作后hdfs内存占用太大的问题查看内存信息hbase读写操作查看内存信息查看本地磁盘的内存信息 df -h查看hdfs上根目录下各个文件的内存大小 hdfs dfs -du -h /查看hdfs上/hbase目录下各个文件的内存大小 hdfs dfs -du -h /hbase查看hdfs上/hbase/oldWALs目录下…...

编程日记 2025/6/23 6:33:53

解决vue2中更新列表数据，页面dom没有重新渲染的问题

在 Vue 2 中，直接修改数组的某个项可能不会触发视图的更新。这是因为 Vue 不能检测到数组的索引变化或对象属性的直接赋值。为了确保 Vue 能够正确地响应数据变化，你可以使用以下几种方法： 1. 使用 Vue.set() 使用 Vue.set() 方法可以确保 …...

编程日记 2025/6/26 1:15:38

Pytest-Bdd-Playwright 系列教程（14）：Docstring 参数

前言

一、什么是docstring?

二、基本语法

三、主要特点

四、实际例子

五、注意事项

六、使用建议

总结

相关文章：