Skip to content
A node module that extracts useful properties like user, repo, and branch from various flavors of GitHub URLs.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
test test: demonstrate REDOS vulnerabilities Feb 26, 2018
.gitignore first commit Nov 25, 2013
.travis.yml Protect against falsy repository.url Jun 7, 2017
README.md spaces May 23, 2018
bower.json bower gah Dec 6, 2014
index.js security: fix REDOS vulnerabilities Feb 26, 2018
package.json

README.md

github-url-to-object Build Status

A module for node.js and browsers that extracts useful properties like user, repo, and branch from various flavors of GitHub URLs.

There's also a Bitbucket equivalent to this library: bitbucket-url-to-object.

Check out the demo at zeke.github.io/github-url-to-object.

Installation

For Node.js or Browserify usage:

npm i github-url-to-object

For bower usage:

bower install github-url-to-object

Usage

Use whatever flavor of GitHub URL you like:

const gh = require('github-url-to-object')

gh('github:monkey/business')
gh('https://github.com/monkey/business')
gh('https://github.com/monkey/business/tree/master')
gh('https://github.com/monkey/business/tree/master/nested/file.js')
gh('https://github.com/monkey/business.git')
gh('http://github.com/monkey/business')
gh('git://github.com/monkey/business.git')
gh('git+https://github.com/monkey/business.git')

Here's what you'll get:

{
  user: 'monkey',
  repo: 'business',
  branch: 'master',
  tarball_url: 'https://api.github.com/repos/monkey/business/tarball/master',
  clone_url: 'https://github.com/monkey/business',
  https_url: 'https://github.com/monkey/business',
  travis_url: 'https://travis-ci.org/monkey/business',
  api_url: 'https://api.github.com/repos/monkey/business'
  zip_url: 'https://github.com/monkey/business/archive/master.zip'
}

The shorthand form lets you specify a branch:

gh('github:monkey/business#nachos')
{
  user: 'monkey',
  repo: 'business',
  branch: 'nachos',
  https_url: 'https://github.com/monkey/business/blob/nachos',
  tarball_url: 'https://api.github.com/repos/monkey/business/tarball/nachos',
  clone_url: 'https://github.com/monkey/business',
  travis_url: 'https://travis-ci.org/monkey/business?branch=nachos',
  api_url: 'https://api.github.com/repos/monkey/business'
  zip_url: 'https://github.com/monkey/business/archive/nachos.zip'
}

If you provide a non-GitHub URL or a falsey value, you'll get null.

GitHub Enterprise

If you're using GitHub Enterprise, pass the enterprise option to allow your non-github.com URL to be parsed:

gh('https://ghe.example.com:heroku/heroku-flags.git', { enterprise: true })

Test

npm install
npm test

js-standard-style

License

MIT

You can’t perform that action at this time.