FM / lib

/usr/lib/node_modules/npm/lib

Name	Size	Mode	Actions
auth/	-	0755	rm
config/	-	0755	rm
doctor/	-	0755	rm
install/	-	0755	rm
search/	-	0755	rm
utils/	-	0755	rm
access.js	5672	0644	edit dl rm
adduser.js	1337	0644	edit dl rm
audit.js	10811	0644	edit dl rm
bin.js	515	0644	edit dl rm
bugs.js	864	0644	edit dl rm
build.js	4545	0644	edit dl rm
cache.js	4773	0644	edit dl rm
ci.js	1341	0644	edit dl rm
completion.js	7278	0644	edit dl rm
config.js	7612	0644	edit dl rm
dedupe.js	4999	0644	edit dl rm
deprecate.js	2157	0644	edit dl rm
dist-tag.js	4204	0644	edit dl rm
docs.js	1063	0644	edit dl rm
doctor.js	4075	0644	edit dl rm
edit.js	1407	0644	edit dl rm
explore.js	1709	0644	edit dl rm
fetch-package-metadata.js	4064	0644	edit dl rm
fund.js	5026	0644	edit dl rm
get.js	235	0644	edit dl rm
help-search.js	5777	0644	edit dl rm
help.js	6507	0644	edit dl rm
hook.js	4727	0644	edit dl rm
init.js	2805	0644	edit dl rm
install-ci-test.js	486	0644	edit dl rm
install-test.js	507	0644	edit dl rm
install.js	37345	0644	edit dl rm
link.js	5739	0644	edit dl rm
logout.js	1289	0644	edit dl rm
ls.js	16480	0644	edit dl rm
npm.js	14719	0644	edit dl rm
org.js	4276	0644	edit dl rm
outdated.js	12572	0644	edit dl rm
owner.js	6754	0644	edit dl rm
pack.js	12068	0644	edit dl rm
ping.js	1141	0644	edit dl rm
prefix.js	330	0644	edit dl rm
profile.js	11401	0644	edit dl rm
prune.js	2281	0644	edit dl rm
publish.js	5264	0644	edit dl rm
rebuild.js	2143	0644	edit dl rm
repo.js	1471	0644	edit dl rm
restart.js	64	0644	edit dl rm
root.js	320	0644	edit dl rm
run-script.js	5540	0644	edit dl rm
search.js	3442	0644	edit dl rm
set.js	276	0644	edit dl rm
shrinkwrap.js	10056	0644	edit dl rm
star.js	2157	0644	edit dl rm
stars.js	1054	0644	edit dl rm
start.js	62	0644	edit dl rm
stop.js	61	0644	edit dl rm
substack.js	509	0644	edit dl rm
team.js	4724	0644	edit dl rm
test.js	374	0644	edit dl rm
token.js	6818	0644	edit dl rm
unbuild.js	4374	0644	edit dl rm
uninstall.js	2261	0644	edit dl rm
unpublish.js	3594	0644	edit dl rm
update.js	2213	0644	edit dl rm
version.js	10029	0644	edit dl rm
view.js	15473	0644	edit dl rm
visnup.js	4104	0644	edit dl rm
whoami.js	1809	0644	edit dl rm
xmas.js	1663	0644	edit dl rm

Edit: /usr/lib/node_modules/npm/lib/help.js (6507B)

module.exports = help

help.completion = function (opts, cb) {
  if (opts.conf.argv.remain.length > 2) return cb(null, [])
  getSections(cb)
}

var path = require('path')
var spawn = require('./utils/spawn')
var npm = require('./npm.js')
var log = require('npmlog')
var openUrl = require('./utils/open-url')
var glob = require('glob')
var didYouMean = require('./utils/did-you-mean')
var cmdList = require('./config/cmd-list').cmdList
var shorthands = require('./config/cmd-list').shorthands
var commands = cmdList.concat(Object.keys(shorthands))
var output = require('./utils/output.js')

function help (args, cb) {
  var argv = npm.config.get('argv').cooked

var argnum = 0
  if (args.length === 2 && ~~args[0]) {
    argnum = ~~args.shift()
  }

// npm help foo bar baz: search topics
  if (args.length > 1 && args[0]) {
    return npm.commands['help-search'](args, argnum, cb)
  }

var section = npm.deref(args[0]) || args[0]

// npm help <noargs>:  show basic usage
  if (!section) {
    var valid = argv[0] === 'help' ? 0 : 1
    return npmUsage(valid, cb)
  }

// npm <command> -h: show command usage
  if (npm.config.get('usage') &&
      npm.commands[section] &&
      npm.commands[section].usage) {
    npm.config.set('loglevel', 'silent')
    log.level = 'silent'
    output(npm.commands[section].usage)
    return cb()
  }

// npm apihelp <section>: Prefer section 3 over section 1
  var apihelp = argv.length && argv[0].indexOf('api') !== -1
  var pref = apihelp ? [3, 1, 5, 7] : [1, 3, 5, 7]
  if (argnum) {
    pref = [ argnum ].concat(pref.filter(function (n) {
      return n !== argnum
    }))
  }

// npm help <section>: Try to find the path
  var manroot = path.resolve(__dirname, '..', 'man')

// legacy
  if (section === 'global') section = 'folders'
  else if (section.match(/.*json/)) section = section.replace('.json', '-json')

// find either /section.n or /npm-section.n
  // The glob is used in the glob.  The regexp is used much
  // further down.  Globs and regexps are different
  var compextglob = '.+(gz|bz2|lzma|[FYzZ]|xz)'
  var compextre = '\\.(gz|bz2|lzma|[FYzZ]|xz)$'
  var f = '+(npm-' + section + '|' + section + ').[0-9]?(' + compextglob + ')'
  return glob(manroot + '/*/' + f, function (er, mans) {
    if (er) return cb(er)

if (!mans.length) return npm.commands['help-search'](args, cb)

mans = mans.map(function (man) {
      var ext = path.extname(man)
      if (man.match(new RegExp(compextre))) man = path.basename(man, ext)

return man
    })

viewMan(pickMan(mans, pref), cb)
  })
}

