UdonTestBase

Tsvrc.UdonTestKit.UdonTestBase is an abstract base class for Play Mode test fixtures that run behaviours as Udon. It extends ClientSimTestBase and gives every test a new UdonHost in its protected Udon property, which destroys what the test created with it after the test.

public class DoorTests : UdonTestBase
{
    [Test]
    public void Open_Closed_OpensTheDoor()
    {
        UdonBehaviour door = Udon.Create<Door>("Door");

        door.SendCustomEvent(nameof(Door.Open));

        Assert.That(door.GetProgramVariable(nameof(Door.IsOpen)), Is.EqualTo(true));
    }
}

Everything from ClientSimTestBase is there too. A test that needs players starts the session with yield return Session.Start(), and the session ends after every test.

Constructors

UdonTestBase has the two constructors of ClientSimTestBase and passes their arguments on:

• UdonTestBase() runs every test in the Unity Test Framework test scene, which the whole run shares.
• UdonTestBase(TestScene scene, TestSceneLifetime lifetime = TestSceneLifetime.PerTest) runs every test in scene, so the GameObjects Udon creates go into it.

Pass the scene from the constructor of your fixture:

public class LobbyTests : UdonTestBase
{
    public LobbyTests() : base(TestScene.Empty("Lobby"))
    {
    }
}

Lifecycle

UdonTestBase adds two methods to those of ClientSimTestBase:

• [SetUp] CreateUdonHost creates Udon. It runs before your own [SetUp].
• [TearDown] DisposeUdonHost disposes it. It runs after your own [TearDown] and before ClientSimTestBase ends the session, so your [UnityTearDown] runs once both are gone.

ClientSimTestBase lists the rest of the order.