Primeiros Passos

Novo por aqui? Leia primeiro a Introdução se você quer entender por que o Zolo existe — o vácuo no ecossistema Lua, os 6 pilares e onde ele se encaixa. Esta página é sobre rodar código.

O Zolo compila pra Lua 5.1 bytecode puro, então o mesmo .zolo que você escreve roda em qualquer host Lua (Roblox, Neovim, Redis, OpenResty, GMod…), e ainda tem alvos nativo (Cranelift) e WASM quando não há host. Vamos colocar um programa pra rodar.

Instalação¶

Compilar a partir do código-fonte:

cargo build --release

O binário estará em target/release/zolo (ou target/release/zolo.exe no Windows).

Hello World¶

Crie um arquivo hello.zolo:

fn main() {
    print("Hello, Zolo!")
}

main()

Execute-o:

zolo run hello.zolo

Comandos CLI¶

Comando	Descrição
`zolo run <file>`	Compilar e executar um arquivo `.zolo`
`zolo <file>`	Atalho para `zolo run`
`zolo compile <file>`	Exibir o código Lua gerado
`zolo check <file>`	Analisar e verificar tipos sem executar
`zolo test [file...]`	Executar funções `@test`
`zolo fmt [--check] <file>`	Formatar o código-fonte
`zolo repl`	REPL interativo
`zolo version`	Exibir a versão
`zolo help`	Exibir ajuda

Opções de Teste¶

zolo test tests.zolo                # executar todas as funções @test
zolo test tests.zolo --filter fib   # apenas testes que correspondam a "fib"
zolo test tests.zolo --list         # listar nomes dos testes sem executar

Estrutura de Projeto¶

Um projeto Zolo típico:

my-project/
  src/
    main.zolo       # ponto de entrada
    lib.zolo        # módulo de biblioteca
    utils.zolo      # utilitários
  examples/
    hello.zolo
  tests/
    test_math.zolo

Próximos Passos¶

Siga em ordem: