Embed static files in Go binaries (replacement for gobuffalo/packr)
Go to file
Mark Bates 342e00a7be
Merge pull request #24 from markbates/aperezg-22_detect_gomod_no_pkg
Error when a directory contains no `.go` or `go.mod` files fixes #22
2019-11-10 15:42:52 -08:00
cmd/pkger improve error testing for non go directories. 2019-11-10 18:22:06 -05:00
examples fix stat example 2019-11-01 16:22:08 -04:00
here match error for nonGoDirRx 2019-11-10 18:38:44 -05:00
internal remove hepa dep 2019-10-16 10:24:05 -04:00
parser improve error testing for non go directories. 2019-11-10 18:22:06 -05:00
pkging now with less printlns and more tests 2019-11-10 18:27:57 -05:00
.gitignore hey brett, you know what time it is? 2019-10-18 16:29:35 -04:00
.goreleaser.yml generated goreleaser 2019-10-18 16:37:25 -04:00
.goreleaser.yml.plush version bump: v0.1.0 2019-10-18 16:37:25 -04:00
LICENSE init 2019-07-30 12:12:21 -04:00
Makefile now with less printlns and more tests 2019-11-10 18:27:57 -05:00
README.md Update README.md 2019-11-05 15:22:08 -05:00
SHOULDERS.md version bump: v0.1.0 2019-10-18 16:32:45 -04:00
apply.go do run run 2019-10-25 10:19:27 -04:00
apply_test.go thats what i get 2019-09-21 18:00:53 -04:00
azure-pipelines.yml a self-made mug is hard to break 2019-10-31 11:12:18 -04:00
azure-tests.yml prime the mod cache 2019-11-05 15:09:28 -05:00
go.mod more examples 2019-10-17 13:45:22 -04:00
go.sum more examples 2019-10-17 13:45:22 -04:00
pkger.go better tests 2019-10-31 17:20:15 -04:00
pkger_test.go Digging the "Dancing Queen" 2019-11-01 16:08:10 -04:00
version.go version bump: v0.10.1 2019-11-08 11:21:34 -08:00

README.md

Pkger

github.com/markbates/pkger is a tool for embedding static files into Go binaries. It will, hopefully, be a replacement for github.com/gobuffalo/packr/v2.

How it Works

Pkger is powered by the dark magic of Go Modules, so they're like, totally required.

With Go Modules pkger can resolve packages with accuracy. No more guessing and trying to figure out build paths, GOPATHS, etc... for this tired old lad.

With the module's path correctly resolved, it can serve as the "root" directory for that module, and all files in that module's directory are available.

Paths:

  • Paths should use UNIX style paths: /cmd/pkger/main.go
  • If unspecified the path's package is assumed to be the current module.
  • Packages can specified in at the beginning of a path with a : seperator. github.com/markbates/pkger:/cmd/pkger/main.go
  • There are no relative paths. All paths are absolute to the modules root.
"github.com/gobuffalo/buffalo:/go.mod" => $GOPATH/pkg/mod/github.com/gobuffalo/buffalo@v0.14.7/go.mod

Usage

Pkger's API is modeled on that of the os package in Go's standard library. This makes Pkger usage familiar to Go developers.

type Pkger interface {
  Parse(p string) (Path, error)
  Current() (here.Info, error)
  Info(p string) (here.Info, error)
  Create(name string) (File, error)
  MkdirAll(p string, perm os.FileMode) error
  Open(name string) (File, error)
  Stat(name string) (os.FileInfo, error)
  Walk(p string, wf filepath.WalkFunc) error
  Remove(name string) error
  RemoveAll(path string) error
}

type File interface {
  Close() error
  Info() here.Info
  Name() string
  Open(name string) (http.File, error)
  Path() Path
  Read(p []byte) (int, error)
  Readdir(count int) ([]os.FileInfo, error)
  Seek(offset int64, whence int) (int64, error)
  Stat() (os.FileInfo, error)
  Write(b []byte) (int, error)
}
├── go.mod
├── go.sum
├── main.go
├── public
│   ├── images
│   │   ├── mark-small.png
│   │   ├── img1.png
│   │   ├── mark_250px.png
│   │   └── mark_400px.png
│   └── index.html
package main

import (
	"fmt"
	"log"
	"os"
	"text/tabwriter"
	"time"

	"github.com/markbates/pkger"
)

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

func run() error {
	w := tabwriter.NewWriter(os.Stdout, 0, 0, 0, ' ', tabwriter.Debug)
	defer w.Flush()

	return pkger.Walk("/public", func(path string, info os.FileInfo, err error) error {
		if err != nil {
			return err
		}

		fmt.Fprintf(w,
			"%s \t %d \t %s \t %s \t\n",
			info.Name(),
			info.Size(),
			info.Mode(),
			info.ModTime().Format(time.RFC3339),
		)

		return nil
	})

}

Output Without Packing

# compile the go binary as usual and run the app:
$ go build -v; ./app

public     | 128   | drwxr-xr-x | 2019-10-18T16:24:55-04:00 |
images     | 128   | drwxr-xr-x | 2019-10-18T16:24:55-04:00 |
img1.png   | 27718 | -rw-r--r-- | 2019-10-18T16:24:55-04:00 |
img2.png   | 27718 | -rw-r--r-- | 2019-10-18T16:24:55-04:00 |
index.html | 257   | -rw-r--r-- | 2019-10-18T16:24:55-04:00 |

Output With Packing

# run the pkger cli to generate a pkged.go file:
$ pkger

# compile the go binary as usual and run the app:
$ go build -v; ./app

public     | 128   | drwxr-xr-x | 2019-10-18T16:24:55-04:00 |
images     | 128   | drwxr-xr-x | 2019-10-18T16:24:55-04:00 |
img1.png   | 27718 | -rw-r--r-- | 2019-10-18T16:24:55-04:00 |
img2.png   | 27718 | -rw-r--r-- | 2019-10-18T16:24:55-04:00 |
index.html | 257   | -rw-r--r-- | 2019-10-18T16:24:55-04:00 |