workspaceid.go RawHistoryFolder

1// Package workspaceid names workspaces for programs outside the compositor:
2// the `id` of ext_workspace_handle_v1 and the `workspace_id` of the state
3// file are the same string.
4//
5// Core keeps numeric workspace IDs, unique for the life of the process. A
6// workspace declared in the configuration is named after its configured name
7// ("name:<configured name>"), so its ID survives restarts; any other
8// workspace is "<prefix>-<core ID>", where the prefix is drawn once per
9// compositor launch, so such an ID is unique within a launch and never
10// repeats across launches.
11package workspaceid
12
13import (
14	"crypto/rand"
15	"encoding/hex"
16	"strconv"
17)
18
19// IDs builds workspace ID strings for one compositor launch.
20type IDs struct{ prefix string }
21
22// New draws the launch prefix: 8 lowercase hex characters from crypto/rand.
23func New() *IDs {
24	var b [4]byte
25	// rand.Read never returns an error (Go 1.24+): it stops the program
26	// instead of returning weak randomness.
27	_, _ = rand.Read(b[:])
28	return &IDs{prefix: hex.EncodeToString(b[:])}
29}
30
31// WithPrefix uses a fixed launch prefix (tests).
32func WithPrefix(prefix string) *IDs { return &IDs{prefix: prefix} }
33
34// ID is the string of the workspace with this core ID and configured name
35// (empty for a numbered or dynamic workspace).
36func (i *IDs) ID(id uint64, configured string) string {
37	if configured != "" {
38		return "name:" + configured
39	}
40	return i.prefix + "-" + strconv.FormatUint(id, 10)
41}