@npmcli/promise-spawn

WebJar for @npmcli/promise-spawn

License	ISC
Categories	CLI User Interface
GroupId	org.webjars.npm
ArtifactId	npmcli__promise-spawn
Last Version	1.3.2
Release Date	Oct 30, 2020
Type	jar
Description	@npmcli/promise-spawn WebJar for @npmcli/promise-spawn
Project URL	https://www.webjars.org
Source Code Management	https://github.com/npm/promise-spawn

Download npmcli__promise-spawn

Filename	Size
npmcli__promise-spawn-1.3.2.pom
npmcli__promise-spawn-1.3.2.jar	5 KB
npmcli__promise-spawn-1.3.2-sources.jar	22 bytes
npmcli__promise-spawn-1.3.2-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/npmcli__promise-spawn/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>npmcli__promise-spawn</artifactId>
    <version>1.3.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/npmcli__promise-spawn/
implementation 'org.webjars.npm:npmcli__promise-spawn:1.3.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/npmcli__promise-spawn/
implementation ("org.webjars.npm:npmcli__promise-spawn:1.3.2")

Apache Buildr

'org.webjars.npm:npmcli__promise-spawn:jar:1.3.2'

Apache Ivy

<dependency org="org.webjars.npm" name="npmcli__promise-spawn" rev="1.3.2">
  <artifact name="npmcli__promise-spawn" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='npmcli__promise-spawn', version='1.3.2')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "npmcli__promise-spawn" % "1.3.2"

Leiningen

[org.webjars.npm/npmcli__promise-spawn "1.3.2"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.webjars.npm : infer-owner	jar	[1.0.4,2)

Project Modules

There are no modules declared in this project.

@npmcli/promise-spawn

Spawn processes the way the npm cli likes to do. Give it some options, it'll give you a Promise that resolves or rejects based on the results of the execution.

Note: When the current user is root, this will use infer-owner to find the owner of the current working directory, and run with that effective uid/gid. Otherwise, it runs as the current user always. (This helps prevent doing git checkouts and such, and leaving root-owned files lying around in user-owned locations.)

USAGE

const promiseSpawn = require('@npmcli/promise-spawn')

promiseSpawn('ls', [ '-laF', 'some/dir/*.js' ], {
  cwd: '/tmp/some/path', // defaults to process.cwd()
  stdioString: false, // stdout/stderr as strings rather than buffers
  stdio: 'pipe', // any node spawn stdio arg is valid here
  // any other arguments to node child_process.spawn can go here as well,
  // but uid/gid will be ignored and set by infer-owner if relevant.
}, {
  extra: 'things',
  to: 'decorate',
  the: 'result',
}).then(result => {
  // {code === 0, signal === null, stdout, stderr, and all the extras}
  console.log('ok!', result)
}).catch(er => {
  // er has all the same properties as the result, set appropriately
  console.error('failed!', er)
})

API

promiseSpawn(cmd, args, opts, extra) -> Promise

Run the command, return a Promise that resolves/rejects based on the process result.

Result or error will be decorated with the properties in the extra object. You can use this to attach some helpful info about why the command is being run, if it makes sense for your use case.

If stdio is set to anything other than 'inherit', then the result/error will be decorated with stdout and stderr values. If stdioString is set to true, these will be strings. Otherwise they will be Buffer objects.

Returned promise is decorated with the stdin stream if the process is set to pipe from stdin. Writing to this stream writes to the stdin of the spawned process.

Options

• stdioString Boolean, default false. Return stdout/stderr output as strings rather than buffers.
• cwd String, default process.cwd(). Current working directory for running the script. Also the argument to infer-owner to determine effective uid/gid when run as root on Unix systems.
• Any other options for child_process.spawn can be passed as well, but note that uid and gid will be overridden by the owner of the cwd when run as root on Unix systems, or null otherwise.

npm

node package manager

Versions

Version
1.3.2 Oct 30, 2020