$ go get -u github.com/julienschmidt/httprouter

package serverimport ("errors""log""net/http""github.com/julienschmidt/httprouter"
)type Server struct {srv *http.Server
}func Get () * Server {return &Server{srv: &http.Server{},}
}func (s *Server) WithAddr (addr string ) * Server {s.srv.Addr = addrreturn s
}func (s *Server) WithErrLogger (l *log.Logger) * Server {s.srv.ErrorLog = lreturn s
}func (s *Server) WithRouter (router *httprouter.Router) * Server {s.srv.Handler = routerreturn s
}func (s *Server) Start () error {if len (s.srv.Addr) == 0 {return errors.New( "Server missing address" )}if s.srv.Handler == nil {return errors.New( "Server missing handler" )}return s.srv.ListenAndServe()
}func (s *Server) Close () error {return s.srv.Close()
}

// cmd/api/router/router.gopackage routerimport ("github.com/boilerplate/cmd/api/handlers/getuser""github.com/boilerplate/pkg/application""github.com/julienschmidt/httprouter"
)func Get (app *application.Application) * httprouter . Router {mux := httprouter.New()mux.GET( "/users" , getuser.Do(app))return mux
}

// cmd/api/handlers/getuser/getuser.gopackage getuserimport ("fmt""net/http""github.com/boilerplate/pkg/application""github.com/julienschmidt/httprouter"
)func Do (app *application.Application) httprouter . Handle {return func (w http.ResponseWriter, r *http.Request, ps httprouter.Params) {fmt.Fprintf(w, "hello" )}
}

// cmd/api/main.gopackage mainimport ("github.com/boilerplate/cmd/api/router""github.com/boilerplate/pkg/application""github.com/boilerplate/pkg/exithandler""github.com/boilerplate/pkg/logger""github.com/boilerplate/pkg/server""github.com/joho/godotenv"
)func main () {if err := godotenv.Load(); err != nil {logger.Info.Println( "failed to load env vars" )}app, err := application.Get()if err != nil {logger.Error.Fatal(err.Error())}srv := server.Get().WithAddr(app.Cfg.GetAPIPort()).WithRouter(router.Get(app)).WithErrLogger(logger.Error)go func () {logger.Info.Printf( "starting server at %s" , app.Cfg.GetAPIPort())if err := srv.Start(); err != nil {logger.Error.Fatal(err.Error())}}()exithandler.Init( func () {if err := srv.Close(); err != nil {logger.Error.Println(err.Error())}if err := app.DB.Close(); err != nil {logger.Error.Println(err.Error())}})
}

$ migrate create -ext sql -dir ./db/migrations create_user

-- db/migrations/${timestamp}_create_user.up.sql
CREATE TABLE IF NOT EXISTS public.users
(id SERIAL PRIMARY KEY ,username VARCHAR ( 100 ) NOT NULL UNIQUE
);

-- db/migrations/${timestamp}_create_user.down.sql
DROP TABLE public.users

$go get - u github. com /golang-migrate/migrate/v4

// cmd/dbmigrate/main.go package mainimport ("log""github.com/boilerplate/pkg/config""github.com/golang-migrate/migrate/v4"_ "github.com/golang-migrate/migrate/v4/database/postgres"_ "github.com/golang-migrate/migrate/v4/source/file""github.com/joho/godotenv"
)func main () {godotenv.Load()cfg := config.Get()direction := cfg.GetMigration()if direction != "down" && direction != "up" {log.Fatal( "-migrate accepts [up, down] values only" )}m, err := migrate.New( "file://db/migrations" , cfg.GetDBConnStr())if err != nil {log.Fatal(err)}if direction == "up" {if err := m.Up(); err != nil {log.Fatal(err)}}if direction == "down" {if err := m.Down(); err != nil {log.Fatal(err)}}
}

#!/bin/bash
set -ego run cmd/dbmigrate/main.gogo run cmd/dbmigrate/main.go -dbname=boilerplatetestGO111MODULE=off go get github.com/githubnemo/CompileDaemonCompileDaemon --build= "go build -o main cmd/api/main.go" -- command =./main

# remove all containers
docker container rm -f $(docker container ps -a -q)# clear volumes
docker volume prune -f# start app
docker-compose up --build

# connect to pg docker container
docker exec -it $(docker ps --filter name=pg --format "{{.Names}}" ) /bin/bash# launch psql cli
psql -U postgres -W# ensure both DBs still present
\l# connect to boilerplate database and list tables
\c boilerplate
\dt# do same for boilerplatetest
\c boilerplatetest
\dt# in both databases you should see users table

# migrate boilerplatetest db down
go run cmd/dbmigrate/main.go \-migrate=down \-dbname=boilerplatetest \-dbhost=localhost# you can now repeat steps from above to connect to pg container
# and ensure that users table is missing from boilerplatetest DB.# now bring it back up
go run cmd/dbmigrate/main.go \-migrate=up \-dbname=boilerplatetest \-dbhost=localhost