clojure.tools.gitlibs — org.clojure/tools.gitlibs 2.5.197

An API for retrieving and caching git repos and working trees.

The git url can be either an https url for anonymous checkout or an ssh url for private access. revs can be either full sha, prefix sha, or tag name.

cache-dir clj

(cache-dir)

Return the root gitlibs cache directory. By default ~/.gitlibs or override by setting the environment variable GITLIBS.

commit-sha clj

(commit-sha url rev)

Returns unpeeled full commit sha, given a rev (which may be tag, branch, etc)

descendant clj

(descendant url revs)

Returns rev in git url which is a descendant of all other revs, or nil if no such relationship can be established.

object-type clj

(object-type url rev)

Takes a git url and rev, and returns the object type, one of :tag :tree :commit or :blob, or nil if not known or ambiguous.

procure clj

(procure url lib rev)

Procure a working tree at rev for the git url representing the library lib, returns the directory path. lib is a qualified symbol where the qualifier is a controlled or conveyed identity, or nil if rev is unknown.

resolve clj

(resolve url rev)

Takes a git url and a rev, and returns the full commit sha or nil if can't resolve. rev may be a partial sha, full sha, or tag name.

tags clj

(tags url)

Fetches, then returns coll of tags in git url