Bilingual post · Post bilíngue

Jump to: English · Português

English {#english}

CrabPascal Quick Start in Five Minutes

You do not need a full Delphi IDE to run Pascal in 2026. CrabPascal v2.22.0 is a Rust-based compiler and runtime that lets you check, run, and optionally build native executables from .dpr and .pas files — in minutes.

What you need

• Windows: download crab-pascal.exe from the latest release, or install the VS Code extension (crabpascal.crabpascal) for auto-install.
• Any OS with Rust: clone the repo and run cargo build --release.
• Optional: gcc or clang only if you want build-exe to emit a native binary.

Verify the install:

crab-pascal --version

You should see CrabPascal v2.22.0.

Your first program

Create HelloWorld.dpr:

program HelloWorld;
begin
  WriteLn('Hello from CrabPascal!');
end.

Run it immediately — no codegen step required:

crab-pascal run HelloWorld.dpr

Validate syntax and types without executing:

crab-pascal check HelloWorld.dpr

The check command runs lexing, parsing, and semantic analysis. Errors appear as file:line:column: error: message, which integrates cleanly with VS Code problem matchers.

Three commands, three workflows

For a quick sanity test, try a repo example:

cd examples/matematica
crab-pascal run matematica.dpr

Optional: native executable

If gcc is on your PATH:

crab-pascal build-exe HelloWorld.dpr --output HelloWorld.exe
./HelloWorld.exe

Without gcc, run still works through the internal runtime — zero external dependencies.

Next steps

• Add crabpascal.toml for search paths and Delphi/FPC mode.
• Install the VS Code extension for tasks and diagnostics.
• Explore examples/crud/ for a REST API with Horse.

CrabPascal releases follow versioned sprints; v2.22.0 is the current stable line. Start with run and check — you will have a working Pascal loop before your coffee gets cold.

Português {#portugus}

Início rápido com CrabPascal em cinco minutos

Você não precisa de um IDE Delphi completo para rodar Pascal em 2026. O CrabPascal v2.22.0 é um compilador e runtime escrito em Rust que permite verificar, executar e — opcionalmente — gerar executáveis nativos a partir de arquivos .dpr e .pas, em poucos minutos.

O que você precisa

• Windows: baixe crab-pascal.exe do release mais recente, ou instale a extensão VS Code (crabpascal.crabpascal) com auto-instalação.
• Qualquer SO com Rust: clone o repositório e execute cargo build --release.
• Opcional: gcc ou clang apenas se quiser usar build-exe para gerar binário nativo.

Confirme a instalação:

crab-pascal --version

A saída esperada inclui CrabPascal v2.22.0.

Seu primeiro programa

Crie HelloWorld.dpr:

program HelloWorld;
begin
  WriteLn('Hello from CrabPascal!');
end.

Execute imediatamente — sem etapa de codegen:

crab-pascal run HelloWorld.dpr

Valide sintaxe e tipos sem executar:

crab-pascal check HelloWorld.dpr

O comando check executa análise léxica, parsing e semântica. Erros aparecem no formato arquivo:linha:coluna: error: mensagem, compatível com problem matchers do VS Code.

Três comandos, três fluxos

Para um teste rápido, use um exemplo do repositório:

cd examples/matematica
crab-pascal run matematica.dpr

Opcional: executável nativo

Se o gcc estiver no PATH:

crab-pascal build-exe HelloWorld.dpr --output HelloWorld.exe
./HelloWorld.exe

Sem gcc, o run continua funcionando via runtime interno — zero dependências externas.

Próximos passos

• Adicione crabpascal.toml para search paths e modo Delphi/FPC.
• Instale a extensão VS Code para tasks e diagnósticos.
• Explore examples/crud/ para uma API REST com Horse.

O CrabPascal evolui em sprints versionados; v2.22.0 é a linha estável atual. Comece com run e check — você terá um loop Pascal funcionando antes do café esfriar.

Published on dev.to/@crabpascal · Código em CrabPascal