Pytest权威教程20-日志
记录日志
Pytest默认捕获WARNING以上日志消息，在每个失败的测试结果概要中，捕获的log信息和stdout、stderr信息使用相同的方式，分块显示。
不带选项运行：
pytest
失败的用例显示格式如下：
----------------------- Captured stdlog call ----------------------
test_reporting.py 26 WARNING text going to logger
----------------------- Captured stdout call ----------------------
text going to stdout
----------------------- Captured stderr call ----------------------
text going to stderr
==================== 2 failed in 0.02 seconds =====================
默认情况下，捕获到的每条日志消息都会显示模块，行号，日志级别和消息内容。
如果需要更改日志的显示格式，也可以通过传递特定的日志格式选项和日期格式选项，来指定日志显示的格式：
pytest --log-format="%(asctime)s %(levelname)s %(message)s" \
--log-date-format="%Y-%m-%d %H:%M:%S"
失败的用例显示格式如下：
----------------------- Captured stdlog call ----------------------
2010-04-10 14:48:44 WARNING text going to logger
----------------------- Captured stdout call ----------------------
text going to stdout
----------------------- Captured stderr call ----------------------
text going to stderr
==================== 2 failed in 0.02 seconds =====================
日志格式和日期格式选项，也可以通过pytest.ini进行设置：
[pytest]
log_format = %(asctime)s %(levelname)s %(message)s
log_date_format = %Y-%m-%d %H:%M:%S
此外，还可以通过以下选项，禁止对失败用例进行stdout、stderr及日志捕获：
pytest --show-capture=no
caplog Fixture方法
在内部测试中，可以更改捕获的日志消息的日志级别。这由caplog夹具支持：
def test_foo(caplog):
caplog.set_level(logging.INFO)
pass
默认情况下，该级别是在根记录器上设置的，但为方便起见，还可以设置任何记录器的日志级别：
def test_foo(caplog):
caplog.set_level(logging.CRITICAL, logger="root.baz")
pass
测试结束时，将自动恢复设置的日志级别。
也可以使用上下文管理器临时更改with块内的日志级别：
def test_bar(caplog):
with caplog.at_level(logging.INFO):
pass
同样，默认情况下，根记录器的级别也会受到影响，但是可以使用以下方法来更改任何记录器的级别：
def test_bar(caplog):
with caplog.at_level(logging.CRITICAL, logger="root.baz"):
pass
最后，在测试运行期间发送到记录器的所有日志都以logging.LogRecord实例和最终日志文本的形式在Fixture上可用。当您要声明消息的内容时，这很有用：
def test_baz(caplog):
func_under_test()
for record in caplog.records:
assert record.levelname != "CRITICAL"
assert "wally" not in caplog.text
有关日志记录的所有可用属性，请参见logging.LogRecord类
你也可以诉诸record_tuples如果你想要做的是保证，某些邮件已根据与给定的严重性和消息给定的记录器名登录：
def test_foo(caplog):
logging.getLogger().info("boo %s", "arg")
assert caplog.record_tuples == [("root", logging.INFO, "boo arg")]
你可以调用caplog.clear()以重置测试中捕获的日志记录：
def test_something_with_clearing_records(caplog):
some_method_that_creates_log_records()
caplog.clear()
your_test_method()
assert ["Foo"] == [rec.message for rec in caplog.records]
该caplog.records属性仅包含当前阶段的记录，因此在setup阶段内，它仅包含设置日志，与call和 teardown阶段相同。
要访问其他阶段的日志，请使用caplog.get_records(when)方法。举个例子，如果你想确保它使用某种固定的测试永远不能登录任何警告，您可以检查的记录setup，并call像这样拆卸过程中的阶段：
@pytest.fixture
def window(caplog):
window = create_window()
yield window
for when in ("setup", "call"):
messages = [
x.message for x in caplog.get_records(when) if x.levelno == logging.WARNING
]
if messages:
pytest.fail(
"warning messages encountered during testing: {}".format(messages)
)
完整的API可访问_pytest.logging.LogCaptureFixture
实时日志
通过将log_cli配置选项设置为true，pytest将在直接将日志记录发送到控制台时输出日志记录。
您可以指定传递的级别，以将等于或更高级别的日志记录打印到控制台的日志记录级别--log-cli-level。此设置接受python文档中显示的日志记录级别名称，或者接受整数作为日志记录级别num。
此外，还可以指定--log-cli-format和 --log-cli-date-format哪个镜和默认--log-format和 --log-date-format如果没有提供，但只被应用到控制台日志处理程序。
还可以在配置INI文件中设置所有CLI日志选项。选项名称为：
- log_cli_level
- log_cli_format
- log_cli_date_format
如果您需要将整个测试套件的日志记录记录到一个文件中，则可以传递 --log-file=/path/to/log/file。该日志文件以写模式打开，这意味着它将在每个运行测试会话中被覆盖。
你还可以使用选项 -log-file-level来指定日志文件的日志记录级别。此设置接受python文档中显示的日志记录级别名称（即大写的名称）或对应的整数值。
此外，还可以指定--log-file-format和 --log-file-date-format，它们等于--log-format和 --log-date-format但应用于日志文件。
也可以在配置INI文件中设置所有日志文件选项。选项名称为：
- log_file
- log_file_level
- log_file_format
- log_file_date_format
你可以调用set_log_path()以动态自定义log_file路径。目前这是一个实验性功能。
（译者注：可以在conftest.py中使用Hook方法pytest_configure()来修改日志名称，示例如下：
# conftest.py
import os
form datetime import datetime
def pytest_configure(config):
today = datetime.now().strftime('%Y%m%d')
config.option.log_file = os.path.join(config.rootdir, 'logs', f'{today}.log')
)
版本改动记录
日志功能的引入代替了之前版本使用pytest-catchlog插件来记录日志的方式。两者相互冲突，Pytest已不再向后兼容pytest-capturelog插件。如果仍然需要使用pytest-catchlog插件，可以通过pytest.ini添加以下内容来禁用内部日志功能。
[pytest]
addopts=-p no:logging
Pytest3.4中不向后兼容的更改
引入日志功能后，社区反馈了一些3.4版本与3.3版本的不兼容问题：
除非log_level配置或--log-level命令行选项明确要求，否则日志级别将不再更改。这允许用户自己配置记录器对象。
现在，默认情况下会禁用用例实时日志输出，并且可以通过配置log_cli为true来启用。启用后，用例运行结果的详细程度会增加，因此可以看到每个测试的日志记录。
现在，实时日志已发送到sys.stdout并且不再需要-s命令行选项才能工作。
如果要部分还原version的日志记录行为3.3，可以将以下选项添加到ini 文件中：
[pytest]
log_cli=true
log_level=NOTSET
有关导致此更改的讨论的更多详细信息，请参见问题＃3013。
