testtube 1.1.0

fromtesttube.helpersimportFrosted,Nosetests,Pep257,Flake8PATTERNS=(# Run pep257 check against a file if it changes, excluding files that have# test_ or tube.py in the name.# If this test fails, don't make any noise (0 bells on failure)(r'((?!test_)(?!tube\.py).)*\.py$',[Pep257(bells=0)]),# Run flake8 and Frosted on the entire project when a python file changes.# If these checks fail, abort the entire test suite because failure might# be due to a syntax error. There's no point running the subsequent tests# if there is such an error.(r'.*\.py$',[Flake8(all_files=True),Frosted(all_files=True)],{'fail_fast':True}),# Run the test suite whenever python or test config files change.(r'(.*setup\.cfg$)|(.*\.coveragerc)|(.*\.py$)',[Nosetests()]))# Don't process any file changes that match these rulesIGNORE_PATTERNS=(r'.*sample/[^/]*$',)

testtube附带了许多这样的助手，可以在 帮助程序.py 。 它们的目的是避免用户指定自己的测试 是可能的。如果它们不足以用于特定项目，请参见 编写自定义测试

包括助手：

• PEP8
• 松饼
• 磨砂
• PEP257
• 鼻测试
• pythonsetuppytest（匹配文件更改时运行python setup.py）
• 清除屏幕（清除屏幕）

帮助程序在实例化时通常接受以下参数：

• 所有文件 ：对整个源目录运行测试 而不仅仅是更改的文件（这是默认行为）
• 快速失败 ：如果测试 失败。
• 铃铛 ：失败时，试管将听到3次通知用户的声音 除非另有规定
• 名称 ：th的名称e测试报告输出中的测试

下面生成一个pep8测试，配置为对所有文件运行， 失败时中止对其测试组的处理，警告用户5次 可以听到，并在测试报告输出中显示为"follow pep8 dude"：

fromtesttube.helpersimportPep8helper=Pep8(all_files=True,fail_fast=True,bells=5,name='follow pep8 dude')

注意，helper一旦实例化，就只是返回 真 或 假 ：

# Once configured, helpers are callables (they act like methods) that# accept a path to a python file and a regex match object (though the# match object isn't a requirement).helper('/path/to/some/file.py',None)

下面是完全合并到tube.py文件中的相同示例：

fromtesttube.helpersimportPep8PATTERNS=[[# Patternr'.*\.py$',# list of callable tests to run[Pep8(all_files=True,fail_fast=True,bells=5,name='follow pep8 dude')]]]

根据需要，可以通过重写 具体方法。见 帮助程序.py 有关详细信息。

除了配置帮助程序外，还可以配置测试组：

• Fail_Fast ：中止后续测试组的处理（如果全部 配置组中的测试未通过。

在第一个示例tube.py文件中，配置了第二个测试组 如果 flake8 或 frosted 失败，

一旦tube.py文件就位，告诉testtube监视项目 变化：

$ stir
testtube is now watching /Path/to/CWD/ for changes...

默认情况下，stir将监视当前工作目录并配置 它本身有一个名为tube（tube.py）的设置模块。如果tube.py文件是 放置在项目根目录中，则不需要指定 假设stir从同一目录执行的任何参数。如果路径需要 要定制一点， 搅拌 -h 将照亮道路：

$ stir -h
usage: stir [-h] [--src_dir SRC_DIR] [--settings SETTINGS]

Watch a directory and run a custom set of tests whenever a file changes.

optional arguments:
  -h, --help           show this help message and exit
  --src_dir SRC_DIR    The directory to watch for changes. (Defaults to CWD)
  --settings SETTINGS  Path to a testtube settings file that defines which
                       tests to run (Defaults to "tube.py" - your settings
                       file must be importable and the path must be relative
                       to your CWD)