git-interpret-trailers - Online di Cloud

PROGRAM:

NAMA

git-interpret-trailers - bantu menambahkan informasi terstruktur ke dalam pesan komit

RINGKASAN

git menafsirkan-trailer [--trim-kosong] [(--trailer [(=|:) ])...] [ ...]

DESKRIPSI

Bantuan menambahkan trailer baris, yang terlihat mirip dengan header email RFC 822, di akhir
jika tidak, bagian bentuk bebas dari pesan komit.

Perintah ini membaca beberapa tambalan atau melakukan pesan baik dari argumen atau
masukan standar jika tidak ada ditentukan. Kemudian perintah ini menerapkan argumen yang diteruskan
menggunakan opsi --trailer, jika ada, ke bagian pesan komit dari setiap file input. NS
hasilnya dipancarkan pada output standar.

Beberapa variabel konfigurasi mengontrol cara argumen --trailer diterapkan ke masing-masing
pesan komit dan cara perubahan cuplikan yang ada dalam pesan komit. Mereka
juga memungkinkan untuk menambahkan beberapa trailer secara otomatis.

Secara default, a = or : argumen yang diberikan menggunakan --trailer akan menjadi
ditambahkan setelah trailer yang ada hanya jika trailer terakhir memiliki perbedaan ( ,
) memasangkan (atau jika tidak ada cuplikan yang ada). NS dan bagian akan
dipangkas untuk menghapus spasi awal dan akhir, dan hasilnya dipangkas dan
akan muncul pesan seperti ini:

tanda: nilai

Artinya dipangkas dan akan dipisahkan oleh ': ' (satu titik dua
diikuti oleh satu spasi).

Secara default, trailer baru akan muncul di akhir semua trailer yang ada. Jika ada
tidak ada cuplikan yang ada, cuplikan baru akan muncul setelah bagian pesan komit dari
output, dan, jika tidak ada baris dengan hanya spasi di akhir bagian pesan komit,
satu baris kosong akan ditambahkan sebelum trailer baru.

Trailer yang ada diekstraksi dari pesan input dengan mencari sekelompok satu atau
lebih banyak baris yang berisi titik dua (secara default), di mana grup didahului oleh satu atau lebih
baris kosong (atau hanya spasi putih). Grup harus berada di akhir pesan atau berada
baris non-spasi terakhir sebelum baris yang dimulai dengan ---. Tiga tanda minus seperti itu
mulai bagian tambalan pesan.

Saat membaca trailer, mungkin ada spasi putih sebelum dan sesudah token, pemisah
dan nilainya. Bisa juga ada spasi putih di dalam token dan nilainya.

Perhatikan bahwa trailer jangan ikuti dan tidak dimaksudkan untuk mengikuti banyak aturan untuk RFC 822
header. Misalnya mereka tidak mengikuti aturan pelipatan garis, aturan pengkodean dan
mungkin banyak aturan lainnya.

PILIHAN

--trim-kosong
jika bagian dari cuplikan apa pun hanya berisi spasi, seluruh cuplikan akan menjadi
dihapus dari pesan yang dihasilkan. Ini berlaku untuk trailer yang sudah ada maupun yang baru
trailer.

--cuplikan [(=|:) ]
Tentukan ( , ) pasangan yang harus diterapkan sebagai cuplikan ke input
pesan. Lihat deskripsi perintah ini.

KONFIGURASI VARIABEL

trailer.separator
Opsi ini memberi tahu karakter mana yang dikenali sebagai pemisah trailer. Secara default
hanya : diakui sebagai pemisah trailer, kecuali bahwa = selalu diterima di
baris perintah untuk kompatibilitas dengan perintah git lainnya.

Karakter pertama yang diberikan oleh opsi ini akan menjadi karakter default yang digunakan saat
pemisah lain tidak ditentukan dalam konfigurasi untuk cuplikan ini.

