Vocabulário essencial

Argumento posicional

Valor identificado pela posicao. Em studyops-ingest notas/, notas/ e o argumento que informa a entrada principal.

Opcao ou flag

Valor nomeado que altera o comportamento. Em studyops-ingest notas/ --format json, --format json pede uma representacao especifica para a saida.

stdin, stdout e stderr

• stdin: entrada que pode vir do terminal ou de outro processo.
• stdout: saida normal, destinada ao resultado do comando.
• stderr: diagnostico e erro, separado do resultado normal.

Separar resultado de diagnostico permite encadear a saida em outro comando sem misturar mensagens para a pessoa que esta executando o processo.

Codigo de retorno

Um valor curto que informa se o processo terminou como esperado. O texto do erro ajuda a diagnosticar; o codigo permite que um script tome uma decisao sem interpretar uma frase.

Fixture

Entrada pequena e versionada usada para repetir um experimento. Uma fixture de CLI deve ser curta o bastante para ser lida, mas real o bastante para revelar um comportamento do programa.