Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
access.js	6.04 KB	-rw-r--r--	2024-07-09 00:04
adduser.js	1.29 KB	-rw-r--r--	2024-05-09 19:00
audit.js	3.15 KB	-rw-r--r--	2024-07-09 00:04
bugs.js	847 B	-rw-r--r--	2023-10-14 15:00
cache.js	7.12 KB	-rw-r--r--	2025-03-27 09:29
ci.js	4.22 KB	-rw-r--r--	2024-07-09 00:04
completion.js	8.9 KB	-rw-r--r--	2024-07-09 00:04
config.js	11.18 KB	-rw-r--r--	2025-03-27 09:29
dedupe.js	1.41 KB	-rw-r--r--	2024-05-09 19:00
deprecate.js	2.13 KB	-rw-r--r--	2025-03-27 09:29
diff.js	8.14 KB	-rw-r--r--	2025-03-27 09:29
dist-tag.js	5.52 KB	-rw-r--r--	2025-03-27 09:29
docs.js	449 B	-rw-r--r--	2024-05-09 19:00
doctor.js	10.1 KB	-rw-r--r--	2025-03-27 09:29
edit.js	1.76 KB	-rw-r--r--	2024-07-09 00:04
exec.js	3.42 KB	-rw-r--r--	2024-07-09 00:04
explain.js	3.58 KB	-rw-r--r--	2025-03-27 09:29
explore.js	2.16 KB	-rw-r--r--	2024-07-09 00:04
find-dupes.js	634 B	-rw-r--r--	2024-05-09 19:00
fund.js	6.46 KB	-rw-r--r--	2024-07-09 00:04
get.js	577 B	-rw-r--r--	2024-05-09 19:00
help-search.js	5.52 KB	-rw-r--r--	2024-05-09 19:00
help.js	3.66 KB	-rw-r--r--	2024-07-09 00:04
hook.js	3.37 KB	-rw-r--r--	2025-03-27 09:29
init.js	6.85 KB	-rw-r--r--	2025-03-27 09:29
install-ci-test.js	373 B	-rw-r--r--	2024-05-09 19:00
install-test.js	370 B	-rw-r--r--	2024-05-09 19:00
install.js	5.15 KB	-rw-r--r--	2025-03-27 09:29
link.js	5.3 KB	-rw-r--r--	2025-03-27 09:29
ll.js	234 B	-rw-r--r--	2022-10-11 19:59
login.js	1.29 KB	-rw-r--r--	2024-05-09 19:00
logout.js	1.42 KB	-rw-r--r--	2024-05-09 19:00
ls.js	16.81 KB	-rw-r--r--	2025-03-27 09:29
org.js	4.02 KB	-rw-r--r--	2025-03-27 09:29
outdated.js	7.7 KB	-rw-r--r--	2024-07-13 15:00
owner.js	5.85 KB	-rw-r--r--	2024-07-09 00:04
pack.js	2.6 KB	-rw-r--r--	2025-03-27 09:29
ping.js	873 B	-rw-r--r--	2024-07-09 00:04
pkg.js	3.56 KB	-rw-r--r--	2025-03-27 09:29
prefix.js	335 B	-rw-r--r--	2025-03-27 09:29
profile.js	10.57 KB	-rw-r--r--	2024-07-09 00:04
prune.js	799 B	-rw-r--r--	2024-05-09 19:00
publish.js	7.19 KB	-rw-r--r--	2025-03-27 09:29
query.js	3.51 KB	-rw-r--r--	2024-07-09 00:04
rebuild.js	2.19 KB	-rw-r--r--	2024-07-09 00:04
repo.js	1.25 KB	-rw-r--r--	2025-03-27 09:29
restart.js	310 B	-rw-r--r--	2023-01-17 19:00
root.js	295 B	-rw-r--r--	2024-05-09 19:00
run-script.js	6.04 KB	-rw-r--r--	2025-03-27 09:29
sbom.js	4.51 KB	-rw-r--r--	2025-03-27 09:29
search.js	1.83 KB	-rw-r--r--	2024-05-09 19:00
set.js	671 B	-rw-r--r--	2024-05-09 19:00
shrinkwrap.js	2.65 KB	-rw-r--r--	2024-07-09 00:04
star.js	1.87 KB	-rw-r--r--	2025-03-27 09:29
stars.js	1.03 KB	-rw-r--r--	2025-03-27 09:29
start.js	300 B	-rw-r--r--	2023-01-17 19:00
stop.js	295 B	-rw-r--r--	2023-01-17 19:00
team.js	4.36 KB	-rw-r--r--	2024-07-09 00:04
test.js	295 B	-rw-r--r--	2023-01-17 19:00
token.js	6.02 KB	-rw-r--r--	2025-03-27 09:29
uninstall.js	1.52 KB	-rw-r--r--	2024-07-09 00:04
unpublish.js	5.27 KB	-rw-r--r--	2025-03-27 09:29
unstar.js	183 B	-rw-r--r--	2024-05-09 19:00
update.js	1.72 KB	-rw-r--r--	2024-07-09 00:04
version.js	3.54 KB	-rw-r--r--	2025-03-27 09:29
view.js	12.8 KB	-rw-r--r--	2025-03-27 09:29
whoami.js	527 B	-rw-r--r--	2024-07-09 00:04

