lockfile

package

v1.0.0-beta.10 Latest Latest Go to latest Published: Aug 19, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

type Entry struct {
	Namespace string
	Operation string
	Inputs    []any
	Value     any
	Policy    string
}

Entry is a single lockfile tuple entry.

type Lockfile struct {
	// contains filtered or unexported fields
}

Lockfile stores lock entries keyed by (namespace, operation, inputs).

func New() *Lockfile

New returns an empty lockfile.

func Parse(data []byte) (*Lockfile, error)

Parse decodes lockfile JSON lines.

Non-empty files must start with a supported version header line.

func (l *Lockfile) Delete(namespace, operation string, inputs []any) bool

Delete removes the result for (namespace, operation, inputs).

func (l *Lockfile) Entries() []Entry

Entries returns a deterministic snapshot of all lock entries.

func (l *Lockfile) Get(namespace, operation string, inputs []any) (any, string, bool)

Get retrieves the value and any legacy v1 policy for (namespace, operation, inputs). Version 2 entries have no policy.

func (l *Lockfile) Marshal() ([]byte, error)

Marshal encodes lockfile entries to deterministic JSON lines.

Empty lockfiles marshal to empty bytes.

func (l *Lockfile) Set(namespace, operation string, inputs []any, value any) error

Set records the value for (namespace, operation, inputs).

func (l *Lockfile) SetWithLegacyPolicy(namespace, operation string, inputs []any, value any, policy string) error

SetWithLegacyPolicy records a value while preserving a version 1 policy in memory. Marshal still writes version 2 and omits the policy.