datasift / storyplayer

     * @param  string $destFilename

     * @return \DataSift\Storyplayer\CommandLib\CommandResult

     */

    public function downloadFile($sourceFilename, $destFilename)

    {

        // what are we doing?

        $log = usingLog()->startAction("download file '{$this->args[0]}':'{$sourceFilename}' to '{$destFilename}'");

        // make sure we have valid host details

        $hostDetails = $this->getHostDetails();

        // get an object to talk to this host

        $host = OsLib::getHostAdapter($this->st, $hostDetails->osName);

        // upload the file

        $result = $host->downloadFile($hostDetails, $sourceFilename, $destFilename);

        // did the command used to upload succeed?

        if ($result->didCommandFail()) {

            $msg = "download failed with return code '{$result->returnCode}' and output '{$result->output}'";

            $log->endAction($msg);

            throw Exceptions::newActionFailedException(__METHOD__, $msg);

        }

        // all done

        $log->endAction();

        return $result;

    }

    /**

     * @param  string $filename

 */

class UsingHost extends HostBase

{

    public function runCommand($command)

    {

        // what are we doing?

        $log = usingLog()->startAction("run command '{$command}' on host '{$this->args[0]}'");

        // make sure we have valid host details

        $hostDetails = $this->getHostDetails();

        // get an object to talk to this host

        $host = OsLib::getHostAdapter($this->st, $hostDetails->osName);

        // run the command in the guest operating system

        $result = $host->runCommand($hostDetails, $command);

        // did the command succeed?

        if ($result->didCommandFail()) {

            $msg = "command failed with return code '{$result->returnCode}' and output '{$result->output}'";

            $log->endAction($msg);

            throw Exceptions::newActionFailedException(__METHOD__, $msg);

        }

        // all done

        $log->endAction();

        return $result;

    }

    public function runCommandAsUser($command, $user)

    {