{"id":36822990,"url":"https://github.com/exactpro/clearth","last_synced_at":"2026-01-12T14:01:58.447Z","repository":{"id":37588908,"uuid":"208800805","full_name":"exactpro/clearth","owner":"exactpro","description":"Test automation tool for Clearing, Settlement and Back-Office Systems","archived":false,"fork":false,"pushed_at":"2025-05-13T12:58:41.000Z","size":4013,"stargazers_count":38,"open_issues_count":0,"forks_count":13,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-13T13:55:10.394Z","etag":null,"topics":["automation","automation-framework","automation-test","automation-tools","emulator","exchange","fintech","fixprotocol","functional-testing","quality-assurance","simulator","software-testing","swift-protocol","test-automation","testing","tool","tools","trading","trading-platform","trading-systems"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/exactpro.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-09-16T13:01:12.000Z","updated_at":"2025-05-13T12:58:45.000Z","dependencies_parsed_at":"2023-09-23T08:48:08.664Z","dependency_job_id":"7adafe03-98f5-4ef8-a6bd-4805c946f36e","html_url":"https://github.com/exactpro/clearth","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/exactpro/clearth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exactpro%2Fclearth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exactpro%2Fclearth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exactpro%2Fclearth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exactpro%2Fclearth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exactpro","download_url":"https://codeload.github.com/exactpro/clearth/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exactpro%2Fclearth/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28340223,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["automation","automation-framework","automation-test","automation-tools","emulator","exchange","fintech","fixprotocol","functional-testing","quality-assurance","simulator","software-testing","swift-protocol","test-automation","testing","tool","tools","trading","trading-platform","trading-systems"],"created_at":"2026-01-12T14:01:58.109Z","updated_at":"2026-01-12T14:01:58.383Z","avatar_url":"https://github.com/exactpro.png","language":"Java","readme":"ClearTH\n==========\n\nThis is the official ClearTH project repository.\n\n## Introduction\n\nClearTH is a test automation tool whose primary purpose is testing of Clearing, Settlement and Back-Office Systems.\n\nIt is able to simultaneously execute multiple end-to-end test scenarios in batches. Test scenarios can be executed within a schedule, thus providing fully autonomous test execution capabilities.\n\nClearTH typically interacts with the system under test via its gateways / APIs, but can be easily extended with new protocols and data formats to work with.\n\nClearTH Core provides basic functionality to execute test scenarios, some automation actions and connectivity support. ClearTH modules extend this functionality with new data formats support and other features.\n\nApplications that use ClearTH are built on top of ClearTH Core, optionally including its modules.\n\n## Tutorials\n\nHere are the links to the tutorial videos introducing you to the main features of ClearTH and helping you get set up.\n\n  - Getting Started:\n    https://youtu.be/pAGXzRbOE24\n  - Project Overview:\n    https://youtu.be/DbBpV-rWAVE\n  - Automation Script:\n    https://youtu.be/HPN64NgWriU\n  - Automation Example (Part 1):\n    https://youtu.be/gOYakNgS5c4\n  - Automation Example (Part 2):\n    https://youtu.be/7iI43EMenrQ\n  - Custom Actions (Part 1):\n    https://youtu.be/l1gl26aEg1g\n  - Custom Actions (Part 2):\n    https://youtu.be/VjC7GCWw_B8\n  - Adding a Module for XML Messages\n    https://youtu.be/Mv3WxHgjmSQ\n  - Automation Example with Messages\n    https://youtu.be/uFbp8RpGrCw\n  - Built-in Tools\n    https://youtu.be/akayR4N3dhk\n\n\n\n## How to build\n\nJDK 11 is required.\n\nBuild and publish ClearTH Core and modules to a local repository, i.e. \"shared\" directory in the repository root by executing the following command from the repository root:\n```\n$ ./gradlew clean build publish\n```\n\nCreate a new project that will use ClearTH Core and its GUI module by executing the following command from the repository root.\n\nNew project will use Jetty 9.4 and, thus, JDK 11 is required to execute this command successfully.\n```\n$ ./gradlew createProject -PnewProjectDir=../PROJECTDIR -PnewProjectName=PROJECTNAME\n```\n\nAlternatively, you can create the project that will use Jetty 12 to host ClearTH, thus, JDK 17 is required:\n```\n$ ./gradlew createProject -PnewProjectDir=../PROJECTDIR -PnewProjectName=PROJECTNAME -Pserver=jetty12\n```\n\nAnyway, the new project will be created in the directory adjacent to the repository root. It will include Jetty server with needed modules installed and ready to host ClearTH.\n\n## Starting ClearTH\n\nJDK 17 is required on ClearTH host if the project uses Jetty 12. Otherwise, JDK 11 is required.\n\nNavigate to the directory with your new project and execute the following command to start ClearTH within the Jetty server:\n```\n$ ./gradlew jettyRun\n```\n\nAlternatively, you can use the following command to explicitly build the WAR file with your project and deploy it to the Jetty server:\n```\n$ ./gradlew runClearTH\n```\n\nClearTH GUI will be available at http://localhost:8080/clearth\n\nYou can log-in by using the following login/password:\n```\nadmin/admin\n```\n\n\n## ClearTH in Docker\n\nNavigate to the directory with your new project and create the WAR file with your project:\n```\n$ ./gradlew copyWar\n```\n\nBuild Docker image:\n```\n$ docker build -t NAME:TAG -f docker/Dockerfile .\n```\n\nCreate a directory for persistent data, give it write permissions:\n```\n$ mkdir docker-volume-data \u0026\u0026 chmod o+wx docker-volume-data/\n```\n\nNow you can start ClearTH from the image you built:\n```\n$ docker run -v ./docker-volume-data:/clearth/persistentFiles -p 8080:8080 -it NAME:TAG\n```\n\nClearTH GUI will be available at http://localhost:8080/clearth\n\nYou can log-in by using the following login/password:\n```\nadmin/admin\n```","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexactpro%2Fclearth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexactpro%2Fclearth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexactpro%2Fclearth/lists"}