Web tools weboptions >>

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 informations.

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 "git@github.com:"]

insteadOf = https://github.com/

Used function(s)


libgit2 (https://libgit2.org/)

Example


url = 'https://github.com/Nelson-numerical-software/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

Web tools weboptions >>