UnitTest | SuperCollider 3.12.2 Help

Subclasses: TestMovingSum, UnitTestScript

Description

In order to make sure a method works correctly, a test can be implemented that assures the correct behavior.

It is a common practice to write tests to clarify how an object should respond, and it may avoid inconsistencies on the long run. A test is always a subclass of UnitTest, implementing at least one method starting with test_.

When running all tests of one class (see run), each test method is called in a seperate instance of this class. Test methods therefore do not interefere with each other.

NOTE: UnitTests for the Common library classes are kept in the testsuite/classlibrary directory of the SuperCollider sources.

To install, download the sources and add the directory to your sclang_conf.yaml, either by editing it or via the ScIDE preferences.

Class Methods

UnitTest.gui

A graphical interface to run and browse all testsUnitTest.gui

UnitTest.reportPasses

UnitTest.reportPasses = value

Accessor controlling whether passing tests should be reported. Defaults to true. See also *passVerbosity which controls how much detail is reported from passing tests when this is set to true.

Arguments:

(value)

Should be true or false.

UnitTest.passVerbosity

UnitTest.passVerbosity = value

Accessor controlling whether extra details should be reported for passing tests.

Defaults to UnitTest.full so that all details are reported; however this behaviour may be too verbose for some, for whom it is sufficient to see that a test is passing without needing to see the detail. If set to UnitTest.brief, and *reportPassesis true, passes will be reported, but without any extra details which may be provided by assertions.

Arguments:

(value)

Should be UnitTest.full or UnitTest.brief.

UnitTest.run(reset: true, report: true)

Run all methods whose names begin with test_.TestUnitTest.new.run;

Arguments:

reset	If `true`, first runs *reset on the class.
report	If `true`, outputs the test results.

UnitTest.runTest(methodName)

Run a single test method.UnitTest.reset; UnitTest.runTest("TestUnitTest:test_assert");

Arguments:

methodName

A String referring to the class and test method within it, e.g. "TestPolyPlayerPool:test_prepareChildrenToBundle".

UnitTest.runAll

Run the entire test suite. As this method addresses the entire test suite, it should be called only on UnitTest. Calling it on any of its subclasses will result in throwing an Error.UnitTest.reset; UnitTest.runAll;

Inherited class methods

Undocumented class methods

UnitTest.brief

UnitTest.full

UnitTest.prRunAllTestMethods(report: true)

UnitTest.prRunWithinSetUpClass(func)

UnitTest.runTestClassForClass(class, reset: true, report: true)

UnitTest.setUpClass

UnitTest.tearDownClass

Instance Methods

.runTestMethod(method, report: true)

Run a single test method of this classTestUnitTest.new.runTestMethod(TestUnitTest.findMethod(\test_assert));

Arguments:

method	the method to run
report	Reports the result of the test if `true` (default is `true`)

Returns:

(describe returnvalue here)

.assert(boolean, message, report: true, onFailure, details)

Asserts that an expression must be true.this.assert(2 == 2, "passes"); this.assert(2 == 2.00001, "fails");

Arguments:

boolean	A boolean, where `true` means that the test is passed.
message	A message describing the purpose of the assertion, e.g. `"foo should be less than bar"`. Posted if `report` is true.
report	Reports the result of the test if `true`.
onFailure	If not `nil`, a failure stops the tests and evaluates this function.
details	Some optional extra details which will be passed to the reporting framework for display unless brief reporting is requested (see *passVerbosity).

.assertEquals(a, b, message: "", report: true, onFailure)

Asserts that an expression a is equal to the value b, where equality is determined according to a's implementation of ==.

Automatically passes details of the equality check to the reporting framework, which will be displayed if the assertion fails, and also if it passes and *reportPasses is true and *passVerbosity is not set to UnitTest.brief.this.assertEquals(2 + 2, 4, "passes"); this.assertEquals(2 + 2, 5, "fails");

Arguments:

a	the experimentally produced value
b	the expected value
message	A message describing the purpose of the assertion, e.g. `"Adding two numbers should return their sum."`. Posted if `report` is true.
report	Reports the result of the test if `true` (default is `true`)
onFailure	If not `nil`, a failure stops the tests and evaluates this function.

.assertFloatEquals(a, b, message: "", within: 0.0001, report: true, onFailure)

Asserts that an expression a returning a float is within a given range (within) of being equal to b.

Automatically passes details of the equality check to the reporting framework, which will be displayed if the assertion fails, and also if it passes and *reportPasses is true and *passVerbosity is not set to UnitTest.brief.this.assertFloatEquals(2, 2.0001, "Pass since 2 is close enough to 2.0001.", 0.001); this.assertFloatEquals(2, 2.0001, "Fail since 2 isn't close enough to 2.0001.", 0.0001);

Arguments:

a	the experimentally produced float value
b	the expected float value
message	A message describing the purpose of the assertion, e.g. `"Adding two numbers should return their sum."`. Posted if `report` is true.
within	The range within which `a` must be of `b` in order for the test to pass.
report	Reports the result of the test if `true` (default is `true`)
onFailure	If not `nil`, a failure stops the tests and evaluates this function.

.assertArrayFloatEquals(a, b, message: "", within: 0.0001, report: true, onFailure)

Make sure that the two arrays of floats a and b equal within a given range (within).this.assertArrayFloatEquals([2, 3] + 0.0001, [2, 3], "Pass since pairs of floats are close enough", 0.001); this.assertArrayFloatEquals([2, 3.0001], [2, 3], "Fail since pairs of floats aren't both close enough", 0.0001);

Arguments:

