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

Bibliotecas e editor CGD

O CGD usa o frontend de D no servidor cgd --lsp --stdio, um processo local persistente. Alterar um documento atualiza sua análise e os dependentes abertos; hover, completion e tokens usam a revisão já analisada. Nenhum build, linker ou código do programa é executado por edição. O editor não precisa de conexão de rede.

VS Code e formatação

Após construir o CGD uma vez:

cd extensao-vscode
npm ci
cd ..
python3 scripts/instalar_extensao.py --associate

A extensão usa o CGD configurado, o do workspace confiável ou o binário incluído no VSIX. CGD: Reiniciar servidor de linguagem reinicia o processo; após reinstalar, use Developer: Reload Window para carregar a nova extensão. Os botões compilam, verificam ou executam o documento salvo. F5 executa sem depuração; DAP foi adiado.

Ctrl+Shift+I e Format Document chamam o formatador do LSP. O estilo usa quatro espaços, espaços entre operadores, separação de blocos e métodos e continuidade de listas longas. Strings, comentários e contratos são preservados; literais longos não são partidos. O formatador é lexical, não renomeia símbolos nem inventa tipos. Na CLI, cgd --formatar arquivo.delegua grava o arquivo; cgd --verificar-formatacao arquivo.delegua retorna 1 se houver divergência.

Completion diferencia métodos e campos, respeita o tipo conhecido, membros públicos herdados e namespaces de módulos. Receptores qualquer sem informação suficiente não recebem sugestões de métodos específicos inventados. Há hover, definição, referências, rename, símbolos, signature help com parâmetro ativo, semantic tokens, dobramento e hints opcionais. O índice abrange documentos abertos mais suas importações estáticas; não indexa automaticamente todos os arquivos do disco. Não existe garantia de inferência completa sobre dados dinâmicos.

JSON em Delégua puro

var biblioteca: qualquer = importar("cgd:json")
var dados: qualquer = biblioteca.JSON.analisar('{"nome":"CGD"}')
var documento: qualquer = biblioteca.JSON(dados)
documento.definir("versao", 1)
escreva(documento.texto())

JSON.analisar(fonte, limite=128, maxNos=100000) implementa gramática estrita, escapes e pares substitutos Unicode. O limite máximo de entrada é 1048576 pontos de código. JSON.serializar(valor) rejeita ciclos e reais não finitos. Inteiros fora de 64 bits e expoentes fora da representação nativa são preservados como NumeroJSON; lexema() devolve sua grafia. As funções soltas permanecem para compatibilidade. O construtor JSON recebe o valor já analisado. valor(), obter(chave), definir(chave,valor) e texto() são métodos de instância.

estatico/estático declara métodos sem isto; eles são herdados e podem ser chamados pela classe ou pela instância. Campos estáticos não estão implementados.

Rede sobre libcurl

importar("cgd:rede") oferece Sessao, obter, enviar, requisitar, lote, versao, detalhes, opcoes, escape/decodificação, URL API e datas/erros. Sessao.opcao(nome,valor) aceita opções gerenciáveis anunciadas pela libcurl instalada. Use Sessao.info(nome) para getinfo escalar, multipart(partes) para partes em memória e upload(dados) para upload explícito. A sessão também oferece reset/close, streams connect-only e espera de leitura/escrita. Feche sessões em finalmente. Lotes usam curl_multi. As respostas trazem codigo (CURLcode, zero no sucesso), status HTTP, corpo, cabecalhos, url, segundos e erro. Falhas de transporte ficam nesses campos; configurações inválidas lançam exceções. HTTP 404 não é sucesso HTTP, mas pode ter CURLcode zero. O corpo da resposta e os headers têm limite padrão de 64 MiB cada, ajustável com CGD_MAX_BYTES.

Os defaults usam HTTP/HTTPS, TLS verificado, conexão de 10 segundos e tempo total de 30 segundos. Os programas podem escolher outras opções/protocolos disponíveis. A API não expõe ponteiros C, FILE*, callbacks arbitrários, sockets crus nem opções que substituam callbacks internos ou desliguem suas proteções. POSTFIELDSIZE direto é recusado: o tamanho acompanha o corpo copiado. O upload nunca lê stdin implicitamente. As opções dependem da libcurl instalada; detalhes() distingue versão dos headers e versão carregada. Entry points WebSocket exigem uma libcurl com os protocolos necessários; o ambiente validado não anuncia ws/wss.

