Skip to content

dgadelha/Portugol-Webstudio

Repository files navigation

Portugol Webstudio

Portugol Webstudio

IDE online para o Portugol

Licença Stars

Baseado no Portugol Studio, o Portugol Webstudio tenta trazer todo ambiente de desenvolvimento que é possível se encontrar no desktop, para a internet. Ele constitui-se de um ambiente de desenvolvimento construído para permitir a criação e a execução dos programas escritos em Portugol, trazendo assim uma experiência o mais próxima do que você pode encontrar da IDE do Portugol Studio. Portugol, também conhecido como Português estruturado, é um pseudocódigo escrito em português.

Captura de Tela

Características

  • Suporta abertura e escrita de arquivos .por
  • Permite editar e executar múltiplos códigos ao mesmo tempo
  • Executado no console original do Portugol com interação em tempo real
  • Interface simples e idêntica ao Portugol Studio
  • Código executado diretamente no navegador através de Web Workers

Estrutura do projeto

O Portugol Webstudio é um projeto que utiliza o framework Angular, RxJS e antlr4ng. Ele é dividido em 7 pacotes (disponíveis na pasta packages):

  • @portugol-webstudio/antlr: Pacote que contém a gramática do Portugol e a geração do parser, lexer e visitor
  • @portugol-webstudio/ide: Pacote que contém a interface do usuário
  • @portugol-webstudio/parser: Pacote que contém o novo parser do Portugol, que recebe uma árvore pré-processada pelo ANTLR e a transforma em uma árvore semântica
  • @portugol-webstudio/resources: Pacote que contém os recursos do Portugol, como os exemplos e a seção de ajuda
  • @portugol-webstudio/runner: Pacote que executa o código gerado pelo transpilador em Web Workers, tratando entrada, saída, erros e eventos.
  • @portugol-webstudio/runtime: Pacote que contém o transpilador de Portugol para JavaScript e o código de execução em runtime necessário: variáveis, bibliotecas, etc.
  • @portugol-webstudio/worker: Pacote que contém o código que será executado em Web Workers, que é responsável por receber o código do Portugol, e executar a verificação de erros e transpilação do código em uma thread separada.

Executando o código localmente

  1. Certifique-se de possuir instalado o Node.js LTS

  2. Instale as dependências do projeto

npm ci
  1. Compile os pacotes:
npm run build
  1. Inicie o servidor de desenvolvimento:
npm start

Após isto, você poderá acessar a IDE em: http://localhost:4200

Contribuidores

Sobre o Projeto

Autores: Douglas Gadêlha e Danilo Gadêlha

Licença

Portugol Webstudio - IDE online para o Portugol
Copyright (C) 2024  Douglas Gadêlha, Danilo Gadêlha e contribuidores

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.