Bibliotecas cgd:* (Web, Dados, Cripto e Sistema)
O CGD vem com 24 módulos prontos instalados em ~/.delegua/cgd. Você importa apenas o que precisa com importar("cgd:nome") e o LSP já completa os nomes e métodos no VS Code.
Mapa completo dos 24 módulos em ~/.delegua/cgd
| Recurso | Como funciona |
|---|---|
| cgd:servidor | Servidor HTTP/1.1 com rotas, parâmetros, JSON, middlewares e modo concorrente epoll (escutarAsync + keep-alive). |
| cgd:rede | Cliente HTTP síncrono e assíncrono sobre libcurl (ClienteHTTP, RespostaHTTP, obter/enviar/enviarJSON). |
| cgd:sockets | Sockets TCP/UDP, resolução DNS e suporte a IPv6 (OuvinteTCP, Conexao, SocketUDP, resolverDNS). |
| cgd:assincrono | Tempo.dormir, HTTP e TCP assíncronos sobre epoll, Canal limitado e GrupoTarefas. |
| cgd:json | Parser e serializador JSON em Delégua puro com limites de profundidade e navegação por caminho. |
| cgd:sqlite | Banco SQLite (libsqlite3) com consultas parametrizadas, transações e fechamento explícito. |
| cgd:bytes | Buffer binário nativo (Bytes) para manipular bytes, hex, base64 e fatiamento sem depender de texto UTF-8. |
| cgd:cripto | Hashes SHA-256/SHA-512, HMAC e bytes aleatórios criptográficos sobre OpenSSL (libcrypto). |
| cgd:compressao | Compressão e descompressão gzip/deflate (zlib) com teto contra bombas de descompressão. |
| cgd:arquivos | Leitura, escrita, linhas, JSON, cópia e remoção de arquivos regulares com limite seguro de memória. |
| cgd:processo / cgd:ambiente / cgd:sistema | Execução de subprocessos sem shell (argv separado + timeout), variáveis de ambiente e dados do sistema. |
| cgd:tempo | Relógios, Duracao, Cronometro, dormirAsync e calendário DataHora. |
| cgd:io / cgd:cli / cgd:log | Entrada/saída estruturada, parser de argumentos de linha de comando e logger estruturado. |
| cgd:textos / cgd:colecoes / cgd:caminhos | Utilitários de string, transformações de vetores (agrupar, reduzir, particionar, blocos) e caminhos POSIX. |
| cgd:matematica / cgd:estatistica / cgd:algoritmos | Funções matemáticas (libm), média/mediana/variância/desvio padrão, busca binária e CRC32. |
| cgd:nativo | Primitivas da ABI gerenciada usadas internamente para construir as bibliotecas acima. |
Experimente: json_classe
var biblioteca: qualquer = importar("../../bibliotecas/json.delegua")
var dados: qualquer = biblioteca.JSON.analisar('{"nome":"CGD","versao":1}')
escreva(biblioteca.JSON.serializar(dados))
var documento: qualquer = biblioteca.JSON(dados)
escreva(documento.obter("nome"))
escreva(documento.definir("versao", 2).texto())
Ver exemplo completo e contrato de teste no GitHub
Experimente: rede
// Não faz requisições externas: introspecção e codificação são locais.
var rede: qualquer = importar("../../bibliotecas/rede.delegua")
escreva(rede.escapar("a b/c"))
escreva(rede.decodificar("a%20b%2Fc"))
escreva(tamanho(rede.opcoes()) > 100)
Ver exemplo completo e contrato de teste no GitHub
Experimente: colecoes
var biblioteca = importar("../../bibliotecas/colecoes.delegua")
escreva(biblioteca.Colecoes.unicos([1, 2, 1, 3, 2]))
escreva(biblioteca.Colecoes.intervalo(5, 0, -2))
var colecoes: qualquer = importar("cgd:colecoes").Colecoes
funcao par(valor: inteiro): logico {
retorna valor % 2 == 0
}
var grupos: tupla = colecoes.particionar([1, 2, 3, 4], par)
escreva(grupos[0])
escreva(grupos[1])
escreva(colecoes.blocos([1, 2, 3, 4, 5], 2))
Ver exemplo completo e contrato de teste no GitHub
Experimente: json_navegacao
var json: qualquer = importar("cgd:json")
var documento: qualquer = json.JSON.deTexto('{"pessoa":{"nome":"Ana"},"valor":null}')
escreva(documento.caminho(["pessoa", "nome"]))
escreva(documento.obter("ausente", 7))
escreva(documento.obter("valor", 7))
var copia: qualquer = documento.copiar()
copia.definir("novo", verdadeiro)
escreva(documento.contem("novo"))
Ver exemplo completo e contrato de teste no GitHub
Experimente: arquivos
var arquivos: qualquer = importar("cgd:arquivos")
var arquivo: qualquer = arquivos.Arquivo("dados.txt")
// Instanciar não abre nem modifica o arquivo. I/O só acontece por chamada explícita.
escreva(arquivo.caminho())
Ver exemplo completo e contrato de teste no GitHub
Experimente: bytes_cripto_sqlite
const Bytes: qualquer = importar("cgd:bytes").Bytes
const Cripto: qualquer = importar("cgd:cripto").Cripto
const Comp: qualquer = importar("cgd:compressao").Compressao
const SQLite: qualquer = importar("cgd:sqlite").SQLite
const DataHora: qualquer = importar("cgd:tempo").DataHora
escreva(Bytes.deTexto("abc").paraHex())
escreva(Cripto.sha256("abc"))
const gz: texto = Comp.gzipComprimir("delegua-compilador-c99")
escreva(Comp.gzipDescomprimir(gz) == "delegua-compilador-c99")
const db: qualquer = SQLite.abrir(":memory:")
tente {
db.executar("CREATE TABLE pessoas (id INTEGER PRIMARY KEY, nome TEXT)")
db.executar("INSERT INTO pessoas (nome) VALUES (?)", ["Ana"])
const linha: qualquer = db.consultarUm("SELECT nome FROM pessoas WHERE id = ?", [1])
escreva(linha["nome"])
} finalmente {
db.fechar()
}
escreva(DataHora.deUTC(2026, 11, 20, 14, 30, 5).formatarISO())
Ver exemplo completo e contrato de teste no GitHub
Experimente: http
// Servidor local: execute e acesse http://127.0.0.1:8080/.
// GET /parar encerra este exemplo; não exponha essa rota em aplicações públicas.
const Servidor: qualquer = importar("cgd:servidor")
var app: qualquer = Servidor.HTTP()
app.get("/", funcao(req: qualquer, res: qualquer): vazio {
res.enviar("Olá, CGD!\n")
})
app.get("/usuarios/:nome", funcao(req: qualquer, res: qualquer): vazio {
res.json({ nome: req.parametro("nome"), pagina: req.query("pagina", "1") })
})
app.post("/api/eco", funcao(req: qualquer, res: qualquer): vazio {
res.status(201).json(req.json())
})
app.head("/", funcao(req: qualquer, res: qualquer): vazio {
res.enviar("Olá, CGD!\n")
})
app.get("/parar", funcao(req: qualquer, res: qualquer): vazio {
res.enviar("Até logo!\n").pararServidor()
})
app.escutar("127.0.0.1", 8080)
Ver exemplo completo e contrato de teste no GitHub
As bibliotecas cgd:* são nativas do CGD (não vêm do NPM nem do delegua-node). Para adicionar um módulo seu, basta colocar o .delegua dentro de ~/.delegua/cgd.