A API controlada não replica toda a API C de libcurl. Consulte a lista real em opcoes() e os testes de loopback em testes/bibliotecas.py.

Coleções

importar("cgd:colecoes") expõe Colecoes.unicos(valores) e Colecoes.intervalo(inicio,fim,passo=1). O intervalo exclui o fim, aceita passo negativo, recusa zero e limita a criação a um milhão de elementos. Comparação de coleções/objetos segue a identidade do runtime. As operações nativas de vetores continuam disponíveis, incluindo mapear e filtrar com callbacks sem captura.

Validação de desenvolvimento

testes/lsp.py verifica protocolo, escopos, UTF-16, buffers em memória, completion, assinaturas e cache. testes/formatador.py exige idempotência e executa os contratos de todos os exemplos formatados, com/sem otimização. testes/bibliotecas.py usa HTTP em loopback e verifica JSON, limites e opções recusadas. scripts/verificar_tipos.py impede auto/foreach inferido em D e variáveis sem anotação nas bibliotecas. python3 scripts/testar_extensao.py abre um Extension Host com perfil temporário para testar a integração real, incluindo formatação e ausência de build por edição.

APIs ampliadas em 16/11/2026

As mudanças desta seção foram incluídas nas suítes autorizadas em 17/11/2026. Consulte CONTINUIDADE.md para os resultados efetivamente concluídos.

JSON e HTTP por classes

var json: qualquer = importar("cgd:json")
var documento: qualquer = json.JSON.deTexto('{"pessoa":{"nome":"Ana"}}')
escreva(documento.caminho(["pessoa", "nome"], "sem nome"))
escreva(documento.obter("ausente", "padrão"))

JSON.contem distingue ausência de um valor nulo. obter aceita chave ou índice, inclusive índice negativo de vetor; caminho percorre uma lista de chaves/índices. definir aceita chave ou índice para escrita. copiar cria um documento independente por serialização e nova análise JSON. chaves exige objeto JSON. Chaves como "chaves", "obter" e "itens" não impedem a serialização; ela usa a enumeração controlada do runtime, sem despacho de propriedades. As funções soltas e JSON.analisar/serializar continuam disponíveis. Profundidade: 1..512; orçamento de nós: 1..1.000.000.

var rede: qualquer = importar("cgd:rede")
var cliente: qualquer = rede.ClienteHTTP("https://exemplo.com")
cliente.cabecalho("Accept", "application/json")
var resposta: qualquer = cliente.obter("/dados").exigirSucesso()
escreva(resposta.status())
escreva(resposta.json())

ClienteHTTP copia cabeçalhos/opções recebidos, oferece obter/enviar/enviarJSON/ atualizar/remover e cria uma sessão isolada por requisição. RespostaHTTP oferece status/sucesso/texto/json/cabecalhos/url/erro/dados/exigirSucesso. dados retorna uma cópia do dicionário. sucesso exige libcurl sem erro e status 200..299; falhas HTTP continuam inspecionáveis até chamar exigirSucesso. As APIs anteriores de sessão, streaming, multipart e lote permanecem disponíveis.

Arquivos e dicionários

var arquivos: qualquer = importar("cgd:arquivos")
var arquivo: qualquer = arquivos.Arquivo("dados.txt")
arquivo.escrever("primeira linha\n").anexar("segunda linha\n")
escreva(arquivo.ler())

Arquivo oferece caminho/existe/informacoes/tamanho/ler/linhas/escrever/anexar/ remover. Cada chamada abre e fecha seu descritor; nenhum ponteiro ou descritor é exposto. Leitura padrão: 16 MiB, configurável até 64 MiB; escrita: até 64 MiB por chamada. Tamanhos/limites contam bytes. Textos de I/O preservam bytes nulos; operações Unicode sobre dados que não são UTF-8 continuam sujeitas à validação usual do runtime. linhas normaliza CRLF e preserva linhas vazias/quebra final. remover devolve falso se ausente. Diretórios/dispositivos/FIFOs não servem para ler/escrever; erros de I/O são exceções tratáveis. Escrita pode ser parcial se o sistema falhar; não é transação nem gravação atômica. Implementação POSIX/Linux.

