Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "DSDP/TM/JUnittests Framework Documentation"

< DSDP‎ | TM
Line 18: Line 18:
 
'''Precondition:''' Both JDT and PDE needs to be installed and activated.
 
'''Precondition:''' Both JDT and PDE needs to be installed and activated.
  
# Open the Eclipse Launch Configuration Dialog in Run mode (Run -> Run...)
+
# Open the Eclipse Launch Configuration Dialog in Run mode (Run -> Run...).
# Expand the "''JUnit Plug-in test''" category if not expanded anyway
+
# Expand the "''JUnit Plug-in test''" category if not expanded anyway.
# Select the pre-configured launch configuration named "''RSE Combined Test Suite''"
+
# Select the pre-configured launch configuration named "''RSE Combined Test Suite''".
# Choose "''Duplicate''" either from the context menu or from the tree toolbar
+
# Choose "''Duplicate''" either from the context menu or from the tree toolbar.
 +
# Change the launch configuration name of the duplicate to identify your test suites launch configuration.
 +
# If your test suite is in another project than "''org.eclipse.rse.tests''", click now on the "''Browse...''" right after the "''Project''" entry field and select the project which contains your test suite.
 +
# Click on the "''Select...''" button right after the "''Test class''" and choose your test suite or test case to run.
 +
# Switch to the "''Main''" tab and check all settings to be as you want them. Usely you can leave them with their defaults.
 +
# Switch to the "''Arguments''" tab and check all settings to be as you want them. Usely you can leave them with their defaults.
 +
# Switch to the "''Environment''" tab if you require to set a specific environment to enable your test suite to run.
 +
# '''Switch to the "''Common''" tab and change the "''Save as''" setting to "''Local file''".'''
 +
# Click on the "''Run''" button to execute the launch configuration.
  
 +
The ''JUnit'' view will open, near to the ''Problems'' view, to show the progress, successes and failures in executing the single test cases. Inspect the failures within the failure trace part for analysing why a test case might have failed. You have real great navigation possibilities and comparisation support from there.
 +
In case that the ''JUnit'' view is not opened automatically, you can open the view via ''Window -> Show View -> Other ... -> Java -> JUnit''.
  
 
=== Launching the DSDP-TM JUnit tests from within the currently running Eclipse instance ===
 
=== Launching the DSDP-TM JUnit tests from within the currently running Eclipse instance ===

Revision as of 09:34, 29 December 2006

Hitch-Hacker's Guide to Using and Writing DSDP-TM (aka RSE) JUnit tests

This page is giving a introduction to the usage of the DSDP-TM JUnit tests framework as well as providing How To's and short descriptions of the features available in the framework for JUnit test developers.

Note: The page is under on-going maintenance and will be updated if the framework is changed or extended!

Using the DSDP-TM JUnit tests

Using means running the test cases either within a target platform Eclipse or within the currently executing Eclipse instance. There is basically only one question to distiguish between the two use cases:

Do you only use RSE within your currently running Eclipse environment for remote system connectivity or do you develop plugin(s) based on RSE and/or using RSE API?

  • If you answer I develop plugin(s) using RSE API and/or I contribute/plan to contribute actively to RSE. -> see section 2.1
  • If you answer I only use RSE within my running Eclipse for accessing remote systems. -> see section 2.2
  • If you cannot answer the above question clearly (because you may simple fall in both user groups at the same time), you may choose the use case with can serve your needs most efficiently.

Launching the DSDP-TM JUnit tests as JUnit Plug-in Test

Precondition: Both JDT and PDE needs to be installed and activated.

  1. Open the Eclipse Launch Configuration Dialog in Run mode (Run -> Run...).
  2. Expand the "JUnit Plug-in test" category if not expanded anyway.
  3. Select the pre-configured launch configuration named "RSE Combined Test Suite".
  4. Choose "Duplicate" either from the context menu or from the tree toolbar.
  5. Change the launch configuration name of the duplicate to identify your test suites launch configuration.
  6. If your test suite is in another project than "org.eclipse.rse.tests", click now on the "Browse..." right after the "Project" entry field and select the project which contains your test suite.
  7. Click on the "Select..." button right after the "Test class" and choose your test suite or test case to run.
  8. Switch to the "Main" tab and check all settings to be as you want them. Usely you can leave them with their defaults.
  9. Switch to the "Arguments" tab and check all settings to be as you want them. Usely you can leave them with their defaults.
  10. Switch to the "Environment" tab if you require to set a specific environment to enable your test suite to run.
  11. Switch to the "Common" tab and change the "Save as" setting to "Local file".
  12. Click on the "Run" button to execute the launch configuration.

The JUnit view will open, near to the Problems view, to show the progress, successes and failures in executing the single test cases. Inspect the failures within the failure trace part for analysing why a test case might have failed. You have real great navigation possibilities and comparisation support from there. In case that the JUnit view is not opened automatically, you can open the view via Window -> Show View -> Other ... -> Java -> JUnit.

Launching the DSDP-TM JUnit tests from within the currently running Eclipse instance

Back to the top