b4f289fe92
In 1.19, gofmt slightly changes how comments are formatted; a blank `//` is inserted before `//go:embed` directives. To accommodate for that in generate.go, treat empty comment lines as part of docs segments.
47 lines
1.4 KiB
Go
47 lines
1.4 KiB
Go
// `//go:embed` is a [compiler
|
|
// directive](https://pkg.go.dev/cmd/compile#hdr-Compiler_Directives) that
|
|
// allows programs to include arbitrary files and folders in the Go binary at
|
|
// build time. Read more about the embed directive
|
|
// [here](https://pkg.go.dev/embed).
|
|
package main
|
|
|
|
// Import the `embed` package; if you don't use any exported
|
|
// identifiers from this package, you can do a blank import with `_ "embed"`.
|
|
import (
|
|
"embed"
|
|
)
|
|
|
|
// `embed` directives accept paths relative to the directory containing the
|
|
// Go source file. This directive embeds the contents of the file into the
|
|
// `string` variable immediately following it.
|
|
//
|
|
//go:embed folder/single_file.txt
|
|
var fileString string
|
|
|
|
// Or embed the contents of the file into a `[]byte`.
|
|
//
|
|
//go:embed folder/single_file.txt
|
|
var fileByte []byte
|
|
|
|
// We can also embed multiple files or even folders with wildcards. This uses
|
|
// a variable of the [embed.FS type](https://pkg.go.dev/embed#FS), which
|
|
// implements a simple virtual file system.
|
|
//
|
|
//go:embed folder/single_file.txt
|
|
//go:embed folder/*.hash
|
|
var folder embed.FS
|
|
|
|
func main() {
|
|
|
|
// Print out the contents of `single_file.txt`.
|
|
print(fileString)
|
|
print(string(fileByte))
|
|
|
|
// Retrieve some files from the embedded folder.
|
|
content1, _ := folder.ReadFile("folder/file1.hash")
|
|
print(string(content1))
|
|
|
|
content2, _ := folder.ReadFile("folder/file2.hash")
|
|
print(string(content2))
|
|
}
|