Rename

const { explainNode } = require('../utils/explain-dep.js')
const npa = require('npm-package-arg')
const semver = require('semver')
const { relative, resolve } = require('node:path')
const validName = require('validate-npm-package-name')
const { output } = require('proc-log')
const ArboristWorkspaceCmd = require('../arborist-cmd.js')

class Explain extends ArboristWorkspaceCmd {
  static description = 'Explain installed packages'
  static name = 'explain'
  static usage = ['<package-spec>']
  static params = [
    'json',
    'workspace',
  ]

static ignoreImplicitWorkspace = false

// TODO
  /* istanbul ignore next */
  static async completion (opts, npm) {
    const completion = require('../utils/installed-deep.js')
    return completion(npm, opts)
  }

async exec (args) {
    if (!args.length) {
      throw this.usageError()
    }

const Arborist = require('@npmcli/arborist')
    const arb = new Arborist({ path: this.npm.prefix, ...this.npm.flatOptions })
    const tree = await arb.loadActual()

if (this.npm.flatOptions.workspacesEnabled
      && this.workspaceNames
      && this.workspaceNames.length
    ) {
      this.filterSet = arb.workspaceDependencySet(tree, this.workspaceNames)
    } else if (!this.npm.flatOptions.workspacesEnabled) {
      this.filterSet =
        arb.excludeWorkspacesDependencySet(tree)
    }

const nodes = new Set()
    for (const arg of args) {
      for (const node of this.getNodes(tree, arg)) {
        const filteredOut = this.filterSet
          && this.filterSet.size > 0
          && !this.filterSet.has(node)
        if (!filteredOut) {
          nodes.add(node)
        }
      }
    }
    if (nodes.size === 0) {
      throw new Error(`No dependencies found matching ${args.join(', ')}`)
    }

const expls = []
    for (const node of nodes) {
      const { extraneous, dev, optional, devOptional, peer, inBundle, overridden } = node
      const expl = node.explain()
      if (extraneous) {
        expl.extraneous = true
      } else {
        expl.dev = dev
        expl.optional = optional
        expl.devOptional = devOptional
        expl.peer = peer
        expl.bundled = inBundle
        expl.overridden = overridden
      }
      expls.push(expl)
    }

if (this.npm.flatOptions.json) {
      output.buffer(expls)
    } else {
      output.standard(expls.map(expl => {
        return explainNode(expl, Infinity, this.npm.chalk)
      }).join('\n\n'))
    }
  }

getNodes (tree, arg) {
    // if it's just a name, return packages by that name
    const { validForOldPackages: valid } = validName(arg)
    if (valid) {
      return tree.inventory.query('packageName', arg)
    }

// if it's a location, get that node
    const maybeLoc = arg.replace(/\\/g, '/').replace(/\/+$/, '')
    const nodeByLoc = tree.inventory.get(maybeLoc)
    if (nodeByLoc) {
      return [nodeByLoc]
    }

// maybe a path to a node_modules folder
    const maybePath = relative(this.npm.prefix, resolve(maybeLoc))
      .replace(/\\/g, '/').replace(/\/+$/, '')
    const nodeByPath = tree.inventory.get(maybePath)
    if (nodeByPath) {
      return [nodeByPath]
    }

// otherwise, try to select all matching nodes
    try {
      return this.getNodesByVersion(tree, arg)
    } catch (er) {
      return []
    }
  }

getNodesByVersion (tree, arg) {
    const spec = npa(arg, this.npm.prefix)
    if (spec.type !== 'version' && spec.type !== 'range') {
      return []
    }

return tree.inventory.filter(node => {
      return node.package.name === spec.name &&
        semver.satisfies(node.package.version, spec.rawSpec)
    })
  }
}

module.exports = Explain