designliquido / delegua

Linguagem de programação 100% em português baseada em TypeScript, independente de sistema operacional e dispositivo, e suporte a múltiplos dialetos.

Linguagem Delégua

Linguagem de programação 100% em português com suporte a múltiplos dialetos, como Portugol VisuAlg, Portugol Studio, Mapler e BIRL.

Página Web com Interpretador Delégua para demonstrações

Acompanhe a Design Líquido nas redes sociais:

Introdução

Delégua é uma linguagem de programação baseada na língua portuguesa, cujo código começou como uma variação (fork) da linguagem Égua, usada para fins educacionais e comerciais pela Design Líquido. A variação começou na versão 1.2.0 de Égua.

Delégua tem retrocompatibilidade com a linguagem Égua e compreende sua extensão de arquivo (.egua). Em outras palavras, todo programa escrito em Égua funciona em Delégua, mas Delégua tem capacidades a mais, conforme mencionado em documentação.

Vantagens de programar em português

• Acessibilidade e Compreensão: Programar em sua língua materna, como o português, pode tornar os conceitos de programação mais acessíveis e fáceis de entender, especialmente para iniciantes. Isso reduz a barreira de entrada para novos programadores.

• Facilita o Aprendizado: A programação em português permite que os aprendizes concentrem-se nos conceitos de programação em vez de lidar com a barreira do idioma. Isso pode acelerar o processo de aprendizado, especialmente para pessoas que não têm fluência em inglês.

• Melhor Comunicação e Documentação: Programar em seu idioma nativo pode levar a uma comunicação mais clara e eficaz com colegas e clientes locais. Além disso, a documentação em português pode ser mais fácil de compreender e seguir.

• Contribuição para a Identidade Cultural: Linguagens de programação em português contribuem para a preservação da identidade cultural e linguística, promovendo o uso e a adoção do idioma em contextos tecnológicos.

• Facilita a Localização de Erros: Programar em português pode tornar mais fácil a localização e correção de erros de código, uma vez que os desenvolvedores podem compreender rapidamente o contexto dos problemas.

Características

Delégua, a linguagem de programação totalmente em português, possui uma série de características que a tornam única e atraente:

Acessibilidade

• Simples e Completa: Delégua é projetada para ser acessível a programadores de todos os níveis, desde iniciantes até experientes. Sua simplicidade e completude facilitam a aprendizagem.

• Totalmente em Português: Uma característica distintiva é que Delégua é desenvolvida inteiramente em português(mesmo), tornando-a acessível e amigável para aqueles que preferem programar em seu idioma nativo.

Tecnologia Moderna

• Código aberto (open source): Delégua é uma linguagem de código aberto e gratuita, licenciada sob a MIT License, permitindo o uso sem restrições.

• Modularidade: A linguagem suporta a criação de módulos reutilizáveis, promovendo a organização e a manutenção do código.

• Orientada a Objetos: Delégua oferece recursos completos de programação orientada a objetos, incluindo classes, objetos e herança.

• Multidialetos. Execute algoritmos em Portugol VisuAlg, Portugol Studio, Portugol Mapler e Portugol IPT.

Flexibilidade e Potencial

• Depurável. Usando um editor com suporte à depuração como o Visual Studio Code, você pode inspecionar o seu programa, suas variáveis e executar linha por linha.

• Portabilidade: Delégua é executável em qualquer dispositivo que interprete JavaScript, tornando-a versátil e compatível com diversos sistemas operacionais e qualquer navegador de internet.

• Traduzibilidade: A capacidade de traduzir programas entre Delégua, Python e JavaScript aumenta a flexibilidade e as opções de desenvolvimento.

Aplicações

• Escrita de aplicações para Internet, usando o ferramentário (framework) liquido;
• Aplicações em React Native.

Instalação

Delégua executa em qualquer dispositivo que interprete JavaScript, ou seja, computadores, celulares e tablets. Você não precisa instalar nada se não quiser. Utilize uma das seguintes opções:

