DEV Community: CrabPascal

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

CrabPascal — Tue, 02 Jun 2026 12:27:00 +0000

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

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

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

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

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

Introducing CrabPascal — Pascal with Rust Claws 🦀 | Apresentando o CrabPascal

CrabPascal — Sun, 31 May 2026 18:17:31 +0000

Bilingual post · Post bilíngue

Jump to: English · Português

English {#english}

Introducing CrabPascal

CrabPascal is an open-source Pascal compiler and runtime written in Rust. It targets developers who work with Delphi and Free Pascal and want a modern toolchain: fast feedback, a real CLI, VS Code / Cursor integration, and enough language parity to run real-world examples — without installing a full Delphi IDE.

Current version: v2.22.0.

Why another Pascal compiler?

Delphi and FPC are mature, but they can feel heavy for quick experiments, CI pipelines, or teaching. CrabPascal focuses on:

Fast compile-check loop — crab-pascal check with real line/column diagnostics
Run without codegen — interpreter/runtime for rapid iteration
Optional native build — build-exe emits C and compiles with gcc/clang
Modern RTL shims — System.*, generics collections, classes, exceptions (in progress by sprint)
Zero Delphi license — MIT, Rust toolchain only

Hello, world

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

crab-pascal run HelloWorld.dpr
crab-pascal check HelloWorld.dpr

REST API in Pascal (Horse)

CrabPascal ships examples using Horse, a popular Delphi HTTP framework:

program SimpleAPI;
uses Horse, System.JSON;

begin
  THorse.Get('/ping',
    procedure(Req: THorseRequest; Res: THorseResponse; Next: TNextProc)
    var J: TJSONObject;
    begin
      J := TJSONObject.Create;
      J.AddPair('message', 'pong');
      Res.Send(J.ToJSON);
    end);

  THorse.Listen(9000);
end.

Run it, then curl http://localhost:9000/ping — real HTTP, real JSON.

Tooling

Command	Purpose
`check`	Lex + parse + semantic analysis
`run`	Execute via internal runtime
`build-exe`	Generate C + native binary
`preproc`	Handle `{$IFDEF}` directives

There is also a VS Code / Cursor extension (crabpascal.crabpascal) with problem matchers, tasks, and optional auto-install of the compiler binary on Windows.

Project status (2026)

CrabPascal is actively developed in versioned sprints (roughly one release per sprint). Recent focus areas:

Real diagnostic spans
System.* namespaces and RTL coverage
OOP: classes, properties, exceptions
Delphi-style strings and Unicode
Generics (TList<T>, TDictionary<K,V>)
Parser hardening and honest build-exe parity with run

It is not a drop-in replacement for Delphi yet — but it is already useful for learning, prototyping, and running curated examples from the repo.

Get involved

Repository: bitbucket.org/alphatecnologia/crabpascal
Dev.to: @crabpascal
Issues, examples, and docs welcome

More deep-dive articles coming soon: generics, the runtime model, and how we approach Delphi compatibility sprint by sprint.

Português {#portugus}

Apresentando o CrabPascal

O CrabPascal é um compilador e runtime Pascal open source escrito em Rust. Ele mira quem trabalha com Delphi e Free Pascal e quer uma toolchain moderna: feedback rápido, CLI de verdade, integração com VS Code / Cursor e paridade suficiente para rodar exemplos reais — sem instalar um IDE Delphi completo.

Versão atual: v2.22.0.

Por que outro compilador Pascal?

Delphi e FPC são maduros, mas podem ser pesados para experimentos rápidos, pipelines de CI ou ensino. O CrabPascal foca em:

Loop rápido de verificação — crab-pascal check com diagnósticos reais (linha/coluna)
Executar sem codegen — interpretador/runtime para iterar rápido
Build nativo opcional — build-exe gera C e compila com gcc/clang
RTL moderno — shims System.*, generics collections, classes, exceptions (evoluindo por sprint)
Sem licença Delphi — MIT, só precisa do toolchain Rust

Hello, world

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

crab-pascal run HelloWorld.dpr
crab-pascal check HelloWorld.dpr

API REST em Pascal (Horse)

O CrabPascal inclui exemplos com Horse, framework HTTP popular no ecossistema Delphi:

program SimpleAPI;
uses Horse, System.JSON;

begin
  THorse.Get('/ping',
    procedure(Req: THorseRequest; Res: THorseResponse; Next: TNextProc)
    var J: TJSONObject;
    begin
      J := TJSONObject.Create;
      J.AddPair('message', 'pong');
      Res.Send(J.ToJSON);
    end);

  THorse.Listen(9000);
end.

Execute e teste com curl http://localhost:9000/ping — HTTP e JSON de verdade.

Ferramentas

Comando	Função
`check`	Lex + parse + análise semântica
`run`	Executa via runtime interno
`build-exe`	Gera C + binário nativo
`preproc`	Trata diretivas `{$IFDEF}`

Há também extensão para VS Code / Cursor (crabpascal.crabpascal) com problem matcher, tasks e auto-instalação opcional do binário no Windows.

Status do projeto (2026)

O CrabPascal evolui em sprints versionadas (cerca de uma release por sprint). Focos recentes:

Spans reais nos diagnósticos
Namespaces System.* e cobertura da RTL
OOP: classes, properties, exceptions
Strings estilo Delphi e Unicode
Generics (TList<T>, TDictionary<K,V>)
Parser mais robusto e paridade honesta entre run e build-exe

Ainda não substitui o Delphi por completo — mas já serve para aprender, prototipar e rodar os exemplos curados do repositório.

Participe

Repositório: bitbucket.org/alphatecnologia/crabpascal
Dev.to: @crabpascal
Issues, exemplos e docs são bem-vindos

Em breve: artigos sobre generics, modelo de runtime e como abordamos compatibilidade com Delphi sprint a sprint.

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