git-annex-get(1) General Commands Manual git-annex-get(1)

git-annex-get - در دسترس قرار دادن محتوای فایل‌های ضمیمه‌شده

git annex get [path ...]

محتوای فایل‌های ضمیمه‌شده (annexed) را در این مخزن در دسترس قرار می‌دهد. این کار شامل کپی کردن آن‌ها از یک مخزن دوردست (ریموت)، دانلود کردن آن‌ها، یا انتقال آن‌ها از نوعی مخزن کلید-مقدار (key-value store) خواهد بود.

در صورت مشخص نشدن هیچ پارامتری، تمام فایل‌های ضمیمه‌شده در دایرکتوری فعلی که محتوای آن‌ها از قبل موجود نبوده است دریافت می‌شوند. می‌توان مسیر فایل‌ها یا دایرکتوری‌ها را برای دریافت مشخص کرد.

# evince foo.pdf
error: Unable to open document foo.pdf: No such file or directory
# ls foo.pdf
foo.pdf@
# git annex get foo.pdf
get foo.pdf (from origin..) ok
# evince foo.pdf

به جای دریافت تمام فایل‌های مشخص‌شده، تنها آن‌هایی را دریافت می‌کند که هنوز تعداد نسخه‌های مورد نظر را ندارند، یا محتوای ترجیحی (preferred content) مخزن هستند. به git-annex-preferred-content(1) مراجعه کنید.
به‌طور معمول git-annex انتخاب می‌کند که محتوا را از کدام ریموت‌ها دریافت کند و ریموت‌های با هزینه کمتر را ترجیح می‌دهد. از این گزینه برای تعیین این‌که از کدام ریموت استفاده شود استفاده کنید.
هر فایلی که روی ریموت موجود نباشد، بدون نمایش پیام نادیده گرفته می‌شود.
دانلود موازی را با حداکثر تعداد کارهای مشخص‌شده که هم‌زمان اجرا می‌شوند فعال می‌کند. برای مثال: -J10
تنظیم این مقدار روی "cpus" یک کار را به ازای هر هسته پردازنده (CPU) اجرا خواهد کرد.
هنگامی که فایل‌ها قابل دانلود از چند ریموت باشند، فعال کردن دانلودهای موازی بار کاری را بین ریموت‌ها تقسیم می‌کند. برای مثال، اگر فایل‌ها روی ریموت‌های A و B در دسترس باشند، یک فایل از A دانلود می‌شود و فایل دیگر هم‌زمان از B دانلود خواهد شد. (همچنان ریموت‌های با هزینه کمتر نسبت به ریموت‌های با هزینه بیشتر ترجیح داده می‌شوند.)
گزینه‌های تطبیق (matching options)
می‌توان از git-annex-matching-options(1) برای کنترل این‌که چه چیزهایی دریافت شوند استفاده کرد.
ادامه دادن فرایند دانلودهای ناتمام فایل‌هایی که قبلاً در مقطعی آغاز شده و متوقف شده بودند. این گزینه برای ادامه کار از همان‌جایی که رها کرده‌اید مفید است... به‌ویژه زمانی که دقیقاً به یاد نمی‌آورید کجا بوده است.
این فایل‌های ناتمام همان فایل‌هایی هستند که توسط git-annex-unused(1) به‌عنوان فایل‌های موقت بدون استفاده فهرست می‌شوند.
توجه داشته باشید که هنگام دانلود، کلید git-annex نمایش داده خواهد شد، زیرا git-annex فایل مرتبط با آن را نمی‌شناسد، و فایل مرتبط حتی ممکن است در دایرکتوری کاری فعلی گیت نباشد.
به جای مشخص کردن نام فایل یا مسیر برای دریافت، می‌توان از این گزینه برای دریافت تمام نسخه‌های موجود از همه فایل‌ها استفاده کرد.
این رفتار پیش‌فرض هنگام اجرای git-annex در یک مخزن خالی (bare repository) است.
عملیات روی فایل‌های موجود در شاخه مشخص‌شده یا مرجع ساختار درختی (treeish).
عملیات روی فایل‌های یافت‌شده در آخرین اجرای دستور git-annex unused.
عملیات روی فایل‌هایی که انتقال آن‌ها اخیراً با شکست مواجه شده است.
با گزینه --incomplete اشتباه گرفته نشود، که فقط دانلودهایی را از سر می‌گیرد که موفق به انتقال بخشی از محتوای یک فایل شده‌اند.
استفاده از این گزینه برای دریافت یک کلید مشخص.
فعال‌سازی حالت دسته‌ای (batch mode)؛ که در آن خطوط حاوی نام فایل‌های مورد نظر برای دریافت از ورودی استاندارد (stdin) خوانده می‌شوند.
با پردازش هر فایل مشخص‌شده، خروجی پیشرفت معمول نمایش داده می‌شود. اگر محتوای فایل مشخص‌شده از قبل موجود باشد، یا با گزینه‌های تطبیق مشخص‌شده مطابقت نداشته باشد، یا یک فایل ضمیمه‌شده نباشد، در پاسخ یک خط خالی تولید می‌شود.
از آنجا که خروجی معمول هنگام دریافت یک فایل پرحجم و تفصیلی است و برای ماشین قابل تجزیه نیست، ممکن است بخواهید از --json در ترکیب با --batch استفاده کنید.
مشابه با --batch است، اما خطوط خوانده‌شده از stdin به‌عنوان کلید تجزیه می‌شوند.
باعث می‌شود ورودی حالت دسته‌ای به جای خطوط جدید معمول، با نویسه‌های تهی (null) جدا شوند.
فعال‌سازی خروجی JSON. این گزینه برای تجزیه توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
گنجاندن اشیای پیشرفت در خروجی JSON.
پیام‌هایی که به‌طور معمول در خطای استاندارد خروجی داده می‌شدند، در عوض در داخل JSON گنجانده می‌شوند.
همچنین می‌توان از گزینه‌های git-annex-common-options(1) استفاده کرد.

git-annex(1)

git-annex-drop(1)

git-annex-copy(1)

git-annex-move(1)

Joey Hess <id@joeyh.name>