DEPRECATED for larger version than go 1.16!

Please use language feature "go:embed".

Zgok is a simple utility to embed any static file into the binary executable file for Go.

日本語: README.jp.md

It can create a single binary file containing all static files. Easy to deploy! No dependency. Available on Windows, Linux, Mac and ARM.

Use the following to install the library and command line program:

go get -u github.com/srtkkou/zgok/...

Use the following command to build the zgok executable file.

$GOPATH/bin/zgok build -e exePath -z zipPath1 -z zipPath2 -o outPath

If you want to read the embedded file in the code, you can do like the following.

package main

import (
	"fmt"
	"github.com/srtkkou/zgok"
	"io/ioutil"
	"os"
)

func main() {
	var content []byte
	path := "test.txt"
	zfs, _ := zgok.RestoreFileSystem(os.Args[0])
	if zfs != nil {
		// For release.
		content, _ = zfs.ReadFile(path)
	} else {
		// For development.
		content, _ = ioutil.ReadFile(path)
	}
	fmt.Println(string(content))
}

If you want to serve zgok embedded files as static files in the web application, you can do like the following.
Note: Assuming that static assets are stored in [./web/public/*].

1. This is the minimal example to use the zgok in web application.

package main

import (
	"net/http"
	"github.com/srtkkou/zgok"
	"os"
)

func main() {
	zfs, err := zgok.RestoreFileSystem(os.Args[0])
	if err != nil {
		panic(err)
	}
	assetServer := zfs.FileServer("web/public")
	http.Handle("/assets/", http.StripPrefix("/assets/", assetServer))
	http.ListenAndServe(":8080", nil)
}

2. Build the zgok executable file.

   go build -o web web.go $GOPATH/bin/zgok build -e web -z web/public -o web_all

3. Access the URL like [http://localhost:8080/assets/css/sample.css] on browser.

The file format of Linux executable file (ELF) and that of the Windows (PE) starts with a header section containing the sizes of each segments in the file. In other words, the executable file knows its REAL size by themselves. So you can add some extra data at the end of the executable file, and still use it normally.

The format of the zgok executable file looks like the following.

Zgok will unzip the files in the zip data section and add the content of them in a map accessible by their path.

Apache License Version 2.0. See the LICENSE file for details.