Artifact [5973a74a83]

Artifact 5973a74a8381d80028a57f8c9e2f15f4db9d60f2213e465941b164668c2014e9:

• File errors.go — part of check-in [d367012009] at 2026-10-25 23:10:47 on branch feat/read-blob-content-cache — feat: read an artifact by hash and cache content on Repo

  Repo.ReadBlob expands one artifact by its full hash after the availability check ReadFile applies, and names an unknown hash with ErrArtifactNotFound.

  Repo.SetContentCache attaches a byte-bounded content.Cache that ReadFile, ReadFileAt, ReadBlob, ListFiles, Diff and Annotate share; check-in parses are kept in its derived memo, so reads at one check-in parse the manifest once. Default off. A read that finds the DB's finished-write count moved swaps in an empty cache, so a purged, compacted or elided artifact, and a rid SQLite reuses after a purge, is never served from it. Writes by another process are not seen; the method's doc says so.

  Tracked in #492. (user: [email protected], size: 2699) [annotate] [blame] [check-ins using] [more...]

package libfossil

import (
	"errors"
	"fmt"
)

type RC int

const (
	RCOK               RC = 0
	RCError            RC = 100
	RCNYI              RC = 101
	RCOOM              RC = 102
	RCMisuse           RC = 103
	RCRange            RC = 104
	RCAccess           RC = 105
	RCIO               RC = 106
	RCNotFound         RC = 107
	RCAlreadyExists    RC = 108
	RCConsistency      RC = 109
	RCRepoNeedsRebuild RC = 110
	RCNotARepo         RC = 111
	RCRepoVersion      RC = 112
	RCDB               RC = 113
	RCBreak            RC = 114
	RCStepRow          RC = 115
	RCStepDone         RC = 116
	RCStepError        RC = 117
	RCType             RC = 118
	RCNotACkout        RC = 119
	RCRepoMismatch     RC = 120
	RCChecksumMismatch RC = 121
	RCLocked           RC = 122
	RCConflict         RC = 123
	RCSizeMismatch     RC = 124
	RCPhantom          RC = 125
	RCUnsupported      RC = 126
)

var rcNames = map[RC]string{
	RCOK: "ok", RCError: "error", RCNYI: "nyi", RCOOM: "oom",
	RCMisuse: "misuse", RCRange: "range", RCAccess: "access", RCIO: "io",
	RCNotFound: "not_found", RCAlreadyExists: "already_exists",
	RCConsistency: "consistency", RCRepoNeedsRebuild: "repo_needs_rebuild",
	RCNotARepo: "not_a_repo", RCRepoVersion: "repo_version", RCDB: "db",
	RCBreak: "break", RCStepRow: "step_row", RCStepDone: "step_done",
	RCStepError: "step_error", RCType: "type", RCNotACkout: "not_a_ckout",
	RCRepoMismatch: "repo_mismatch", RCChecksumMismatch: "checksum_mismatch",
	RCLocked: "locked", RCConflict: "conflict", RCSizeMismatch: "size_mismatch",
	RCPhantom: "phantom", RCUnsupported: "unsupported",
}

func (rc RC) String() string {
	if s, ok := rcNames[rc]; ok {
		return s
	}
	return fmt.Sprintf("rc_%d", int(rc))
}

type FslError struct {
	Code  RC
	Msg   string
	Cause error
}

func (e *FslError) Error() string {
	return fmt.Sprintf("fossil(%s): %s", e.Code, e.Msg)
}

func (e *FslError) Unwrap() error {
	return e.Cause
}

// ErrVersionNotFound is returned by ResolveVersion when the requested version
// string does not match any artifact in the repository. Callers can match
// with errors.Is.
var ErrVersionNotFound = errors.New("libfossil: version not found")

// ErrAmbiguousVersion is returned by ResolveVersion when a UUID prefix
// matches more than one artifact (collision). Callers can match with
// errors.Is.
var ErrAmbiguousVersion = errors.New("libfossil: ambiguous version prefix")

// ErrArtifactNotFound is returned by UUIDFromRID when the given RID does not
// correspond to any artifact in the repository's blob table, and by ReadBlob
// for a hash the blob table does not name. Callers can match with errors.Is.
var ErrArtifactNotFound = errors.New("libfossil: artifact not found")