The Open John Language (oJl)

Versão: betaV0.1 | Documentação: oJl Biblie V0.1 PT-BR

Escrito Por: João Victor

I.0 - Introdução

Olá querido(a) leitor(a),
Desde já agradeço por você estar lendo essa documentação! Se você está aqui significa que você decidiu testar o JL, ou simplesmente conhecer meu projeto. Isso é um grande motivo para eu me alegrar. Obrigado!

I.1 - O que é a oJl?

oJl (Open John Language) é uma linguagem de programação desenvolvida com o propósito de ser clara, simples e acessível. Sua sintaxe foi projetada para se aproximar de uma linguagem natural, facilitando a leitura e compreensão do código, o que a torna adequada tanto para iniciantes quanto para desenvolvedores experientes que buscam produtividade.

Como seu nome diz oJl é um projeto de código aberto, sinta-se à vontade para modificar estudar a fundo como o projeto funciona.

O principal objetivo da oJl é ser intuitiva e funcional, sem abrir mão da eficiência. Trata-se de um projeto experimental em constante evolução, com a meta de oferecer uma alternativa viável e amigável no ecossistema de linguagens de programação.

I.2 - Porque eu criei a oJl?

As linguagens de programação são ferramentas fundamentais que nos permitem nos comunicar com as máquinas desde o século XX. A oJl nasceu do propósito de ser acolhedora, simples e funcional, permitindo que projetos complexos possam ser desenvolvidos de forma clara e acessível.

A criação da oJl também surgiu de uma motivação pessoal: o desejo de construir algo que tivesse identidade própria e pudesse ser reconhecido. Mesmo que venha a ser lembrada como uma linguagem “diferente” ou até “estranha”, para mim, o mais importante é que ela carregue personalidade e significado.

I.3 - Objetivos da linguagem

A oJl foi projetada para ter um foco geral, podendo ser utilizada em diferentes tipos de projetos, desde os mais simples até aplicações mais complexas. Sua proposta de ser uma linguagem aberta e flexível permite que qualquer pessoa adapte, expanda e crie novas versões de acordo com suas próprias necessidades e objetivos.

P.0 - Primeiros Passos

P.1 - Como Instalar?

A instalação da JL é rápida e simples. Como a JL foi desenvolvida em Python, é necessário ter o Python instalado em sua máquina.

  1. Baixe o interpretador: Faça o download do arquivo ojlreader.py.
  2. Crie seu arquivo JL: Crie um arquivo com a extensão .ojl (por exemplo: meu_codigo.ojl).
  3. Execute seu programa: Para rodar o arquivo, basta abrir o interpretador com o Python, passando o arquivo como argumento:
python3 ojlreader.py meu_codigo.ojl
Também não posso ignorar o fato de que executar programas escritos em oJl é um processo chato, irei começar a trabalhar em uma IDE, para que seja algo mais fácil de se trabalhar.

P.2 - Requisitos do sistema

P.3 - Seu primeiro programa

O clássico “Hello, World!” em oJl.

1. Crie o arquivo hello.ojl.

2. Escreva o código:

say "Hello, World!";

3. Execute no terminal:

python3 lexer.py hello.ojl

O comando say é responsável por exibir mensagens, semelhante ao print em outras linguagens.

M.0 - O Manual

M.1 - Sintaxe

A sintaxe da oJl busca ser simples, e compreensível, se assemelhando como se fosse uma conversa. A sintaxe da oJl foi evoluindo com o tempo para ficar mais “clean” e menos assustadora.

Por curiosidade vou mostrar a evolução da sintaxe da linguagem. Antes oJl funcionava com blocos, aqui vai um simples “Hello World” antigo:
when_tcs{ say = “Hello World” }

M.2 - A bíblia oJl

M.2.1. Comentários

Qualquer texto após um ! é um comentário.

! Este é um comentário.
var nome = "John"; ! Isto também.

M.2.2. Variáveis

Use var para declarar e $ para usar.

! Declarando
var mensagem = "Olá, mundo!";
var idade = 25;

! Usando
say $mensagem;

M.2.3. Comando `say` (Saída)

Usado para imprimir valores na tela.

say "Este é um texto literal.";
say $idade;

M.2.4. Comando `calc` (Cálculos)

Realiza uma operação matemática e armazena o resultado. A sintaxe é calc [expressão] -> [variável_destino];.

var x = 10;
var y = 5;
var resultado = 0;

calc x + y -> resultado; ! resultado agora contém 15
say $resultado;

M.2.5. Estruturas de Controle (Comando `if`)

Executa um bloco de código se uma condição for verdadeira. Tudo em uma única linha.

var nota = 10;
if $nota = 10 (say "Parabéns, nota máxima!";);

M.2.6. Funções

Agrupa código para ser reutilizado. Tudo em uma única linha.

! Definição
f saudacao (say "Olá!";say "Bem-vindo à OJL!";);

! Chamada
f saudacao;

M.3 - Precisa de ajuda?

Encontrou algum erro? Quer dizer alguma sugestão? Preencha o formulário: Diga aqui.

F.0 - Considerações finais

Chegamos ao fim dessa documentação. Fico feliz em saber que você chegou até esse ponto, espero que essa documentação por mais simples que seja possa ser útil para você. Nos acompanhe no GitHub para mais informações.

Obrigado! ;D

oJl é um projeto de código aberto criado por João Victor.
Página do Projeto no GitHub | Meu Perfil no GitHub