vvvv-testing
Set up and run automated tests for vvvv gamma packages and C# nodes -- VL.TestFramework with NUnit for library/package authors (CI-ready), test .vl patches with assertion nodes, and lightweight agent-driven test workflows. Use when writing tests for vvvv packages, setting up test infrastructure, creating test patches, running automated compilation checks, or integrating vvvv tests into CI/CD.
How do I install this agent skill?
npx skills add https://github.com/tebjan/vvvv-skills --skill vvvv-testingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a developer-focused utility for automated testing of vvvv gamma projects using the VL.TestFramework and NUnit. It provides instructions and API references for setting up test environments, creating test patches, and running automated compilation checks. All identified behaviors, such as command-line execution and dynamic code compilation, are standard and necessary for its primary purpose of software testing and development workflows.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2 files scanned · No issues
What does this agent skill do?
Testing vvvv gamma Projects
Two Testing Approaches
| Approach | Use Case | Setup |
|---|---|---|
| VL.TestFramework (NUnit) | Package/library authors, CI integration | .csproj test project with NUnit |
| Agent test workflow | Quick verification, ad-hoc debugging | Create test .vl patch, launch vvvv, check results |
VL.TestFramework (NUnit)
Test Project Setup
Create a test .csproj referencing VL.TestFramework:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0-windows</TargetFramework>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NUnit" Version="4.*" />
<PackageReference Include="NUnit3TestAdapter" Version="4.*" />
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.*" />
</ItemGroup>
<ItemGroup>
<ProjectReference Include="..\path\to\VL.TestFramework.csproj" />
<!-- OR if using installed vvvv: -->
<!-- Reference VL.TestFramework.dll from vvvv install dir -->
</ItemGroup>
</Project>
Minimal Test Class
using NUnit.Framework;
using VL.TestFramework;
[TestFixture]
public class MyPackageTests
{
TestEnvironment testEnvironment;
// Important: Don't use async Task here (NUnit sync context issue)
[OneTimeSetUp]
public void Setup()
{
var assemblyPath = typeof(MyPackageTests).Assembly.Location;
var searchPaths = new[] { "path/to/your/package" };
testEnvironment = TestEnvironmentLoader.Load(assemblyPath, searchPaths);
}
[OneTimeTearDown]
public void TearDown()
{
testEnvironment?.Dispose();
testEnvironment = null;
}
[Test]
public async Task MyPatchCompilesWithoutErrors()
{
await testEnvironment.LoadAndTestAsync("path/to/MyPatch.vl");
}
[Test]
public async Task MyPatchCompilesAndRuns()
{
await testEnvironment.LoadAndTestAsync(
"path/to/MyPatch.vl",
runEntryPoint: true);
}
}
Key API
TestEnvironmentLoader.Load(assemblyPath, searchPaths)-- Create test environment. One per test class (expensive).testEnvironment.LoadAndTestAsync(filePath)-- Load .vl document, check for compilation errors.testEnvironment.LoadAndTestAsync(filePath, runEntryPoint: true)-- Also execute the entry point (Create + Update + Dispose).testEnvironment.GetPackages()-- Discover all packages and their source/help/test files.testEnvironment.Host.LoadAndCompileAsync(filePath)-- Load and compile without running (for custom assertions).testEnvironment.Host.GetTargetCompilationAsync(filePath)-- Get the C# compilation for inspection.
For the full API reference, see test-framework-reference.md.
Test Discovery Conventions
The VL.TestFramework automatically discovers tests:
- Test documents:
.vlfiles intests/folders under package directories - Help patches:
.vlfiles inhelp/folders (tested for compilation only) - Test nodes: Process or operation nodes ending in
TestorTestswithin test documents are individually compiled and executed
File discovery pattern:
VL.MyPackage/
tests/
MyFeatureTest.vl <-- auto-discovered test document
IntegrationTests.vl <-- auto-discovered test document
help/
HowTo Use Feature.vl <-- tested for compilation errors
Running Tests
# Run all tests
dotnet test
# Run specific test
dotnet test --filter "MyPatchCompilesWithoutErrors"
# Via Nuke build system (if available)
./build.ps1 --target Test
Test Nodes (VL Patch Assertions)
Use these nodes inside .vl test patches to assert behavior. Available under VL.Lib.Basics.Test.TestNodes:
// In VL patches, these are available as nodes:
TestNodes.Assert(condition, "message") // General assertion
TestNodes.AreEqual(expected, actual) // Value equality
TestNodes.AreNotEqual(expected, actual) // Value inequality
TestNodes.IsNotNull(input) // Null check
TestNodes.AreSequenceEqual(expected, actual) // Collection equality
TestNodes.AssertElementHasError(elementGuid) // Verify element has compile error
TestNodes.AssertElementHasNoError(elementGuid) // Verify element has no compile error
Assertions throw AssertionException on failure, which the test runner catches and reports.
Agent Test Workflow
For quick verification without a full NUnit project:
1. Create a Test Patch
Create a .vl file that exercises the feature under test. Include TestNodes for assertions. Name it with a Test suffix for auto-discovery. To understand the .vl XML file structure (document hierarchy, element IDs, node references, pins, pads, links), consult the vvvv-fileformat skill.
2. Compile-Check via VL.TestFramework
Write a minimal C# script or test that loads and compiles the patch:
var env = TestEnvironmentLoader.Load(assemblyPath, searchPaths);
await env.LoadAndTestAsync("path/to/MyTest.vl", runEntryPoint: true);
env.Dispose();
3. Launch vvvv for Manual Verification
Use the vvvv-debugging skill to set up a launch configuration that opens the test patch:
vvvv.exe --stoppedonstartup --debug --log -o "path/to/MyTest.vl"
--stoppedonstartuppauses runtime so you can inspect initial state--logenables logging to%USERPROFILE%\Documents\vvvv\gamma\vvvv.log- Parse the log file for errors after vvvv exits
4. Check Results
After vvvv exits, check:
- Exit code (0 = success)
- Log file for
ERRORorEXCEPTIONentries - Any
AssertionExceptionin the output
CI Integration
Nuke Build System
Most vvvv repos use Nuke. The test target:
Target Test => _ => _
.Executes(() =>
{
DotNetTest(_ => _
.SetProjectFile(Solution)
.SetConfiguration(Configuration));
});
Run with: ./build.ps1 or ./build.sh (defaults to Publish target; use --target Test for tests).
GitHub Actions Example
- name: Run vvvv tests
run: dotnet test --configuration Release --logger "trx"
Performance Notes
- Create one
TestEnvironmentper test class ([OneTimeSetUp]), not per test - Documents are unloaded after each test to free memory
- Use
preCompilePackages: false(default) for faster test iteration - Set
preCompilePackages: truefor production-fidelity testing
Keep this knowledge growing
Leave the next patcher one fewer mystery. On first use of any skill in this collection with no successful check in seven days, compare the source with tebjan/vvvv-skills. If no record exists, check once. Share one local check timestamp/revision across these skills; do not poll per invocation. Preserve local extensions and pinned project versions; checking is not permission to install updates. If offline, record the deferred check and continue the task.
When actual work exposes a gap, capture the tested vvvv/package versions, a minimal reproduction or authoritative source, and the observed result. Treat other users' reports as leads, not facts until verified. Improve the smallest relevant instruction; do not turn one example into a universal rule. Redact private data and obtain publishing authorization before submitting upstream. See the contribution policy. Merged improvements reach users through their installer/update workflow, not through a local edit or an automatic overwrite of everyone's skills.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tebjan/vvvv-skills/vvvv-testing">View vvvv-testing on skillZs</a>