DEV Community

CrabPascal
CrabPascal

Posted on

CrabPascal Quick Start in Five Minutes | Início rápido em cinco minutos

#pascal #compiler #rust #tutorial

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
Enter fullscreen mode Exit fullscreen mode

You should see CrabPascal v2.22.0.

Your first program

Create HelloWorld.dpr:

program HelloWorld;
begin
  WriteLn('Hello from CrabPascal!');
end.
Enter fullscreen mode Exit fullscreen mode

Run it immediately — no codegen step required:

crab-pascal run HelloWorld.dpr
Enter fullscreen mode Exit fullscreen mode

Validate syntax and types without executing:

crab-pascal check HelloWorld.dpr
Enter fullscreen mode Exit fullscreen mode

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

Command When to use
check CI, pre-commit, fast feedback while editing
run Prototyping, examples, Horse HTTP servers
build-exe Shipping a standalone .exe via C + gcc

For a quick sanity test, try a repo example:

cd examples/matematica
crab-pascal run matematica.dpr
Enter fullscreen mode Exit fullscreen mode

Optional: native executable

If gcc is on your PATH:

crab-pascal build-exe HelloWorld.dpr --output HelloWorld.exe
./HelloWorld.exe
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

A saída esperada inclui CrabPascal v2.22.0.

Seu primeiro programa

Crie HelloWorld.dpr:

program HelloWorld;
begin
  WriteLn('Hello from CrabPascal!');
end.
Enter fullscreen mode Exit fullscreen mode

Execute imediatamente — sem etapa de codegen:

crab-pascal run HelloWorld.dpr
Enter fullscreen mode Exit fullscreen mode

Valide sintaxe e tipos sem executar:

crab-pascal check HelloWorld.dpr
Enter fullscreen mode Exit fullscreen mode

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

Comando Quando usar
check CI, pre-commit, feedback rápido ao editar
run Prototipagem, exemplos, servidores Horse HTTP
build-exe Distribuir um .exe standalone via C + gcc

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

cd examples/matematica
crab-pascal run matematica.dpr
Enter fullscreen mode Exit fullscreen mode

Opcional: executável nativo

Se o gcc estiver no PATH:

crab-pascal build-exe HelloWorld.dpr --output HelloWorld.exe
./HelloWorld.exe
Enter fullscreen mode Exit fullscreen mode

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

Top comments (0)