pytest-pystack

pytest插件，用于轻松将PyStack集成到您的测试套件中。

它可以用于自动转储套件中挂起的测试的堆栈跟踪。

有关工具的更多信息，请参阅PyStack。

安装

要安装 PyStack pytest 插件，只需在您的 venv 中运行以下命令：

python -m pip install pytest-pystack

快速入门

安装 pytest 插件后，您可以通过运行 pytest 并带有参数 --pystack-threshold=5 来让 PyStack 监控您的测试套件，如果测试耗时超过 5 秒，则会输出堆栈跟踪。

配置

PyStack 插件可以通过以下选项通过命令行进行配置：

• --pystack-threshold：启用插件并监控所有测试，如果测试耗时超过指定的阈值则生成堆栈跟踪。注意，这并不会在指定阈值后停止或失败测试用例。
• --pystack-output-file：将 PyStack 输出追加到文件中。
• --pystack-path：指向 pystack 可执行文件的路径。
• --pystack-args：传递给 pystack remote <pid> 的额外参数，例如 --native 或 --native-all。

并且通过任何 pytest 配置文件，例如 pyproject.toml 的示例

[tool.pytest.ini_options]
pystack_threshold=60
pystack_path="custom-version-of-pystack"
pystack_output_file="./pystack.log"
pystack_args="--native"

许可证

本项目采用 Apache-2.0 许可证，如 LICENSE 文件所示。

行为准则

• 行为准则

本项目已采用行为准则。如果您对行为准则或在此项目中遇到的行为有任何疑问，请通过 opensource@bloomberg.net 联系我们。

贡献

我们欢迎您的贡献，以帮助我们改进和扩展此项目！

以下是一些基本步骤，您需要遵循这些步骤才能为项目做出贡献。如果您对此过程或向彭博开源项目做出贡献的任何其他方面有任何疑问，请随时通过 opensource@bloomberg.net 发送电子邮件，我们会尽快解答您的问题。

贡献许可

由于本项目是根据开源许可证分发的，因此您所做的贡献也受相同的许可证条款约束。为了我们能接受您的贡献，我们需要您明确确认您能够并且愿意根据这些条款提供它们，我们用于此的机制称为开发者原创证书 (DCO)。这与 Linux 内核、Samba 和许多其他主要开源项目使用的流程类似。

为了根据这些条款参与，您必须做的只是在每个贡献的提交消息的最后包含一行，例如以下内容：

Signed-Off-By: Random J. Developer <random@developer.example.org>

实现这一点的最简单方法是在您的 git commit 命令中添加 -s 或 --signoff。

您必须使用您的真实姓名（抱歉，不接受化名，也不接受匿名贡献）。

步骤

• 创建一个 Issue，选择 '功能请求'，并说明您提出的更改。
• 遵循您提供的 Issue 模板中的指南。
• 提交 Issue。
• 提交一个 Pull Request，并在 Pull Request 摘要中包含 "#" 以将其链接到 Issue。