11.02 - Converters

From file...

• • to configuration.selenium

Category-Name: configuration.selenium

What: This converter creates a configuration.selenium resource, usable to launch a Selenium Server for selenium RC tests.

CONVERT {resourceToConvert<Res:file>} TO configuration.selenium (configuration.selenium) AS {converted<Res:configuration.selenium>}

Input:

• • resourceToConvert<Res:file>: The name (in the context) of the resource which references a configuration file for a Selenium sever. ('.properties')

Output:

• • converted<Res:configuration.selenium>: The name of the converted resource (Resource of category configuration.selenium).

Example:

LOAD selenium/selenium-conf.properties AS selenium-conf.file

CONVERT selenium-conf.file TO configuration.selenium AS selenium-conf

• • to script.html.selenium

Category-Name: script

What: This 'script' converter will convert a resource of category 'file' to a resource of category 'script.html.selenium'.

CONVERT {resourceToConvert<Res:file>} TO script.html.selenium (script) USING {conf<Res:file>} AS{converted<Res:script.html.selenium>}

Input:

• • resourceToConvert<Res:file>: The name (in the context) of the resource which references the root directory containing the sources needed for a selenium test suite at the format "selenese".

  • conf<Res:file>: The name of the resource which references a configuration file which can contain two keys :

    • • mainpath: The path (relative to the root directory of the bundle) to the html file containing the test suite.

        • browser: The browser to use (To retrieve the list of possible values see: http://stackoverflow.com/questions/1317055/how-to-run-google-chrome-with-selenium-rc)

It can be define via an inline instruction.

Output:

• • converted<Res:script.html.selenium>: The name of the converted resource. (Resource of category script.html.selenium)

Example:

LOAD path/to/rootDirectory AS directory

CONVERT directory TO script.html.selenium (script) USING (mainpath:relative/path/to/suite.html) AS selenese.bundle

From script.java...

• • to script.java.selenium1

Category-Name: script

What: this 'script' converter create a selenium test resource suitable (Resource of category 'script.java.selenium1) for use with the ('execute' 'script.java.selenium1') command from a 'script.java' resource.

CONVERT {resourceToConvert<Res:script.java>} TO script.java.selenium1(script) USING {conf<Res:file>} AS {converted<Res:script.java.selenium1>}

Input:

• • resourceToConvert<Res:script.java>: The name (in the context) of the resource which references a java bundle which contains the source code, the compiled code and the resources of a selenium1 test suite.

  • conf<Res:file>:(Optional) The name of the resource which references a configuration file which can contain only one key:

    • mainClass: The qualified name of the main java class. The configuration must be supplied as a text file with one line containing the qualified name. If you give more, the last read line becomes the main class name. This parameter may be used if you have only one selenium test suite. On the other hand, if your selenium test bundle contains several test suite sharing helper code resources and dependencies, you may omit the main class name and rather give that parameter in the configuration of your various execute commands. It can be defined via an inline instruction.

Output:

• • converted<Res:script.java.selenium1>: The name of the converted resource. (Resource of category script.java.selenium1)

Example:

LOAD selenium AS seleniumTestSource

CONVERT seleniumTestSource TO script.java (compile) AS seleniumTestCompiled

CONVERT seleniumTestCompiled TO script.java.selenium1 (script) USING $(org.squashtest.Selenium1JUnit3) AS seleniumTest

• • to script.java.selenium2

Category-Name: script

What: this 'script' converter create a selenium test resource suitable (Resource of category 'script.java.selenium2) for use with the ('execute' 'script.java.selenium2') command from a 'script.java' resource.

CONVERT {resourceToConvert<Res:script.java>} TO script.java.selenium2 (script) USING {conf<Res:file>} AS {converted<Res:script.java.selenium2>}

Input:

• • resourceToConvert<Res:script.java>: The name (in the context) of the resource which references a java bundle which contains the source code, the compiled code and the resources of a selenium2 test suite.

  • conf<Res:file>:(Optional) The name of the resource which references a configuration file which can contain only one key:

    • mainClass: The qualified name of the main java class. The configuration must be supplied as a text file with one line containing the qualified name. If you give more, the last read line becomes the main class name. This parameter may be used if you have only one selenium test suite. On the other hand, if your selenium test bundle contains several test suite sharing helper code resources and dependencies, you may omit the main class name and rather give that parameter in the configuration of your various execute commands. It can be defined via an inline instruction.

Output:

• • converted<Res:script.java.selenium2>: The name of the converted resource. (Resource of category script.java.selenium2)

Example:

LOAD selenium AS seleniumTestSource

CONVERT seleniumTestSource TO script.java (compile) AS seleniumTestCompiled

CONVERT seleniumTestCompiled TO script.java.selenium2 (script) USING $(org.squashtest.Selenium2JUnit4WithResourceDependency)AS seleniumTest