{"id":15020901,"url":"https://github.com/telekom/testerra","last_synced_at":"2025-04-09T09:07:56.798Z","repository":{"id":36968951,"uuid":"270631519","full_name":"telekom/testerra","owner":"telekom","description":"Testerra is an integrated framework for automating tests for (web) applications. ","archived":false,"fork":false,"pushed_at":"2025-02-11T17:11:21.000Z","size":67727,"stargazers_count":32,"open_issues_count":15,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-03T00:48:09.794Z","etag":null,"topics":["automation","java","selenium","testerra","testframework","testng","webdriver"],"latest_commit_sha":null,"homepage":"https://docs.testerra.io/","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/telekom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-08T10:49:52.000Z","updated_at":"2025-03-06T18:36:19.000Z","dependencies_parsed_at":"2023-12-20T12:51:47.819Z","dependency_job_id":"4c6a8749-4ef8-40af-9a6b-23ec269be186","html_url":"https://github.com/telekom/testerra","commit_stats":{"total_commits":4720,"total_committers":46,"mean_commits":102.6086956521739,"dds":0.5158898305084746,"last_synced_commit":"89e4ae62b821129ecbee3c8e26ba0881a6d0d2ef"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2Ftesterra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2Ftesterra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2Ftesterra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2Ftesterra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telekom","download_url":"https://codeload.github.com/telekom/testerra/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248008630,"owners_count":21032556,"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":["automation","java","selenium","testerra","testframework","testng","webdriver"],"created_at":"2024-09-24T19:55:49.670Z","updated_at":"2025-04-09T09:07:56.762Z","avatar_url":"https://github.com/telekom.png","language":"Java","funding_links":[],"categories":["测试"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n    Testerra\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://mvnrepository.com/artifact/io.testerra\" title=\"MavenCentral\"\u003e\u003cimg alt=\"Maven Central\" src=\"https://img.shields.io/maven-central/v/io.testerra/core/2?label=Maven%20Central\"\u003e\u003c/a\u003e\n    \u003ca href=\"/../../commits/\" title=\"Last Commit\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/telekom/testerra?style=flat\"\u003e\u003c/a\u003e\n    \u003ca href=\"/../../issues\" title=\"Open Issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/telekom/testerra?style=flat\"\u003e\u003c/a\u003e\n    \u003ca href=\"./LICENSE\" title=\"License\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-green.svg?style=flat\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#setup\"\u003eSetup\u003c/a\u003e •\n  \u003ca href=\"#documentation\"\u003eDocumentation\u003c/a\u003e •\n  \u003ca href=\"#extras\"\u003eExtras\u003c/a\u003e •\n  \u003ca href=\"#support-and-feedback\"\u003eSupport\u003c/a\u003e •\n  \u003ca href=\"#how-to-contribute\"\u003eContribute\u003c/a\u003e •\n  \u003ca href=\"#contributors\"\u003eContributors\u003c/a\u003e •\n  \u003ca href=\"#licensing\"\u003eLicensing\u003c/a\u003e\n\u003c/p\u003e\n\n## About Testerra\n\n\u003cp align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./docs/src/images/s_Testerra_Logo_0256px.png\"\u003e\n        \u003cimg alt=\"Text changing depending on mode. Light: 'So light!' Dark: 'So dark!'\" src=\"./docs/src/images/w_Testerra_Logo_0256px.png\"\u003e\n    \u003c/picture\u003e\n\u003c/p\u003e\n\nIt is an integrated Java framework for automating tests for (web) applications. Testerra can also be understood as a building block for test automation projects with various basic components.\n\nYou may see Testerra as an open source test automation library for web frontend testing. It provides a tool suite for many use cases: a base API for Page Object Pattern (including responsive layouts) and GuiElements (smarter WebElements (Selenium)), enhanced reporting functionality, a utility collection and some additional helpful modules.\n\nTesterra is developed by our Test Automation Experts at Telekom MMS in Dresden. In numerous projects Testerra is used as the standard test automation framework and includes the experience of more then 10 years of test automation.\n\n**This is the branch of Testerra 2. For Testerra 1 go to https://github.com/telekom/testerra/tree/testerra1** \n\n## Setup\n\nInclude the following dependency in your project.\n\nGradle:\n```groovy\ndependencies {\n    implementation 'io.testerra:driver-ui-desktop:2.10'\n    implementation 'io.testerra:report-ng:2.10'\n}\n```\n\nMaven:\n```xml\n\u003cdependencies\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.testerra\u003c/groupId\u003e\n        \u003cartifactId\u003edriver-ui-desktop\u003c/artifactId\u003e\n        \u003cversion\u003e2.10\u003c/version\u003e\n    \u003c/dependency\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.testerra\u003c/groupId\u003e\n        \u003cartifactId\u003ereport-ng\u003c/artifactId\u003e\n        \u003cversion\u003e2.10\u003c/version\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\nTesterra requires **JDK11** or later and uses **Selenium 4**.\n\n### Using Testerra functionality\n\nCreate a Test Class and extend the TesterraTest class:\n\n````java\npublic class MyTest extends TesterraTest implements UiElementFinderFactoryProvider, WebDriverManagerProvider {\n    \n    @Test\n    public void testT01_My_first_tt_test() {\n        UiElementFinder finder = UI_ELEMENT_FINDER_FACTORY.create(WEB_DRIVER_MANAGER.getWebDriver());\n        \n        finder.find(By.name(\"q\"))\n                .type(\"Hello World\")\n                .expect().value().endsWith(\"Hello\").is(false);\n    }\n}\n````\n\n## Documentation\n\n* Check out our comprehensive [Testerra 2 documentation](https://docs.testerra.io/testerra/2-latest/index.html)!\n* Feel free to try out our ready-to-use [Skeleton project][testerra-skeleton].\n* Some more features can be found [in the Testerra demo project][testerra-demo].\n\n## Extras\n\n### Testing\n\nEvery module contains tests that can be run like\n```shell\ngradle test\n```\n\nAdditional test properties are listed in the module's README. \n\nActivate Jacoco code coverage analysis by \n```shell\ngradle testCodeCoverageReport\n```\ninstead of ``gradle test``\n\n### License report\n\nCreate a report about used licenses for every dependency:\n\n``gradle generateLicenseReport``\n\nYou will find the reports of all modules under  ``license3rdparty``.\n\n### SBOM reports\n\nCreate an SBOM reports for every module:\n\n``gradle cyclonedxBom``\n\nYou will find the JSON files under ``\u003croot-project\u003e/build/sbom``\n\n### Publishing\n\nTesterra is deployed and published to Maven Central. All JAR files are signed via Gradle signing plugin.\n\nThe following properties have to be set via command line or ``~/.gradle/gradle.properties``\n\n| Property                    | Description                                           |\n|-----------------------------|-------------------------------------------------------|\n| `ttVersion`                 | Version of deployed Testerra, default is `2-SNAPSHOT` |\n| `deployUrl`                 | Maven repository URL                                  |\n| `deployUsername`            | Maven repository username                             |\n| `deployPassword`            | Maven repository password                             |\n| `signing.keyId`             | GPG private key ID (short form)                       |\n| `signing.password`          | GPG private key password                              |\n| `signing.secretKeyRingFile` | Path to GPG private key                               |\n\nIf all properties are set, call the following to build, deploy and release Testerra:\n````shell\ngradle buildReport publish closeAndReleaseRepository\n````\n\n## Code of Conduct\n\nThis project has adopted the [Contributor Covenant](https://www.contributor-covenant.org/) in version 2.0 as our code of conduct. Please see the details in our [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). All contributors must abide by the code of conduct.\n\n## Working Language\n\nWe decided to apply _English_ as the primary project language.  \n\nConsequently, all content will be made available primarily in English. We also ask all interested people to use English as language to create issues, in their code (comments, documentation etc.) and when you send requests to us. The application itself and all end-user faing content will be made available in other languages as needed.\n\n\n## Support and Feedback\nThe following channels are available for discussions, feedback, and support requests:\n\n| Type               | Channel                                                                                                                                                                              |\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Issues**         | \u003ca href=\"https://github.com/telekom/testerra/issues/new/choose\" title=\"Issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/telekom/testerra?style=flat\"\u003e\u003c/a\u003e                      |\n| **Other Requests** | \u003ca href=\"mailto:testerra@t-systems-mms.com\" title=\"Email us\"\u003e\u003cimg src=\"https://img.shields.io/badge/email-Testerra%20team-green?logo=mail.ru\u0026style=flat-square\u0026logoColor=white\"\u003e\u003c/a\u003e |\n\n## Additional repositories\n\n### Testerra extensions\n\n| Repository                        | Description                     |\n|-----------------------------------|---------------------------------|\n| [testerra-skeleton]               | Testerra Skeleton Project       |\n| [testerra-demo]                   | Testerra demo projects          |\n| [testerra-selenoid-connector]     | Testerra Selenoid Connector     |\n| [testerra-hpqc-connector]         | Testerra HPQC Connector         |\n| [testerra-teamcity-connector]     | Testerra TeamCity Connector     |\n| [testerra-cucumber-connector]     | Testerra Cucumber Connector     |\n| [testerra-xray-connector]         | Testerra Xray Connector         |\n| [testerra-appium-connector]       | Testerra Appium Connector       |\n| [testerra-azure-devops-connector] | Testerra Azure DevOps Connector |\n\n[testerra]: https://github.com/telekom/testerra\n[testerra-skeleton]: https://github.com/telekom/testerra-skeleton\n[testerra-demo]: https://github.com/telekom-mms/testerra-demo\n[testerra-selenoid-connector]: https://github.com/telekom/testerra-selenoid-connector\n[testerra-hpqc-connector]: https://github.com/telekom/testerra-hpqc-connector\n[testerra-teamcity-connector]: https://github.com/telekom/testerra-teamcity-connector\n[testerra-cucumber-connector]: https://github.com/telekom/testerra-cucumber-connector\n[testerra-xray-connector]: https://github.com/telekom/testerra-xray-connector\n[testerra-appium-connector]: https://github.com/telekom/testerra-appium-connector\n[testerra-azure-devops-connector]: https://github.com/telekom/testerra-azure-devops-connector\n\n### Legacy Testerra modules\n\nYou will find outdated Testerra modules here: https://github.com/telekom/testerra-legacy\n\n## How to Contribute\n\nContribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](./CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](./CODE_OF_CONDUCT.md) at all times.\n\n## Contributors\n\nAt the same time our commitment to open source means that we are enabling -in fact encouraging- all interested parties to contribute and become part of its developer community.\n\n## Licensing\n\nCopyright (c) 2020 Deutsche Telekom AG.\n\nLicensed under the **Apache License, Version 2.0** (the \"License\"); you may not use this file except in compliance with the License.\n\nYou may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the [LICENSE](./LICENSE) for the specific language governing permissions and limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelekom%2Ftesterra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelekom%2Ftesterra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelekom%2Ftesterra/lists"}