Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Граф топологии

Topology graph — отображает скомпилированное IR выбранной сущности Release в виде интерактивного графа: контейнеры границ и подсистем, где каждая граница или подсистема, объявленная внутри другой, рисуется внутри неё, рёбра со стилем в зависимости от происхождения, панорамирование и масштабирование, щелчок по узлу, чтобы выбрать его, и двойной щелчок, чтобы открыть его исходный файл, а также щелчок по ребру, чтобы выбрать соединение, которое оно изображает.

Граф топологии сущности Release: три компонента внутри рамок, содержащих узлы, которые не объявляет ни одна граница или подсистема, рёбра от компонента web к его базе данных и кешу, а также легенда в левом нижнем углу.

Заголовок каждого контейнера называет не только его группировку, но и его вид, поэтому внешнюю и внутреннюю рамки можно различить даже в рабочем пространстве, которое не объявляет ни одну из них, — где иначе обе носили бы одинаковое имя. Группировка, которую никто не объявлял и которую компилятор создаёт для компонентов, перечисленных сущностью Release или Aggregate на верхнем уровне, получает заголовок, указывающий, что группировка не объявлена, а её рамка рисуется иначе, чем рамка объявленной группировки, — пунктирным нейтральным контуром, — чтобы её не принимали за группировку с таким именем; группировка, которую объявили вы, сохраняет своё имя, каким бы оно ни было, включая default.

Каждое ребро имеет наконечник стрелки на том конце, на который оно указывает: ребро идёт от компонента-потребителя к его цели, а наконечник рисуется собственным цветом и штриховкой ребра. Размер рамки узла определяется измерением текста, который в ней рисуется, — и имени узла, и компонента под ним, — поэтому ни то ни другое не выходит за контур, каким бы длинным ни было имя компонента.

Легенда в левом нижнем углу называет каждую группировку по документу, который её объявляет, — границу по сущности Release, подсистему по сущности Aggregate — и, если на рисунке такая есть, рамку с узлами, не входящими ни в одну группировку, вместе с её содержимым; она указывает, какой конец ребра является его целью; а также называет цветную полосу вдоль переднего края узла и каждый цвет, который ей присваивает рисунок, рядом со значением component.aggrega.ai/type, которое этот цвет обозначает, в точности так, как записана метка, со строкой для узлов без такой метки, если они есть. Она также поясняет, чего эти цвета не означают: они назначаются при каждой отрисовке графа, поэтому группируют узлы по типу в пределах одного графа, а тот же цвет в другом графе не означает тот же тип. Легенда остаётся на месте, что бы вы ни делали с рисунком, поэтому всякий раз, когда рисунок подгоняется под панель, — при первой отрисовке и каждый раз, когда вы запрашиваете граф, — он подгоняется под часть панели над легендой: в пределах всей ширины панели и высоты, оставшейся над легендой, с центрированием по горизонтали, так что легенда не закрывает ни одной части рисунка, сколько бы строк она ни содержала. В панели, слишком низкой, чтобы оставить место над легендой, рисунок подгоняется под всю панель.

Выбор узла открывает панель со списком того, что к нему присоединено: для каждого присоединения — сущность Feature и её разрешённая версия, слот, который оно заполняет, или то, что оно не заполняет ни одного объявленного слота, сущность FeatureRecipe, которая его реализует, с именем и версией, когда скомпилированный граф её называет, его происхождение, объявленные им метки и значения, записанные его автором. Присоединение, записанное на одном из соединений компонента, — под features: в записи uses, в сущности Aggregate или Release, — в этот список не входит: оно рисуется на соединении, к которому относится, так, как его фиксирует скомпилированный граф, а панель узла сообщает, когда у его соединений есть присоединения.

Щелчок по ребру выбирает соединение, которое оно изображает, и открывает для него панель с заголовком из компонента-потребителя и его цели, с указанием сокета и псевдонима, где присоединения этого соединения показаны так же, как у узла, — для каждого сущность Feature и её разрешённая версия, заполняемый слот, сущность FeatureRecipe, которая его реализует, когда скомпилированный граф её называет, и его значения, — или фраза о том, что к нему ничего не присоединено. Выбор узла снимает выбор соединения, и наоборот; Escape или кнопка закрытия панели снимает любой из них, а перерисовка сохраняет выбор, пока перестроенный граф по-прежнему рисует этот узел или соединение от того же компонента через тот же сокет под тем же псевдонимом.

