2011-06-17 15:44:59 +00:00
|
|
|
================================================================================
|
|
|
|
bindata
|
|
|
|
================================================================================
|
|
|
|
|
|
|
|
This tool converts any file into managable Go source code. Useful for embedding
|
|
|
|
binary data into a go program. The file data is gzip compressed before being
|
|
|
|
converted to a raw byte slice.
|
|
|
|
|
|
|
|
If gofmt is available on the system, bindata will invoke it to format the
|
|
|
|
generated go file.
|
|
|
|
|
|
|
|
================================================================================
|
|
|
|
DEPENDENCIES
|
|
|
|
================================================================================
|
|
|
|
|
|
|
|
n/a
|
|
|
|
|
|
|
|
================================================================================
|
|
|
|
USAGE
|
|
|
|
================================================================================
|
|
|
|
|
|
|
|
$ goinstall github.com/jteeuwen/go-bindata
|
|
|
|
|
|
|
|
The simplest invocation is to pass it only the input file name.
|
|
|
|
The output file and code settings are inferred from this automatically.
|
|
|
|
|
|
|
|
$ bindata -i testdata/gophercolor.png
|
|
|
|
[w] No output file specified. Using 'testdata/gophercolor.png.go'.
|
|
|
|
[w] No package name specified. Using 'main'.
|
|
|
|
[w] No function name specified. Using 'gophercolor_png'.
|
|
|
|
[i] Done.
|
|
|
|
|
|
|
|
This creates the "testdata/gophercolor.png.go" file which has a package
|
|
|
|
declaration with name 'main' and one function named 'gophercolor_png'.
|
|
|
|
It looks like this:
|
|
|
|
|
|
|
|
func gophercolor_png() ([]byte, os.Error) {
|
|
|
|
var gz *gzip.Decompressor
|
|
|
|
var err os.Error
|
|
|
|
if gz, err = gzip.NewReader(bytes.NewBuffer([]byte{
|
|
|
|
...
|
|
|
|
})); err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
var b bytes.Buffer
|
|
|
|
io.Copy(&b, gz)
|
|
|
|
gz.Close()
|
|
|
|
return b.Bytes(), nil
|
|
|
|
}
|
|
|
|
|
|
|
|
You can now simply include the new .go file in your program and call
|
|
|
|
gophercolor_png() to get the uncompressed image data.
|
2011-06-17 15:46:29 +00:00
|
|
|
See the testdata directory for example input and output.
|
|
|
|
|
2011-06-17 16:52:40 +00:00
|
|
|
Aternatively, you can pipe the input file data into stdin. bindata will then
|
|
|
|
spit out the generated Go code to stdout. This does require explicitly naming
|
|
|
|
the desired function name, as it can not be inferred from the input data.
|
|
|
|
The package name will still default to 'main'.
|
|
|
|
|
|
|
|
$ cat testdata/gophercolor.png | ./bindata -f gophercolor_png | gofmt
|
|
|
|
|
2011-06-17 15:44:59 +00:00
|
|
|
Invoke the program with the -h flag for more options.
|
|
|
|
|