Linguagem Égua

Linguagem de programação simples e moderna.
Documentação »

IDEgua · Reportar Bug

Sobre

Égua é uma linguagem de programação interpretada, com sintaxe totalmente em português, voltada ao ensino de programação. O interpretador (lexer, parser, resolver e avaliador tree-walking) é escrito em JavaScript e roda em dois ambientes: no Node.js, via CLI com REPL, e no navegador, através de um bundle consumido pela IDEgua. É distribuída pelo npm sob licença MIT.

Comece a programar

No navegador, sem instalar nada

Visite a IDEgua e comece a programar direto do navegador.

Instalação local (CLI)

Com o Node.js 18 ou mais recente instalado:

npm i -g egua

Isso disponibiliza o comando egua no seu terminal, de duas formas:

# Executa um arquivo .egua
egua meu_programa.egua

# Sem argumentos, abre o modo interativo (REPL)
egua

No modo interativo, cada linha é executada na hora:

égua> escreva("Olá, mundo!")
Olá, mundo!

Seu primeiro programa

Crie um arquivo ola.egua:

escreva("Olá, mundo!");

E execute:

egua ola.egua

Bibliotecas padrão

A linguagem inclui bibliotecas nativas, carregadas com importar:

var m = importar("matematica");
escreva(m.raizq(16)); // 4

Biblioteca	Para quê
matematica	Funções matemáticas (raiz quadrada, trigonometria, etc.)
textos	Manipulação de textos (maiúsculas, divisão, substituição, etc.)
tempo	Data e hora do sistema
requisicao	Requisições HTTP (obter, enviar, atualizar, excluir)

Também há funções globais sempre disponíveis, como escreva, texto, paraCada, mapear, filtrar e ordenar. A referência completa está na documentação.

Estrutura do repositório

Este é um monorepo com a linguagem e suas aplicações:

Caminho	O que é
src/	Núcleo da linguagem: lexer, parser, resolver, interpretador e bibliotecas padrão
bin/	Ponto de entrada do CLI (egua)
tests/	Suíte de testes escrita na própria linguagem (tests.egua)
scripts/	Build do bundle da linguagem para o navegador (esbuild)
apps/site/	Site e documentação (egua.dev), feito com VitePress
apps/idegua/	IDE online (programar.egua.dev)

Desenvolvendo localmente

git clone https://github.com/eguadev/egua.git
cd egua
npm ci

# Roda a suíte de testes da linguagem
npm test

# Executa a sua cópia local do interpretador
./bin/egua meu_programa.egua

# Gera o bundle da linguagem usado pela IDEgua (apps/idegua/js/egua.min.js)
npm run build-web

Para rodar o site de documentação:

cd apps/site
npm ci
npm run dev

Documentação

• Para acessar nossa documentação, visite o site de documentação.

Contribuições

• Para contribuições, por favor, leia o nosso Guia de Contribuição antes de submeter uma Pull Request.

Contato

• Email: lucaspompeuneves@gmail.com