Usage Guide

Usage Guide

This Guide helps you familiarize yourself with the 3 tools being provided in this package.

Table of Contents

• Initial Steps
• Using Main GUI
• Using Console
• Using Test Bench

Initial Steps

1. Clone the Repository

   git clone https://github.com/Neo-Mind/WARP.git --branch <branch name> --single--branch
   

   For e.g. you can use the 'rock-win32' branch for use in Windows Environment containing Scripts for RO client.

2. Go to the OS-specific directory inside the cloned repo For e.g. 'win32'

3. Launch the tool you want and you are ready.

Using Main GUI

For Windows, it is available as WARP.exe under the 'win32' folder.

A typical workflow with the Main GUI is as follows:

1. Load the Source app.
2. Select the Patches you want.
3. Some of the Patches ask for specific inputs from you so provide them as well.
4. Once you are ready click Apply Patches to create the Target.

In case you are interested in Extensions instead:

1. Open the Extensions drawer either by clicking the top right button or swiping left from the right edge.
2. Click Load Extensions if your extension is not present. The drawer would need to opened again in this case.
3. Load the Source app if you need something from it, which is usually the case.
4. Click the Extension you want and it will run.
5. Similar to Patches, sometimes Extensions also expect specific inputs from the user so you need to provide those.
6. Once completed either a message pops up or it can open a generated file instead.

Refer Main GUI for further details about the interface.

Using Console

Console is essentially a minimalist version of Main GUI and can solely be used for patching (as of now).
You need a Session File ready with you. For Windows, the tool is available as WARP_console.exe under the 'win32' folder.

It is invoked as :

<path to WARP repo>/win32/WARP_console.exe -using <session path> [-from <source path>] [-to <target path>] [-language <language name>]

Refer Console for further details.

Using Tester GUI

For Windows, it is available as WARP_bench.exe under the 'win32' folder.

A typical workflow with the Tester GUI is as follows:

• In Patches tab, Click Get Patches and select those which you wish to test.
• In Extensions tab, Click Get Extensions and select those which you wish to test.
• In Testers tab, Specify Test Dir containing the test applications.
• Click Get Exes and select the applications you wish to use for testing.
• Finally click Run Test or press Ctrl+T to perform the tests.
• The UI will automatically switch to the Results tab and you can view the Output section to see the test results.

In case you wish to perform any script evaluations you can do so in the Script Editor section underneath Output.
It's results also get sent to the Output section.

Refer Test Bench for further details.