title: “Command-line Interfaces (CLIs)” linkTitle: “Command-line Interfaces (CLIs)” description: “With popular open source packages and a robust standard library, use Go to create fast and elegant CLIs.” date: 2019-10-04T15:26:31-04:00 series: Use Cases books:

Overview {#overview .sectionHeading}

CLI developers prefer Go for portability, performance, and ease of creation

Command line interfaces (CLIs), unlike graphical user interfaces (GUIs), are text-only. Cloud and infrastructure applications are primarily CLI-based due to their easy automation and remote capabilities.

Key benefits {#key-benefits .sectionHeading}

Leverage fast compile times to build programs that start quickly and run on any system

Developers of CLIs find Go to be ideal for designing their applications. Go compiles very quickly into a single binary, works across platforms with a consistent style, and brings a strong development community. From a single Windows or Mac laptop, developers can build a Go program for every one of the dozens of architectures and operating systems Go supports in a matter of seconds, no complicated build farms are needed. No other compiled language can be built as portably or quickly. Go applications are built into a single self contained binary making installing Go applications trivial.

Specifically, programs written in Go run on any system without requiring any existing libraries, runtimes, or dependencies. And programs written in Go have an immediate startup time—similar to C or C++ but unobtainable with other programming languages.

Use Case {#use-case .sectionHeading}

Use Go for building elegant CLIs

{{< backgroundQuote author=“Steve Domino” title=“senior engineer and architect at Strala” link=“https://medium.com/@skdomino/writing-better-clis-one-snake-at-a-time-d22e50e60056” >}} I was tasked with building our CLI tool and found two really great projects, Cobra and Viper, which make building CLI’s easy. Individually they are very powerful, very flexible and very good at what they do. But together they will help you show your next CLI who is boss! {{< /backgroundQuote >}}

{{< backgroundQuote author=“Francesc Campoy” title=“VP of product at DGraph Labs and producer of Just For Func videos” link=“https://www.youtube.com/watch?v=WvWPGVKLvR4” >}} Cobra is a great product to write small tools or even large ones. It’s more of a framework than a library, because when you call the binary that would create a skeleton, then you would be adding code in between.” {{< /backgroundQuote >}}

When developing CLIs in Go, two tools are widely used: Cobra & Viper.

{{< pkg “github.com/spf13/cobra” Cobra >}} is both a library for creating powerful modern CLI applications and a program to generate applications and CLI applications in Go. Cobra powers most of the popular Go applications including CoreOS, Delve, Docker, Dropbox, Git Lfs, Hugo, Kubernetes, and many more. With integrated command help, autocomplete and documentation “[it] makes documenting each command really simple,” says Alex Ellis, founder of OpenFaaS.

{{< pkg “github.com/spf13/viper” Viper >}} is a complete configuration solution for Go applications, designed to work within an app to handle configuration needs and formats. Cobra and Viper are designed to work together.

Viper supports nested structures in the configuration, allowing CLI developers to manage the configuration for multiple parts of a large application. Viper also provides all of the tooling need to easily build twelve factor apps.

“If you don’t want to pollute your command line, or if you’re working with sensitive data which you don’t want to show up in the history, it’s a good idea to work with environment variables. To do this, you can use Viper,” suggests Geudens.

{{< rawhtml >}}{{< /rawhtml >}}

Featured users {#featured-users .sectionHeading}

{{< featuredProjects >}}

{{< rawhtml >}}{{< /rawhtml >}}

Get Started {#get-started .sectionHeading}

Go books for creating CLIs

{{< books >}} {{< goLibraries >}}