axx

• execution of shell commands
• async/await functionality for easy concurrency control
• streaming, proper piping

npm install axx

require("axx")

lean functions

• axx — run shell command
• raxx — read from file
• waxx — write to file
• caxx — log to stdout (the console)

memory-hog functions

• maxx — same as axx, but returns the full stdout result
• mraxx — same as raxx, but returns the whole file to result

examples

const {axx, raxx, waxx} = require("axx")

const n = `$(npm bin)` // "node_modules/.bin"

async function build() {

	// minify a script
	await
	raxx(`myscript.js`,
		axx(`${n}/uglifyjs --compress --mangle`,
			waxx(`myscript.min.js`)
		)
	)

	// run a few concurrent operations, wait for them all to complete
	await Promise.all([
		axx(`${n}/tsc`),
		axx(`cat src/a src/b`, waxx(`dist/c`)),
		axx(`${n}/node-sass --source-map true src/s.scss dist/s.css`)
	])

	console.log("✔ done build")
}

some more contrived examples

// log the package.json to the console just so i can see it
await raxx(`package.json`, caxx())

// alternative (memory-hog) way to log to the console
const text = await mraxx(`LICENSE.txt`)
console.log(text)