Enhance CLI with ZX

askForAuthProfile.mjs

export const askForAuthProfile = async () => {
    // Since 'minimist' is integrated a 'argv' is available out-of-box
    if( argv.authindex ) {
      // If a 'authindex' is provided as argument
      // select the given authentication profile
      await $`pac auth select --index ${argv.authindex}`     
      return
    }
    // list all available authentication profile  
    await $`pac auth list`
    // interactively ask for a profile
    const choice = await question('choose profile index (enter for confirm active one): ')
    // select the given authentication profile    
    await $`pac auth select --index ${choice}`
}

askForSolutionFolder.mjs

export const askForSolutionFolder = async () => {
    let solution
    // Since 'minimist' is integrated a 'argv' is available out-of-box
    if( argv.solution ) {
      // If a 'solution' is provided as argument use it
      solution = argv.solution
    }
    else {
      // otherwise ask for it
      solution = await question('solution folder: ')
    }

    // Since 'fs-extra' and 'chalk' are integrated 'fs' and 'chalk' are available out-of-box
    try {
        // Folder validation
        const stats = await fs.stat( solution )
        if( stats.isDirectory() )
            return solution

        console.log( chalk.red(`solution folder '${solution}' is not a directory!`))            
    }
    catch( e ) {
        console.log( chalk.red(`solution folder '${solution}' doesn't exist!`))
    }
}

Enhance CLI with ZX.md

GIST for embed in Enhance CLI with ZX article on Medium

ImportSolution.mjs

try {

    await askForAuthProfile()

    const solution = await askForSolutionFolder()

    // import Solution as 'Managed' into selected profile
    await $`pac solution pack --zipfile /tmp/${solution}_managed.zip -f ${solution} -p Managed -aw`  
    await $`pac solution import -p /tmp/${solution}_managed.zip -f -pc -a`        

} catch (p) {
    if (p.exitCode)
        console.log(`error occurred code: ${p.exitCode} error: ${p.stderr}`)
    else
        console.error(p)
}

zx-builtin-functions.md

function	description
cd()	Changes the current working directory.
fetch()	A wrapper around the node-fetch package.
question()	A wrapper around the readline package.
sleep()	A wrapper around the setTimeout function.
nothrow()	Changes behavior of $ to not throw an exception on non-zero exit codes.
quiet()	Changes behavior of $ to disable verbose output.

zx-builtin-packages.md

packages	description
chalk	Colorize output
yaml	Parse/Serialize yaml format
fs-extra	File System utility
globby	User-friendly glob matching
minimist	Argument options parser
witch	require/resolve for binaries