Імпорт в Aggrega
Що імпорт читає й записує та які формати він читає, описано в розділі Імпорт; ця сторінка пояснює, як запустити імпорт із редактора.
Aggrega: Import into Aggrega — створити чернетки файлів опису Aggrega з джерела, написаного іншим інструментом. Це також кнопка Import у групі Author панелі Commands і пункт Import into Aggrega у контекстному меню файлу або папки в Провіднику, який імпортує файл або папку, на які ви клацнули: усі три — одна команда, тож вони ставлять ті самі запитання в тому самому порядку, кожне у власному полі введення редактора, за винятком того, що пункт Провідника не питає джерело.
Спочатку джерело: File… або Folder…, потім діалог відкриття вашого редактора для об’єкта цього виду — вибір іде першим, бо у Windows і Linux один діалог не може запропонувати обидва варіанти. Потім папка всередині робочої області, до якої створюються чернетки, відносно її кореня; якщо залишити її порожньою, чернетки створюються під коренем робочої області, як це робить aggrega import без --output-dir. Потім параметри — список, у якому можна позначити Preview, Sync, обидва або жодного: Preview — це --dry-run: нічого не записується, а кожен файл, який записав би імпорт, показується в каналі виводу разом із його вмістом, — а Sync — це --sync: він приводить те, що створив попередній імпорт, у відповідність до джерела, змінюючи лише те, що записав імпорт, і кожна оновлена частина перелічується в каналі тими словами, які для неї друкує aggrega import --sync; якщо не позначити жодного, чернетки записуються повністю. Нарешті, можливість провайдера, для якої створюється чернетка сутності Manifest, наприклад compose або helm; якщо залишити її порожньою, чернетка не створюється, як без --target. Відповідь, залишена порожньою, і параметр, залишений непозначеним, взагалі не надсилаються, тож компілятор застосовує власне значення за замовчуванням, а закриття будь-якого запитання чи діалогу завершує імпорт, нічого не надіславши. Папку, що веде за межі робочої області, і можливість, до якої не прив’язана жодна сутність Recipe в каталозі робочої області, компілятор відхиляє власними словами до того, як щось буде записано.

Формат розпізнається за власною формою джерела, як у терміналі; якщо компілятор відмовляє, бо джерело не розпізнає жоден формат або розпізнає більше ніж один, редактор показує цю відмову — у якій названо формати — і питає, у якому форматі читати джерело, потім надсилає той самий імпорт знову з цим форматом, а якщо залишити це запитання порожнім, імпорт завершується цією відмовою. Читається файл, який ви вказали, або ті файли вказаної вами директорії, які читає його імпортер, і жодні інші. Команда не звертається до мережі, окрім як для отримання того, на чому працює імпорт і чого на цій машині ще немає, — одного з базових імпортерів компілятора, коли він уперше потрібен формату, і, у робочій області, яка не вказує жодної папки каталогу, опублікованого знімка каталогу, який імпорт читає як свій каталог, — кожне з них отримується з реєстру робочої області за замовчуванням, перевіряється та зберігається в кеші вмісту, як це робить aggrega import. Джерело може бути будь-де на цій машині, бо це файл, на який ви вказали, а не файл робочої області; чернетки завжди потрапляють до робочої області.
Команда показує перебіг виконання з кнопкою Cancel, і натискання Cancel зупиняє перетворення, а не лише очікування редактора, бо імпортер працює як плагін, який компілятор може згорнути посеред виконання.
На завершення повідомляється, як було розпізнано джерело, скільки файлів створено і куди вони потрапили, при цьому рахуються чернетки, а не .aggrega-import.json — запис про те, що записав імпорт, який кожен імпорт записує поруч зі своїми чернетками; власні результати імпортера й кожен файл, що потрапив на диск, включно з цим записом, надходять до каналу виводу Aggrega, бо вони вказують на місце у вихідному файлі, а не в документі, який ви написали. Коли імпорт, що записує свої чернетки, залишає в них ненадані значення, яких не може містити жодне джерело, редактор пропонує запитати їх у вас, як описано в розділі Відповіді на значення, яких імпорт ще не надав.
Відповіді на значення, яких імпорт ще не надав
Деякі значення, потрібні чернетці, не може містити жодне джерело — наприклад, образ, у який збирається ваш власний код, електронна пошта облікового запису власника або джерело секрету. Коли імпорт, що записує свої чернетки, залишає такі значення порожніми, редактор один раз пропонує запитати їх у вас — у сповіщенні, що називає їхню кількість; відхилення пропозиції нічого не змінює. Для попереднього перегляду нічого не пропонується, так само як aggrega import --dry-run нічого не запитує, бо до попереднього перегляду не застосовується жодна відповідь; його результати в каналі виводу все одно називають кожне значення, що лишається порожнім. Якщо прийняти пропозицію, кожне значення запитується в окремому полі введення, у тому порядку, у якому їх перелічують чернетки: заголовок поля містить створений файл і ключ, за яким розташоване значення, а запитання сформульовано власним описом значення від компілятора — тим запитанням, яке aggrega import ставить у терміналі. Поле секрету питає власними словами компілятора, звідки походить секрет, — ніколи не сам секрет — і приховує те, що ви вводите. Поле, залишене порожнім, залишає це значення ненаданим, щоб відповісти на нього пізніше у файлі відповідей. Натискання Escape в будь-якому полі завершує запитання й нічого не надсилає, включно з уже введеними відповідями.
Потім редактор знову надсилає імпорт із вашими відповідями, з тим самим перебігом виконання та кнопкою Cancel, і його результати, файли та завершення надходять до каналу виводу так само, як і для першого імпорту. Відповіді надсилаються із синхронізацією, бо чернетки вже на диску. Компілятор записує кожну відповідь у чернетки й зберігає її у файлі відповідей, який читає aggrega import, тож пізніший імпорт або синхронізація цього джерела не запитує її знову; значення, на яке цей файл уже відповідає, взагалі не запитується. Секрет, на який відповіли чимось іншим, ніж назвою його джерела, компілятор відхиляє власними словами, і він лишається ненаданим. Усе, чого чернеткам ще бракує після повторного надсилання імпорту, пропонується так само.