README

ModernSyntax — Functional-Programming Toolkit for Delphi

🔒 Supply-chain transparency (CRA-ready): a machine-readable SBOM (CycloneDX) is published on the package portal — pubpascal.dev/packages/modernsyntax · security disclosure policy in SECURITY.md.

📚 Documentation · ⬇️ Download · 🐛 Issues

• 🇬🇧 English
• 🇧🇷 Português

🇬🇧 English

ModernSyntax is a high-performance, lightweight functional-programming and modern-syntax extension toolkit for Delphi. It modernizes Delphi coding paradigms, bringing them on par with advanced features found in contemporary languages such as Rust, Kotlin, C#, and Haskell. Designed to bridge native Pascal syntax limitations, ModernSyntax introduces safe optional types (TOption<T>) to prevent null-reference errors, functional error flows (TResultPair<S,F>), advanced pattern matching (TMatch<T>), asynchronous task scheduling, and currying.

🚀 Key Features

• Null Safety (TOption<T>): Enforces strict compile-time or runtime handling of optional values, preventing common Access Violations (null-pointer exceptions) in the style of Rust or Haskell.
• Functional Error Handling (TResultPair<S, F>): Replaces untracked exceptions with a clean, functional success/failure return type.
• Pattern Matching (TMatch<T>): Expressive, type-safe matching structures to completely replace nested if-else or convoluted case statements.
• Simplified Asynchrony (TScheduler): Easily schedule background tasks with an async/await-style wrapper, without manual thread synchronization.
• Tuples & Destructuring (TTuple<T>): Create lightweight, anonymous data structures (e.g., (1, 'a', True)) with direct value extraction.
• Currying (TCurrying): Introduces functional partial applications, bringing Scala and Haskell functional-programming paradigms directly to Delphi.

🏛 Compatibility Matrix

🐧 Cross-Platform Build — Win32 / Win64 / Linux64 (verified)

✅ Verified 2026-06-20 in a real production backend: ModernSyntax compiles as a dependency on Win32, Win64 and Linux64 (dcclinux64). macOS/iOS/Android follow from the Delphi RTL but are not build-verified here yet.

Windows-only APIs are guarded for non-Windows targets: TDotEnv uses a POSIX setenv/unsetenv shim (Posix.Stdlib) instead of SetEnvironmentVariable; OutputDebugString falls back to stderr; InterlockedIncrement64 is replaced by the cross-platform AtomicIncrement intrinsic; bare uses Windows clauses are {$IFDEF MSWINDOWS}-guarded. Windows behaviour is unchanged.

Building a consumer app for Linux64: install the Linux 64-bit platform (RAD Studio GetIt / GetItCmd -if=delphi_linux -ae), provide a Linux SDK (RAD Studio SDK Manager + PAServer, or a sysroot assembled from a WSL/Linux toolchain passed to dcclinux64 via --syslibroot / --libpath), then compile with dcclinux64.

⚙️ Installation

Boss (recommended):

boss install ModernSyntax

PubPascal (CRA-ready registry):

pubpascal install modernsyntax

Or browse the package page at pubpascal.dev/packages/modernsyntax.

⚡️ Quick Start

1. Null Safety (TOption<T>)

uses
  ModernSyntax.Option;

var
  LName: TOption<string>;
begin
  // Create an optional value
  LName := TOption<string>.Some('Isaque');

  if LName.HasValue then
    WriteLn('Value: ' + LName.Value)
  else
    WriteLn('No value found.');

  // Safe default fallback
  WriteLn(LName.ValueOrElse('Default Name'));
end;

2. Pattern Matching (TMatch<T>)

uses
  ModernSyntax.Match;

var
  LInput: Integer;
  LMessage: string;
begin
  LInput := 2;

  LMessage := TMatch<Integer>.Create(LInput)
    .CaseOf(1, 'First place!')
    .CaseOf(2, 'Second place!')
    .CaseOf(3, 'Third place!')
    .ElseOf('Runner up.')
    .MatchValue;

  // LMessage = 'Second place!'
end;

3. Functional Results (TResultPair<S, F>)

uses
  ModernSyntax.ResultPair;

function Divide(const A, B: Double): TResultPair<Double, string>;
begin
  if B = 0 then
    Result := TResultPair<Double, string>.Failure('Division by zero!')
  else
    Result := TResultPair<Double, string>.Success(A / B);
end;

🇧🇷 Português

ModernSyntax é um kit de ferramentas leve e de alta performance para programação funcional e extensão de sintaxe moderna em Delphi. Ele moderniza os paradigmas de codificação do Delphi, trazendo-os para o mesmo nível de recursos encontrados em linguagens contemporâneas avançadas como Rust, Kotlin, C# e Haskell. Desenvolvido para superar limitações da sintaxe nativa do Pascal, o ModernSyntax introduz tipos opcionais seguros (TOption<T>) para evitar erros de referência nula, fluxo de erros funcional (TResultPair<S,F>), pattern matching avançado (TMatch<T>), agendamento assíncrono de tarefas e currying.

