easycmd
Go 언어로 작성된 명령어 실행 라이브러리입니다. 외부 명령어를 간편하게 실행하고 표준 입출력을 제어할 수 있는 래퍼 기능을 제공합니다.
설치
go get github.com/seungyeop-lee/easycmd
기본 사용법
간단한 명령어 실행
package main
import (
"github.com/seungyeop-lee/easycmd"
)
func main() {
cmd := easycmd.New()
err := cmd.Run("echo hello world")
if err != nil {
panic(err)
}
}
표준 출력 캡처
package main
import (
"bytes"
"fmt"
"github.com/seungyeop-lee/easycmd"
)
func main() {
out := &bytes.Buffer{}
cmd := easycmd.New(easycmd.WithStdOut(out))
err := cmd.Run("echo hello world")
if err != nil {
panic(err)
}
fmt.Println("출력:", out.String()) // 출력: hello world
}
고급 사용법
Shell 명령어 실행
cmd := easycmd.New()
// bash로 래핑된 명령어 실행
err := cmd.RunShell("(cd .. && pwd)")
// 멀티라인 shell 스크립트 실행
err = cmd.RunShell(`
pwd
ls -al
`)
PowerShell 명령어 실행 (Windows)
cmd := easycmd.New()
err := cmd.RunPowershell("Get-Location")
특정 디렉토리에서 실행
cmd := easycmd.New()
// 기본 명령어를 특정 디렉토리에서 실행
err := cmd.RunWithDir("ls", "/tmp")
// Shell 명령어를 특정 디렉토리에서 실행
err = cmd.RunShellWithDir("pwd && ls", "/tmp")
// PowerShell 명령어를 특정 디렉토리에서 실행
err = cmd.RunPowershellWithDir("Get-ChildItem", "C:\\temp")
커스텀 설정
import (
"os"
"strings"
)
cmd := easycmd.New(
easycmd.WithStdIn(strings.NewReader("input")), // 표준 입력 설정
easycmd.WithStdOut(os.Stdout), // 표준 출력 설정
easycmd.WithStdErr(os.Stderr), // 표준 에러 설정
)
err := cmd.Run("cat") // 표준 입력에서 "input"을 읽어서 출력
디버그 모드
import (
"bytes"
"fmt"
)
// 기본 디버그 모드 (디버그 출력은 stderr로)
cmd := easycmd.New(easycmd.WithDebug())
err := cmd.Run("echo hello world")
// 커스텀 디버그 출력 스트림
debugOut := &bytes.Buffer{}
cmd = easycmd.New(easycmd.WithDebug(debugOut))
err = cmd.Run("echo hello world")
fmt.Println("디버그 출력:", debugOut.String())
복합 설정 사용
import (
"bytes"
"strings"
)
out := &bytes.Buffer{}
debugOut := &bytes.Buffer{}
input := strings.NewReader("test input\n")
cmd := easycmd.New(
easycmd.WithStdIn(input),
easycmd.WithStdOut(out),
easycmd.WithStdErr(os.Stderr),
easycmd.WithDebug(debugOut),
)
err := cmd.RunShell("cat && echo 'processing...' >&2")
API 레퍼런스
주요 메서드
New(configApplies ...configApply) *Cmd: 새로운 Cmd 인스턴스 생성
Run(commandStr string) error: 기본 명령어 실행
RunShell(commandStr string) error: bash로 래핑된 명령어 실행
RunPowershell(commandStr string) error: PowerShell로 래핑된 명령어 실행
RunWithDir(commandStr string, runDirStr string) error: 특정 디렉토리에서 기본 명령어 실행
RunShellWithDir(commandStr string, runDirStr string) error: 특정 디렉토리에서 Shell 명령어 실행
RunPowershellWithDir(commandStr string, runDirStr string) error: 특정 디렉토리에서 PowerShell 명령어 실행
설정 함수
WithStdIn(reader io.Reader) configApply: 표준 입력 설정
WithStdOut(writer io.Writer) configApply: 표준 출력 설정
WithStdErr(writer io.Writer) configApply: 표준 에러 설정
WithDebug(debugOut ...io.Writer) configApply: 디버그 모드 활성화 및 디버그 출력 스트림 설정
디버그 모드 출력 내용
디버그 모드가 활성화되면 다음 정보들이 출력됩니다:
- 파싱된 명령어 문자열
- 실행될 명령어 이름
- 명령어 인수 배열
- 실행 디렉토리 (설정된 경우)
- 명령어 실행 시작/완료/실패 메시지
에러 처리
cmd := easycmd.New()
err := cmd.Run("invalid-command")
if err != nil {
fmt.Printf("명령어 실행 실패: %v\n", err)
}
// 빈 명령어에 대한 특별한 에러
if errors.Is(err, easycmd.EmptyCmdError) {
fmt.Println("빈 명령어입니다")
}
라이선스
이 프로젝트는 Apache License 2.0 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.