AJ_Tools_UnitTest is a component developed with 4D v17 R5. Its purpose is to give 4D developers a way to do unit test and partial integration tests within 4D.
It is made to be used in development environment but not in production. You can write unit tests and partial integration tests (no UI). You cannot write functional tests with this component.
This component was created under the inspiration of the Javascript unit test library RITEway developed by Eric Elliott, which is a master in the Test Driven Development.
Those 2 articles was the main resources that inspired me to developer AJ_Tools_UnitTest component. JavaScript Testing: Unit vs Functional vs Integration Tests Rethinking Unit Test Assertions
Example v2 (From v18 R3)
// __UNIT_TEST
$test:=AJ_UnitTest .new("Sum()";Current method name;"Math")
$test.given:="no parameters"
$test.should:="return 0"
$test.expected:=0
$test.actual:=zz_sum
$test.assert()
$test.given:="1 parameter (here 5)"
$test.should:="return 10 (addition itself)"
$test.expected:=10
$test.actual:=zz_sum (5)
$test.assert()
$test.given:="3 and 3"
$test.should:="return 6"
$test.expected:=6
$test.actual:=zz_sum (3;3)
$test.assert()
Example (Before v18 R3)
// __UNIT_TEST
$test:=New AJ_Tools_UT_describe ("Sum()";Current method name;"Math")
$test.given:="no parameters"
$test.should:="return 0"
$test.expected:=0
$test.actual:=zz_sum
$test.assert()
$test.given:="1 parameter (here 5)"
$test.should:="return 10 (addition itself)"
$test.expected:=10
$test.actual:=zz_sum (5)
$test.assert()
$test.given:="3 and 3"
$test.should:="return 6"
$test.expected:=6
$test.actual:=zz_sum (3;3)
$test.assert()
Minimal 4D Version :
- 18 (using formula member function)
- 18 R3 (using class)
If you have any question, you can ask them directly on github or write to [email protected]