shithub: furgit

ref: df1f2fb3daa1acd25c88510f259d5535fb482126
dir: /object/fetch/path.go/

package fetch

import (
	"fmt"

	objectid "codeberg.org/lindenii/furgit/object/id"
	"codeberg.org/lindenii/furgit/object/tree"
)

// PathEmptyError indicates that Path received no segments.
type PathEmptyError struct{}

func (err *PathEmptyError) Error() string {
	return "object/fetch: empty tree path"
}

// PathSegmentEmptyError indicates that one path segment is empty.
type PathSegmentEmptyError struct {
	Index int
}

func (err *PathSegmentEmptyError) Error() string {
	return fmt.Sprintf("object/fetch: empty tree path segment at index %d", err.Index)
}

// PathNotFoundError indicates that one tree path segment was not found.
type PathNotFoundError struct {
	Index int
	Name  []byte
}

func (err *PathNotFoundError) Error() string {
	return fmt.Sprintf("object/fetch: tree entry %q not found at index %d", err.Name, err.Index)
}

// PathNotTreeError indicates that one intermediate path segment was not a tree.
type PathNotTreeError struct {
	Index int
	Name  []byte
}

func (err *PathNotTreeError) Error() string {
	return fmt.Sprintf("object/fetch: path segment %q at index %d is not a tree", err.Name, err.Index)
}

// Path resolves parts within the tree identified by root and returns the final
// tree entry.
//
// The root object may be any tree-ish object accepted by PeelToTree.
//
// parts must contain at least one path segment. Intermediate path segments
// must resolve to tree entries. The final entry is returned without loading
// its object. Path segments may not contain \x00.
//
// The path cannot be accurately represented as a string or a single []byte
// because Git tree entry names may include slashes. While []string is
// technically possible (since Go strings are not necessarily UTF-8), they
// do often imply UTF-8 in practice, which would be undesirable.
//
// If your entry names are valid UTF-8 and uses / solely as segment separators,
// it may be convenient to use TreeFS for an io/fs.FS-like interface.
//
// Labels: Life-Parent.
func (r *Fetcher) Path(root objectid.ObjectID, parts [][]byte) (tree.TreeEntry, error) {
	if len(parts) == 0 {
		return tree.TreeEntry{}, &PathEmptyError{}
	}

	current, err := r.PeelToTree(root)
	if err != nil {
		return tree.TreeEntry{}, err
	}

	for i, part := range parts {
		if len(part) == 0 {
			return tree.TreeEntry{}, &PathSegmentEmptyError{Index: i}
		}

		entry := current.Object().Entry(part)
		if entry == nil {
			return tree.TreeEntry{}, &PathNotFoundError{
				Index: i,
				Name:  append([]byte(nil), part...),
			}
		}

		if i == len(parts)-1 {
			return *entry, nil
		}

		if entry.Mode != tree.FileModeDir {
			return tree.TreeEntry{}, &PathNotTreeError{
				Index: i,
				Name:  append([]byte(nil), part...),
			}
		}

		current, err = r.ExactTree(entry.ID)
		if err != nil {
			return tree.TreeEntry{}, err
		}
	}

	return tree.TreeEntry{}, &PathNotFoundError{Index: len(parts) - 1}
}