git-interpret-treler - Dalam Talian di Awan

JADUAL:

NAMA

git-interpret-treler - membantu menambah maklumat berstruktur ke dalam mesej komit

SINOPSIS

pergi tafsir-treler [--trim-kosong] [(--treler [(=|:) ])...] [ ...]

DESCRIPTION

Bantu tambah treler baris, yang kelihatan serupa dengan pengepala e-mel RFC 822, pada penghujung
sebaliknya bentuk bebas sebahagian daripada mesej komit.

Perintah ini membaca beberapa patch atau komit mesej daripada sama ada hujah atau
input standard jika tidak dinyatakan. Kemudian arahan ini menggunakan hujah yang diluluskan
menggunakan pilihan --trailer, jika ada, ke bahagian mesej komit setiap fail input. The
keputusan dipancarkan pada output standard.

Sesetengah pembolehubah konfigurasi mengawal cara argumen --trailer digunakan pada setiap satu
mesej komit dan cara mana-mana treler sedia ada dalam mesej komit diubah. mereka
juga memungkinkan untuk menambah beberapa treler secara automatik.

Secara lalai, a = or : hujah yang diberikan menggunakan --trailer akan
ditambahkan selepas treler sedia ada hanya jika treler terakhir mempunyai treler yang berbeza ( ,
) pasangan (atau jika tiada treler sedia ada). The dan bahagian akan menjadi
dipangkas untuk mengalih keluar ruang putih permulaan dan mengekori, dan yang terhasil dipangkas dan
akan muncul dalam mesej seperti ini:

token: nilai

Ini bermakna bahawa dipangkas dan akan dipisahkan dengan ': ' (satu titik bertindih
diikuti dengan satu ruang).

Secara lalai treler baharu akan muncul pada penghujung semua treler sedia ada. Jika ada
bukan treler sedia ada, treler baharu akan muncul selepas bahagian mesej komit
output, dan, jika tiada baris dengan hanya ruang di hujung bahagian mesej komit,
satu baris kosong akan ditambah sebelum treler baharu.

Treler sedia ada diekstrak daripada mesej input dengan mencari kumpulan satu atau
lebih banyak baris yang mengandungi titik bertindih (secara lalai), di mana kumpulan itu didahului oleh satu atau lebih
baris kosong (atau ruang putih sahaja). Kumpulan mesti sama ada berada di penghujung mesej atau berada
baris bukan ruang putih terakhir sebelum baris yang bermula dengan ---. Tiga tanda tolak sedemikian
mulakan bahagian tampalan mesej.

Apabila membaca treler, mungkin terdapat ruang kosong sebelum dan selepas token, pemisah
dan nilai. Terdapat juga ruang putih di dalam token dan nilai.

Perhatikan bahawa treler jangan ikut dan tidak bertujuan untuk mengikuti banyak peraturan untuk RFC 822
tajuk. Contohnya mereka tidak mengikut peraturan lipatan baris, peraturan pengekodan dan
mungkin banyak peraturan lain.

PILIHAN

--trim-kosong
Sekiranya sebahagian daripada mana-mana treler hanya mengandungi ruang kosong, keseluruhan treler akan menjadi
dikeluarkan daripada mesej yang terhasil. Ini terpakai kepada treler sedia ada dan juga baharu
treler.

--treler [(=|:) ]
Nyatakan a ( , ) pasangan yang harus digunakan sebagai treler kepada input
mesej. Lihat huraian arahan ini.

CONFIGURATION PELBAGAI

treler.pemisah
Pilihan ini memberitahu aksara yang diiktiraf sebagai pemisah treler. Secara lalai
hanyalah : diiktiraf sebagai pemisah treler, kecuali itu = sentiasa diterima pada
baris arahan untuk keserasian dengan arahan git lain.

Aksara pertama yang diberikan oleh pilihan ini akan menjadi aksara lalai yang digunakan apabila
pemisah lain tidak dinyatakan dalam konfigurasi untuk treler ini.

