ballerina/test module
Annotations
Name | Attachement Points | Data Type | Description |
---|---|---|---|
AfterEach | function | - | Identifies afterTest function. |
AfterSuite | function | - | Identifies afterSuite function. |
BeforeEach | function | - | Identifies beforeTest function. |
BeforeSuite | function | - | Identifies beforeSuite function. |
Config | function | TestConfig | |
Mock | function | MockConfig |
Records Summary
Record | Description | ||
---|---|---|---|
MockConfig | Configuration of the function to be mocked. | ||
TestConfig | Configuration set for test functions. |
Functions Summary
Return Type | Function and Description | ||
---|---|---|---|
assertEquals(any|error actual, any|error expected, string msg) Asserts whether the given values are equal. If it is not, an AssertError is thrown with the given errorMessage. |
|||
assertFail(string msg) Assert failure is triggered based on user discretion. AssertError is thrown with the given errorMessage. |
|||
assertFalse(boolean condition, string msg) Asserts whether the given condition is false. If it is not, a AssertError is thrown with the given errorMessage. |
|||
assertNotEquals(any|error actual, any|error expected, string msg) Asserts whether the given values are not equal. If it is equal, an AssertError is thrown with the given errorMessage. |
|||
assertTrue(boolean condition, string msg) Asserts whether the given condition is true. If it is not, a AssertError is thrown with the given errorMessage. |
|||
error<> | createBallerinaError(string errorMessage, string category) Creates an AssertError with custom message and category. |
||
boolean | startServiceSkeleton(string moduleName, string openApiFilePath) Start a service skeleton from a given OpenApi definition in the given ballerina module. |
||
boolean | startServices(string moduleName) Starts all the services defined in the module specified in the 'moduleName' argument. |
||
stopServiceSkeleton(string moduleName) Stop a service skeleton and cleanup created directories of a given ballerina module. |
|||
stopServices(string moduleName) Stops all the services defined in the module specified in the 'moduleName' argument. |
public type MockConfig record
Configuration of the function to be mocked.
Field Name | Data Type | Default Value | Description |
---|---|---|---|
moduleName | string | . | Name of the module that the function to be mocked resides in |
functionName | string | Name of the function to be mocked |
public type TestConfig record
Configuration set for test functions.
Field Name | Data Type | Default Value | Description |
---|---|---|---|
enable | boolean | true | Flag to enable/disable test functions |
groups | string[] | [] | List of groups that this test function belongs to |
dataProvider | string | Name of the function which will be used to feed data into this test |
|
before | string | Name of the function to be run before the test is run |
|
after | string | Name of the function to be run after the test is run |
|
dependsOn | string[] | [] | A list of function names the test function depends on, and will be run before the test |
public function assertEquals(any|error actual, any|error expected, string msg)
Asserts whether the given values are equal. If it is not, an AssertError is thrown with the given errorMessage.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
actual | any|error | Actual value |
|
expected | any|error | Expected value |
|
msg | string | Assertion Failed! | Assertion error message |
public function assertFail(string msg)
Assert failure is triggered based on user discretion. AssertError is thrown with the given errorMessage.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
msg | string | Test Failed! | Assertion error message |
public function assertFalse(boolean condition, string msg)
Asserts whether the given condition is false. If it is not, a AssertError is thrown with the given errorMessage.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
condition | boolean | Boolean condition to evaluate |
|
msg | string | Assertion Failed! | Assertion error message |
public function assertNotEquals(any|error actual, any|error expected, string msg)
Asserts whether the given values are not equal. If it is equal, an AssertError is thrown with the given errorMessage.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
actual | any|error | Actual value |
|
expected | any|error | Expected value |
|
msg | string | Assertion Failed! | Assertion error message |
public function assertTrue(boolean condition, string msg)
Asserts whether the given condition is true. If it is not, a AssertError is thrown with the given errorMessage.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
condition | boolean | Boolean condition to evaluate |
|
msg | string | Assertion Failed! | Assertion error message |
public function createBallerinaError(string errorMessage, string category) returns (error<>)
Creates an AssertError with custom message and category.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
errorMessage | string | Custom message for the ballerina error |
|
category | string | error category |
Return Type | Description | ||
---|---|---|---|
error<> | an AssertError with custom message and category |
public function startServiceSkeleton(string moduleName, string openApiFilePath) returns (boolean)
Start a service skeleton from a given OpenApi definition in the given ballerina module.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
moduleName | string | Name of the module |
|
openApiFilePath | string | Path to the OpenApi definition |
Return Type | Description | ||
---|---|---|---|
boolean |
|
public function startServices(string moduleName) returns (boolean)
Starts all the services defined in the module specified in the 'moduleName' argument.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
moduleName | string | Name of the module |
Return Type | Description | ||
---|---|---|---|
boolean |
|
public function stopServiceSkeleton(string moduleName)
Stop a service skeleton and cleanup created directories of a given ballerina module.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
moduleName | string | Name of the module |
public function stopServices(string moduleName)
Stops all the services defined in the module specified in the 'moduleName' argument.
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
moduleName | string | Name of the module |