occam-open-cli 6.0.390 → 6.1.0

package/README.md

@@ -43,7 +43,7 @@ Commands:
 
   set-options                                     Set options 
 
-  clone <package_name>                            Clone a package with Git
+  clone <repository_name>                         Clone a repository with Git
 
   publish <package_name>                          Publish a package
 
@@ -69,11 +69,15 @@ Options:
 
   --log-level|-l                                  Set the log level when publishing
   
-  --yes|-y                                        Initially answer yes to prompts
+  --yes|-y                                        Automatically answer yes to affiermation prompts
 
-  --tail|-t                                       Sets the size of the tail of the log messages when publishing. The default is ten. 
+  --tail|-t                                       Sets the size of the tail of the log messages when publishing. The default is ten 
 
-  --follow|-f                                     Show all of the log messages when publishing. The default is false.
+  --follow|-f                                     Show all of the log messages when publishing. The default is false
+
+  --headless|-x                                   Headless mode. Clone or open all dependencies bar the repository or package itself
+  
+  --dependencies|-a                               Include dependencies when cloning repositories or opening packages
 ```
 
 This is slightly different from `npm` in that `open` is usually executed from the parent directory of a project rather than from within the project sub-directory itself.

package/bin/abbreviations.js

@@ -1,19 +1,19 @@
 "use strict";
 
-const { NO_OPTION, YES_OPTION, HELP_OPTION, TAIL_OPTION, FOLLOW_OPTION, DRY_RUN_OPTION, VERSION_OPTION, QUIETLY_OPTION, LOG_LEVEL_OPTION } = require("./options");
+const { YES_OPTION, HELP_OPTION, TAIL_OPTION, FOLLOW_OPTION, DRY_RUN_OPTION, VERSION_OPTION, QUIETLY_OPTION, HEADLESS_OPTION, LOG_LEVEL_OPTION, DEPENDENCIES_OPTION } = require("./options");
 
-const n = NO_OPTION,
-      y = YES_OPTION,
+const y = YES_OPTION,
       h = HELP_OPTION,
       t = TAIL_OPTION,
       f = FOLLOW_OPTION,
       d = DRY_RUN_OPTION,
       v = VERSION_OPTION,
       q = QUIETLY_OPTION,
-      l = LOG_LEVEL_OPTION
+      x = HEADLESS_OPTION,
+      l = LOG_LEVEL_OPTION,
+      a = DEPENDENCIES_OPTION;
 
 module.exports = {
-  n,
   y,
   h,
   t,
@@ -21,5 +21,7 @@ module.exports = {
   d,
   v,
   q,
-  l
+  x,
+  l,
+  a
 };

package/bin/action/clone.js

@@ -1,25 +1,23 @@
 "use strict";
 
 const cloneOperation = require("../operation/clone"),
-      cloneReleasesOperation = require("../operation/cloneReleases"),
-      releaseNamePromptOperation = require("../operation/prompt/releaseName"),
-      cloneDependenciesPromptOperation = require("../operation/prompt/cloneDependencies");
+      cloneRepositoriesOperation = require("../operation/cloneRepositories"),
+      repositoryNamePromptOperation = require("../operation/prompt/repositoryName");
 
 const { executeOperations } = require("../utilities/operation"),
       { SUCCESSFUL_CLONE_MESSAGE, FAILED_CLONE_MESSAGE } = require("../messages");
 
-function cloneAction(releaseName, quietly, yes, no) {
+function cloneAction(repositoryName, dependencies, headless, quietly) {
   const operations = [
-          releaseNamePromptOperation,
-          cloneDependenciesPromptOperation,
+          repositoryNamePromptOperation,
           cloneOperation,
-          cloneReleasesOperation
+          cloneRepositoriesOperation
         ],
         context = {
-          no,
-          yes,
           quietly,
-          releaseName
+          headless,
+          dependencies,
+          repositoryName
         };
 
   executeOperations(operations, (completed) => {

package/bin/action/help.js

@@ -17,7 +17,7 @@ Commands:
 
   set-options                                     Set options 
 
-  clone <package_name>                            Clone a package with Git
+  clone <repository_name>                         Clone a repository with Git
 
   publish <package_name>                          Publish a package
 
@@ -43,11 +43,15 @@ Options:
 
   --log-level|-l                                  Set the log level when publishing
   
-  --yes|-y                                        Initially answer yes to prompts
+  --yes|-y                                        Automatically answer yes to affiermation prompts
 
-  --tail|-t                                       Sets the size of the tail of the log messages when publishing. The default is ten. 
+  --tail|-t                                       Sets the size of the tail of the log messages when publishing. The default is ten 
 
-  --follow|-f                                     Show all of the log messages when publishing. The default is false.
+  --follow|-f                                     Show all of the log messages when publishing. The default is false
+
+  --headless|-x                                   Headless mode. Clone or open all dependencies bar the repository or package itself
+  
+  --dependencies|-a                               Include dependencies when cloning repositories or opening packages
 
 Further information:
 

package/bin/action/open.js

@@ -1,24 +1,24 @@
 "use strict";
 
 const openOperation = require("../operation/open"),
-      openReleasesOperation = require("../operation/openReleases"),
-      openDependenciesOperation = require("../operation/openDependencies"),
+      openReleasesOperation = require("../operation/openReleasees"),
       releaseNamePromptOperation = require("../operation/prompt/releaseName");
 
 const { executeOperations } = require("../utilities/operation"),
       { SUCCESSFUL_OPEN_MESSAGE, FAILED_OPEN_MESSAGE } = require("../messages");
 
-function openAction(releaseName, quietly, no) {
+function openAction(releaseName, dependencies, headless, quietly, yes) {
   const operations = [
           releaseNamePromptOperation,
-          openDependenciesOperation,
           openOperation,
           openReleasesOperation
         ],
         context = {
-          no,
+          yes,
           quietly,
-          releaseName
+          headless,
+          releaseName,
+          dependencies
         };
 
   executeOperations(operations, (completed) => {

package/bin/defaults.js

@@ -6,8 +6,7 @@ const { EMPTY_STRING } = require("./constants");
 
 const { INFO_LEVEL } = levels;
 
-const DEFAULT_NO = false,
-      DEFAULT_YES = false,
+const DEFAULT_YES = false,
       DEFAULT_HELP = false,
       DEFAULT_HOST = "https://openmathematics.org",
       DEFAULT_TAIL = 10,
@@ -15,12 +14,13 @@ const DEFAULT_NO = false,
       DEFAULT_DRY_RUN = false,
       DEFAULT_VERSION = false,
       DEFAULT_QUIETLY = false,
+      DEFAULT_HEADLESS = false,
       DEFAULT_LOG_LEVEL = INFO_LEVEL,
+      DEFAULT_DEPENDENCIES = false,
       DEFAULT_SHELL_COMMANDS = EMPTY_STRING,
       DEFAULT_GITHUB_HOST_NAME = "github.com";
 
 module.exports = {
-  DEFAULT_NO,
   DEFAULT_YES,
   DEFAULT_HELP,
   DEFAULT_HOST,
@@ -29,7 +29,9 @@ module.exports = {
   DEFAULT_DRY_RUN,
   DEFAULT_VERSION,
   DEFAULT_QUIETLY,
+  DEFAULT_HEADLESS,
   DEFAULT_LOG_LEVEL,
+  DEFAULT_DEPENDENCIES,
   DEFAULT_SHELL_COMMANDS,
   DEFAULT_GITHUB_HOST_NAME
 };

package/bin/descriptions.js

@@ -7,9 +7,9 @@ const USE_SSH_DESCRIPTION = "Use SSH when cloning: ",
       ARE_YOU_SURE_DESCRIPTION = "Are you sure? (y)es (n)o: ",
       EMAIL_ADDRESS_DESCRIPTION = "Email address: ",
       SHELL_COMMANDS_DESCRIPTION = "Shell command(s) to run after successful publishing: ",
+      REPOSITORY_NAME_DESCRIPTION = "Repository name: ",
       CONFIRM_PASSWORD_DESCRIPTION = "Confirm password: ",
       GITHUB_HOST_NAME_DESCRIPTION = "GitHub host name (leave blank for default): ",
-      CLONE_DEPENDENCIES_DESCRIPTION = "Clone dependencies? (y)es (n)o: ",
       EMAIL_ADDRESS_OR_USERNAME_DESCRIPTION = "Email address or username: ";
 
 module.exports = {
@@ -20,8 +20,8 @@ module.exports = {
   ARE_YOU_SURE_DESCRIPTION,
   EMAIL_ADDRESS_DESCRIPTION,
   SHELL_COMMANDS_DESCRIPTION,
+  REPOSITORY_NAME_DESCRIPTION,
   CONFIRM_PASSWORD_DESCRIPTION,
   GITHUB_HOST_NAME_DESCRIPTION,
-  CLONE_DEPENDENCIES_DESCRIPTION,
   EMAIL_ADDRESS_OR_USERNAME_DESCRIPTION
 };

package/bin/main.js

@@ -15,7 +15,7 @@ const helpAction = require("./action/help"),
       setShellCommandsAction = require("./action/setShellCommands");
 
 const { NO_ARGUMENT_GIVEN_MESSAGE, COMMAND_NOT_RECOGNISED_MESSAGE } = require("./messages"),
-      { DEFAULT_NO, DEFAULT_YES, DEFAULT_TAIL, DEFAULT_FOLLOW, DEFAULT_DRY_RUN, DEFAULT_QUIETLY, DEFAULT_LOG_LEVEL } = require("./defaults"),
+      { DEFAULT_YES, DEFAULT_TAIL, DEFAULT_FOLLOW, DEFAULT_DRY_RUN, DEFAULT_QUIETLY, DEFAULT_HEADLESS, DEFAULT_LOG_LEVEL, DEFAULT_DEPENDENCIES } = require("./defaults"),
       { HELP_COMMAND,
         OPEN_COMMAND,
         CLONE_COMMAND,
@@ -31,13 +31,14 @@ const { NO_ARGUMENT_GIVEN_MESSAGE, COMMAND_NOT_RECOGNISED_MESSAGE } = require(".
         SET_SHELL_COMMANDS_COMMAND } = require("./commands");
 
 function main(command, argument, options) {
-  const { no = DEFAULT_NO,
-          yes = DEFAULT_YES,
+  const { yes = DEFAULT_YES,
           tail = DEFAULT_TAIL,
           follow = DEFAULT_FOLLOW,
           dryRun = DEFAULT_DRY_RUN,
           quietly = DEFAULT_QUIETLY,
-          logLevel = DEFAULT_LOG_LEVEL } = options;
+          headless = DEFAULT_HEADLESS,
+          logLevel = DEFAULT_LOG_LEVEL,
+          dependencies = DEFAULT_DEPENDENCIES } = options;
 
   switch (command) {
     case HELP_COMMAND: {
@@ -64,7 +65,7 @@ function main(command, argument, options) {
       } else {
         const releaseName = argument; ///
 
-        openAction(releaseName, quietly, no);
+        openAction(releaseName, dependencies, headless, quietly, yes);
       }
 
       break;
@@ -74,9 +75,9 @@ function main(command, argument, options) {
       if (argument === null) {
         console.log(NO_ARGUMENT_GIVEN_MESSAGE);
       } else {
-        const releaseName = argument;  ///
+        const repositoryName = argument;  ///
 
-        cloneAction(releaseName, quietly, yes, no);
+        cloneAction(repositoryName, dependencies, headless, quietly);
       }
 
       break;

package/bin/messages.js

@@ -12,10 +12,11 @@ const NO_ARGUMENT_GIVEN_MESSAGE = "No argument has been given.",
       INVALID_AFFIRMATION_MESSAGE = "You must answer (y)es or (n)o.",
       INVALID_RELEASE_NAME_MESSAGE = "Package names must consist of groups of at least two and no more than sixteen numbers or lowercase letters, separated by dashes.",
       INVALID_EMAIL_ADDRESS_MESSAGE = "The email address does not appear to be a valid one.",
+      INVALID_REPOSITORY_NAME_MESSAGE = "Repository names must consist of groups of at least two and no more than sixteen numbers or lowercase letters, separated by dashes.",
       INVALID_GITHUB_HOST_NAME_MESSAGE = "The GitHub host name can be any number of alphabetical, numeric, dash or period characters, or can be left blank.",
       INVALID_EMAIL_ADDRESS_OR_USERNAME_MESSAGE = "The email address or username does not appear to be a valid one.",
       FAILED_OPEN_MESSAGE = "Failed to open the package.",
-      FAILED_CLONE_MESSAGE = "Failed to clone the package.",
+      FAILED_CLONE_MESSAGE = "Failed to clone the repository.",
       FAILED_PUBLISH_MESSAGE = "Failed to publish the package.",
       FAILED_WITHDRAW_MESSAGE = "Failed to withdraw the package.",
       FAILED_INITIALISE_MESSAGE = "Failed to create a configuration file because one is already present.",
@@ -23,9 +24,9 @@ const NO_ARGUMENT_GIVEN_MESSAGE = "No argument has been given.",
       FAILED_PROJECT_LOAD_MESSAGE = "Failed to load the project. Likely it is missing or perhaps it is already a package.",
       FAILED_SET_SHELL_COMMANDS_MESSAGE = "Failed to set the shell commands.",
       SUCCESSFUL_OPEN_MESSAGE = "The package has been opened successfully.",
-      SUCCESSFUL_CLONE_MESSAGE = "The package has been cloned successfully.",
+      SUCCESSFUL_CLONE_MESSAGE = "The repository has been cloned successfully.",
       SUCCESSFUL_PUBLISH_MESSAGE = "The package has been published successfully.",
-      SUCCESSFUL_WITHDRAW_MESSAGE = "The package has been withdrawd successfully.",
+      SUCCESSFUL_WITHDRAW_MESSAGE = "The package has been withdrawn successfully.",
       SUCCESSFUL_INITIALISE_MESSAGE = "The configuration file has been created successfully.",
       SUCCESSFUL_SET_OPTIONS_MESSAGE = "The options have been set successfully.",
       SUCCESSFUL_SET_SHELL_COMMANDS_MESSAGE = "The shell commands have been set successfully.";
@@ -43,6 +44,7 @@ module.exports = {
   INVALID_AFFIRMATION_MESSAGE,
   INVALID_RELEASE_NAME_MESSAGE,
   INVALID_EMAIL_ADDRESS_MESSAGE,
+  INVALID_REPOSITORY_NAME_MESSAGE,
   INVALID_GITHUB_HOST_NAME_MESSAGE,
   INVALID_EMAIL_ADDRESS_OR_USERNAME_MESSAGE,
   FAILED_OPEN_MESSAGE,

package/bin/operation/clone.js

@@ -5,7 +5,8 @@ const post = require("../post");
 const { CLONE_API_URI } = require("../uris");
 
 function cloneOperation(proceed, abort, context) {
-  const { releaseName } = context,
+  const { repositoryName } = context,
+        releaseName = repositoryName, ///
         uri = `${CLONE_API_URI}/${releaseName}`,
         json = {};
 

package/bin/operation/cloneRepositories.js

@@ -0,0 +1,136 @@
+"use strict";
+
+const { exec } = require("child_process"),
+      { Entries } = require("occam-entities"),
+      { arrayUtilities, fileSystemUtilities, asynchronousUtilities } = require("necessary");
+
+const { retrieveOptions } = require("../configuration"),
+      { DEFAULT_GITHUB_HOST_NAME } = require("../defaults");
+
+const { first } = arrayUtilities,
+      { forEach } = asynchronousUtilities,
+      { checkEntryExists } = fileSystemUtilities;
+
+function cloneRepositoriesOperation(proceed, abort, context) {
+  const { releases, dependencies } = context
+
+  if (dependencies) {
+    const success = true;
+
+    Object.assign(context, {
+      success
+    });
+
+    forEach(releases, cloneRepositoryOperation, () => {
+      const { success } = context;
+
+      delete context.success;
+
+      success ?
+        proceed() :
+          abort();
+    }, context);
+
+    return;
+  }
+
+  const success = true;
+
+  Object.assign(context, {
+    success
+  });
+
+  const firstRelease = first(releases),
+        release = firstRelease, ///
+        index = Infinity,
+        done = null;
+
+  cloneRepositoryOperation(release, () => {
+    const { success } = context;
+
+    delete context.success;
+
+    success ?
+      proceed() :
+        abort();
+  }, done, context, index);
+}
+
+module.exports = cloneRepositoriesOperation;
+
+function cloneRepositoryOperation(release, next, done, context, index) {
+  if (index === 0) {
+    const { headless } = context;
+
+    if (headless) {
+      next();
+
+      return;
+    }
+  }
+
+  const { name, quietly } = release,
+        entryPath = name, ///
+        entryExists = checkEntryExists(entryPath);
+
+  if (entryExists) {
+    if (!quietly) {
+      console.log(`Cannot clone the '${name}' package because a file or directory with that name already exists.`);
+    }
+
+    const success = false;
+
+    Object.assign(context, {
+      success
+    });
+
+    next();
+
+    return;
+  }
+
+  done = next;  ///
+
+  cloneRepository(release, quietly, done);
+}
+
+function cloneRepository(release, quietly, done) {
+  let repository = repositoryFromRelease(release)
+
+  const options = retrieveOptions(),
+        { ssh } = options;
+
+  if (ssh) {
+    const { gitHubHostName } = ssh;
+
+    repository = repository.replace(`https://${DEFAULT_GITHUB_HOST_NAME}/`, `git@${gitHubHostName}:`)
+  }
+
+  const command = `git clone ${repository}.git`;
+
+  exec(command, (error) => {
+    if (error) {
+      console.log(error);
+    }
+
+    if (!quietly) {
+      const { name } = release;
+
+      console.log(name);
+    }
+
+    done();
+  });
+}
+
+function repositoryFromRelease(release) {
+  let { entries } = release;
+
+  const json = entries; ///
+
+  entries = Entries.fromJSON(json);
+
+  const repository = entries.getRepository();
+
+  return repository;
+}