Contohnya, jika nilai untuk pilihan ini ialah "%=$", maka hanya baris yang menggunakan format
dengan mengandungi %, = or $ dan kemudian ruang akan dipertimbangkan
treler. Dan % akan menjadi pemisah lalai yang digunakan, jadi secara lalai treler akan muncul
seperti: % (tanda satu peratus dan satu ruang akan muncul di antara token
dan nilai).

treler.di mana
Pilihan ini memberitahu tempat treler baharu akan ditambahkan.

Ini boleh menjadi akhir, iaitu lalai, mula, selepas atau sebelum.

Jika ia tamat, maka setiap treler baharu akan muncul pada penghujung treler sedia ada.

Jika ia adalah permulaan, maka setiap treler baharu akan muncul pada permulaan, bukannya penghujung, daripada
treler sedia ada.

Jika ia selepas, maka setiap treler baharu akan muncul sejurus selepas treler terakhir dengan
sama .

Jika sebelum ini, maka setiap treler baharu akan muncul sejurus sebelum treler pertama dengan
sama .

trailer.ifexists
Pilihan ini membolehkan anda memilih tindakan yang akan dilakukan apabila ada
sudah sekurang-kurangnya satu treler dengan yang sama dalam mesej.

Nilai yang sah untuk pilihan ini ialah: addIfDifferentNeighbor (ini adalah lalai),
addIfDifferent, tambah, tulis ganti atau buat apa-apa.

Dengan addIfDifferentNeighbor, treler baharu akan ditambah hanya jika tiada treler dengan
sama ( , ) pasangan berada di atas atau di bawah garisan di mana treler baharu akan berada
ditambah.

Dengan addIfDifferent, treler baharu akan ditambah hanya jika tiada treler dengan treler yang sama
( , ) pasangan sudah ada dalam mesej.

Dengan tambahan, treler baharu akan ditambah, walaupun beberapa treler dengan yang sama ( ,
) pasangan sudah ada dalam mesej.

Dengan penggantian, treler sedia ada dengan yang sama akan dipadamkan dan yang baharu
treler akan ditambah. Treler yang dipadamkan akan menjadi yang paling dekat (dengan treler yang sama
) ke tempat yang baru akan ditambah.

Dengan doNothing, tiada apa yang akan dilakukan; itu bukan treler baru akan ditambah jika ada
sudah satu dengan yang sama dalam mesej.

treler.jika tiada
Pilihan ini membolehkan anda memilih tindakan yang akan dilakukan apabila ada
belum ada treler yang sama dalam mesej.

Nilai yang sah untuk pilihan ini ialah: tambah (ini adalah lalai) dan doNothing.

Dengan tambahan, treler baharu akan ditambah.

Dengan doNothing, tiada apa yang akan dilakukan.

treler. .kunci
Kunci ini akan digunakan sebagai ganti dalam treler. Pada penghujung kunci ini, a
pemisah boleh muncul dan kemudian beberapa aksara ruang. Secara lalai satu-satunya yang sah
pemisah adalah :, tetapi ini boleh ditukar menggunakan pembolehubah konfigurasi trailer.separators.

Jika terdapat pemisah, maka kunci akan digunakan dan bukannya kedua-duanya dan juga
pemisah lalai apabila menambah treler.

treler. .di mana
Pilihan ini mengambil nilai yang sama seperti treler.di mana pembolehubah konfigurasi dan ia
mengatasi apa yang ditentukan oleh pilihan itu untuk treler dengan yang ditentukan .

treler. .ifexist
Pilihan ini mengambil nilai yang sama seperti trailer.ifexist pembolehubah konfigurasi dan ia
mengatasi apa yang ditentukan oleh pilihan itu untuk treler dengan yang ditentukan .

treler. .jika terlepas
Pilihan ini mengambil nilai yang sama seperti treler.jika tiada pembolehubah konfigurasi dan
ia mengatasi apa yang ditentukan oleh pilihan itu untuk treler dengan yang ditentukan .

treler. .perintah
Pilihan ini boleh digunakan untuk menentukan arahan shell yang akan dipanggil
menambah atau mengubah suai treler secara automatik dengan yang ditentukan .

