git-for-each-ref - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

git-for-each-ref - Xuất thông tin về mỗi ref

SYNOPSIS

git cho-mỗi-ref [--count = ] [--shell | --perl | --python | --tcl]
[(--sort = ) ...] [--format = ] [ ...]
[--points-at ] [(- hợp nhất | - không hợp nhất) [ ]]
[--chứa đựng [ ]]

MÔ TẢ

Lặp lại tất cả các giới thiệu phù hợp và hiển thị chúng theo ,
sau khi phân loại chúng theo tập hợp đã cho . Nếu như được đưa ra, dừng lại sau khi
cho thấy rằng nhiều giới thiệu. Các giá trị nội suy trong có thể tùy ý được trích dẫn là
chuỗi ký tự trong ngôn ngữ máy chủ được chỉ định cho phép đánh giá trực tiếp của chúng trong đó
ngôn ngữ.

LỰA CHỌN

Theo mặc định, lệnh hiển thị tất cả các tham chiếu phù hợp . Tùy chọn này làm cho nó dừng lại
sau khi hiển thị rằng nhiều giới thiệu.


Tên trường để sắp xếp. Tiền tố - để sắp xếp theo thứ tự giảm dần của giá trị. Khi nào
không xác định, đổi tên được sử dụng. Bạn có thể sử dụng --sort = tùy chọn nhiều lần, trong
trường hợp nào khóa cuối cùng trở thành khóa chính.


Một chuỗi nội suy% (tên trường) từ đối tượng được trỏ đến bởi một tham chiếu
cho xem. Nếu tên trường được bắt đầu bằng dấu hoa thị (*) và tham chiếu trỏ vào thẻ
đối tượng, giá trị cho trường trong thẻ đối tượng tham chiếu được sử dụng. Khi không xác định,
mặc định thành% (objectname) SPC% (objecttype) TAB% (refname). Nó cũng nội suy %% thành
% và% xx trong đó xx là các chữ số hex nội suy thành ký tự có mã hex xx; vì
ví dụ% 00 nội suy thành \ 0 (NUL),% 09 thành \ t (TAB) và% 0a thành \ n (LF).

...
Nếu một hoặc nhiều mẫu được đưa ra, chỉ các tham chiếu được hiển thị phù hợp với ít nhất một
mô hình, hoặc sử dụng fnmatch(3) hoặc theo nghĩa đen, trong trường hợp sau là khớp hoàn toàn
hoặc từ đầu lên đến một dấu gạch chéo.

