git

Documentation

Overview

The git transmat can unpack filesystems from the Git version control system.

The features of this are intentionally limited for rio's purposes: the git transmat is read-only (unpack; no pack); `rio unpack git` must specify a hash (this should come as no surprise, since it's the rule for all Rio pack types, but it is different than git-checkout. Neither git branches nor tags are acceptable, being indirect and mutable); and the unpacked filesystem will *not* include the `.git` dir (because paradoxically, the internal layout of the `.git` objects is can be quite unpredictable, and is definitely not a function of the commit hash!).

Packing into git is not supported because the semantics don't align: commit hashes are not a pure function of the packed file contents (due to additional info like commit timestamps and the parent commits), nor is it valid to store a single commit in git without a branch or tag name, and therefore the `api.PackFunc` signiture is almost totally incongruent. Git is designed for version control; not object storage. This is okay.

Index

• Constants
• func Unpack(ctx context.Context, wareID api.WareID, path string, ...) (_ api.WareID, err error)

Constants

const PackType = api.PackType("git")

Functions

func Unpack

func Unpack(
	ctx context.Context,
	wareID api.WareID,
	path string,
	filt api.FilesetUnpackFilter,
	placementMode rio.PlacementMode,
	warehouses []api.WarehouseLocation,
	mon rio.Monitor,
) (_ api.WareID, err error)