pric - compilador prisma alternativo

Compila arquivos fontes Prisma para executável (prog.exe em Win ou prog em Linux);

Este programa serve para compilar programas Prisma gerando um 'auto' interpretador, assim não será necessário ter o interpretador prisma instalado no computador alvo da instalação.

Obs.: Em sistema Windows é necessário a dll prisma tanto para o intepretador quanto para executáveis compilados com pric. A dll prisma correta será disponibilizada junto com o pric para windows.

Use:

  [no Windows] C:\\Prisma\\1.0\\bin\\pric.exe -o prog.exe prog.prisma
  [no Linux]   pric -o prog prog.prisma
  
  é possível passar mais de um fonte (arquivo.prisma):
  pric -o prog fonte1.prisma fonte2.prisma fonte3.prisma fonteprincipal.prisma

pric possui várias opções, veja:

• [ -o file_out ] - Compila os fontes com a saída file_out (especifique a extensão apropriada - em Windows: .exe | em Linux não precisa de extensão).
• [ -c file_out ] - Une os fontes em um só com a saída file_out (especifique a extensão apropriada).
• [ -p file_out ] - Compila os fontes para byte-code necessitando do interpratador prisma instalado
• [ -a file_out ] - gera um executável sem compilar o fonte prisma. (aceita apenas um fonte).
• [ -d ] - define o modo como debug, o source é anexado ao arquivo compilado para informações extras.
• [ -r ] - define o modo como release, o source não é anexado. (o padrão é release);
• [ -l ] - (letra 'L' minúscula) define uma biblioteca prisma para ligar ao arquivo compilado, exemplo: -l /home/myuser/libs/mylib.pris
• [ -s ] - define o caminho do auto-interpretador, exemplo: -s /pasta/srprisma
• [ -v ] - imprime a versão deste programa.
• [ -h ] - imprime esta mensagem.
• [ -z ] - define (shebang) um caminho para o interpretador, exemplo: -z /usr/local/bin/prisma

Veja abaixo algumas opções detalhadas:

[ -c ] - Opção para unir os fontes em um único arquivo sem compilar:

Obs.: Deixe no final o arquivo principal, aquele que usa funções que estão nos outros fontes.

     pric -c progfinal.prisma fontes1.prisma fontes2.prisma fontes3.prisma 

[ -p ] - Opção apenas compila para byte-codes sem gerar um 'auto interpretador'

     pric -p prog.pbrexe fontes1.prisma fontes2.prisma fontes3.prisma 

[ -a ] - Opção gera um executável sem compilar para byte-codes

Obs.: Essa opção é útil para gerar um executável a partir de um arquivo já compilado em byte-codes.

Obs.: Essa opção aceita apenas um fonte.

    pric -a prog.out prog.prisma

[ -d ] - Opção gera um executável com informações para debug

    pric -d -o prog.out prog.prisma

[ -r ] - Opção gera um executável em modo release.

Obs.: Esta opção é padrão, então nem precisa usá-la, a menos que queira deixar explícita a escolha em um arquivo make, por exemplo.

    pric -r -o prog.out prog.prisma

[ -l ] - ('L' minúsculo) Opção para ligar uma biblioteca prisma ao programa

Obs.: Esta opção aceita somente bibliotecas feitas em puro prisma, texto fonte prisma sem compilar.

Obs.: O programa não precisa mais da lib, pois ela fica embutida no executável final.

    pric -r -o prog.out prog.prisma -l pasta/mylib.pris

    pric -o prog.out prog.prisma -l pasta/minhalib.pris -l pasta/outralib.pris ...

[ -s ] - Define outro caminho para do auto interpretador a ser usado

Obs.: Muito útil para cross compilação, ligar um executável Win em ambiente Línux, vice-versa.

Obs.: O padrão é o próprio auto interpretador embutido no pric.

Em sistema Win você pode querer um programa com interface gráfica sem aparecer a janela preta do cmd.

Para isso basta usar o auto interpretador igsrprisma.exe para gerar um executável com somente interface gráfica.

     pric.exe -o prog.exe prog.prisma -s C:\Prisma\1.0\bin\igsrprisma.exe

Obs.: Troque o caminho de acordo com sua instalação Prisma.

[ -z ] - Define (shebang) um caminho para o interpretador, exemplo: -z /usr/local/bin/prisma

Para quem usa linux e está familiarizado com terminal, com certeza já deve ter visto ou até mesmo usado. Shebang é aquela primeira linha em scripts Linux, iniciando pelos caracteres #! e que indicam o caminho para o interpretador daquele script.

Um exemplo de início de um script bash:

   #!/bin/bash
   echo Iniciando processo!
   ...

Outro exemplo, usando Prisma como interpretador

   #!/usr/local/bin/prisma
   imprima("Iniciando o processo!");
   ...

Caso esteja usando Linux, ou Prisma cgi, esse recurso se torna muito útil:

      pric -p  prog.cgi prog.prisma -z /usr/local/bin/prisma

Obs.: Logicamente só faz sentido usando a opção -p para criar um arquivo em byte code, pois se gerar um executável ele não precisa de shebang, já é um executável compilado em C.

Obs.: Ao utilizar a opção -p o compilador já adiciona a shebang por padrão, logo use a opção -z apenas se mudar o caminho do interpretador da shebang.

Feito com minidoc-0.1 Linguagem Prisma