ssb-pull-requests

Pull requests for git-ssb repos

API

var Pulls = require('ssb-pull-requests')
var pulls = Pulls.init(sbot)

get: async

Get a pull request by its id

pulls.get(id, cb)

→

{
  id: Ref,
  created_at: timestamp,
  headRepo: Ref,
  headBranch: string,
  baseRepo: Ref,
  baseBranch: string,
  title: string?,
  text: string?,
  open: boolean,
  mergeable: boolean?
}

• mergeable: whether the pull request can be automatically merged (true), or not (false), or it is unknown (null)

list: source

Get a stream of pull requests

issues.list({ repo:, open:, author:, live:, gt:, gte:, lt:, lte:, reverse: })

• repo (Ref): filter by base git-ssb repo
• open (boolean): filter by open/closed status
• author (FeedRef): get only pull requests created by the given feed
• live (boolean, default: false): Keep the stream open and emit new messages as they are received.
• gt (greater than), gte (greater than or equal): maximum [timestamp, id]
• lt (less than), lte (less than or equal): minimum [timestamp, id]
• reverse (boolean, default: false): reverse the order of results

→

{
  id: Ref,
  created_at: timestamp,
  repo: Ref,
  branch: string,
  head_repo: Ref,
  head_branch: string,
  title: string?,
  text: string?,
  open: boolean,
  mergeable: boolean?,
}

• mergeable: whether the pull request can be automatically merged

Schemas

var prSchemas = Pulls.schemas

prSchemas.new(baseRepo, baseBranch, headRepo, headBranch, title, text)

Create a pull request. A pull request is a request to pull from a branch of one git-ssb repo (head), to a branch on another git-ssb repo (base).

• baseRepo (Ref): repo to request changes pulled into
• baseBranch (string): branch of the repo to request changes pulled into
• headRepo (Ref): repo where the changes are implemented
• headBranch (string): branch of the repo to pull from
• title (string): title of the pull request
• text (string): text describing the pull request

→

{
  type: 'pull-request',
  project: Ref,
  repo: Ref,
  branch: string,
  base_repo: Ref,
  base_branch: string,
  title: string?,
  text: string?
}

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.