Shell-style programming in Go: Write powerful "shell scripts" as Go programs

yupsh lets you write Go programs that work like shell scripts, combining the best of both worlds:

• Shell's Power: Composable commands, pipelines, and text processing glue
• Go's Strengths: Type safety, performance, robust error handling, and rich data structures

Instead of writing bash scripts, write Go programs with shell-like operations!

• Glue Code: Connecting different tools and processing data flows
• Text Processing: Powerful pipelines for filtering, transforming, and analyzing
• Automation: Quick scripts to automate repetitive tasks

• Type Safety: Catch errors at compile time instead of runtime
• Performance: Compiled binaries run faster and use less memory
• Data Handling: Rich standard library and powerful data structures
• Error Handling: Explicit error handling prevents silent failures
• Testing: Built-in testing framework with excellent tooling
• Distribution: Single binary deployment, no dependency issues

// Instead of this bash script:
// #!/bin/bash
// cat logs/*.log \
// | grep ERROR \
// | cut -d' ' -f1,3 \
// | sort \
// | uniq -c \
// | head -10

// Write this Go program:
func main() {
    ctx := context.Background()

    pipeline := yup.Pipe(
        cat.Cat("logs/*.log"),
        grep.Grep("ERROR", grep.IgnoreCase),
        cut.Cut(cut.Fields(1, 3), cut.Delimiter(" ")),
        sort.Sort(),
        uniq.Uniq(uniq.Count),
        head.Head(head.Lines(10)),
    )

    pipeline.Execute(ctx, nil, os.Stdout, os.Stderr)
}

yupsh provides pure Go implementations of common Unix commands. Each command is independently maintained with comprehensive examples.

Pure Go implementations - No subprocess spawning for core commands. Zero external dependencies.

• ✅ Shell's composability with Go's type safety
• ✅ Pure Go implementations - no subprocess overhead
• ✅ Single binary - works anywhere Go runs
• ✅ Testable & maintainable - full IDE support
• ✅ Extensible - each command is independent

# Install the framework and commands
go get github.com/gloo-foo/framework
go get github.com/yupsh/grep
go get github.com/yupsh/sort

// Write shell-like Go code
pipeline := yup.Pipe(
    grep.Grep("ERROR"),
    sort.Sort(),
    head.Head(head.Lines(10)),
)

pipeline.Execute(ctx, input, os.Stdout, os.Stderr)

• 📘 Documentation: Core concepts, philosophy, and detailed guides
• 🚀 Examples: Real shell scripts vs yupsh Go programs
• 🔧 Framework: Build your own commands
• 💬 Discussions: Ask questions and share ideas

yupsh - Shell-style programming in Go
GitHub • Documentation • Examples