Location Manager

Description

The Test Engine finds resources in the file system using locations. Each resource type has a default location. You can remap any location to a different folder in the file system.

For example, the document renderer looks for all pictures in the pictures location. That means that whatever the file name of the picture, the folder associated with the location pictures is prepended to it.

Locations have a root and a path part. The root specifies another location, which can be empty. If a root location is given, then the location's full path is the root's full path with the location's path appended to it. Locations can be nested into complex hierarchies in this way.

For example, with default locations, when the renderer requests the pictures location, the Location Manager must:

1. Retrieve the pictures location, its root points to the data location
2. Retrieve the data location, its root points to the project location
3. Retrieve the project location, it has no root
4. Return the path project.path + data.path + pictures.path

If the picture's file name is 'special\logos\big_logo.bmp' and the project file is in 'c:\test_engine\project1', then the final path is:

c:\test_engine\project1\data\pictures\special\logos\big_logo.bmp

The file name specified in the EML file can have extra sub-folders with it. Use the Windows separator character for folder names. The Test Engine will convert the separators if the platform requires it. Also note that all separators are automatically added for concatenated folders.