• Dentro do Visual Studio Code, instale a extensão da Design Líquido. Aprenda como executar e depurar seu programa aqui;
• Utilize nosso editor online.

Para instalar no seu computador, veja o projeto @designliquido/delegua-node.

Documentação

• Delégua é documentada na Wiki deste GitHub.
• A documentação técnica (gerada por TypeDoc) pode ser encontrada aqui.

Contribuições e Comunidade

• Para contribuições, por favor, leia o nosso Guia de Contribuição antes de submeter uma Pull Request.
• Veja nossas discussões atuais.
• Temos um grupo no Discord.

delegua's Issues

Retornando booleanos em inglês

Ex:

var a = 1 == 1
escreva(a) // true

var b = 1 !== 1
escreva(b) // false

Zero não é considerado um número inteiro pelo método inteiro() quando passado na forma de número

Números como paràmetro do método inteiro()

var valor = inteiro(1)

se (valor > 0) {
  escreva('Este número é positivo!');
} senao se (valor < 0) {
  escreva('Este número é negativo!');
  } senao {
  escreva('Zero não é positivo nem negativo');
}

retorno:
Este número é positivo!

var valor = inteiro(-1)

se (valor > 0) {
  escreva('Este número é positivo!');
} senao se (valor < 0) {
  escreva('Este número é negativo!');
  } senao {
  escreva('Zero não é positivo nem negativo!');
}

retorno:
Este número é negativo!

var valor = inteiro(0)

se (valor > 0) {
  escreva('Este número é positivo!');
} senao se (valor < 0) {
  escreva('Este número é negativo!');
  } senao {
  escreva('Zero não é positivo nem negativo');
}

retorno:
Erro em JavaScript: Somente números podem passar para inteiro.
Pilha de execução: Error: Somente números podem passar para inteiro.

Strings como paràmetro do método inteiro()

var valor = inteiro("1")

se (valor > 0) {
  escreva('Este número é positivo!');
} senao se (valor < 0) {
  escreva('Este número é negativo!');
  } senao {
  escreva('Zero não é positivo nem negativo');
}

retorno:
Este número é positivo!

var valor = inteiro("-1")

se (valor > 0) {
  escreva('Este número é positivo!');
} senao se (valor < 0) {
  escreva('Este número é negativo!');
  } senao {
  escreva('Zero não é positivo nem negativo!');
}

retorno:
Este número é negativo!

var valor = inteiro("0")

se (valor > 0) {
  escreva('Este número é positivo!');
} senao se (valor < 0) {
  escreva('Este número é negativo!');
  } senao {
  escreva('Zero não é positivo nem negativo');
}

retorno:
Zero não é positivo nem negativo!

Variável não definida

A partir da versão 0.3.0 de Delégua, ao definir variável, esta gerando problema de variável não definida.

Cenário:

var a = 1
a
escreva(a)
Erro: [Linha: 1] Variável não definida 'a'.

Método leia gera erro se parâmetro estiver vazio

Comando leia só funciona se passar texto ou texto vazio como leia('') se não passar nada gera erro.

var a = leia()

Erro no '': Esperado expressão.

Erro na função mapear quando o retorno da função de callback é passado sem ponto e vírgula

funcao funcaoTestaMap(lista) {
  retorna mapear(
    lista,
    funcao(valor) {
      retorna valor
    })
}

escreva(funcaoTestaMap([1, 2, 3, 4]))

retorno:
NaN, NaN, NaN, NaN

funcao funcaoTestaMap(lista) {
  retorna mapear(
    lista,
    funcao(valor) {
      retorna valor;
    })
}

escreva(funcaoTestaMap([1, 2, 3, 4]))

retorno:
1, 2, 3, 4

Erros ao usar o console Delégua

PS C:\delegua> escreva(856+4)

Erro:

escreva : The term 'escreva' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included,
verify that the path is correct and try again.
At line:1 char:1

