zeroinstall.helpers

get_selections_gui(iface_uri, gui_args, test_callback=None)

Run the GUI to choose and download a set of implementations. 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, or None to show just the preferences dialog
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

Since: 0.28

ensure_cached(uri, command='run', config=None)

source code

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

the selected implementations, or None if the user cancelled

Module helpers

get_selections_gui(iface_uri, gui_args, test_callback=None)

ensure_cached(uri, command='run', config=None)