feat: retry failed repositories

Author: frankpagan

src/coc.js

@@ -1,15 +1,23 @@
 #!/usr/bin/env node
+
+// Import necessary modules for path operations, file system operations, and more
 const path = require("path");
 const fs = require("fs");
 const readline = require("readline");
 const execute = require("./execute");
 const addMeta = require("./addMeta");
 const { color } = require("./fonts");
 
+// Configuration object for storing options
 let config = {};
 
+// Extract arguments from the command line input
 const argv = process.argv.slice(2);
+
+// Define available command-line options
 const options = ["-self"];
+
+// Iterate over available options and set configurations if specified in argv
 for (let option of options) {
 	if (argv.includes(option)) {
 		config[option.replace(/^--/, "")] = true;
@@ -18,12 +26,16 @@ for (let option of options) {
 	}
 }
 
+// Format command from argv, handling spaces and quotes
 command = argv
-	.map((part) =>
-		part.match(/ |'|"/) ? `'${part.replace(/'/, "\\'")}'` : part
-	)
+	.map((part) => (part.match(/ |'|"/) ? `'${part.replace(/'/, "'")}'` : part))
 	.join(" ");
 
+/**
+ * Load repository configuration from the given path.
+ * @param {string} path - The file path to load repository config from.
+ * @returns {Array} - List of repositories.
+ */
 function getRepositories(path) {
 	try {
 		const config = require(path);
@@ -39,28 +51,39 @@ function getRepositories(path) {
 	}
 }
 
+/**
+ * Main function to execute commands across repositories.
+ * @param {Object} config - The configuration object.
+ * @param {Array} [repos=null] - List of repositories to process.
+ * @param {string} [directory=null] - The directory path of the configuration.
+ */
 async function main(config = {}, repos = null, directory = null) {
 	if (!repos) {
-		// Existing logic to determine repositories and configuration
+		// Determine repositories and configuration file paths
 		const currentRepoPath = path.resolve(
 			process.cwd(),
 			"CoCreate.config.js"
 		);
 		const packageJsonPath = path.resolve(process.cwd(), "package.json");
 
+		// Load repositories from specified config file
 		if (config["c"] && fs.existsSync(config["c"])) {
 			repos = getRepositories(config["c"]);
 			directory = path.dirname(config["c"]);
 			console.warn(
 				`${color.yellow}using ${config["c"]} configuration${color.reset}`
 			);
-		} else if (!config["self"] && fs.existsSync(currentRepoPath)) {
+		}
+		// Load repositories from default CoCreate.config.js if exists
+		else if (!config["self"] && fs.existsSync(currentRepoPath)) {
 			repos = getRepositories(currentRepoPath);
 			directory = path.dirname(currentRepoPath);
 			console.warn(
 				`${color.yellow}using ${currentRepoPath} configuration${color.reset}`
 			);
-		} else if (fs.existsSync(packageJsonPath)) {
+		}
+		// If package.json exists, load repository details from it
+		else if (fs.existsSync(packageJsonPath)) {
 			const repoPath = path.resolve(process.cwd());
 			const packageObj = require(packageJsonPath);
 			const repoUrl =
@@ -78,20 +101,26 @@ async function main(config = {}, repos = null, directory = null) {
 			console.warn(
 				`${color.yellow}using ${packageJsonPath} configuration${color.reset}`
 			);
-		} else {
+		}
+		// Error if no configuration can be found
+		else {
 			console.error(
 				`${color.red}a configuration file cannot be found${color.reset}`
 			);
 			process.exit(1);
 		}
 	}
 
+	// Set default config values
 	config = { hideMessage: false, ...config };
 
+	// Add metadata to repos if any are present
 	if (repos && repos.length) repos = await addMeta(repos, [], directory);
 
+	// Execute the command across repositories
 	const failed = await execute(command, repos, config);
 
+	// Handle any failed command executions
 	if (failed && failed.length > 0) {
 		console.log(
 			color.red +
@@ -104,10 +133,17 @@ async function main(config = {}, repos = null, directory = null) {
 			);
 		}
 
+		// Prompt user to retry failed commands
 		await promptRetry(failed, config, directory);
 	}
 }
 
+/**
+ * Prompt the user to retry failed commands.
+ * @param {Array} failed - List of failed commands.
+ * @param {Object} config - Configuration object.
+ * @param {string} directory - Path of the configuration directory.
+ */
 async function promptRetry(failed, config, directory) {
 	const rl = readline.createInterface({
 		input: process.stdin,
@@ -127,4 +163,5 @@ async function promptRetry(failed, config, directory) {
 	);
 }
 
+// Call the main function with initial configuration
 main(config);