process.h

#ifndef SOURCEMETA_CORE_PROCESS_H_
#define SOURCEMETA_CORE_PROCESS_H_
 
#ifndef SOURCEMETA_CORE_PROCESS_EXPORT
#include <sourcemeta/core/process_export.h>
#endif
 
// NOLINTBEGIN(misc-include-cleaner)
#include <sourcemeta/core/process_error.h>
// NOLINTEND(misc-include-cleaner)
 
#include <filesystem>       // std::filesystem
#include <initializer_list> // std::initializer_list
#include <map>              // std::map
#include <optional>         // std::optional
#include <span>             // std::span
#include <string>           // std::string
#include <string_view>      // std::string_view

 
namespace sourcemeta::core {

struct ProcessInput {
  std::filesystem::path directory{std::filesystem::current_path()};
  std::optional<std::map<std::string_view, std::string_view>> environment{
      std::nullopt};

  std::string_view standard_input{};
};

SOURCEMETA_CORE_PROCESS_EXPORT
auto spawn(const std::string &program,
           std::initializer_list<std::string_view> arguments,
           const ProcessInput &input = {}) -> int;

SOURCEMETA_CORE_PROCESS_EXPORT
auto spawn(const std::string &program,
           std::span<const std::string_view> arguments,
           const ProcessInput &input = {}) -> int;

struct ProcessOutput {
  std::optional<int> exit_code{std::nullopt};
  std::string standard_output{};
  std::string standard_error{};
};

SOURCEMETA_CORE_PROCESS_EXPORT
auto spawn_and_capture(const std::string &program,
                       std::initializer_list<std::string_view> arguments,
                       const ProcessInput &input = {}) -> ProcessOutput;

SOURCEMETA_CORE_PROCESS_EXPORT
auto spawn_and_capture(const std::string &program,
                       std::span<const std::string_view> arguments,
                       const ProcessInput &input = {}) -> ProcessOutput;
 
} // namespace sourcemeta::core
 
#endif