Working with Git

Dirigible's IDE Git perspective and the git SDK module both wrap JGit against repositories registered under a workspace. Repositories are addressed by (workspaceName, repositoryName) - URI and credentials appear only on clone, pull, and push.

From the IDE

The Git perspective provides the everyday flow: clone, commit, push, pull, branch, diff, log. Use it for interactive work.

From user code

import { Git } from "@aerokit/sdk/git";

Git.cloneRepository("myws", "https://github.com/acme/svc.git", "user", "token", "main");
Git.commit("alice", "alice@acme.com", "myws", "svc", "tighten validation", true);
Git.push("myws", "svc", "user", "token");

import org.eclipse.dirigible.sdk.git.Git;

Git.cloneRepository("myws", "https://github.com/acme/svc.git", "user", "token", "main");
Git.commit("alice", "alice@acme.com", "myws", "svc", "tighten validation", true);
Git.push("myws", "svc", "user", "token");

Reading commit history:

import org.eclipse.dirigible.components.ide.git.domain.GitCommitInfo;
import java.util.List;

List<GitCommitInfo> history = Git.getHistory("svc", "myws", "src/Main.java");

File content at a specific revision

String content = Git.getFileContent("myws", "svc", "src/Main.java", "HEAD~3");

Reaching the JGit API directly

For operations not covered by the facade - rebase strategies, cherry-picks, advanced merge configs - drop down to org.eclipse.jgit.api.Git against the on-disk repository path. Resolve the path through IRepository or the workspace API.

See also

• @aerokit/sdk/git/client
• org.eclipse.dirigible.sdk.git.Git
• Git perspective