نام (NAME)

gh-pr-create - ایجاد یک پول‌ریکوئست جدید در یک مخزن گیت‌هاب

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

gh pr create [flags]

توضیحات (DESCRIPTION)

ایجاد یک پول‌ریکوئست در گیت‌هاب.

در صورت موفقیت، نشانی اینترنتی (URL) پول‌ریکوئست ایجادشده چاپ خواهد شد.

هنگامی که شاخه فعلی به طور کامل به یک مخزن ریموت گیت push نشده باشد، اعلانی نمایش داده می‌شود که می‌پرسد شاخه کجا ارسال شود و گزینه‌ای برای فورک کردن مخزن مبنا پیشنهاد می‌دهد. هر فورکی که از این طریق ایجاد شود، تنها شامل شاخه پیش‌فرض مخزن بالادستی خواهد بود. از --head برای صرف‌نظر کردن صریح از هرگونه عملیات فورک یا push استفاده کنید.

گزینه --head از ساختار <user>:<branch> برای انتخاب مخزن مبدا متعلق به <user> پشتیبانی می‌کند. استفاده از یک سازمان به عنوان <user> در حال حاضر پشتیبانی نمی‌شود. برای اطلاعات بیشتر، ببینید: ⟨https://github.com/cli/cli/issues/10093⟩

اعلانی نیز عنوان و بدنه پول‌ریکوئست را درخواست خواهد کرد. از --title و --body برای صرف‌نظر کردن از این اعلان استفاده کنید، یا از --fill برای پر کردن خودکار این مقادیر از کامیت‌های گیت بهره ببرید. توجه به این نکته مهم است که اگر --title و/یا --body نیز در کنار --fill ارائه شوند، مقادیر مشخص‌شده با --title و/یا --body اولویت خواهند داشت و هر محتوای پرشده به صورت خودکار را بازنویسی می‌کنند.

شاخه مبنا (base) برای پول‌ریکوئست ایجادشده را می‌توان با استفاده از فلگ --base مشخص کرد. در صورت عدم ارائه، مقدار پیکربندی شاخه گیت gh-merge-base استفاده خواهد شد. در صورت عدم پیکربندی، شاخه پیش‌فرض مخزن استفاده خواهد شد. دستور git config branch.{current}.gh-merge-base {base} را اجرا کنید تا شاخه فعلی برای استفاده از مبنای ادغام مشخص‌شده پیکربندی شود.

با ارجاع دادن به یک ایشو (issue) در بدنه پول‌ریکوئست، آن را به پول‌ریکوئست پیوند دهید. اگر متن بدنه شامل Fixes #123 یا Closes #123 باشد، ایشوی ارجاع داده شده پس از ادغام شدن پول‌ریکوئست به صورت خودکار بسته خواهد شد.

از --attach برای بارگذاری تصویر یا ویدیو استفاده کنید. فایل پیوست به بدنه اضافه می‌شود. اگر بدنه به یک فایل پیوست‌شده ارجاع دهد، مانند ![alt](./login.png)، آن ارجاع بازنویسی می‌شود تا به جای آن به فایل بارگذاری‌شده اشاره کند. می‌توانید در هر دستور حداکثر ۵۰ فایل را پیوست کنید.

متن جایگزین (Alt text) برای تصویر پس از مسیر و به دنبال # می‌آید، مانند --attach './login.png#The login error state'. بدون آن، نام فایل استفاده می‌شود. ارجاعی که از قبل در بدنه وجود دارد، متن جایگزین نوشته‌شده در آنجا را حفظ می‌کند. ویدیو به صورت یک پخش‌کننده نمایش داده می‌شود و متن جایگزین ندارد، بنابراین نمی‌توان متنی به آن اختصاص داد.

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

به‌طور پیش‌فرض، کاربرانی که دسترسی نوشتن به مخزن مبنا دارند می‌توانند کامیت‌های جدیدی را به شاخه هد پول‌ریکوئست push کنند. این امکان را با --no-maintainer-edit غیرفعال کنید.

افزودن یک پول‌ریکوئست به پروژه‌ها نیازمند مجوز با حوزه (scope) project است. برای اعطای مجوز، دستور gh auth refresh -s project را اجرا کنید.

گزینه‌ها (OPTIONS)

-a, --assignee <login>: تخصیص افراد بر اساس نام کاربری (login). از "@me" برای تخصیص به خود استفاده کنید.
--attach <file>: پیوست کردن یک فایل تصویر یا ویدیو، در قالب '#'
-B, --base <branch>: شاخه‌ای که می‌خواهید کد شما در آن ادغام شود
-b, --body <string>: بدنه پول‌ریکوئست
-F, --body-file <file>: خواندن متن بدنه از فایل (از "-" برای خواندن از ورودی استاندارد استفاده کنید)
-d, --draft: علامت‌گذاری پول‌ریکوئست به عنوان پیش‌نویس (draft)
--dry-run: چاپ جزئیات به جای ایجاد پول‌ریکوئست. ممکن است همچنان تغییرات گیت push شوند.
-e, --editor: صرف‌نظر کردن از اعلان‌ها و باز کردن ویرایشگر متن برای نوشتن عنوان و بدنه در آن. خط اول عنوان و باقی متن بدنه است.
-f, --fill: استفاده از اطلاعات کامیت برای عنوان و بدنه
--fill-first: استفاده از اطلاعات اولین کامیت برای عنوان و بدنه
--fill-verbose: استفاده از پیام و بدنه کامیت‌ها برای توضیحات
-H, --head <branch>: شاخه‌ای که حاوی کامیت‌های پول‌ریکوئست شماست (پیش‌فرض [شاخه فعلی])
-l, --label <name>: افزودن برچسب‌ها با نام
-m, --milestone <name>: افزودن پول‌ریکوئست به یک مایلستون بر اساس نام
--no-maintainer-edit: غیرفعال کردن امکان ویرایش پول‌ریکوئست توسط نگهدارنده
-p, --project <title>: افزودن پول‌ریکوئست به پروژه‌ها بر اساس عنوان
--recover <string>: بازیابی ورودی از یک اجرای ناموفق create
-r, --reviewer <handle>: درخواست بررسی از افراد یا تیم‌ها با نام کاربری آن‌ها
-T, --template <file>: فایل الگو برای استفاده به عنوان متن اولیه بدنه
-t, --title <string>: عنوان برای پول‌ریکوئست
-w, --web: باز کردن مرورگر وب برای ایجاد پول‌ریکوئست

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

-R, --repo <[HOST/]OWNER/REPO>: انتخاب مخزنی دیگر با استفاده از قالب [HOST/]OWNER/REPO

نام‌های مستعار (ALIASES)

gh pr new

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.

مثال‌ها (EXAMPLES)

$ gh pr create --title "The bug is fixed" --body "Everything works again"
$ gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name
$ gh pr create --project "Roadmap"
$ gh pr create --base develop --head monalisa:feature
$ gh pr create --template "pull_request_template.md"
$ gh pr create --attach './login.png#The login error state'
$ gh pr create --attach ./before.png --attach ./after.png

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

gh-pr(1)