ExternalProcess.h

Go to the documentation of this file.

// Copyright (c) 2002-present, OpenMS Inc. -- EKU Tuebingen, ETH Zurich, and FU Berlin
// SPDX-License-Identifier: BSD-3-Clause
//
// --------------------------------------------------------------------------
// $Maintainer: Chris Bielow $
// $Authors: Chris Bielow $
// --------------------------------------------------------------------------
 
#pragma once
 
#include <OpenMS/DATASTRUCTURES/String.h>
 
#include <functional>
#include <map>
#include <string>
#include <vector>
 
namespace OpenMS
{
 
  class OPENMS_DLLAPI ExternalProcess
  {
  public:
    enum class RETURNSTATE
    {
      SUCCESS,  
      NONZERO_EXIT, 
      CRASH, 
      FAILED_TO_START 
    };
 
    enum class IO_MODE
    {
        NO_IO, 
        READ_ONLY,
        WRITE_ONLY,
        READ_WRITE
    };
 
    ExternalProcess();
 
    ExternalProcess(std::function<void(const String&)> callbackStdOut, std::function<void(const String&)> callbackStdErr);
 
    ~ExternalProcess();
 
    void setCallbacks(std::function<void(const String&)> callbackStdOut, std::function<void(const String&)> callbackStdErr);
 
    RETURNSTATE run(const String& exe, const std::vector<String>& args, const String& working_dir, const bool verbose, String& error_msg,
                    IO_MODE io_mode = IO_MODE::READ_WRITE,
                    const std::map<String, String>& env = {},
                    std::function<void()> idle_callback = nullptr);
 
    RETURNSTATE run(const String& exe, const std::vector<String>& args, const String& working_dir, const bool verbose,
                    IO_MODE io_mode = IO_MODE::READ_WRITE,
                    const std::map<String, String>& env = {},
                    std::function<void()> idle_callback = nullptr);
 
  private:
    std::function<void(const String&)> callbackStdOut_;
    std::function<void(const String&)> callbackStdErr_;
  };
} // ns OpenMS