Dicionários oferecem obter(chave, padrao = nulo), definir(chave, valor) (retorna o valor), contemChave(chave), itens() (snapshot de tuplas chave/valor) e limpar() (muta a mesma coleção e retorna o dicionário). obter usa o padrão somente quando a chave não existe; nulo armazenado permanece nulo. itens faz cópia rasa, sem prometer ordem. Uma chave textual com o nome de um método continua ocultando esse método; use índices para acessar esses dados.

Ciclo de vida explícito

classe Recurso {
    construtor() {}
    destrutor(): vazio {
        escreva("liberado")
    }
}
var recurso: Recurso = Recurso()
tente {
    escreva("usando")
} finalmente {
    destruir(recurso)
}

construtor, destrutor e estatico/estático são palavras-chave. Destrutores são públicos, de instância, sem argumentos e com retorno vazio. Use destruir(instancia) para acionar a cadeia da classe derivada até as bases, uma vez por identidade; reentrada e chamadas repetidas são ignoradas. As bases ainda executam se uma classe falhar; a primeira exceção é relançada ao final. A cadeia é automática: não chame super.destrutor() dentro dela. Chamadas diretas ao método não substituem esse protocolo. A memória continua gerenciada pelo GC; não há execução de destrutores Delégua pelo coletor nem ao sair de escopos. Sessao implementa destrutor que fecha sua sessão nativa; fechar continua disponível.

Editor e prévia CTFE

A extensão 0.3.0 inclui gramática lexical para coloração antes de o LSP responder, snippets e reconhecimento de executáveis com shebang cgd/delegua. Tokens semânticos continuam prevalecendo. Completion usa o catálogo de palavras-chave do lexer e membros do receptor respeitando escopo, herança, estáticos e visibilidade; isto. incompleto preserva o contexto da classe. Não há sugestões de nomes aleatórios do arquivo como fallback depois de ponto.

O hover pode exibir o resultado de chamadas puras com argumentos constantes e de operações primitivas. A prévia trabalha sobre cópias, apenas sob demanda, com cache por revisão, até 100.000 instruções de VM por documento e limites de nós/ profundidade. Constantes primitivas tipadas são aceitas se seu contrato passar. Não executa rede, I/O, funções comuns ou código arbitrário, nem invoca compilador C/linker. Falhas e limites omitem a prévia; variáveis mutáveis e recursos fora do subconjunto CTFE não recebem valores presumidos. Isso não constitui depuração.

Biblioteca padrão ampliada e erros visuais (0.5.0)

A referência principal de uso é o guia web próprio, do início às APIs e decisões de escopo. Ela inclui os capítulos específicos de Textos, Estatistica, Caminhos e diagnósticos do runtime, com exemplos e contratos.

cgd:textos oferece comecaCom, terminaCom, repetir, preencherInicio/preencherFim, linhas, digitos, juntar, inverter e contar. Texto é Unicode; digitos é ASCII explícito e inverter usa pontos de código, sem normalizar grafemas.

cgd:estatistica oferece soma, media, minimo, maximo, mediana, variancia, desvioPadrao e resumo. A mediana copia antes de ordenar; a variância é incremental, populacional por padrão, com opção amostral. Entradas insuficientes falham.

cgd:caminhos oferece absoluto, normalizar, juntar, nome, diretorio, extensao e semExtensao. São operações POSIX lexicais, sem acessar disco ou resolver links. Não use normalizar como garantia de confinamento de arquivos.

Colecoes ganhou primeiro, ultimo, encontrar, contar, particionar, combinar, blocos e frequencias. Resultados novos preservam referências rasas aos elementos; callbacks não capturam ambiente. Arquivo ganhou lerJSON, escreverJSON e copiarPara. Matematica expõe funções trigonométricas inversas, logaritmos, arredondar/truncar, hipotenusa e resto via libm.

Erros não capturados do runtime mostram error[R0001], arquivo/linha/coluna, linha de fonte e marcador ^. Sem o arquivo, a localização permanece. O trecho é lido do disco apenas ao reportar falha e pode divergir se o fonte foi modificado. Controles são escapados; leitura/janela são limitadas e FIFO não bloqueia o renderer. Exceções capturadas não são impressas automaticamente.