@caweb/cli 1.0.3 → 1.0.5

package/README.md

@@ -1,15 +1,150 @@
 # caweb-cli
-`caweb-cli` rapidly sets up a local WordPress environment using [wp-env](https://www.npmjs.com/package/@wordpress/env), fully configured to the [CAWebPublishing Service](https://caweb.cdt.ca.gov/). The cli will automatically generate the necessary [.wp-env.json](https://www.npmjs.com/package/@wordpress/env#wp-envjson) file, to override or add additional configuration options use the [.wp-env.override.json](https://www.npmjs.com/package/@wordpress/env#wp-envoverridejson) file.
+`caweb-cli` utilizes [wp-env](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/) in the background; to rapidly set up a local WordPress environment, fully configured for the [CAWebPublishing Service](https://caweb.cdt.ca.gov/). The cli will automatically generate the necessary [.wp-env.json](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/#wp-env-json) file, to override or add additional configuration options use the [.wp-env.override.json](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/#wp-env-override-json) file.
 
 ## Additional Features
-- phpMyAdmin Service  
 - Downloads and configures the [CAWeb Theme](https://github.com/CA-cODE-Works/CAWeb)  
-- Downloads and configures the [Divi Theme](https://www.elegantthemes.com/gallery/divi/) (*requires valid ElegantThemes Username and API Key*)
+- Downloads and configures the [Divi Theme](https://www.elegantthemes.com/gallery/divi/) (*requires valid ElegantThemes Username and API Key*)  
+- Adds phpMyAdmin Service for both WordPress environments. (Username: <strong>bold</strong> , Password: <strong>password</strong>)  
+-- phpMyAdmin development site starts at http://localhost:8080  
+-- phpMyAdmin test site started at http://localhost:9090
 
+- Adds config.yml to both cli containers 
+<pre>
+path: /var/www/html
+apache_modules:
+  - mod_rewrite
+</pre>
 ## Command Reference
-`caweb-cli` is a wrapper for [wp-env](https://www.npmjs.com/package/@wordpress/env); therefore, all commands from wp-env are readily available, for more information on those commands [see](https://www.npmjs.com/package/@wordpress/env#command-referenced). ***Note:** substitute `wp-env` command with `caweb`. 
-
 ### `caweb start`  
-Starts the CAWebPublishing WordPress Environment.  
-### `caweb shell`  
-Open a shell session in the WordPress environment.
+Generates the required wp-env.json, starts the WordPress environment, downloads any CAWebPublishing sources and approved plugins.  
+<pre>
+caweb start
+
+Options:
+      --debug      Enable debug output.               [boolean] [default: false]
+      --update     Download source updates and apply WordPress configuration.
+                                                      [boolean] [default: false]
+      --xdebug     Enables Xdebug. If not passed, Xdebug is turned off. If no
+                   modes are set, uses "debug". You may set multiple Xdebug
+                   modes by passing them in a comma-separated list:
+                   `--xdebug=develop,coverage`. See
+                   https://xdebug.org/docs/all_settings#mode for information
+                   about Xdebug modes.                                  [string]
+      --scripts    Execute any configured lifecycle scripts.
+                                                       [boolean] [default: true]
+      --bare       True if excluding any downloads from CAWeb, use this if you
+                   want to use a local version of the CAWeb Theme,
+                   Configurations will still be applied.
+                                                      [boolean] [default: false]
+  -m, --multisite  True if converting to multisite.   [boolean] [default: false]
+      --subdomain  If passed, the network will use subdomains, instead of
+                   subdirectories. Doesn't work with 'localhost', make sure to
+                   set Port to 80.                    [boolean] [default: false]
+</pre>
+### `caweb stop`  
+<pre>
+caweb stop
+
+Stops running WordPress for development and tests and frees the ports.
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+</pre>
+### `caweb clean [environment]`  
+<pre>
+caweb clean [environment]
+
+Cleans the WordPress databases.
+
+Positionals:
+  environment  Which environments' databases to clean.
+            [string] [choices: "all", "development", "tests"] [default: "tests"]
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+  --scripts  Execute any configured lifecycle scripts. [boolean] [default: true]
+</pre>
+### `caweb run <container> [command...]`  
+<pre>
+caweb run <container> [command...]
+
+Runs an arbitrary command in one of the underlying Docker containers. A double
+dash can be used to pass arguments to the container without parsing them. This
+is necessary if you are using an option that is defined below. You can use
+`bash` to open a shell session and both `composer` and `phpunit` are available
+in all WordPress and CLI containers. WP-CLI is also available in the CLI
+containers.
+
+Positionals:
+  container  The underlying Docker service to run the command on.
+              [string] [required] [choices: "mysql", "tests-mysql", "wordpress",
+                                          "tests-wordpress", "cli", "tests-cli"]
+  command    The command to run.                           [array] [default: []]
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+  --env-cwd  The command's working directory inside of the container. Paths
+             without a leading slash are relative to the WordPress root.
+                                                         [string] [default: "."]
+</pre>
+### `caweb destroy`  
+<pre>
+caweb destroy
+
+Destroy the WordPress environment. Deletes docker containers, volumes, and
+networks associated with the WordPress environment and removes local files.
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+  --scripts  Execute any configured lifecycle scripts. [boolean] [default: true]
+</pre>
+### `caweb logs [environment]`  
+<pre>
+caweb logs [environment]
+
+displays PHP and Docker logs for given WordPress environment.
+
+Positionals:
+  environment  Which environment to display the logs from.
+      [string] [choices: "development", "tests", "all"] [default: "development"]
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+  --watch    Watch for logs as they happen.            [boolean] [default: true]
+</pre>
+### `caweb install-path`  
+<pre>
+caweb install-path
+
+Get the path where all of the environment files are stored. This includes the
+Docker files, WordPress, PHPUnit files, and any sources that were downloaded.
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+</pre>
+### `caweb shell [environment]`  
+<pre>
+caweb shell [environment]
+
+Open shell terminal in WordPress environment.
+
+Positionals:
+  environment  Which environment to open terminal in.
+             [string] [choices: "development", "tests"] [default: "development"]
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+</pre>
+### `caweb update-plugins [environment]`  
+<pre>
+caweb update-plugins [environment]
+
+Updates all plugins in the WordPress environment.
+
+Positionals:
+  environment  Which environment to update.
+             [string] [choices: "development", "tests"] [default: "development"]
+
+Options:
+  --debug    Enable debug output.                     [boolean] [default: false]
+</pre>

package/lib/caweb.js

@@ -62,6 +62,8 @@ async function configureCAWeb( environment, config, spinner ) {
 
 	// if our theme is active.
 	if( false !== isThemeActivated ){
+		spinner.text = `Configuring CAWebPublishing ${environment} Environment...`;
+
 		let themeOptions = [];
 
 		// iterate over config options.
@@ -114,15 +116,7 @@ async function configureCAWeb( environment, config, spinner ) {
 		)
 	}
 	
-	// rewrite and flush permalink structure.
-	await runDockerCmds(
-		environment,
-		[
-			`wp rewrite structure ${WP_PERMALINK} --hard`,
-			'wp rewrite flush --hard'
-		],
-		config
-	);
+	
 }
 
 module.exports = {

package/lib/cli.js

@@ -64,15 +64,7 @@ module.exports = function cli() {
 	// we are overwriting the default wp-env start command with our own.
 	yargs.command(
 		'start',
-		wpGreen(
-			chalk`Starts WordPress for development on port {bold.underline ${ terminalLink(
-				'8888',
-				'http://localhost:8888'
-			) }} (override with WP_ENV_PORT) and tests on port {bold.underline ${ terminalLink(
-				'8889',
-				'http://localhost:8889'
-			) }} (override with WP_ENV_TESTS_PORT). The current working directory must be a WordPress installation, a plugin, a theme, or contain a .wp-env.json file. After first install, use the '--update' flag to download updates to mapped sources and to re-apply WordPress configuration options.`
-		),
+		false,
 		( args ) => {
 			args.option( 'update', {
 				type: 'boolean',
@@ -104,7 +96,7 @@ module.exports = function cli() {
 			} );
 			args.option( 'subdomain', {
 				type: 'boolean',
-				describe: 'If passed, the network will use subdomains, instead of subdirectories. Doesn’t work with ‘localhost’.',
+				describe: "If passed, the network will use subdomains, instead of subdirectories. Doesn't work with 'localhost', make sure to set Port to 80.",
 				default: false,
 			} );
 		},
@@ -142,7 +134,7 @@ module.exports = function cli() {
 	)
 
 	// Test Command.
-	yargs.command(
+	/*yargs.command(
 		'test [environment]',
 		'Test commands on a WordPress environment', 
 		(args) => {
@@ -155,7 +147,7 @@ module.exports = function cli() {
 			
 		}, 
 		withSpinner( env.test )
-	)
+	)*/
 	
 	return yargs;
 };

package/lib/commands/start.js

@@ -28,7 +28,7 @@ const CONFIG_CACHE_KEY = 'config_checksum';
 const { configureCAWeb } = require('../caweb');
 const { buildWPEnvConfig, buildDockerComposeConfig } = require('../configs');
 const {downloadSources } = require('../download-sources');
-const { convertToMultisite } = require('../wordpress');
+const { configureWordPress } = require('../wordpress');
 
 /**
  * Promisified dependencies
@@ -115,26 +115,10 @@ module.exports = async function start({
 			await sleep( 4000 );
 		}
 
-
 		// Download any resources required for CAWeb.
 		if( ! bare ){
 			await downloadSources({spinner, config});
 		}
-				
-		// if multisite.
-		if( multisite ){
-			spinner.text = 'Converting to multisite ' + ( subdomain ? 'subdomain' : 'subdirectory') + '...'
-
-			await Promise.all( [
-				retry( () => convertToMultisite( 'development', config, subdomain ), {
-					times: 2,
-				} ),
-				retry( () => convertToMultisite( 'tests', config, subdomain ), {
-					times: 2,
-				} ),
-			] );
-	
-		}
 
 		// Write docker-compose.override.yml file to workDirectoryPath.
 		await writeFile(
@@ -142,7 +126,27 @@ module.exports = async function start({
 			yaml.dump( buildDockerComposeConfig(workDirectoryPath) )
 		);
 
-		spinner.text = 'Configuring CAWebPublishing Environments...';
+		// We need to bring the WordPress and CLI instances up again so they pick up
+		// any config changes that may have been added to the docker-compose.override.yml.
+		await dockerCompose.upMany(
+			[
+				'wordpress', 'tests-wordpress',
+				'cli', 'tests-cli'
+			], {
+			cwd: workDirectoryPath,
+			commandOptions: ['--build', '--force-recreate'],
+			log: debug
+		})
+
+		// Make additional WordPress Configurations.
+		await Promise.all( [
+			retry( () => configureWordPress( 'development', config, spinner, multisite, subdomain ), {
+				times: 2,
+			} ),
+			retry( () => configureWordPress( 'tests', config, spinner, multisite, subdomain ), {
+				times: 2,
+			} )
+		] );
 
 		// Make CAWeb WordPress Configurations.
 		await Promise.all( [
@@ -157,13 +161,9 @@ module.exports = async function start({
 		// Start phpMyAdmin Service.
 		spinner.text = 'Starting phpMyAdmin Service';
 
-		// We need to bring the WordPress instances up again so they pick up
-		// any config changes that may have been added to the docker-compose.override.yml.
 		await dockerCompose.upMany(
 			[
 				'phpmyadmin','tests-phpmyadmin',
-				'wordpress', 'tests-wordpress',
-				'cli', 'tests-cli'
 			], {
 			cwd: workDirectoryPath,
 			commandOptions: ['--build', '--force-recreate'],
@@ -172,7 +172,7 @@ module.exports = async function start({
 
 		spinner.prefixText = preText + 
 			`phpMyAdmin development site started at http://localhost:8080\n` +
-			`phpMyAdmin development site started at http://localhost:9090\n\n`;
+			`phpMyAdmin test site started at http://localhost:9090\n\n`;
 
 		spinner.text = 'Done!';
 

package/lib/commands/test.js

@@ -9,6 +9,8 @@ const { execSync } = require( 'child_process' );
 const dockerCompose = require( 'docker-compose' );
 const loadConfig = require( '@wordpress/env/lib/config/load-config' );
 const run = require('@wordpress/env/lib/commands/run');
+const getHostUser = require( '@wordpress/env/lib/get-host-user' );
+const yaml = require( 'js-yaml' );
 
 /**
  * Internal dependencies
@@ -16,7 +18,7 @@ const run = require('@wordpress/env/lib/commands/run');
 const {
 	runDockerCmds, 
 } = require('../docker');
-
+ 
 const { 
 	buildWPEnvConfig, 
 	buildDockerComposeConfig 
@@ -63,8 +65,16 @@ module.exports = async function test({
 	try {
 		const config = await loadConfig(path.resolve('.'));
 		const {WP_PERMALINK} = config.env[ environment ].config
-		
+		const { workDirectoryPath} = config;
+		const {name} = getHostUser();
+		const containerName = path.basename(workDirectoryPath) + ('tests' === environment ? '-tests' : '') + '-cli';
+		//const containerID = await execSync(`docker ps -qf "name=${containerName}"`).toString().trim();
+	
 		spinner.text = "Testing code...";
+			
+
+		spinner.text = 'Completed Testing code...'
+
 		/*
 		let result = await runDockerCmds(
 			environment,
@@ -79,7 +89,6 @@ module.exports = async function test({
 		}
 		*/
 
-		spinner.text = 'Completed Testing code...'
 
 	} catch(error) {
 		console.log(error)

package/lib/configs.js

@@ -4,8 +4,15 @@
 const path = require( 'path' );
 const fs = require('fs-extra');
 const pkg = require( '../package.json' );
+const yaml = require( 'js-yaml' );
+const getHostUser = require( '@wordpress/env/lib/get-host-user' );
 
 
+/**
+ * Promisified dependencies
+ */
+const { writeFile } = fs.promises;
+
 /**
  * Build .wp-env.json
  * 
@@ -44,6 +51,11 @@ const buildWPEnvConfig = (bare, multisite) => {
  * @returns object
  */
 const buildDockerComposeConfig = (workDirectoryPath) => {
+	const {name} = getHostUser();
+    
+    // generate cli config file for cli containers.
+    generateCLIConfig(workDirectoryPath);
+
     let dockerConfig = {
         version: '3.7',
         services: {
@@ -68,6 +80,32 @@ const buildDockerComposeConfig = (workDirectoryPath) => {
                     MEMORY_LIMIT: '5G',
                     MAX_EXECUTION_TIME: 7200
                 }
+            },
+            cli: {
+                build: {
+                    context: '.',
+                    dockerfile: 'CLI.Dockerfile'
+                },
+                volumes: [ path.join(workDirectoryPath, 'config.yml')  + `:/home/${name}/.wp-cli/config.yml`  ]
+            },
+            "tests-cli": {
+                build: {
+                    context: '.',
+                    dockerfile: 'Tests-CLI.Dockerfile'
+                },
+                volumes: [ path.join(workDirectoryPath, 'config.yml')  + `:/home/${name}/.wp-cli/config.yml`]
+            },
+            wordpress: {
+                build: {
+                    context: '.',
+                    dockerfile: 'WordPress.Dockerfile'
+                }
+            },
+            "tests-wordpress": {
+                build: {
+                    context: '.',
+                    dockerfile: 'Tests-WordPress.Dockerfile'
+                }
             }
         }
       
@@ -87,40 +125,56 @@ const buildDockerComposeConfig = (workDirectoryPath) => {
 
     // Add extra volumes to WordPress instances.
     if( extraVolumes.length ){
-
         dockerConfig.services.wordpress = {
-            build: {
-                context: '.',
-                dockerfile: 'WordPress.Dockerfile'
-            },
-            volumes: extraVolumes,
+            ...dockerConfig.services.wordpress,
+            volumes: [
+                ...extraVolumes
+            ],
         };
         dockerConfig.services.cli = {
-            build: {
-                context: '.',
-                dockerfile: 'CLI.Dockerfile'
-            },
-            volumes: extraVolumes,
+            ...dockerConfig.services.cli,
+            volumes: [
+                ...dockerConfig.services.cli.volumes,
+                ...extraVolumes
+            ],
         };
         dockerConfig.services['tests-wordpress'] = {
-            build: {
-                context: '.',
-                dockerfile: 'Tests-WordPress.Dockerfile'
-            },
-            volumes: extraVolumes,
+            ...dockerConfig.services['tests-wordpress'],
+            volumes: [
+                ...extraVolumes
+            ],
         };
         dockerConfig.services['tests-cli'] = {
-            build: {
-                context: '.',
-                dockerfile: 'Tests-CLI.Dockerfile'
-            },
-            volumes: extraVolumes,
+            ...dockerConfig.services['tests-cli'],
+            volumes: [
+                ...dockerConfig.services['tests-cli'].volumes,
+                ...extraVolumes
+            ],
         };
+
     }
 
     return dockerConfig;
 }
 
+/**
+ * Generate config.yml
+ * 
+ * @param {string}  workDirectoryPath Path to the work directory located in ~/.wp-env.
+ * 
+ * @returns void
+ */
+async function generateCLIConfig(workDirectoryPath){
+    const yml = {
+        path: '/var/www/html',
+        apache_modules: ['mod_rewrite']
+    };
+
+    await writeFile(
+        path.join(workDirectoryPath, 'config.yml'),
+        yaml.dump(yml));
+}
+
 module.exports = {
     buildWPEnvConfig,
     buildDockerComposeConfig

package/lib/divi.js

@@ -8,7 +8,7 @@
  * Internal dependencies
  */
 const { runDockerCmds } = require('./docker');
-const { DIVI_OPTIONS, DIVI_BUILDER_OPTIONS, DIVI_UPDATE_OPTIONS } = require('./options');
+const { DIVI_OPTIONS } = require('./options');
 
 
 /**
@@ -66,23 +66,29 @@ async function configureDivi( environment, config, spinner ) {
 		diviBuilderOptions = diviBuilderOptions ? JSON.parse( diviBuilderOptions ) : {};
 		diviUpdateOptions = undefined !== diviUpdateOptions && diviUpdateOptions ? JSON.parse( diviUpdateOptions ) : {};
 
-		// iterate over config options.
-		Object.entries(config.env[ environment ].config).forEach(([k,v]) => {
-			// if the option is prefixed with ET_.
-			if ( `${k}`.startsWith('ET_') ){
-				
+		// iterate over mapped Divi option groups.
+		Object.entries(DIVI_OPTIONS).forEach(([group, options]) => {
+			// iterate over each group options.
+			Object.entries(options).forEach(([key, data]) => {
+
+				// if user config has a Divi option variable use that, otherwise use our default.
+				let option_value = undefined !== config.env[ environment ].config[key] ?
+					config.env[ environment ].config[key] : 
+					data.defaultValue;
+					
 				// is a valid Divi Option.
-				if( undefined !== DIVI_OPTIONS[k] ){
-					diviOptions[DIVI_OPTIONS[k].name] = v;
+				if( 'et_divi' === group ){
+					diviOptions[data.name] = option_value;
 				// is a valid Divi Builder Option.
-				}else if( undefined !== DIVI_BUILDER_OPTIONS[k] ){
-					diviBuilderOptions[DIVI_BUILDER_OPTIONS[k].name] = v;
+				}else if( 'et_bfb_settings' === group ){
+					diviBuilderOptions[data.name] = option_value;
 				// is a valid Divi Update Option.
-				}else if( undefined !== DIVI_UPDATE_OPTIONS[k] ){
-					diviUpdateOptions[DIVI_UPDATE_OPTIONS[k].name] = v;
+				}else if( 'et_automatic_updates_options' === group ){
+					diviUpdateOptions[data.name] = option_value;
 				}
-			}
-		});
+
+			})
+		})
 
 		// parse option object back to string.
 		diviOptions = JSON.stringify( diviOptions );

package/lib/options.js

@@ -189,73 +189,71 @@ const CAWEB_OPTIONS = {
 }
 
 const DIVI_OPTIONS = {
-	ET_DYNAMIC_MODULE: {
-		name: 'divi_dynamic_module_framework',
-		defaultValue: 'on',
-		label: 'Dynamic Module Framework'
+	'et_divi': {
+		ET_DYNAMIC_MODULE: {
+			name: 'divi_dynamic_module_framework',
+			defaultValue: 'on',
+			label: 'Dynamic Module Framework'
+		},
+		ET_DYNAMIC_CSS: {
+			name: 'divi_dynamic_css',
+			defaultValue: 'on',
+			label: 'Dynamic CSS'
+		},
+		ET_CRITICAL_CSS: {
+			name: 'divi_critical_css',
+			defaultValue: 'on',
+			label: 'Critical CSS'
+		},
+		ET_DYNAMIC_JS: {
+			name: 'divi_dynamic_js_libraries',
+			defaultValue: 'on',
+			label: 'Dynamic JavaScript Libraries'
+		},
+		ET_CLASSIC_EDITOR: {
+			name: 'et_enable_classic_editor',
+			defaultValue: 'on',
+			label: 'Enable Classic Editor'
+		},
+		ET_STATIC_CSS_GENERATION: {
+			name: 'et_pb_static_css_file',
+			defaultValue: 'on',
+			label: 'Static CSS File Generation'
+		},
+		ET_PRODUCT_TOUR: {
+			name: 'et_pb_product_tour_global',
+			defaultValue: 'off',
+			label: 'Product Tour'
+		}
 	},
-	ET_DYNAMIC_CSS: {
-		name: 'divi_dynamic_css',
-		defaultValue: 'on',
-		label: 'Dynamic CSS'
+	'et_bfb_settings': {
+			ET_NEW_BUILDER_EXPERIENCE: {
+				name: 'enable_bfb',
+				defaultValue: 'off',
+				label: 'Enable The Latest Divi Builder Experience'
+			},
+			ET_OUTPUT_STYLES_INLINE: {
+				name: 'et_pb_css_in_footer',
+				defaultValue: 'off',
+				label: 'Output Styles Inline'
+			}
 	},
-	ET_CRITICAL_CSS: {
-		name: 'divi_critical_css',
-		defaultValue: 'on',
-		label: 'Critical CSS'
-	},
-	ET_DYNAMIC_JS: {
-		name: 'divi_dynamic_js_libraries',
-		defaultValue: 'on',
-		label: 'Dynamic JavaScript Libraries'
-	},
-	ET_CLASSIC_EDITOR: {
-		name: 'et_enable_classic_editor',
-		defaultValue: 'on',
-		label: 'Enable Classic Editor'
-	},
-	ET_STATIC_CSS_GENERATION: {
-		name: 'et_pb_static_css_file',
-		defaultValue: 'on',
-		label: 'Static CSS File Generation'
-	},
-	ET_PRODUCT_TOUR: {
-		name: 'et_pb_product_tour_global',
-		defaultValue: 'off',
-		label: 'Product Tour'
-	}
-}
-
-const DIVI_BUILDER_OPTIONS = {
-	ET_NEW_BUILDER_EXPERIENCE: {
-		name: 'enable_bfb',
-		defaultValue: 'off',
-		label: 'Enable The Latest Divi Builder Experience'
-	},
-	ET_OUTPUT_STYLES_INLINE: {
-		name: 'et_pb_css_in_footer',
-		defaultValue: 'off',
-		label: 'Output Styles Inline'
+	'et_automatic_updates_options':  {
+		ET_USERNAME: {
+			name: 'username',
+			defaultValue: '',
+			label: 'Username'
+		},
+		ET_API_KEY: {
+			name: 'api_key',
+			defaultValue: '',
+			label: 'API Key'
+		}
+	
 	}
 }
 
-const DIVI_UPDATE_OPTIONS = {
-	ET_USERNAME: {
-		name: 'username',
-		defaultValue: '',
-		label: 'Username'
-	},
-	ET_API_KEY: {
-		name: 'api_key',
-		defaultValue: '',
-		label: 'API Key'
-	}
-
-}
-
 module.exports = {
     CAWEB_OPTIONS,
-	DIVI_OPTIONS,
-	DIVI_BUILDER_OPTIONS,
-	DIVI_UPDATE_OPTIONS
+	DIVI_OPTIONS
 }

package/lib/wordpress.js

@@ -1,6 +1,8 @@
 'use strict';
 const { writeFile } = require('fs-extra');
 const path = require( 'path' );
+const { execSync } = require( 'child_process' );
+
 /**
  * External dependencies
  */
@@ -113,8 +115,43 @@ async function generateHTAccess(environment, workDirectoryPath, subdomain){
 	await writeFile(path.join(workDirectoryPath, folder, '.htaccess'), htaccess);
 
 }
+/**
+ * Configures WordPress for the given environment by installing WordPress,
+ * activating all plugins, and activating the first theme. These steps are
+ * performed sequentially so as to not overload the WordPress instance.
+ *
+ * @param {WPEnvironment} environment The environment to configure. Either 'development' or 'tests'.
+ * @param {WPConfig}      config      The wp-env config object.
+ * @param {Object}        spinner     A CLI spinner which indicates progress.
+ * @param {boolean}   	  multisite   True if converting to multisite.
+ * @param {boolean} 	  subdomain   True if converting to multisite subdomain.
+ */
+async function configureWordPress(environment, config, spinner, multisite, subdomain){
+	const { workDirectoryPath} = config;
+	const {
+		WP_PERMALINK
+	} = config.env[ environment ].config
+
+
+	// Convert to multisite if flag was passed.
+	if( multisite ){
+		spinner.text = 'Converting to multisite ' + ( subdomain ? 'subdomain' : 'subdirectory') + '...'
+		
+		await convertToMultisite( environment, config, subdomain )
+	}
+
+	// rewrite and flush permalink structure.
+	await runDockerCmds(
+		environment,
+		[
+			`wp rewrite structure ${WP_PERMALINK} --hard`
+		],
+		config
+	);
+}
 
 module.exports = {
+	configureWordPress,
 	isMultisite,
 	convertToMultisite,
 	generateHTAccess

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caweb/cli",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "CAWebPublishing Command Line Interface.",
   "main": "lib/env.js",
   "files": [
@@ -16,10 +16,8 @@
   },
   "scripts": {
     "caweb": "caweb",
-    "test": "echo \"Error: run tests from root\" && exit 0",
-    "prelocaltest": "npm uninstall @caweb/cli",
-    "localtest": "npm pack && npm i caweb-cli-%npm_package_version%.tgz",
-    "postlocaltest": "del caweb-cli-%npm_package_version%.tgz"
+    "local": "npm pack && npm i caweb-cli-%npm_package_version%.tgz",
+    "test": "echo \"Error: run tests from root\" && exit 0"
   },
   "repository": {
     "type": "git",
@@ -39,12 +37,12 @@
   },
   "homepage": "https://github.com/CAWebPublishing/caweb-cli#readme",
   "dependencies": {
-    "@wordpress/env": "^8.11.0",
+    "@wordpress/env": "^9.0.0",
     "chalk": "^4.0.0",
     "fs-extra": "^11.1.1"
   },
   "config": {
-    "WP_VER": "6.3.2",
+    "WP_VER": "6.4.2",
     "PHP_VER": "8.1",
     "DEFAULTS": {
       "WP_DEFAULT_THEME": "CAWeb",
@@ -58,16 +56,7 @@
       "ADMIN_COOKIE_PATH": "/",
       "COOKIE_DOMAIN": "",
       "COOKIEPATH": "",
-      "SITECOOKIEPATH": "",
-      "ET_DYNAMIC_MODULE": "on",
-      "ET_DYNAMIC_CSS": "on",
-      "ET_CRITICAL_CSS": "on",
-      "ET_DYNAMIC_JS": "on",
-      "ET_STATIC_CSS_GENERATION": "on",
-      "ET_OUTPUT_STYLES_INLINE": "off",
-      "ET_PRODUCT_TOUR": "off",
-      "ET_NEW_BUILDER_EXPERIENCE": "off",
-      "ET_CLASSIC_EDITOR": "on"
+      "SITECOOKIEPATH": ""
     }
   }
 }