• escreva(856+4)
• CategoryInfo : ObjectNotFound: (escreva:String) [], CommandNotFoundException
• FullyQualifiedErrorId : CommandNotFoundException

Implementar dialetos para eguap e eguac

Erro de hasOwnProperty ao verificar nulo

escreva(nulo == nulo)

ou

nulo == nulo

Erro em JavaScript: Cannot read properties of null (reading 'hasOwnProperty')
Pilha de execução: TypeError: Cannot read properties of null (reading 'hasOwnProperty')

Adicionar suporte para simbolos

• Simbolos.
  +=
  -=
  *=
  /=

Mudar funções para ES6

Parênteses em `retorna` devem ser opcionais

inicio.delegua

var funcoesMatematicas = importar('./funcoes.delegua')

var soma = funcoesMatematicas.soma(1, 2)
escreva(soma)

funcoes.delegua

função soma(valor1, valor2){
    retorna valor1 + valor2;
}

delegua inicio.delegua

Erro: [Linha: 3] Chamada de função ou método inexistente: [object Object]

Métodos do exemplo que não deveriam ter retorno retornam valor assim mesmo

classe Resposta {
    enviar(codigo) {
        isto.codigo = codigo
    }

    status(statusHttp) {
        isto.statusHttp = statusHttp
    }
}

var resp = Resposta();
escreva(resp.enviar("Ok").status(200))

Neste caso:

enviar(codigo) {
        isto.codigo = codigo
    }

"Ok" é retornado pelo Interpretador, e

    status(statusHttp) {
        isto.statusHttp = statusHttp
    }

200 é retornado pelo Interpretador.

Deixar opcional o uso de (ponto e vírgula) no final

Escreva não esta funcionando com N parametros

escreva('teste', 1, 2, 3)

Resultado:

3

Erro ao iniciar RELP (Delégua)

C:\delegua\fontes\interpretador\pilha-escopos-execucao.ts:34
this.pilha.at(-1).ambiente.valores[nomeVariavel] = valor;
^
TypeError: this.pilha.at is not a function
at PilhaEscoposExecucao.definirVariavel (C:\delegua\fontes\interpretador\pilha-escopos-execucao.ts:34:20)
at default_1 (C:\delegua\fontes\bibliotecas\biblioteca-global.ts:12:26)
at new Interpretador (C:\delegua\fontes\interpretador\interpretador.ts:89:33)
at new Delegua (C:\delegua\fontes\delegua.ts:85:38)
at principal (C:\delegua\index.ts:21:21)
at Object. (C:\delegua\index.ts:30:1)
at Module._compile (internal/modules/cjs/loader.js:1085:14)
at Module._compile (C:\delegua\node_modules\ts-node\src\index.ts:1455:23)
at internal/modules/cjs/loader.js:1114:10
at Object..ts (C:\delegua\node_modules\ts-node\src\index.ts:1458:12)
Waiting for the debugger to disconnect...

Instrução `escolha` deve aceitar múltiplos casos com o mesmo bloco, e a palavra `sustar`

O problema vem de Égua Clássico. escolha não aceita bloco para cada caso, não aceita múltiplos casos pro mesmo bloco, e não reconhece a palavra sustar (ou pausa).

Implementar métodos de texto discutidos em https://github.com/DesignLiquido/delegua/discussions/125

Depende de #129.

Criar guia de contribuição

https://github.com/DesignLiquido/delegua/blob/principal/.github/CONTRIBUTING.md

Não usar o package.json para definir a versão atual.

Corrigir Bug no lexador do dialeto birl.

Se a string de this.codigo não vinher com os \n nos locais certos o lexador entra em uma verificação infinita.

Meu proximo passo e corrigir esse bug.

Permitir comentários em múltiplas linhas

Hoje, só é possível fazer comentários com // a idéia é também permitir o uso de /* */ para várias linhas.

Usar algo como:

/*
Comentário
Comentário
Comentário
Comentário
*/

