process.hxx

Go to the documentation of this file.

//
// Copyright (c) 2026 Jamie Kenyon. All Rights Reserved.
//
 
#pragma once
 
#include <cstdint>
#include <filesystem>
#include <memory>
#include <string>
#include <system_error>
#include <vector>
 
namespace pl
{
    struct ProcessResult
    {
        enum class Status
        {
            Success,       
            NonZeroExit,   
            FailedToStart, 
            Terminated,    
            Killed,        
            Crashed,       
            Error          
        };
 
        Status      status = Status::Error; 
        int32_t     exitCode = -1;          
        std::string message;                
 
        [[nodiscard]] auto succeeded() const -> bool
        {
            return status == Status::Success;
        }
    };
 
    class PlatformProcess; 
 
    class Process
    {
    public:
        Process();
 
        ~Process();
 
        Process(Process const&) = delete;
 
        Process& operator=(Process const&) = delete;
 
        Process(Process&&) = delete;
 
        Process& operator=(Process&&) = delete;
 
        [[nodiscard]] auto start(std::filesystem::path const& executablePath, std::vector<std::string> const& arguments) -> std::error_code;
 
        [[nodiscard]] auto terminate() -> std::error_code;
 
        [[nodiscard]] auto kill(uint32_t const exitCode = 1) -> std::error_code;
 
        [[nodiscard]] auto wait() -> ProcessResult;
 
    private:
        enum class StopRequest
        {
            None,
            Terminate,
            Kill
        };
 
        std::unique_ptr<PlatformProcess> _platformProcess;             
        StopRequest                      _stopRequest = StopRequest::None; 
    };
} // namespace pl