Files
sanderling/internal/sidecar/embed.go
T
pj 6a9fac7ec0 feat(sidecar): embed sidecar JAR via go:embed
Ships with a 24-byte placeholder so fresh clones build without
requiring a sidecar build first. `make uatu` copies the real
fat JAR into internal/sidecar/assets before `go build`, so
shipping binaries carry the full sidecar (~130 MB).

Extract writes the JAR to a temp dir alongside a SHA-256 file
and skips rewrite when the checksum already matches.
2026-04-18 00:06:27 +07:00

65 lines
1.9 KiB
Go

package sidecar
import (
"crypto/sha256"
"encoding/hex"
_ "embed"
"errors"
"fmt"
"os"
"path/filepath"
)
//go:embed assets/sidecar-all.jar
var embeddedJAR []byte
// PlaceholderMagic is the byte sequence written to the placeholder JAR that
// ships in the repository. A binary that still carries the placeholder is
// not runnable against a real sidecar — `make sidecar && make uatu` must
// have been invoked to embed the real fat JAR.
const PlaceholderMagic = "uatu-sidecar-placeholder"
// IsPlaceholder reports whether the embedded JAR is the development
// placeholder rather than a real sidecar fat JAR.
func IsPlaceholder() bool {
return string(embeddedJAR) == PlaceholderMagic
}
// EmbeddedSize returns the size in bytes of the embedded JAR.
func EmbeddedSize() int { return len(embeddedJAR) }
// EmbeddedSHA256 returns the hex-encoded SHA-256 of the embedded JAR.
func EmbeddedSHA256() string {
sum := sha256.Sum256(embeddedJAR)
return hex.EncodeToString(sum[:])
}
// Extract writes the embedded JAR to a deterministic path inside dir,
// alongside a .sha256 file. If the destination already exists with a
// matching checksum, no rewrite happens. Returns the JAR path.
func Extract(dir string) (string, error) {
if len(embeddedJAR) == 0 {
return "", errors.New("sidecar: embedded JAR is empty")
}
if err := os.MkdirAll(dir, 0o755); err != nil {
return "", fmt.Errorf("mkdir %s: %w", dir, err)
}
jarPath := filepath.Join(dir, "uatu-sidecar.jar")
checksumPath := jarPath + ".sha256"
checksum := EmbeddedSHA256()
if existing, err := os.ReadFile(checksumPath); err == nil && string(existing) == checksum {
if _, err := os.Stat(jarPath); err == nil {
return jarPath, nil
}
}
if err := os.WriteFile(jarPath, embeddedJAR, 0o644); err != nil {
return "", fmt.Errorf("write %s: %w", jarPath, err)
}
if err := os.WriteFile(checksumPath, []byte(checksum), 0o644); err != nil {
return "", fmt.Errorf("write checksum: %w", err)
}
return jarPath, nil
}