a	the experimentally produced value, which is an `Array` of floats
b	the `Array` of float values expected
message	A message describing the purpose of the assertion, e.g. `"Arrays foo and bar should be equal."`. Posted if `report` is true.
within	The range within which each item of `a` must be of the corresponding item in `b` in order for the test to pass.
report	Reports the result of the test if `true` (default is `true`)
onFailure	If not `nil`, a failure stops the tests and evaluates this function.

.ifAsserts(boolean, message, ifPassedFunc, ifFailedFunc, report: true)

Make a further assertion only if it passed, or only if it failed.( a = UnitTest.new; a.ifAsserts(2 == 3, "yes", { a.assert(2 == 4) }, { a.assert(1 == 1, "but this is correct") }); )

.assertException(func, errorClass, message, report: true, onFailure, details)

Make sure that a specific Exception or Error is thrown.

Arguments:

func	Pass the code that is expected to throw an error in this function.
errorClass	The class or class name which the error should be kind of.
message	A message describing the purpose of the assertion.
report	Reports the result of the test if `true` (default is `true`)
onFailure	If not `nil`, a failure stops the tests and evaluates this function.
details	Some optional extra details which will be passed to the reporting framework for display unless brief reporting is requested (see *passVerbosity).

.assertNoException(func, message, report: true, onFailure, details)

Make sure that a specific Exception or Error is not thrown. For arguments, see -assertException.

.wait(predicate, failureMessage: "", maxTime: 10.0)

Wait for a predicate function to return true. Considers the test failed after maxTime. Only valid within a test (or a routine).

NOTE: It's best to avoid using this method in tests. See CondVar: -waitFor for a better option.

.bootServer(server)

Wait for server boot until continued. Only valid within a test (or a routine).

If already booted, then freeAll and create new allocators.( { UnitTest.new.bootServer(s); }.fork )

.debug(text)

Supply some debugging information relevant to the currently running test case. This will be displayed immediately preceding any details which may be displayed through use of the details argument of -passed and -failed.

Arguments:

text	The debugging text.

Discussion:

will result in:FAIL: a TestMyClass: test_myMethod obj has color red Is: 4 Should be: 5

.passed(method, message, report: true, details)

Arguments:

method	Name of the method in which the test is passing.
message	A message describing the purpose of the assertion, e.g. `"foo should be less than bar"`. Posted if neither `report` nor *reportPasses are false.
report	Reports the result of the test if true and *reportPasses is true.
details	Some optional extra details which will be displayed if reportPasses is true and passVerbosity is not set to `UnitTest.brief`.

Discussion:

.failed(method, message, report: true, details)

Arguments:

method	Name of the method in which the test is failing.
message	A message describing the purpose of the assertion, e.g. `"foo should be less than bar"`. Posted if `report` is true.
report	Reports the result of the test if true.
details	Some optional extra details which will be displayed if `report`is true.

Discussion:

Inherited instance methods

Undocumented instance methods

.asynchAssert(waitConditionBlock, testBlock, timeoutMessage: "", timeout: 10)

Examples

Write tests by subclassing UnitTest, and defining methods whose names begins test_. Each test method will be called from a fresh instance of the subclass.

If you implement the methods setUp and tearDown in your test class, they will be called before and after every test. This can help to eliminate repetitive code, and makes it easier to maintain your tests by ensuring that they all run under the same set of conditions.TestYourClass : UnitTest { setUp { // this will be called before each test } tearDown { // this will be called after each test } test_yourMethod { // every method whose name begins with "test_" will be run this.assert( 6 == 6, "6 should equal 6"); this.assertEquals( 9, 9, "9 should equal 9"); this.assertFloatEquals( 4.0 , 1.0 * 4.0 / 4.0 4.0, "floating point math should be close to equal"); // we are inside a Routine, you may wait 1.0.wait; // this will wait until the server is booted this.bootServer; // if the server is already booted it will free all nodes // and create new allocators, giving you a clean slate p = { SinOsc.ar }; p.play; p.register; // will wait until the condition is true // will be considered a failure after 10 seconds this.wait( { p.isPlaying }, "waiting for synth to play", 10); } }

helpfile source: /usr/local/share/SuperCollider/HelpSource/Classes/UnitTest.schelp
link::Classes/UnitTest::

UnitTest : Object

UnitTest.gui

UnitTest.reportPasses

UnitTest.reportPasses = value

Arguments:

UnitTest.passVerbosity

UnitTest.passVerbosity = value

Arguments:

UnitTest.run(reset: true, report: true)

Arguments:

UnitTest.runTest(methodName)

Arguments:

UnitTest.runAll

UnitTest.brief

UnitTest.full

UnitTest.prRunAllTestMethods(report: true)

UnitTest.prRunWithinSetUpClass(func)

UnitTest.runTestClassForClass(class, reset: true, report: true)

UnitTest.setUpClass

UnitTest.tearDownClass

.runTestMethod(method, report: true)

Arguments:

Returns:

.assert(boolean, message, report: true, onFailure, details)

Arguments:

.assertEquals(a, b, message: "", report: true, onFailure)

Arguments:

.assertFloatEquals(a, b, message: "", within: 0.0001, report: true, onFailure)

Arguments:

.assertArrayFloatEquals(a, b, message: "", within: 0.0001, report: true, onFailure)

Arguments:

.ifAsserts(boolean, message, ifPassedFunc, ifFailedFunc, report: true)

.assertException(func, errorClass, message, report: true, onFailure, details)

Arguments:

.assertNoException(func, message, report: true, onFailure, details)

.wait(predicate, failureMessage: "", maxTime: 10.0)

.bootServer(server)

.debug(text)

Arguments:

Discussion:

.passed(method, message, report: true, details)

Arguments:

Discussion:

.failed(method, message, report: true, details)

Arguments:

Discussion:

.asynchAssert(waitConditionBlock, testBlock, timeoutMessage: "", timeout: 10)