function pickMan (mans, pref_) {
  var nre = /([0-9]+)$/
  var pref = {}
  pref_.forEach(function (sect, i) {
    pref[sect] = i
  })
  mans = mans.sort(function (a, b) {
    var an = a.match(nre)[1]
    var bn = b.match(nre)[1]
    return an === bn ? (a > b ? -1 : 1)
      : pref[an] < pref[bn] ? -1
        : 1
  })
  return mans[0]
}

function viewMan (man, cb) {
  var nre = /([0-9]+)$/
  var num = man.match(nre)[1]
  var section = path.basename(man, '.' + num)

// at this point, we know that the specified man page exists
  var manpath = path.join(__dirname, '..', 'man')
  var env = {}
  Object.keys(process.env).forEach(function (i) {
    env[i] = process.env[i]
  })
  env.MANPATH = manpath
  var viewer = npm.config.get('viewer')

var conf
  switch (viewer) {
    case 'woman':
      var a = ['-e', '(woman-find-file \'' + man + '\')']
      conf = { env: env, stdio: 'inherit' }
      var woman = spawn('emacsclient', a, conf)
      woman.on('close', cb)
      break

case 'browser':
      openUrl(htmlMan(man), 'help available at the following URL', cb)
      break

default:
      conf = { env: env, stdio: 'inherit' }
      var manProcess = spawn('man', [num, section], conf)
      manProcess.on('close', cb)
      break
  }
}

function htmlMan (man) {
  var sect = +man.match(/([0-9]+)$/)[1]
  var f = path.basename(man).replace(/[.]([0-9]+)$/, '')
  switch (sect) {
    case 1:
      sect = 'cli-commands'
      break
    case 5:
      sect = 'configuring-npm'
      break
    case 7:
      sect = 'using-npm'
      break
    default:
      throw new Error('invalid man section: ' + sect)
  }
  return path.resolve(__dirname, '..', 'docs', 'public', sect, f, 'index.html')
}

function npmUsage (valid, cb) {
  npm.config.set('loglevel', 'silent')
  log.level = 'silent'
  output([
    '\nUsage: npm <command>',
    '',
    'where <command> is one of:',
    npm.config.get('long') ? usages()
      : '    ' + wrap(commands),
    '',
    'npm <command> -h  quick help on <command>',
    'npm -l            display full usage info',
    'npm help <term>   search for help on <term>',
    'npm help npm      involved overview',
    '',
    'Specify configs in the ini-formatted file:',
    '    ' + npm.config.get('userconfig'),
    'or on the command line via: npm <command> --key value',
    'Config info can be viewed via: npm help config',
    '',
    'npm@' + npm.version + ' ' + path.dirname(__dirname)
  ].join('\n'))

if (npm.argv.length > 1) {
    output(didYouMean(npm.argv[1], commands))
  }

cb(valid)
}

function usages () {
  // return a string of <command>: <usage>
  var maxLen = 0
  return Object.keys(npm.commands).filter(function (c) {
    return c === npm.deref(c)
  }).reduce(function (set, c) {
    set.push([c, npm.commands[c].usage || ''])
    maxLen = Math.max(maxLen, c.length)
    return set
  }, []).map(function (item) {
    var c = item[0]
    var usage = item[1]
    return '\n    ' +
      c + (new Array(maxLen - c.length + 2).join(' ')) +
      (usage.split('\n').join('\n' + (new Array(maxLen + 6).join(' '))))
  }).join('\n')
}

function wrap (arr) {
  var out = ['']
  var l = 0
  var line

line = process.stdout.columns
  if (!line) {
    line = 60
  } else {
    line = Math.min(60, Math.max(line - 16, 24))
  }

arr.sort(function (a, b) { return a < b ? -1 : 1 })
    .forEach(function (c) {
      if (out[l].length + c.length + 2 < line) {
        out[l] += ', ' + c
      } else {
        out[l++] += ','
        out[l] = c
      }
    })
  return out.join('\n    ').substr(2)
}

function getSections (cb) {
  var g = path.resolve(__dirname, '../man/man[0-9]/*.[0-9]')
  glob(g, function (er, files) {
    if (er) return cb(er)

cb(null, Object.keys(files.reduce(function (acc, file) {
      file = path.basename(file).replace(/\.[0-9]+$/, '')
      file = file.replace(/^npm-/, '')
      acc[file] = true
      return acc
    }, { help: true })))
  })
}

cmd: