NAME

git-url-parse - Parse and extract git URL components

SYNOPSIS

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

DESCRIPTION

Git supports many ways to specify URLs, some of them non-standard. For example, git supports the scp style [user@]host:[path] format. This command eases interoperability with git URLs by enabling the parsing and extraction of the components of all git URLs.

Any syntactically valid URL is parsed, even if the scheme is not one git supports for fetching or pushing.

OPTIONS

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

OUTPUT

When --component is given, the requested component of each URL is printed on its own line, in the order the URLs were given. If the URL has no such component (for example, a port in a URL that does not specify one), an empty line is printed in its place.

When --component is not given, no output is produced. The exit status is zero if every URL parses successfully and non-zero otherwise, allowing the command to be used purely as a validator.

EXAMPLES

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

$ 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

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

SEE ALSO

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

GIT

Part of the git(1) suite