Skip to main content


Project description

Varsnap Python

Codeship Status for albertyw/varsnap-python

Python Varsnap Client


Install from PyPI - pip install varsnap


The client depends on three environment variables to be set:

  • VARSNAP - Should be either true or false. Varsnap will be disabled if the variable is anything other than true.
  • ENV - If set to development, the client will receive events from production. If set to production, the client will emit events.
  • VARSNAP_PRODUCER_TOKEN - Only clients with this token may emit production snapshots. Copied from
  • VARSNAP_CONSUMER_TOKEN - Only clients with this token may emit development snapshots. Copied from


Add the varsnap decorator in front of any function you'd like to make better:

from varsnap import varsnap

def example(args, **kwargs):
    return 'output'


With the proper environment variables set, in a test file, add

import unittest
from varsnap import test

class TestIntegration(unittest.TestCase):
    def test_varsnap(self):
        matches, logs = test()
        if matches is None:
            raise'No Snaps found')
        self.assertTrue(matches, logs)


Decorators changing function names

Using decorators may change the name of functions. In order to not confuse varsnap, set the decorated function's __qualname__ to the original __qualname__:

def decorator(func):
    def decorated(*args, **kwargs):
        func(*args, **kwargs)
    decorated.__qualname__ = func.__qualname__
    return decorated


pip install twine
python sdist bdist_wheel
twine upload dist/*

Project details

Download files

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

Files for varsnap, version 1.3.4
Filename, size File type Python version Upload date Hashes
Filename, size varsnap-1.3.4-py3-none-any.whl (15.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size varsnap-1.3.4.tar.gz (9.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page