git-for-each-ref - Dalam talian di Awan

JADUAL:

NAMA

git-for-each-ref - Maklumat output pada setiap ref

SINOPSIS

pergi untuk-setiap-ref [--count= ] [--shell|--perl|--python|--tcl]
[(--sort= )...] [--format= ] [ ...]
[--menunjuk-pada ] [(--bercantum | --tidak-bercantum) [ ]]
[--mengandungi [ ]]

DESCRIPTION

Ulangi semua rujukan yang sepadan dan tunjukkan mereka mengikut yang diberikan ,
selepas menyusunnya mengikut set yang diberikan . Jika diberi, berhenti selepas
menunjukkan bahawa banyak rujukan. Nilai yang diinterpolasi dalam boleh dipetik sebagai pilihan
literal rentetan dalam bahasa hos yang ditentukan membenarkan penilaian langsung mereka dalam itu
bahasa.

PILIHAN

Secara lalai arahan menunjukkan semua rujukan yang sepadan . Pilihan ini membuatnya berhenti
selepas menunjukkan bahawa banyak rujukan.


Nama medan untuk diisih. Awalan - untuk mengisih mengikut tertib menurun nilai. Bila
tidak ditentukan, nama semula digunakan. Anda boleh menggunakan --sort= pilihan beberapa kali, dalam
yang mana kunci terakhir menjadi kunci utama.


Rentetan yang menginterpolasi %(nama medan) daripada objek yang ditunjuk oleh makhluk ref
ditunjukkan. Jika nama medan didahulukan dengan asterisk (*) dan ref menunjuk pada teg
objek, nilai untuk medan dalam teg objek merujuk digunakan. Apabila tidak dinyatakan,
lalai kepada %(nama objek) SPC %(jenis objek) TAB %(nama semula). Ia juga menginterpolasi %% kepada
%, dan %xx di mana xx ialah digit hex interpolasi kepada aksara dengan kod hex xx; untuk
contoh %00 interpolasi kepada \0 (NUL), %09 kepada \t (TAB) dan %0a kepada \n (LF).

...
Jika satu atau lebih corak diberikan, hanya rujukan ditunjukkan yang sepadan dengan sekurang-kurangnya satu
corak, sama ada menggunakan fnmatch(3) atau secara literal, dalam kes kedua sepadan sepenuhnya
atau dari awal hingga ke garis miring.

--shell, --perl, --python, --tcl
Jika diberikan, rentetan yang menggantikan ruang letak %(nama medan) dipetik sebagai rentetan
literal yang sesuai untuk bahasa hos yang ditentukan. Ini bertujuan untuk menghasilkan a
skrip yang boleh `dinilai` secara langsung.

--menunjuk-di
Hanya senaraikan rujukan yang menunjuk pada objek yang diberikan.

--digabungkan [ ]
Hanya senarai rujukan yang petuanya boleh dicapai daripada komit yang ditentukan (HEAD jika tidak
ditentukan).

--tidak digabungkan [ ]
Hanya senaraikan rujukan yang petuanya tidak dapat dicapai daripada komit yang ditentukan (HEAD jika tidak
ditentukan).

--mengandungi [ ]
Hanya senarai tag yang mengandungi komit yang ditentukan (HEAD jika tidak dinyatakan).

BIDANG NAMA

Pelbagai nilai daripada medan berstruktur dalam objek yang dirujuk boleh digunakan untuk interpolasi
ke dalam output yang terhasil, atau sebagai kunci isihan.

Untuk semua objek, nama berikut boleh digunakan:

