DEV Community

Cover image for The Go Playground: Using Modules
Matt Dale
Matt Dale

Posted on • Edited on

1

The Go Playground: Using Modules

This is part of an upcoming series about useful and surprising features of the Go Playground. Follow me to read more about the Go Playground!


The Go Playground is extremely useful for sharing runnable Go code and testing out standard library functions, but what if you want to test out code that's in an external library? It turns out that the Go Playground can automatically fetch Go modules when you import packages that aren't in the standard library.

Let's check out an example of generating a random UUIDv4 using the github.com/google/uuid package:

package main

import (
    "fmt"

    "github.com/google/uuid"
)

func main() {
    u, err := uuid.NewRandom()
    if err != nil {
        panic(err)
    }

    fmt.Println(u)
}
Enter fullscreen mode Exit fullscreen mode

Run

When we run that code, the Go playground fetches the github.com/google/uuid module, then compiles and runs our code. By default, the Go Playground fetches the latest available module version for the specified package. But what if we want to use a different version of the module?

Major Versions

To fetch a different major version, add a major version suffix to the import path and the Go Playground will fetch that major version instead! For example, to fetch package mypackage from version v2.x.x of the github.com/name/example module, import package

github.com/name/example/v2/mypackage
Enter fullscreen mode Exit fullscreen mode

Let's check out an example of writing a simple HTTP handler using v5 of the github.com/go-chi/chi module:

package main

import (
    "fmt"
    "io"
    "net"
    "net/http"
    "os"

    "github.com/go-chi/chi/v5"
    "github.com/go-chi/chi/v5/middleware"
)

func main() {
    r := chi.NewRouter()
    r.Use(middleware.Logger)
    r.Get("/", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("hi"))
    })

    listener, err := net.Listen("tcp", ":8080")
    if err != nil {
        panic(err)
    }
    go http.Serve(listener, r)

    fmt.Println("Sending request...")
    res, err := http.Get("http://localhost:8080/")
    if err != nil {
        panic(err)
    }

    fmt.Println("Reading response...")
    if _, err := io.Copy(os.Stdout, res.Body); err != nil {
        panic(err)
    }
}
Enter fullscreen mode Exit fullscreen mode

Run

That example highlights another feature of the Go Playground: you can run and test local network services, like HTTP servers! Your code can't access the Internet, but you can run as many local services as the Go Playground sandbox can handle.

Any Version

So far we've let the Go Playground fetch the latest version and a specific major version, but we can also specify the exact version of a module if we want. To do that, we'll use another hidden feature of the Go Playground: you can add multiple source code files!

In this example, we'll add a go.mod file that specifically requests v1.11.7 of the go.mongodb.org/mongo-driver module:

package main

import (
    "fmt"

    "go.mongodb.org/mongo-driver/version"
)

func main() {
    fmt.Println(version.Driver)
}
-- go.mod --
module mymodule

require go.mongodb.org/mongo-driver v1.11.6
Enter fullscreen mode Exit fullscreen mode

Run

That's all for now! In the next Go Playground post, we'll look at displaying images and GIFs in the Go Playground. Subscribe for more!

Image of Datadog

Measure and Advance Your DevSecOps Maturity

In this white paper, we lay out a DevSecOps maturity model based on our experience helping thousands of organizations advance their DevSecOps practices. Learn the key competencies and practices across four distinct levels of maturity.

Get The White Paper

Top comments (0)

Sentry image

See why 4M developers consider Sentry, “not bad.”

Fixing code doesn’t have to be the worst part of your day. Learn how Sentry can help.

Learn more

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay