Documentação — Cafezinho

Introdução

A Cafezinho é uma linguagem de programação interpretada, escrita em português brasileiro, criada para ensino real de lógica, programação e robótica — sem simulações falsas.

Ela possui lexer, parser, AST, runtime próprio, sistema de módulos, biblioteca padrão, IDE gráfica e integração direta com hardware.

Instalação

A Cafezinho é distribuída como executável único.

caf programa.caf

Sintaxe básica

escreva("Olá, mundo");

Variáveis

defina idade = 16;
defina nome = "Cafezinho";

Controle de fluxo

se (idade >= 18) {
    escreva("Maior");
} senao {
    escreva("Menor");
}

enquanto (contador < 10) {
    escreva(contador);
    contador = contador + 1;
}

Funções

defina soma = funcao(a, b) {
    retorne a + b;
};

Listas e dicionários

defina numeros = [1, 2, 3];
defina pessoa = {
    "nome": "Ana",
    "idade": 20
};

Módulos padrão

matematica
texto
lista
dicionario
tempo
sistema
arquivo
rede
json
robotica

Robótica integrada

A Cafezinho possui um sistema unificado de robótica que permite escrever um único código e executar em:

Simulador educacional
Arduino (C++ gerado automaticamente)
micro:bit (MicroPython gerado automaticamente)

Configuração da plataforma

robotica.configurar("arduino");

LED

robotica.led.ligar(13);
robotica.led.desligar(13);

Servo motor

robotica.servo.mover(9, 90);

Sensores

defina valor = robotica.sensor.analogico(0);
escreva(valor);

Padaria

A Padaria é o sistema oficial de bibliotecas da Cafezinho, com compartilhamento real de código.

caf padaria criar util.caf
caf padaria pedir sensores

Erros

Erros são objetos reais e interrompem a execução.

ERRO: divisão por zero

Boas práticas

Use ponto e vírgula
Separe código em arquivos
Use módulos e Padaria
Escreva código legível