git-url-parse - Man Page

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

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​.

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

Extract the <component> component from the given Git URLs​. <component> can be one of: scheme, user, password, host, port, path​.

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​.

• Print the host name:

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

• Print the 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

• Validate URLs without outputting anything:

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

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

Part of the git(1) suite