Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Grafik topologi

Topology graph — merender IR terkompilasi dari Release yang dipilih sebagai grafik interaktif: kontainer batas dan subsistem, dengan setiap batas atau subsistem yang dideklarasikan di dalam yang lain digambar di dalamnya, sisi yang diberi gaya sesuai asal-usulnya, geser dan zoom, klik node untuk memilihnya dan klik ganda untuk membuka file sumbernya, serta klik sisi untuk memilih koneksi yang digambarnya.

Grafik topologi sebuah Release: tiga komponen di dalam kotak yang menampung node yang tidak dideklarasikan oleh batas atau subsistem mana pun, sisi dari komponen web ke basis data dan cache-nya, serta legenda di kiri bawah.

Judul setiap kontainer menyebutkan jenisnya selain pengelompokannya, sehingga kotak luar dan kotak dalam dapat dibedakan bahkan di workspace yang tidak mendeklarasikan keduanya — yang jika tidak, keduanya akan membawa nama yang sama. Pengelompokan yang tidak dideklarasikan siapa pun, yang dibuat kompiler untuk komponen yang dicantumkan sebuah Release atau Aggregate di tingkat teratas, diberi judul yang menyatakan bahwa tidak ada yang dideklarasikan, dan kotaknya digambar berbeda dari kotak pengelompokan yang dideklarasikan — dengan garis tepi bertitik yang netral — agar tidak terbaca sebagai pengelompokan dengan nama itu; pengelompokan yang Anda deklarasikan tetap memakai namanya apa pun itu, termasuk default.

Setiap sisi memiliki kepala panah di ujung yang ditunjuknya: sisi berjalan dari komponen konsumen ke targetnya, dan kepala panah digambar dengan warna dan pola putus-putus milik sisi itu sendiri. Kotak node diukur berdasarkan teks yang digambarnya, baik nama node maupun komponen di bawahnya, sehingga keduanya tidak melewati garis tepinya seberapa pun panjang nama komponennya.

Legenda di kiri bawah menamai setiap pengelompokan berdasarkan dokumen yang mendeklarasikannya — batas berdasarkan Release, subsistem berdasarkan Aggregate — dan, jika gambar memilikinya, kotak yang menampung node yang tidak termasuk dalam pengelompokan mana pun, beserta isinya; legenda menunjukkan ujung sisi mana yang merupakan targetnya; dan menamai bilah warna di sepanjang tepi depan node serta setiap warna yang diberikan gambar kepadanya, di samping nilai component.aggrega.ai/type yang diwakili warna itu, persis seperti label tersebut ditulis, dengan satu baris untuk node yang tidak memiliki label seperti itu jika ada. Legenda juga menyatakan apa yang tidak dimaksud oleh warna-warna itu: warna ditetapkan setiap kali grafik digambar, sehingga warna mengelompokkan node berdasarkan tipe dalam satu grafik, dan warna yang sama di grafik lain bukan tipe yang sama. Legenda tetap di tempatnya apa pun yang Anda lakukan pada gambar, sehingga setiap kali gambar disesuaikan dengan panel — saat pertama kali digambar, dan setiap kali Anda meminta grafik — gambar disesuaikan dengan bagian panel di atas legenda: dalam seluruh lebar panel dan tinggi yang tersisa di atas legenda, diposisikan di tengah secara horizontal, sehingga legenda tidak menutupi bagian mana pun dari gambar berapa pun jumlah barisnya. Pada panel yang terlalu pendek untuk menyisakan ruang di atas legenda, gambar disesuaikan dengan seluruh panel.

Memilih node akan membuka panel yang mencantumkan apa yang dilampirkan padanya: untuk setiap lampiran, Feature dan versi yang di-resolve, slot yang diisinya atau bahwa lampiran itu tidak mengisi slot yang dideklarasikan, FeatureRecipe yang merealisasikannya, beserta nama dan versinya, jika grafik terkompilasi menyebutkannya, asal-usulnya, label yang dideklarasikannya, dan nilai yang ditulis oleh pembuatnya. Lampiran yang ditulis pada salah satu koneksi komponen — di bawah features: pada entri uses, di Aggregate atau Release — tidak ada dalam daftar itu: lampiran tersebut digambar pada koneksi tempatnya berada, sebagaimana dicatat oleh grafik terkompilasi, dan panel node menyatakan jika koneksinya memiliki lampiran.

