Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Importar para o Aggrega

O que uma importação lê e grava, e os formatos que ela lê, são descritos em Importação; esta página trata de executar uma a partir do editor.

Aggrega: Import into Aggrega — redige arquivos de authoring do Aggrega a partir de uma fonte escrita por outra ferramenta. É também o botão Import no grupo Author do painel Commands, e Import into Aggrega no menu de contexto de um arquivo ou pasta no Explorer, que importa o arquivo ou a pasta em que você clicou: os três são um único comando, então fazem as mesmas perguntas, nesta ordem, cada uma na entrada do próprio editor, exceto que a entrada do Explorer não pergunta pela fonte.

Primeiro a fonte: File… ou Folder…, depois a caixa de diálogo de abertura do seu editor para um desse tipo — a escolha vem primeiro porque no Windows e no Linux uma caixa de diálogo não pode oferecer ambos. Depois a pasta dentro do workspace em que redigir, relativa à raiz dele, em que deixá-la vazia redige sob a raiz do workspace, como aggrega import faz sem --output-dir. Depois as opções, uma lista em que você pode marcar Preview, Sync, ambas ou nenhuma: Preview é --dry-run — nada é gravado, e cada arquivo que a importação gravaria é mostrado no canal de saída seguido do seu conteúdo — e Sync é --sync, que atualiza em relação à fonte o que uma importação anterior redigiu, alterando apenas o que a importação gravou, com cada parte que atualiza listada no canal nas palavras que aggrega import --sync imprime para ela; não marcar nenhuma grava os rascunhos inteiros. Por último, a capacidade de provider para a qual redigir um Manifest, como compose ou helm, em que deixá-la vazia não redige nenhum, como sem --target. Uma resposta que você deixa vazia, e uma opção que você deixa desmarcada, não é enviada, então o compilador aplica o próprio padrão, e dispensar qualquer pergunta ou caixa de diálogo encerra a importação sem enviar nada. Uma pasta que leva para fora do workspace, e uma capacidade à qual nenhuma Recipe no catálogo do workspace se vincula, são recusadas pelo compilador com as próprias palavras antes que qualquer coisa seja gravada.

A primeira pergunta da importação, que pergunta se a fonte é um arquivo ou uma pasta.

O formato é reconhecido pela própria forma da fonte, como em um terminal; onde o compilador recusa porque nenhum formato, ou mais de um, reconhece a fonte, o editor mostra essa recusa — que nomeia os formatos — e pede o formato com que ler a fonte, depois envia a mesma importação de novo com ele, e deixar essa pergunta vazia encerra a importação com a recusa. Ela lê o arquivo que você nomeia, ou os arquivos do diretório que você nomeia que o seu importador lê, e nenhum outro. Ela não acessa nenhuma rede, exceto para buscar aquilo de que uma importação depende para ser executada e que esta máquina ainda não tem — um dos importadores principais do compilador, na primeira vez que um formato precisa dele, e, em um workspace que não nomeia nenhuma pasta de catálogo, o snapshot publicado do catálogo que a importação lê como seu catálogo —, cada um buscado no registro padrão do workspace, verificado e mantido no cache de conteúdo, como aggrega import faz. A fonte pode estar em qualquer lugar desta máquina, porque é um arquivo para o qual você apontou, e não um que o workspace contém; os rascunhos sempre vão para o workspace.

Ela mostra o progresso com um botão Cancel, e pressionar Cancel interrompe a conversão em vez de apenas fazer o editor parar de esperar, porque o importador é executado como um plugin que o compilador pode desfazer no meio da execução.

O final diz em que formato a fonte foi reconhecida, quantos arquivos foram redigidos e para onde foram, contando os rascunhos e não .aggrega-import.json, o registro do que a importação gravou que toda importação grava ao lado dos seus rascunhos; os achados próprios do importador e cada arquivo que chegou ao disco, incluindo o registro, vão para o canal de saída do Aggrega, porque nomeiam um lugar no arquivo-fonte, e não em um documento que você escreveu. Quando uma importação que grava os seus rascunhos os deixa devendo valores que nenhuma fonte pode conter, o editor se oferece para pedi-los a você, como descrito em Responder aos valores que uma importação ainda deve.

Responder aos valores que uma importação ainda deve

Alguns valores de que um rascunho precisa são valores que nenhuma fonte pode conter — a imagem em que o seu próprio código é construído, por exemplo, o e-mail de uma conta proprietária ou a origem de um segredo. Quando uma importação que grava os seus rascunhos deixa esses valores vazios, o editor se oferece uma única vez, em uma notificação que informa quantos são, para pedi-los a você; dispensar a oferta não muda nada. Nada é oferecido a uma prévia, assim como aggrega import --dry-run não pergunta nada, porque nenhuma resposta é aplicada a uma prévia; os achados dela no canal de saída ainda nomeiam cada valor ainda vazio. Se você aceitar a oferta, cada valor é pedido em uma caixa de entrada própria, na ordem em que os rascunhos os listam: a caixa tem como título o arquivo redigido e a chave em que o valor fica, e pergunta com a descrição do valor dada pelo próprio compilador, a pergunta que aggrega import faz em um terminal. A caixa de um segredo pergunta de onde o segredo vem, nas palavras do próprio compilador — nunca o segredo em si — e oculta o que você digita. Uma caixa que você deixa vazia deixa esse valor pendente, para ser respondido mais tarde no arquivo de respostas. Pressionar Escape em qualquer caixa encerra as perguntas e não envia nada, incluindo as respostas que você já tinha digitado.

O editor então envia a importação de novo com as suas respostas, com o mesmo progresso e o mesmo botão Cancel, e os achados, os arquivos e o final dela chegam ao canal de saída como os da primeira importação. As respostas vão em uma sincronização, porque os rascunhos já estão no disco. O compilador grava cada resposta nos rascunhos e a mantém no arquivo de respostas que aggrega import lê, de modo que uma importação ou sincronização posterior dessa fonte não a pede de novo; um valor que esse arquivo já responde nem chega a ser pedido. Um segredo respondido com algo diferente de um nome para a sua origem é recusado pelo compilador com as próprias palavras e continua pendente. O que os rascunhos ainda deverem depois da importação enviada de novo é oferecido da mesma forma.