nama semula
Nama ref (bahagian selepas $GIT_DIR/). Untuk nama pendek yang tidak samar-samar bagi
rujuk tambahkan :pendek. Pilihan teras.warnAmbiguousRefs digunakan untuk memilih yang ketat
mod singkatan. Jika jalur= dilampirkan, jalur laluan yang dipisahkan dengan garis miring
komponen dari hadapan nama semula (cth, %(nama semula:jalur=2) menukar rujukan/tag/foo
menjadi foo. mestilah integer positif. Jika rujukan yang dipaparkan mempunyai lebih sedikit komponen
daripada , arahan itu dibatalkan dengan ralat.

jenis objek
Jenis objek (blob, tree, commit, tag).

saiz objek
Saiz objek (sama dengan pergi fail kucing -s laporan).

nama objek
Nama objek (aka SHA-1). Untuk singkatan nama objek yang tidak samar-samar
tambahkan :pendek.

huluan
Nama ref tempatan yang boleh dianggap "hulu" daripada ref yang dipaparkan.
Respects :short dengan cara yang sama seperti nama semula di atas. Di samping itu penghormatan :trek untuk ditunjukkan
"[depan N, belakang M]" dan :trackshort untuk menunjukkan versi singkat: ">" (depan), "<"
(belakang), "<>" (depan dan belakang), atau "=" (selaras). Tiada kesan jika ref tidak
mempunyai maklumat penjejakan yang berkaitan dengannya.

menolak
Nama rujukan tempatan yang mewakili lokasi @{push} untuk rujukan yang dipaparkan.
Menghormati :short, :track, dan :trackshort pilihan seperti huluan. Menghasilkan kosong
rentetan jika tiada ref @{push} dikonfigurasikan.

KETUA
* jika HEAD sepadan dengan ref semasa (cawangan yang didaftar keluar), ' ' jika tidak.

warna
Tukar warna output. Diikuti oleh : , di mana nama diterangkan dalam
warna.cawangan.*.

menjajarkan
Jajarkan ke kiri, tengah atau kanan kandungan antara %(align:...) dan %(end). The
"align:" diikuti oleh dan dalam sebarang susunan yang dipisahkan dengan koma,
Dimanakah adalah sama ada kiri, kanan atau tengah, lalai ialah kiri dan
ialah jumlah panjang kandungan dengan penjajaran. Jika panjang kandungan lebih daripada
lebar maka tiada penjajaran dilakukan. Jika digunakan dengan --petikan segala-galanya di antara
%(align:...) dan %(end) dipetik, tetapi jika bersarang maka hanya tahap paling atas berprestasi
memetik.

Sebagai tambahan kepada perkara di atas, untuk komit dan teg objek, nama medan pengepala (pokok,
induk, objek, jenis dan teg) boleh digunakan untuk menentukan nilai dalam medan pengepala.

Untuk objek komit dan teg, medan tarikh pencipta dan pencipta khas akan sepadan dengannya
tarikh yang sesuai atau tuple nama-e-mel-tarikh daripada medan committer atau tagger
bergantung kepada jenis objek. Ini bertujuan untuk bekerja pada campuran beranotasi dan
tag ringan.

Medan yang mempunyai tuple nama-e-mel-tarikh sebagai nilainya (pengarang, pengkomit dan penanda) boleh
diakhiri dengan nama, e-mel dan tarikh untuk mengekstrak komponen yang dinamakan.

Mesej lengkap dalam objek komit dan tag ialah kandungan. Baris pertamanya ialah
kandungan:subjek, dengan subjek adalah gabungan semua baris mesej komit ke atas
ke baris kosong pertama. Baris seterusnya ialah kandungan: badan, di mana badan ialah semua baris
selepas baris kosong pertama. Tandatangan GPG pilihan ialah contents:signature. N pertama
baris mesej diperoleh menggunakan contents:lines=N.

Untuk tujuan pengisihan, medan dengan nilai angka mengisih dalam susunan angka (saiz objek,
authordate, committerdate, creatordate, taggerdate). Semua medan lain digunakan untuk mengisih
susunan nilai bait mereka.

Terdapat juga pilihan untuk mengisih mengikut versi, ini boleh dilakukan dengan menggunakan nama medan
version:refname atau alias v:refname.

Walau apa pun, nama medan yang merujuk kepada medan yang tidak berkenaan dengan objek yang dirujuk oleh
ref tidak menyebabkan ralat. Ia mengembalikan rentetan kosong sebaliknya.

Sebagai kes khas untuk medan jenis tarikh, anda boleh menentukan format untuk tarikh dengan
menambah : diikuti dengan nama format tarikh (lihat nilai pilihan --date to :git-rev-
senarai(1) mengambil).

CONTOH

Contoh yang menghasilkan teks berformat secara langsung. Tunjukkan 3 komitmen teg terkini:

#!/ Bin / sh

git for-each-ref --count=3 --sort='-*authordate' \
--format='Daripada: %(*nama pengarang) %(*mel pengarang)
Subjek: %(*subjek)
Tarikh: %(*authordate)
Ruj: %(*nama semula)

%(*badan)
' 'rujukan/teg'

Contoh mudah yang menunjukkan penggunaan shell eval pada output, menunjukkan penggunaan
--cangkang. Senaraikan awalan semua kepala:

#!/ Bin / sh

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
sambil baca entry
do
eval "$entry"
echo `nama nama $ref`
dilakukan

Laporan yang lebih terperinci tentang teg, menunjukkan bahawa format itu mungkin keseluruhan
skrip:

#!/ Bin / sh

fmt='
r=%(nama semula)
t=%(*jenis objek)
T=${r#refs/tags/}

o=%(*nama objek)
n=%(*nama pengarang)
e=%(*authoremail)
s=%(*subjek)
d=%(*author)
b=%(*badan)

jenis=Tag
jika ujian "z$t" = z
kemudian
# boleh menjadi teg ringan
t=%(jenis objek)
kind="Tag ringan"
o=%(nama objek)
n=%(nama pengarang)
e=%(mel pengarang)
s=%(subjek)
d=%(author)
b=%(badan)
fi
echo "$jenis $T mata pada objek $t $o"
jika ujian "z$t" = zcommit
kemudian
echo "Komit telah dikarang oleh $n $e
di $d, dan bertajuk

$s

Mesejnya berbunyi sebagai:
"
echo "$b" | sed -e "s/^/ /"
echo
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*objecttype' \
--sort=-taggerdate \
rujukan/tag`
eval "$eval"

Gunakan git-for-each-ref dalam talian menggunakan perkhidmatan onworks.net