designliquido / vscode

Extensão do Visual Studio Code para as linguagens da Design Líquido e dialetos de Portugol.

Linguagens em Português para Visual Studio Code

Essa extensão visa melhorar a produtividade de projetos escritos usando as linguagens da Design Líquido:

• Delégua;
• LMHT;
• FolEs;
• LinConEs;

Essa extensão também oferece suporte parcial a outras linguagens que são dialetos de Delégua:

• Egua;
• Pituguês;
• Portugol Mapler;
• Portugol Studio;
• Portugol VisuAlg.

Instalação

Você pode instalar pesquisando nas extensões do Visual Studio Code ou por este link.

Funcionalidades até então

• Sintaxe colorida
• Formatação de arquivos em Delégua
• Análise semântica para Delégua
• Reconhecimento de expressões comuns das linguagens Delégua, Égua, Pituguês e dialetos de Portugol, como VisuAlg e Portugol Studio/Webstudio
• Ícones para arquivos .delegua, .egua, .pitugues, .foles, .lincones e .lmht
• Trechos de códigos para facilitar desenvolvimento em Delégua
• Mecanismo de completude de funções da biblioteca global para Delégua
• Suporte a depuração para Delégua, Pituguês, Portugol VisuAlg e Portugol Studio/Webstudio

Tradução entre linguagens

Essa extensão suporta tradução entre linguagens:

• VisuAlg para Delégua;
• Delégua para JavaScript
• JavaScript para Delégua
• Delégua para Python

Pressione Ctrl + Shift + p (Cmd + Shift + p no Mac) e digite "tradução" para ter acesso aos comandos. Você pode atribuir atalhos de teclado a eles se quiser.

Depuração

Delégua possui um protocolo próprio de comunicação entre depurador e cliente de depuração, conforme especificado aqui. A ideia é que seja possível escrever interações entre diferentes clientes de depuração, como outros editores que tenham suporte a depuração, por exemplo.

O Visual Studio Code também possui um protocolo de comunicação detalhado aqui. Para que Delégua e Visual Studio Code se entendam, é preciso um intermediador entre eles, implementado pela classe DeleguaTempoExecucaoLocal.

Segundo a documentação do Visual Studio Code, linguagens podem usar ou um executável que faça a tradução das mensagens entre linguagem e Visual Studio Code, um servidor Socket implementado dentro da extensão, ou ainda, uma implementação customizada. Aqui optamos pela opção do servidor Socket até a versão 0.1.1 (ver classes DeleguaTempoExecucaoRemota e DeleguaSessaoDepuracaoRemota), que abre em uma porta aleatória disponível. Esta forma comanda a execução de Delégua com a opção --depurador definida, que abre o servidor de depuração na porta 7777 e espera uma instrução de pronto para liberar os comandos de depuração para a interface do VSCode. A implementação ainda existe, mas não é habilitada por padrão. Poderá voltar no futuro.

Atualmente a extensão usa o núcleo da linguagem Delégua como uma dependência NPM e instancia e controla os elementos da linguagem.

vscode's Issues

Implementar Provedor de Documentação em Código para LinConEs

Vulgo HoverProvider. Usar como base outras implementações, como a de LMHT.

Implementar fragmentos (_snippets_) de código para LinConEs

Em outras linguagens da extensão, podemos pressionar Ctrl/Cmd + Shift + espaço para ver uma lista de fragmentos (snippets):

Ao pressionar Enter em um fragmento, temos no editor o código previamente preenchido:

A ideia é fazer o mesmo para LinConEs.

Favor utilizar o diretório https://github.com/DesignLiquido/vscode/tree/principal/snippets como base.

Implementar Provedor de Completude LinConEs

Usar como base outros provedores existentes.

Implementar `limpatela` - VisuAlg

Relacionado: DesignLiquido/delegua#502

https://stackoverflow.com/a/41600891/9043143

Evento que deve ser criado na classe DeleguaSessaoDepuracaoBase:

this.tempoExecucao.on('limpatela', () => {        
    vscode.commands.executeCommand('workbench.debug.panel.action.clearReplAction');
});

Assinaturas de métodos da biblioteca global de Delégua

Por causa de https://github.com/DesignLiquido/vscode/blob/principal/fontes/assinaturas-metodos/delegua-provedor-assinaturas-metodos.ts, teremos que expandir os métodos da biblioteca global.

Atualmente coloquei só um como exemplo, que é o escreva. Agora temos o seguinte:

import { PrimitivaOuMetodo } from "./tipos";

