Skip to content

AJARProject/AJ_Tools_UnitTest

Repository files navigation

GitHub top language GitHub release (latest by date including pre-releases)

AJ_Tools_UnitTest

AJ_Tools_UnitTest is a component originally 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.

Credits

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 create AJ_Tools_UnitTest component. JavaScript Testing: Unit vs Functional vs Integration Tests Rethinking Unit Test Assertions

Documentation

wiki AJ_Tools_UnitTest

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()

Results Window

All tests pass Result Window - all tests pass One test fails Result Window - one test fails

Version

Minimal 4D Version :

  • 18 (using formula member function)
  • 18 R3 (using class)

Questions?

If you have any question, you can ask them directly on github or write to [email protected]