Gecko [ c.stage.kornherr.net ]

Name	Size	Permission	Date
completion	[ DIR ]	drwxr-xr-x	2024-07-10 10:56
config	[ DIR ]	drwxr-xr-x	2024-07-10 10:56
ansi-trim.js	173 B	-rw-r--r--	2023-11-23 07:39
audit-error.js	978 B	-rw-r--r--	2023-11-23 07:39
auth.js	2.32 KB	-rw-r--r--	2023-11-23 07:39
cmd-list.js	2.42 KB	-rw-r--r--	2023-11-23 07:39
completion.sh	1.84 KB	-rw-r--r--	2023-11-23 07:39
did-you-mean.js	1.46 KB	-rw-r--r--	2023-11-23 07:39
display.js	3.38 KB	-rw-r--r--	2023-11-23 07:39
error-message.js	12.72 KB	-rw-r--r--	2023-11-23 07:39
exit-handler.js	7.15 KB	-rw-r--r--	2023-11-23 07:39
explain-dep.js	3.73 KB	-rw-r--r--	2023-11-23 07:39
explain-eresolve.js	2.54 KB	-rw-r--r--	2023-11-23 07:39
format-bytes.js	629 B	-rw-r--r--	2023-11-23 07:39
format-search-stream.js	3.93 KB	-rw-r--r--	2023-11-23 07:39
get-identity.js	802 B	-rw-r--r--	2023-11-23 07:39
is-windows.js	233 B	-rw-r--r--	2023-11-23 07:39
log-file.js	6.95 KB	-rw-r--r--	2023-11-23 07:39
log-shim.js	1.68 KB	-rw-r--r--	2023-11-23 07:39
npm-usage.js	2.09 KB	-rw-r--r--	2023-11-23 07:39
open-url-prompt.js	1.44 KB	-rw-r--r--	2023-11-23 07:39
open-url.js	1.09 KB	-rw-r--r--	2023-11-23 07:39
otplease.js	1.23 KB	-rw-r--r--	2023-11-23 07:39
ping.js	252 B	-rw-r--r--	2023-11-23 07:39
pulse-till-done.js	412 B	-rw-r--r--	2023-11-23 07:39
queryable.js	9.58 KB	-rw-r--r--	2023-11-23 07:39
read-user-info.js	1.99 KB	-rw-r--r--	2023-11-23 07:39
reify-finish.js	876 B	-rw-r--r--	2023-11-23 07:39
reify-output.js	4.96 KB	-rw-r--r--	2023-11-23 07:39
replace-info.js	807 B	-rw-r--r--	2023-11-23 07:39
tar.js	3.9 KB	-rw-r--r--	2023-11-23 07:39
timers.js	2.73 KB	-rw-r--r--	2023-11-23 07:39
update-notifier.js	1.76 KB	-rw-r--r--	2023-11-23 07:39
validate-lockfile.js	1023 B	-rw-r--r--	2023-11-23 07:39
web-auth.js	558 B	-rw-r--r--	2023-11-23 07:39

Rename

const { dirname } = require('path')
const { commands } = require('./cmd-list')

const COL_MAX = 60
const COL_MIN = 24
const COL_GUTTER = 16
const INDENT = 4

const indent = (repeat = INDENT) => ' '.repeat(repeat)
const indentNewline = (repeat) => `\n${indent(repeat)}`

module.exports = async (npm) => {
  const browser = npm.config.get('viewer') === 'browser' ? ' (in a browser)' : ''
  const allCommands = npm.config.get('long') ? await cmdUsages(npm) : cmdNames()

return `npm <command>

Usage:

npm install        install all the dependencies in your project
npm install <foo>  add the <foo> dependency to your project
npm test           run this project's tests
npm run <foo>      run the script named <foo>
npm <command> -h   quick help on <command>
npm -l             display usage info for all commands
npm help <term>    search for help on <term>${browser}
npm help npm       more involved overview${browser}

All commands:
${allCommands}

Specify configs in the ini-formatted file:
${indent() + npm.config.get('userconfig')}
or on the command line via: npm <command> --key=value

More configuration info: npm help config
Configuration fields: npm help 7 config

npm@${npm.version} ${dirname(dirname(__dirname))}`
}

const cmdNames = () => {
  const out = ['']

const line = !process.stdout.columns ? COL_MAX
    : Math.min(COL_MAX, Math.max(process.stdout.columns - COL_GUTTER, COL_MIN))

let l = 0
  for (const c of commands) {
    if (out[l].length + c.length + 2 < line) {
      out[l] += ', ' + c
    } else {
      out[l++] += ','
      out[l] = c
    }
  }

return indentNewline() + out.join(indentNewline()).slice(2)
}

const cmdUsages = async (npm) => {
  // return a string of <command>: <usage>
  let maxLen = 0
  const set = []
  for (const c of commands) {
    const { usage } = await npm.cmd(c)
    set.push([c, usage.split('\n')])
    maxLen = Math.max(maxLen, c.length)
  }

return set.map(([name, usageLines]) => {
    const gutter = indent(maxLen - name.length + 1)
    const usage = usageLines.join(indentNewline(INDENT + maxLen + 1))
    return indentNewline() + name + gutter + usage
  }).join('\n')
}