{"id":21116853,"url":"https://github.com/iamcharankumar/web_test_framework","last_synced_at":"2025-07-08T19:33:30.815Z","repository":{"id":194341254,"uuid":"690353664","full_name":"iamcharankumar/web_test_framework","owner":"iamcharankumar","description":"A Java-based Selenium Web Test Framework for automating tests on the Sauce Demo website.","archived":false,"fork":false,"pushed_at":"2024-07-20T15:08:32.000Z","size":4606,"stargazers_count":10,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-07-21T16:26:41.461Z","etag":null,"topics":["data-driven","discord-bot","java","logback","maven","parallelization","reportportal","selenium-grid-4","selenium-java","selenium-webdriver","test-automation-framework","testng","ui-testing","web-testing"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamcharankumar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-09-12T03:12:43.000Z","updated_at":"2024-06-26T06:18:21.000Z","dependencies_parsed_at":"2023-09-12T23:58:28.936Z","dependency_job_id":"0ff205ec-144d-4487-8d8f-1f5ea592e12b","html_url":"https://github.com/iamcharankumar/web_test_framework","commit_stats":null,"previous_names":["iamcharankumar/web_test_framework"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamcharankumar%2Fweb_test_framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamcharankumar%2Fweb_test_framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamcharankumar%2Fweb_test_framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamcharankumar%2Fweb_test_framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamcharankumar","download_url":"https://codeload.github.com/iamcharankumar/web_test_framework/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225458242,"owners_count":17477414,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["data-driven","discord-bot","java","logback","maven","parallelization","reportportal","selenium-grid-4","selenium-java","selenium-webdriver","test-automation-framework","testng","ui-testing","web-testing"],"created_at":"2024-11-20T02:36:15.059Z","updated_at":"2025-07-08T19:33:30.804Z","avatar_url":"https://github.com/iamcharankumar.png","language":"Java","readme":"![Selenium](https://img.shields.io/badge/-selenium-%43B02A?style=for-the-badge\u0026logo=selenium\u0026logoColor=white)\n![Java](https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge\u0026logo=openjdk\u0026logoColor=white)\n![Maven](https://img.shields.io/badge/apachemaven-C71A36.svg?style=for-the-badge\u0026logo=apachemaven\u0026logoColor=white)\n![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge\u0026logo=docker\u0026logoColor=white)\n\n# ABOUT\n\nA Web Test Framework for developing regression suites. The test cases can be run locally and in remote server.\n\n# STEPS FOR INTEGRATING TESTNG \u0026 REPORT PORTAL\n\n1. Download the latest docker-compose.yml\n   from [here](https://github.com/reportportal/reportportal/blob/master/docker-compose.yml), a quicker way to download\n   this is to use below command\n   `curl https://raw.githubusercontent.com/reportportal/reportportal/master/docker-compose.yml -o docker-compose.yml`\n2. Once downloaded, execute the below command to pull the required images and start containers\n   `docker-compose -p reportportal up -d --force-recreate`\n3. Verify login http://localhost:8080/ui/#login with `default\\1q2w3e` or `superadmin\\erebus`\n4. Create a blank project and copy and paste the below config in `reportportal.properties` under `src/test/resources`.\n   See the table below.\n5. Read these great posts written below by [Automation Hacks](https://github.com/automationhacks) to configure the\n   Report\n   portal.\n   By far, these are the only posts with accurate steps.\n    1. Further reading on setting up the reportportal\n       is [here](https://automationhacks.io/2020/03/02/how-to-setup-reportportal-on-a-local-docker-instance/).\n    2. Further reading on configuring logback with reportportal to push logs\n       is [here](https://automationhacks.io/2020/09/25/logging-integration-with-logback-testng-in-report-portal/).\n\n| Sl.No | Report portal Property Name | Report portal Property Value |\n|-------|-----------------------------|------------------------------|\n| 1     | rp.endpoint                 | http://localhost:8080        |\n| 2     | rp.api.key                  | \u003cAPI_KEY\u003e                    |\n| 3     | rp.launch                   | Java launch                  |\n| 4     | rp.project                  | web_tests                    |\n\n#### REPORT PORTAL OUTPUTS\n\n\u003cimg width=\"1728\" alt=\"Web_Tests_ReportPortal_Launch\" src=\"https://github.com/iamcharankumar/web_test_framework/assets/29479534/51effb54-8318-4705-ab04-fe4431f7e040\"\u003e\n\u003cimg width=\"1728\" alt=\"Web_Tests_ReportPortal_Test_Methods\" src=\"https://github.com/iamcharankumar/web_test_framework/assets/29479534/ed758683-1e83-4020-acaa-97151941896d\"\u003e\n\u003cimg width=\"1728\" alt=\"Web_Tests_ReportPortal_Failed\" src=\"https://github.com/iamcharankumar/web_test_framework/assets/29479534/979cfb69-5ba7-4560-b3dc-a4884f9da388\"\u003e\n\n# STEPS FOR INTEGRATING TEST REPORTS [REPORT PORTAL URL] WITH DISCORD MESSAGE SERVICE\n\n1. Create a discord account and follow the steps\n   given [here](https://www.svix.com/resources/guides/how-to-make-webhook-discord/) to configure a message channel and\n   send the test reports after the test execution.\n2. Pass your channel's webhook token in the `SauceLabsPortalConstants` class.\n3. Here we will send the Report Portal Launch URL along with test case metrics.\n   So make sure that your report portal is\n   up and running.\n4. You're ready to execute your tests now. Follow the below section.\n\n#### DISCORD OUTPUTS\n\n\u003cimg width=\"854\" alt=\"Web_Tests_Discord\" src=\"https://github.com/iamcharankumar/web_test_framework/assets/29479534/bb19fb36-6246-43b8-a8ab-5fbc1a373b7b\"\u003e\n\n# STEPS FOR THE TEST EXECUTION\n\n1. `git clone https://github.com/iamcharankumar/web_test_framework.git`\n2. `cd web_test_framework`\n3. `git pull`\n4. `mvn clean test -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`\n\n#### BROWSERS \u0026 RUN MODES\n\n| Sl.No | Browser Name | Run Mode | mvn command                                                                                                                                   |\n|-------|--------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| 1     | Chrome       | Local    | `mvn clean test -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`                                      |\n| 2     | Chrome       | Headless | `mvn clean test -Drunmode=headless -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`                   |\n| 3     | Chrome       | Remote   | `mvn clean test -Drunmode=remote -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`                     |\n| 4     | Firefox      | Local    | `mvn clean test -Dbrowser=firefox -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`                    |\n| 5     | Firefox      | Headless | `mvn clean test -Drunmode=headless -Dbrowser=firefox -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3` |\n| 6     | Firefox      | Remote   | `mvn clean test -Drunmode=remote -Dbrowser=firefox -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`   |\n| 7     | Edge         | Local    | `mvn clean test -Dbrowser=edge -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`                       |\n| 8     | Edge         | Headless | `mvn clean test -Drunmode=headless -Dbrowser=edge -Dgroups=SAUCE_LABS_SMOKE,SAUCE_LABS_REGRESSION -Dthreads=3 -Ddataproviderthreadcount=3`    |\n\n**NOTE**: These above commands (no testng.xml required) will run the tests in parallel with the specified thread count\nand with the respective groups and thread counts.\nThe screenshot listeners are configured in \"pom.xml\" under \"\u003c property \u003e\" tag.\n\n# PROPERTIES SETUP FOR SELENIUM GRID\n\n- Run mode value can be 'local' or 'remote'\n- You can configure it in the \"config.properties\" file.\n- To run in remote server, follow the below docker setup instructions.\n\n# DOCKER SETUP FOR SELENIUM GRID\n\n**Make sure to have the docker desktop and docker compose installed on your machine.**\n\n**NOTE:** Since I'm running the `docker-compose-v3.yml` on Apple Chip, I'm using `docker-seleniarm` images.\nMore on the Docker images for Selenium (ARM/NON-ARM)\nread this GitHub's [README](https://github.com/seleniumhq-community/docker-seleniarm).\n\n# 🧪 ARM-Ready Selenium Grid with Docker Compose\n\n\u003e ⚠️ Tired of Selenium Docker setups breaking on your M1/M2 Mac? Here's a fully functional ARM-based Selenium Grid using [`seleniarm`](https://github.com/SeleniumHQ/docker-selenium#arm-support).\n\n---\n\n## 💡 Why This Exists\n\nMost Selenium Docker images are built for **x86_64** architecture — which fails to run on modern **ARM64** systems like:\n\n- Apple Silicon Macs (M1/M2)\n- Raspberry Pi\n- ARM-based CI runners\n\nThis project uses the [`seleniarm`](https://github.com/SeleniumHQ/docker-selenium#arm-support) images to build a **cross-platform, lightweight, plug-and-play** Selenium Grid. 🌍\n\n---\n\n## ⚙️ Tech Stack\n\n- Selenium Grid Hub (ARM compatible)\n- Chrome \u0026 Firefox Nodes (ARM)\n- Docker Compose\n- VNC Enabled for visual debugging\n- Parallel test sessions\n\n---\n\n## 🧱 Folder Structure\n\nGoto `/web_test_framework/src/main/java/resources` and execute the below docker commands to setup the `Seleniarm Gird`.\n\n`docker ps -a`\n\n###### Run the below command to delete all the docker containers (if only required)\n\n`docker rm -vf $(docker ps -aq)`\n\n###### To spin up 10 nodes in the grid we use --scale before the node's name.\n\n`docker-compose -f docker-compose-v3.yml up --scale chrome=10 --scale firefox=10 -d --force-recreate`\n\n###### To kill a session in the selenium grid.\n\n`curl -X DELETE http://localhost:4444/wd/hub/session/{session_id}`\n\n#### SELENIUM GRID OUTPUTS\n\n\u003cimg width=\"1728\" alt=\"7_Threads_Chrome_Remote\" src=\"https://github.com/user-attachments/assets/52070b74-fed6-4880-a668-1a3743e3946c\" /\u003e\n\u003cimg width=\"1728\" alt=\"Max_9_Threads_Firefox_Remote\" src=\"https://github.com/user-attachments/assets/cc6ab5a8-3aa1-489d-972a-9f6c915da7a8\" /\u003e\n\n#### DECLUTTERING MAVEN OUTPUT\n\n- Maven usually floods the console with logs during test execution, making it hard to spot what's important.\n  A clean, minimal, Node.js-style output for a Java project felt impossible—until I\n  found this [maven dependency](https://mvnrepository.com/artifact/me.fabriciorby/maven-surefire-junit5-tree-reporter).\n- Its purpose is simple: **\"What happened to my test cases?\"** That’s exactly what it shows—straight to the point, no\n  clutter.\n- By following this [post](https://medium.com/wearewaes/my-journey-to-a-clear-test-output-in-maven-df82fe272249)\n  by [Fabricio](https://github.com/fabriciorby),\n  I was able to configure it easily and get the clean output shown below.\n- The output works locally and in GitHub Actions as well.\n- Huge respect and thanks to the author for this\n  brilliant [work](https://github.com/fabriciorby/maven-surefire-junit5-tree-reporter?tab=readme-ov-file)!\n  ❤️\n\n\u003cimg width=\"1726\" alt=\"Web_Selenium_Logs\" src=\"https://github.com/user-attachments/assets/f67b40af-469b-4237-8956-7a64bb6713f0\" /\u003e\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=iamcharankumar/web_test_framework\u0026type=Date)](https://star-history.com/#iamcharankumar/web_test_framework\u0026Date)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamcharankumar%2Fweb_test_framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamcharankumar%2Fweb_test_framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamcharankumar%2Fweb_test_framework/lists"}