CLI do Soyuz

O Soyuz vem com um toolchain integrado: um único binário soyuz cobre a criação de projetos, compilação e execução.

---

Instalação

Binário pré-compilado (Linux x64)

Baixe o soyuz-linux-x64 na página de Releases e mova para o PATH:

chmod +x soyuz-linux-x64
sudo mv soyuz-linux-x64 /usr/local/bin/soyuz

Build da source

git clone https://github.com/VandeJr/soyuz
cd soyuz
make build    # gera ./soyuz e ./soyuz-lsp
make install  # instala em ~/.local/bin por padrão

Caution

O Soyuz utiliza Clang para a fase de linkagem. Instale antes de compilar qualquer programa:

# Ubuntu / Debian
sudo apt install clang

# Arch Linux
sudo pacman -S clang

---

soyuz new

Cria um projeto Soyuz com a estrutura mínima necessária.

soyuz new <nome>         # projeto binário (executável)
soyuz new --lib <nome>   # projeto biblioteca

Projeto binário — gera:

• Directoryhello/

  • soyuz.toml
  • main.sy

Projeto biblioteca — gera:

• Directorymylib/

  • soyuz.toml
  • lib.sy

soyuz.toml gerado

[project]
name    = "hello"
version = "0.1.0"
type    = "binary"   # ou "library"
entry   = "main.sy"

[packages]
# aliases para imports locais (ver Módulos)

---

soyuz build

Compila o projeto ou um arquivo avulso.

Modo projeto (sem argumento)

Execute dentro de um diretório que contenha soyuz.toml:

soyuz build            # debug  → target/debug/<name>
soyuz build --release  # release → target/release/<name>

O output segue a estrutura:

• Directoryhello/

  • Directorytarget/

    • Directorydebug/

      • hello
    • Directoryrelease/

      • hello

Para projetos do tipo library, soyuz build executa apenas a verificação de tipos — nenhum executável é gerado:

Biblioteca 'mylib' v0.1.0 verificada com sucesso.

Modo arquivo (legado)

soyuz build [-o saída] <arquivo.sy>

soyuz build main.sy             # output: ./output
soyuz build -o meu_app main.sy  # output: ./meu_app

Flag --release

Ativa -O2 no Clang. Útil para distribuição; desnecessário durante o desenvolvimento.

---

soyuz run

Compila para um diretório temporário, executa o binário e apaga em seguida.

soyuz run                        # usa entry do soyuz.toml
soyuz run <arquivo.sy>           # compila e executa um arquivo avulso
soyuz run --release              # build otimizado antes de executar
soyuz run <arquivo.sy> -- arg1 arg2  # passa argumentos ao programa

Note

O separador -- delimita os argumentos do soyuz run dos argumentos que serão passados ao programa compilado. Tudo após -- chega em args() dentro do programa.

Exemplo

# Criar projeto, rodar e verificar argumentos
soyuz new demo && cd demo
soyuz run -- alpha beta

main.sy

import @soyuz/prelude

fn main() {
    val a = args()
    print("recebeu $(a.size()) argumentos")
}

---

soyuz.toml — referência completa

[project]
name    = "minha-app"   # nome do projeto e do binário gerado
version = "0.1.0"       # semver livre — apenas documentação por enquanto
type    = "binary"      # "binary" | "library"
entry   = "main.sy"     # arquivo de entrada (relativo à raiz do projeto)

[packages]
# Define aliases para o sistema de imports.
# utils = "lib/utils"  →  import { ... } from @utils/modulo
utils = "lib/utils"
http  = "lib/http"

Aliases de packages

Com [packages] definido, você usa @<alias>/<modulo> nos imports:

import (
    { soma } from @utils/math
    { GET }  from @http/client
)

Descoberta do projeto

O compilador busca o soyuz.toml subindo pelos diretórios a partir do arquivo de entrada — o mesmo comportamento de ferramentas como cargo ou go. Você pode rodar soyuz build de qualquer subdiretório do projeto.

---

FFI — arquivos C no projeto

Coloque arquivos .c em um diretório runtime/ na raiz do projeto. Eles são automaticamente compilados e linkados com o programa:

• Directoryminha-app/

  • soyuz.toml
  • main.sy
  • Directoryruntime/

    • bindings.c

O header soyuz.h (com a API de RC, listas e mapas) fica disponível via -I automaticamente.

---

Language Server (LSP)

O binário soyuz-lsp é publicado junto com soyuz em cada release. Configure seu editor para apontar para ele:

Neovim (nvim-lspconfig)

require('lspconfig').soyuz.setup {
  cmd = { 'soyuz-lsp' },
  filetypes = { 'soyuz' },
  root_dir = require('lspconfig.util').root_pattern('soyuz.toml'),
}

VS Code

Instale a extensão Soyuz Language Support ou configure manualmente em .vscode/settings.json:

{
  "soyuz.languageServerPath": "/usr/local/bin/soyuz-lsp"
}

O LSP oferece: diagnósticos em tempo real, hover com tipos, completions, inlay hints e formatação de código.