Misalnya, jika nilai untuk opsi ini adalah "%=$", maka hanya baris yang menggunakan format
dengan mengandung %, = or $ dan kemudian spasi akan dipertimbangkan
trailer. Dan % akan menjadi pemisah default yang digunakan, jadi secara default trailer akan muncul
seperti: % (tanda satu persen dan satu spasi akan muncul di antara token
dan nilainya).

trailer.di mana
Opsi ini memberi tahu di mana trailer baru akan ditambahkan.

Ini bisa berakhir, yang merupakan default, mulai, setelah atau sebelum.

Jika sudah berakhir, maka setiap trailer baru akan muncul di akhir trailer yang ada.

Jika dimulai, maka setiap trailer baru akan muncul di awal, bukan di akhir, dari
trailer yang ada.

Jika setelahnya, maka setiap trailer baru akan muncul tepat setelah trailer terakhir dengan
sama .

Jika sebelumnya, maka setiap trailer baru akan muncul tepat sebelum trailer pertama dengan
sama .

trailer.ifexists
Opsi ini memungkinkan untuk memilih tindakan apa yang akan dilakukan ketika ada
sudah setidaknya satu trailer dengan yang sama dalam pesan.

Nilai yang valid untuk opsi ini adalah: addIfDifferentNeighbor (ini adalah default),
addIfDifferent, tambahkan, timpa, atau lakukanNothing.

Dengan addIfDifferentNeighbor, cuplikan baru akan ditambahkan hanya jika tidak ada cuplikan dengan
sama ( , ) pasangan berada di atas atau di bawah garis di mana trailer baru akan berada
menambahkan.

Dengan addIfDifferent, trailer baru akan ditambahkan hanya jika tidak ada trailer dengan yang sama
( , ) pasangan sudah ada dalam pesan.

Dengan add, trailer baru akan ditambahkan, meskipun beberapa trailer dengan yang sama ( ,
) pasangan sudah ada di pesan.

Dengan ganti, trailer yang ada dengan yang sama akan dihapus dan yang baru
trailer akan ditambahkan. Trailer yang dihapus akan menjadi yang paling dekat (dengan yang sama
) ke tempat yang baru akan ditambahkan.

Dengan doNothing, tidak ada yang akan dilakukan; itu tidak ada trailer baru yang akan ditambahkan jika ada
sudah satu dengan yang sama dalam pesan.

trailer.jika hilang
Opsi ini memungkinkan untuk memilih tindakan apa yang akan dilakukan ketika ada
belum ada trailer dengan yang sama dalam pesan.

Nilai yang valid untuk opsi ini adalah: add (ini default) dan doNothing.

Dengan menambahkan, trailer baru akan ditambahkan.

Dengan doNothing, tidak ada yang akan dilakukan.

cuplikan. .kunci
Kunci ini akan digunakan sebagai pengganti di trailernya. Di akhir kunci ini, a
pemisah dapat muncul dan kemudian beberapa karakter spasi. Secara default satu-satunya yang valid
pemisah adalah :, tetapi ini dapat diubah menggunakan variabel konfigurasi trailer.separators.

Jika ada pemisah, maka kuncinya akan digunakan sebagai pengganti keduanya dan
pemisah default saat menambahkan trailer.

cuplikan. .di mana
Opsi ini mengambil nilai yang sama dengan trailer.di mana variabel konfigurasi dan itu
menimpa apa yang ditentukan oleh opsi itu untuk trailer dengan yang ditentukan .

cuplikan. .ifexist
Opsi ini mengambil nilai yang sama dengan trailer.ifexist variabel konfigurasi dan itu
menimpa apa yang ditentukan oleh opsi itu untuk trailer dengan yang ditentukan .

cuplikan. .merindukan
Opsi ini mengambil nilai yang sama dengan trailer.jika hilang variabel konfigurasi dan
itu menimpa apa yang ditentukan oleh opsi itu untuk trailer dengan yang ditentukan .

cuplikan. .memerintah
Opsi ini dapat digunakan untuk menentukan perintah shell yang akan dipanggil ke
secara otomatis menambahkan atau memodifikasi trailer dengan yang ditentukan .

