Olá! Fico feliz em saber que você está interessada em usar o Yargs no seu projeto. Vou explicar como você pode utilizá-lo de forma efetiva.
O Yargs é uma biblioteca que permite analisar e processar argumentos da linha de comando de uma forma mais fácil e intuitiva. Ele oferece recursos para definir argumentos, opções e comandos, além de gerar automaticamente mensagens de ajuda e uso.
Para começar a usar o Yargs, você precisa seguir alguns passos simples:
Instalação: Certifique-se de que o Yargs esteja instalado no seu projeto. Você pode fazer isso executando o comando npm install yargs ou yarn add yargs no seu terminal.
Importação: Importe o módulo yargs no seu código para utilizá-lo. Você pode fazer isso da seguinte maneira:
import yargs from 'yargs';
import { hideBin } from 'yargs/helpers';
Configuração dos argumentos: Agora, você precisa configurar os argumentos que deseja analisar. Isso pode ser feito usando o método yargs.command() para definir comandos, e o método yargs.option() para definir opções. Por exemplo:
yargs.command('hello', 'Exibe uma mensagem de saudação', (yargs) => {
yargs.option('name', {
alias: 'n',
description: 'Nome para a saudação',
type: 'string',
demandOption: true, // Define se é uma opção obrigatória
});
}, (argv) => {
console.log(`Olá, ${argv.name}!`);
});
Neste exemplo, configuramos um comando "hello" que possui uma opção "--name" (ou "-n") para especificar o nome para a saudação. O método command() recebe três parâmetros: o nome do comando, uma descrição e callbacks para configuração e execução do comando.
Parse dos argumentos: Após definir os argumentos, você precisa realizar o parse dos argumentos fornecidos pela linha de comando. Isso é feito chamando o método yargs.parse():
const argv = yargs(hideBin(process.argv)).argv;
O hideBin() é um auxiliar do Yargs que remove os primeiros elementos do array process.argv, que normalmente inclui o caminho para o executável e o nome do script. O yargs() cria uma nova instância do Yargs e o argv contém um objeto com os valores dos argumentos analisados.
Com esses passos, você deve conseguir usar o Yargs no seu projeto. Certifique-se de definir os comandos e opções necessários para a sua aplicação e adaptar o código de acordo com as suas necessidades.
Espero que isso tenha esclarecido como usar o Yargs no seu projeto. Se tiver mais dúvidas, é só perguntar!