@automattic/vip 2.10.0 → 2.12.0

package/package/dist/bin/vip-dev-env-create.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+"use strict";
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _chalk = _interopRequireDefault(require("chalk"));
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var exit = _interopRequireWildcard(require("../lib/cli/exit"));
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Internal dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create`,
+  description: 'Creates a local dev environment'
+}, {
+  usage: `vip @123.production ${_devEnvironment.DEV_ENVIRONMENT_SUBCOMMAND} create`,
+  description: 'Creates a local dev environment for production site for id 123'
+}, {
+  usage: `vip ${_devEnvironment.DEV_ENVIRONMENT_SUBCOMMAND} create --slug=my_site`,
+  description: 'Creates a local dev environment aliased as "my_site"'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create --slug=test`,
+  description: 'Assigning unique slugs to environments allows multiple environments to be created.'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create --multisite --wordpress="5.8" --client-code="~/git/my_code"`,
+  description: 'Creates a local multisite dev environment using WP 5.8 and client code is expected to be in "~/git/my_code"'
+}];
+const cmd = (0, _command.default)().option('slug', 'Custom name of the dev environment').option('title', 'Title for the WordPress site').option('multisite', 'Enable multisite install', undefined, value => {
+  var _value$toLowerCase;
+
+  return 'false' !== (value === null || value === void 0 ? void 0 : (_value$toLowerCase = value.toLowerCase) === null || _value$toLowerCase === void 0 ? void 0 : _value$toLowerCase.call(value));
+});
+(0, _devEnvironmentCli.addDevEnvConfigurationOptions)(cmd);
+cmd.examples(examples);
+cmd.argv(process.argv, async (arg, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  debug('Args: ', arg, 'Options: ', opt);
+  const trackingInfo = {
+    slug
+  };
+  await (0, _tracker.trackEvent)('dev_env_create_command_execute', trackingInfo);
+
+  const startCommand = _chalk.default.bold((0, _devEnvironmentCli.getEnvironmentStartCommand)(opt));
+
+  const environmentAlreadyExists = (0, _devEnvironmentCore.doesEnvironmentExist)(slug);
+
+  if (environmentAlreadyExists) {
+    const messageToShow = `Environment already exists\n\n\nTo start the environment run:\n\n${startCommand}\n\n` + `To create another environment use ${_chalk.default.bold('--slug')} option with a unique name.\n`;
+    exit.withError(messageToShow);
+  }
+
+  let defaultOptions = {};
+
+  try {
+    if (opt.app) {
+      const appInfo = await (0, _devEnvironmentCore.getApplicationInformation)(opt.app, opt.env);
+      defaultOptions = (0, _devEnvironmentCli.getOptionsFromAppInfo)(appInfo);
+    }
+  } catch (error) {
+    const message = `failed to fetch application "${opt.app}" information`;
+    debug(`WARNING: ${message}`, error.message);
+    console.log(_chalk.default.yellow('Warning:'), message);
+  }
+
+  const instanceData = await (0, _devEnvironmentCli.promptForArguments)(opt, defaultOptions);
+  instanceData.siteSlug = slug;
+
+  try {
+    await (0, _devEnvironmentCore.createEnvironment)(instanceData);
+    await (0, _devEnvironmentCore.printEnvironmentInfo)(slug);
+    const message = '\n' + _chalk.default.green('✓') + ` environment created.\n\nTo start it please run:\n\n${startCommand}\n`;
+    console.log(message);
+    await (0, _tracker.trackEvent)('dev_env_create_command_success', trackingInfo);
+  } catch (error) {
+    await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_create_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-destroy.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+"use strict";
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _chalk = _interopRequireDefault(require("chalk"));
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Internal dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} destroy`,
+  description: 'Destroys the default local dev environment'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} destroy --slug=foo`,
+  description: 'Destroys a local dev environment named foo'
+}];
+(0, _command.default)().option('slug', 'Custom name of the dev environment').option('soft', 'Keep config files needed to start an environment intact').examples(examples).argv(process.argv, async (arg, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_destroy_command_execute', trackingInfo);
+  debug('Args: ', arg, 'Options: ', opt);
+
+  try {
+    const removeFiles = !(opt.soft || false);
+    await (0, _devEnvironmentCore.destroyEnvironment)(slug, removeFiles);
+    const message = _chalk.default.green('✓') + ' Environment destroyed.\n';
+    console.log(message);
+    await (0, _tracker.trackEvent)('dev_env_destroy_command_success', trackingInfo);
+  } catch (error) {
+    await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_destroy_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-exec.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+"use strict";
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} exec -- wp post list`,
+  description: 'Use dev-environment to run `wp post list`'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} exec --slug my_site -- wp shell`,
+  description: 'Use dev-environment "my_site" to run interactive wp shell'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} exec -- add-site --new-site-slug subsite --new-site-title "New Subsite"`,
+  description: 'Execute script to add a subsite to multisite dev environment'
+}];
+(0, _command.default)({
+  wildcardCommand: true
+}).option('slug', 'Custom name of the dev environment').examples(examples).argv(process.argv, async (unmatchedArgs, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_exec_command_execute', trackingInfo);
+
+  try {
+    // to avoid confusion let's enforce -- as a splitter for arguments for this command and wp itself
+    const argSplitterIx = process.argv.findIndex(argument => '--' === argument);
+    const argSplitterFound = argSplitterIx > -1;
+
+    if (unmatchedArgs.length > 0 && !argSplitterFound) {
+      throw new Error('Please provide "--" argument to separate arguments for "vip" and command to be executed (see "--help" for examples)');
+    }
+
+    let arg = [];
+
+    if (argSplitterFound && argSplitterIx + 1 < process.argv.length) {
+      arg = process.argv.slice(argSplitterIx + 1);
+    }
+
+    await (0, _devEnvironmentCore.exec)(slug, arg);
+    await (0, _tracker.trackEvent)('dev_env_exec_command_success', trackingInfo);
+  } catch (error) {
+    (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_exec_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-import-media.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+"use strict";
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import media path/to/wp-content/uploads`,
+  description: 'Import contents of the given WP uploads folder file into the media library of the default dev environment'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import media path/to/wp-content/uploads --slug=mysite`,
+  description: 'Import contents of the given WP uploads folder file into the media library of a dev environment named `mysite`'
+}];
+(0, _command.default)({
+  requiredArgs: 1
+}).examples(examples).option('slug', 'Custom name of the dev environment').argv(process.argv, async (unmatchedArgs, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const [filePath] = unmatchedArgs;
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_import_media_command_execute', trackingInfo);
+
+  try {
+    await (0, _devEnvironmentCore.importMediaPath)(slug, filePath);
+    await (0, _tracker.trackEvent)('dev_env_import_media_command_success', trackingInfo);
+  } catch (error) {
+    (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_import_media_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-import-sql.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+"use strict";
+
+var _fs = _interopRequireDefault(require("fs"));
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+var _sql = require("../lib/validations/sql");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Internal dependencies
+ */
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql some-wp-db-file.sql`,
+  description: 'Import the contents of a WordPress database from an SQL file'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql wordpress.sql --slug=my_site`,
+  description: 'Import the contents of a WordPress database from an SQL file into `my_site`'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql wordpress.sql --search-replace="testsite.com,test-site.go-vip.net"`,
+  description: 'Import the contents of a WordPress database from an SQL file and replace the occurrences of `testsite.com` with `test-site.go-vip.net`'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql wordpress.sql --search-replace="testsite.com,test-site.go-vip.net" --in-place`,
+  description: 'Import the contents of a WordPress database from an SQL file and replace the occurrences of `testsite.com` with `test-site.go-vip.net` in place (modifies the original SQL file)'
+}];
+(0, _command.default)({
+  requiredArgs: 1
+}).option('slug', 'Custom name of the dev environment').option('search-replace', 'Perform Search and Replace on the specified SQL file').option('in-place', 'Search and Replace explicitly on the given input file').option('skip-validate', 'Do not perform file validation.').examples(examples).argv(process.argv, async (unmatchedArgs, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const [fileName] = unmatchedArgs;
+  const {
+    searchReplace,
+    inPlace
+  } = opt;
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_import_sql_command_execute', trackingInfo);
+
+  try {
+    const {
+      resolvedPath,
+      inContainerPath
+    } = await (0, _devEnvironmentCore.resolveImportPath)(slug, fileName, searchReplace, inPlace);
+
+    if (!opt.skipValidate) {
+      await (0, _sql.validate)(fileName, []);
+    }
+
+    const importArg = ['wp', 'db', 'import', inContainerPath];
+    await (0, _devEnvironmentCore.exec)(slug, importArg);
+
+    if (searchReplace && searchReplace.length && !inPlace) {
+      _fs.default.unlinkSync(resolvedPath);
+    }
+
+    const cacheArg = ['wp', 'cache', 'flush'];
+    await (0, _devEnvironmentCore.exec)(slug, cacheArg);
+    const addUserArg = ['wp', 'dev-env-add-admin', '--username=vipgo', '--password=password'];
+    await (0, _devEnvironmentCore.exec)(slug, addUserArg);
+    await (0, _tracker.trackEvent)('dev_env_import_sql_command_success', trackingInfo);
+  } catch (error) {
+    (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_import_sql_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-import.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+"use strict";
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql file.sql`,
+  description: 'Import the given SQL file to your site'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import media path/to/wp-content/uploads`,
+  description: 'Import contents of the given WP uploads folder file into the media library of the default dev environment'
+}];
+(0, _command.default)({
+  requiredArgs: 1
+}).examples(examples).command('sql', 'Import SQL to your dev-env database from a file').command('media', 'Import media files to the dev environment of your application from a compressed web archive. ' + 'This command will copy the contents of a folder to the `uploads` folder of the target dev environment.').argv(process.argv);

package/package/dist/bin/vip-dev-env-info.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+"use strict";
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Internal dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} info --all`,
+  description: 'Return information about all local dev environments'
+}, {
+  usage: `vip @123 ${_devEnvironment.DEV_ENVIRONMENT_SUBCOMMAND} info`,
+  description: 'Return information about dev environment for site 123'
+}, {
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} info --slug=my_site`,
+  description: 'Return information about a local dev environment named "my_site"'
+}];
+(0, _command.default)().option('slug', 'Custom name of the dev environment').option('all', 'Show Info for all local dev environments').examples(examples).argv(process.argv, async (arg, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  const trackingInfo = opt.all ? {
+    all: true
+  } : (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_info_command_execute', trackingInfo);
+  debug('Args: ', arg, 'Options: ', opt);
+
+  try {
+    if (opt.all) {
+      await (0, _devEnvironmentCore.printAllEnvironmentsInfo)();
+    } else {
+      await (0, _devEnvironmentCore.printEnvironmentInfo)(slug);
+    }
+
+    await (0, _tracker.trackEvent)('dev_env_info_command_success', trackingInfo);
+  } catch (error) {
+    (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_info_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-list.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+"use strict";
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} list`,
+  description: 'Return information about all local dev environments'
+}];
+(0, _command.default)().examples(examples).argv(process.argv, async () => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const trackingInfo = {
+    all: true
+  };
+  await (0, _tracker.trackEvent)('dev_env_list_command_execute', trackingInfo);
+
+  try {
+    await (0, _devEnvironmentCore.printAllEnvironmentsInfo)();
+    await (0, _tracker.trackEvent)('dev_env_list_command_success', trackingInfo);
+  } catch (error) {
+    (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_list_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-start.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+"use strict";
+
+var _chalk = _interopRequireDefault(require("chalk"));
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _child_process = require("child_process");
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Internal dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment'); // PowerShell command for Windows Docker patch
+
+const dockerWindowsPathCmd = 'wsl -d docker-desktop bash -c "sysctl -w vm.max_map_count=262144"';
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} start`,
+  description: 'Starts a local dev environment'
+}];
+(0, _command.default)().option('slug', 'Custom name of the dev environment').option('skip-rebuild', 'Only start stopped services').examples(examples).argv(process.argv, async (arg, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const startProcessing = new Date();
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_start_command_execute', trackingInfo);
+  debug('Args: ', arg, 'Options: ', opt);
+  const options = {
+    skipRebuild: !!opt.skipRebuild
+  };
+
+  try {
+    if (process.platform === 'win32') {
+      debug('Windows platform detected. Applying Docker patch...');
+      (0, _child_process.exec)(dockerWindowsPathCmd, {
+        shell: 'powershell.exe'
+      }, (error, stdout) => {
+        if (error != null) {
+          debug(error);
+          console.log(`${_chalk.default.red('✕')} There was an error while applying the Windows Docker patch.`);
+        } else {
+          debug(stdout);
+          console.log(`${_chalk.default.green('✓')} Docker patch for Windows applied.`);
+        }
+      });
+    }
+
+    await (0, _devEnvironmentCore.startEnvironment)(slug, options);
+    const processingTime = new Date() - startProcessing;
+    const successTrackingInfo = { ...trackingInfo,
+      processing_time: processingTime
+    };
+    await (0, _tracker.trackEvent)('dev_env_start_command_success', successTrackingInfo);
+  } catch (error) {
+    await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_start_command_error', trackingInfo);
+  }
+});

package/package/dist/bin/vip-dev-env-stop.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+"use strict";
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _chalk = _interopRequireDefault(require("chalk"));
+
+var _tracker = require("../lib/tracker");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
+
+var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
+
+var _devEnvironment = require("../lib/constants/dev-environment");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Internal dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const examples = [{
+  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} stop`,
+  description: 'Stops a local dev environment'
+}];
+(0, _command.default)().option('slug', 'Custom name of the dev environment').examples(examples).argv(process.argv, async (arg, opt) => {
+  await (0, _devEnvironmentCli.validateDependencies)();
+  const slug = (0, _devEnvironmentCli.getEnvironmentName)(opt);
+  debug('Args: ', arg, 'Options: ', opt);
+  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
+  await (0, _tracker.trackEvent)('dev_env_stop_command_execute', trackingInfo);
+
+  try {
+    await (0, _devEnvironmentCore.stopEnvironment)(slug);
+    const message = _chalk.default.green('✓') + ' environment stopped.\n';
+    console.log(message);
+    await (0, _tracker.trackEvent)('dev_env_stop_command_success', trackingInfo);
+  } catch (error) {
+    (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_stop_command_error', trackingInfo);
+  }
+});