github-url-to-object

2018-10-11 admin

github-url-to-object是什么

什么是github-url-to-object,Extract user, repo, and other interesting properties from GitHub URLs

github-url-to-object使用教程帮助文档

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

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处。

转载请注明:文章转载自 JavaScript中文网 [https://www.javascriptcn.com]

本文地址:https://www.javascriptcn.com/read-42399.html

文章标题:github-url-to-object

回到顶部