--shell, --perl, --python, --tcl
Nếu được cung cấp, các chuỗi thay thế phần giữ chỗ% (tên trường) được trích dẫn dưới dạng chuỗi
các ký tự phù hợp với ngôn ngữ máy chủ được chỉ định. Điều này có nghĩa là để tạo ra một
scriptlet có thể được `đánh giá trực tiếp.

--points-at
Chỉ liệt kê các tham chiếu trỏ đến đối tượng đã cho.

--merged [ ]
Chỉ liệt kê các tham chiếu có mẹo có thể truy cập được từ cam kết đã chỉ định (HEAD nếu không
được chỉ định).

- không hợp nhất [ ]
Chỉ liệt kê các tham chiếu có mẹo không thể truy cập được từ cam kết đã chỉ định (HEAD nếu không
được chỉ định).

--chứa đựng [ ]
Chỉ liệt kê các thẻ có chứa cam kết được chỉ định (HEAD nếu không được chỉ định).

CÁNH ĐỒNG TÊN

Các giá trị khác nhau từ các trường có cấu trúc trong các đối tượng được tham chiếu có thể được sử dụng để nội suy
vào kết quả đầu ra hoặc dưới dạng các khóa sắp xếp.

Đối với tất cả các đối tượng, có thể sử dụng các tên sau:

đổi tên
Tên của ref (phần sau $ GIT_DIR /). Đối với một tên ngắn không mơ hồ của
ref append: ngắn gọn. Tùy chọn core.warnAmbiguousRefs được sử dụng để chọn mức nghiêm ngặt
chế độ viết tắt. Nếu dải = được nối, dải đường dẫn được phân tách bằng dấu gạch chéo
các thành phần từ phía trước của tên đổi tên (ví dụ:% (refname: dải = 2) biến refs / tags / foo
thành foo. phải là một số nguyên dương. Nếu một tham chiếu được hiển thị có ít thành phần hơn
hơn , lệnh hủy bỏ với một lỗi.

loại đối tượng
Loại đối tượng (blob, cây, cam kết, thẻ).

đồ vật
Kích thước của đối tượng (giống như git tập tin mèo -s báo cáo).

tên của môn học
Tên đối tượng (hay còn gọi là SHA-1). Đối với tên viết tắt không mơ hồ của tên đối tượng
nối thêm: ngắn gọn.

Thượng nguồn
Tên của một tham chiếu cục bộ có thể được coi là "ngược dòng" từ tham chiếu được hiển thị.
Respects: ngắn gọn giống như cách đổi tên ở trên. Ngoài ra, tôn trọng: theo dõi để hiển thị
"[phía trước N, phía sau M]" và: trackhort để hiển thị phiên bản ngắn hơn: ">" (phía trước), "<"
(phía sau), "<>" (phía trước và phía sau) hoặc "=" (đồng bộ). Không có hiệu lực nếu ref không
có thông tin theo dõi được liên kết với nó.

đẩy
Tên của một giới thiệu cục bộ đại diện cho vị trí @ {push} cho giới thiệu được hiển thị.
Các tùy chọn tôn trọng: short,: track, và: trackhort như ngược dòng. Tạo ra một sản phẩm trống
string nếu không có ref @ {push} nào được định cấu hình.

TRỤ
* nếu HEAD khớp với tham chiếu hiện tại (nhánh đã kiểm tra), '' ngược lại.

màu sắc
Thay đổi màu đầu ra. Theo dõi bởi : , nơi tên được mô tả trong
color.branch. *.

sắp xếp
Căn trái-, giữa- hoặc phải nội dung giữa% (align: ...) và% (end). Các
"align:" được theo sau bởi và theo bất kỳ thứ tự nào được phân tách bằng dấu phẩy,
ở đâu là trái, phải hoặc giữa, mặc định là trái và
là tổng độ dài của nội dung có căn chỉnh. Nếu độ dài nội dung nhiều hơn
chiều rộng thì không có căn chỉnh nào được thực hiện. Nếu được sử dụng với --trích dẫn Mọi thứ ở giữa
% (align: ...) và% (end) được trích dẫn, nhưng nếu được lồng vào nhau thì chỉ cấp cao nhất thực hiện
trích dẫn.

Ngoài những điều trên, đối với các đối tượng cam kết và thẻ, tên trường tiêu đề (cây,
cha, đối tượng, loại và thẻ) có thể được sử dụng để chỉ định giá trị trong trường tiêu đề.

Đối với các đối tượng cam kết và thẻ, các trường người tạo và người tạo đặc biệt sẽ tương ứng với
bộ ngày thích hợp hoặc tên-email-ngày từ các trường người cam kết hoặc người gắn thẻ
tùy thuộc vào loại đối tượng. Chúng nhằm mục đích làm việc trên sự kết hợp của chú thích và
thẻ nhẹ.

Các trường có bộ dữ liệu tên-email-ngày làm giá trị của nó (tác giả, người xác nhận và người gắn thẻ) có thể
kèm theo tên, email và ngày để trích xuất thành phần được đặt tên.

Thông điệp hoàn chỉnh trong đối tượng cam kết và thẻ là nội dung. Dòng đầu tiên của nó là
nội dung: chủ đề, trong đó chủ đề là phần nối của tất cả các dòng của thông báo cam kết lên
đến dòng trống đầu tiên. Dòng tiếp theo là nội dung: cơ thể, nơi nội dung là tất cả các dòng
sau dòng trống đầu tiên. Chữ ký GPG tùy chọn là nội dung: chữ ký. N đầu tiên
dòng thông báo được lấy bằng nội dung: lines = N.

Đối với mục đích sắp xếp, các trường có giá trị số sắp xếp theo thứ tự số (kích thước đối tượng,
tác giả, cam kết, người tạo, người gắn thẻ). Tất cả các trường khác được sử dụng để sắp xếp trong
thứ tự giá trị byte của chúng.

Ngoài ra còn có một tùy chọn để sắp xếp theo các phiên bản, điều này có thể được thực hiện bằng cách sử dụng tên trường
version: refname hoặc bí danh của nó v: refname.

Trong mọi trường hợp, tên trường tham chiếu đến trường không thể áp dụng cho đối tượng được giới thiệu bởi
ref không gây ra lỗi. Thay vào đó, nó trả về một chuỗi trống.

Là một trường hợp đặc biệt cho các trường loại ngày, bạn có thể chỉ định một định dạng cho ngày bằng cách
thêm: theo sau là tên định dạng ngày (xem các giá trị mà tùy chọn --date thành :git-rev-
(1) mất).

VÍ DỤ

Một ví dụ trực tiếp tạo ra văn bản được định dạng. Hiển thị 3 cam kết được gắn thẻ gần đây nhất:

#!/ Bin / sh

git for-each-ref --count = 3 --sort = '- * Authordate' \
--format = 'Từ:% (* tên tác giả)% (* tác giả)
Chủ đề)
Ngày:% (* tác giả)
Tham khảo:% (* refname)

%(*cơ thể người)
'' refs / tags '

Một ví dụ đơn giản cho thấy việc sử dụng đánh giá trình bao trên đầu ra, minh họa việc sử dụng
--vỏ bọc. Liệt kê các tiền tố của tất cả các đầu:

#!/ Bin / sh

git for-each-ref --shell --format = "ref =% (refname)" refs / heads | \
trong khi đọc mục nhập
do
eval "$ entry"
echo `dirname $ ref`
thực hiện

Báo cáo phức tạp hơn một chút về thẻ, chứng minh rằng định dạng có thể là toàn bộ
kịch bản:

#!/ Bin / sh

fmt = '
r =% (đổi tên)
t =% (* objecttype)
T = $ {r # refs / tags /}

o =% (* tên đối tượng)
n =% (* tên tác giả)
e =% (* tác giả)
s =% (* chủ đề)
d =% (* tác giả)
b =% (* nội dung)

kind = Thẻ
nếu kiểm tra "z $ t" = z
sau đó
# có thể là một thẻ nhẹ
t =% (loại đối tượng)
kind = "Thẻ nhẹ"
o =% (tên đối tượng)
n =% (tên tác giả)
e =% (tác giả)
s =% (chủ đề)
d =% (tác giả)
b =% (nội dung)
fi
echo "$ kind $ T trỏ vào một đối tượng $ t $ o"
nếu kiểm tra "z $ t" = zcommit
sau đó
echo "Cam kết được tạo bởi $ n $ e
ở $ d và có tiêu đề

$s

Tin nhắn của nó đọc là:
"
echo "$ b" | sed -e "s / ^ / /"
bỏ lỡ
fi
'

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

Sử dụng git-for-each-ref trực tuyến bằng các dịch vụ onworks.net