Odisseia Language

Extensão oficial da linguagem de programação Odisseia para Visual Studio Code. Ela reúne as ferramentas necessárias para escrever, analisar, executar, testar e depurar aplicações Odisseia sem sair do editor.

Odisseia é uma linguagem de propósito geral com sintaxe clara e familiar, inspirada em Pascal. Foi projetada para aplicações de longa duração, automações, serviços, processamento de dados, integração entre sistemas e software que precisa combinar produtividade, segurança e desempenho.

Recursos da extensão

• reconhecimento de arquivos-fonte .odis e bytecode compilado .odisc;
• destaque de sintaxe e tema Odisseia Dark;
• snippets para estruturas frequentes da linguagem;
• diagnósticos durante a edição e ao salvar o arquivo;
• formatação de código integrada ao Visual Studio Code;
• navegação por símbolos, definições e referências;
• ajuda contextual, sugestões e renomeação de símbolos;
• compilação de código-fonte para bytecode portátil .odisc;
• execução direta de arquivos .odis e .odisc;
• visualização e desmontagem das instruções do bytecode;
• depuração com breakpoints, execução passo a passo e inspeção de variáveis;
• terminal REPL para experimentação interativa;
• integração com tarefas e configurações de execução do Visual Studio Code;
• execução de testes declarados no próprio código;
• Language Server e adaptador de depuração incluídos no pacote.

Linguagem e runtime

A distribuição inclui o compilador, a Odisseia VM e as ferramentas de desenvolvimento. O código pode ser interpretado diretamente, compilado para bytecode ou otimizado durante a execução pelo mecanismo JIT. O bytecode permanece portátil, enquanto o JIT pode transformar trechos usados com frequência em código nativo para reduzir o custo de execuções posteriores.

A Odisseia oferece tipos primitivos, rotinas, exceções tipadas, units, objetos nativos, coleções tipadas como TList<T> e TMap<TKey,TValue>, além de rotinas assíncronas e concorrência estruturada. A biblioteca padrão contempla arquivos, processos, HTTP, JSON, XML, expressões regulares, bancos de dados, Redis, filas, configuração, criptografia e outras necessidades comuns de aplicações modernas.

Programas de longa duração não possuem um limite global obrigatório de 30 segundos. Prazos podem ser definidos explicitamente nas operações em que fazem sentido, como chamadas de rede, consultas ou processos externos.

Compilação e execução

Use a paleta de comandos ou o menu de contexto para verificar, executar, compilar e depurar o arquivo atual. Os atalhos principais são:

Também é possível usar as ferramentas pelo terminal:

odisseia check programa.odis
odisseia run programa.odis
odisseia compile programa.odis -o programa.odisc
odisseia-vm programa.odisc

Interoperabilidade

A linguagem pode ser incorporada a aplicações escritas em outras tecnologias por meio de sua ABI C. Essa interface permite carregar bytecode, criar contextos de execução, fornecer valores, executar programas e recuperar resultados a partir de linguagens capazes de consumir bibliotecas C.

O isolamento de capacidades permite controlar o acesso do programa a arquivos, rede, processos, variáveis de ambiente e outros recursos do sistema hospedeiro. Isso facilita a execução de código com permissões explícitas e adequadas a cada aplicação.

Ferramentas incluídas

O pacote específico de cada sistema operacional contém:

• odisseia: interface de linha de comando da linguagem;
• odisseia-compiler: compilador para bytecode;
• odisseia-vm: máquina virtual Odisseia;
• odisseia-lsp: servidor de linguagem;
• odisseia-debug: adaptador de depuração;
• odisseia-ffi-worker: processo isolado para interoperabilidade nativa.

Esses executáveis são selecionados automaticamente pela extensão. Quando necessário, seus caminhos e comportamentos podem ser personalizados nas configurações do Visual Studio Code.