pytest-random-order 1.1.1

桶类型选择

最好从最小的桶类型（class或module，取决于您是否有基于类的测试）开始，当您确信您的测试可以处理它时再切换到更大的桶类型。

如果您的测试依赖于模块或会话作用域的设置，更多的测试随机顺序将意味着测试速度变慢。在编码时，您可能不想在global或package级别进行随机化，而需要快速确认没有出现重大问题。

在模块或类中禁用洗牌

您可以通过标记模块或类为random_order并传递disabled=True来禁用单个模块或类内测试的洗牌。

pytestmark = pytest.mark.random_order(disabled=True)

def test_number_one():
    assert True

def test_number_two():
    assert True

class MyTest(TestCase):
    pytestmark = pytest.mark.random_order(disabled=True)

    def test_number_one(self):
        self.assertTrue(True)

无论测试运行的桶类型如何，test_number_one都将始终在test_number_two之前运行。

按相同顺序重新运行测试（相同种子）

如果您发现测试失败是因为您重新排列了测试，您可能希望能够按相同的失败顺序重新运行测试。为了允许重现测试顺序，插件会报告它用于伪随机数生成器的种子值。

============================= test session starts ==============================
..
Using --random-order-bucket=module
Using --random-order-seed=24775
...

现在，您可以使用--random-order-seed=...作为下一次运行的参数来产生相同的顺序。

$ pytest -v --random-order-seed=24775

首先运行上次失败的测试

从v0.8.0开始，pytest缓存插件的--failed-first标志已支持——上次运行中失败的测试将在通过洗牌桶类型之前运行。

禁用插件

如果插件表现不佳或您只想确保它不是导致您的测试失败或不应该通过的原因，您可以禁用它。

$ pytest -p no:random_order

请注意，默认情况下禁用随机化。通过传递-p no:random_order，您将停止插件注册，因此它的钩子不会注册，其命令行选项也不会出现在--help中。

v1.1.1 (2024-01-20)

• 修复了#54 - 在禁用cacheprovider插件时出现AttributeError。感谢@jhanm12。

v1.1.0 (2022-12-03)

• 修复了xdist支持（感谢@matejsp）。

v1.0.4 (2018-11-30)

• 修复了在#36中报告的doctests问题 - class、package和module未工作，因为DoctestItem没有cls或module属性。感谢@tobywf。

• 弃用none桶类型。

• 使用tox运行pytest-random-order的测试，包括pytest 3和4。

v1.0.3 (2018-11-16)

• 修复了与pytest 4.0.0的兼容性问题，如先前一样与pytest 3.0+兼容。

• 源分布中包含测试。

v1.0.0 (2018-10-20)

• 插件默认不再更改测试顺序。您必须执行以下操作之一：1) 传递 --random-order，或 --random-order-bucket=<bucket>，或 --random-order-seed=<seed>，或 2) 编辑您的 pytest 配置文件，并在 addopts 下添加这些选项之一，或 3) 在环境变量 PYTEST_ADDOPTS 中指定这些标志。

• 需要 Python 3.5+。如果您想使用此插件与 Python 2.7 一起使用，请使用稳定的 v0.8.0 版本，如果您对默认随机化测试顺序满意，则这是一个很好的选择。

• 插件注册的名称已从 random-order（连字符）更改为 random_order（下划线）。这解决了通过标准 -p 标志禁用或启用此插件时的一致性问题。以前，可以通过传递 -p no:random-order 来禁用插件，但只能通过传递 -p pytest_random_order.plugin 来重新启用。现在，它们是 -p no:random_order 来禁用和 -p random_order.plugin 来启用（我认为 .plugin 部分，因为 pytest 可能认为它与 random_order 无关，并导入它，而没有它就是同一件事，所以不导入它））。

v0.8.0

• pytest 缓存插件的 --failed-first 现在正常工作。