Libraries.Testing.Test

This class represents an abstract test on the system. It can either be instantiated and its state altered or it can be subclassed and executed externally, by a tester or otherwise. Inside it contains a series of helper actions for having one or more value checks. By default, if this test receives a check and at least one of these checks fails, the overall test fails on a run.

Example Code

use Libraries.Testing.Tester
    use Libraries.Testing.Test
    
    Tester tests
    
    Test result
    result:SetMessage("This is a failed test.")
    
    tests:Add(result)

This action checks whether two number values are equal, using the default threshold value as the difference allowed.

Example Code

use Libraries.Testing.Test
        
        Test result
        output result:Check(0.01, 0.02) //false

This action checks whether two values are equal.

Example Code

use Libraries.Testing.Test
        
        Test result
        output result:Check(true, false) //false

This action checks whether two number values are equal, using the default threshold value as the difference allowed.

Example Code

use Libraries.Testing.Test
        
        Test result
        output result:Check(0.01, 0.02, 0.01) //true

This action checks whether two values are equal.

Example Code

use Libraries.Testing.Test
        
        Test result
        output result:Check(1, 2) //false

This action checks whether two values are equal.

Example Code

use Libraries.Testing.Test
        
        Test result
        output result:Check("Hi", "Not Hi") //false

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Example Code

Object o
        Object t
        integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

This action determines if two objects are equal based on their hash code values.

Example Code

use Libraries.Language.Object
        use Libraries.Language.Types.Text
        Object o
        Text t
        boolean result = o:Equals(t)

Returns an error message from the test.

This action gets the hash code for an object.

Example Code

Object o
        integer hash = o:GetHashCode()

Returns a message from the test.

Returns the name of the test. Tests do not have a name by default.

Returns the default threshold for the comparison of two numbers.

Returns whether or not this test threw an error while it executed.

This action returns true if the test passed. By default, it returns false. If even a single check call failed, this test fails unless SetPassed is called explicitly.

This action executes the test. By default, it does nothing.

Example Code

use Libraries.Testing.Tester
        use Libraries.Testing.Test
        
        Tester tests
        
        Test result
        result:SetMessage("This is a failed test.")
        
        tests:Run(result)

Sets an error message from the test.

Sets a error message from the test.

Sets the name of the test

This action tells the test whether or not it passed.

Sets the default threshold for the comparison of two numbers.

Sets whether or not this test threw an error while it executed.