Merge ~kissiel/plainbox:sa-selection-midway into plainbox:master

[Maciej Kisielewski]

SessionAssistant: allow sa.hand_pick_jobs in the main loop

This allows apps to re-apply selection patterns after some jobs were run,
thus generating new selection (list of strings matching ids).

Concrete mechanics:
    start session;
    call hand_pick_jobs('.*') (selecting all _existing_ jobs)
    run resource job that generates a new job that matches above pattern
    (*NEW*) call hand_pick_jobs() again to apply the filter to the new state
    run freshly instantiated jobs
    profit!

[Sylvain Pineau (sylvain-pineau)]

+1

review: Approve

diff --git a/plainbox/impl/session/assistant.py b/plainbox/impl/session/assistant.py
index 253625f..5a72bb1 100644
--- a/plainbox/impl/session/assistant.py
+++ b/plainbox/impl/session/assistant.py
@@ -1701,6 +1701,7 @@ class SessionAssistant:
             self.get_dynamic_todo_list: "to see what is yet to be executed",
             self.run_job: "to run a given job",
             self.use_alternate_selection: "to change the selection",
+            self.hand_pick_jobs: "to generate new selection and use it",
             self.use_job_result: "to feed job result back to the session",
             # XXX: should this be available right off the bat or should we wait
             # until all of the mandatory jobs have been executed.