Git commands accept a wide variety of URLs syntaxes, not just standard URLs. This can make parsing git URLs difficult since standard URL parsers cannot be used. Even if an external parser were implemented, it would have to track git's development closely in case support for any new URL schemes are added. These patches introduce a new url-parse builtin command that exposes git's native URL parsing algorithms as a plumbing command, allowing other programs to then call upon git itself to parse the git URLs and their components. This should be quite useful for scripts. For example, a script might want to add remotes to repositories, naming them according to the domain name where the repository is hosted. This new builtin allows it to parse the git URL and extract its host name which can then be used as input for other operations. This would be difficult to implement otherwise due to git's support for scp style URLs. Signed-off-by: Matheus Afonso Martins Moreira matheus@xxxxxxxxxxxxxxxxxx Matheus Afonso Martins Moreira (13): url: move helper function to URL header and source urlmatch: define url_parse function builtin: create url-parse command url-parse: add URL parsing helper function url-parse: enumerate possible URL components url-parse: define component extraction helper fn url-parse: define string to component converter fn url-parse: define usage and options url-parse: parse options given on the command line url-parse: validate all given git URLs url-parse: output URL components selected by user Documentation: describe the url-parse builtin tests: add tests for the new url-parse builtin .gitignore | 1 + Documentation/git-url-parse.txt | 59 ++++++++++ Makefile | 1 + builtin.h | 1 + builtin/url-parse.c | 132 ++++++++++++++++++++++ command-list.txt | 1 + connect.c | 8 -- connect.h | 1 - git.c | 1 + remote.c | 1 + t/t9904-url-parse.sh | 194 ++++++++++++++++++++++++++++++++ url.c | 8 ++ url.h | 2 + urlmatch.c | 90 +++++++++++++++ urlmatch.h | 1 + 15 files changed, 492 insertions(+), 9 deletions(-) create mode 100644 Documentation/git-url-parse.txt create mode 100644 builtin/url-parse.c create mode 100755 t/t9904-url-parse.sh base-commit: e326e520101dcf43a0499c3adc2df7eca30add2d Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1715%2Fmatheusmoreira%2Furl-parse-v1 Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1715/matheusmoreira/url-parse-v1 Pull-Request: https://github.com/git/git/pull/1715 -- gitgitgadget
