Module helpers

Run the GUI to choose and download a set of implementations. If the GUI itself is due for a check, refresh it first. The user may ask the GUI to submit a bug report about the program. In that case, the GUI may ask us to test it. test_callback is called in that case with the implementations to be tested; the callback will typically call zeroinstall.injector.run.test_selections and return the result of that.

Parameters:

• iface_uri (str) - the required program
• gui_args ([str]) - any additional arguments for the GUI itself
• test_callback (zeroinstall.injector.selections.Selections -> str) - function to use to try running the program

Returns: zeroinstall.injector.selections.Selections

the selected implementations

Ensure that an implementation of uri is cached. If not, it downloads one. It uses the GUI if a display is available, or the console otherwise.

Parameters:

• uri (str) - the required interface

Returns: zeroinstall.injector.selections.Selections

a new policy for this program, or None if the user cancelled