aboutsummaryrefslogtreecommitdiffstats
path: root/library/go/core/resource/resource.go
blob: 686ea73c3b3f3304cd3aac246ddb74e6590835b9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
// Package resource provides integration with RESOURCE and RESOURCE_FILES macros.
//
// Use RESOURCE macro to "link" file into the library or executable.
//
//	RESOURCE(my_file.txt some_key)
//
// And then retrieve file content in the runtime.
//
//	blob := resource.Get("some_key")
//
// Warning: Excessive consumption of resource leads to obesity.
package resource

import (
	"fmt"
	"sort"
)

var resources = map[string][]byte{}

// InternalRegister is private API used by generated code.
func InternalRegister(key string, blob []byte) {
	if _, ok := resources[key]; ok {
		panic(fmt.Sprintf("resource key %q is already defined", key))
	}

	resources[key] = blob
}

// Get returns content of the file registered by the given key.
//
// If no file was registered for the given key, nil slice is returned.
//
// User should take care, to avoid mutating returned slice.
func Get(key string) []byte {
	return resources[key]
}

// MustGet is like Get, but panics when associated resource is not defined.
func MustGet(key string) []byte {
	r, ok := resources[key]
	if !ok {
		panic(fmt.Sprintf("resource with key %q is not defined", key))
	}
	return r
}

// Keys returns sorted keys of all registered resources inside the binary
func Keys() []string {
	keys := make([]string, 0, len(resources))
	for k := range resources {
		keys = append(keys, k)
	}
	sort.Strings(keys)
	return keys
}