Permitir concatenação de texto e número

Essa funcionalidade é para o dialeto Delégua.

Adicionar flag para saber qual linguagem usar, egua ou delégua

Padrão é delegua.

Criar repostitório para extensão da linguagem - VSCode

Método 'escreva' retorna um 'undefined' a mais.

Se escrevermos somente o nome da variável no terminal e dermos um enter, o código retorna um objeto com as chaves "valor" e "tipo". Exemplo:

var texto = "Olá, tudo bem?"; // undefined
texto // {"valor":"Olá, tudo bem?","tipo":"texto"}

Até aqui, tudo bem, pois quando digitamos o nome da variável, o objeto contendo valor e tipo são retornados na íntegra.

Porém, se seguirmos o mesmo processo, mas utilizamos o método escreva(variável) para ler, o código retorna o valor, mas seguido de um undefined na linha abaixo:

var texto = "Olá, tudo bem?";
escreva(texto); 
// Olá, tudo bem? 
// undefined

OBSERVAÇÕES FINAIS:

• Pode ser que o método esteja tentando também retornar o "tipo" - a segunda chave do objeto montado ao criar a variável;
• É importante notar também que no primeiro exemplo, após criar a variável, um undefined também está sendo retornado por padrão. Trago esse ponto apenas para a possibilidade de ser o mesmo erro ou uma questão similar.

Não retorna erro quando tem identificador inválido na linha

    classe Animal {
      correr() {
        escreva("Correndo Loucamente"); aquiPrecisaGerarUmErro
      }
    }
    classe Cachorro herda Animal {
      latir() {
        escreva("Au Au Au Au");
      }
    }

    var nomeDoCachorro = Cachorro();
    nomeDoCachorro.correr();
    nomeDoCachorro.latir();

Criar documentação TypeDoc para Delégua

Documentar métodos, classes, propriedades ...

TYPEDOC: Parece ser uma boa opção.
https://typedoc.org/guides/installation/

Erro ao executar o teste de Bhaskara usando Delégua

Usando dialeto: padrão
[Arquivo: bhaskara.egua] [Linha: undefined] Erro no ';': Esperado '}' após o bloco.
Waiting for the debugger to disconnect...

No dialeto Égua funciona normal.

Criar uma nova forma para retornar erros

Idéia aqui seria retornar uma pilha de erros.

Hoje usamos console.log() mas dependendo da aplicação, pode não ser a melhor solução.

Método escreva deve suportar qualquer número de argumentos

var x = 10;
var y = 10;
var z = 10;

escreva(x, y, z);

Deveria escrever: 10 10 10

Criar repositórios para módulos da linguagem

Retornar pilha de erros

Melhorar traduções

Parte 2 das traduções.

• Funções
• Variáveis
• Classes
• Métodos

Retorno de método `nulo` esta retornando `null`

testes.delegua

função testeRetornoNulo(){
    retorna nulo
}

inicio.delegua

var teste = importar('./testes.delegua')

var resultado = teste.testeRetornoNulo()
escreva(resultado)

delegua inicio.delegua

Retorno esperado

nulo

Retorno obtido

null

Adicionar no Wiki diferenças do égua e delégua

Algumas delas:

• #23
• #15
• #21
• #22
• #3
• #45

Não esta retornando erros no retorno de Delégua

Testando:

    classe Animal {
      correr() {
        escreva("Correndo Loucamente");
      }
    }
    classe Cachorro herda Animal {
      latir() {
        escreva("Au Au Au Au"); aqui é pra gerar um erro
      }
    }
    
    var nomeDoCachorro = Cachorro();
    nomeDoCachorro.correr();
    nomeDoCachorro.latir();

Deveria retornar erro, mas não retorna e funciona normal.

Verificar motivo dos testes não estar opcional o uso do ponto e vírgula

Implementar TypeScript

Problema no lexador.mapear()

Dado o seguinte array de string:

