Open NPM package/module homepage url from NPM registry. Support CLI and Promises
npm install homepage```
$ npm install homepage -g
$ homepage --help
promise example (open self)
`js`
homepage({promise: true})
.then(function resolve(res) {
assert(typeof res === 'object' && typeof res.visit === 'string')
assert(res.visit === 'https://github.com/tunnckoCore/homepage')
})`
callback example (open mocha)js`
homepage('mocha', function(err, res) {
assert(err === null)
assert(typeof res === 'object' && typeof res.visit === 'string')
console.log(res.visit)
//=> https://github.com/mochajs/mocha
})
`
$ npm test
`
API
#### homepage(name, [options], [callback])
-
name {String|Object} Name of the npm package
- options {Object|Fn} Options can be callback, if repo is object and .promise: false
- name {String} Name of the npm package
- promise {Boolean} Handle response with promise - true/false or empty
- callback {Fn} Node-style callback, same as always
CLI
`
$ homepage --help
`$3
> Flags can be used in any order.-
--help
- --version
- -n|--name|1st arg {String} Name of the npm package
- -p|--promise|2nd arg {Boolean} Handle response with promise - true/false or emptyExample usage
`
$ homepage [promise]
$ homepage mocha # open github.com/mochajs/mocha
$ homepage -n koa -p # open github.com/koajs/koa
$ homepage gulp # open gulpjs.com
$ homepage lodash -p # open lodash.com
$ homepage --promise --name assemble # open assemble.io
$ homepage -n express # open expressjs.com
`
Authors & Contributors
Charlike Mike Reagent [![author tips][author-gittip-img]][author-gittip]
+ [gittip/tunnckoCore][author-gittip]
+ [github/tunnckoCore][author-github]
+ [twitter/tunnckoCore][author-twitter]
+ [npmjs/tunnckoCore][author-npmjs]
+ [more ...][author-more]
License [![MIT license][license-img]][license-url]
Copyright (c) 2014 [Charlike Mike Reagent][author-website], contributors.
Released under the [MIT`][license-url] license.
[downloads-img]: http://img.shields.io/npm/dm/homepage.svg
[npm-required-version-img]: http://img.shields.io/badge/npm-%3E=%201.4.28-blue.svg
[node-required-version-img]: https://img.shields.io/node/v/homepage.svg
[node-required-version-url]: http://nodejs.org/download/
[npmjs-url]: http://npm.im/homepage
[npmjs-fury]: https://badge.fury.io/js/homepage.svg
[npmjs-shields]: https://img.shields.io/npm/v/homepage.svg
[npmjs-install]: https://nodei.co/npm/homepage.svg?mini=true
[coveralls-url]: https://coveralls.io/r/tunnckoCore/homepage?branch=master
[coveralls-shields]: https://img.shields.io/coveralls/tunnckoCore/homepage.svg
[license-url]: https://github.com/tunnckoCore/homepage/blob/master/license.md
[license-img]: http://img.shields.io/badge/license-MIT-blue.svg
[travis-url]: https://travis-ci.org/tunnckoCore/homepage
[travis-img]: https://travis-ci.org/tunnckoCore/homepage.svg?branch=master
[depstat-url]: https://david-dm.org/tunnckoCore/homepage
[depstat-img]: https://david-dm.org/tunnckoCore/homepage.svg
[ferver-img]: http://img.shields.io/badge/using-ferver-585858.svg
[ferver-url]: https://github.com/jonathanong/ferver
[author-gittip-img]: http://img.shields.io/gittip/tunnckoCore.svg
[author-gittip]: https://www.gittip.com/tunnckoCore
[author-github]: https://github.com/tunnckoCore
[author-twitter]: https://twitter.com/tunnckoCore
[author-website]: http://www.whistle-bg.tk
[author-npmjs]: https://npmjs.org/~tunnckocore
[author-more]: http://j.mp/1stW47C
[cobody-url]: https://github.com/tj/co-body
[mocha-url]: https://github.com/tj/mocha
[rawbody-url]: https://github.com/stream-utils/raw-body
[multer-url]: https://github.com/expressjs/multer
[express-url]: https://github.com/strongloop/express
[formidable-url]: https://github.com/felixge/node-formidable
[co-url]: https://github.com/tj/co
[extend-url]: https://github.com/justmoon/node-extend
[csp-report]: https://mathiasbynens.be/notes/csp-reports