Apabila pilihan ini ditentukan, tingkah laku itu seolah-olah istimewa =
hujah telah ditambahkan pada permulaan baris arahan, di mana diambil untuk menjadi
output standard bagi arahan yang ditentukan dengan mana-mana ruang putih di hadapan dan di belakang
dipangkas.

Jika arahan mengandungi rentetan $ARG, rentetan ini akan digantikan dengan rentetan
sebahagian daripada treler sedia ada dengan yang sama , jika ada, sebelum perintah itu
dilancarkan.

Jika ada = hujah juga dihantar pada baris arahan, apabila a
treler. .perintah dikonfigurasikan, arahan juga akan dilaksanakan untuk setiap satu
hujah-hujah ini. Dan juga sebahagian daripada hujah ini, jika ada, akan digunakan untuk
gantikan rentetan $ARG dalam arahan.

CONTOH

· Konfigurasikan a menandatangani treler dengan a Ditandatangani-oleh kunci, dan kemudian tambah dua daripada treler ini
kepada mesej:

$ git config trailer.sign.key "Ditandatangani-dimatikan-oleh"
$ kucing msg.txt
tertakluk

mesej
$ kucing msg.txt | git interpret-treler --trailer 'sign: Alice[e-mel dilindungi]>' --trailer 'tanda: Bob[e-mel dilindungi]>'
tertakluk

mesej

Ditandatangani oleh: Alice[e-mel dilindungi]>
Ditandatangani oleh: Bob[e-mel dilindungi]>

· Ekstrak komit terakhir sebagai tampung, dan tambahkan a Cc dan Diulas oleh treler kepadanya:

$ git format-patch -1
0001-foo.patch
$ git interpret-trelers --treler 'Cc: Alice[e-mel dilindungi]>' --treler 'Disemak-oleh: Bob[e-mel dilindungi]>' 0001-foo.patch >0001-bar.patch

· Konfigurasikan a menandatangani treler dengan arahan untuk menambah secara automatik 'Ditandatangani oleh: ' dengan
maklumat pengarang hanya jika tiada 'Ditandatangani-oleh: ' sudah, dan tunjukkan caranya
berfungsi:

$ git config trailer.sign.key "Ditandatangani oleh: "
$ git config trailer.sign.ifmissing add
$ git config trailer.sign.ifexists doNothing
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git interpret-treler <
> EOF

Ditandatangani oleh: Bob[e-mel dilindungi]>
$ git interpret-treler <
> Ditandatangani-oleh: Alice[e-mel dilindungi]>
> EOF

Ditandatangani oleh: Alice[e-mel dilindungi]>

· Konfigurasikan a menetapkan treler dengan kunci yang mengandungi a # dan tiada ruang selepas ini
watak, dan tunjukkan cara ia berfungsi:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "Betulkan #"
$ echo "subjek" | git interpret-treler --treler fix=42
tertakluk

Betulkan # 42

· Konfigurasikan a lihat treler dengan arahan untuk menunjukkan subjek komit iaitu
berkaitan, dan tunjukkan cara ia berfungsi:

$ git config trailer.see.key "Lihat-juga: "
$ git config trailer.see.ifExists "ganti"
$ git config trailer.see.ifMissing "doNothing"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpret-treler <
> subjek
>
> mesej
>
> lihat: KEPALA~2
> EOF
tertakluk

mesej

Lihat-juga: fe3187489d69c4 (subjek komitmen yang berkaitan)

· Konfigurasikan templat komit dengan beberapa treler dengan nilai kosong (menggunakan sed untuk menunjukkan
dan kekalkan ruang belakang di hujung treler), kemudian konfigurasikan commit-msg
cangkuk yang menggunakan pergi tafsir-treler untuk mengalih keluar treler dengan nilai kosong dan menambah
a versi git treler:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***subjek***
>
> ***mesej***
>
> Pembetulan: Z
> Sk: Z
> Disemak-oleh: Z
> Ditandatangani-oleh: Z
> EOF
$ git config commit.template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/ Bin / sh
> git interpret-trailer --trim-empty --trailer "git-version: \$(git describe)" "\$1" > "\$1.new"
> mv "\$1.baru" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

Gunakan git-interpret-treler dalam talian menggunakan perkhidmatan onworks.net