{"id":13753236,"url":"https://github.com/testng-team/testng-eclipse","last_synced_at":"2025-04-05T09:10:22.735Z","repository":{"id":50135329,"uuid":"745766","full_name":"testng-team/testng-eclipse","owner":"testng-team","description":"Eclipse plug-in for TestNG","archived":false,"fork":false,"pushed_at":"2024-04-14T15:11:55.000Z","size":67072,"stargazers_count":194,"open_issues_count":68,"forks_count":163,"subscribers_count":31,"default_branch":"master","last_synced_at":"2024-04-17T22:49:44.640Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://testng.org","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/testng-team.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","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":"2010-06-28T23:23:46.000Z","updated_at":"2024-06-18T03:58:24.972Z","dependencies_parsed_at":"2023-12-31T04:27:15.619Z","dependency_job_id":"e1ca780a-37f1-45b7-85ee-8eb7a6e05eec","html_url":"https://github.com/testng-team/testng-eclipse","commit_stats":null,"previous_names":["testng-team/testng-eclipse","cbeust/testng-eclipse"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testng-team%2Ftestng-eclipse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testng-team%2Ftestng-eclipse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testng-team%2Ftestng-eclipse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testng-team%2Ftestng-eclipse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/testng-team","download_url":"https://codeload.github.com/testng-team/testng-eclipse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247312085,"owners_count":20918344,"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":[],"created_at":"2024-08-03T09:01:18.820Z","updated_at":"2025-04-05T09:10:22.618Z","avatar_url":"https://github.com/testng-team.png","language":"Java","readme":"TestNG for Eclipse Plugin\n====\n\n[![Build Status](http://img.shields.io/travis/cbeust/testng-eclipse.svg)](https://travis-ci.org/cbeust/testng-eclipse)\n[![Join the chat at https://gitter.im/cbeust/testng-eclipse](https://badges.gitter.im/cbeust/testng-eclipse.svg)](https://gitter.im/cbeust/testng-eclipse?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![Download](https://api.bintray.com/packages/testng-team/testng-eclipse-release/updatesites/images/download.svg) ](https://bintray.com/testng-team/testng-eclipse-release/updatesites/_latestVersion)\n\n## Installation\n\n### Install Release\n\n\u003ca href=\"http://marketplace.eclipse.org/marketplace-client-intro?mpc_install=1549\" class=\"drag\" title=\"Drag to your running Eclipse workspace.\"\u003e\u003cimg class=\"img-responsive\" src=\"https://marketplace.eclipse.org/sites/all/themes/solstice/public/images/marketplace/btn-install.png\" alt=\"Drag to your running Eclipse workspace.\" /\u003e\u003c/a\u003e\n\nsee more at https://testng.org/doc/download.html\n\n### Install Snapshot\n\nThe update site to install snapshot versions of the TestNG Eclipse plug-in is:\n\n`https://testng.org/testng-eclipse-update-site`\n\nUse it if you want to experiment with the new features or verify the bug fixes, and please [report back if you encounter any issues](https://github.com/cbeust/testng-eclipse/issues).\n\nTo install it:\n* Click \"Help -\u003e Install New Software...\" on top level menu\n* Paste the url `https://testng.org/testng-eclipse-update-site` to `Work with: ` text field and press enter.\n* Select the plugins\n* Click \"Next\" button and accept the license to complete the installation.\n* Restart Eclipse\n\nIf you want to install previous version of beta, you can pick up one from [here](https://testng.org/testng-eclipse-update-site).\n\nEnjoy.\n\n### Update sites\n\nPlugin Version            | Online Update-Site | Zipped Update-Site\n------------------------- | ------------------ | ---------------------\nLATEST RELEASE   | `https://testng.org/testng-eclipse-update-site` | [here](https://testng.org/testng-eclipse-update-site)\nLATEST BETA | `https://testng.org/testng-eclipse-update-site` | [here](https://testng.org/testng-eclipse-update-site)\nHistory:||\n7.11.0.202503091801      | `https://testng.org/testng-eclipse-update-site/7.11.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.11.0.202503091801/org.testng.eclipse.updatesite.zip)\n7.10.2.202503082113      | `https://testng.org/testng-eclipse-update-site/7.10.2/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.10.2.202503082113/org.testng.eclipse.updatesite.zip)\n7.10.0.202404131040      | `https://testng.org/testng-eclipse-update-site/7.10.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.10.0.202404131040/org.testng.eclipse.updatesite.zip)\n7.9.0.202312310355      | `https://testng.org/testng-eclipse-update-site/7.9.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.9.0.202312310355/org.testng.eclipse.updatesite.zip)\n7.8.0.202308061717      | `https://testng.org/testng-eclipse-update-site/7.8.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.8.0.202308061717/org.testng.eclipse.updatesite.zip)\n7.4.0.202106051955      | `https://testng.org/testng-eclipse-update-site/7.4.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.4.0.202106051955/org.testng.eclipse.updatesite.zip)\n7.4.0.202105021622      | `https://testng.org/testng-eclipse-update-site/7.4.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.4.0.202105021622/org.testng.eclipse.updatesite.zip)\n7.3.0.202008060412      | `https://testng.org/testng-eclipse-update-site/7.3.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.3.0.202008060412/org.testng.eclipse.updatesite.zip)\n7.2.0.202005051752      | `https://testng.org/testng-eclipse-update-site/7.2.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.2.0.202005051752/org.testng.eclipse.updatesite.zip)\n7.1.1.202003100345      | `https://testng.org/testng-eclipse-update-site/7.1.1/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.1.1.202003100345/org.testng.eclipse.updatesite.zip)\n7.1.0.202003090500      | `https://testng.org/testng-eclipse-update-site/7.1.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.1.0.202003090500/org.testng.eclipse.updatesite.zip)\n7.0.0.201908240652       | `https://testng.org/testng-eclipse-update-site/7.0.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/7.0.0.201908240652/org.testng.eclipse.updatesite.zip)\n6.14.3.201902250526       | `https://testng.org/testng-eclipse-update-site/6.14.3/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.14.3.201902250526/org.testng.eclipse.updatesite.zip)\n6.14.0.201802161500       | `https://testng.org/testng-eclipse-update-site/6.14.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.14.0.201802161500/org.testng.eclipse.updatesite.zip)\n6.13.0.201712040650       | `https://testng.org/testng-eclipse-update-site/6.13.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.13.0.201712040650/org.testng.eclipse.updatesite.zip)\n6.12.0.201709050550       | `https://testng.org/testng-eclipse-update-site/6.12.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.12.0.201709050550/org.testng.eclipse.updatesite.zip)\n6.11.0.201703011520       | `https://testng.org/testng-eclipse-update-site/6.11.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.11.0.201703011520/site_assembly.zip)\n6.10.0.201612030230       | `https://testng.org/testng-eclipse-update-site/6.10.0/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.10.0.201612030230/site_assembly.zip)\n6.9.13.201609291640       | `https://testng.org/testng-eclipse-update-site/6.9.13/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.9.13.201609291640/site_assembly.zip)\n6.9.12.201607091356       | `https://testng.org/testng-eclipse-update-site/6.9.12/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.9.12.201607091356/site_assembly.zip)\n6.9.11.201604020423       | `https://testng.org/testng-eclipse-update-site/6.9.11/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.9.11.201604020423/site_assembly.zip)\n6.9.10.201512240000       | `https://testng.org/testng-eclipse-update-site/6.9.10/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.9.10.201512240000/site_assembly.zip)\n6.9.5.201505251947        | `https://testng.org/testng-eclipse-update-site/6.9.5/` | [download](https://testng.org/testng-eclipse-update-site/zipped/6.9.5.201505251947/site_assembly.zip)\n\n(**NOTE**: it's always recommended to install from the ***LATEST RELEASE*** updatesite. the version-specific updatesites are for cases that you want to stay on an old version.)\n\n## Change Logs\n\nThe full changelog is [here](CHANGES.md)\n\n## User documentation\n\nThe documentation for this plug-in can be found at https://testng.org/doc/eclipse.html\n\n## Build\n\n### Version number\n\nSet the version number with `scripts/set-version`, e.g.:\n\n```bash\nscripts/set-version 6.8.22-SNAPSHOT\n```\n\nUsing `SNAPSHOT` version numbers will generate UTC timestamped plugin-numbers, e.g. 6.8.22.201505030200.\n\n### Building\n\nOnce the version is correct, build the Eclipse plug-in as follows:\n\n```bash\n./mvnw -e -U -Dci clean install\n```\n\nThe update site package will be generated at `testng-eclipse-update-site/target/org.testng.eclipse.updatesite.zip`\n\n## Troubleshooting\n\nSee the troubleshooting doc [here](Troubleshooting.md)\n\n## For Plugin Developer\n\n### Setup Dev Env\n\n* In Eclipse, select _Import / Existing Project_ and point the dialog to\nthis directory. \n* Go to Eclipse Preference page, navigate to _Plug-in Development / Target Platform_, select 'TestNG Eclipse Luna Target Platform' as the active target platform.\n* Then you can just create a new Eclipse application launch to run the plug-in.\n\n\n### Tech Details\n\nThe runner view is called TestRunnerViewPart and it receives the test\nresults from the remote TestNG process. Every new result is passed to\n```postTestResult()``` which in turn, passes this result to each tab by\ncalling their ```updateTestResult()``` method.\n\nThe tab's logic is in ```AbstractTab```, which calculates a unique id for\neach test result and then either creates or updates the corresponding\nnode in the tree. Each node is associated with an instance of an\n```ITreeItem``` (store in its data map) which contains all the necessary\ninformation to display the label, its image, etc...\n\nThe tests are run by a subclass of ```TestNG``` called ```RemoteTestNG```. The\nEclipse client forks the ```RemoteTestNG``` process and adds itself as a\nlistener. The difference is that this listener will pass the test\nresults over the network using a serialization based protocol that can\nbe found in the ```strprotocol``` package.\n\nThe plug-in understands two system properties, which you can define as\nVM arguments in the launch dialog:\n\n   `-Dtestng.eclipse.verbose`\n\nThis will cause both the Eclipse client and RemoteTestNG to issue a\nmore verbose output.\n\n   `-Dtestng.eclipse.debug`\n\nUse this flag if you need to debug and break into RemoteTestNG. In\nthis case, you need to start the RemoteTestNG process youself as a\nregular Java application and with the \"-debug\" flag. Then start the\nEclipse client with this system property, and then the two processes\nwill communicate on a hardcoded port, 12345 (as opposed to the random\nport which they usually use) and through a hardcoded XML file\n(`\"${java.io.tmpdir}/testng-customsuite.xml\"`).\n\nNow that you launched both processes yourself, you can set up break\npoint and inspect variables on either.\n\n\n### Protocol\n\nWhen a new run is launched, TestNGLaunchConfigurationDelegate creates\na VMRunnerConfigurationClient that launches RemoteTestNG with a host,\na port and an XML file. Then Eclipse listens on this host and port.\n\nThe base class that provides the basic listening functions is\nAbstractRemoteTestRunnerClient, which is defined in TestNG. The\nEclipse plug-in subclasses this class with an\nEclipseTestRunnerClient. TestRunnerViewPart creates an instance of\nthis class and then calls startListening() on it.\n\nWhenever a new message is received, AbstractRemoteTestRunnerClient\nlooks up the type of the message and then calls the subclass's\ncorresponding method:\n\n```\nSUITE -\u003e notifyStart(GenericMessage)\nTEST -\u003e notifySuiteEvents(SuiteMessage)\nTEST_RESULT -\u003e notifyTestEvents(TestMessage)\nother -\u003e notifyResultEvents(TestResultMessage)\n```\n\nRemoteTestNG starts by opening a connection to the port passed on the\ncommand line and when it succeeds, runs the suites and uses listeners\nto send messages to the Eclipse client.\n\nAll these messages implement IStringMessage and they are of several kinds:\n\nGenericMessage: general information message (such as an initial notification of the number of suites/tests)\n\n- TestMessage\n- SuiteMessage\n- TestResultMessage\n","funding_links":[],"categories":["Don't forget to give a :star: to make the project popular"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestng-team%2Ftestng-eclipse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftestng-team%2Ftestng-eclipse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestng-team%2Ftestng-eclipse/lists"}