@designliquido/delegua-node

delegua-node

Versão de Delégua com suporte a funcionalidades do ecossistema do Node.js. Também funciona com o Bun.

Motivação

Em versões anteriores, o suporte ao ecossistema Node vinha embutido no pacote do núcleo da linguagem. Isso virou um problema quando tentamos importar o pacote numa aplicação com Webpack.

Como o Webpack tenta ler todas as referências de todos os módulos recursivamente, independente se estamos importando um módulo ou vários, há problemas quando tentamos importar child_process ou net na parte de navegador de internet e as aplicações falham.

Mais adiante, este pacote ganhou a função de concentrar todos os dialetos em um único lugar, já que implementa a funcionalidade de execução de código por linha de comando.

Implicações

Se sua aplicação:

• Precisa suportar importações, seja de outros fontes, seja de bibliotecas NPM
• Executa código Delégua, ou outros dialetos, remotamente
• Deve executar no ambiente Node.js ou Bun, ou qualquer outro motor de JavaScript fora do navegador de internet

Ela deve, então, usar este pacote. Caso contrário, o uso apenas do núcleo de Delégua, ou pacote de dialeto, é uma escolha melhor.

Instalação

Se quiser instalar no seu computador, você deve ter antes o Node.js instalado em seu ambiente.

Com o Node.js instalado, execute o seguinte comando em um prompt de comando (Terminal, PowerShell ou cmd no Windows, Terminal ou sh em Mac e Linux):

npm install -g @designliquido/delegua-node

No entanto, este pacote por si só não contém as bibliotecas que fazem parte do ecossistema de Delégua, como delegua-matematica, delegua-http e outras. Para instalar a solução completa, com todas essas bibliotecas, utilize o comando:

npm install -g delegua

Usando como LAIR (Leia-Avalie-Imprima-Repita) em console

Feita a instalação no seu ambiente, execute o seguinte comando:

delegua

Você terá um interpretador Delégua que avalia expressões linha a linha.

Um exemplo de uso é como uma calculadora:

delegua> 2 + 2
4

delegua> 2 * 3
6

delegua> 2 ** 10
1024

Para finalizar a execução do interpretador LAIR Delégua, use o atalho Ctrl + C (todos os sistemas operacionais).

Se quiser apenas ver a versão instalada (sem executar), use:

delegua -v

Ou

delegua --versao

Dialetos que suportam o modo LAIR

• Delégua
• Égua Clássico
• Pituguês

Executando arquivos

É possível usar o interpretador com outros dialetos, como Égua.

delegua --dialeto egua

Ou

delegua -d pitugues

Veja aqui todos os dialetos suportados.

Executando código

É possível passar código como argumento para Delégua usando a opção -c:

delegua -c "escreva('Olá mundo')"

Tradução para outras linguagens

Delégua traduz para JavaScript e vice-versa. Mais informações aqui.