improv(clone): display & explanations

Author: chrisgrieser

info.plist

@@ -1777,41 +1777,41 @@
 			<key>config</key>
 			<dict>
 				<key>default</key>
-				<false/>
+				<string>10</string>
+				<key>placeholder</key>
+				<string></string>
 				<key>required</key>
 				<false/>
-				<key>text</key>
-				<string>fork when not owner</string>
+				<key>trim</key>
+				<true/>
 			</dict>
 			<key>description</key>
-			<string>When cloning a repository that you do not own, also create a fork an prepare the repo for e PR. (Requires the `gh` cli.)</string>
+			<string>Depth of the clone (`--shallow={n}`). Leave empty to not perform shallow clone.</string>
 			<key>label</key>
 			<string></string>
 			<key>type</key>
-			<string>checkbox</string>
+			<string>textfield</string>
 			<key>variable</key>
-			<string>fork_on_clone</string>
+			<string>clone_depth</string>
 		</dict>
 		<dict>
 			<key>config</key>
 			<dict>
 				<key>default</key>
-				<string>5</string>
-				<key>placeholder</key>
-				<string></string>
+				<false/>
 				<key>required</key>
 				<false/>
-				<key>trim</key>
-				<true/>
+				<key>text</key>
+				<string>fork when not owner</string>
 			</dict>
 			<key>description</key>
-			<string>Depth of the clone (`--shallow={n}`)</string>
+			<string>When cloning a repository that you do not own, also create a fork an prepare the repo for e PR. (Requires the `gh` cli.)</string>
 			<key>label</key>
 			<string></string>
 			<key>type</key>
-			<string>textfield</string>
+			<string>checkbox</string>
 			<key>variable</key>
-			<string>clone_depth</string>
+			<string>fork_on_clone</string>
 		</dict>
 		<dict>
 			<key>config</key>
@@ -1824,7 +1824,7 @@
 				<string>restore mtime</string>
 			</dict>
 			<key>description</key>
-			<string></string>
+			<string>`git clone` normally erases modification time of files. It can be restored from the commit log, though. However, this the modification time then only goes as far back as the oldest commit, so you might want to increase clone depth.</string>
 			<key>label</key>
 			<string></string>
 			<key>type</key>

scripts/clone-repo.sh

@@ -9,18 +9,24 @@ url="[email protected]:$source_repo.git" # use SSH instead of https
 [[ ! -e "$local_repo_folder" ]] && mkdir -p "$local_repo_folder"
 cd "$local_repo_folder" || return 1
 
+#───────────────────────────────────────────────────────────────────────────────
+# CLONE
 # validate depth, minimum 2
 # WARN depth=2 ensures that amending a shallow commit does not result in a
 # new commit without parent, effectively destroying git history (!!)
 [[ $clone_depth =~ ^[0-9]+$ && $clone_depth -ge 2 ]] || clone_depth=2
 
-git clone --depth="$clone_depth" "$url" --no-single-branch --no-tags # get branches, but not tags
+if [[ $clone_depth -eq 0 ]]; then
+	git clone "$url" --no-single-branch --no-tags # get branches, but not tags
+else
+	git clone "$url" --depth="$clone_depth" --no-single-branch --no-tags
+fi
 
 # Open in terminal via Alfred
 echo -n "$local_repo_folder/$reponame"
 
 #───────────────────────────────────────────────────────────────────────────────
-# RESTORE MTIME 
+# RESTORE MTIME
 
 cd "$reponame" || return 1
 

scripts/my-github-repos.js

@@ -27,6 +27,7 @@ function run() {
 	// CONFIG
 	const username = $.getenv("github_username");
 	const localRepoFolder = $.getenv("local_repo_folder");
+	const depthInfo = $.getenv("clone_depth") ? ` (depth ${$.getenv("clone_depth")})` : "";
 
 	// determine local repos
 	const localRepos = {};
@@ -76,7 +77,7 @@ function run() {
 			// changes when repo is local
 			repo.local = localRepos[repo.name];
 			const mainArg = repo.local?.path || repo.html_url;
-			const terminalActionDesc = repo.local ? "Open in Terminal" : "Shallow Clone";
+			const terminalActionDesc = repo.local ? "Open in Terminal" : "Shallow Clone" + depthInfo;
 			// open in terminal when local, clone when not
 			const terminalArg = repo.local?.path || repo.html_url;
 			if (repo.local) {

scripts/public-github-repo-search.js

@@ -66,14 +66,13 @@ function run(argv) {
 	}
 
 	const forkOnClone = $.getenv("fork_on_clone") === "1";
+	const depthInfo = $.getenv("clone_depth") ? ` (depth ${$.getenv("clone_depth")})` : "";
 	const apiURL = `https://api.github.com/search/repositories?q=${encodeURIComponent(query)}`;
 
 	/** @type {AlfredItem[]} */
 	const repos = JSON.parse(httpRequest(apiURL))
 		.items.filter((/** @type {GithubRepo} */ repo) => !(repo.fork || repo.archived))
 		.map((/** @type {GithubRepo} */ repo) => {
-			console.log("🪚 " + repo.full_name);
-
 			// calculate relative date
 			// INFO pushed_at refers to commits only https://github.com/orgs/community/discussions/24442
 			// CAVEAT pushed_at apparently also includes pushes via PR :(
@@ -86,8 +85,7 @@ function run(argv) {
 				repo.description,
 			].join("  ·  ");
 
-			const cloneSubtitle = "⌃: Shallow Clone" + (forkOnClone ? " & Fork" : "");
-
+			const cloneSubtitle = "⌃: Shallow Clone " + depthInfo + (forkOnClone ? " & Fork" : "");
 			const secondUrl = repo.homepage || repo.html_url + "/releases";
 
 			return {