Make git-get more robust and add man page

Author: stilvoid

git-get

@@ -1,17 +1,42 @@
 #!/bin/bash
 
-base_dir=$(git config get.location)
+base_dir="$(git config get.location)"
 
 if [ -z "$base_dir" ]; then
-    base_dir=~/code
+    base_dir="$HOME/code"
+else
+    # Replace a tilde with $HOME
+    base_dir="${base_dir/#~/$HOME}"
 fi
 
-# We will blithely assume that the last argument is the repository
-dir=${!#}
 
-dir=$(echo $dir | sed -e 's/^.*:\/\///')
-dir=$(echo $dir | sed -e 's/^.*@//')
-dir=$(echo $dir | sed -e 's/:/\//g')
-dir="$base_dir/$dir"
+repo="$1"
 
-git clone $@ $dir
+if [ -z "$repo" ]; then
+    echo "Usage git get <repository>"
+    echo
+    echo "  git-get clones <repository> into a folder derived from the repository URL"
+    echo
+    echo "  For example, git get [email protected]:stilvoid/git-get.git"
+    echo "  will be checkout into ~/code/github.com/stilvoid/git-get.git"
+    echo
+    echo "  You can override the default base path (~/code) with"
+    echo "  git config --global get.loation \"/path/to/your/code\""
+    exit 1
+fi
+
+# Strip scheme
+dir="${repo#*://}"
+
+# Strip username
+dir="${dir#*@}"
+
+# Replace : with /
+dir="${dir/://}"
+
+# Remove .git
+dir="${dir%.git}"
+
+dir="${base_dir}/${dir}"
+
+git clone "$repo" "$dir"

git-get.1

@@ -0,0 +1,40 @@
+.TH "GIT\-GET" "1" "2025-01-10" "https://github.com/stilvoid/git-get" "Git Manual"
+.SH NAME
+git-git \- clone a git repository into a folder structure derived from the repository URL
+.SH SYNOPSIS
+.B git-get
+.IR repository
+.SH DESCRIPTION
+.Nm
+clones
+.IR repository
+into a folder derived from the repository URL by removing the scheme (e.g. \fIhttps://\fR),
+the username (e.g. \fIgit@\fR),
+and the suffix \fI.git\fR if it exists.
+.SH EXAMPLE
+.PP
+Clone the git-get repository:
+.PP
+.nf
+.RS
+$ git get [email protected]:stilvoid/git-get
+.RE
+OR
+.RS
+$ git get https://github.com/stilvoid/git-get.git
+.RE
+.fi
+.PP
+will both result in the repository being checked out to
+.PP
+.RS
+$HOME/code/github.com/stilvoid/git-get
+.RE
+.PP
+You can override the default base path (
+.I ~/code
+) with:
+.PP
+.RS
+$ git config --global get.loation "/path/to/your/code"
+.RE