Перейти до вмісту
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 знову підганяє малюнок під панель — так можна повернутися до цілої форми після збільшення її частини. Велику топологію підганяють цілком, а не обрізають, тож велика з’являється дрібною: видно, як її складено, а до назв можна дістатися збільшенням. Там, де дві або більше групи в одному блоці розташувалися б вищими, ніж ширшими, їх малюють поруч, а не одна над одною в стовпці, тож велика топологія використовує ширину панелі, а перше підганяння малює її більшою, ніж дозволив би один стовпець.

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