Под присоединениями узла, в разделе May attach, панель перечисляет сущности Features, объявленной применимости которых удовлетворяют метки этого узла на графе сущности Release, показанной в панели, — сущности Features, объявленные документами рабочего пространства, которые читает эта сущность Release, все, кроме находящихся в папке каталога, которую читают только другие сущности Releases, а также содержащиеся в папках каталогов, с которыми собирается эта сущность Release, — каждую с её видом и либо файлом рабочего пространства, который её объявляет, либо настроенным каталогом, из которого она разрешена. Этот список показывает, к чему эти сущности Features объявляют свою применимость, а не решение о том, что присоединение одной из них даст успешную сборку, — а когда он пуст, он сообщает, что объявленная применимость ни одной сущности Feature не соответствует этим меткам, и это более узкое утверждение, чем то, что ничего нельзя присоединить. Запрос, на который языковой сервер не смог ответить, сообщает об этом вместо списка, а не оставляет его пустым. Сущность Feature, объявленная за ссылкой, ведущей за пределы рабочего пространства, — ссылкой на внешнюю папку или ссылкой с именем как у файла YAML, ведущей к внешнему файлу, — не предлагается, поскольку языковой сервер не читает ни одну сущность через такую ссылку, хотя дерево файлов вашего редактора показывает эту сущность Feature. Если рабочее пространство содержит такую ссылку, об этом сообщает строка под списком или под фразой, заменяющей пустой список: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Сущности Features, доступные через эту ссылку, не предлагаются, поскольку она ведёт за пределы рабочего пространства Aggrega:), а за ней путь ссылки относительно рабочего пространства, — или Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Сущности Features, доступные через эти ссылки, не предлагаются, поскольку каждая из них ведёт за пределы рабочего пространства Aggrega:) для нескольких, сначала ссылки на папки. Она называет ссылки, о которых сообщает языковой сервер, в терминах сущности Release, показанной в панели, как это делает панель Catalog в терминах выбранной сущности Release. Если это сообщение невозможно прочитать, список рисуется без строки, а причина записывается в канал вывода Aggrega; у списка, который не удалось построить, такой строки нет.

Граф топологии с выбранным компонентом web, а рядом панель, сообщающая, что к нему ничего не присоединено, и перечисляющая в разделе May attach сущности Features, которые можно присоединить, каждую с элементом управления Attach.

Каждая строка имеет элемент управления Attach, который её применяет: у компилятора запрашивается, какой документ объявляет выбранный компонент и где в этом документе должно находиться такое присоединение, и запись вносится туда через редактор — поэтому она попадает в историю отмены, оказывается в буфере, который вы просматриваете, а не в последней версии, сохранённой на диске, и оставляет окружающие комментарии и форматирование такими, какими вы их написали. Ничего не сохраняется от вашего имени; эта правка — такое же изменение, как любое другое, и компилятор повторно проверяет её, как после любой правки. Граф перерисовывается при сохранении, поскольку топология компилируется из документов в том виде, в каком они находятся на диске, а присоединение, которое ещё остаётся в буфере, пока не является их частью. Присоединение получает имя сущности Feature, а попытка присоединить сущность Feature, уже присоединённую под этим именем, отклоняется, а не записывается дважды. Компонент, объявленный внутри подсистемы, присоединяется тем же нажатием, что и компонент, объявленный на верхнем уровне, и оба варианта работают по одной и той же причине: граф идентифицирует компонент по его позиции в скомпилированной топологии, эта позиция не говорит, какие ключи записал автор компонента, поэтому расширение запрашивает, а не реконструирует, — ответ называет документ и путь к блоку в нём, и оба переносятся в правку такими, какими пришли. Если такого места, которое можно назвать, нет — идентификатора, которого нет в графе, узла, для которого он не фиксирует ни одного документа, или компонента, собственный блок которого невозможно назвать в документе, где он написан, — панель показывает причину, которую дал компилятор, а не собственную формулировку этого расширения.

