How to Run - TestlumFramework/Testlum GitHub Wiki

Options for installing and running Testlum

Please note that you need to input your values for the filenames and the absolute path.

Example of test resources can be found also in details of last release (RESOURCES_EXAMPLE.zip).

Run from sources

  1. Clone the repository to your local machine.
  2. Open project in your favourite IDE.
  3. Setup required program arguments -c={config-file-name}.xml -p=path/to/test-resources.
  4. Launch main java class - com.knubisoft.testlum.starter.TESTLUMStarter.

Run from CLI

You can download .jar file of Testlum from our releases.

And then simply execute following command in CLI.

  java -jar testlum-{version}.jar -c={config-file-name}.xml -p=path/to/test-resources

Run in your java project

  1. Add our official maven dependency.
<repositories>
    <repository>
        <id>testlum</id>
        <name>Testlum Releases</name>
        <url>https://mvnrepository.knubisoft.com/artifactory/testlum</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
      <groupId>com.testlum</groupId>
      <artifactId>tesltum-engine</artifactId>
      <version>1.0.0</version>
    </dependency>
</dependencies>
  1. And use our starter.
public static void main(String[] args) {
    TESTLUMStarter.main(new String[]{"-c={config-file-name}", "-p=/path-to-resources"});
}

Run using docker

After cloning repository to your local machine:

  • navigate to root project folder
  • build image from Dockerfile
  docker build -t testlum:1.0 .
  • execute run-docker-local bash script by passing test resources location
  sh run-docker-local imageName configFileName testResourcesPath
  sh run-docker-local testlum:1.0 global-config.xml ~/Users/user/test-resources 

Or you can use our official docker image from Docker Hub.

  docker pull testlum/testlum
⚠️ **GitHub.com Fallback** ⚠️