Skip to main content

Snapshot testing for Textual apps

Project description


Snapshot testing for Textual apps.


Install using pip:

pip install pytest-textual-snapshot

After installing, the snap_compare fixture will automatically be made available.


A pytest-textual-snapshot test saves an SVG screenshot of a running Textual app to disk. The next time the test runs, it takes another screenshot and compares it to the saved one. If the new screenshot differs from the old one, the test fails. This is a convenient way to quickly and automatically detect visual regressions in your applications.


Running tests

You can run your tests using pytest as normal.

My snapshot test failed, what do I do?

If your snapshot test fails, it means that the screenshot taken during the test session differs from the last screenshot taken. This change is shown in the failure report, which you'll be given a linked to in the event of a failure.

If the diff shown in the failure report looks correct, you can update the snapshot on disk by running pytest with the --snapshot-update flag.

Writing tests

Basic usage

Inject the snap_compare fixture into your test and call it with the path to the Textual app (the file containing the App subclass).

def test_something(snap_compare):
    assert snap_compare("path/to/")

Pressing keys

Key presses can be simulated before the screenshot is taken.

def test_something(snap_compare):
    assert snap_compare("path/to/", press=["tab", "left", "a"])

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_textual_snapshot-0.4.0.tar.gz (7.5 kB view hashes)

Uploaded Source

Built Distribution

pytest_textual_snapshot-0.4.0-py3-none-any.whl (8.6 kB view hashes)

Uploaded Python 3

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