ES-Git

Git implemented in EcmaScript, a fork of JS-Git

Example

This basic example shows how to do low-level manipulation of an in-memory repository

import { Mode, mix } from '@rs4/es-git-core';
import MemoryRepo from '@rs4/es-git-memory-repo';
import objectMixin from '@rs4/es-git-object-mixin';
import saveAsMixin from '@rs4/es-git-save-as-mixin';
import loadAsMixin from '@rs4/es-git-load-as-mixin';

async function test(){
  // Create the repository in memory and
  // enhance it using three mixins
  class Repo extends mix(MemoryRepo)
                    .with(objectMixin)
                    .with(saveAsMixin)
                    .with(loadAsMixin) {}

  // Create an instance of the repository
  const repo = new Repo();

  // Save a text file in the repo with the contents `hello`
  const hash = await repo.saveText('hello');

  // Save a folder with one file, the one we created above
  const tree = await repo.saveTree({
    'file.txt': {
      mode: Mode.file,
      hash
    }
  });

  // Commit the file and folder to the repo
  const commitHash = await repo.saveCommit({
    author: {
      name: 'Tim Caswell',
      email: 'tim@creationix.com',
      date: new Date()
    },
    committer: {
      name: 'Marius Gundersen',
      email: 'me@mariusgundersen.net',
      date: new Date()
    },
    message: 'initial commit',
    tree,
    parents: []
  });

  // Point the master branch to the commit
  await repo.setRef('refs/heads/master', commitHash);

  // Get the hash that the master branch points to
  const refHash = await repo.getRef('refs/heads/master');
  if(!refHash) throw new Error('branch does not exist');

  // Get the commit (the hash of the tree and the message) using the hash
  const {tree: treeHash, message} = await repo.loadCommit(refHash);
  console.log(message); // `initial commit`

  // Get the hash to the `file.txt' file in the tree
  const {'file.txt': {hash: fileHash}} = await repo.loadTree(treeHash);

  // Get the content of the file as a string
  const content = await repo.loadText(fileHash);
  console.log(content) // `hello`
};

test();

Repositories

These are the core storage packages. They all implement IRawRepo. Pick one that fits your project, and enhance it with the mixins.

Mixins

These mixins add features to the repo. Some of them depend on other mixins, so the order in which the mixins are applied is significant.

zlib-mixin
object-mixin
fetch-mixin
cache-objects-mixin (depends on object-mixin)
read-combiner-mixin (depends on object-mixin)
path-to-object-mixin (depends on object-mixin)
load-as-mixin (depends on object-mixin)
save-as-mixin (depends on object-mixin)
walkers-mixin (depends on object-mixin)
commit-mixin (depends on object-mixin)
push-mixin (depends on object-mixin and walkers-mixin)
checkout-mixin (depends on object-mixin and walkers-mixin)

Other packages

Relationship to JS-Git