Seu primeiro projeto Arandu

Bem-vindo. Em poucos minutos, você vai criar um projeto de verdade, validar o código com o CLI e executar o programa. Depois, o tour mostra como a linguagem mantém posse, erros e diagnósticos sob controle.

Instalação

Instale o Arandu e confirme que o comando está disponível:

curl -sSf https://arandu.dev/install | sh
arandu --version
Dica

Se algo não funcionar no ambiente, rode arandu doctor. Ele verifica a instalação e aponta o que precisa ser ajustado.

Crie um projeto

O CLI já prepara a estrutura inicial para você. Crie um projeto e entre na pasta:

arandu new hello_arandu
cd hello_arandu

arandu.toml identifica o projeto e src/main.aru é a entrada padrão. Abra esse arquivo para ver o programa inicial:

module my_app

import io

func main(): int {
    io.println("Olá, Arandu!")
    return 0
}

Valide, execute e compile

O fluxo diário começa com check: ele encontra erros sem executar o programa. Depois, use run para executar e build para gerar o binário nativo:

arandu check
arandu run
arandu build

Você deve ver Olá, Arandu! ao executar o projeto. Se preferir testar um arquivo isolado, o CLI também aceita arandu check caminho/arquivo.aru e arandu run caminho/arquivo.aru.

Garantia

main retorna um código inteiro: 0 indica que o programa terminou normalmente. O compilador valida essa assinatura antes da execução.

O que você acabou de usar

  • Projeto reproduzível — configuração, entrada e dependências ficam organizadas no diretório do projeto.
  • CLI com feedback rápido — check separa validação de execução e doctor ajuda a investigar o ambiente.
  • Compilação nativa — build transforma o projeto em um binário para distribuição.

Agora você pode seguir para o tour e aprender posse linear, Result e os diagnósticos que explicam como corrigir o código.