credit — http://www.lighthouseabudhabi.org/global-network/ In this article, we are going to be building a very simple Command Line Interface in Go using the package available on Github here: . urfave/cli https://github.com/urfave/cli I’ve been doing one or two domain migrations across various hosting providers recently and thought it would be a cool idea to build a tool or program that could be used to query things like the Nameservers of a website, the CNAMEs, the IP addresses and so on. The overall aim of this particular tutorial is to give you an idea as to how you can build your own CLIs that could do a wide variety of other things such as monitoring, image manipulation and so on. network The full code for this tutorial can be found here: TutorialEdge/Go/go-cli-tutorial Popular Projects is growing massively in popularity and we have seen large enterprise companies such as Hashicorp adopt the language for quite a number of different tools and systems. And for good reason, the design of Go lends itself incredibly well to these styles of application and the ability to cross-compile a binary executable for all major platforms easily is a massive win. Golang Getting Started Let’s create a new directory on our computer called or something along those lines. We’ll be creating a directory structure that will look like this for our project: go-cli/ go-cli/- pkg/- cmd/my-cli/- vendor/- README.md- ... This structure follows the widely accepted Go project layout guide available on Github. Getting Into The Code Now that we’ve got a basic project structure down, we can start to work on our application. First of all, we will need a new file called within our new directory. We’ll populate this with a very simple type of application and use this as the base from which we’ll grow from. cli.go cmd/my-cli/ Hello World // cmd/my-cli/cli.gopackage mainimport ( "fmt")func main() { fmt.Println("Go CLI v0.01")} We can then attempt to run this from our project’s root directory by typing: ➜ go run cmd/my-cli/cli.go Go CLI v0.01 Excellent, we’ve got the makings of our new CLI sorted, let’s now look at how we can add a few commands and make it somewhat useful. Our First Command As we’ll be using the package we’ll need to download this package locally in order to use it, we can do that through a simple command like so: urfave/cli go get $ go get github.com/urfave/cli Now that we have the necessary package, let’s update our file to use this package and create a new CLI application for us: cli.go // cmd/my-cli/cli.goimport ( "log" "os" "github.com/urfave/cli")func main() { err := cli.NewApp().Run(os.Args) if err != nil { log.Fatal(err) }} When we run this now, you’ll see it fleshes out our programs response and adds things like the version, how we use the cli and the various commands we have at our disposal. ➜ go run cmd/my-cli/cli.goNAME: cli - A new cli applicationUSAGE: cli [global options] command [command options] [arguments...]VERSION: 0.0.0COMMANDS: help, h Shows a list of commands or help for one commandGLOBAL OPTIONS: --help, -h show help --version, -v print the version Awesome, this is very quickly starting to look like a more polished project and not just a minor side project! We can now start adding our own . Each of these commands will match up with one of our tests, so we’ll have one command: which, when triggered and supplied with a will go off and lookup the Name Servers of that particular host. Commands ns url Our final list of commands will look something like this: - will retrieve the name servers ns - will lookup the CNAME for a given host cname - will lookup the mail exchange records for a given host mx - will lookup the IP addresses for a given host. ip Nice and simple, let’s get started by creating our first command: package mainimport ( "fmt" "log" "net" "os" "github.com/urfave/cli")func main() { app := cli.NewApp() app.Name = "Website Lookup CLI" app.Usage = "Let's you query IPs, CNAMEs, MX records and Name Servers!" // We'll be using the same flag for all our commands // so we'll define it up here myFlags := []cli.Flag{ cli.StringFlag{ Name: "host", Value: "tutorialedge.net", }, } // we create our commands app.Commands = []cli.Command{ { Name: "ns", Usage: "Looks Up the NameServers for a Particular Host", Flags: myFlags, // the action, or code that will be executed when // we execute our `ns` command Action: func(c *cli.Context) error { // a simple lookup function ns, err := net.LookupNS(c.String("url")) if err != nil { return err } // we log the results to our console // using a trusty fmt.Println statement for i := 0; i < len(ns); i++ { fmt.Println(ns[i].Host) } return nil }, }, } // start our application err := app.Run(os.Args) if err != nil { log.Fatal(err) }} We can then try to run this by typing: $ go run cmd/my-cli/cli.go ns --url tutorialedge.net This should then return the name servers for my site and print them out in the terminal. We can also do a run the help command which will show us exactly how to use our new command within our CLI. Looking up IP Addresses All of our command definitions will look really similar within our program, with the exception of how we go about printing out the results. The function returns a slice of IP addresses and as such we’ll have to iterate over these in order to print them out in a nice fashion: net.LookupIP() { Name: "ip", Usage: "Looks up the IP addresses for a particular host", Flags: myFlags, Action: func(c *cli.Context) error { ip, err := net.LookupIP(c.String("host")) if err != nil { fmt.Println(err) } for i := 0; i < len(ip); i++ { fmt.Println(ip[i]) } return nil },}, Looking up our CNAME We can then add our command which will use the function with our passed in host and return a single CNAME string which we can then print out: cname net.LookupCNAME() { Name: "cname", Usage: "Looks up the CNAME for a particular host", Flags: myFlags, Action: func(c *cli.Context) error { cname, err := net.LookupCNAME(c.String("host")) if err != nil { fmt.Println(err) } fmt.Println(cname) return nil },}, Looking up MX Records Finally, we want to be able to query the Mail Exchange records for our given host, we can do that by using the function and passing in our host. This will return a slice of mx records which, like our IPs, we’ll have to iterate over in order to print out: net.LookupMX() { Name: "mx", Usage: "Looks up the MX records for a particular host", Flags: myFlags, Action: func(c *cli.Context) error { mx, err := net.LookupMX(c.String("host")) if err != nil { fmt.Println(err) } for i := 0; i < len(mx); i++ { fmt.Println(mx[i].Host, mx[i].Pref) } return nil },}, Building our CLI Now that we have a basic CLI up and running, it’s time to build it so that we can use it in anger. $ go build cmd/my-cli/cli.go This should compile a executable which we can then run like so: cli $ ./cli helpNAME: Website Lookup CLI - Let's you query IPs, CNAMEs, MX records and Name Servers!USAGE: cli [global options] command [command options] [arguments...]VERSION: 0.0.0COMMANDS: ns Looks Up the NameServers for a Particular Host cname Looks up the CNAME for a particular host ip Looks up the IP addresses for a particular host mx Looks up the MX records for a particular host help, h Shows a list of commands or help for one commandGLOBAL OPTIONS: --help, -h show help --version, -v print the version As you can see, all of our commands have been successfully listed in the COMMANDS section of the output. Conclusion So, in this tutorial we’ve managed to successfully build a really simple, yet effective CLI using the package from Github. The CLI can be cross-compiled for any of the major operating systems with minimal fuss and it features all the functionality that you would expect from a production-grade command line interface. urface/cli If you liked my article and wish to support me, then please feel free to check out my YouTube Channel: _Hi Guys! Welcome to my channel, TutorialEdge! This is where I'll be posting all of my video tutorials on all of the…_youtube.com TutorialEdge Originally published at tutorialedge.net .
