| 1 | PlanetSim |
|---|
| 2 | --------------- |
|---|
| 3 | @author Jordi Pujol jordi.pujol@estudiants.urv.es |
|---|
| 4 | http://ants.etse.urv.es/planetsim |
|---|
| 5 | |
|---|
| 6 | 1. Content |
|---|
| 7 | ------------------------ |
|---|
| 8 | |
|---|
| 9 | This directory contains all *.bat and *.sh to run all existing |
|---|
| 10 | tests in the planet.test package and subpackages. |
|---|
| 11 | |
|---|
| 12 | The distribution of these scripts is the same than the |
|---|
| 13 | planet.test package hierarchy, using the name of the main class |
|---|
| 14 | and the subpackages to naming the script file. For example, |
|---|
| 15 | the scripts that execute the test planet.test.bad.SimNetTest |
|---|
| 16 | are called bad.SimNetTest.sh and bad.SimNetTest.bat, omitting |
|---|
| 17 | the package name "planet.test". |
|---|
| 18 | |
|---|
| 19 | |
|---|
| 20 | 2. Ant compatibility |
|---|
| 21 | ----------------------- |
|---|
| 22 | |
|---|
| 23 | There are planetsim.properties and build.xml for ant compatibility. |
|---|
| 24 | The build.xml has been tested and fully functional. |
|---|
| 25 | |
|---|
| 26 | See the results of "ant targets" in the command line. |
|---|
| 27 | |
|---|
| 28 | IMPORTANT: You need to copy the $PLANETSIM/lib/junit.jar to the $ANT_HOME/lib |
|---|
| 29 | to successfully run "ant test". |
|---|
| 30 | |
|---|
| 31 | |
|---|
| 32 | 3. How to run tests |
|---|
| 33 | ----------------------- |
|---|
| 34 | |
|---|
| 35 | If you have modified any class or added any new test, you have to |
|---|
| 36 | run "$ ant jar" or "> ant jar" in this directory to build the |
|---|
| 37 | ../lib/planetsim.jar distribution file. |
|---|
| 38 | |
|---|
| 39 | One recommend to run any script as follows: |
|---|
| 40 | |
|---|
| 41 | On Windows systems: |
|---|
| 42 | ...\> script_name.bat > out.txt |
|---|
| 43 | |
|---|
| 44 | On *nix systems: |
|---|
| 45 | $ ./script_name.sh > out.txt |
|---|
| 46 | |
|---|
| 47 | to capture the output to the results file named 'out.txt'. |
|---|
| 48 | |
|---|
| 49 | |
|---|
| 50 | |
|---|
| 51 | 4. GML graphs |
|---|
| 52 | ----------------------- |
|---|
| 53 | |
|---|
| 54 | This release is able to generate GML graphs representations. |
|---|
| 55 | To open any *.gml output file, use the scripts open_GML_viewer.bat/.sh |
|---|
| 56 | to see the results. |
|---|
| 57 | |
|---|
| 58 | The Yed library is used. See ../lib/*_yed.html for more details. |
|---|
| 59 | |
|---|
| 60 | |
|---|
| 61 | |
|---|
| 62 | 3. Feedback |
|---|
| 63 | ----------------------- |
|---|
| 64 | |
|---|
| 65 | You can make a very good feedback send us your suggestions and |
|---|
| 66 | errors. Email us to Jordi Pujol <jordi.pujol@estudiants.urv.es> |
|---|
| 67 | |
|---|
| 68 | On any error or problem cases, you have to send these information: |
|---|
| 69 | |
|---|
| 70 | 1. Version of Planetsim in use |
|---|
| 71 | 2. Short description of the error (or problem) |
|---|
| 72 | 3. The detail of the main classes that take part (executed test, etc.) |
|---|
| 73 | 4. The related stack trace (if exists) |
|---|
| 74 | 5. Any other remarkable information. |
|---|
| 75 | |
|---|
| 76 | NOTE: The maximum size of the sent mail is 3MB. |
|---|
| 77 | |
|---|
| 78 | |
|---|
| 79 | ----- |
|---|
| 80 | |
|---|
| 81 | Jordi Pujol |
|---|
| 82 | Planet Project Member |
|---|
| 83 | |
|---|
| 84 | Planet: http://ants.etse.urv.es/planet |
|---|
| 85 | PlanetSim: http://ants.etse.urv.es/planetsim |
|---|
| 86 | |
|---|
| 87 | July 20, 2005 |
|---|
