{"id":51186887,"url":"https://github.com/rockops/rocktest","last_synced_at":"2026-06-27T11:03:07.209Z","repository":{"id":46280491,"uuid":"323292250","full_name":"rockops/rocktest","owner":"rockops","description":"Test automation that rocks","archived":false,"fork":false,"pushed_at":"2021-11-02T15:33:36.000Z","size":786,"stargazers_count":5,"open_issues_count":11,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-28T11:46:56.917Z","etag":null,"topics":["low-code","test-automation","testing","testing-tools"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rockops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-21T09:43:49.000Z","updated_at":"2021-11-19T14:10:30.000Z","dependencies_parsed_at":"2022-09-03T00:41:47.427Z","dependency_job_id":null,"html_url":"https://github.com/rockops/rocktest","commit_stats":null,"previous_names":["rockops/rocktest"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/rockops/rocktest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rockops%2Frocktest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rockops%2Frocktest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rockops%2Frocktest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rockops%2Frocktest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rockops","download_url":"https://codeload.github.com/rockops/rocktest/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rockops%2Frocktest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34850576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["low-code","test-automation","testing","testing-tools"],"created_at":"2026-06-27T11:03:06.209Z","updated_at":"2026-06-27T11:03:07.203Z","avatar_url":"https://github.com/rockops.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RockTest\n\n![rocktest.png](rocktest.png)\n\n\n## What is it ?\n\nRockTest allows you to write test scenarios, using a simple and well known YAML syntax.\n\nTests are divided into steps, which are YAML blocks.\n\nExample :\n\n````yaml\n- display: This is RockTest\n- sql.request:\n  params:\n    request: select * from rock\n````\n\nThis scenario has 2 steps :\n- A display to print a message\n- A sql.request to execute a SQL request\n\nMany modules are available (HTTP clients and server, SQL, Web automation with Selenium, Assertions...)\n\n![rock](rocktest.svg)\n\n## Interested ? Rock with _Katakoda_ !\n\nSee it live on Katakoda : https://www.katakoda.com/rocktest\n\nRead the full documentation : https://rockintest.github.io/rocktest/\n\n## Getting started with Docker\n\nYou can use Rocker, the packaged Docker image of RockTest.\n\nTo run a scenario, do the following commands (suppose $SCEN is the directory where your senarios are)\n\n    $ cd $SCEN\n    $ docker run --rm -v $PWD:/scen rockintest/rocktest scenario.yaml\n\nIf you use Docker on Windows with cmd.exe :\n\n    C:\\rocktest\\scen\u003e docker run --rm -v %cd%:/scen rockintest/rocktest scenario.yaml\n\nOr if you prefer powershell :\n\n    PC C:\\rocktest\\scen\u003e docker run --rm -v $pwd:/scen rockintest/rocktest scenario.yaml\n\n*Example*:\n\nTo execute a simple scenario :\n\n    $ git clone https://github.com/rockintest/rocktest.git\n    $ cd rocktest/docs/example/core\n    $ docker run --rm -v $PWD:/scen rockintest/rocktest display.yaml\n\n## Getting started without Docker\n\nGet the binary release :\n\n    $ curl -L https://github.com/rockintest/rocktest/releases/latest/download/rocktest-bin.tar.gz --output rocktest-bin.tar.gz\n\nExtract the archive\n\n    $ tar xzvf rocktest-bin.tar.gz\n\nSetup the environment :\n\n    $ rocktest-bin/sh/rocksetup\n    $ . ~/.bashrc\n\nRun the \"display.yaml\" scenario\n\n    $ rocktest rocktest-bin/core/display.yaml\n\nYou Rock !! \n\n## Build Rocktest\n\n### Prerequisites\n\nTo run RockTest, you need the following :\n\n#### Setup Java 8\n\n- Download and install the latest JDK 8 from [https://adoptopenjdk.net/](https://adoptopenjdk.net/?variant=openjdk8\u0026jvmVariant=hotspot).\nMake sure java and javac are in the PATH.\n\n#### Setup Maven \u003e= 3.6.3\n\n- Download the last version from : https://maven.apache.org/download.cgi.\n- Extract the ZIP, and add the bin sub-directory to your PATH.\n\n#### Setup Selenium\n\nAs an option, to run the Web tests, you will need a Selenium server for your preferred browser.\n- For Chrome : https://chromedriver.chromium.org/downloads\n- For Firefox : https://github.com/mozilla/geckodriver/releases\n\nExtract the binary and put it in your PATH.\nYou need the browser installed too, of course (chrome and/or Firefox).\n\n#### A Shell\n\nIf you are running Linux then you are ready to Rock :guitar:\n\nFor Windows users, you can use either use WSL or Gitbash as a shell : https://gitforwindows.org/\n\nThis will install Git and Bash on your Windows box.\n\n### Build from source\n\nOpen your shell, go to the right directory and run the following commands :\n\n    $ git clone https://github.com/rockintest/rocktest.git\n    $ cd rocktest\n    $ mvn clean package\n\nThen set the `$ROCK_HOME` environnement variable and add the `sh` directory to your PATH :\n\n    $ export ROCK_HOME=$PWD\n    $ export PATH=$PATH:$ROCK_HOME/sh\n\n### Run your first scenario\n\nEnter the following comands :\n\n    $ cd $ROCK_HOME/scen-test\n    $ rocktest hello.yaml\n\nYou should see some logs, with the message \"Hello RockTest\" and a scenario success\n\n```\n________               ______  ________              _____\n___  __ \\______ __________  /_____  __/_____ __________  /_\n__  /_/ /_  __ \\_  ___/__  //_/__  /   _  _ \\__  ___/_  __/\n_  _, _/ / /_/ // /__  _  ,\u003c   _  /    /  __/_(__  ) / /_\n/_/ |_|  \\____/ \\___/  /_/|_|  /_/     \\___/ /____/  \\__/\n Test automation that rocks !        (v1.0.0-SNAPSHOT)\n09/01/2021 16:08:15.559 [INFO ] -  Starting RocktestApplication v1.0.0-SNAPSHOT on bouzin with PID 69786 (/home/ben/src/rock/rocktest/target/rocktest-1.0.0-SNAPSHOT.jar started by ben in /home/ben/src/rock/rocktest/scen-test)\n09/01/2021 16:08:15.560 [DEBUG] -  Running with Spring Boot v2.3.0.RELEASE, Spring v5.2.6.RELEASE\n09/01/2021 16:08:15.561 [INFO ] -  No active profile set, falling back to default profiles: default\n09/01/2021 16:08:16.136 [INFO ] -  Started RocktestApplication in 0.893 seconds (JVM running for 1.288)\n09/01/2021 16:08:16.138 [INFO ] -  Set variable module = hello\n09/01/2021 16:08:16.138 [INFO ] -  Load scenario. name=hello.yaml, dir=.\n09/01/2021 16:08:16.161 [INFO ] -  Set variable module = hello\n----------------------------------------\n09/01/2021 16:08:16.163 [INFO ] - [hello] Step#1 display,Hello RockTest !\n09/01/2021 16:08:16.167 [INFO ] - [hello] Step#1 Hello RockTest !\n----------------------------------------\n========================================\n=     Scenario Success ! It Rocks      =\n========================================\n```\n\n### Congrats !\n\nYou have just run your first RockTest scenario.\n\nTo learn how to do HTTP requests, SQL requests, Web scenarios or HTTP mocks, check the documentation : https://rockintest.github.io/rocktest/\n\nOr play live on Katakoda : https://katakoda.com/rocktest\n\nHave fun with RockTest !\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frockops%2Frocktest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frockops%2Frocktest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frockops%2Frocktest/lists"}