ssb-git-repo

ssb-git-repo

Host git repos in secure-scuttlebutt

Example

var ssbGit = require('ssb-git-repo')
var repoId = '%CBeVWA9eYt6OhJDXFtqas6kWb5LwaJxYtfwDazKvh4U=.sha256'

// get a single repo:
ssbGit.getRepo(sbot, repoId, function (err, repo) {
  if (err) throw err
  // do something with the repo
})

API

ssbGit.createRepo(sbot[, options], cb(err, repo))

Create a repo. Publishes a message announcing the new repo.

• sbot: a scuttlebot or ssb-client object
• options.upstream (ssbGit.Repo or MsgId): upstream repo (of which the new repo will be a fork)
• options.name (string): name to give the repo
• options.live: keep the repo updated as changes are pushed to it
• options.output: stream for logging stuff to
• cb: function called when the repo is created
• err: error creating the repo, if any
• repo: ssbGit.Repo object for the new repo

ssbGit.getRepo(sbot, msgOrId[, options], cb(err, repo))

Get a repo.

• sbot: a scuttlebot or ssb-client object
• msgOrId: SSB message that started the repo, or the ID of it
• options.live: keep the repo updated as changes are pushed to it
• options.output: stream for logging stuff to
• cb: function called when the repo is retrieved
• err: error retrieving the repo, if any
• repo: ssbGit.Repo object for the retrieved repo

ssbGit.repos(sbot, options): source(repo)

Get repos from the feed

• sbot: a scuttlebot or ssb-client object
• options: options to pass to sbot.createFeedStream
• repo: ssbGit.Repo object

ssbGit.Repo

An abstract-pull-git-repo-compliant git repo object. Additional methods:

repo.close(cb(err))

Close the repo's update stream.

• cb: function called when the repo's stream is closed
• err: error closing the repo, if any

repo.getHead(cb(err, head))

Get the repo's HEAD, i.e. the "default branch" ref, e.g. `"refs/heads/master"

repo.hasObjectQuick(hash) : has

Check for the presence of a commit hash, with possible false negatives.

• hash (sha1): the commit id to check
• has (boolean): true if the commit is present

This will only show an object as present if it was pushed in ssb-git-repo

= v1.9.0.

Schema

type: git-repo

{ type: 'git-repo' }

Creates a git repo. Note that you can actually push git objects to any message in your feed, but the git-repo type is here to declare that a message will be for a git repo. It may have properties added later.

type: git-update

{
  type: 'git-update',
  repo: MsgId,
  repoBranch: [ MsgId ]?,
  refs: { <ref>: String|null }?,
  packs: [ BlobLink ]?,
  indexes: [ BlobLink ]?,
  head: string?,
  commits: [ { sha1: String, title: String } ]?,
  commits_more: Number?,
  num_objects: Number?,
  object_ids: [ String ]?,
}

Updates a repo. Published as a result of git push.

• repo: id of a message (expected of type git-repo) identifying the repo
• repoBranch: ids of latest concurrent previous git-update messages. Use to indicate causal order.
• refs: updates to the repo's refs. a map of ref names to git sha1 hashes. e.g. { 'refs/heads/master': commitId }
• packs: links to git packfiles being added to the repo
• indexes: links to index files for the packfiles in packs
• head: value of the HEAD symref, i.e. the default branch, e.g. "refs/heads/master"
• commits: array of info about commits that are included in packs, for display purposes
• commits\_more: number of commits included in packs but not in commits
• num_objects: number of objects included in packs
• object_ids: sha1 hashes of git objects included in packs, other than commit ids mentioned in commits. If not all can be included in the array because of the message size limit, omit this property instead of truncating the array.

License

Copyright (c) 2016 Charles Lehner

Usage of the works is permitted provided that this instrument is retained with the works, so that any entity that uses the works is notified of this instrument.

DISCLAIMER: THE WORKS ARE WITHOUT WARRANTY.