No project description provided
Project description
expecttest ![PyPI version](https://pypi-camo.freetls.fastly.net/e5531f94a94db6d27556b044c20ef9aa75821e5b/68747470733a2f2f62616467652e667572792e696f2f70792f657870656374746573742e737667)
This library implements expect tests (also known as "golden" tests). Expect
tests are a method of writing tests where instead of hard-coding the expected
output of a test, you run the test to get the output, and the test framework
automatically populates the expected output. If the output of the test changes,
you can rerun the test with the environment variable EXPECTTEST_ACCEPT=1
to
automatically update the expected output.
Somewhat unusually, this library implements inline expect tests: that is to say, the expected output isn't saved to an external file, it is saved directly in the Python file (and we modify your Python file when updating the expect test.)
The general recipe for how to use this is as follows:
-
Write your test and use
assertExpectedInline()
instead of a normalassertEqual
. Leave the expected argument blank with an empty string:self.assertExpectedInline(some_func(), "")
-
Run your test. It should fail, and you get an error message about accepting the output with
EXPECTTEST_ACCEPT=1
-
Rerun the test with
EXPECTTEST_ACCEPT=1
. Now the previously blank string literal will contain the expected value of the test.self.assertExpectedInline(some_func(), "my_value")
Some tips and tricks:
-
Often, you will want to expect test on a multiline string. This framework understands triple-quoted strings, so you can just write
"""my_value"""
and it will turn into triple-quoted strings. -
Take some time thinking about how exactly you want to design the output format of the expect test. It is often profitable to design an output representation specifically for expect tests.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for expecttest-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 36f07b2f2800c12e5a0a5763d420f9f9b91631329bd54537509ebf17f8f81c36 |
|
MD5 | 3ffd16d3aca06436f66727aaa3fcdac2 |
|
BLAKE2b-256 | 73a89427813686fe043eaf817b99444d4d321ce14f9434e3ffb6bbd1a182a8df |