Ketika opsi ini ditentukan, perilakunya seolah-olah khusus =
argumen ditambahkan di awal baris perintah, di mana diambil menjadi
output standar dari perintah yang ditentukan dengan spasi putih awal dan akhir
dipangkas.

Jika perintah berisi string $ARG, string ini akan diganti dengan
bagian dari trailer yang ada dengan yang sama , jika ada, sebelum perintahnya adalah
diluncurkan.

Jika beberapa = argumen juga diteruskan pada baris perintah, ketika a
cuplikan. .memerintah dikonfigurasi, perintah juga akan dieksekusi untuk masing-masing
argumen ini. Dan bagian dari argumen ini, jika ada, akan digunakan untuk
ganti string $ARG dalam perintah.

CONTOH

· Konfigurasikan menandatangani trailer dengan Ditandatangani oleh kunci, lalu tambahkan dua trailer ini
ke pesan:

$ git config trailer.sign.key "Ditandatangani oleh"
$ pesan kucing.txt
subyek

pesan
$ cat msg.txt | git interpret-trailers --trailer 'tanda: Alice[email dilindungi]>' --trailer 'tanda: Bob[email dilindungi]>'
subyek

pesan

Ditandatangani oleh: Alice[email dilindungi]>
Ditandatangani oleh: Bob[email dilindungi]>

· Ekstrak komit terakhir sebagai tambalan, dan tambahkan Cc dan Diperiksa oleh trailernya:

$ git format-patch -1
0001-foo.patch
$ git interpret-trailer --trailer 'Cc: Alice[email dilindungi]>' --trailer 'Diulas-oleh: Bob[email dilindungi]>' 0001-foo.patch >0001-bar.patch

· Konfigurasikan menandatangani cuplikan dengan perintah untuk secara otomatis menambahkan 'Ditandatangani oleh: ' dengan
informasi penulis hanya jika belum ada 'Signed-off-by: ', dan tunjukkan caranya
karya:

$ git config trailer.sign.key "Ditandatangani oleh: "
$ git config trailer.sign.ifmissing tambahkan
$ git config trailer.sign.ifexists tidak melakukan apa-apa
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git interpret-trailer <
> EOF

Ditandatangani oleh: Bob[email dilindungi]>
$ git interpret-trailer <
> Ditandatangani oleh: Alice[email dilindungi]>
> EOF

Ditandatangani oleh: Alice[email dilindungi]>

· Konfigurasikan memperbaiki trailer dengan kunci yang berisi a # dan tidak ada ruang setelah ini
karakter, dan tunjukkan cara kerjanya:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "Perbaiki #"
$ echo "subjek" | git interpret-trailer --trailer fix=42
subyek

Perbaiki #42

· Konfigurasikan melihat trailer dengan perintah untuk menunjukkan subjek komit yaitu
terkait, dan tunjukkan cara kerjanya:

$ git config trailer.see.key "Lihat-juga: "
$ git config trailer.see.ifAda "ganti"
$ git config trailer.see.ifKehilangan "tidak melakukan apa-apa"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpret-trailer <
> subjek
>
> pesan
>
> lihat: KEPALA~2
> EOF
subyek

pesan

Lihat juga: fe3187489d69c4 (subjek komit terkait)

· Konfigurasikan templat komit dengan beberapa cuplikan dengan nilai kosong (menggunakan sed untuk menampilkan
dan pertahankan spasi tambahan di akhir trailer), lalu konfigurasikan commit-msg
kait yang menggunakan git menafsirkan-trailer untuk menghapus trailer dengan nilai kosong dan menambahkan
a git-versi Trailer:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***subyek***
>
> ***pesan***
>
> Perbaikan: Z
> Cc: Z
> Diulas-oleh: Z
> Ditandatangani oleh: Z
> EOF
$ git config komit.template komit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/ Bin / sh
> git interpret-trailers --trim-empty --trailer "git-version: \$(git menjelaskan)" "\$1" > "\$1.new"
> mv "\$1.baru" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

Gunakan git-interpret-trailer online menggunakan layanan onworks.net