export const metodosBibliotecaGlobal: PrimitivaOuMetodo[] = [
    {
        nome: 'escreva',
        assinaturas: [
            {
                formato: 'escreva(...argumentos: qualquer)',
                parametros: [
                    {
                        nome: '...argumentos',
                        documentacao:
                            'Os argumentos para impressão, que podem ser literais, constantes ou variáveis de qualquer tipo.',
                    },
                ],
            },
        ],
        documentacao:
            'Escreve um ou mais argumentos na saída padrão da aplicação. \n' +
            '## Interpolação \n' +
            'Delégua suporta interpolação de variáveis: \n \n' +
            "```var comidaFavorita = 'strogonoff'```\n\n" +
            '```escreva("Minha comida favorita é ${comidaFavorita}")```',
        exemploCodigo: 'função escreva(...argumentos)',
    },
    ...

A ideia é adicionar para os demais métodos o array de assinaturas.

Traduzir tags da linguagem LMHT

Arquivos:

• configuracoes\configuracao-lmht.json
• syntaxes\lmht.tmLanguage.json

Usar como base o projeto https://github.com/DesignLiquido/LMHT.

Bug no "escreval"

Bom dia!

Durante meus estudos, notei um bug ao utilizar a função "escreval".

Ao executar a programação com o "escreval" a frase some e aparece apenas ">" (Primeira imagem)

Ao executar a programação com o "escreva" a frase aparece normalmente. (Segunda imagem)

Agradeço por disponibilizar uma extensão tão incrivel, espero estar contribuindo, um grande abraço!

Usar no provedor de completude de FolEs uma lista que venha da biblioteca de FolEs

Hoje em dia o provedor de completude de FolEs usa essa lista de sugestões, que fiz para validar o funcionamento do provedor. O problema é que a lista não vem da biblioteca, mas da própria extensão, o que pode ocasionar esforço duplo mais futuramente.

A ideia é achar uma forma de trazer os modificadores dinamicamente de @designliquido/foles e popular o provedor de completude. Provavelmente isso trará impacto em FolEs também.

Não consigo executar contagens decrescentes com a estrutura para

No curso do Guanabara de algoritmo, ele faz um exercício com a estrutura de repetição PARA, ele pede para fazer algumas contagens regressivas, porém não consigo executar códigos com contagens regressivas, como faço para arrumar isso?

Código que tentei fazer porém não deu certo.

algoritmo "valoresPares"

var
Cont, V: Inteiro

inicio
    escreval("Digite um valor: ")
    Leia(V)
    para CONT de V ate 0 passo -2 faca
        Escreval(CONT)
    Fimpara

fimalgoritmo

Auto-completar para VisuAlg

Base: https://www.youtube.com/watch?v=w5ZpAqt2L6Q&lc=Ugwcyh7isafq5tjCl0R4AaABAg

O que já temos: https://github.com/DesignLiquido/vscode/blob/principal/fontes/documentacao-em-editor/visualg-documentacao-em-editor.ts e https://github.com/DesignLiquido/vscode/blob/principal/fontes/completude/visualg-provedor-completude.ts
O que precisa ser feito: colocar exemplos de código em https://github.com/DesignLiquido/vscode/blob/principal/fontes/primitivas/dialetos/visualg.ts e testar a extensão.
Problema: os manuais para cada função desapareceram da internet. Vamos precisar ser criativos aqui e recriar os exemplos.

Reconhecer senão/senãose/funções

Implementar Provedor de Completude LMHT

`inteiro(leia())` chama o prompt três vezes

Código para testes:

var n1 = inteiro(leia("digite sua idade"));
var n2 = (365*n1);

escreva("Você tem " +n2+" dias de vida");

Desdobramento de DesignLiquido/delegua#302

Traduções na gramática de LinConEs

Na força da preguiça, copiei a gramática de SQL na extensão mas nunca a traduzi: https://github.com/DesignLiquido/vscode/blob/principal/gramaticas/lincones.tmLanguage.json

A ideia é traduzir a gramática inteira e ir testando em arquivos .lincones pra ver se fica colorido corretamente.

`enquanto (verdadeiro)` em Delégua causa loop infinito

Código para simulação:

var n1 = 1;
var n2 = 1; 
var resultado = 0

var n1 = leia("teste 1");

enquanto (verdadeiro){
    var menu = leia("Digite a opção: 1 - Multiplicacao / 2 - Divisao / 3 - Soma / 4 - Subtração");
    se (menu == "1"){
        resultado = n1 * n2;        
        sustar;
    }senao se(menu =="2"){
        resultado = n1 / n2;
        sustar;            
    }senao se(menu =="3"){
        resultado = n1 + n2;
        sustar;            
    }senao se(menu =="4"){
        resultado = n1 - n2;
        sustar;
    }senao{
        escreva("opção invalida");
    }
}
escreva("resultado "+resultado);

Desdobramento de DesignLiquido/delegua#302

FALTA DE SUPORTE A CODIFICAÇÃO UTF-8

Pessoal, eu amei bastante essa extensão para o vscode, no entanto não há suporte a codificação de caracteres especiais da língua portuguesa. Tem como colocar essa feature para UTF-8?