Sample repo to run java on playwright in hyperexecute.
HyperExecute is a smart test orchestration platform to run end-to-end Selenium tests at the fastest speed possible. HyperExecute lets you achieve an accelerated time to market by providing a test infrastructure that offers optimal speed, test orchestration, and detailed execution logs.
The overall experience helps teams test code and fix issues at a much faster pace. HyperExecute is configured using a YAML file. Instead of moving the Hub close to you, HyperExecute brings the test scripts close to the Hub!
- HyperExecute HomePage: https://www.lambdatest.com/hyperexecute
- Lambdatest HomePage: https://www.lambdatest.com
- LambdaTest Support: [email protected]
To know more about how HyperExecute does intelligent Test Orchestration, do check out HyperExecute Getting Started Guide
Follow the below steps to run Gitpod button:
- Click 'Open in Gitpod' button (You will be redirected to Login/Signup page).
- Login with Lambdatest credentials and it will be redirected to Gitpod editor in new tab and current tab will show hyperexecute dashboard.
Before using HyperExecute, you have to download HyperExecute CLI corresponding to the host OS. Along with it, you also need to export the environment variables LT_USERNAME and LT_ACCESS_KEY that are available in the LambdaTest Profile page.
HyperExecute CLI is the CLI for interacting and running the tests on the HyperExecute Grid. The CLI provides a host of other useful features that accelerate test execution. In order to trigger tests using the CLI, you need to download the HyperExecute CLI binary corresponding to the platform (or OS) from where the tests are triggered:
Also, it is recommended to download the binary in the project's parent directory. Shown below is the location from where you can download the HyperExecute CLI binary:
- Mac: https://downloads.lambdatest.com/hyperexecute/darwin/hyperexecute
- Linux: https://downloads.lambdatest.com/hyperexecute/linux/hyperexecute
- Windows: https://downloads.lambdatest.com/hyperexecute/windows/hyperexecute.exe
Before the tests are run, please set the environment variables LT_USERNAME & LT_ACCESS_KEY from the terminal. The account details are available on your LambdaTest Profile page.
For macOS:
export LT_USERNAME=LT_USERNAME
export LT_ACCESS_KEY=LT_ACCESS_KEYFor Linux:
export LT_USERNAME=LT_USERNAME
export LT_ACCESS_KEY=LT_ACCESS_KEYFor Windows:
set LT_USERNAME=LT_USERNAME
set LT_ACCESS_KEY=LT_ACCESS_KEYAuto-split execution mechanism lets you run tests at predefined concurrency and distribute the tests over the available infrastructure. Concurrency can be achieved at different levels - file, module, test suite, test, scenario, etc.
For more information about auto-split execution, check out the Auto-Split Getting Started Guide
Auto-split YAML file (yaml/win/junit_hyperexecute_autosplit_sample.yaml) in the repo contains the following configuration:
globalTimeout: 150
testSuiteTimeout: 150
testSuiteStep: 150Global timeout, testSuite timeout, and testSuite timeout are set to 150 minutes. The runson key determines the platform (or operating system) on which the tests are executed. Here we have set the target OS as Windows.
runson: winAuto-split is set to true in the YAML file.
autosplit: trueretryOnFailure is set to true, instructing HyperExecute to retry failed command(s). The retry operation is carried out till the number of retries mentioned in maxRetries are exhausted or the command execution results in a Pass. In addition, the concurrency (i.e. number of parallel sessions) is set to 2.
retryOnFailure: true
maxRetries: 5
concurrency: 2Dependency caching is enabled in the YAML file to ensure that the package dependencies are not downloaded in subsequent runs. The first step is to set the Key used to cache directories. The directory m2_cache_dir is created in the project's root directory.
env:
CACHE_DIR: m2_cache_dir
cacheKey: '{{ checksum "pom.xml" }}'
cacheDirectories:
- $CACHE_DIRSteps (or commands) that must run before the test execution are listed in the pre run step. In the example, the playwright version installation command has to be passed along with the maven command to download the Maven packages in the m2_cache_dir. To prevent test execution at the pre stage, the maven.test.skip parameter is set to true so that only packages are downloaded and no test execution is performed.
pre:
- npm install [email protected] --save-exact
- mvn -Dmaven.repo.local=$CACHE_DIR -Dmaven.test.skip=true clean installSteps (or commands) that need to run after the test execution are listed in the post step. In the example, we cat the contents of yaml/win/junit_hyperexecute_autosplit_sample.yaml
post:
- cat yaml/win/junit_hyperexecute_autosplit_sample.yamlThe testDiscovery directive contains the command that gives details of the mode of execution, along with detailing the command that is used for test execution. Here, we are fetching the list of class names that would be further passed in the testRunnerCommand
testDiscovery:
type: raw
mode: static
command: grep 'public class' src/test/java/SampleTest.java | awk '{print$3}'Running the above command on the terminal will give a list of tests present in the SampleTest.java:
*sampleTest1
The testRunnerCommand contains the command that is used for triggering the test. The output fetched from the testDiscoverer command acts as an input to the testRunner command.
testRunnerCommand: mvn -Dplatname=win -Dmaven.repo.local=m2_cache_dir -Dtest=$test test surefire-report:reportThe mergeArtifacts directive (which is by default false) is set to true for merging the artifacts and combing artifacts generated under each task.
The uploadArtefacts directive informs HyperExecute to upload artifacts [files, reports, etc.] generated after task completion. In the example, path consists of a regex for parsing the sure-fire reports (i.e. target/surefire-reports/) directory.
mergeArtifacts: true
uploadArtefacts:
- name: Surefire Report
path:
- target/surefire-reports/**HyperExecute also facilitates the provision to download the artifacts on your local machine. To download the artifacts, click on Artifacts button corresponding to the associated TestID.
Now, you can download the artifacts by clicking on the Download button as shown below:
The CLI option --config is used for providing the custom HyperExecute YAML file (i.e. yaml/win/junit_hyperexecute_autosplit_sample.yaml for Windows and yaml/linux/junit_hyperexecute_autosplit_sample.yaml for Linux).
Run the following command on the terminal to trigger Java tests on the Windows platform. The --download-artifacts option is used to inform HyperExecute to download the artifacts for the job. The --force-clean-artifacts option force cleans any existing artifacts for the project.
./hyperexecute --config yaml/win/junit_hyperexecute_autosplit_sample.yaml --force-clean-artifacts --download-artifactsRun the following command on the terminal to trigger java tests on the Linux platform. The --download-artifacts option is used to inform HyperExecute to download the artifacts for the job. The --force-clean-artifacts option force cleans any existing artifacts for the project.
./hyperexecute --config yaml/linux/junit_hyperexecute_autosplit_sample.yaml --force-clean-artifacts --download-artifactsVisit HyperExecute Automation Dashboard to check the status of execution
Shown below is the execution screenshot when the YAML file is triggered from the terminal:
Matrix-based test execution is used for running the same tests across different test (or input) combinations. The Matrix directive in HyperExecute YAML file is a key:value pair where value is an array of strings.
Also, the key:value pairs are opaque strings for HyperExecute. For more information about matrix multiplexing, check out the Matrix Getting Started Guide
In the current example, matrix YAML file (yaml/win/junit_hyperexecute_matrix_sample.yaml) in the repo contains the following configuration:
globalTimeout: 150
testSuiteTimeout: 150
testSuiteStep: 150Global timeout, testSuite timeout, and testSuite timeout are set to 150 minutes. The target platform is set to Win. Please set the [runson] key to [mac] if the tests have to be executed on the macOS platform.
runson: winThe matrix constitutes of the following entries - classname. The entries represent the class names in the test code.
matrix:
classname: ["SampleTest"] The testSuites object contains a list of commands (that can be presented in an array). In the current YAML file, commands for executing the tests are put in an array (with a '-' preceding each item). The Maven command mvn test is used to run tests located in the current project. In the current project, parallel execution is achieved at the class level. The maven.repo.local parameter in Maven is used for overriding the location where the dependent Maven packages are downloaded.
testSuites:
- mvn `-Dplatname=win `-Dmaven.repo.local=m2_cache_dir `-Dtest=$classname test surefire-report:reportDependency caching is enabled in the YAML file to ensure that the package dependencies are not downloaded in subsequent runs. The first step is to set the Key used to cache directories. The directory m2_cache_dir is created in the project's root directory.
env:
CACHE_DIR: m2_cache_dir
cacheKey: '{{ checksum "pom.xml" }}'
cacheDirectories:
- $CACHE_DIRSteps (or commands) that must run before the test execution are listed in the pre run step. In the example, the playwright version installation command has to be passed along with the maven command to download the Maven packages in the m2_cache_dir. To prevent test execution at the pre stage, the maven.test.skip parameter is set to true so that only packages are downloaded and no test execution is performed.
pre:
- npm install [email protected] --save-exact
- mvn -Dmaven.repo.local=$CACHE_DIR -Dmaven.test.skip=true clean installSteps (or commands) that need to run after the test execution are listed in the post step. In the example, we cat the contents of yaml/win/junit_hyperexecute_matrix_sample.yaml
post:
- cat yaml/win/junit_hyperexecute_matrix_sample.yamlThe mergeArtifacts directive (which is by default false) is set to true for merging the artifacts and combing artifacts generated under each task.
The uploadArtefacts directive informs HyperExecute to upload artifacts [files, reports, etc.] generated after task completion. In the example, path consists of a regex for parsing the sure-fire reports (i.e. target/surefire-reports/) directory.
mergeArtifacts: true
uploadArtefacts:
- name: Surefire Report
path:
- target/surefire-reports/**HyperExecute also facilitates the provision to download the artifacts on your local machine. To download the artifacts, click on Artifacts button corresponding to the associated TestID.
Now, you can download the artifacts by clicking on the Download button as shown below:
The CLI option --config is used for providing the custom HyperExecute YAML file (i.e. yaml/win/junit_hyperexecute_matrix_sample.yaml for Windows and yaml/linux/junit_hyperexecute_matrix_sample.yaml for Linux).
Run the following command on the terminal to trigger junit tests on the Windows platform. The --download-artifacts option is used to inform HyperExecute to download the artifacts for the job. The --force-clean-artifacts option force cleans any existing artifacts for the project.
./hyperexecute --config yaml/win/junit_hyperexecute_matrix_sample.yaml --force-clean-artifacts --download-artifactsRun the following command on the terminal to trigger java tests on the Linux platform. The --download-artifacts option is used to inform HyperExecute to download the artifacts for the job. The --force-clean-artifacts option force cleans any existing artifacts for the project.
./hyperexecute --config yaml/linux/java_hyperexecute_matrix_sample.yaml --force-clean-artifacts --download-artifactsVisit HyperExecute Automation Dashboard to check the status of execution:
Shown below is the execution screenshot when the YAML file is triggered from the terminal:
In case you want to use any secret keys in the YAML file, the same can be set by clicking on the Secrets button the dashboard.
Now create a secret key that you can use in the HyperExecute YAML file.
All you need to do is create an environment variable that uses the secret key:
env:
PAT: ${{ .secrets.testKey }}HyperExecute lets you navigate from/to Test Logs in Automation Dashboard from/to HyperExecute Logs. You also get relevant get relevant Selenium test details like video, network log, commands, Exceptions & more in the Dashboard. Effortlessly navigate from the automation dashboard to HyperExecute logs (and vice-versa) to get more details of the test execution.
Shown below is the HyperExecute Automation dashboard which also lists the tests that were executed as a part of the test suite:
The LambdaTest Community allows people to interact with tech enthusiasts. Connect, ask questions, and learn from tech-savvy people. Discuss best practises in web development, testing, and DevOps with professionals from across the globe.
If you want to learn more about the LambdaTest's features, setup, and usage, visit the LambdaTest documentation. You can also find in-depth tutorials around test automation, mobile app testing, responsive testing, manual testing on LambdaTest Blog and LambdaTest Learning Hub.
LambdaTest is a leading test execution and orchestration platform that is fast, reliable, scalable, and secure. It allows users to run both manual and automated testing of web and mobile apps across 3000+ different browsers, operating systems, and real device combinations. Using LambdaTest, businesses can ensure quicker developer feedback and hence achieve faster go to market. Over 500 enterprises and 1 Million + users across 130+ countries rely on LambdaTest for their testing needs.
- Got a query? we are available 24x7 to help. Contact Us
- For more info, visit - https://www.lambdatest.com
