execa 4.1.0

Execa is a JavaScript package designed to improve the methods of Node.js's child_process, making it easier for developers to work with process execution. Some key features include a promise interface, improved Windows support, execution of locally installed binaries without the need for npx, and a plethora of convenience methods for handling process input and output.

To use execa, start by installing the package using npm with the command npm install execa. Below are some examples of how you can use execa:

// Using Promise Interface
import {execa} from 'execa';
const {stdout} = await execa('echo', ['unicorns']);
console.log(stdout);  //=> 'unicorns'

// Using Scripts Interface
import {$} from 'execa';
const branch = await $`git branch --show-current`;
await $`dep deploy --branch=${branch}`;

// Handling Errors
import {execa} from 'execa';
try {
	await execa('unknown', ['command']);
} catch (error) {
	console.log(error);
}

// Graceful termination
const subprocess = execa('node');
setTimeout(() => {
	subprocess.kill('SIGTERM', {
		forceKillAfterTimeout: 2000
	});
}, 1000);

These are simple use cases. To fully benefit from execa, review more advanced options and features in the usage documentation.

The comprehensive documentation for execa can be found on the GitHub page. The readme file includes all the details about installation, usage examples, options, and the API. It is designed as a complete guide, providing users with everything they need to know about the package, how it works, and how to use it effectively.