Importare in Aggrega
Ciò che un import legge e scrive, e i formati che legge, sono descritti in Import; questa pagina spiega come eseguirne uno dall’editor.
Aggrega: Import into Aggrega — redige file di authoring Aggrega da una sorgente scritta da un altro strumento. È anche il pulsante Import nel gruppo Author del pannello Commands, e Import into Aggrega nel menu contestuale di un file o di una cartella nell’Explorer, che importa il file o la cartella su cui hai fatto clic: i tre sono un unico comando, quindi pongono le stesse domande, in quest’ordine, ciascuna nell’input dell’editor stesso, tranne che la voce dell’Explorer non chiede la sorgente.
Prima la sorgente: File… o Folder…, poi la finestra di apertura del tuo editor per una di quel tipo — la scelta viene prima perché su Windows e Linux una finestra di dialogo non può offrire entrambi. Poi la cartella all’interno del workspace in cui redigere, relativa alla sua radice, dove lasciarla vuota redige sotto la radice del workspace, come fa aggrega import senza --output-dir. Poi le opzioni, un elenco in cui puoi spuntare Preview, Sync, entrambe o nessuna: Preview è --dry-run — non viene scritto nulla, e ogni file che l’import scriverebbe viene mostrato sul canale di output seguito dal suo contenuto — e Sync è --sync, che aggiorna rispetto alla sorgente ciò che un import precedente ha redatto, cambiando solo ciò che l’import ha scritto, con ogni parte che aggiorna elencata sul canale con le parole che aggrega import --sync stampa per essa; non spuntarne nessuna scrive le bozze per intero. Infine, la capability del provider per cui redigere un Manifest, come compose o helm, dove lasciarla vuota non ne redige nessuno, come senza --target. Una risposta che lasci vuota, e un’opzione che lasci non spuntata, non viene inviata affatto, quindi il compilatore applica il proprio default, e chiudere qualsiasi domanda o finestra di dialogo termina l’import senza inviare nulla. Una cartella che porta fuori dal workspace, e una capability a cui nessuna Recipe nel catalogo del workspace si lega, vengono rifiutate dal compilatore con parole proprie prima che venga scritto qualsiasi cosa.

Il formato viene riconosciuto dalla forma della sorgente stessa, come in un terminale; dove il compilatore rifiuta perché nessun formato, o più di uno, riconosce la sorgente, l’editor mostra quel rifiuto — che nomina i formati — e chiede il formato con cui leggere la sorgente, poi invia di nuovo lo stesso import includendolo, e lasciare vuota quella domanda termina l’import con il rifiuto. Legge il file che nomini, o i file della directory che nomini che il suo importer legge, e nessun altro. Non raggiunge alcuna rete, tranne per scaricare ciò su cui un import si basa e che questa macchina non possiede ancora — uno degli importer di base del compilatore, la prima volta che un formato ne ha bisogno, e, in un workspace che non nomina alcuna cartella di catalogo, lo snapshot pubblicato del catalogo che l’import legge come proprio catalogo — ciascuno scaricato dal registro predefinito del workspace, verificato e conservato nella cache dei contenuti, come fa aggrega import. La sorgente può trovarsi ovunque su questa macchina, perché è un file a cui hai puntato e non uno che il workspace contiene; le bozze finiscono sempre nel workspace.
Mostra l’avanzamento con un pulsante Cancel, e premere Cancel ferma la conversione anziché far solo smettere l’editor di attendere, perché l’importer gira come plugin che il compilatore può interrompere a metà esecuzione.
La conclusione dice in quale formato è stata riconosciuta la sorgente, quanti file sono stati redatti e dove sono finiti, contando le bozze e non .aggrega-import.json, il registro di ciò che l’import ha scritto che ogni import scrive accanto alle proprie bozze; le segnalazioni dell’importer stesso e ogni file arrivato su disco, registro incluso, vanno nel canale di output Aggrega, perché nominano un punto nel file sorgente anziché in un documento che hai scritto tu. Quando un import che scrive le proprie bozze le lascia con valori in sospeso che nessuna sorgente può contenere, l’editor si offre di chiederteli, come descritto in Fornire i valori che un import lascia in sospeso.
Fornire i valori che un import lascia in sospeso
Alcuni valori di cui una bozza ha bisogno sono valori che nessuna sorgente può contenere — l’immagine in cui viene compilato il tuo codice, per esempio, l’email di un account proprietario, o la provenienza di un secret. Quando un import che scrive le proprie bozze lascia vuoti valori di questo tipo, l’editor si offre una sola volta, in una notifica che indica quanti sono, di chiederteli; ignorare l’offerta non cambia nulla. A un’anteprima non viene offerto nulla, così come aggrega import --dry-run non chiede nulla, perché a un’anteprima non viene applicata alcuna risposta; le sue segnalazioni nel canale di output nominano comunque ogni valore ancora vuoto. Se accetti l’offerta, ogni valore viene chiesto in una casella di input dedicata, nell’ordine in cui le bozze li elencano: la casella ha come titolo il file redatto e la chiave in cui si trova il valore, e pone la domanda con la descrizione del valore data dal compilatore stesso, la domanda che aggrega import pone in un terminale. La casella di un secret chiede da dove proviene il secret, con le parole del compilatore — mai il secret stesso — e nasconde ciò che digiti. Una casella che lasci vuota lascia quel valore in sospeso, da fornire in seguito nel file delle risposte. Premere Esc in qualsiasi casella termina le domande e non invia nulla, comprese le risposte che avevi già digitato.
L’editor invia quindi di nuovo l’import con le tue risposte, con lo stesso avanzamento e lo stesso pulsante Cancel, e le sue segnalazioni, i suoi file e la sua conclusione arrivano al canale di output come quelli del primo import. Le risposte vengono inviate con un sync, perché le bozze sono già su disco. Il compilatore scrive ogni risposta nelle bozze e la conserva nel file delle risposte che aggrega import legge, così un import o un sync successivo di quella sorgente non la chiede di nuovo; un valore a cui quel file risponde già non viene chiesto affatto. Un secret a cui si risponde con qualcosa di diverso da un nome per la sua provenienza viene rifiutato dal compilatore con parole proprie e resta in sospeso. Tutto ciò che le bozze lasciano ancora in sospeso dopo il nuovo invio dell’import viene proposto allo stesso modo.