Inliner

inliner_logo

O Inliner é uma ferramenta escrita em Python 3.x que converte programas em BASIC escritos de “um jeito indentado” para o velho estilo de linhas numeradas; seu objetivo é facilitar a programação em computadores clássicos ao abstrair a numeração de linhas, estimular o uso de comentários, melhorar a visibilidade no código e também sua manutenção de definições que funcionam para armazenar determinados valores ou mesmo pequenas macros.

Como usar

Basicamente edite o programa no editor de textos de sua preferência tomando os seguintes cuidados:

  • Coloque cada comando BASIC em uma linha de texto, o Inliner os agrupará em uma mesma linha de programa (numerada);
  • Insira uma linha em branco entre os comandos para que a ferramenta crie uma nova linha de programa;
  • Comentários com um apóstrofo serão descartados enquanto que com dois (ou “REM”) gerarão uma linha de programa;
  • Rótulos são definidos em uma única linha terminada com dois pontos e referenciados entre chaves duplas (“{{ … }}”);
  • Use uma barra invertida (“\”) no começo para indicar que uma linha de texto é continuação da linha anterior e
  • Crie definições usando um tipo especial de comentário com ‘ define «NOME» «valor» e referenciadas como se fossem rótulos com chaves duplas.

Os parâmetros do Inliner são “- -start” para indicar a linha inicial, “- -step” para definir o incremento entre linhas, “- -upper” para colocar todos os comandos em caixa alta (essencial em alguns interpretadores) e “- -rem”¹  para utilizar o comando do “rem” do BASIC ao invés do caractere de apóstrofo nos comentários.

(¹) Nas primeiras versões existiu o parâmetro “- -REM” para utilizar o comando rem em caixa alta mas com a introdução do parâmetro “- -upper” ele deixou de fazer sentido. Sua funcionalidade pode ser conseguida utilizado conjuntamente os parâmetros “- -rem” e “- – upper”.

Instalação

Clone o repositório Git, ou baixe os arquivos do programa, e faça:

$ pip install -r requirements.txt

Para instalar as dependências das bibliotecas usadas pelo Inliner. Se preferir você pode configurá-lo para trabalhar em um ambiente virtual.

Uso

O Inliner é uma ferramenta de linha de comando, use:

$ inliner --help
Inliner 1.0-3
A tool that converts indented BASIC programs into line numbered style.

Copyright (C) 2017 by Giovanni Nunes <giovanni.nunes@gmail.com>

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.

Usage:
 inliner <filename> [ --start=<line> --step=<value> --upper --rem ]
 inliner --help

Options:
 --help Show this screen.
 --rem Use the REM statement istead of the apostrophe.
 --upper Put all BASIC statements in uppercase.

Para exibir uma lista dos parâmetros dele.

Anúncios