Alat pembangun · Perbandingan teks
Cara Membaca Perbezaan Bersatu: Pengepala Hunk, Garis Konteks dan +/- Penanda
· Latar belakang
perbezaan teks tompok aliran kerja pembangun
Menyahkod format perbezaan bersatu baris demi baris, daripada pengepala fail dan julat @@ hunk kepada baris konteks dan menukar penanda, jadi tampalan daripada sebarang alat masuk akal.
Dinding tambah, tolak dan simbol @@ — dibuka dengan pertemuan pertama dengan tampalan dalam e-mel atau permintaan tarik
`changes.patch` yang dimuat turun bermula dengan tanda baca yang menyerupai output perbezaan yang biasa, tetapi struktur tepatnya penting. ToolAcre menulis dua label dan kemudian setiap baris perbandingan dengan penanda satu aksara. Membaca apa yang wujud adalah lebih selamat daripada medan membekalkan mental daripada format tampung yang lain.
Buka fail dalam editor teks biasa. Dua baris pertama mengenal pasti label kiri dan kanan yang dibekalkan oleh UI sebagai `original` dan `changed`. Baris berikutnya membina semula teks yang dibandingkan melalui penanda konteks, penyingkiran dan penambahan.
Baris pengepala fail — menerangkan baris --- dan +++, laluan dan alat awalan a/ dan b/ tambah
Pengepala ialah `--- original` diikuti dengan `+++ changed`. Dalam alat lain, awalan tersebut mungkin berada dalam tatabahasa tampung yang lebih kaya, tetapi pengeksport ini tidak menambah cap masa, laluan atau metadata. Label menggambarkan sisi, bukan fail yang terbukti wujud pada cakera.
Perbezaan itu penting kerana Text diff menerima rentetan yang ditampal dan bukannya objek fail. Muat turun mencipta laporan teks tempatan selepas perbandingan. Merawat label sebagai laluan repositori atau pengecam semakan akan mengaitkan asal yang tidak pernah dikumpulkan oleh UI.
Tajuk besar diterangkan — menyahkod @@ -12,7 +12,8 @@ sebagai baris permulaan dan kiraan baris untuk setiap sisi
Tiada baris yang bermula dengan `@@` dalam `toUnifiedText`. Fungsi memetakan terus ke atas semua baris selepas dua label. Akibatnya output ini tidak mempunyai julat sekerat untuk dinyahkod dan tiada pasangan baris permulaan/count dibenamkan dalam teks yang dimuat turun.
Nombor baris kekal tersedia dalam paparan pelayar yang diberikan, di mana baris membawa kedudukan kiri dan kanan. Eksport memilih perwakilan yang lebih mudah. Jika program hiliran memerlukan hunks bersatu yang lengkap dengan standard, sahkan keserasian dan bukannya menganggap sambungan `.patch` membekalkan sintaks yang tiada.
ToolAcre tidak mengeluarkan tajuk @@ hunk, jadi tiada satu pun untuk dinyahkod
Ruang hadapan menandakan baris yang tidak berubah, tolak menandakan penyingkiran kiri dan tambah menandakan penambahan kanan. UI boleh meruntuhkan larian yang sama lama secara visual, tetapi `lastDiff` mengekalkan hasil lengkap dan muat turun mensiri semua baris. Tiada penanda langkau memasuki rentetan tampung.
Garis besar menyebut tiga baris konteks sebagai lalai. Tiga digunakan oleh panggilan runtuh visual, bukan oleh eksport. Menggabungkan laluan tersebut akan mengecilkan kandungan yang dimuat turun. Pembentangan dan siri berkongsi baris tetapi menggunakan transformasi yang berbeza.
Muat turun menandakan setiap baris dan tidak menggunakan lalai konteks tiga baris
Bandingkan bahagian kiri `a b` dengan bahagian kanan `a c`. Baris yang dieksport ialah dua label, kemudian space-a, minus-b dan plus-c. Bacaan dari atas ke bawah menunjukkan bahawa `a` kekal, `b` meninggalkan teks asal dan `c` memasuki bahagian yang diubah.
Oleh itu, pengubahsuaian diwakili sebagai penyingkiran dan penambahan bersebelahan apabila penjajaran meletakkannya bersama. Format tidak menamakannya "diubah suai." Jika baris berulang membenarkan penjajaran lain, jujukan boleh kelihatan berbeza semasa masih mengambil kira setiap baris input.
Contoh yang berjaya: baca strim penuh berbentuk tampalan yang ToolAcre sebenarnya dieksport
Format perbezaan yang disatukan biasa, konteks dan lengkap mempunyai spesifikasi dan sejarah tersendiri, tetapi ia tidak dilaksanakan atau didokumenkan oleh set sumber yang digunakan di sini. Artikel ini tidak mendakwa mengapa satu format menjadi popular atau senarai medan ToolAcre tidak dipancarkan.
Gunakan arahan kawalan versi apabila alat lain mesti menggunakan tampung. Muat turun ToolAcre berguna sebagai artifak semakan mudah alih, namun repositori tidak mengandungi penghurai tampalan atau guna fungsi yang membuktikan ia boleh pergi balik melalui pengguna tampung sewenang-wenangnya.
Perbandingan format bersatu, konteks dan normal yang lengkap memerlukan sumber luaran
Tampalan binari, menamakan semula pengepala, perubahan mod dan aplikasi berada di luar laluan ini. Teks tidak mengandungi pengecam objek atau nenek moyang yang sama. Ia tidak boleh mewakili operasi repositori sahaja kerana penandanya kelihatan biasa.
Pengeksport juga mencerminkan pilihan perbandingan aktif. Baris yang dianggap sama selepas penormalan huruf besar atau ruang kosong membawa teks kiri asal sahaja, jadi dokumen berbentuk tampalan bukanlah pembinaan semula bait demi bait bagi kedua-dua input di bawah padanan longgar.
Bawa pulang: perbezaan ialah cerita yang dimampatkan — meringkaskan susunan bacaan dan mencatat cara Perbandingan Teks ToolAcre menunjukkan jenis perubahan yang sama seperti baris yang diserlahkan untuk semakan pantas
Baca dua label dahulu, kemudian tafsirkan setiap baris awalan mengikut tertib. Jika anda memerlukan nombor baris yang diberikan, kembali ke paparan pelayar. Jika anda memerlukan orang yang lengkap dengan piawaian, hasilkan mereka dengan alat yang mendokumenkan kontrak itu.
ToolAcre menyediakan cara padat untuk mengambil perbandingan di luar halaman tanpa menuntut untuk melaksanakan setiap ciri tampung. Nama yang lebih sempit itu—output berbentuk patch—memastikan jangkaan sejajar dengan fungsi yang tepat dan mengelakkan janji palsu tentang keserasian aplikasi.