sindresorhus/execa

Features

• Subprocess Management - Routes the output of one subprocess into the input of another using linear chains or multiple destinations.
• Promise-Based Flow Control - Wraps Node.js child process modules to provide asynchronous control flow and detailed error objects.
• CLI Process Controls - Cancels running processes using an abort signal to allow the child process to clean up before exiting.
• Command Argument Parsers - Handles escaping of arguments containing spaces or special characters to prevent injection.
• Command Line IO Handlers - Provides a toolkit for piping, redirecting, and transforming standard input and output streams from external commands.
• Command Line Tooling - Provides the foundational capabilities for building developer tools that execute local binaries and capture interleaved output.
• Output Redirection - Routes standard output and error to pipes, files, the parent terminal, or multiple targets simultaneously.
• Process Lifecycle Managers - Returns a subprocess instance immediately upon spawning to provide access to process IDs and runtime properties.
• Real-Time Output Streaming - Iterates over output lines as they are produced or converts a subprocess into a duplex stream.
• Shell Command Execution - Runs shell commands and external binaries from Node.js with promise-based results and automatic argument escaping.
• Shell Command Runners - Provides an interface for executing system-level shell commands with built-in argument escaping for security.
• File-Based Redirection - Writes a command's standard output directly to a file by overwriting or appending content.
• Process Output Iteration - Processes the standard output and error of a running command line by line as data is produced.
• I/O Redirections - Redirects standard input and output to files, strings, or web streams via splitting or transformation functions.
• Interleaved Output Capture - Combines standard output and error streams into a single chronological sequence to preserve message ordering.
• Process IO Pipelines - Provides advanced streaming, filtering, and redirection of standard I/O between multiple subprocesses or files.
• Process Termination Signals - Integrates the Web API AbortController to cancel running subprocesses and trigger graceful cleanup routines.
• Process Execution Wrappers - Provides a promise-based wrapper for the Node.js child_process module to simplify the execution of external commands and binaries.
• String Escapers - Automatically quotes and escapes shell arguments to prevent command injection and ensure literal string interpretation.
• Standard Input Processing - Feeds data into a command's standard input using strings, files, or web streams.
• Command Injection Prevention - Prevents shell injection vulnerabilities by treating input as literal text and automatically escaping arguments.
• Inter-Process Communication - Implements mechanisms for exchanging structured JSON data and messages between a parent Node.js process and its subprocesses.
• Interleaved Stream Capture - Merges standard output and error into a single stream to preserve the chronological order of messages.
• Binary Stream Chunking - Iterates over subprocess output as arbitrary binary chunks to prevent data corruption from character encoding.
• Binary Standard Input - Passes binary data to a subprocess using buffers or files to handle input containing null bytes.
• Command Execution - Supports executing external commands synchronously by blocking the event loop until completion.
• Stream Output Transformation - Modifies output lines via a generator function to rewrite, filter, or expand data in real time.
• Command String Parsers - Splits a command string into an array of arguments for easier programmatic execution.
• Local Binary Execution - Searches for and runs executable binaries located in local dependency folders or specified directories.
• Subprocess Message Exchange - Implements the sending and receiving of messages between parent and subprocess using async iterables.
• Execution Environment Configurations - Sets the working directory, environment variables, and binary preferences for a specific command execution.
• Communication Channels - Establishes a dedicated message bus between parent and child processes for exchanging structured JSON data.
• Binary Stream Handling - Provides raw buffer access to subprocess output to prevent data corruption from character encoding.
• Output Line Splitting - Splits the standard output of a command into an array or async iterable for line-by-line processing.
• Process Signal Forwarding - Forces subprocesses to exit cleanly when they intercept signals or the parent process terminates abruptly.
• Shebang-Based Execution - Detects and prepends the correct runtime executable based on the script file header for cross-platform execution.
• IO Stream Transformers - Uses async generators to filter or modify input and output data streams in real time.
• Error Contextualization - Provides enriched error objects containing command, duration, exit code, and full output for improved debugging.
• Subprocess Error Classification - Captures detailed error objects from external commands to distinguish between timeouts, cancellations, and execution failures.
• Binary Output Capture - Captures subprocess output as raw byte arrays to preserve non-text data and avoid encoding issues.
• Execution Metadata - Retrieves detailed execution metadata, including the original command string and total duration.
• Shell and Scripting - Cross-platform child process execution.
• General Utilities - Improved child process execution.
• Shell and Execution - Cross-platform implementation of child process execution.
• Works with AVA - Listed in the “Works with AVA” section of the Awesome Ava awesome list.

Historial de estrellas