Codemaru.Services.Certificates.ProcessRunner 클래스 참조

더 자세히 ...

Codemaru.Services.Certificates.ProcessRunner에 대한 상속 다이어그램 :

Codemaru.Services.Certificates.ProcessRunner에 대한 협력 다이어그램:

Public 멤버 함수
async Task< ProcessExecutionResult >	RunAsync (string fileName, string arguments, string? workingDirectory, TimeSpan timeout, int maxOutputChars, CancellationToken cancellationToken)

정적 Private 멤버 함수
static string	ResolveWorkingDirectory (string fileName, string? workingDirectory)
static void	AppendLine (StringBuilder builder, string? line, int maxOutputChars)
static void	TryKill (Process process)

상세한 설명

외부 프로세스를 실행하고 표준 출력/오류를 수집합니다.

ProcessRunner.cs 파일의 16 번째 라인에서 정의되었습니다.

멤버 함수 문서화

AppendLine()

void Codemaru.Services.Certificates.ProcessRunner.AppendLine ( StringBuilder builder, string? line, int maxOutputChars )

inlinestaticprivate

Append Line 작업을 수행합니다.

매개변수

builder	builder에 사용할 StringBuilder 값입니다.
line	line에 사용할 string? 값입니다.
maxOutputChars	max Output Chars에 사용할 int 값입니다.

ProcessRunner.cs 파일의 279 번째 라인에서 정의되었습니다.

    {
        if (string.IsNullOrEmpty(line))
        {
            return;
        }
 
        if (builder.Length >= maxOutputChars)
        {
            return;
        }
 
        builder.AppendLine(line);
 
        if (builder.Length > maxOutputChars)
        {
            builder.Length = maxOutputChars;
        }
    }

다음에 의해서 참조됨 : RunAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

ResolveWorkingDirectory()

string Codemaru.Services.Certificates.ProcessRunner.ResolveWorkingDirectory ( string fileName, string? workingDirectory )

inlinestaticprivate

Resolve Working Directory 작업을 수행합니다.

매개변수

fileName	file Name에 사용할 string 값입니다.
workingDirectory	working Directory에 사용할 string? 값입니다.

반환값

Resolve Working Directory 작업에서 생성한 string 결과입니다.

ProcessRunner.cs 파일의 237 번째 라인에서 정의되었습니다.

    {
        if (!string.IsNullOrWhiteSpace(workingDirectory))
        {
            return workingDirectory;
        }
 
        return Path.GetDirectoryName(fileName) ?? Environment.CurrentDirectory;
    }

다음에 의해서 참조됨 : RunAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

RunAsync()

async Task< ProcessExecutionResult > Codemaru.Services.Certificates.ProcessRunner.RunAsync ( string fileName, string arguments, string? workingDirectory, TimeSpan timeout, int maxOutputChars, CancellationToken cancellationToken )

inline

Run Async 작업을 수행합니다.

매개변수

fileName	file Name에 사용할 string 값입니다.
arguments	arguments에 사용할 string 값입니다.
workingDirectory	working Directory에 사용할 string? 값입니다.
timeout	timeout에 사용할 TimeSpan 값입니다.
maxOutputChars	max Output Chars에 사용할 int 값입니다.
cancellationToken	취소 요청을 감시하는 토큰입니다.

반환값

Run Async 작업에서 생성한 Task<ProcessExecutionResult> 결과입니다.

Codemaru.Services.Certificates.IProcessRunner를 구현.

ProcessRunner.cs 파일의 82 번째 라인에서 정의되었습니다.

    {
        if (string.IsNullOrWhiteSpace(fileName))
        {
            return new ProcessExecutionResult
            {
                IsSuccess = false,
                ExitCode = -1,
                Message = "Executable path is empty."
            };
        }
 
        if (!File.Exists(fileName))
        {
            return new ProcessExecutionResult
            {
                IsSuccess = false,
                ExitCode = -1,
                Message = $"Executable not found: {fileName}"
            };
        }
 
        string resolvedWorkingDirectory = ResolveWorkingDirectory(fileName, workingDirectory);
        if (!Directory.Exists(resolvedWorkingDirectory))
        {
            return new ProcessExecutionResult
            {
                IsSuccess = false,
                ExitCode = -1,
                Message = $"Working directory not found: {resolvedWorkingDirectory}"
            };
        }
 
        StringBuilder output = new();
        StringBuilder error = new();
        int outputLimit = maxOutputChars <= 0 ? 6000 : maxOutputChars;
 
        ProcessStartInfo startInfo = new()
        {
            FileName = fileName,
            Arguments = arguments,
            WorkingDirectory = resolvedWorkingDirectory,
            UseShellExecute = false,
            RedirectStandardOutput = true,
            RedirectStandardError = true,
            CreateNoWindow = true
        };
 
        using Process process = new() { StartInfo = startInfo, EnableRaisingEvents = true };
 
        try
        {
            process.OutputDataReceived += (_, e) => AppendLine(output, e.Data, outputLimit);
            process.ErrorDataReceived += (_, e) => AppendLine(error, e.Data, outputLimit);
 
            if (!process.Start())
            {
                return new ProcessExecutionResult
                {
                    IsSuccess = false,
                    ExitCode = -1,
                    Message = $"Failed to start process: {fileName}"
                };
            }
 
            process.BeginOutputReadLine();
            process.BeginErrorReadLine();
 
            using CancellationTokenSource timeoutSource = new(timeout);
            using CancellationTokenSource linkedSource = CancellationTokenSource.CreateLinkedTokenSource(
                cancellationToken,
                timeoutSource.Token);
 
            try
            {
                await process.WaitForExitAsync(linkedSource.Token).ConfigureAwait(false);
            }
            catch (OperationCanceledException)
            {
                TryKill(process);
 
                return new ProcessExecutionResult
                {
                    IsSuccess = false,
                    ExitCode = -1,
                    Output = output.ToString(),
                    Error = error.ToString(),
                    Message = timeoutSource.IsCancellationRequested
                        ? $"Process timed out: {fileName} {arguments}"
                        : $"Process canceled: {fileName} {arguments}"
                };
            }
 
            return new ProcessExecutionResult
            {
                IsSuccess = process.ExitCode == 0,
                ExitCode = process.ExitCode,
                Output = output.ToString(),
                Error = error.ToString(),
                Message = process.ExitCode == 0
                    ? "Process completed successfully."
                    : $"Process failed with exit code {process.ExitCode}."
            };
        }
        catch (Exception ex)
        {
            return new ProcessExecutionResult
            {
                IsSuccess = false,
                ExitCode = -1,
                Output = output.ToString(),
                Error = error.ToString(),
                Message = ex.Message
            };
        }
    }

다음을 참조함 : AppendLine(), Codemaru.Models.Certificates.Error, ResolveWorkingDirectory(), TryKill().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

TryKill()

void Codemaru.Services.Certificates.ProcessRunner.TryKill ( Process process )

inlinestaticprivate

Kill 작업을 시도하고 성공 여부를 반환합니다.

매개변수

process

process에 사용할 Process 값입니다.

ProcessRunner.cs 파일의 315 번째 라인에서 정의되었습니다.

    {
        try
        {
            if (!process.HasExited)
            {
                process.Kill(entireProcessTree: true);
            }
        }
        catch
        {
            // Process cleanup best effort.
        }
    }

다음에 의해서 참조됨 : RunAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• ProcessRunner.cs