Skip to main content

A plugin to support golden tests with pytest.

Project description

PyPI version https://img.shields.io/pypi/l/pytest-goldie.svg

pytest-goldie is a pytest plugin that enables golden testing using pytest framework. Golden testing is a methodology that compares the output of your code with a pre-recorded output. This package provides a fixture called golden that can be used to update test results and make test comparisons.

Example

First, install the plugin:

$ pip install pytest-goldie

Then, in your test file, use the golden fixture:

def my_function():
    return "Hello, world!"

def test_my_function(golden):
    output = my_function()
    golden.test(output)

The golden.test method takes the output of your function and compares it to the saved output of a previous run. If the update_goldens flag is set, pytest-goldie will update the saved output with the new output.

To run the tests and update goldens, use the following command:

$ pytest --update_goldens

By default, the golden files are stored in a folder named ‘goldens’. You can change the folder name with –goldens_folder flag:

$ pytest --goldens_folder my_goldens

This will set the goldens folder to “my_goldens” instead of the default “goldens”.

License

This software is licensed under the MIT License.

Created by Nick Kartashov and contributors.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-goldie-0.1.4.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

pytest_goldie-0.1.4-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file pytest-goldie-0.1.4.tar.gz.

File metadata

  • Download URL: pytest-goldie-0.1.4.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.12

File hashes

Hashes for pytest-goldie-0.1.4.tar.gz
Algorithm Hash digest
SHA256 bb6fb0cf5f3b3914272f4d70363c135e851baf5d99346b404a9df6f41997119f
MD5 ef9accd40e08b84fe97f4d8231688e4c
BLAKE2b-256 a082ebc6dfc40a2b5cf663ef3a23b349e2736e59ce2c18bf9adcf8cbcca3d3d0

See more details on using hashes here.

File details

Details for the file pytest_goldie-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for pytest_goldie-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 33822c01b78c09a8da1129baa68da80d3cccc80cd93d8dbaa4d421f1aec3499b
MD5 8b8674c4225cf15b8b32604eb20e6e84
BLAKE2b-256 3121bc718a73a8b67a557e6c77a315766b4d8225be56c9b406daba060d0507b3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page