Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

The Liquibase code contains both unit tests and integration tests. This document explains the basics of creating Unit tests that will be used by the automated build process to validate Liquibase and reduce regressions.

...

You are also able to run all unit tests via the maven command - mvn test.<provide step by step on running the command via maven - please also include output>maven.

From the root of the liquibase repository, run mvn test which will build the project and run all the tests.

The output will show the tests executing like this:

Code Block

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO] 
[INFO] liquibase-core                                                     [jar]
[INFO] liquibase-maven-plugin                                    [maven-plugin]
[INFO] liquibase-cdi                                                      [jar]
[INFO] liquibase-integration-tests                                        [jar]
[INFO] liquibase-pro-base                                                 [pom]
[INFO] liquibase-pro                                                      [jar]
[INFO] licensing                                                          [pom]
[INFO] licensing-keymgr                                                   [jar]
[INFO] liquibase-root                                                     [pom]
[INFO] liquibase-dist                                                     [jar]
[INFO] licensing-keygen                                                   [jar]
[INFO] 
[INFO] --------------------< org.liquibase:liquibase-core >--------------------
[INFO] Building liquibase-core 4.0.0-beta1-local-SNAPSHOT                [1/11]
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 

..........[ skipped output ].....................

[INFO] -------------------------------------------------------
[INFO]  T E S T S
[INFO] -------------------------------------------------------
[INFO] Running liquibase.CatalogAndSchemaTest
[INFO] Tests run: 38, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.781 s - in liquibase.CatalogAndSchemaTest
[INFO] Running liquibase.change.AbstractChangeTest
[INFO] Tests run: 23, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.415 s - in liquibase.change.AbstractChangeTest
[INFO] Running liquibase.change.AbstractSQLChangeTest
[INFO] Tests run: 10, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.68 s - in liquibase.change.AbstractSQLChangeTest
[INFO] Running liquibase.change.AddColumnChangeTest
[INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.003 s - in liquibase.change.AddColumnChangeTest
[INFO] Running liquibase.change.AddColumnConfigTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.027 s - in liquibase.change.AddColumnConfigTest
[INFO] Running liquibase.change.ChangeFactoryTest
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.131 s - in liquibase.change.ChangeFactoryTest
[INFO] Running liquibase.change.ChangeParameterMetaDataTest
[INFO] Tests run: 9, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.021 s - in liquibase.change.ChangeParameterMetaDataTest
[INFO] Running liquibase.change.CheckSumTest
[INFO] Tests run: 11, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.007 s - in liquibase.change.CheckSumTest
[INFO] Running liquibase.change.ColumnConfigTest
[INFO] Tests run: 91, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.246 s - in liquibase.change.ColumnConfigTest
[INFO] Running liquibase.change.ConstraintsConfigTest
[INFO] Tests run: 32, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.015 s - in liquibase.change.ConstraintsConfigTest

..........[ skipped output ].....................


[INFO] Reactor Summary for liquibase-root:
[INFO] 
[INFO] liquibase-core ..................................... SUCCESS [01:09 min]
[INFO] liquibase-maven-plugin ............................. SUCCESS [  9.587 s]
[INFO] liquibase-cdi ...................................... SUCCESS [  9.642 s]
[INFO] liquibase-integration-tests ........................ SUCCESS [ 56.768 s]
[INFO] liquibase-pro-base ................................. SUCCESS [  0.037 s]
[INFO] liquibase-pro ...................................... SUCCESS [  7.319 s]
[INFO] licensing .......................................... SUCCESS [  0.026 s]
[INFO] licensing-keymgr ................................... SUCCESS [  7.802 s]
[INFO] liquibase-root ..................................... SUCCESS [  0.020 s]
[INFO] liquibase-dist ..................................... SUCCESS [  7.143 s]
[INFO] licensing-keygen ................................... SUCCESS [  0.448 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:48 min
[INFO] Finished at: 2020-04-14T16:24:28-05:00
[INFO] ------------------------------------------------------------------------

If any tests failed, you’ll see it say “BUILD FAILED” at the end and the “T E S T S” section will list the failing tests.