Level Up Your Web Apps With Go

Third-party Libraries
So far we’ve only used standard libraries in the examples; that is, code that comes
as part of the Go installation. In real life, however, you'll use a mix of standard lib-
raries and third-party code. Go’s third-party ecosystem makes it very easy to run,
in fact only a single command is required to get started with a third-party package
hosted on the Internet using the
go get
tool. We’ll be looking at how to consume
third-party packages right now, but in a later chapter we’ll also look at how we
create and distribute our own.
Source Control Software
Go can download third-party libraries stored in several varieties of source control
software. If you attempt to download a package stored in source control software
not on your system, you’ll see a message along the lines of “go: missing Git com-
mand. See http://golang.org/s/gogetcmd.” The vast majority of packages are stored
in Git, so I suggest you install it if you're yet to do so. Visit
http://golang.org/s/gogetcmd now and follow the link to install it. Go also supports
Mercurial, Subversion, and Bazaar.
To see this in action, we’re going to write a simple program that converts some
markdown formatted text into HTML. If you’ve never heard of markdown, it’s a
way of writing formatted text in a simplified manner, and it's gaining popularity as
a way to mark up text without having to know HTML.
We’ll use a library called Black Friday by Russ Ross. The library is hosted on Github
at
github.com/russross/blackfriday
. We tell Go to download the package first:
go get github.com/russross/blackfriday
This will download the library into your
$GOPATH
at
$GOPATH/src/git-
hub.com/russross/blackfriday
. If it runs correctly, there will be no output in the
command line. If you run the command again it will be very fast, as Go knows you
33
Go Types Explored

---

already have the package and don’t need to download it again. To force an update,
you can add the
-u
flag. Now you can simply import the library in your code and
you’re good to go. The library is referenced exactly as it was when we installed it:
github.com/russross/blackfriday
markdown.go
package main
import (
"fmt"
"github.com/russross/blackfriday"
)
func main() {
markdown := []byte(`
# This is a header
* and
* this
* is
* a
* list
`)
html := blackfriday.MarkdownBasic(markdown)
fmt.Println(string(html))
}
If you run this code, you’ll see an output such as this: