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
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.