package/bin/operation/openReleasees.js

@@ -0,0 +1,184 @@
+"use strict";
+
+const { arrayUtilities, shellUtilities, fileSystemUtilities, asynchronousUtilities } = require("necessary");
+
+const { isFileRelease } = require("../utilities/release"),
+      { validateAnswer } = require("../utilities/validate"),
+      { isAnswerAffirmative } = require("../utilities/prompt"),
+      { INVALID_ANSWER_MESSAGE } = require("../messages");
+
+const { first } = arrayUtilities,
+      { prompt } = shellUtilities,
+      { forEach } = asynchronousUtilities,
+      { writeFile, removeEntry, checkEntryExists, isEntryDirectory } = fileSystemUtilities;
+
+function openReleasesOperation(proceed, abort, context) {
+  const { releases, dependencies } = context;
+
+  if (dependencies) {
+    const success = true;
+
+    Object.assign(context, {
+      success
+    });
+
+    forEach(releases, openReleasePromptOperation, () => {
+      const { success } = context;
+
+      delete context.success;
+
+      success ?
+        proceed() :
+          abort();
+    }, context);
+
+    return;
+  }
+
+  const success = true;
+
+  Object.assign(context, {
+    success
+  });
+
+  const firstRelease = first(releases),
+        release = firstRelease, ///
+        index = Infinity,
+        done = null;
+
+  openReleasePromptOperation(release, () => {
+    const { success } = context;
+
+    delete context.success;
+
+    success ?
+      proceed() :
+        abort();
+  }, done, context, index);
+}
+
+module.exports = openReleasesOperation;
+
+function openReleasePromptOperation(release, next, done, context, index) {
+  if (index === 0) {
+    const { headless } = context;
+
+    if (headless) {
+      next();
+
+      return;
+    }
+  }
+
+  const { name, quietly } = release,
+        entryPath = name, ///
+        entryExists = checkEntryExists(entryPath);
+
+  if (!entryExists) {
+    openRelease(release, quietly);
+
+    next();
+
+    return;
+  }
+
+  const entryDirectory = isEntryDirectory(entryPath);
+
+  if (entryDirectory) {
+    if (!quietly) {
+      console.log(`Cannot open the '${name}' package because a directory with that name already exists.`);
+    }
+
+    const success = false;
+
+    Object.assign(context, {
+      success
+    });
+
+    next();
+
+    return;
+  }
+
+  const fileName = name,
+        fileRelease = isFileRelease(fileName);
+
+  if (!fileRelease) {
+    if (!quietly) {
+      console.log(`The '${name}' file is not a package and therefore cannot be overwritten.`);
+    }
+
+    const success = false;
+
+    Object.assign(context, {
+      success
+    });
+
+    next();
+
+    return;
+  }
+
+  const { yes } = context;
+
+  if (yes) {
+    if (!quietly) {
+      console.log(`Overwriting the existing '${name}' package.`);
+    }
+
+    removeEntry(entryPath);
+
+    openRelease(release, quietly);
+
+    return;
+  }
+
+  const description = `Overwrite the existing '${name}' package? (y)es (n)o: `,
+        errorMessage = INVALID_ANSWER_MESSAGE,
+        validationFunction = validateAnswer,  ///
+        options = {
+          description,
+          errorMessage,
+          validationFunction
+        };
+
+  prompt(options, (answer) => {
+    const valid = (answer !== null);
+
+    if (valid) {
+      const affirmative = isAnswerAffirmative(answer);
+
+      if (affirmative) {
+        removeEntry(entryPath);
+
+        openRelease(release, quietly);
+      }
+
+      next();
+
+      return;
+    }
+
+    const success = false;
+
+    Object.assign(context, {
+      success
+    });
+
+    next();
+  });
+}
+
+function openRelease(release, quietly) {
+  const { name } = release,
+        filePath = name,  ///
+        releaseJSON = release,  ///
+        releaseJSONString = JSON.stringify(releaseJSON),
+        content = releaseJSONString; ///
+
+  writeFile(filePath, content);
+
+  if (!quietly) {
+    console.log(name);
+  }
+}

