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

Importar para o Aggrega

O que uma importação lê e escreve, e os formatos que lê, estão descritos em Importação; esta página trata da execução de uma importação a partir do editor.

Aggrega: Import into Aggrega — redige ficheiros 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 ficheiro ou pasta no Explorer, que importa o ficheiro ou a pasta em que se clicou: os três são um único comando, pelo que fazem as mesmas perguntas, por esta 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 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 onde redigir, relativa à sua raiz, 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 se pode marcar Preview, Sync, ambas ou nenhuma: Preview é --dry-run — nada é escrito, e cada ficheiro que a importação escreveria é mostrado no canal de saída seguido do seu conteúdo — e Sync é --sync, que atualiza face à fonte o que uma importação anterior redigiu, alterando apenas o que a importação escreveu, com cada parte que atualiza listada no canal nas palavras que aggrega import --sync imprime para ela; não marcar nenhuma escreve os rascunhos completos. Por fim, 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 deixada vazia, e uma opção deixada por marcar, não é de todo enviada, pelo que o compilador aplica a sua própria predefinição, e descartar qualquer pergunta ou caixa de diálogo termina 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 suas próprias palavras antes de qualquer coisa ser escrita.

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

O formato é reconhecido pela própria forma da fonte, como num terminal; onde o compilador recusa porque nenhum formato, ou mais de um, reconhece a fonte, o editor mostra essa recusa — que indica os formatos — e pede o formato com que ler a fonte, depois envia de novo a mesma importação incluindo-o, e deixar essa pergunta vazia termina a importação com a recusa. Lê o ficheiro indicado, ou os ficheiros do diretório indicado que o seu importador lê, e nenhum outro. Não acede a nenhuma rede, exceto para obter aquilo de que uma importação depende para correr e que esta máquina ainda não tem — um dos importadores base do compilador, na primeira vez que um formato precisa dele, e, num workspace que não indica nenhuma pasta de catálogo, o snapshot publicado do catálogo que a importação lê como o seu catálogo —, cada um obtido a partir do registo predefinido do workspace, verificado e guardado na cache de conteúdo, como aggrega import faz. A fonte pode estar em qualquer sítio desta máquina, porque é um ficheiro para o qual se apontou e não um que o workspace contém; os rascunhos ficam sempre no workspace.

Mostra o progresso com um botão Cancel, e premir Cancel para a conversão em vez de apenas fazer o editor deixar de esperar, porque o importador é executado como um plugin que o compilador pode desfazer a meio da execução.

A conclusão indica em que formato a fonte foi reconhecida, quantos ficheiros foram redigidos e para onde foram, contando os rascunhos e não .aggrega-import.json, o registo do que a importação escreveu que todas as importações escrevem junto aos seus rascunhos; as constatações próprias do importador e cada ficheiro que chegou ao disco, registo incluído, vão para o canal de saída do Aggrega, porque indicam um sítio no ficheiro de origem e não num documento redigido pelo utilizador. Quando uma importação que escreve os seus rascunhos os deixa a dever valores que nenhuma fonte pode conter, o editor oferece-se para os pedir, como descrito em Responder aos valores que uma importação ainda fica a dever.

Responder aos valores que uma importação ainda fica a dever

Alguns valores de que um rascunho precisa são valores que nenhuma fonte pode conter — a imagem em que o 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 escreve os seus rascunhos deixa esses valores vazios, o editor oferece-se uma única vez, numa notificação que indica quantos são, para os pedir; descartar a oferta não altera nada. A uma pré-visualização não é oferecido nada, tal como aggrega import --dry-run não pergunta nada, porque nenhuma resposta é aplicada a uma pré-visualização; as suas constatações no canal de saída continuam a indicar cada valor ainda vazio. Se a oferta for aceite, cada valor é pedido numa caixa de entrada própria, pela ordem em que os rascunhos os listam: a caixa tem como título o ficheiro redigido e a chave em que o valor se encontra, e pergunta com a descrição do valor dada pelo próprio compilador, a pergunta que aggrega import faz num terminal. A caixa de um segredo pergunta de onde vem o segredo, nas palavras do próprio compilador — nunca o segredo em si — e oculta o que se escreve. Uma caixa deixada vazia deixa esse valor por responder, para ser respondido mais tarde no ficheiro de respostas. Premir Escape em qualquer caixa termina as perguntas e não envia nada, incluindo as respostas já escritas.

O editor envia então de novo a importação com as respostas, com o mesmo progresso e o mesmo botão Cancel, e as suas constatações, os seus ficheiros e a sua conclusão chegam ao canal de saída como os da primeira importação. As respostas seguem numa sincronização, porque os rascunhos já estão no disco. O compilador escreve cada resposta nos rascunhos e guarda-a no ficheiro de respostas que aggrega import lê, pelo que uma importação ou sincronização posterior dessa fonte não volta a pedi-la; um valor a que esse ficheiro já responde não é de todo pedido. Um segredo respondido com algo que não seja um nome para a sua origem é recusado pelo compilador com as suas próprias palavras e continua por responder. Tudo o que os rascunhos ainda ficarem a dever depois do novo envio da importação é oferecido da mesma forma.