repo

Git repository tool for Nelson

Syntax

• repo('clone', url, branch, destination)

• repo('clone', url, destination)

• repo('clone', url, branch, destination, username, password)

• repo('clone', url, destination, username, password)

• repo('export', url, branch_tag_sha1, destination)

• repo('export', url, destination)

• repo('export', url, branch_tag_sha1, destination, username, password)

• repo('export', url, destination, username, password)

• repo('checkout', destination, branch_tag_sha1)

• ce = repo('branch', destination)

• ce = repo('tag', destination)

• st = repo('log', destination)

• repo('fetch', destination)

• repo('fetch', destination, username, password)

• repo('remove_branch', destination, branch)

• current_branch = repo('current_branch', destination)

Input argument

• url - a string: URL to a git repository.

• branch - a string: branch name.

• destination - a string: local pathname.

• branch_tag_sha1 - a string: a branch name, tag or sha1.

• username - a string: username used if an authentification is required.

• password - a string: password used if an authentification is required.

Output argument

• ce - a cell: list of tags or branchs.

• st - a structure: contains log information.

• current_branch - a string: name of current branch.

Description

repo() allows to clone, checkout, fetch a git repository.

checkout command will be forced and remove untracked filed.

git https protocol works on all platforms. git ssh protocol works currently on macos and linux platforms.

report('export', ...) clone and remove .git directory.

Tips:

If you have this error: callback returned unsupported credentials type , checks your ~/.gitconfig file.

You don't have some ssh or https redirection.

Remove entries:

[url "[e-mail]:"]

insteadOf = https://github.com/

Used function(s)

libgit2 (https://libgit2.org/)

Example

url = 'https://github.com/nelson-lang/module_skeleton.git';
destination = [tempdir(), 'demo_repo'];
if isdir(destination)
    rmdir(destination, 's');
end
mkdir(destination);
repo('clone', url, destination)
repo('tag', destination)
repo('branch', destination)
repo('current_branch', destination)
repo('log', destination)

See also

webread.

History

Version	Description
1.0.0	initial version

Author

Allan CORNET