Primeiros Passos

Os programas em Sounio são criados em ficheiros com a extensão .sio, sendo depois analisados, interpretados ou compilados nativamente através da ferramenta de comando souc. O nosso guia de introdução foca-se na utilização de artefactos validados e num fluxo que coloca a validação sintática e semântica em primeiro lugar (check-first).

Recomendações e Boas Práticas

• Ambiente de Trabalho: Atualmente, a forma mais rápida de iniciar o desenvolvimento baseia-se no descarregamento de um dos nossos binários compilados diretamente de um ambiente validado (checked JIT artifact).
• Variáveis de Ambiente: Lembre-se de configurar a variável SOUNIO_STDLIB_PATH apontando para o diretório stdlib/ do repositório para expor as bibliotecas padrão do ecossistema.
• Validação Segura: Adote o hábito de utilizar o comando souc check antes de recorrer a ações de execução (run) ou empacotamento (build).

Limitações Conhecidas

• Alinhamento do Binário: O comportamento exato da linguagem pode apresentar pequenas variações dependendo da revisão e da arquitetura do binário souc instalado.
• Transição de Build: A compilação do compilador a partir do código-fonte em Rust utilizando o cargo já não constitui o percurso recomendado para novos utilizadores do ecossistema.

Executar Testes Locais

Para validar o compilador Sounio no seu ambiente local, execute os seguintes comandos no terminal a partir da raiz do repositório:

export SOUC_BIN="$(pwd)/bin/souc"
export SOUNIO_STDLIB_PATH="$(pwd)/stdlib"

# Verifica a versão instalada do compilador
"$SOUC_BIN" --version

# Executa testes rápidos de validação e verificação de tipos
"$SOUC_BIN" check examples/hello.sio
"$SOUC_BIN" check tests/run-pass/covid_2020_kernel.sio
"$SOUC_BIN" check tests/run-pass/vancomycin_propagation.sio
"$SOUC_BIN" check tests/compile-fail/vancomycin_low_conf.sio