A biblioteca padrãoSlide 61 de 85
61FlagA biblioteca padrão
Flags de linha de comando
hive.term.codec() lê flags de linha de comando para um tipo seu por meio de T.decode, e encode escreve um de volta. Um campo é --name value ou --name=value, nomeado pelo próprio campo ou por -- Flag as <nome>; sem os traços — e um segundo nome, mais curto, é lido depois de um traço só: -- Flag as dry-run n; é --dry-run e -n igualmente, -n valor e -n=valor. Uma falha é um hive.term.FlagError, cujo path é a flag como foi escrita.
T.decodelê umaStr, dividida do jeito que um shell divide uma linha, então um valor entre aspas continua sendo uma palavra só.hive.term.flags()é a linha com os próprios argumentos do programa, com aspas de novo em cada palavra que tenha espaço, aspas ou barra invertida:args()entrega as palavras com as aspas do shell já removidas, então juntá-las dividiria de novo um valor entre aspas.- Uma flag
Boolsozinha étrue, e ela só toma a palavra seguinte quando essa palavra étrueoufalse— que é como oencodeescreve uma,--dry-run true. - Um vetor é a sua flag repetida, e um vetor ausente é vazio. Qualquer outra flag dada duas vezes é um erro.
- Um campo sem
Defaultprecisa estar lá, umBoolincluído. Uma flagAtomaceita só átomos que o programa menciona. - As palavras antes da primeira flag, e tudo depois de um
--sozinho, são do próprio programa, ehive.term.positional(line)responde com elas. Entre elas só há flags e seus valores: uma flag que o tipo não declara é um erro que lista as que ele declara, e também uma palavra que não é valor de nenhuma flag — ela vai antes das flags ou depois do--.
Flags para um tipo
type Options {
name: Str
dryRun: Bool -- Flag as dry-run; Default as false;
count: Int -- Default as 10;
}
proc main(): void {
// A linha que hive.term.flags() entrega para esses argumentos, com aspas de novo no valor que tem espaço.
line := "--name 'Ada Lovelace' --dry-run --count=3"
if Options.decode(line, hive.term.codec()) is Result.Ok(o) {
echo "{o.name} {o.dryRun} {o.count}"
}
// Uma flag sem Default precisa estar lá.
if Options.decode("--dry-run", hive.term.codec()) is Result.Error(why) {
echo "{why.path}: esperava {why.expected}, encontrou {why.found}"
}
echo encode(Options("Ada Lovelace", true, 3), hive.term.codec())
}Dá para editar este programa e rodá-lo aqui.Tab indenta, Esc sai do programa e Ctrl+Enter o roda.
Nomes curtos, e as palavras do próprio programa
type Options {
model: Str -- Flag as model m; Default as "small";
verbose: Bool -- Flag as verbose v; Default as false;
}
proc main(): void {
// O que vem depois de um -- sozinho é do próprio programa, assim como palavras antes das flags.
line := "-m large -v -- what is this"
if Options.decode(line, hive.term.codec()) is Result.Ok(o) {
echo "{o.model} {o.verbose}"
}
echo hive.term.positional(line)
if Options.decode("--modle large", hive.term.codec()) is Result.Error(why) {
echo "{why.path}: esperava {why.expected}, encontrou {why.found}"
}
}Dá para editar este programa e rodá-lo aqui.Tab indenta, Esc sai do programa e Ctrl+Enter o roda.