JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1894338
  • Score
    100M100P100Q200466F
  • License MIT

Parse a github URL into an object.

Package Exports

  • parse-github-url

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (parse-github-url) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

parse-github-url NPM version Build Status

Parse a github URL into an object.

HEADS UP! Breaking changes in 0.3.0!!!

See the release history for details.

Why another GitHub URL parser library?

Seems like every lib I've found does too much, like both stringifying and parsing, or converts the URL from one format to another, only returns certain segments of the URL except for what I need, yields inconsistent results or has poor coverage.

TOC

(TOC generated by verb using markdown-toc)

Usage

var gh = require('parse-github-url');
gh('https://github.com/jonschlinkert/micromatch');

Results in:

{
  "owner": "jonschlinkert",
  "name": "micromatch",
  "repo": "jonschlinkert/micromatch",
  "branch": "master"
}

Example results

Generated results from test fixtures:

// assemble/verb#1.2.3
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "1.2.3"
}

// assemble/verb#branch
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "branch"
}

// assemble/verb
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git+https://github.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git+ssh://github.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git://gh.pages.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git://github.assemble.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git://github.assemble.two.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git://github.com/assemble/verb
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git://github.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git@gh.pages.com:assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// git@github.com:assemble/verb.git#1.2.3
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "1.2.3"
}

// git@github.com:assemble/verb.git#v1.2.3
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "v1.2.3"
}

// git@github.com:assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// github:assemble/verb
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// http://github.com/assemble
{
  "owner": "assemble",
  "name": null,
  "repo": null,
  "branch": "master"
}

// http://github.com/assemble/verb
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// http://github.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// http://github.com/assemble/verb/tree
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// http://github.com/assemble/verb/tree/master
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// http://github.com/assemble/verb/tree/master/foo/bar
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master/foo/bar"
}

// https://assemble.github.com/assemble/verb/somefile.tar.gz
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://assemble.github.com/assemble/verb/somefile.zip
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://assemble@github.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://gh.pages.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://github.com/assemble/verb
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://github.com/assemble/verb.git
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://github.com/assemble/verb/blob/1.2.3/README.md
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "1.2.3"
}

// https://github.com/assemble/verb/blob/249b21a86400b38969cee3d5df6d2edf8813c137/README.md
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://github.com/assemble/verb/blob/master/assemble/index.js
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://github.com/assemble/verb/tree/1.2.3
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "1.2.3"
}

// https://github.com/assemble/verb/tree/feature/1.2.3
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "feature/1.2.3"
}

// https://github.com/repos/assemble/verb/tarball
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

// https://github.com/repos/assemble/verb/zipball
{
  "owner": "assemble",
  "name": "verb",
  "repo": "assemble/verb",
  "branch": "master"
}

is-git-url: Regex to validate that a URL is a git url. | homepage

History

v0.3.0

To be more consistent with node.js/package.json conventions, the following properties were renamed in v0.3.0:

  • repo is now name (project name)
  • repopath is now repository (project repository)
  • user is now owner (project owner or org)

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Author

Jon Schlinkert

License

Copyright © 2016 Jon Schlinkert Released under the MIT license.

This file was generated by verb on January 17, 2016.