Mengklik sisi akan memilih koneksi yang digambarnya dan membuka panel untuknya, berjudul komponen konsumen dan targetnya serta menyebutkan socket dan alias, dengan lampiran koneksi itu ditampilkan seperti lampiran node — untuk masing-masing, Feature dan versi yang di-resolve, slot yang diisinya, FeatureRecipe yang merealisasikannya jika grafik terkompilasi menyebutkannya, serta nilainya — atau sebuah kalimat yang menyatakan bahwa tidak ada yang dilampirkan padanya. Memilih node akan menghapus pilihan koneksi, begitu pula sebaliknya; Escape atau tombol tutup panel menghapus salah satunya, dan penggambaran ulang mempertahankan pilihan selama grafik yang dibangun ulang masih menggambar node tersebut, atau koneksi dari komponen yang sama melalui socket yang sama dengan alias yang sama.

Di bawah lampiran node, pada May attach, panel mencantumkan Features yang penerapan terdeklarasinya dipenuhi oleh label node itu pada grafik Release yang ditampilkan panel — Features yang dideklarasikan oleh dokumen di workspace yang dibaca Release itu, semuanya kecuali yang berada di direktori katalog yang hanya dibaca oleh Releases lain, serta yang ada di direktori katalog yang menjadi dasar build Release itu — masing-masing disebutkan dengan jenisnya dan dengan file workspace yang mendeklarasikannya atau katalog terkonfigurasi tempat ia di-resolve. Daftar itu adalah hal yang dinyatakan berlaku oleh Features tersebut, bukan keputusan bahwa melampirkan salah satunya akan menghasilkan build yang berhasil — dan saat kosong, daftar itu menyatakan bahwa penerapan terdeklarasi dari Feature mana pun tidak cocok dengan label tersebut, yang merupakan pernyataan lebih sempit daripada tidak ada yang dapat dilampirkan. Permintaan yang tidak dapat dijawab oleh server bahasa menyatakan hal itu di tempat daftar, alih-alih membiarkannya kosong. Feature yang dideklarasikan di balik tautan yang mengarah ke luar workspace — tautan ke direktori di luar, atau tautan yang dinamai seperti file YAML yang mengarah ke file di luar — tidak ditawarkan, karena server bahasa tidak membaca entitas apa pun melalui tautan seperti itu, meskipun pohon file editor Anda menampilkan Feature tersebut. Jika workspace memuat tautan seperti itu, sebuah baris di bawah daftar, atau di bawah kalimat yang menggantikan daftar kosong, menyatakannya: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Features yang dijangkau melalui tautan ini tidak ditawarkan, karena tautan ini mengarah ke luar workspace Aggrega:) diikuti jalur tautan relatif terhadap workspace — atau Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Features yang dijangkau melalui tautan-tautan ini tidak ditawarkan, karena masing-masing mengarah ke luar workspace Aggrega:) untuk beberapa tautan, dengan tautan ke direktori terlebih dahulu. Baris itu menyebutkan tautan yang dilaporkan server bahasa dalam konteks Release yang ditampilkan panel, sebagaimana panel Catalog melakukannya dalam konteks Release yang dipilih. Jika laporan itu tidak dapat dibaca, daftar digambar tanpa baris tersebut dan alasannya ditulis ke kanal output Aggrega; daftar yang tidak dapat dihasilkan tidak memiliki baris itu.

Grafik topologi dengan komponen web dipilih, dan panel di sampingnya yang menyatakan bahwa tidak ada yang dilampirkan padanya serta mencantumkan di bawah May attach Features yang dapat dilampirkan, masing-masing dengan kontrol Attach.

