Editor: cores, autocompletar e depurador
O que a extensão faz, o que o LSP responde, e como parar o programa numa linha — inclusive por ssh.
A pergunta costuma vir como "tem plugin?". Tem, e ele é instalado pela própria CLI — a gramática de cores é gerada do tokens.py, então ela não pode discordar do lexer.
Instalar#
$ dataforge editorEle instala no VS Code e nos derivados (Cursor, VSCodium, Windsurf). A coloração, os snippets, o ícone do .df, o cliente do LSP e o adaptador de depuração vão juntos.
O que o LSP responde#
| Recurso | O que faz |
|---|---|
| hover | o tipo e a doc do que está sob o cursor |
| ir-para-definição | inclusive atravessando adopt |
| completar | olha o contexto: depois de p., os membros de p |
| diagnósticos | os mesmos do dataforge check, enquanto você digita |
// df: permitir <regra> | silencia ali, lido do texto do editor |
Os nomes do próprio arquivo vêm antes dos 2323 símbolos da biblioteca — é o que se procura em nove de cada dez vezes. E o comentário que silencia uma regra é lido do buffer, não do disco: num arquivo não salvo, ler do disco silenciaria a regra errada — ou nenhuma.
Depurar#
$ dataforge debug programa.df # no terminal, e serve por ssh
$ dataforge dap # o mesmo no painel do editor (F5)| Comando | Faz |
|---|---|
n | a próxima linha, sem entrar |
s | entra na ação |
c | segue até a próxima parada |
w saldo | para quando saldo mudar |
r saldo | para quando saldo for lido |
O depurador desliga a compilação para fechamentos: ele para em cada linha sombreando execute, e o corpo compilado passaria por fora. Um depurador que enxerga metade das instruções é pior que um interpretador mais lento.