Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Importar a Aggrega

Lo que una importación lee y escribe, y los formatos que lee, se describen en Importación; esta página explica cómo ejecutar una desde el editor.

Aggrega: Import into Aggrega — redacta archivos de authoring de Aggrega a partir de una fuente que escribió otra herramienta. También es el botón Import del grupo Author del panel Commands, e Import into Aggrega en el menú contextual de un archivo o carpeta en el Explorer, que importa el archivo o la carpeta en que hiciste clic: los tres son un solo comando, así que hacen las mismas preguntas, en este orden, cada una en la entrada propia del editor, salvo que la entrada del Explorer no pregunta por la fuente.

Primero la fuente: File… o Folder…, y después el diálogo de apertura de tu editor para uno de ese tipo — la elección va primero porque en Windows y Linux un diálogo no puede ofrecer ambos. Después la carpeta dentro del workspace en la que redactar, relativa a su raíz, donde dejarla vacía redacta bajo la raíz del workspace, como hace aggrega import sin --output-dir. Después las opciones, una lista en la que puedes marcar Preview, Sync, ambas o ninguna: Preview es --dry-run — no se escribe nada, y cada archivo que escribiría la importación se muestra en el canal de salida seguido de su contenido — y Sync es --sync, que pone al día con la fuente lo que redactó una importación anterior, cambiando solo lo que escribió la importación, con cada parte que actualiza listada en el canal con las palabras que aggrega import --sync imprime para ella; no marcar ninguna escribe los borradores completos. Por último, la capacidad de provider para la que redactar un Manifest, como compose o helm, donde dejarla vacía no redacta ninguno, como sin --target. Una respuesta que dejas vacía, y una opción que dejas sin marcar, no se envía en absoluto, así que el compilador aplica su propio valor predeterminado, y descartar cualquier pregunta o diálogo termina la importación sin enviar nada. Una carpeta que sale del workspace, y una capacidad a la que no se vincula ninguna Recipe del catálogo del workspace, las rechaza el compilador con sus propias palabras antes de escribir nada.

La primera pregunta de la importación, que pregunta si la fuente es un archivo o una carpeta.

El formato se reconoce por la forma propia de la fuente, como en un terminal; cuando el compilador rechaza porque ningún formato, o más de uno, reconoce la fuente, el editor muestra ese rechazo — que nombra los formatos — y pide el formato con el que leer la fuente, y luego envía de nuevo la misma importación incluyéndolo; dejar vacía esa pregunta termina la importación con el rechazo. Lee el archivo que nombras, o los archivos del directorio que nombras que lee su importador, y ningún otro. No llega a ninguna red, salvo para obtener aquello con lo que se ejecuta una importación y que esta máquina aún no tiene — uno de los importadores básicos del compilador, la primera vez que un formato lo necesita, y, en un workspace que no nombra ninguna carpeta de catálogo, la instantánea publicada del catálogo que la importación lee como su catálogo —, cada uno obtenido del registro predeterminado del workspace, verificado y guardado en la caché de contenido, como hace aggrega import. La fuente puede estar en cualquier lugar de esta máquina, porque es un archivo al que apuntaste y no uno que contiene el workspace; los borradores siempre acaban en el workspace.

Muestra el progreso con un botón Cancel, y pulsar Cancel detiene la conversión en lugar de solo hacer que el editor deje de esperar, porque el importador se ejecuta como un plugin que el compilador puede deshacer a mitad de ejecución.

El final dice en qué formato se reconoció la fuente, cuántos archivos se redactaron y adónde fueron, contando los borradores y no .aggrega-import.json, el registro de lo que escribió la importación que toda importación escribe junto a sus borradores; los propios hallazgos del importador y cada archivo que llegó al disco, registro incluido, van al canal de salida de Aggrega, porque nombran un lugar del archivo fuente y no de un documento que tú escribiste. Cuando una importación que escribe sus borradores los deja debiendo valores que ninguna fuente puede contener, el editor ofrece pedírtelos, como se describe en Responder a los valores que una importación aún debe.

Responder a los valores que una importación aún debe

Algunos valores que necesita un borrador son valores que ninguna fuente puede contener: la imagen en la que se construye tu propio código, por ejemplo, el correo electrónico de una cuenta propietaria o el origen de un secreto. Cuando una importación que escribe sus borradores deja vacíos esos valores, el editor ofrece una sola vez, en una notificación que indica cuántos son, pedírtelos; descartar la oferta no cambia nada. A una vista previa no se le ofrece nada, igual que aggrega import --dry-run no pregunta nada, porque a una vista previa no se le aplica ninguna respuesta; sus hallazgos en el canal de salida siguen nombrando cada valor aún vacío. Si aceptas la oferta, cada valor se pide en un cuadro de entrada propio, en el orden en que los borradores los enumeran: el cuadro lleva como título el archivo redactado y la clave en la que está el valor, y pregunta con la descripción del valor que da el propio compilador, la pregunta que aggrega import hace en un terminal. El cuadro de un secreto pregunta de dónde viene el secreto, con las palabras del propio compilador — nunca el secreto en sí — y oculta lo que escribes. Un cuadro que dejas vacío deja ese valor pendiente, para responderlo más adelante en el archivo de respuestas. Pulsar Escape en cualquier cuadro termina las preguntas y no envía nada, incluidas las respuestas que ya habías escrito.

Después, el editor envía de nuevo la importación con tus respuestas, con el mismo progreso y el mismo botón Cancel, y sus hallazgos, sus archivos y su final llegan al canal de salida como los de la primera importación. Las respuestas van en una sincronización, porque los borradores ya están en el disco. El compilador escribe cada respuesta en los borradores y la guarda en el archivo de respuestas que lee aggrega import, de modo que una importación o sincronización posterior de esa fuente no vuelve a pedirla; un valor que ese archivo ya responde no se pide en absoluto. Un secreto respondido con algo distinto de un nombre para su origen lo rechaza el compilador con sus propias palabras y sigue pendiente. Lo que los borradores aún deban después de la importación enviada de nuevo se ofrece de la misma manera.