نام (NAME)

git-url-parse - تجزیه و استخراج مؤلفه‌های نشانی اینترنتی (URL) در گیت

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

git url-parse [-c <component>] [--] <url>...

توضیحات (DESCRIPTION)

گیت از روش‌های متعددی برای مشخص کردن URLها پشتیبانی می‌کند که برخی از آن‌ها غیراستاندارد هستند. برای نمونه، گیت از قالب سبک scp یعنی [user@]host:[path] پشتیبانی می‌کند. این دستور با امکان‌پذیر ساختن تجزیه و استخراج مؤلفه‌های تمامی URLهای گیت، تعامل‌پذیری با آن‌ها را تسهیل می‌کند.

هر URL دارای ساختار نحوی معتبر تجزیه می‌شود، حتی اگر طرحواره (scheme) آن از مواردی نباشد که گیت برای واکشی یا ارسال پشتیبانی می‌کند.

گزینه‌ها (OPTIONS)

-c <component>, --component <component>

مؤلفهٔ <component> را از URLهای گیت داده‌شده استخراج می‌کند. <component> می‌تواند یکی از موارد زیر باشد: scheme, user, password, host, port, path.

خروجی (OUTPUT)

هنگامی که گزینهٔ --component داده شود، مؤلفهٔ درخواستی برای هر URL به ترتیبی که URLها وارد شده‌اند، هر یک در یک خط جداگانه چاپ می‌شود. اگر URL فاقد چنین مؤلفه‌ای باشد (برای مثال، پورت در نشانی‌ای که پورت را مشخص نکرده است)، یک خط خالی به جای آن چاپ می‌شود.

هنگامی که --component مشخص نشود، هیچ خروجی‌ای تولید نمی‌شود. در صورتی که تمام URLها با موفقیت تجزیه شوند وضعیت خروج صفر، و در غیر این صورت غیرصفر خواهد بود؛ که این امکان را می‌دهد تا از این دستور صرفاً به عنوان یک اعتبارسنج استفاده شود.

مثال‌ها (EXAMPLES)

•چاپ نام میزبان (host):

$ git url-parse --component host https://example.com/user/repo
example.com

•چاپ مسیر (path):

$ git url-parse --component path https://example.com/user/repo
/user/repo
$ git url-parse --component path example.com:~user/repo
~user/repo
$ git url-parse --component path example.com:user/repo
/user/repo

•اعتبارسنجی URLها بدون تولید خروجی:

$ git url-parse https://example.com/user/repo example.com:~user/repo

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

git-clone(1), git-fetch(1), git-config(1)

GIT

بخشی از مجموعهٔ git(1)