/*
 * Copyright (c) Contributors to the Open 3D Engine Project.
 * For complete copyright and license terms please see the LICENSE at the root of this distribution.
 *
 * SPDX-License-Identifier: Apache-2.0 OR MIT
 *
 */

#pragma once

#include <TestImpactFramework/TestImpactRuntime.h>

#include <AzCore/std/optional.h>
#include <AzCore/std/string/string.h>

namespace TestImpact
{
    //! Identifier to distinguish between processes.
    using ProcessId = size_t;

    //! Return code of successfully launched process.
    using ReturnCode = int;

    //! Error code for processes that are forcefully terminated whilst in-flight by the client.
    inline constexpr const ReturnCode ProcessTerminateErrorCode = 0xF10BAD;

    //! Error code for processes that are forcefully terminated whilst in-flight by the scheduler due to timing out.
    inline constexpr const ReturnCode ProcessTimeoutErrorCode = 0xBADF10;

    //! Specifier for how the process's standard out willt be routed
    enum class StdOutputRouting
    {
        ToParent,
        None
    };

    enum class StdErrorRouting
    {
        ToParent,
        None
    };

    //! Container for process standard output and standard error.
    struct StdContent
    {
        AZStd::optional<AZStd::string> m_out;
        AZStd::optional<AZStd::string> m_err;
    };

    //! Information about a process the arguments used to launch it.
    class ProcessInfo
    {
    public:
        //! Provides the information required to launch a process.
        //! @param processId Client-supplied id to diffrentiate between processes.
        //! @param stdOut Routing of process standard output.
        //! @param stdErr Routing of process standard error.
        //! @param processPath Path to executable binary to launch.
        //! @param startupArgs Arguments to launch the process with.
        ProcessInfo(
            ProcessId processId,
            StdOutputRouting stdOut,
            StdErrorRouting stdErr,
            const RepoPath& processPath,
            const AZStd::string& startupArgs = "");
        ProcessInfo(ProcessId processId, const RepoPath& processPath, const AZStd::string& startupArgs = "");

        //! Returns the identifier of this process.
        ProcessId GetId() const;

        //! Returns whether or not stdoutput is routed to the parent process.
        bool ParentHasStdOutput() const;

        //! Returns whether or not stderror is routed to the parent process.
        bool ParentHasStdError() const;

        // Returns the path to the process binary.
        const RepoPath& GetProcessPath() const;

        //! Returns the command line arguments used to launch the process.
        const AZStd::string& GetStartupArgs() const;

    private:
        const ProcessId m_id;
        const bool m_parentHasStdOutput;
        const bool m_parentHasStdErr;
        const RepoPath m_processPath;
        const AZStd::string m_startupArgs;
    };
} // namespace TestImpact