package/bin/operation/prompt/repositoryName.js

@@ -0,0 +1,53 @@
+"use strict";
+
+const { shellUtilities } = require("necessary");
+
+const { validateRepositoryName } = require("../../utilities/validate"),
+      { REPOSITORY_NAME_DESCRIPTION } = require("../../descriptions"),
+      { INVALID_REPOSITORY_NAME_MESSAGE } = require("../../messages");
+
+const { prompt } = shellUtilities;
+
+function repositoryNamePromptOperation(proceed, abort, context) {
+  const { repositoryName } = context,
+				errorMessage = INVALID_REPOSITORY_NAME_MESSAGE;
+
+  if (repositoryName !== null) {
+    const valid = validateRepositoryName(repositoryName);
+
+    if (valid) {
+      proceed();
+      
+      return;
+    }
+
+    console.log(errorMessage);
+  }
+
+  const description = REPOSITORY_NAME_DESCRIPTION,
+        validationFunction = validateRepositoryName, ///
+        options = {
+          description,
+          errorMessage,
+          validationFunction
+        };
+
+  prompt(options, (answer) => {
+    const repositoryName = answer, ///
+          valid = (repositoryName !== null);
+
+    if (valid) {
+      Object.assign(context, {
+        repositoryName
+      });
+
+      proceed();
+      
+      return;
+    }
+
+    abort();
+  });
+}
+
+module.exports = repositoryNamePromptOperation;

