Odisseia Language

Official Visual Studio Code extension for Odisseia. It provides editing, diagnostics, formatting, compilation, execution, REPL, visual debugging and the bilingual Odisseia Configurator for English and Portuguese users.

Use Odisseia: Open Configurator from the Command Palette to edit the runtime configuration, environment-variable references and interface language.

Português

Teste de programas hospedados

Use Odisseia: Create test context para criar um arquivo .odistest.json ao lado do programa. Depois, defina breakpoints e execute Odisseia: Debug with test context ou pressione F5. O Debug Console apresenta a resposta capturada.

O arquivo deve usar o mesmo nome-base do programa. Por exemplo, get-order.odis utiliza automaticamente get-order.odistest.json. Também é possível informar outro arquivo no campo testContext do .vscode/launch.json.

Testes nativos

Arquivos *.test.odis exibem Run Test e Debug Test acima de cada declaração test. O primeiro executa somente o caso selecionado pela CLI; o segundo inicia o DAP com testName, preservando breakpoints em setup, teste, units e teardown. Uma configuração de debug cujo program aponta para *.test.odis e omite testName executa a suíte completa. O Debug Console mostra PASS/FAIL, mensagens de erro e o resumo. Breakpoints em qualquer caso permanecem ativos durante a suíte. Para categorias externas (integration, slow, native e network), a extensão solicita um config.json. A CLI e o DAP usam os providers, permissões e limites dessa configuração; sem seleção explícita, o teste externo não é iniciado.

A unit Testing fornece TAssert, TTestClock, TTestProgram e TTestProgramResponse. Eles são tipos nativos, não palavras reservadas. A extensão reconhece esses nomes no LSP e no realce de sintaxe. Credenciais de integração vêm de variáveis de ambiente referenciadas pelo config.json local e não são enviadas à plataforma.

Extensão oficial da linguagem Odisseia para Visual Studio Code.

O pacote oferece edição de .odis, realce de sintaxe, snippets, formatação, diagnósticos em memória, completion, hover, ajuda de assinatura, navegação entre símbolos, rename, compilação para .odisc, execução, REPL e depuração visual.

Ferramentas incluídas

A distribuição pode incluir os executáveis adequados à plataforma:

• odisseia: CLI principal, verificação, execução, testes e REPL;
• odisseia-compiler: compilação para bytecode .odisc;
• odisseia-vm: execução portátil do bytecode;
• odisseia-lsp: diagnósticos e recursos inteligentes do editor;
• odisseia-debug: adaptador de depuração;
• odisseia-ffi-worker: isolamento de integrações nativas;
• odisseia-config: configurador visual com interface em português e inglês.

O debugger oferece breakpoints, navegação pela pilha, inspeção segura de variáveis, rotinas concorrentes como threads DAP e visualização estruturada de objetos. A extensão salva o arquivo antes dos comandos quando essa opção está habilitada e preserva o alinhamento entre código-fonte e bytecode.

Recursos da linguagem

O editor reconhece a sintaxe inspirada em Pascal, units, exceções tipadas, classes da biblioteca padrão, concorrência estruturada, canais, diretivas, arquivos e diretórios virtuais, datas e horas, JSON, XML, HTTP, bancos de dados, Redis, MQTT, MCP, criptografia e chamadas nativas pela ABI C.

Completion, hover e assinaturas são fornecidos pelo Odisseia Language Server. Os comandos usam criação direta de processos, limites configuráveis de captura e tratamento seguro de informações sensíveis.

Configuração

Normalmente os executáveis incluídos no VSIX são usados automaticamente. Para uma instalação de desenvolvimento, podem ser informados caminhos alternativos em:

• odisseia.executablePath;
• odisseia.lsp.executablePath;
• odisseia.debug.executablePath.
• odisseia.config.executablePath.

Também é possível controlar salvamento antes dos comandos, exibição do canal de saída, limite de saída e frequência dos diagnósticos.

Comandos

Pela Command Palette estão disponíveis comandos para verificar, executar, executar com configuração, abrir o REPL, compilar, desassemblar bytecode, formatar, iniciar servidores MCP e reiniciar o Language Server. O comando Odisseia: Open Configurator abre o configurador visual incluído no pacote.

Desenvolvimento e validação

Abra editors/vscode no VS Code e use a configuração de execução da extensão. A estrutura do produto pode ser validada com:

powershell.exe -ExecutionPolicy Bypass -File scripts\validate-extension.ps1

Para gerar o VSIX, compile antes os executáveis Odisseia da plataforma e execute:

powershell.exe -ExecutionPolicy Bypass -File scripts\build-vsix.ps1 `
  -TargetPlatform win32-x64 `
  -BinDirectory C:\caminho\para\bin

No macOS ou Linux, o empacotador Node.js usa o utilitario zip e dispensa PowerShell. A partir da raiz do repositorio, com os executaveis em ../bin:

node editors/vscode/scripts/build-vsix.mjs darwin-arm64 ../bin ../vsix

Use darwin-x64, linux-x64 ou linux-arm64 para os demais destinos, sempre com os executaveis correspondentes. O pacote inclui CLI, compilador, VM, LSP, debugger, configurador e FFI worker; bibliotecas externas devem ser instaladas separadamente.

Odisseia Language é uma ferramenta independente da linguagem. Ela não registra editores de workflow, Business Logic nem funcionalidades específicas de plataformas de automação.