🚀 Recursos Principais

• Null Safety (TOption<T>): Impõe a manipulação estrita e segura de valores opcionais, prevenindo exceções clássicas de Access Violation (ponteiro nulo) ao estilo de Rust ou Haskell.
• Tratamento de Erros Funcional (TResultPair<S, F>): Substitui exceções desorganizadas por um tipo limpo e funcional de sucesso/falha no retorno de métodos.
• Pattern Matching (TMatch<T>): Estruturas condicionais expressivas e fortemente tipadas para substituir cadeias complexas de if-else ou blocos case limitados.
• Assincronia Simplificada (TScheduler): Agende e gerencie tarefas assíncronas ao estilo async/await sem a complexidade de sincronização manual de threads.
• Tuplas & Desestruturação (TTuple<T>): Cria estruturas leves de dados anônimos (ex.: (1, 'a', True)) com extração direta de valores.
• Currying (TCurrying): Introduz a aplicação parcial de funções, trazendo paradigmas de linguagens como Scala ou Haskell diretamente ao Delphi.

🏛 Matriz de Compatibilidade

🐧 Build Multiplataforma — Win32 / Win64 / Linux64 (verificado)

✅ Verificado em 2026-06-20 num backend real em produção: o ModernSyntax compila como dependência em Win32, Win64 e Linux64 (dcclinux64). macOS/iOS/Android seguem da RTL Delphi, mas ainda não foram verificados em build aqui.

APIs Windows-only ficam guardadas para alvos não-Windows: o TDotEnv usa um shim POSIX setenv/unsetenv (Posix.Stdlib) no lugar de SetEnvironmentVariable; OutputDebugString cai para stderr; InterlockedIncrement64 vira o intrínseco multiplataforma AtomicIncrement; cláusulas uses Windows ficam sob {$IFDEF MSWINDOWS}. O comportamento no Windows não muda.

Para buildar um app consumidor no Linux64: instale a plataforma Linux 64-bit (RAD Studio GetIt / GetItCmd -if=delphi_linux -ae), forneça um SDK Linux (SDK Manager do RAD Studio + PAServer, ou um sysroot montado de um toolchain WSL/Linux passado ao dcclinux64 via --syslibroot / --libpath), e compile com dcclinux64.

⚙️ Instalação

Boss (recomendado):

boss install ModernSyntax

PubPascal (registro CRA-ready):

pubpascal install modernsyntax

Ou acesse a página do pacote em pubpascal.dev/packages/modernsyntax.

⚡️ Início Rápido

1. Null Safety (TOption<T>)

uses
  ModernSyntax.Option;

var
  LName: TOption<string>;
begin
  // Cria um valor opcional
  LName := TOption<string>.Some('Isaque');

  if LName.HasValue then
    WriteLn('Valor: ' + LName.Value)
  else
    WriteLn('Nenhum valor encontrado.');

  // Valor padrão de fallback caso seja nulo
  WriteLn(LName.ValueOrElse('Nome Padrão'));
end;

2. Pattern Matching (TMatch<T>)

uses
  ModernSyntax.Match;

var
  LInput: Integer;
  LMessage: string;
begin
  LInput := 2;

  LMessage := TMatch<Integer>.Create(LInput)
    .CaseOf(1, 'Primeiro lugar!')
    .CaseOf(2, 'Segundo lugar!')
    .CaseOf(3, 'Terceiro lugar!')
    .ElseOf('Participante.')
    .MatchValue;

  // LMessage = 'Segundo lugar!'
end;

3. Resultados Funcionais (TResultPair<S, F>)

uses
  ModernSyntax.ResultPair;

function Dividir(const A, B: Double): TResultPair<Double, string>;
begin
  if B = 0 then
    Result := TResultPair<Double, string>.Failure('Divisão por zero!')
  else
    Result := TResultPair<Double, string>.Success(A / B);
end;

⛏️ Contributing/Contribuição

Contributions are welcome — bug reports, new features, doc improvements, or translations. Contribuições são bem-vindas — relatórios de bugs, novas funcionalidades, melhorias na documentação ou traduções.

Steps / Passos:

1. Fork the repository / Faça um fork do repositório.
2. Create a feature branch: git checkout -b feat/your-feature / Crie uma branch: git checkout -b feat/sua-feature.
3. Commit your changes with a descriptive message / Faça commits com mensagens descritivas.
4. Open a Pull Request targeting main / Abra um Pull Request para main.
5. Wait for review and address feedback / Aguarde a revisão e responda ao feedback.

📬 Contact / Contato

💲 Donation / Doação

If this library saves you time, consider supporting its development. Se esta biblioteca economiza o seu tempo, considere apoiar o desenvolvimento.

📄 License / Licença

Released under the MIT License. Distribuído sob a Licença MIT.

Copyright © 2025-2026 Isaque Pinheiro.