A CLI em scripts
Códigos de saída, cor, idioma, variáveis de ambiente, eval — e o que um script pode confiar.
A CLI é usada por gente e por programa. Para o programa, o que importa é o que não muda: o código de saída, a saída sem cor, e as variáveis de ambiente que mudam o comportamento.
Códigos de saída#
| Código | Significa |
|---|---|
0 | deu certo — inclusive check com avisos (use --strict para reprovar) |
1 | falhou: erro no programa, teste reprovado, erro de análise, quebra de ABI |
2 | o seu programa pediu — OS.exit(2) sai com o código que você escolher |
Variáveis de ambiente#
| Variável | Efeito |
|---|---|
NO_COLOR=1 ou --no-color | sem códigos de cor — para log e CI |
DF_IDIOMA=en | as mensagens em inglês (o padrão é português) |
DATAFORGE_SEM_TROCA=1 | ignora o pino de versão do forge.toml |
DATAFORGE_REGISTRY | o registro de pacotes |
DF_ATUALIZAR_SNAPSHOT=1 | aceita as mudanças dos instantâneos |
DATABASE_URL | a conexão que Forge.de_ambiente() lê |
Uma linha, sem arquivo#
bash
dataforge eval 'out 2 ** 10'
dataforge eval 'out [1, 2, 3] >> morph n: n * 2'
dataforge --version # o que o instalador e o CI conferem
dataforge converter script.py # um ponto de partida, a partir de PythonNuma esteira#
bash
#!/bin/sh
set -e # para no primeiro codigo diferente de zero
export NO_COLOR=1
dataforge fmt . --check
dataforge check . --strict --formato=github
dataforge seguranca . --strict
dataforge test --minimo=80
dataforge abi v1/lib.df src/lib.df # 1 se a versao nova quebraContinue em Referência completa.