repository-provider
Advanced tools
abstract interface to git repository providers like github bitbucket
abstract interface to git repository providers like github bitbucket
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();
Base repository provider acts as a source of repositories
Parameters
options ObjectProperties
Provider initialization will be called once before content addressing method is called
Returns Class repository class used by the Provider
Returns Class branch class used by the Provider
Returns Class content class used by the Provider
Returns Class pull request class used by the Provider
Create a new repository
Parameters
Returns Promise<Repository>
Delete a repository
Parameters
name stringLookup a repository
Parameters
name stringReturns Promise<Repository>
Lookup a branch First lookup repository then the branch If no branch was specified then the default branch will be delivered.
Parameters
name string with optional branch name as '#myBranchName'Is our rate limit reached. By default we have no rate limit
Returns boolean always false
Deliver the repository type
Returns string 'git'
Default configuration options
Returns Object
Pepare configuration by mixing together defaultOptions with actual options
Parameters
config Object raw configReturns Object combined options
Abstract branch
Parameters
repository Repositoryname string (optional, default 'master')Properties
repository Repositoryprovider Providername stringcalled one after constructing
Returns Promise
Returns Provider
Branch owner By default we provide the repository owner
Returns string
Branch project By default we provide the repository project
Returns string
Deliver repository and branch name combined
Returns string 'repo#branch'
Deliver repository and branch name combined. But skipping the branch name if it is the default branch
Returns string 'repo#branch'
Deliver repository and branch url combined
Returns string 'repoUrl#branch'
Are we the default branch
Returns boolean name is 'master'
Delete the branch from the Repository.
Deliver file content
Parameters
path stringReturns Promise<Content> content of a given file
Commit files
Parameters
Returns Promise
Create a pull request
Parameters
Returns Promise
File list
Value delivered from the provider
Returns boolean providers rateLimitReached
forward to the Provider
Parameters
value booleanAbstract repository
Parameters
Properties
Called one after constructing
Lookup content form the default branch
Parameters
args ...anyReturns Content
Deliver urls to access the repo
Deliver preffered url to access the repo
Returns string
Deliver the url of issue tracking system.
Returns string
Deliver the url of home page.
Returns string
Repository owner Default implementation delivers undefined
Returns string undefined
Repository project Default implementation delivers undefined
Returns string undefined
Lookup branch by name
Parameters
name stringLookup the default branch
Returns Promise<Branch> 'master' branch
Returns Promise<Map> of all branches
Create a new Branch by cloning a given source branch
Parameters
Returns Promise<Branch> newly created branch
Delete a Branch
Parameters
name stringAdd a branch
Parameters
branch BranchDelete the repository from the Provider.
Deliver all @{link PullRequest}s
Returns Promise<Map> of all pull requests
Deliver @{link PullRequest} for a given name
Parameters
name stringReturns Promise<PullRequest>
Add a pull request
Parameters
pullRequest PullRequestReturns Promise
Delete a PullRequest
Parameters
name stringReturns Promise
Value delivered from the provider
Returns boolean providers rateLimitReached
forward to the Provider
Parameters
value booleanAbstract pull request
Parameters
Properties
name stringrepository Repositoryprovider Providertitle string?state string?Returns Provider
Delete the pull request from the Repository.
Returns Promise
Parameters
pathcontent (optional, default undefined)type (optional, default 'blob')mode (optional, default '100644')Properties
content (string | Buffer)path string file name inside of the repositorytype string tpye of the contentmode string file permissionsWith npm do:
npm install repository-provider
BSD-2-Clause
FAQs
abstract interface to git repository providers like github, bitbucket and gitlab
We found that repository-provider demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.