نام (NAME)

git-annex-matchexpression - بررسی مطابقت یک عبارت با داده‌ها

خلاصه دستور (SYNOPSIS)

git annex matchexpression expression [data]

توضیحات (DESCRIPTION)

این دستور سطح پایین (plumbing)، یک عبارت محتوای ترجیحی (preferred content expression) و مقداری داده دریافت می‌کند و بررسی می‌کند که آیا عبارت با آن داده‌ها مطابقت دارد یا خیر. اگر مطابقت داشته باشد با کد ۰ و در غیر این صورت با ۱ خارج می‌شود. چنانچه داده‌های کافی ارائه نشده باشد، خطایی نمایش داده و با کد خطای ویژهٔ ۴۲ خارج می‌شود.

برای نمونه، دستور زیر با کد ۰ خارج خواهد شد:

git annex matchexpression "include=*.png and largerthan=1mb" --file=foo.png --size=10mb

گزینه‌ها (OPTIONS)

--file=

نام فایلی را که باید تطابق با آن سنجیده شود مشخص می‌کند. توجه داشته باشید که نیازی نیست این فایل واقعاً روی دیسک وجود داشته باشد.

--size=

اندازهٔ فایل را مشخص می‌کند. اندازه را می‌توان با هر یک از واحدهای متداول مانند «0.5 gb» یا «100 KiloBytes» مشخص کرد.

--key=

کلیدی را که باید مورد بررسی قرار گیرد مشخص می‌کند. این گزینه برای عبارت‌های تطبیقی مانند «copies=N»، «metadata=tag=foo» و «present» که همگی نیازمند بررسی اطلاعات ثبت‌شده برای یک کلید هستند، لازم است.

بسیاری از کلیدها اندازهٔ مشخصی دارند، بنابراین هنگام تعیین چنین کلیدی نیازی به --size نیست.

--largefiles

عبارت را به جای یک عبارت محتوای ترجیحی، به عنوان یک عبارت annex.largefiles تحلیل و پردازش می‌کند.

--mimetype=

نوع MIME فایل را مشخص می‌کند. فقط هنگام استفاده از --largefiles همراه با عبارت mimetype= مورد نیاز است.

--mimeencoding=

کدگذاری MIME فایل را مشخص می‌کند. فقط هنگام استفاده از --largefiles همراه با عبارت mimeencoding= مورد نیاز است.

--explain

توضیحی دربارهٔ اینکه کدام بخش‌های عبارت محتوای ترجیحی همخوانی دارند و کدام بخش‌ها مطابقت ندارند نمایش می‌دهد.

همچنین می‌توان از گزینه‌های git-annex-common-options(1) استفاده کرد.

همچنین ببینید (SEE ALSO)

git-annex(1)

git-annex-preferred-content(1)

git-annex-matching-expression(1)

git-annex-sim(1)

نویسندگان (AUTHORS)

Joey Hess <id@joeyh.name>