Setiap baris memiliki kontrol Attach yang menerapkannya: kompiler ditanya dokumen mana yang mendeklarasikan komponen yang dipilih dan di bagian mana dalam dokumen itu lampiran seperti itu seharusnya berada, lalu entri ditulis di sana melalui editor — sehingga entri masuk ke riwayat undo, mendarat di buffer yang sedang Anda lihat, bukan di versi terakhir yang disimpan ke disk, dan membiarkan komentar serta format di sekitarnya seperti yang Anda tulis. Tidak ada yang disimpan atas nama Anda; pengeditan itu adalah perubahan seperti perubahan lainnya, dan kompiler memvalidasinya ulang seperti setelah pengeditan apa pun. Grafik digambar ulang saat Anda menyimpan, karena topologi dikompilasi dari dokumen sebagaimana adanya di disk, dan lampiran yang masih berada di buffer belum menjadi bagiannya. Lampiran diberi nama sesuai Feature, dan melampirkan Feature yang sudah dilampirkan dengan nama itu akan ditolak alih-alih ditulis dua kali. Komponen yang dideklarasikan di dalam subsistem dilampiri dengan tekanan yang sama seperti komponen yang dideklarasikan di tingkat teratas, dan keduanya berfungsi karena alasan yang sama: grafik mengidentifikasi komponen berdasarkan posisinya dalam topologi terkompilasi, posisi itu tidak menyatakan kunci mana yang ditulis pembuat komponen, sehingga ekstensi bertanya alih-alih merekonstruksi — jawabannya menyebutkan dokumen dan jalur ke blok di dalamnya, dan keduanya dibawa ke dalam pengeditan sebagaimana diterima. Jika tidak ada tempat seperti itu untuk disebutkan — id yang tidak dimiliki grafik, node yang tidak dicatatkan dokumennya, atau komponen yang bloknya sendiri tidak dapat disebutkan di dokumen tempat ia ditulis — yang ditampilkan panel adalah alasan yang diberikan kompiler, bukan rumusan milik ekstensi ini sendiri.

Panel koneksi yang dipilih memiliki bagian May attach sendiri: slot yang dideklarasikan socket koneksi tersebut, dalam urutan komponen mendeklarasikannya, masing-masing dengan keterangan apakah wajib, apakah yang mengisinya menangani materi sensitif, mode pengiriman yang diizinkannya, selektornya, dan deskripsinya, serta di bawah setiap slot, Features yang menurut jawaban server bahasa dapat mengisinya pada koneksi tersebut — yaitu yang penerapan terdeklarasinya dipenuhi oleh label komponen konsumen dan yang label miliknya sendiri memenuhi selektor slot. Jika tidak ada slot yang dapat diisi, panel menjelaskan alasannya dalam istilah server bahasa — sebuah Feature menggambar koneksi tersebut, socket tersebut bukan salah satu yang dideklarasikan komponen, atau socket tidak mendeklarasikan slot — dan tidak menawarkan apa pun untuk dilampirkan. Menekan Attach di bawah sebuah slot menulis Feature dengan nama slot tersebut, berupa entri <slot>: yang type:-nya menyebutkan Feature tersebut, pada entri koneksi itu dalam dokumen yang menggambar koneksi: Release untuk koneksi yang digambar Release, dan Aggregate untuk selainnya. Koneksi yang dipilih dari entrinya dalam sebuah dokumen, melalui Aggrega: Attach a Feature to the connection at the cursor, justru ditulis di dokumen tersebut — Release, untuk entri milik Release sendiri bagi koneksi yang digambar Aggregate — dan baris panel di bawah May attach kemudian menyatakan bahwa Feature ditulis pada entri koneksi itu dalam dokumen tempat perintah dijalankan. Kompiler ditanya di mana entri itu ditempatkan dalam dokumen tersebut, bagian jalur yang belum dimuat dokumen ditulis bersamanya, dan suntingan masuk ke editor seperti suntingan sebuah node, dalam keadaan belum disimpan. Slot yang sudah ditunjukkan grafik terisi pada koneksi tersebut ditolak sebelum apa pun ditanyakan, dan penolakan dari kompiler ditampilkan dengan kata-katanya sendiri.

