» Test Framework
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.

Test Framework

In order to prevent certain bugs from resurfacing again after they've been fixed, vvvv has a test framework. The framework consists of a couple of nodes and a simple template that test-patches have to follow to test for a specific known bug. If the bug persists, the patch returns an error-, otherwise a success-code.

Everytime the vvvv build-server creates a new alpha-vvvversion it also runs all available test-patches. If any of the test-patches fails, the build is not being released and the devvvvs are being informed about the problem.

Therefore the more test-patches we collect about known issues the less likely it is that our build-server lets a buggy build slip through. Here is how you can help us to improve the release-quality of vvvv by creating and sending us test-patches for issues you find:

  1. Create a test-patch by starting from "\lib\nodes\Template test.v4p" patch
  2. Make sure the test fails
  3. Upload the patch in the forum or pull-request to https://github.com/vvvv/vvvv-sdk/tree/develop/vvvv45/tests/patches

Test Patches

To be recognized as a test-patch by the build-server a patch needs to:

  • follow this naming scheme:
    • "* test.v4p", e.g: "DuplicateNodes test.v4p" or "Cons (String) test.v4p"
  • have the following in- and outlets
    • Inlets: Run (bang)
    • Outlets: Success (bool), Message (string), Running (bool)
The template for test-patches

The test-framework will open every such patch and bang its Run input. Now the creator of the patch is responsible to test for a specific case and return a Success of 1 (for true) or 0 (for false). Additionally a Message can be returned. Typically it is enough to run tests for exactly one frame only and the Run input can be directly connected to the Running output. But it is also fine to have tests running for a couple of frames by setting Running back to 0 after some frames past.

The build-logs including test-results per build-attempt can be found on the build-server:

Useful Nodes

The Test category in the nodebrowser holds a couple of nodes that can be useful for building test-patches, like:

  • Assert (Test)
  • AreEqual (Test Value)
  • AreEqual (Test String)

Consult their help-patches to learn how to use them.

Test Rig

To run test-patches locally, get TeamCityTester.v4p from here:
https://github.com/vvvv/vvvv-sdk/tree/develop/vvvv45/tests

and enter the directory that holds your test-patches into the Directory IOBox, then press Run Tests.

This is the same patch our build-server runs, so the TTY output is a bit cryptic but you should be able to identify problems there.

anonymous user login

Shoutbox

~6d ago

fleg: This Tuesday, Cologne: exhibition opening of "interwoven", textile disinformation patterns created with vvvv. https://fleg.de/news/exhibition-interwoven

~19d ago

manuelgonzalvez: Assimp nodes all broken afted Win Update w/exception "COM object that has been separated from its underlying RCW(...)"

~19d ago

manuelgonzalvez: @levi thanks would love to! anyway managed to get something similar working based on forum search and anthokio's patches.

~20d ago

levi: @ravasquez thanks. 31.2 x86 verrion worked. @manuelgonzalvez i have a dx11 projectTexture if u a want.

~21d ago

manuelgonzalvez: Anyone has a dx11 port of "projectedTexture" dx9 fx for projection mapping?

~21d ago

manuelgonzalvez: Anyone has a dx11 port of "projectedTexture" dx9 fx for projection mapping?

~22d ago

ravazquez: @levi not sure bout the ImagePack, but I believe VL.OpenCV should give you the same tools and should work with beta just fine

~22d ago

levi: anyone knows of a VVVVpacks.image that works for elliot's projector calibration patches?x64,dx11. always crashes v4 on solve.

~29d ago

Lorenz: VJing with GIFS: https://lorenzpotthast.de/gifjockey/ A fun little side project, that I first prototyped in v4 and now turned web-based ;)

~2mth ago

schlonzo: finally fixed in 4.8 nice1