driver/sshdriver: add multifile support to scp

Users are accustomed to scp having an option for copying recursively as
well as to accept multiple source files.
Meet user expectation by adding well known `-r` option and support for
multiple source files.

Signed-off-by: Sebastian Gross <sgross@emlix.com>

Author: sbngross

labgrid/driver/sshdriver.py

@@ -356,25 +356,34 @@ def forward_unix_socket(self, unixsocket, localport=None):
             yield localport
 
     @Driver.check_active
-    @step(args=['src', 'dst'])
-    def scp(self, *, src, dst):
+    @step(args=['src', 'dst', 'recursive'])
+    def scp(self, *, src: str | list(str), dst: str, recursive: bool = False):
         if not self._check_keepalive():
             raise ExecutionError("Keepalive no longer running")
 
-        if src.startswith(':') == dst.startswith(':'):
+        if isinstance(src, str):
+            src = [src]
+
+        remote_src = [f.startswith(':') for f in src]
+        if any(remote_src) != all(remote_src):
+            raise ValueError("All sources must be consistently local or remote (start with :)")
+
+        if all(remote_src) == dst.startswith(':'):
             raise ValueError("Either source or destination must be remote (start with :)")
-        if src.startswith(':'):
-            src = '_' + src
-        if dst.startswith(':'):
-            dst = '_' + dst
+
+        src = [s.replace(':', '_:') for s in src]
+        dst = dst.replace(':', '_:')
 
         complete_cmd = [self._scp,
                 "-S", self._ssh,
                 "-F", "none",
                 "-o", f"ControlPath={self.control.replace('%', '%%')}",
-                src, dst,
+                *src,
+                dst,
         ]
-        
+
+        if recursive:
+            complete_cmd.insert(1, "-r")
         if self.explicit_sftp_mode and self._scp_supports_explicit_sftp_mode():
             complete_cmd.insert(1, "-s")
         if self.explicit_scp_mode and self._scp_supports_explicit_scp_mode():
@@ -594,3 +603,4 @@ def _stop_keepalive(self):
         if stdout:
             for line in stdout.splitlines():
                 self.logger.warning("Keepalive %s: %s", self.networkservice.address, line)
+