Nilai yang dilaporkan kompiler sebagai sensitif ditahan oleh server bahasa dari grafik yang dikirimkannya, dan ditahan lagi oleh ekstensi sebelum grafik diserahkan ke tampilan sama sekali, sehingga nilai itu tidak ada di tampilan untuk ditampilkan — panel menyebutkan nama kolomnya dan menjelaskan alasan penahanannya, dan lampiran yang penanda sensitivitasnya berbentuk yang tidak dikenali panel menahan setiap nilai alih-alih menebak. Lampiran yang digambar pada koneksi ditahan dengan aturan yang persis sama seperti yang digambar pada node, di bawah pengaturan yang sama. aggrega.graph.showSensitiveValues menonaktifkan penahanan bagi penulis yang perlu membaca kembali apa yang ditulisnya: hanya selama pengaturan ini aktif, permintaan grafik meminta nilai-nilai tersebut ke server bahasa, dan halaman pengaturan menjelaskan apa yang ditampilkan karenanya.

Node disusun menurut urutan gelombang Release dinyalakan, sehingga boundary yang mendeklarasikan syncWave: muncul lebih dulu daripada boundary yang menunggunya. Mengarahkan penunjuk ke sebuah node menampilkan komponennya dan versi yang telah di-resolve, labelnya, gelombang yang dideklarasikannya, dan metadata milik entitas katalog itu sendiri — lisensi, repositori, beranda, kata kunci, dan pengelola — dengan hanya menampilkan kolom yang benar-benar dideklarasikan entitas tersebut.

Grafik yang terbuka merender ulang dirinya setiap kali dokumen yang ditulis di ruang kerja disimpan, sehingga mengikuti suntingan Anda tanpa perlu dibuka ulang; grafik digambar ulang saat penyimpanan, bukan pada setiap ketukan tombol, karena topologi dikompilasi dari apa yang ada di disk. Grafik juga digambar ulang saat lockfile Release yang dipilih ditulis — oleh Aggrega: Pull, oleh build dengan Auto pull, atau oleh aggrega pull di terminal — karena grafik disematkan pada lockfile tersebut, dan juga saat server bahasa dapat menjawab lagi, sehingga grafik yang dibiarkan terbuka selama restart pulih dengan sendirinya.

Penggambaran ulang yang tidak Anda minta membiarkan tampilan Anda di tempat Anda meletakkannya: geseran dan zoom yang Anda miliki dipertahankan, baik topologi yang dibangun ulang berbeda maupun tidak, sehingga node yang diletakkan tata letak baru di tempat semula tetap berada di bawah bagian panel yang sama, dan node yang diletakkannya di tempat lain — komponen yang ditambahkan dapat menggeser komponen di sekitarnya — bergerak di dalam tampilan yang Anda pertahankan alih-alih membawa tampilan bersamanya. Hal ini termasuk penggambaran ulang yang terjadi saat grafik berada di balik tab lain, yang akan Anda temui kembali seperti saat Anda meninggalkannya.

Aggrega: Show topology graph menyesuaikan gambar dengan panel lagi, yang merupakan cara kembali ke bentuk utuh setelah memperbesar sebagian darinya. Topologi besar disesuaikan secara utuh, bukan dipotong, sehingga topologi besar tampil kecil: Anda melihat bagaimana susunannya, dan menjangkau nama-nama dengan memperbesar. Jika dua pengelompokan atau lebih yang dimuat dalam satu kotak tersusun lebih tinggi daripada lebarnya, pengelompokan itu digambar bersebelahan alih-alih ditumpuk dalam satu kolom, sehingga topologi besar memanfaatkan lebar panel dan penyesuaian pertamanya menggambarnya lebih besar daripada yang dimungkinkan satu kolom.

Pembangunan ulang yang ditolak kompiler mempertahankan gambar yang Anda miliki alih-alih mengosongkannya — topologi masih layak dibaca dan masih merupakan tempat Anda bekerja — dan meredupkannya, sehingga gambar yang tidak lagi terkini tidak dikira terkini; pemberitahuan di atasnya memuat alasan dari kompiler sendiri. Gambar kembali ke intensitas penuh segera setelah gambar baru dibangun. Tata letak dihitung di tampilan; kompiler mengirimkan topologi, tidak pernah koordinat.