['5*4', 'escreva(2 + 2)']

Saída:
4
Esperado:
20
4

Esse problema ocorre no seguinte método analisarNumero() do arquivo lexador.ts:

        const numeroCompleto = this.codigo[this.linha].substring(
            this.inicioSimbolo,
            this.atual
        );
        this.adicionarSimbolo(
            tiposDeSimbolos.NUMERO,
            parseFloat(numeroCompleto)
        );

A variável numeroCompleto era pra retornar 4, mas esta retornando vazio, e quando tenta fazer o parseFloat gera NaN;

Testando, verifiquei que this.atual esta com valor errado.

Apenas retorna os elementos dentro do array quando usado o método escreva

var lista = [1, 2, 3, 4, 5, 6, 7, 8, 9];

escreva(lista) // 1, 2, 3, 4, 5, 6, 7, 8, 9

Importar biblioteca externa esta com erro

Instalei o lodash global na máquina, e fiz o seguinte teste:

inicio.delegua

var lodash = importar('lodash');
var a = { 'b': 'c' };
escreva(lodash.get(a, 'b', 'f'));

delegua inicio.delegua

TypeError: Cannot read properties of null (reading 'constructor')

Erro em JavaScript: Cannot convert undefined or null to object
Pilha de execução: TypeError: Cannot convert undefined or null to object

Problema na atribuição de variáveis

var x = 1 + 1;
escreva(x);

Esta retornando null, deveria retornar 2.

Mau funcionamento ao tentar clonar variáveis

Ao tentar clonar uma variável a partir de outra, essa nova variável está recebendo o objeto inteiro ("valor" e "tipo") ao invés de receber somente o valor.

Exemplo:

var a = 123;
var copia = a;
escreva(copia); // {"valor":{"valor":123,"tipo":"número"},"tipo":"dicionário"}

Estou ciente de que clonar dessa forma pode ser um pouco incomum, mas nunca podemos duvidar do comportamento do usuário.

Podemos notar também que outra consequência dessa Issue é que as variáveis clonadas sempre receberão o tipo 'dicionário' por receberem o objeto inteiro.

Em tempo, ressalto que quando clonamos uma variável com implementações extras (o que é mais comum), o funcionamento ocorre de acordo:

var a = 'Vitor Brandao';
var aMaiusculo = a.maiusculo();
escreva(aMaiusculo); // "VITOR BRANDAO"

Mas mesmo ao tentar clonar a variável bem sucedida, persiste a atribuição do objeto inteiro:

var a = 'Vitor Brandao';
var aMaiusculo = a.maiusculo();
var copia = aMaiusculo;
escreva(copia); // {"valor":{"valor":"VITOR BRANDAO","tipo":"texto"},"tipo":"dicionário"}

Mostrando resultado somente uma vez no console

Começou a partir da versão 0.1.3

Cenário:

escreva('abc' + 123); // abc123

Se repetir o mesmo processo, não vai mostrar nada no console, mesmo se tentar escrever qualquer outra coisa.

O resultado é sempre o mesmo, funcionando apenas uma única vez.

Adicionar na wiki referência dos pacotes delegua-matematica e delegua-tempo

Implementar template string

Dialeto não esta funcionando

Motivo:

É iniciado as intancias das classes via construtor, depois é sobrescrito por novas instancias.

Melhorar testes

Criar e melhorar testes existestes para:

• égua
• eguac
• eguap
• delégua

Módulo não encontrado "perf_hooks"

Quando tento usar delegua em outros projetos, gera erro no perf_hooks.

Permitir operações direto no console

Essa funcionalidade é para o dialeto Delégua.

Hoje, só é possível realizar operações matemáticas se fizer a atribuição a uma variável.

A idéia aqui é permitir essas operações no console sem precisar dessa atribuição e assim mostrar o resultado.

9-2
9*2
9/2
9**2

Também para operadores lógicos.

2 != 2; // falso
1==1; // verdadeiro
5+5; // 10