Stages the given file or files in the working clone. The invocation will be rejected if any files (given with their file URIs) is not among the changed files.
the repository to stage the files.
one or multiple file URIs to stage in the working clone.
Returns the annotations of each line in the given file.
the repository which contains the given file.
the URI of the file to get the annotations for.
more options refining the git blame
.
Returns with the currently active branch, or undefined
if the current branch is in detached mode.
the type of the branch, which is always the current
.
Returns with an array of branches.
the type of the branch, which is either the local
, the remote
, or all
of them.
Creates, renames, and deletes a branch.
further Git command refinements for the branch modification.
Switches branches or restores working tree files.
the repository to where the git checkout
has to be performed.
further checkout options.
Clones a remote repository into the desired local location.
the URL of the remote.
the clone options.
Commits the changes of all staged files in the working directory.
the repository where the staged changes has to be committed.
the optional commit message.
Shows the difference between content pairs in the working tree, commits, or index.
the repository where where the diff has to be calculated.
optional configuration for further refining the git diff
command execution.
Executes the Git command and resolves to the result. If an executed Git command exits with a code that is not in the successExitCodes
or an error not in expectedErrors
,
a GitError
will be thrown.
the repository where one can execute the command. (Although the repository path is not necessarily mandatory for each Git commands,
such as git config -l
, or git --version
, we treat the repository as a required argument to have a symmetric API.)
the array of arguments for Git.
options can be used to tweaked additional configurations for the low-level command execution.
Fetches branches and/or tags (collectively, refs
) from the repository, along with the objects necessary to complete their histories.
The remotely-tracked branches will be updated too.
the repository to fetch from.
optional options for git fetch
refinement.
Returns a list with commits and their respective file changes.
the repository where the log has to be calculated.
optional configuration for further refining the git log
command execution.
Resolves to true
if the file is managed by the Git repository. Otherwise, false
.
Shows information about files in the index and the working tree
the repository where the git lf-files
has to be executed.
the URI of the file to check.
further options for the command executions.
Merges the given branch into the currently active branch.
the repository to merge from.
git merge
command refinements.
Fetches from and integrates with another repository. It incorporates changes from a repository into the current branch.
In its default mode, git pull
is shorthand for git fetch
followed by git merge FETCH_HEAD
.
the repository to pull from.
optional refinements for the git pull
command.
Updates the refs
using local refs
, while sending objects necessary to complete the given refs
by pushing
all committed changed from the local Git repository to the remote
one.
the repository to push to.
optional refinements for the git push
command.
It resolves to an array of configured remotes names for the given repository.
the repository to get the remote names.
It resolves to an array of configured remote objects for the given Git action.
the repository to get the remote objects.
git remote
command refinements.
Resolves to an array of repositories discovered in the workspace given with the workspace root URI.
Resets the current HEAD
of the entire working directory to the specified state.
the repository which state has to be reset.
further clarifying the git reset
command.
Returns the commit SHA of the given ref if the ref exists, or returns 'undefined' if the given ref does not exist.
the repository where the ref may be found.
configuration containing the ref and optionally other properties for further refining the git rev-parse
command execution.
Retrieves and shows the content of a resource from the repository at a given reference, commit, or tree. Resolves to a promise that will produce a string containing the contents of the file or an error if the file does not exists in the given revision.
the repository to get the file content from.
the URI of the file who's content has to be retrieved and shown.
the options for further refining the git show
.
The default git stash
command. Equivalent to git stash push
. If the message
is not defined, the Git default WIP on branchname will be used instead.
Resolves to an array of stashed entries that you currently have. Same as git stash list
.
Removes all the stash entries.
Performs stash actions depending on given action option.
pop:
Removes a single stashed state from the stash list and applies it on top of the current working tree state.
The single stashed state is identified by the optional id
. If the id
is not defined the latest stash will be popped.
apply:
Like git stash pop
, but does not remove the state from the stash list.
drop:
Removes a single stash entry from the list of stash entries. When the id
is not given, it removes the latest one.
Returns with the working directory status of the given Git repository.
Removes the given file or files among the staged files in the working clone. The invocation will be rejected if any files (given with their file URIs) is not among the staged files.
the repository to where the staged files have to be removed from.
one or multiple file URIs to unstage in the working clone. If the array is empty, all the changed files will be staged.
optional refinements for the the unstaging operation.
Provides basic functionality for Git.