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 pkgJson = require('@npmcli/package-json')
const runScript = require('@npmcli/run-script')
const { join, relative } = require('node:path')
const { log, output } = require('proc-log')
const completion = require('../utils/installed-shallow.js')
const BaseCommand = require('../base-cmd.js')

// npm explore <pkg>[@<version>]
// open a subshell to the package folder.
class Explore extends BaseCommand {
  static description = 'Browse an installed package'
  static name = 'explore'
  static usage = ['<pkg> [ -- <command>]']
  static params = ['shell']
  static ignoreImplicitWorkspace = false

// TODO
  /* istanbul ignore next */
  static async completion (opts, npm) {
    return completion(npm, opts)
  }

async exec (args) {
    if (args.length < 1 || !args[0]) {
      throw this.usageError()
    }

const pkgname = args.shift()

// detect and prevent any .. shenanigans
    const path = join(this.npm.dir, join('/', pkgname))
    if (relative(path, this.npm.dir) === '') {
      throw this.usageError()
    }

// run as if running a script named '_explore', which we set to either
    // the set of arguments, or the shell config, and let @npmcli/run-script
    // handle all the escaping and PATH setup stuff.

const { content: pkg } = await pkgJson.normalize(path).catch(er => {
      log.error('explore', `It doesn't look like ${pkgname} is installed.`)
      throw er
    })

const { shell } = this.npm.flatOptions
    pkg.scripts = {
      ...(pkg.scripts || {}),
      _explore: args.join(' ').trim() || shell,
    }

if (!args.length) {
      output.standard(`\nExploring ${path}\nType 'exit' or ^D when finished\n`)
    }

return runScript({
      ...this.npm.flatOptions,
      pkg,
      path,
      event: '_explore',
      stdio: 'inherit',
    }).catch(er => {
      process.exitCode = typeof er.code === 'number' && er.code !== 0 ? er.code
        : 1
        // if it's not an exit error, or non-interactive, throw it
      const isProcExit = er.message === 'command failed' &&
          (typeof er.code === 'number' || /^SIG/.test(er.signal || ''))
      if (args.length || !isProcExit) {
        throw er
      }
    })
  }
}

module.exports = Explore