jsonstore

Documentation

Overview

Package jsonstore persists Go values as JSON files on disk. Save marshals a value and writes it atomically (via internal/fileutil); Load reads and unmarshals one, reporting absence without an error so callers can treat a missing file as empty state. It is the shared home for the marshal+atomic write and read+unmarshal patterns previously duplicated across the scheduler, cache, artifact, and hide stores.

Index

• func Load(path string, v any) (found bool, err error)
• func Save(path string, v any, perm os.FileMode) error

Functions

func Load

func Load(path string, v any) (found bool, err error)

Load reads path and unmarshals its JSON contents into v. It returns (false, nil) when the file does not exist, leaving v unmodified, so callers can distinguish "absent" from a decode error. A successful load returns (true, nil).

func Save

func Save(path string, v any, perm os.FileMode) error

Save marshals v to JSON and writes it to path atomically with the given file permission. The parent directory is created (mode 0700) if needed.