Панель выбранного соединения имеет собственный раздел May attach: слоты, которые объявляет socket этого соединения, в порядке их объявления компонентом, каждый с указанием, обязателен ли он, работает ли то, что его заполняет, с конфиденциальными данными, какой способ доставки он допускает, его селектора и описания, а под каждым слотом — Features, которые, по ответу языкового сервера, могут заполнить его на этом соединении: те, чью объявленную применимость удовлетворяют метки компонента-потребителя и чьи собственные метки удовлетворяют селектору слота. Там, где ни один слот нельзя заполнить, панель объясняет причину в терминах языкового сервера — соединение нарисовала сущность Feature, socket не входит в объявленные компонентом или socket не объявляет слотов — и ничего не предлагает для присоединения. Нажатие Attach под слотом записывает сущность Feature под именем слота, как запись <slot>:, чей type: называет эту сущность Feature, в запись этого соединения в документе, который нарисовал соединение: в сущность Release для соединения, нарисованного сущностью Release, иначе — в сущность Aggregate. Соединение, выбранное из его записи в документе с помощью Aggrega: Attach a Feature to the connection at the cursor, вместо этого записывается в этот документ — в сущность Release для собственной записи сущности Release о соединении, нарисованном сущностью Aggregate, — и тогда строка панели под May attach сообщает, что сущность Feature записывается в запись этого соединения в документе, где была выполнена команда. У компилятора запрашивается, где эта запись должна находиться в этом документе, любая часть пути, которой в документе ещё нет, записывается вместе с ней, а правка попадает в редактор так же, как для узла, несохранённой. Слот, который граф уже показывает заполненным на этом соединении, отклоняется прежде, чем что-либо будет запрошено, а отказ компилятора показывается его собственными словами.

Значение, которое компилятор помечает как конфиденциальное, языковой сервер исключает из отправляемого графа, а расширение исключает ещё раз, прежде чем граф вообще будет передан представлению, поэтому в представлении его нет, чтобы показать, — панель называет поле и объясняет, почему оно скрыто, а присоединение, пометка конфиденциальности которого имеет форму, не распознаваемую панелью, скрывает все значения, а не пытается угадать. Присоединение, нарисованное на соединении, скрывается по точно тому же правилу, что и нарисованное на узле, при той же настройке. aggrega.graph.showSensitiveValues отключает скрытие для автора, которому нужно перечитать написанное: только пока она включена, запрос графа запрашивает эти значения у языкового сервера, а страница настроек объясняет, что при этом отображается.

Узлы располагаются в том порядке, в котором запускаются волны сущности Release, поэтому boundary, объявляющая syncWave:, появляется раньше boundary, которые её ожидают. При наведении указателя на узел показываются его компонент и разрешённая версия, метки, объявленная волна и собственные метаданные сущности каталога — лицензия, репозиторий, домашняя страница, ключевые слова и сопровождающие, — причём только те поля, которые сущность действительно объявляет.

Открытый граф перерисовывается каждый раз, когда в рабочей области сохраняется написанный документ, поэтому он следует за вашими правками без повторного открытия; он перерисовывается при сохранении, а не при каждом нажатии клавиши, потому что топология компилируется из того, что находится на диске. Он перерисовывается и тогда, когда записывается lock-файл выбранной сущности Release — командой Aggrega: Pull, сборкой с Auto pull или aggrega pull в терминале, — потому что граф закреплён за этим lock-файлом, а также когда языковой сервер снова становится доступен, поэтому граф, оставленный открытым во время перезапуска, восстанавливается сам.

Перерисовка, которую вы не запрашивали, оставляет представление там, где вы его поставили: панорамирование и масштаб сохраняются независимо от того, отличается ли перестроенная топология, поэтому узел, который перестроенная раскладка ставит туда, где он был, остаётся под той же частью панели, а узел, который она ставит в другое место, — добавленный компонент может сдвинуть соседние, — перемещается в пределах сохранённого представления, а не тянет представление за собой. Это относится и к перерисовке, которая происходит, пока граф находится за другой вкладкой: вы возвращаетесь к нему таким, каким его оставили.

Aggrega: Show topology graph снова вписывает рисунок в панель — так можно вернуться к общей форме после увеличения её части. Большая топология вписывается целиком, а не обрезается, поэтому большая появляется мелкой: видно, как она устроена, а до имён можно добраться увеличением. Там, где две или более группы в одном блоке расположились бы выше, чем шире, они рисуются рядом друг с другом, а не стопкой в одном столбце, поэтому большая топология использует ширину панели, а первое вписывание рисует её крупнее, чем позволил бы один столбец.

Перестроение, которое компилятор отклоняет, сохраняет прежний рисунок вместо того, чтобы очищать его, — топологию по-прежнему стоит читать, и она по-прежнему там, где вы работали, — и приглушает его, чтобы рисунок, который уже не актуален, не приняли за актуальный; уведомление над ним содержит причину, названную самим компилятором. Как только будет построен новый рисунок, он снова отображается в полную силу. Раскладка вычисляется в представлении; компилятор поставляет топологию, а не координаты.