wp-studio 1.7.8-beta2 → 1.7.8-beta3

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/AGENTS.md

@@ -1,121 +0,0 @@
-# Instructions
-
-This package is part of WP-CLI, the official command line interface for WordPress. For a detailed explanation of the project structure and development workflow, please refer to the main @README.md file.
-
-## Best Practices for Code Contributions
-
-When contributing to this package, please adhere to the following guidelines:
-
-* **Follow Existing Conventions:** Before writing any code, analyze the existing codebase in this package to understand the coding style, naming conventions, and architectural patterns.
-* **Focus on the Package's Scope:** All changes should be relevant to the functionality of the package.
-* **Write Tests:** All new features and bug fixes must be accompanied by acceptance tests using Behat. You can find the existing tests in the `features/` directory. There may be PHPUnit unit tests as well in the `tests/` directory.
-* **Update Documentation:** If your changes affect the user-facing functionality, please update the relevant inline code documentation.
-
-### Building and running
-
-Before submitting any changes, it is crucial to validate them by running the full suite of static code analysis and tests. To run the full suite of checks, execute the following command: `composer test`.
-
-This single command ensures that your changes meet all the quality gates of the project. While you can run the individual steps separately, it is highly recommended to use this single command to ensure a comprehensive validation.
-
-### Useful Composer Commands
-
-The project uses Composer to manage dependencies and run scripts. The following commands are available:
-
-* `composer install`: Install dependencies.
-* `composer test`: Run the full test suite, including linting, code style checks, static analysis, and unit/behavior tests.
-* `composer lint`: Check for syntax errors.
-* `composer phpcs`: Check for code style violations.
-* `composer phpcbf`: Automatically fix code style violations.
-* `composer phpstan`: Run static analysis.
-* `composer phpunit`: Run unit tests.
-* `composer behat`: Run behavior-driven tests.
-
-### Coding Style
-
-The project follows the `WP_CLI_CS` coding standard, which is enforced by PHP_CodeSniffer. The configuration can be found in `phpcs.xml.dist`. Before submitting any code, please run `composer phpcs` to check for violations and `composer phpcbf` to automatically fix them.
-
-## Documentation
-
-The `README.md` file might be generated dynamically from the project's codebase using `wp scaffold package-readme` ([doc](https://github.com/wp-cli/scaffold-package-command#wp-scaffold-package-readme)). In that case, changes need to be made against the corresponding part of the codebase.
-
-### Inline Documentation
-
-Only write high-value comments if at all. Avoid talking to the user through comments.
-
-## Testing
-
-The project has a comprehensive test suite that includes unit tests, behavior-driven tests, and static analysis.
-
-* **Unit tests** are written with PHPUnit and can be found in the `tests/` directory. The configuration is in `phpunit.xml.dist`.
-* **Behavior-driven tests** are written with Behat and can be found in the `features/` directory. The configuration is in `behat.yml`.
-* **Static analysis** is performed with PHPStan.
-
-All tests are run on GitHub Actions for every pull request.
-
-When writing tests, aim to follow existing patterns. Key conventions include:
-
-* When adding tests, first examine existing tests to understand and conform to established conventions.
-* For unit tests, extend the base `WP_CLI\Tests\TestCase` test class.
-* For Behat tests, only WP-CLI commands installed in `composer.json` can be run.
-
-### Behat Steps
-
-WP-CLI makes use of a Behat-based testing framework and provides a set of custom step definitions to write feature tests.
-
-> **Note:** If you are expecting an error output in a test, you need to use `When I try ...` instead of `When I run ...` .
-
-#### Given
-
-* `Given an empty directory` - Creates an empty directory.
-* `Given /^an? (empty|non-existent) ([^\s]+) directory$/` - Creates or deletes a specific directory.
-* `Given an empty cache` - Clears the WP-CLI cache directory.
-* `Given /^an? ([^\s]+) (file|cache file):$/` - Creates a file with the given contents.
-* `Given /^"([^"]+)" replaced with "([^"]+)" in the ([^\s]+) file$/` - Search and replace a string in a file using regex.
-* `Given /^that HTTP requests to (.*?) will respond with:$/` - Mock HTTP requests to a given URL.
-* `Given WP files` - Download WordPress files without installing.
-* `Given wp-config.php` - Create a wp-config.php file using `wp config create`.
-* `Given a database` - Creates an empty database.
-* `Given a WP install(ation)` - Installs WordPress.
-* `Given a WP install(ation) in :subdir` - Installs WordPress in a given directory.
-* `Given a WP install(ation) with Composer` - Installs WordPress with Composer.
-* `Given a WP install(ation) with Composer and a custom vendor directory :vendor_directory` - Installs WordPress with Composer and a custom vendor directory.
-* `Given /^a WP multisite (subdirectory|subdomain)?\s?(install|installation)$/` - Installs WordPress Multisite.
-* `Given these installed and active plugins:` - Installs and activates one or more plugins.
-* `Given a custom wp-content directory` - Configure a custom `wp-content` directory.
-* `Given download:` - Download multiple files into the given destinations.
-* `Given /^save (STDOUT|STDERR) ([\'].+[^\'])?\s?as \{(\w+)\}$/` - Store STDOUT or STDERR contents in a variable.
-* `Given /^a new Phar with (?:the same version|version "([^"]+)")$/` - Build a new WP-CLI Phar file with a given version.
-* `Given /^a downloaded Phar with (?:the same version|version "([^"]+)")$/` - Download a specific WP-CLI Phar version from GitHub.
-* `Given /^save the (.+) file ([\'].+[^\'])? as \{(\w+)\}$/` - Stores the contents of the given file in a variable.
-* `Given a misconfigured WP_CONTENT_DIR constant directory` - Modify wp-config.php to set `WP_CONTENT_DIR` to an empty string.
-* `Given a dependency on current wp-cli` - Add `wp-cli/wp-cli` as a Composer dependency.
-* `Given a PHP built-in web server` - Start a PHP built-in web server in the current directory.
-* `Given a PHP built-in web server to serve :subdir` - Start a PHP built-in web server in the given subdirectory.
-
-#### When
-
-* ``When /^I launch in the background `([^`]+)`$/`` - Launch a given command in the background.
-* ``When /^I (run|try) `([^`]+)`$/`` - Run or try a given command.
-* ``When /^I (run|try) `([^`]+)` from '([^\s]+)'$/`` - Run or try a given command in a subdirectory.
-* `When /^I (run|try) the previous command again$/` - Run or try the previous command again.
-
-#### Then
-
-* `Then /^the return code should( not)? be (\d+)$/` - Expect a specific exit code of the previous command.
-* `Then /^(STDOUT|STDERR) should( strictly)? (be|contain|not contain):$/` - Check the contents of STDOUT or STDERR.
-* `Then /^(STDOUT|STDERR) should be a number$/` - Expect STDOUT or STDERR to be a numeric value.
-* `Then /^(STDOUT|STDERR) should not be a number$/` - Expect STDOUT or STDERR to not be a numeric value.
-* `Then /^STDOUT should be a table containing rows:$/` - Expect STDOUT to be a table containing the given rows.
-* `Then /^STDOUT should end with a table containing rows:$/` - Expect STDOUT to end with a table containing the given rows.
-* `Then /^STDOUT should be JSON containing:$/` - Expect valid JSON output in STDOUT.
-* `Then /^STDOUT should be a JSON array containing:$/` - Expect valid JSON array output in STDOUT.
-* `Then /^STDOUT should be CSV containing:$/` - Expect STDOUT to be CSV containing certain values.
-* `Then /^STDOUT should be YAML containing:$/` - Expect STDOUT to be YAML containing certain content.
-* `Then /^(STDOUT|STDERR) should be empty$/` - Expect STDOUT or STDERR to be empty.
-* `Then /^(STDOUT|STDERR) should not be empty$/` - Expect STDOUT or STDERR not to be empty.
-* `Then /^(STDOUT|STDERR) should be a version string (<|<=|>|>=|==|=|<>) ([+\w.{}-]+)$/` - Expect STDOUT or STDERR to be a version string comparing to the given version.
-* `Then /^the (.+) (file|directory) should( strictly)? (exist|not exist|be:|contain:|not contain):$/` - Expect a certain file or directory to (not) exist or (not) contain certain contents.
-* `Then /^the contents of the (.+) file should( not)? match (((\/.*\/)|(#.#))([a-z]+)?)$/` - Match file contents against a regex.
-* `Then /^(STDOUT|STDERR) should( not)? match (((\/.*\/)|(#.#))([a-z]+)?)$/` - Match STDOUT or STDERR against a regex.
-* `Then /^an email should (be sent|not be sent)$/` - Expect an email to be sent (or not).
-* `Then the HTTP status code should be :code` - Expect the HTTP status code for visiting `http://localhost:8080`.

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/bundle/rmccue/requests/scripts/proxy/proxy.py

@@ -1,5 +0,0 @@
-def request(flow):
-	flow.request.headers["x-requests-proxy"] = "http"
-
-def response(flow):
-	flow.response.headers[b"x-requests-proxied"] = "http"

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/bundle/rmccue/requests/scripts/proxy/start.sh

@@ -1,19 +0,0 @@
-#!/usr/bin/env bash
-
-PROXYDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-PORT=${PORT:-9000}
-
-PROXYBIN=${PROXYBIN:-"$(which mitmdump)"}
-ARGS="-s '$PROXYDIR/proxy.py' -p $PORT"
-if [[ ! -z "$AUTH" ]]; then
-	ARGS="$ARGS --proxyauth $AUTH"
-fi
-PIDFILE="$PROXYDIR/proxy-$PORT.pid"
-
-set -x
-
-start-stop-daemon --verbose --start --background --pidfile $PIDFILE --make-pidfile --exec $PROXYBIN -- $ARGS
-
-ps -p $(cat $PIDFILE) u
-sleep 2
-ps -p $(cat $PIDFILE) u

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/bundle/rmccue/requests/scripts/proxy/stop.sh

@@ -1,10 +0,0 @@
-#!/usr/bin/env bash
-
-PROXYDIR="$PWD/$(dirname $0)"
-PORT=${PORT:-9000}
-
-PIDFILE="$PROXYDIR/proxy-$PORT.pid"
-
-set -x
-
-start-stop-daemon --verbose --stop --pidfile $PIDFILE --remove-pidfile

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Path.php

@@ -1,260 +0,0 @@
-<?php
-
-namespace WP_CLI;
-
-/**
- * Path manipulation helper class.
- *
- * Provides a centralized collection of path-related utility methods for
- * working with filesystem paths in a cross-platform manner.
- *
- * @package WP_CLI
- */
-class Path {
-
-	/**
-	 * File stream wrapper prefix for Phar archives.
-	 *
-	 * @var string
-	 */
-	const PHAR_STREAM_PREFIX = 'phar://';
-
-	/**
-	 * Regular expression pattern to match __FILE__ and __DIR__ constants.
-	 *
-	 * We try to be smart and only replace the constants when they are not within quotes.
-	 * Regular expressions being stateless, this is probably not 100% correct for edge cases.
-	 *
-	 * @see https://regex101.com/r/9hXp5d/11
-	 * @see https://stackoverflow.com/a/171499/933065
-	 *
-	 * @var string
-	 */
-	const FILE_DIR_PATTERN = '%(?>#.*?$)|(?>//.*?$)|(?>/\*.*?\*/)|(?>\'(?:(?=(\\\\?))\1.)*?\')|(?>"(?:(?=(\\\\?))\2.)*?")|(?<file>\b__FILE__\b)|(?<dir>\b__DIR__\b)%ms';
-
-	/**
-	 * Check if a certain path is within a Phar archive.
-	 *
-	 * If no path is provided, the function checks whether the current WP_CLI instance is
-	 * running from within a Phar archive.
-	 *
-	 * @param string|null $path Optional. Path to check. Defaults to null, which checks WP_CLI_ROOT.
-	 * @return bool Whether path is within a Phar archive.
-	 */
-	public static function inside_phar( $path = null ) {
-		if ( null === $path ) {
-			if ( ! defined( 'WP_CLI_ROOT' ) ) {
-				return false;
-			}
-
-			$path = WP_CLI_ROOT;
-		}
-
-		return 0 === stripos( $path, self::PHAR_STREAM_PREFIX );
-	}
-
-	/**
-	 * Determine whether a path is absolute.
-	 *
-	 * @param string $path
-	 * @return bool
-	 */
-	public static function is_absolute( $path ) {
-		// Empty path is not absolute.
-		if ( '' === $path ) {
-			return false;
-		}
-
-		// Windows drive letter + colon + slash or backslash.
-		if ( preg_match( '#^[A-Z]:[\\\\/]#i', $path ) ) {
-			return true;
-		}
-
-		// UNC path (\\Server\Share).
-		if ( preg_match( '#^\\\\\\\\[^\\\\/]+[\\\\/][^\\\\/]+#', $path ) ) {
-			return true;
-		}
-
-		// Unix root.
-		return isset( $path[0] ) && '/' === $path[0];
-	}
-
-	/**
-	 * Expand tilde (~) in path to home directory.
-	 *
-	 * Expands paths that start with ~ to the current user's home directory.
-	 * Only handles the current user's home directory (not ~username patterns).
-	 *
-	 * @param string $path Path that may contain a tilde.
-	 * @return string Path with tilde expanded to home directory, or unchanged if tilde not at start or followed by username.
-	 */
-	public static function expand_tilde( $path ) {
-		if ( isset( $path[0] ) && '~' === $path[0] ) {
-			$home = self::get_home_dir();
-			// Only expand if we can determine the home directory.
-			// Handle both "~" and "~/..." patterns (but not "~username").
-			if ( ! empty( $home ) && ( 1 === strlen( $path ) || '/' === $path[1] ) ) {
-				$path = $home . substr( $path, 1 );
-			}
-			// If followed by anything other than '/', or home is empty, leave it unchanged.
-		}
-
-		return $path;
-	}
-
-	/**
-	 * Get the home directory.
-	 *
-	 * @return string
-	 */
-	public static function get_home_dir() {
-		$home = getenv( 'HOME' );
-		if ( ! $home ) {
-			// In Windows $HOME may not be defined.
-			$home = getenv( 'HOMEDRIVE' ) . getenv( 'HOMEPATH' );
-		}
-
-		return rtrim( $home, '/\\' );
-	}
-
-	/**
-	 * Appends a trailing slash.
-	 *
-	 * @param string $value What to add the trailing slash to.
-	 * @return string String with trailing slash added.
-	 */
-	public static function trailingslashit( $value ) {
-		if ( ! is_string( $value ) ) {
-			return '/';
-		}
-
-		return rtrim( $value, '/\\' ) . '/';
-	}
-
-	/**
-	 * Check if a path is a PHP stream URL.
-	 *
-	 * @param string $path The resource path or URL.
-	 * @return bool True if the path is a PHP stream URL, false otherwise.
-	 */
-	public static function is_stream( $path ) {
-		$scheme_separator = strpos( $path, '://' );
-
-		if ( false === $scheme_separator ) {
-			return false;
-		}
-
-		$stream = strtolower( substr( $path, 0, $scheme_separator ) );
-
-		return in_array( $stream, stream_get_wrappers(), true );
-	}
-
-	/**
-	 * Normalize a filesystem path.
-	 *
-	 * On Windows systems, replaces backslashes with forward slashes
-	 * and forces upper-case drive letters.
-	 * Allows for two leading slashes for Windows network shares, but
-	 * ensures that all other duplicate slashes are reduced to a single one.
-	 * Ensures upper-case drive letters on Windows systems.
-	 * Allows for PHP file wrappers.
-	 *
-	 * @param string $path Path to normalize.
-	 * @return string Normalized path.
-	 */
-	public static function normalize( $path ) {
-		$wrapper = '';
-		if ( self::is_stream( $path ) ) {
-			list( $wrapper, $path ) = explode( '://', $path, 2 );
-			$wrapper               .= '://';
-		}
-		$path = str_replace( '\\', '/', $path );
-		$path = (string) preg_replace( '|(?<=.)/+|', '/', $path );
-		if ( ':' === substr( $path, 1, 1 ) ) {
-			$path = ucfirst( $path );
-		}
-		// Resolve single-dot path segments (e.g., /foo/./bar becomes /foo/bar).
-		$path = (string) preg_replace( '#/(?:\./)+#', '/', $path );
-		if ( '/.' === substr( $path, -2 ) ) {
-			$path = substr( $path, 0, -1 );
-		}
-		// Resolve leading ./ (e.g., ./foo/bar becomes foo/bar).
-		$path = (string) preg_replace( '#^(?:\./)+#', '', $path );
-		// Collapse any duplicate slashes introduced by dot-segment resolution.
-		$path = (string) preg_replace( '|(?<=.)/+|', '/', $path );
-		return $wrapper . $path;
-	}
-
-	/**
-	 * Get the file basename.
-	 *
-	 * @param string $path
-	 * @param string $suffix
-	 * @return string
-	 */
-	public static function basename( $path, $suffix = '' ) {
-		// phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.urlencode_urlencode -- Format required by wordpress.org API.
-		return urldecode( \basename( str_replace( [ '%2F', '%5C' ], '/', urlencode( $path ) ), $suffix ) );
-	}
-
-	/**
-	 * Get a Phar-safe version of a path.
-	 *
-	 * For paths inside a Phar, this strips the outer filesystem's location to
-	 * reduce the path to what it needs to be within the Phar archive.
-	 *
-	 * Use the __FILE__ or __DIR__ constants as a starting point.
-	 *
-	 * @param string $path An absolute path that might be within a Phar.
-	 * @return string A Phar-safe version of the path.
-	 */
-	public static function phar_safe( $path ) {
-		if ( ! self::inside_phar() ) {
-			return $path;
-		}
-
-		return str_replace(
-			self::PHAR_STREAM_PREFIX . rtrim( WP_CLI_PHAR_PATH, '/' ) . '/',
-			self::PHAR_STREAM_PREFIX,
-			$path
-		);
-	}
-
-	/**
-	 * Replace magic constants in some PHP source code.
-	 *
-	 * Replaces the __FILE__ and __DIR__ magic constants with the values they are
-	 * supposed to represent at runtime.
-	 *
-	 * @param string $source The PHP code to manipulate.
-	 * @param string $path The path to use instead of the magic constants.
-	 * @return string Adapted PHP code.
-	 */
-	public static function replace_path_consts( $source, $path ) {
-		// Solve issue with Windows allowing single quotes in account names.
-		$file = addslashes( $path );
-
-		if ( file_exists( $file ) ) {
-			$file = (string) realpath( $file );
-		}
-
-		$dir = dirname( $file );
-
-		// Replace __FILE__ and __DIR__ constants with value of $file or $dir.
-		return (string) preg_replace_callback(
-			self::FILE_DIR_PATTERN,
-			static function ( $matches ) use ( $file, $dir ) {
-				if ( ! empty( $matches['file'] ) ) {
-					return "'{$file}'";
-				}
-
-				if ( ! empty( $matches['dir'] ) ) {
-					return "'{$dir}'";
-				}
-
-				return $matches[0];
-			},
-			$source
-		);
-	}
-}