Marathon and MarathonITE Manual Jalian Systems Pvt. Ltd. Marathon and MarathonITE Manual Jalian Systems Pvt. Ltd. About Marathon and MarathonITE Marathon is the premier open source test automation tool for Java/Swing™ applications. Jalian Systems adopted Marathon in 2006 and is providing enhancements and support for this open source project. Based on the same open platform of Marathon, Jalian Systems provides MarathonITE - Marathon Integrated Testing Environment, a commercial enhanced version of Marathon. ©Jalian Systems Pvt. Ltd. i Table of Contents Welcome to Marathon and MarathonITE ........................................................................................... vii I. Getting Started ................................................................................................................................... 1 1. Quick Start ................................................................................................................................ 2 II. User Guide ....................................................................................................................................... 8 2. Installation ................................................................................................................................. 9 2.1. Downloading .................................................................................................................. 9 2.2. System Requirements ..................................................................................................... 9 2.3. Installation .................................................................................................................... 10 3. Detour: Launching Java Applications .................................................................................... 12 3.1. Launch Information ..................................................................................................... 12 3.2. Your Application ......................................................................................................... 12 3.3. Java command line ...................................................................................................... 13 3.4. Executable Jar .............................................................................................................. 13 3.5. Java Applets ................................................................................................................. 14 3.6. Java Webstart (JNLP) .................................................................................................. 15 3.7. Java Applications as Batch Files ................................................................................. 16 3.8. Java Executable Wrappers ........................................................................................... 17 4. Creating a Test Project ........................................................................................................... 18 4.1. Starting Marathon ........................................................................................................ 18 4.2. Project Selection Dialog .............................................................................................. 19 4.3. Project Configuration ................................................................................................... 19 4.4. Saving Project .............................................................................................................. 25 5. User Interface .......................................................................................................................... 28 5.1. Main Window .............................................................................................................. 28 5.2. Views ........................................................................................................................... 36 5.3. Navigator View ............................................................................................................ 36 5.4. Test Runner View ........................................................................................................ 39 5.5. Output View ................................................................................................................. 40 5.6. Results View ................................................................................................................ 40 5.7. Editors .......................................................................................................................... 41 6. Detour: Ruby for Marathon .................................................................................................... 42 6.1. JRuby - not ruby! ........................................................................................................ 42 6.2. Ruby Basics ................................................................................................................. 42 6.3. Marathon and Ruby ..................................................................................................... 51 7. Creating Test Scripts .............................................................................................................. 53 7.1. Test Scripts .................................................................................................................. 53 7.2. Recording Scripts ......................................................................................................... 54 7.3. Modifying Scripts ........................................................................................................ 58 8. Playing Test Scripts ................................................................................................................ 59 8.1. Playing Scripts in Editor ............................................................................................. 59 8.2. Playing Scripts Using Test Runner ............................................................................. 59 8.3. Playing Scripts From Command Line ......................................................................... 60 8.4. Ant Build File .............................................................................................................. 61 9. Debugging Scripts .................................................................................................................. 62 9.1. Debug Option ............................................................................................................... 62 9.2. Using Script Console ................................................................................................... 63 10. Managing Checklists ............................................................................................................. 65 ii Marathon and MarathonITE Manual 10.1. Checklists ................................................................................................................... 65 10.2. Creating a New Checklist .......................................................................................... 66 10.3. Modifying a Checklist ............................................................................................... 67 10.4. Deleting a Checklist ................................................................................................... 68 11. Exploratory Testing .............................................................................................................. 69 11.1. Introducing Exploratory Testing ................................................................................ 69 11.2. Recording Findings .................................................................................................... 70 11.3. Attaching a screenshot ............................................................................................... 71 11.4. Stopping the Test ....................................................................................................... 72 11.5. Sharing the Results .................................................................................................... 72 12. Semi Automatic Tests ........................................................................................................... 73 12.1. Why Semi Automatic Tests ....................................................................................... 73 12.2. Using Semi Automatic Tests ..................................................................................... 73 12.3. Creating A Semi Automatic Test .............................................................................. 74 12.4. Running Semi Automatic Tests ................................................................................. 75 13. Fixtures .................................................................................................................................. 76 13.1. Marathon Fixtures ...................................................................................................... 76 13.2. Using Fixtures ............................................................................................................ 76 13.3. Creating Fixtures ........................................................................................................ 77 13.4. Modifying a Fixture ................................................................................................... 78 13.5. Deleting Fixtures ........................................................................................................ 78 14. Modularizing