Package utils

Add a path to the python module search path.

Parameters:

• path (str) - The file path to add.
• append (bool default: False) - Either insert the path at the head of sys.path, or append to the end.

Get the path to the module that called this instance

Returns: str

The file path to the backend's class module

Parameters:

• cmd (str) - a python command to perform path translation on, according to the worker's worker_path_map. The cmd is scanned for any string wrapped in QB_CONVERT_PATH()

Returns: str

the cmd with any paths translated as necessary

Attempt to perform an authenticated copy. An existing destination file will be overwritten.

Prompt for authentication on OS X, otherwise just return an error message on other OS's upon failure.

Parameters:

• src (str) - copy source file
• dst - copy destination file

Returns: str

Return an error message; a null-string indicates success

Attempt to perform a file write that is expected to require authentication.

Parameters:

• data (str) - data to write to the destination file
• dst (str) - destination file
• concat (boolean) - if true, concat the data to the destination, otherwise overwrite destination

Returns: str

Return an error message; a null-string indicates success

Generate a time-stamped backup file name:
    qb.conf -> qb.20121231_235959.conf

@param fName: A file name
@type fName: C{str}

@return: A filename with a timestamp embedded in front of the file extension
@rtype: C{str}