package/bin/options.js

@@ -1,17 +1,17 @@
 "use strict";
 
-const NO_OPTION = "no",
-      YES_OPTION = "yes",
+const YES_OPTION = "yes",
       HELP_OPTION = "help",
       TAIL_OPTION = "tail",
       FOLLOW_OPTION = "follow",
       VERSION_OPTION = "version",
       QUIETLY_OPTION = "quietly",
       DRY_RUN_OPTION = "dry-run",
-      LOG_LEVEL_OPTION = "log-level";
+      HEADLESS_OPTION = "headless",
+      LOG_LEVEL_OPTION = "log-level",
+      DEPENDENCIES_OPTION = "dependencies";
 
 module.exports = {
-  NO_OPTION,
   YES_OPTION,
   HELP_OPTION,
   TAIL_OPTION,
@@ -19,5 +19,7 @@ module.exports = {
   VERSION_OPTION,
   QUIETLY_OPTION,
   DRY_RUN_OPTION,
-  LOG_LEVEL_OPTION
+  HEADLESS_OPTION,
+  LOG_LEVEL_OPTION,
+  DEPENDENCIES_OPTION
 };

package/bin/utilities/release.js

@@ -0,0 +1,17 @@
+"use strict";
+
+const { fileSystemUtilities } = require("occam-file-system");
+
+const { loadRelease } = fileSystemUtilities;
+
+function isFileRelease(fileName) {
+  const projectsDirectoryPath = process.cwd(), ///
+        release = loadRelease(fileName, projectsDirectoryPath),
+        fileRelease = (release !== null);
+
+  return fileRelease;
+}
+
+module.exports = {
+  isFileRelease
+};

package/bin/utilities/validate.js

@@ -14,6 +14,8 @@ function validateEmailAddress(emailAddress) { return /^[a-z0-9._%+-]+@[a-z0-9.-]
 
 function validateShellCommands(shellCommands) { return  /^.*$/.test(shellCommands); }
 
+function validateRepositoryName(repositoryName) { return /^[a-z0-9]{2,16}(?:-[a-z0-9]{2,16}){0,4}$/.test(repositoryName); }
+
 function validateGitHubHostName(gitHubHostName) { return /^[a-zA-Z0-9.\-]*$/.test(gitHubHostName); }
 
 function validateEmailAddressOrUsername(emailAddressOrUsername) {
@@ -42,6 +44,7 @@ module.exports = {
   validateReleaseName,
   validateEmailAddress,
   validateShellCommands,
+  validateRepositoryName,
   validateGitHubHostName,
   validateEmailAddressOrUsername
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "occam-open-cli",
   "author": "James Smith",
-  "version": "6.0.390",
+  "version": "6.1.0",
   "license": "MIT, Anti-996",
   "homepage": "https://github.com/djalbat/occam-open-cli",
   "description": "Occam's package management tool.",

package/bin/operation/clone.old.js

@@ -1,52 +0,0 @@
-"use strict";
-
-const { exec } = require("child_process"),
-      { fileSystemUtilities } = require("necessary");
-
-const { checkEntryExists } = fileSystemUtilities;
-
-const { retrieveOptions } = require("../configuration"),
-      { DEFAULT_GITHUB_HOST_NAME } = require("../defaults");
-
-function cloneOperation(proceed, abort, context) {
-  const { releaseName } = context,
-        path = releaseName, ///
-        entryExists = checkEntryExists(path);
-
-  if (entryExists) {
-    const { quietly } = context;
-
-    if (!quietly) {
-      console.log(`Cannot clone the '${releaseName}' package because an entry of that name already exists.`);
-    }
-
-    proceed();
-
-    return;
-  }
-
-  let { repository } = context;
-
-  const options = retrieveOptions(),
-        { ssh } = options;
-
-  if (ssh) {
-    const { gitHubHostName } = ssh;
-
-    repository = repository.replace(`https://${DEFAULT_GITHUB_HOST_NAME}/`, `git@${gitHubHostName}:`)
-  }
-
-  const command = `git clone ${repository}.git`;
-
-  exec(command, (error) => {
-    if (error) {
-      abort();
-
-      return;
-    }
-
-    proceed();
-  });
-}
-
-module.exports = cloneOperation;

package/bin/operation/cloneReleases.js

@@ -1,92 +0,0 @@
-"use strict";
-
-const { exec } = require("child_process"),
-      { Entries } = require("occam-entities"),
-      { fileSystemUtilities, asynchronousUtilities } = require("necessary");
-
-const { retrieveOptions } = require("../configuration"),
-      { DEFAULT_GITHUB_HOST_NAME } = require("../defaults");
-
-const { checkEntryExists } = fileSystemUtilities;
-
-const { forEach } = asynchronousUtilities;
-
-function cloneReleasesOperation(proceed, abort, context) {
-  const { releases } = context,
-        done = proceed; ///
-
-  forEach(releases, cloneReleasePromptOperation, done, context);
-}
-
-module.exports = cloneReleasesOperation;
-
-function cloneReleasePromptOperation(release, next, done, context, index) {
-  const { cloneDependencies } = context;
-
-  if (!cloneDependencies) {
-    if (index > 0) {
-      next();
-
-      return;
-    }
-  }
-
-  const { name, quietly } = release,
-        entryPath = name, ///
-        entryExists = checkEntryExists(entryPath);
-
-  if (entryExists) {
-    if (!quietly) {
-      console.log(`Cannot clone the '${name}' package because a directory of that name already exists.`);
-    }
-
-    next();
-
-    return;
-  }
-
-  done = next;  ///
-
-  cloneRelease(release, quietly, done);
-}
-
-function cloneRelease(release, quietly, done) {
-  let repository = repositoryFromRelease(release)
-
-  const options = retrieveOptions(),
-        { ssh } = options;
-
-  if (ssh) {
-    const { gitHubHostName } = ssh;
-
-    repository = repository.replace(`https://${DEFAULT_GITHUB_HOST_NAME}/`, `git@${gitHubHostName}:`)
-  }
-
-  const command = `git clone ${repository}.git`;
-
-  exec(command, (error) => {
-    if (error) {
-      console.log(error);
-    }
-
-    if (!quietly) {
-      const { name } = release;
-
-      console.log(name);
-    }
-
-    done();
-  });
-}
-
-function repositoryFromRelease(release) {
-  let { entries } = release;
-
-  const json = entries; ///
-
-  entries = Entries.fromJSON(json);
-
-  const repository = entries.getRepository();
-
-  return repository;
-}

package/bin/operation/openDependencies.js

@@ -1,14 +0,0 @@
-"use strict";
-
-function openDependenciesOperation(proceed, abort, context) {
-  const { no } = context,
-        openDependencies = !no;
-
-  Object.assign(context, {
-    openDependencies
-  });
-
-  proceed();
-}
-
-module.exports = openDependenciesOperation;

package/bin/operation/openReleases.js

@@ -1,97 +0,0 @@
-"use strict";
-
-const { shellUtilities, fileSystemUtilities, asynchronousUtilities } = require("necessary");
-
-const { YES, NO} = require("../constants"),
-      { validateAnswer } = require("../utilities/validate"),
-      { isAnswerAffirmative } = require("../utilities/prompt"),
-      { INVALID_ANSWER_MESSAGE } = require("../messages");
-
-const { writeFile, removeEntry, checkEntryExists, isEntryDirectory } = fileSystemUtilities;
-
-const { prompt } = shellUtilities,
-      { forEach } = asynchronousUtilities;
-
-function openReleasesOperation(proceed, abort, context) {
-  const { releases } = context,
-        done = proceed; ///
-
-  forEach(releases, openReleasePromptOperation, done, context);
-}
-
-module.exports = openReleasesOperation;
-
-function openReleasePromptOperation(release, next, done, context, index) {
-  const { openDependencies } = context;
-
-  if (!openDependencies) {
-    if (index > 0) {
-      next();
-
-      return;
-    }
-  }
-
-  const { name, quietly } = release,
-        entryPath = name, ///
-        entryExists = checkEntryExists(entryPath);
-
-  if (!entryExists) {
-    openRelease(release, quietly);
-
-    next();
-
-    return;
-  }
-
-  const entryDirectory = isEntryDirectory(entryPath);
-
-  if (entryDirectory) {
-    if (!quietly) {
-      console.log(`Cannot open the '${name}' package because a directory of that name already exists.`);
-    }
-
-    next();
-
-    return;
-  }
-
-  const description = `Overwrite the existing '${name}' package? (y)es (n)o: `,
-        errorMessage = INVALID_ANSWER_MESSAGE,
-        validationFunction = validateAnswer,  ///
-        options = {
-          description,
-          errorMessage,
-          validationFunction
-        };
-
-  prompt(options, (answer) => {
-    const valid = (answer !== null);
-
-    if (valid) {
-      const affirmative = isAnswerAffirmative(answer);
-
-      if (affirmative) {
-        removeEntry(entryPath);
-
-        openRelease(release, quietly);
-      }
-
-      next();
-    }
-  });
-}
-
-function openRelease(release, quietly) {
-  const { name } = release,
-        filePath = name,  ///
-        releaseJSON = release,  ///
-        releaseJSONString = JSON.stringify(releaseJSON),
-        content = releaseJSONString; ///
-
-  writeFile(filePath, content);
-
-  if (!quietly) {
-    console.log(name);
-  }
-}

package/bin/operation/prompt/cloneDependencies.js

@@ -1,56 +0,0 @@
-"use strict";
-
-const { shellUtilities } = require("necessary");
-
-const { YES, NO } = require("../../constants"),
-      { isAnswerAffirmative } = require("../../utilities/prompt"),
-      { validateAffirmation } = require("../../utilities/validate"),
-      { INVALID_AFFIRMATION_MESSAGE } = require("../../messages"),
-      { CLONE_DEPENDENCIES_DESCRIPTION } = require("../../descriptions");
-
-const { prompt } = shellUtilities;
-
-function cloneDependenciesPromptOperation(proceed, abort, context) {
-  let answer = null;
-
-  const { yes, no } = context;
-
-  if (yes) {
-    answer = YES;
-  }
-
-  if (no) {
-    answer = NO;
-  }
-
-  const description = CLONE_DEPENDENCIES_DESCRIPTION,
-        errorMessage = INVALID_AFFIRMATION_MESSAGE,
-        validationFunction = validateAffirmation,  ///
-        options = {
-          answer,
-          description,
-          errorMessage,
-          validationFunction
-        };
-
-  prompt(options, (answer) => {
-    const valid = (answer !== null);
-
-    if (valid) {
-      const affirmative = isAnswerAffirmative(answer),
-            cloneDependencies = affirmative; ///
-
-      Object.assign(context, {
-        cloneDependencies
-      });
-
-      proceed();
-
-      return;
-    }
-
-    abort();
-  });
-}
-
-module.exports = cloneDependenciesPromptOperation;