repository-provider

repository-provider

abstract interface to git repository providers like github bitbucket

Example

import { GithubProvider } from 'repository-provider';

const provider = new GithubProvider({ token: 'xxx' });

const repository = await provider.repository('myuser/myrepo');
const branch = await repository.branch('master');
const files = await branch.list();

Derived Providers

list by repository-provider keyword

API

Table of Contents

• Provider
  • Parameters
  • Properties
  • repositoryGroup
    • Parameters
  • createRepositoryGroup
    • Parameters
  • repository
    • Parameters
  • branch
    • Parameters
  • repositoryGroupClass
  • rateLimitReached
  • name
  • provider
  • toJSON
  • optionsFromEnvironment
    • Parameters
• priority
• Branch
  • Parameters
  • Properties
• defaultOptions
• defaultOptions
• defaultOptions
• OneTimeInititalizer
• Owner
  • Properties
• logger
  • Parameters
• Repository
  • Parameters
  • Properties
• description
• description
• id
• id
• id
• PullRequest
  • Parameters
  • Properties
  • provider
  • delete
  • merge
  • decline
• title
• body
• state
• locked
• merged
• RepositoryGroup
  • Parameters
  • Properties
  • repositoryClass
  • branchClass
  • contentClass
  • pullRequestClass
• definePropertiesFromOptions
  • Parameters

Provider

Extends Owner

Base repository provider acts as a source of repositories

Parameters

• options Object

Properties

• repositoryGroups Map<string, RepositoryGroup>

repositoryGroup

Lookup a repository group

Parameters

• name string of the group
• options Object

Returns Promise<RepositoryGroup>

createRepositoryGroup

Create a new repository group

Parameters

• name string
• options Object

Returns Promise<RepositoryGroup>

repository

Lookup a repository in the provider and all of its repository groups

Parameters

• name string of the repository
• options Object

Returns Promise<Repository>

branch

Lookup a branch in the provider and all of its repository groups

Parameters

• name string of the branch
• options Object

Returns Promise<Branch>

repositoryGroupClass

Returns Class repository group class used by the Provider

rateLimitReached

Is our rate limit reached. By default we have no rate limit

Returns boolean always false

name

Deliver the provider name

Returns string class name by default

provider

we are our own provider

Returns Provider this

toJSON

list all defined entries from defaultOptions

optionsFromEnvironment

Extract options suitable for the constructor form the given set of environment variables

Parameters

• env Object

Returns Object undefined if no suitable environment variables have been found

priority

in case there are several provider able to support a given source which one sould be used ? this defines the order

Branch

• See: Repository#addBranch

Abstract branch

Parameters

• repository Repository
• name string
• options Object

Properties

• repository Repository
• provider Provider
• name string

defaultOptions

options

defaultOptions

options

defaultOptions

options

OneTimeInititalizer

enshures that _initialize() will be called only once

Owner

Collection of repositories

Properties

• repositories Map<string, Repository>

logger

default logger

Parameters

• arg ...any

Repository

Abstract repository

Parameters

• owner Owner
• name string (#branch) will be removed
• options Object
  • options.description string? human readable description
  • options.id string? internal id

Properties

• owner Owner
• name string without (#branch)
• description string? from options.description
• id string? from options.id
• branches Map<string, Branch>
• pullRequests Map<string, PullRequest>

description

the description of the repository content.

Returns string

description

the description of the repository group.

Returns string

id

unique id within the provider.

Returns string

id

internal id.

Returns string

id

unique id within the provider.

Returns string

PullRequest

Abstract pull request Repository#addPullRequest

Parameters

• source Branch
• destination Branch
• name string
• options Object
  • options.title string?
  • options.state string?
  • options.merged boolean?
  • options.locked boolean?

Properties

• name string
• source Branch
• destination Branch
• title string?
• state string?
• merged boolean?
• locked boolean?

provider

Returns Provider

delete

• See: Repository#deletePullRequest

Delete the pull request from the Repository.

Returns Promise

merge

Merge the pull request

decline

Decline the pull request

title

the one line description of the pull request.

Returns string

body

the description of the pull request.

Returns string

state

state of the pull request.

Returns string

locked

locked state of the pull request.

Returns boolean

merged

merged state of the pull request.

Returns boolean

RepositoryGroup

Extends Owner

Abstract repository collection

Parameters

• provider Provider
• name string of the group
• options Object
  • options.description string? human readable description
  • options.id string? internal id

Properties

• provider Provider
• name string

repositoryClass

By default we use the providers implementation.

Returns Class as defined in the provider

branchClass

By default we use the providers implementation.

Returns Class as defined in the provider

contentClass

By default we use the providers implementation.

Returns Class as defined in the provider

pullRequestClass

By default we use the providers implementation.

Returns Class as defined in the provider

definePropertiesFromOptions

• See: Object.definedProperties()

create properties from options and default options

Parameters

• object Object target object
• options Object as passed to object constructor
• properties Object object properties (optional, default {})

install

With npm do:

npm install repository-provider

license

BSD-2-Clause