plainbox-session-export (1)


plainbox session export [-h] [--flag FLAG] [-f FORMAT] [-p OPTIONS] [-o FILE]


Export a single session

The plainbox session export command allows to export any existing session (that can be still resumed) with any set of exporter / exporter option combinations.

The exported session representation can be printed to stdout (default) or saved to a specified file. You can pass a question mark (?) to both --output-format and --output-options for a list of available values.


Positional arguments:

Identifier of the session to export

Optional arguments:

--flag pass this resume flag to the session resume code
-f=text, --output-format=text
 save test results in the specified FORMAT (pass ? for a list of choices)
-p=, --output-options=
 comma-separated list of options for the export mechanism (pass ? for a list of choices)
-o=-, --output-file=-
 save test results to the specified FILE (or to stdout if FILE is -)


Sessions that cannot be resumed cannot be exported. Two common causes for that are known.

First of all, a session can fail to resume because of missing or changed job definitions. For that you need to re-install the exact same provider version as was available on the machine that generated the session you are trying to work with.

The second case is when a session was copied from another machine and some of the log files are pointing to a different users’ account. This can be worked around by providing appropriate symbolic links from /home/some-user/ to /home/your-user/

comments powered by Disqus