PHP 8.2.30
Preview: explore.js Size: 2.33 KB
//proc/thread-self/root/opt/alt/alt-nodejs16/root/lib/node_modules/npm/lib/commands/explore.js

// npm explore <pkg>[@<version>]
// open a subshell to the package folder.

const rpj = require('read-package-json-fast')
const runScript = require('@npmcli/run-script')
const { join, resolve, relative } = require('path')
const log = require('../utils/log-shim.js')
const completion = require('../utils/completion/installed-shallow.js')
const BaseCommand = require('../base-command.js')

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 */
  async completion (opts) {
    return completion(this.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 pkg = await rpj(resolve(path, 'package.json')).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) {
      this.npm.output(`\nExploring ${path}\nType 'exit' or ^D when finished\n`)
    }
    log.disableProgress()
    try {
      return await runScript({
        ...this.npm.flatOptions,
        pkg,
        banner: false,
        path,
        stdioString: true,
        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
        }
      })
    } finally {
      log.enableProgress()
    }
  }
}
module.exports = Explore

Directory Contents

Dirs: 0 × Files: 68

Name Size Perms Modified Actions
5.45 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.20 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
11.95 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
729 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
508 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
815 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
7.08 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
3.63 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
8.91 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
8.11 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.37 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.06 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
8.10 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
5.47 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
447 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
9.22 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.00 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.44 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
3.55 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.33 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
602 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
6.37 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
524 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
5.62 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
4.53 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
3.93 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
6.81 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
377 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
374 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
5.11 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
5.02 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
234 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.34 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
16.94 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
4.20 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
8.84 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
5.88 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.36 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
874 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
3.47 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
343 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
11.25 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
779 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
6.33 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.81 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.16 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.24 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
351 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
298 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
6.90 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.72 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.63 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
572 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
2.64 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.87 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.03 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
341 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
336 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
4.44 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
336 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
6.79 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.52 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
4.51 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
182 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download
1.70 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
3.60 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
14.38 KB lrw-r--r-- 2026-03-17 06:55:03
Edit Download
514 B lrw-r--r-- 2026-03-17 06:55:03
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).