Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Running Unit Tests

Developers typically run Unit Tests through IDEs, not through the classic JUnit test runners.  Unit tests can also be run through Maven - indeed, if you're not careful, Maven will run unit tests even when you don't want it.  When tests are run through Maven, the Surefire plugin can produce various reports on the health of the unit test suite.  In KFS Financials 6, running the unit test suite must be done against a database populated with demo data from both the Financials and Rice datasets - ie, to run locally, you should run against a local satellite database.

With KFS Financials 6's move to Maven, the optional KFS modules have been moved into separate KFS modules, and the core modules are together in one Maven module.  To run tests for a single module, simply run the "mvn test" maven lifecycle command in the module where you'd like to run the tests (e.g., kfs/kfs-ar); or, alternatively, run any mvn lifecycle command (package, install) which depends on the test step without applying the -DskipTests command line option in that directory.

If you'd like to run the whole test suite, simply run "mvn test" from the root kfs pom.  Note that running the entire suite can take over an hour locally.

The KFS Financials product team has a continuous integration system, Jenkins, which runs the unit test suite.   As of KFS 6, it will only run the module unit tests for code affected by a code change.  This is to say: if a commit was added to the system which only affected classes in org.kuali.kfs.module.purap, then Jenkins will run only the tests for the kfs-purap module.  This speeds up the continuous integration a great deal, which means that developers can get feedback from Jenkins pretty quickly if their commit has broken something important.KFS's plan  The tests are run each time a pull request is added.  The outcome of the test can be determined based on a red X next to the pull request (failure) or green check (success).

The plan going forward includes increasing the size of the unit test suite as well as including more automated functional testing; it is also being considered how to adopt a microservices approach, which may split functionality out into separate projects - along with related tests.

...

Of course, you can run single unit tests through Maven as well:

mvn test -e -Dtest=PreCommitSuite

Unit Testing Before Submitting a Pull Request

...