Added clone command

Author: polytypic

README.md

@@ -67,7 +67,14 @@ cppsm test-watch
 Clone an existing project:
 
 ```bash
-git clone URI
+cppsm clone URL BRANCH
+```
+
+Or clone an existing project using plain git:
+
+```bash
+git clone -b BRANCH URL/NAME.git
+cd NAME
 git submodule update --init     # NOTE: non-recursive
 ```
 

bash_completion

@@ -10,20 +10,27 @@ __cppsm_complete() {
   case "$PREVIOUS" in
     cppsm)
       # shellcheck disable=SC2207
-      COMPREPLY=($(compgen -W "add build build-watch hello init list remove setup test test-watch update-all" -- "$CURRENT"))
+      COMPREPLY=($(compgen -W "add build build-watch clone hello init list remove setup test test-watch update-all" -- "$CURRENT"))
       ;;
     add)
       # shellcheck disable=SC2207
       COMPREPLY=($(compgen -W "equipment requires" -- "$CURRENT"))
       ;;
+    clone)
+      if command -v jq > /dev/null && command -v curl > /dev/null && command -v sed > /dev/null; then
+        # shellcheck disable=SC2207
+        COMPREPLY=($(curl -s "https://api.github.com/search/repositories?q=topic:cppsm+${CURRENT##*/}" | \
+                       jq '.items | .[] | .ssh_url'))
+      fi
+      ;;
     equipment|requires)
       if command -v jq > /dev/null && command -v curl > /dev/null && command -v sed > /dev/null; then
         # shellcheck disable=SC2207
         COMPREPLY=($(curl -s "https://api.github.com/search/repositories?q=topic:cppsm+${CURRENT##*/}" | \
                        jq '.items | .[] | .clone_url'))
       fi
       ;;
-    https:*.git)
+    https:*.git|git*.git)
       if command -v sed > /dev/null; then
         # shellcheck disable=SC2207
         COMPREPLY=($(git ls-remote --heads "$PREVIOUS" | sed -e 's#[^ ]*\s*refs/heads/##g'))

commands/clone

@@ -0,0 +1,21 @@
+#!/bin/bash -e
+
+# shellcheck source=.settings
+. "${BASH_SOURCE%/*}/.settings"
+
+if [ "$#" -ne 2 ]; then
+  CMD="${0##*/}"
+  cat << EOF
+Usage: $CMD url branch
+
+Clones the specified cppsm compatible repository and its dependencies.
+EOF
+  exit 1
+fi
+
+NAME="${1%.git}"
+NAME="${NAME##*/}"
+
+git clone -b "$2" "$1"
+cd "$NAME"
+git submodule update --init