PIF

Repositório de desenvolvimento da linguagem de programação PIF

Aprendendo a programar...

Esta linguagem é extremamente simples e amigável para programadores iniciantes, contando com diversos exemplos e documentação completa a respeito do uso e das regras.

Documentação

A documentação da linguagem contém a explicação de como um programa escrito em PIF deve ser escrito:

1. Início.
2. Índice geral.
3. Entrada e saída de dados.
4. Operações com o tipo literal.
5. Estruturas condicionais.
6. Estruturas de repetição.

Exemplos

1. Exemplos básicos entrada e saída de dados
2. Exemplos de operações com o tipo literal (cadeia de caracteres ou palavras)
3. Exemplos de uso de estruturas condicionais (se...então, senão se ... então, senão ...)
4. Exemplos de uso de estruturas de repetição (faça ... enquanto , enquanto ... faça) - básicos e um pouco avançados

Também há alguns exemplos do que não deve ser feito (alguns programas podem nem chegar a compilar)

1. Exemplos de código incorreto

Compilando o código ({programa}.pifc)

Para compilar o código, basta baixar o compilador ou compilá-lo através do código fonte e seguir as instruções conforme indicado na documentação do compilador.

Baixando e instalando

Windows

Há distribuições binárias a partir da página de releases. Vá para os detalhes da última versão e baixe o arquivo pif_compiler-X.X.XX_x{64|86}.exe, onde X.X.XX é a versão e x{64|86} é a arquitetura compilada (escolha a arquitetura compatível com a sua máquina). Depois, basta seguir os passos do instalador e executar o compilador através da linha de comando ou usando o PIF IDE.

Alternativamente, você poderá compilar o projeto a partir do código fonte, conforme descrito na sessão Compilando a partir do código fonte.

Linux

Para Linux, você deverá compilar o projeto a partir do código fonte, conforme descrito na sessão Compilando a partir do código fonte.

Compilando a partir do código fonte

O código fonte está sendo testado tanto no Windows (MSVC2017_{x64,x86}, MinGW_{x86,x64}), quanto no Linux (Fedora GCC_x64).

Para compilar o código fonte, primeiramente você deverá seguir alguns passos, dependendo de seu SO.

Windows

1. (Opcional) Baixe e instale o VS Community 2019 (caso você deseje utilizar próprio compilador C++ do visual studio) - Certifique-se que o kit de desenvolvimento C++ está selecionado.
2. Visite a página de download da versão de código aberto do Qt (dê preferência ao instalador online).
3. Execute o instalador (talvez você precise fazer um cadastro, mas não se preocupe, não haverá cobrança).
4. Selecione os itens que deseja baixar e instalar (recomendamos que a última versão LTS seja a utilizada).
5. Nas opções "tools" marque também as versões mais recentes do MinGW (é muito útil caso você não queira usar o compilador da MS).
6. Avançe e pronto!
7. Abra o recém instaldo QtCreator, abra o arquivo "compiler.pro" através da opção de abertura de projetos na IDE, selecione os kits válidos e avance.
8. Forneça os parâmetros de linha de comando conforme indicado na documentação do compilador.
9. Clique CTRL + R e o projeto será compilado e executado (de acordo com os argumentos fornecidos).

Linux

• Instale as dependências conforme descrito em Qt for Linux/X11.
• Agora você tem 2 opções:

1. Instalar o Qt diretamente do site do desenvolvedor.
2. Instalar o Qt através de pacotes de desenvolvimento disponíveis na distro de sua preferência.

Instalação a partir do site oficial

1. Visite a página de download da versão de código aberto do Qt.
2. Execute o instalador (talvez você precise fazer um cadastro, mas não se preocupe, não haverá cobrança).
3. Selecione os itens que deseja baixar e instalar (recomendamos que a última versão LTS seja a utilizada).
4. Avançe e pronto!
5. Abra o recém instaldo QtCreator, abra o arquivo "compiler.pro" através da opção de abertura de projetos na IDE, selecione os kits válidos e avance.
6. Forneça os parâmetros de linha de comando conforme indicado na documentação do compilador.
7. Clique CTRL + R e o projeto será compilado e executado (de acordo com os argumentos fornecidos).

Fedora/RHEL/CentOS

1. Digite os seguintes comandos:

	$ sudo dnf upgrade
	$ sudo dnf install qt5-devel
	$ cd <PIF_PROJ_PATH/src/>
	$ mkdir build
	$ cd build
	$ qmake ../compiler/compiler.pro
	$ make

Pronto! Assim que terminar você poderá rodar o executável conforme a documentação do compilador.

	$ ./pifc [args]

• Alternativamente, você também pode usar o Qt creator (mas não se esqueça de adicionar o qmake ao PATH).

Ubuntu/Debian e derivados...

1. Digite os seguintes comandos:

	$ sudo apt-get update && sudo apt-get upgrade
	$ sudo apt-get install qtbase5-dev qt5-qmake
	$ cd <PIF_PROJ_PATH/src/>
	$ mkdir build
	$ cd build
	$ qmake ../compiler/compiler.pro
	$ make

Pronto! Assim que terminar você poderá rodar o executável conforme a documentação do compilador.

	$ ./pifc [args]

• Alternativamente, você também pode usar o Qt creator (mas não se esqueça de adicionar o qmake ao PATH).

Licença

Todo o desenvolvimento da linguagem de programação PIFC encontra-se sob a licença de código aberto LGPL V3 cuja cópia encontra-se disponível na raíz deste repositório. Já a documentação encontra-se sob a Licença Creative Commons Attribution-Share Alike 4.0 International (CC-BY-SA).

Este trabalho está licenciado com uma Licença Creative Commons - Atribuição-CompartilhaIgual 4.0 Internacional.