parse-github-url

What is parse-github-url?

The parse-github-url npm package is a utility for parsing GitHub repository URLs into their component parts. It helps in extracting information such as the owner, repository name, branch, and file path from a given GitHub URL.

What are parse-github-url's main functionalities?

Parse GitHub URL

This feature allows you to parse a GitHub URL and extract its components such as the owner, repository name, and more. The code sample demonstrates how to use the package to parse a GitHub URL and log the parsed components.

const parse = require('parse-github-url');
const parsed = parse('https://github.com/IonicaBizau/parse-github-url');
console.log(parsed);

Extract Owner and Repository

This feature allows you to specifically extract the owner and repository name from a GitHub URL. The code sample shows how to parse the URL and log the owner and repository name.

const parse = require('parse-github-url');
const { owner, name } = parse('https://github.com/IonicaBizau/parse-github-url');
console.log(`Owner: ${owner}, Repository: ${name}`);

Handle Different URL Formats

This feature demonstrates the package's ability to handle different GitHub URL formats, including those with different protocols and extensions. The code sample shows how to parse a URL with the 'git+' protocol and '.git' extension.

const parse = require('parse-github-url');
const parsed = parse('git+https://github.com/IonicaBizau/parse-github-url.git');
console.log(parsed);

Other packages similar to parse-github-url

github-url-to-object

The github-url-to-object package converts GitHub URLs to objects containing useful information like owner, name, and branch. It is similar to parse-github-url but also includes additional properties like API URLs and HTTPS URLs.

parse-repo

The parse-repo package parses repository URLs from various hosting services, including GitHub. It provides a more generalized solution compared to parse-github-url, which is specific to GitHub.

git-url-parse

The git-url-parse package parses Git URLs and supports multiple Git hosting services, including GitHub, GitLab, and Bitbucket. It offers a broader range of functionality compared to parse-github-url, which is focused solely on GitHub.

README

parse-github-url

Parse a github URL into an object.

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.

Install with npm

npm i parse-github-url --save

Usage

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

Results in:

{
  "user": "jonschlinkert",
  "repo": "micromatch",
  "repopath": "jonschlinkert/micromatch",
  "branch": "master"
}

Example results

Generated results from test fixtures:

// assemble/verb#1.2.3
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "1.2.3"
}

// assemble/verb#branch
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "branch"
}

// assemble/verb
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

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

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

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

// git://github.assemble.com/assemble/verb.git
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

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

// git://github.com/assemble/verb
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

// git://github.com/assemble/verb.git
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

// [e-mail]:assemble/verb.git
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

// [e-mail]:assemble/verb.git#1.2.3
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "1.2.3"
}

// [e-mail]:assemble/verb.git#v1.2.3
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "v1.2.3"
}

// [e-mail]:assemble/verb.git
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

// github:assemble/verb
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

// http://github.com/assemble
{
  "user": "assemble",
  "repo": null,
  "repopath": null,
  "branch": "master"
}

// http://github.com/assemble/verb
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

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

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

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

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

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

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

// https://[e-mail]/assemble/verb.git
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

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

// https://github.com/assemble/verb
{
  "user": "assemble",
  "repo": "verb",
  "repopath": "assemble/verb",
  "branch": "master"
}

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

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

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

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

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

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

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

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

Related projects

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

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

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright (c) 2015 Jon Schlinkert
Released under the MIT license

---

This file was generated by verb-cli on March 25, 2015.

Changelog

v0.2.1 - 2015-10-17

Merged

• Return null if user is undefined #4

Commits

• Add tests 23a2f5c