Allow defining custom prefixes

In addition to the predefined prefixes 'gh', 'gl' and 'bb', allow
defining your own prefixes for, e.g. internal hosts.

Author: papperlapapp

README.md

@@ -81,6 +81,13 @@ CPMAddPackage("uri@version#tag")
 
 In the shorthand syntax if the URI is of the form `gh:user/name`, it is interpreted as GitHub URI and converted to `https://github.com/user/name.git`. If the URI is of the form `gl:user/name`, it is interpreted as a [GitLab](https://gitlab.com/explore/) URI and converted to `https://gitlab.com/user/name.git`. If the URI is of the form `bb:user/name`, it is interpreted as a [Bitbucket](https://bitbucket.org/) URI and converted to `https://bitbucket.org/user/name.git`. Otherwise the URI used verbatim as a git URL. All packages added using the shorthand syntax will be added using the [EXCLUDE_FROM_ALL](https://cmake.org/cmake/help/latest/prop_tgt/EXCLUDE_FROM_ALL.html) flag.
 
+In addition to the predefined prefixes, it is also possible to define custom prefixes, e.g.
+```cmake
+set(CPM_CUSTOM_PREFIXES c1:https://c1.example.com c2:https://c2.example.com)
+CPMAddPackage("c1:some/[email protected]")
+CPMAddPackage("c2:another/repo#v1.2.3")
+```
+
 The single-argument syntax also works for URLs:
 
 ```cmake

cmake/CPM.cmake

@@ -339,7 +339,8 @@ endfunction()
 # to: GITHUB_REPOSITORY;foo/bar;VERSION;1.2.3
 function(cpm_parse_add_package_single_arg arg outArgs)
   # Look for a scheme
-  if("${arg}" MATCHES "^([a-zA-Z]+):(.+)$")
+
+  if("${arg}" MATCHES "^([a-zA-Z0-9]+):(.+)$")
     string(TOLOWER "${CMAKE_MATCH_1}" scheme)
     set(uri "${CMAKE_MATCH_2}")
 
@@ -353,19 +354,32 @@ function(cpm_parse_add_package_single_arg arg outArgs)
     elseif(scheme STREQUAL "bb")
       set(out "BITBUCKET_REPOSITORY;${uri}")
       set(packageType "git")
+    elseif(DEFINED CPM_CUSTOM_PREFIXES)
+      foreach(prefix ${CPM_CUSTOM_PREFIXES})
+        if("${prefix}" MATCHES "([^:]+):(.+)")
+          if(scheme STREQUAL "${CMAKE_MATCH_1}")
+            set(out "GIT_REPOSITORY;${uri};CUSTOM_REPOSITORY;${CMAKE_MATCH_2}")
+            set(packageType "git")
+            break()
+          endif()
+        endif()
+      endforeach()
+    endif()
+    if("${out}" STREQUAL "")
       # A CPM-specific scheme was not found. Looks like this is a generic URL so try to determine
       # type
-    elseif(arg MATCHES ".git/?(@|#|$)")
-      set(out "GIT_REPOSITORY;${arg}")
-      set(packageType "git")
-    else()
-      # Fall back to a URL
-      set(out "URL;${arg}")
-      set(packageType "archive")
-
-      # We could also check for SVN since FetchContent supports it, but SVN is so rare these days.
-      # We just won't bother with the additional complexity it will induce in this function. SVN is
-      # done by multi-arg
+      if(arg MATCHES ".git/?(@|#|$)")
+        set(out "GIT_REPOSITORY;${arg}")
+        set(packageType "git")
+      else()
+        # Fall back to a URL
+        set(out "URL;${arg}")
+        set(packageType "archive")
+
+        # We could also check for SVN since FetchContent supports it, but SVN is so rare these days.
+        # We just won't bother with the additional complexity it will induce in this function. SVN
+        # is done by multi-arg
+      endif()
     endif()
   else()
     if(arg MATCHES ".git/?(@|#|$)")
@@ -534,6 +548,7 @@ function(CPMAddPackage)
       GIT_SHALLOW
       EXCLUDE_FROM_ALL
       SOURCE_SUBDIR
+      CUSTOM_REPOSITORY
   )
 
   set(multiValueArgs URL OPTIONS)
@@ -560,6 +575,8 @@ function(CPMAddPackage)
     set(CPM_ARGS_GIT_REPOSITORY "https://gitlab.com/${CPM_ARGS_GITLAB_REPOSITORY}.git")
   elseif(DEFINED CPM_ARGS_BITBUCKET_REPOSITORY)
     set(CPM_ARGS_GIT_REPOSITORY "https://bitbucket.org/${CPM_ARGS_BITBUCKET_REPOSITORY}.git")
+  elseif(DEFINED CPM_ARGS_CUSTOM_REPOSITORY)
+    set(CPM_ARGS_GIT_REPOSITORY "${CPM_ARGS_CUSTOM_REPOSITORY}/${CPM_ARGS_GIT_REPOSITORY}.git")
   endif()
 
   if(DEFINED CPM_ARGS_GIT_REPOSITORY)

test/unit/parse_add_package_single_arg.cmake

@@ -36,6 +36,13 @@ assert_equal("BITBUCKET_REPOSITORY;foo/bar" "${args}")
 cpm_parse_add_package_single_arg("bb:foo/Bar" args)
 assert_equal("BITBUCKET_REPOSITORY;foo/Bar" "${args}")
 
+set(CPM_CUSTOM_PREFIXES c1:https://c1.example.com c2:https://c2.example.com/mirror)
+cpm_parse_add_package_single_arg("c1:foo/bar@13" args)
+assert_equal("GIT_REPOSITORY;foo/bar;VERSION;13;CUSTOM_REPOSITORY;https://c1.example.com" "${args}")
+
+cpm_parse_add_package_single_arg("c2:foo/Bar#bla" args)
+assert_equal("GIT_REPOSITORY;foo/Bar;GIT_TAG;bla;CUSTOM_REPOSITORY;https://c2.example.com/mirror" "${args}")
+
 cpm_parse_add_package_single_arg("https://github.com/cpm-cmake/[email protected]" args)
 assert_equal("GIT_REPOSITORY;https://github.com/cpm-cmake/CPM.cmake.git;VERSION;0.30.5" "${args}")