jj-git-import(1) General Commands Manual jj-git-import(1)

jj-git-import - به‌روزرسانی مخزن با تغییرات اعمال‌شده در مخزن Git زیربنایی

jj git import [-R|--repository] [--ignore-working-copy] [--no-integrate-operation] [--ignore-immutable] [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help]

به‌روزرسانی مخزن با تغییرات اعمال‌شده در مخزن Git زیربنایی

کامیت‌هایی که دیگر از هیچ شاخه‌ای در مخزن Git در دسترس نباشند، در مخزن Git به‌عنوان متروکه (abandoned) در نظر گرفته می‌شوند و برای مطابقت با مخزن Git، در مخزن jj نیز متروکه خواهند شد. برای غیرفعال کردن این رفتار، مقدار `git.abandon-unreachable-commits` را روی `false` تنظیم کنید.

اگر کامیت رونوشت کاری متروکه شود، یک کامیت جدید و خالی به آن اختصاص داده می‌شود. این یک قاعدهٔ کلی است و مختص این دستور نیست.

به‌طور پیش‌فرض، این دستور در فضاهای کاری هم‌مکان (colocated) کاری انجام نمی‌دهد زیرا درون‌ریزی (import) به‌صورت خودکار رخ می‌دهد. برای درون‌ریزی اجباری تغییرات از `--ignore-working-copy` استفاده کنید.

چاپ راهنما (مشاهده خلاصه با '-h')

مسیر مخزنی که عملیات روی آن انجام می‌شود

به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در اجداد دایرکتوری کاری فعلی می‌گردد.

از رونوشت کاری اسنپ‌شات گرفته نشود و آن را به‌روزرسانی نکند

به‌طور پیش‌فرض، Jujutsu در آغاز هر دستور از رونوشت کاری اسنپ‌شات می‌گیرد. همچنین در پایان دستور، در صورتی که کامیت رونوشت کاری (`@`) توسط دستور تغییر یافته باشد، رونوشت کاری به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از رونوشت کاری صرف‌نظر کنید و در عوض یک کامیت رونوشت کاری احتمالاً قدیمی را مشاهده نمایید، می‌توانید از `--ignore-working-copy` استفاده کنید. این گزینه برای مثال در اعلان خط فرمان (prompt) مفید است، به‌ویژه اگر فرآیند دیگری داشته باشید که کامیت‌های رونوشت کاری را ثبت می‌کند.

بارگذاری مخزن در یک عملیات خاص با `--at-operation` به‌طور ضمنی `--ignore-working-copy` را اعمال می‌کند.

اجرای دستور طبق معمول بدون ادغام هیچ عملیاتی

هنگامی که این گزینه مشخص شود، عملیات همچنان طبق معمول ایجاد خواهند شد اما در تاریخچهٔ عملیات (operation log) ادغام نمی‌شوند. همچنین رونوشت کاری نیز به‌روزرسانی نخواهد شد.

دستور، شناسهٔ عملیات حاصل را چاپ خواهد کرد. می‌توانید آن را برای مثال به `jj --at-op` ارسال کنید تا وضعیت به‌دست‌آمدهٔ مخزن را بررسی نمایید، یا آن را به `jj op restore` بدهید تا مخزن به آن وضعیت بازگردانده شود. همچنین می‌توانید شناسه را به `jj op integrate` بدهید تا عملیات ادغام شود.

توجه داشته باشید که این کار مانع اثرات جانبی بیرون از مخزن *نمی‌شود*. برای نمونه، `jj git push --no-integrate-operation` همچنان عملیات ارسال (push) را انجام خواهد داد.

اجازه بازنویسی کامیت‌های تغییرناپذیر

به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌ها در مجموعه پیکربندی‌شدهٔ کامیت‌های تغییرناپذیر جلوگیری می‌کند. این گزینه بررسی مذکور را غیرفعال کرده و اجازه می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید.

این گزینه تنها بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری `immutable_heads()` یا کلمه کلیدی قالب `immutable` اثری ندارد.

عملیاتی که مخزن باید در نقطهٔ آن بارگذاری شود

عملیاتی که مخزن باید در نقطهٔ آن بارگذاری شود. به‌طور پیش‌فرض، Jujutsu مخزن را در تازه‌ترین عملیات، یا در صورت وجود عملیات‌های واگرا، در نقطهٔ ادغام آن‌ها بارگذاری می‌کند.

می‌توانید از `--at-op=<operation ID>;` استفاده کنید تا ببینید مخزن در یک عملیات پیشین چگونه بوده است. برای نمونه `jj --at-op=<operation ID>; st` آنچه را که `jj st` در زمان پایان یافتن آن عملیات نشان می‌داد به شما نمایش می‌دهد. `--at-op=@` تقریباً همانند حالت پیش‌فرض است، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.

از دستور `jj op log` برای یافتن شناسهٔ عملیات دلخواه خود استفاده کنید. هر پیشوند یکتایی از شناسهٔ عملیات کافی خواهد بود.

هنگام بارگذاری مخزن در یک عملیات پیشین، رونوشت کاری نادیده گرفته می‌شود، درست مانند اینکه `--ignore-working-copy` مشخص شده باشد.

امکان اجرای دستورات تغییردهنده (mutating) هنگام بارگذاری مخزن در یک عملیات پیشین وجود دارد. انجام این کار معادل اجرای همزمان دستورات با شروع از عملیات پیشین است. به‌ندرت دلیلی برای انجام چنین کاری وجود دارد، اما امکان‌پذیر است.

فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging)
تعیین زمان استفاده از رنگ در خروجی

مقادیر ممکن:

  • always
  • never
  • debug
  • auto
بی‌صدا کردن خروجی‌های غیراصلی دستور

برای نمونه، `jj file list` همچنان فایل‌ها را فهرست می‌کند، اما به شما اطلاع نمی‌دهد که آیا از رونوشت کاری اسنپ‌شات گرفته شده یا نوادگان بازپایه‌ریزی شده‌اند یا خیر.

هشدارها و خطاها همچنان چاپ خواهند شد.

غیرفعال کردن صفحه‌بندی‌کننده (pager)
گزینه‌های پیکربندی اضافی (قابلیت تکرار دارد)

نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت یک عبارت TOML تعیین شود. در صورتی که مقدار رشته‌ای درون ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از علامت‌های نقل‌قول صرف‌نظر کرد.

فایل‌های پیکربندی اضافی (قابلیت تکرار دارد)
import