Chapters ▾ 2nd Edition

A3.9 پیوست C: دستورات گیت (Git Commands) - ایمیل (Email)

ایمیل (Email)

بسیاری از پروژه‌های گیت، از جمله خودِ گیت، به‌طور کامل از طریق فهرست‌های پستی (mailing list) نگهداری می‌شوند. گیت چندین ابزار درونی دارد که این فرآیند را آسان‌تر می‌کند؛ از تولید پَچ‌هایی که بتوانید به‌راحتی ایمیل کنید تا اعمال آن پَچ‌ها از صندوق پستی.

اعمال پچ (git apply)

دستور git apply یک پچ ایجاد‌شده با دستور git diff یا حتی با دستور GNU diff را اعمال می‌کند. این شبیه کاری است که دستور patch انجام می‌دهد با چند تفاوت کوچک.

ما نحوه استفاده از آن و موقعیت‌هایی که ممکن است از آن استفاده کنید را در اعمال اصلاحات از طریق ایمیل (Applying Patches from Email) نشان داده‌ایم.

اعمال پچ از ایمیل (git am)

دستور git am برای اعمال پچ‌ها از صندوق ایمیل استفاده می‌شود، به‌طور مشخص صندوق‌هایی با فرمت mbox. این برای دریافت پچ‌ها از طریق ایمیل و اعمال آسان آن‌ها در پروژه‌تان مفید است.

ما استفاده و جریان کاری پیرامون git am را در اعمال پچ با am (Applying a Patch with am) پوشش داده‌ایم، از جمله استفاده از گزینه‌های --resolved، -i و -3.

همچنین تعدادی هوک وجود دارد که می‌توانید برای کمک به جریان کاری پیرامون git am از آن‌ها استفاده کنید و همهٔ آن‌ها در قلاب‌های جریان کاری ایمیل (Email Workflow Hooks) بررسی شده‌اند.

ما همچنین از آن برای اعمال تغییرات فرمت‌شدهٔ پچِ درخواست‌های Pull در گیت‌هاب در اعلان‌های ایمیلی (Email Notifications) استفاده می‌کنیم.

ایجاد پچ‌ها برای ارسال (git format-patch)

دستور git format-patch برای تولید مجموعه‌ای از پچ‌ها در فرمت mbox به‌کار می‌رود که می‌توانید آن‌ها را به‌صورت درست فرمت‌شده برای یک فهرست پستی ارسال کنید.

ما یک مثال از مشارکت در یک پروژه با استفاده از ابزار git format-patch را در پروژه عمومی از طریق ایمیل (Public Project over Email) بررسی می‌کنیم.cached

ارسال پچ از طریق IMAP (git imap-send)

دستور git imap-send یک صندوق پستی تولیدشده با git format-patch را در یک پوشهٔ پیش‌نویس IMAP آپلود می‌کند.

ما یک مثال از مشارکت در یک پروژه با ارسال پچ‌ها با ابزار git imap-send را در پروژه عمومی از طریق ایمیل (Public Project over Email) مرور می‌کنیم.

ارسال پچ از طریق ایمیل (git send-email)

دستور git send-email برای ارسال پچ‌هایی که با git format-patch تولید شده‌اند از طریق ایمیل استفاده می‌شود.

ما یک مثال از مشارکت در یک پروژه با ارسال پچ‌ها با ابزار git send-email را در پروژه عمومی از طریق ایمیل (Public Project over Email) بررسی می‌کنیم.

درخواست کشش برای مخزن دیگر (git request-pull)

 دستور git request-pull فقط برای تولید یک متن نمونه برای ایمیل فرستادن به کسی استفاده می‌شود.
اگر شاخه‌ای روی یک سرور عمومی دارید و می‌خواهید به کسی بگویید چگونه آن تغییرات را ادغام کند بدون اینکه پچ‌ها را از طریق ایمیل بفرستید، می‌توانید این دستور را اجرا کرده و خروجی را برای شخصی که می‌خواهید تغییرات را pull کند ارسال کنید.

نحوه استفاده از git request-pull برای تولید پیام pull را در پروژه‌ی عمومی فورک شده (Forked Public Project) نشان داده‌ایم.

scroll-to-top