la riga di comando-args vale la pena dare un'occhiata!
È possibile impostare le opzioni utilizzando gli standard di notazione principali ( ulteriori informazioni ). Questi comandi sono tutti equivalenti, impostando gli stessi valori:
$ example --verbose --timeout=1000 --src one.js --src two.js
$ example --verbose --timeout 1000 --src one.js two.js
$ example -vt 1000 --src one.js two.js
$ example -vt 1000 one.js two.js
Per accedere ai valori, creare innanzitutto un elenco di definizioni delle opzioni che descrivono le opzioni accettate dall'applicazione. La type
proprietà è una funzione setter (il valore fornito viene passato attraverso questo), dandoti il pieno controllo sul valore ricevuto.
const optionDefinitions = [
{ name: 'verbose', alias: 'v', type: Boolean },
{ name: 'src', type: String, multiple: true, defaultOption: true },
{ name: 'timeout', alias: 't', type: Number }
]
Successivamente, analizza le opzioni usando commandLineArgs () :
const commandLineArgs = require('command-line-args')
const options = commandLineArgs(optionDefinitions)
options
ora si presenta così:
{
src: [
'one.js',
'two.js'
],
verbose: true,
timeout: 1000
}
Utilizzo avanzato
Oltre all'utilizzo tipico sopra, è possibile configurare la riga di comando-args per accettare moduli di sintassi più avanzati.
Sintassi basata su comandi (stile git) nel modulo:
$ executable <command> [options]
Per esempio.
$ git commit --squash -m "This is my commit message"
Sintassi dei comandi e dei sotto-comandi (stile docker) nel formato:
$ executable <command> [options] <sub-command> [options]
Per esempio.
$ docker run --detached --image centos bash -c yum install -y httpd
Generazione della guida all'uso
Una guida all'uso (in genere stampata quando --help
è impostata) può essere generata utilizzando l'utilizzo della riga di comando . Vedi gli esempi seguenti e leggi la documentazione per istruzioni su come crearli.
Un tipico esempio di guida all'uso.
La guida all'uso di polimero-cli è un buon esempio di vita reale.
Ulteriori letture
C'è molto altro da imparare, consultare la wiki per esempi e documentazione.