Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Módulos estáticos e ~/.delegua/cgd

Divida projetos maiores em vários arquivos .delegua ou importe bibliotecas prontas com importar("cgd:nome"). Tudo é resolvido estaticamente na compilação, com detecção de ciclos e cache automático.

Módulos locais e bibliotecas em ~/.delegua/cgd

Para importar um arquivo do seu projeto, passe o caminho relativo terminado em .delegua: importar("util.delegua").

Para bibliotecas cgd:, o CGD NÃO usa uma lista fixa no compilador: ele procura diretamente .delegua dentro de ~/.delegua/cgd (ou na pasta definida pela variável de ambiente CGD_LIBS_DIR), usando bibliotecas/ ao lado do executável apenas como fallback. Se você salvar ~/.delegua/cgd/minhalib.delegua, importar("cgd:minhalib") funciona na hora — e já aparece no autocomplete do VS Code!

const JSON: qualquer = importar("cgd:json").JSON
const util: qualquer = importar("./util.delegua")

Namespaces, ciclos e identidade de classes

Cada módulo é inicializado uma única vez e expõe suas funções, variáveis e classes como namespace. O compilador detecta ciclos (E2001), verifica se o membro importado realmente existe (E3109) e garante que duas classes com o mesmo nome em módulos diferentes nunca sejam confundidas.

Experimente: 01_importacao

var calculos: qualquer = importar("lib/calculos.delegua")
var outraReferencia: qualquer = importar("./lib/calculos.delegua")
escreva(calculos.soma(3), outraReferencia.versao, calculos.Valor(4).dado)

Ver exemplo completo e contrato de teste no GitHub

Experimente: 08_otimizacao_modulos

// As duas importações compartilham o módulo, sem repetir inicialização.
var primeiro: qualquer = importar("biblioteca.delegua")
var segundo: qualquer = importar("biblioteca.delegua")
escreva(primeiro.dobro(2 + 2))

Ver exemplo completo e contrato de teste no GitHub

Caminhos em importar() precisam ser literais conhecidos na compilação. Tentativas de travessia em cgd: (como cgd:../segredo) são bloqueadas com E2003.