gitfs

README

Package gitfs presents a file tree downloaded from a remote Git repo as an in-memory fs.FS. See the API reference.

Documentation

Overview

Package gitfs presents a file tree downloaded from a remote Git repo as an in-memory fs.FS.

Index

• type Hash
  • func (h Hash) String() string
• type Repo
  • func NewRepo(url string) (*Repo, error)
  • func (r *Repo) Clone(ref string) (Hash, fs.FS, error)
  • func (r *Repo) CloneHash(h Hash) (fs.FS, error)
  • func (r *Repo) Resolve(ref string) (Hash, error)

Types

type Hash

type Hash [20]byte

A Hash is a SHA-1 Hash identifying a particular Git object.

func (Hash) String

func (h Hash) String() string

type Repo

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

A Repo is a connection to a remote repository served over HTTP or HTTPS.

func NewRepo

func NewRepo(url string) (*Repo, error)

NewRepo connects to a Git repository at the given http:// or https:// URL.

func (*Repo) Clone

func (r *Repo) Clone(ref string) (Hash, fs.FS, error)

Clone resolves the given ref to a hash and returns the corresponding fs.FS.

func (*Repo) CloneHash

func (r *Repo) CloneHash(h Hash) (fs.FS, error)

CloneHash returns the fs.FS for the given hash.

func (*Repo) Resolve

func (r *Repo) Resolve(ref string) (Hash, error)

Resolve looks up the given ref and returns the corresponding Hash.