Импорт в 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, поэтому последующий импорт или синхронизация этого источника не запрашивает его снова; значение, на которое этот файл уже отвечает, вообще не запрашивается. Секрет, на который ответили чем-либо, кроме имени его источника, компилятор отклоняет своими словами, и он остаётся незаполненным. Всё, чего черновикам ещё не хватает после повторной отправки импорта, предлагается тем же способом.