Merge branch 'wrapper' into 'master'

introduce DECKARD_WRAPPER env variable for easier debugging

See merge request !188

deckard.py

@@ -3,6 +3,7 @@ import errno
 import logging
 import logging.config
 import os
+import shlex
 import shutil
 import socket
 import subprocess
@@ -110,7 +111,11 @@ def run_daemon(program_config):
     proc = None
     program_config['log'] = os.path.join(program_config["WORKING_DIR"], 'server.log')
     daemon_log_file = open(program_config['log'], 'w')
-    program_config['args'] = [program_config['binary']] + program_config['additional']
+    program_config['args'] = (
+        shlex.split(os.environ.get('DECKARD_WRAPPER', ''))
+        + [program_config['binary']]
+        + program_config['additional']
+    )
     logging.getLogger('deckard.daemon.%s.argv' % name).debug('%s', program_config['args'])
     try:
         proc = subprocess.Popen(program_config['args'], stdout=daemon_log_file,

doc/user_guide.rst

@@ -269,6 +269,7 @@ Tips:
 - working directory can be explicitly specified in environment variable ``DECKARD_DIR`
 - command line argument ``--log-level DEBUG`` forces extra verbose logging, including logs from all binaries and packets handled by Deckard
 - environment variable ``DECKARD_NOCLEAN`` instructs Deckard not to remove working directories after successful tests
+- environment variable ``DECKARD_WRAPPER`` is prepended to all commands to be executed, intended usage is to run binary under test with ``valgrind`` or ``rr record``
 
 
 Writting own scenarios