uproctrace

@@ -81,11 +81,23 @@ upt-tool mytrace.upt dump

 ## Graphical User interface

-To explore a trace in the graphical user interface, run:

+To explore a trace in the graphical user interface (GUI), run:

 ```

 upt-tool mytrace.upt gui

 ```

+The left half of the GUI shows the process tree with a few selected details

+about each process.  The right half shows further details of the process

+selected on the left side.

+

+By double-clicking on the entries in the right tree view, their content can be

+copied to the clipboard. If a row with subordinate rows is double-clicked, the

+contents of all the subordinate entries are copied to the clipboard, using

+proper shell-escaping of the individual entries. If a process row on the left

+side is double-clicked, a shell command for repeating the execution of the

+process (including working directory, environment variables and command line)

+is copied to the clipboard.

+

 ## Example: Trace Build Process

 To show the capabilities of the UProcTrace, a process that calls several child

@@ -81,6 +81,7 @@

                     <property name="fixed_height_mode">True</property>

                     <property name="enable_tree_lines">True</property>

                     <signal name="cursor-changed" handler="onProcessesCursorChanged" swapped="no"/>

+                    <signal name="row-activated" handler="onProcessesRowActivated" swapped="no"/>

                     <child internal-child="selection">

                       <object class="GtkTreeSelection"/>

                     </child>

@@ -182,7 +182,8 @@ class UptGui:

         handlers = {

             'onDestroy': self.onDestroy,

             'onDetailsRowActivated': self.onDetailsRowActivated,

-            'onProcessesCursorChanged': self.onProcessesCursorChanged

+            'onProcessesCursorChanged': self.onProcessesCursorChanged,

+            'onProcessesRowActivated': self.onProcessesRowActivated

         }

         self.builder.connect_signals(handlers)

         # open trace file

@@ -296,6 +297,38 @@ class UptGui:

         # show details of selected process

         self.showDetails(proc_id)

+    def onProcessesRowActivated(self, _widget, _row, _col):

+        """

+        Row in processes view has been activated.

+        """

+        # get selected row (if any)

+        processes_sel = self.wid_processes_view.get_selection()

+        if processes_sel is None:

+            return

+        processes_iter = processes_sel.get_selected()[1]

+        if processes_iter is None:

+            return

+        # get process

+        proc_id = self.wid_processes_tree.get_value(processes_iter,

+                                                    self.PROC_PROC_ID)

+        if proc_id is None or proc_id < 0:

+            return

+        proc = self.processes.getProcess(proc_id)

+        if proc is None:

+            return

+        # copy shell command line to repeat process call to clipboard

+        # ( cd <workdir>; env -i <environment> <cmdline> )

+        string = '('

+        if proc.cwd:

+            string += ' cd ' + cmdline_str_escape(proc.cwd) + ';'

+        if proc.environ:

+            string += ' env -i ' + cmdline2str(sorted(proc.environ))

+        if proc.cmdline:

+            string += ' ' + cmdline2str(proc.cmdline)

+        string += ' )'

+        self.clipboard.set_text(string, -1)

+        self.clipboard.store()

+

     def openTrace(self, proto_filename: str):

         """

         Open a trace file.