ost.settings - Locate Files and Retrieve Preferences¶

exception ost.settings.FileNotFound(name, reason)¶

Raised when Locate() is unable to locate a file. The exception contains detailed information on what was tried to locate the file, i.e. search paths, environment variables and also provides useful hints on how to let Locate know where to find the file.

ost.settings.GetValue(val_key, val_default=None, prefix='OST')¶

Returns the value of the variable val_key if defined, otherwise returns the default value provided by the user (if provided). Search order:

• environment variable called $prefix_$val_key
• variable called val_key in .ostrc file

ost.settings.Locate(file_name, explicit_file_name=None, search_paths=[], env_name=None, search_system_paths=True)¶

Helper function to locate files. To get the full name of an executable, let’s say qmake, use

abs_qmake_path=Locate('qmake', env_name='QMAKE_EXECUTABLE')

First the function checks if an environment variable with the name QMAKE_EXECUTABLE is set. If so, the value of this variable is returned. Next, each directory listed in search_paths is searched. If the executable could still not be found and search_system_paths is set to True, the binary search paths are searched.

If the file could not be located, a FileNotFound exception will be raised containing a detail description why Locate failed. The error message is formatted in such a way that it can directly be presented to the user.