sdc-build-wp 4.1.0 → 4.1.2

package/vendor/wp-coding-standards/wpcs/WordPress/Helpers/MinimumWPVersionTrait.php

@@ -1,159 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Helpers;
-
-use PHPCSUtils\BackCompat\Helper;
-
-/**
- * Helper utilities for sniffs which take the minimum supported WP version of the
- * code under examination into account.
- *
- * Usage instructions:
- * - Add appropriate `use` statement(s) to the file/class which intends to use this functionality.
- * - Call the `MinimumWPVersionTrait::set_minimum_wp_version()` method in the `process()`/`process_token()`
- *   method.
- * - After that, the `MinimumWPVersionTrait::$minimum_wp_version` property can be freely used
- *   in the sniff.
- *
- * @since 3.0.0 The property and method in this trait were previously contained in the
- *              `WordPressCS\WordPress\Sniff` class and have been moved here.
- */
-trait MinimumWPVersionTrait {
-
-	/**
-	 * Minimum supported WordPress version.
-	 *
-	 * Currently used by the `WordPress.Security.PreparedSQLPlaceholders`,
-	 * `WordPress.WP.AlternativeFunctions`, `WordPress.WP.Capabilities`,
-	 * `WordPress.WP.DeprecatedClasses`, `WordPress.WP.DeprecatedFunctions`,
-	 * `WordPress.WP.DeprecatedParameter` and the `WordPress.WP.DeprecatedParameterValues` sniff.
-	 *
-	 * These sniffs will adapt their behaviour based on the minimum supported WP version
-	 * indicated.
-	 * By default, it is set to presume that a project will support the current
-	 * WP version and up to three releases before.
-	 *
-	 * This property allows changing the minimum supported WP version used by
-	 * these sniffs by setting a property in a custom phpcs.xml ruleset.
-	 * This property will need to be set for each sniff which uses it.
-	 *
-	 * Example usage:
-	 * <rule ref="WordPress.WP.DeprecatedClasses">
-	 *  <properties>
-	 *   <property name="minimum_wp_version" value="4.9"/>
-	 *  </properties>
-	 * </rule>
-	 *
-	 * Alternatively, the value can be passed in one go for all sniffs using it via
-	 * the command line or by setting a `<config>` value in a custom phpcs.xml ruleset.
-	 *
-	 * CL:      `phpcs --runtime-set minimum_wp_version 5.7`
-	 * Ruleset: `<config name="minimum_wp_version" value="6.0"/>`
-	 *
-	 * @since 0.14.0 Previously the individual sniffs each contained this property.
-	 * @since 3.0.0  - Moved from the Sniff class to this dedicated Trait.
-	 *               - The property has been renamed from `$minimum_supported_version` to `$minimum_wp_version`.
-	 *               - The CLI option has been renamed from `minimum_supported_wp_version` to `minimum_wp_version`.
-	 *
-	 * @var string WordPress version.
-	 */
-	public $minimum_wp_version;
-
-	/**
-	 * Default minimum supported WordPress version.
-	 *
-	 * By default, the minimum_wp_version presumes that a project will support the current
-	 * WP version and up to three releases before.
-	 *
-	 * {@internal This should be a constant, but constants in traits are not supported
-	 *            until PHP 8.2.}}
-	 *
-	 * @since 3.0.0
-	 *
-	 * @var string WordPress version.
-	 */
-	private $default_minimum_wp_version = '6.2';
-
-	/**
-	 * Overrule the minimum supported WordPress version with a command-line/config value.
-	 *
-	 * Handle setting the minimum supported WP version in one go for all sniffs which
-	 * expect it via the command line or via a `<config>` variable in a ruleset.
-	 * The config variable overrules the default `$minimum_wp_version` and/or a
-	 * `$minimum_wp_version` set for individual sniffs through the ruleset.
-	 *
-	 * @since 0.14.0
-	 * @since 3.0.0  - Moved from the Sniff class to this dedicated Trait.
-	 *               - Renamed from `get_wp_version_from_cl()` to `set_minimum_wp_version()`.
-	 *
-	 * @return void
-	 */
-	final protected function set_minimum_wp_version() {
-		$minimum_wp_version = '';
-
-		// Use a ruleset provided value if available.
-		if ( ! empty( $this->minimum_wp_version ) ) {
-			$minimum_wp_version = $this->minimum_wp_version;
-		}
-
-		// A CLI provided value overrules a ruleset provided value.
-		$cli_supported_version = Helper::getConfigData( 'minimum_wp_version' );
-		if ( ! empty( $cli_supported_version ) ) {
-			$minimum_wp_version = $cli_supported_version;
-		}
-
-		// If no valid value was provided, use the default.
-		if ( filter_var( $minimum_wp_version, \FILTER_VALIDATE_FLOAT ) === false ) {
-			$minimum_wp_version = $this->default_minimum_wp_version;
-		}
-
-		$this->minimum_wp_version = $minimum_wp_version;
-	}
-
-	/**
-	 * Compares two version numbers.
-	 *
-	 * @since 3.0.0
-	 *
-	 * @param string $version1 First version number.
-	 * @param string $version2 Second version number.
-	 * @param string $operator Comparison operator.
-	 *
-	 * @return bool
-	 */
-	final protected function wp_version_compare( $version1, $version2, $operator ) {
-		$version1 = $this->normalize_version_number( $version1 );
-		$version2 = $this->normalize_version_number( $version2 );
-
-		return version_compare( $version1, $version2, $operator );
-	}
-
-	/**
-	 * Normalize a version number.
-	 *
-	 * Ensures that a version number is comparable via the PHP version_compare() function
-	 * by making sure it complies with the minimum "PHP-standardized" version number requirements.
-	 *
-	 * Presumes the input is a numeric version number string. The behaviour with other input is undefined.
-	 *
-	 * @since 3.0.0
-	 *
-	 * @param string $version Version number.
-	 *
-	 * @return string
-	 */
-	private function normalize_version_number( $version ) {
-		if ( preg_match( '`^\d+\.\d+$`', $version ) ) {
-			$version .= '.0';
-		}
-
-		return $version;
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Helpers/PrintingFunctionsTrait.php

@@ -1,122 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Helpers;
-
-use WordPressCS\WordPress\Helpers\RulesetPropertyHelper;
-
-/**
- * Helper functions and function lists for checking whether a function prints output.
- *
- * Any sniff class which incorporates this trait will automatically support the
- * following `public` property which can be changed from within a custom ruleset:
- * - `customPrintingFunctions`.
- *
- * @since 3.0.0 The properties in this trait were previously contained partially in the
- *              `WordPressCS\WordPress\Sniff` class and partially in the `EscapeOutputSniff`
- *              class and have been moved here.
- */
-trait PrintingFunctionsTrait {
-
-	/**
-	 * Custom list of functions which print output incorporating the passed values.
-	 *
-	 * @since 0.4.0
-	 * @since 3.0.0 Moved from the EscapeOutput Sniff class to this trait.
-	 *
-	 * @var string[]
-	 */
-	public $customPrintingFunctions = array();
-
-	/**
-	 * Functions which print output incorporating the values passed to them.
-	 *
-	 * @since 0.5.0
-	 * @since 0.11.0 Changed from public static to protected non-static.
-	 * @since 3.0.0 - Moved from the Sniff class to this trait.
-	 *              - Visibility changed from protected to private.
-	 *
-	 * @var array<string, bool>
-	 */
-	private $printingFunctions = array(
-		'_deprecated_argument'    => true,
-		'_deprecated_constructor' => true,
-		'_deprecated_file'        => true,
-		'_deprecated_function'    => true,
-		'_deprecated_hook'        => true,
-		'_doing_it_wrong'         => true,
-		'_e'                      => true,
-		'_ex'                     => true,
-		'printf'                  => true,
-		'trigger_error'           => true,
-		'user_error'              => true,
-		'vprintf'                 => true,
-		'wp_die'                  => true,
-		'wp_dropdown_pages'       => true,
-	);
-
-	/**
-	 * Cache of previously added custom functions.
-	 *
-	 * Prevents having to do the same merges over and over again.
-	 *
-	 * @since 0.4.0
-	 * @since 0.11.0 - Changed from public static to protected non-static.
-	 *               - Changed the format from simple bool to array.
-	 * @since 3.0.0  - Moved from the EscapeOutput Sniff class to this trait.
-	 *               - Visibility changed from protected to private.
-	 *
-	 * @var string[]
-	 */
-	private $addedCustomPrintingFunctions = array();
-
-	/**
-	 * Combined list of WP/PHP native and custom printing functions.
-	 *
-	 * @since 3.0.0
-	 *
-	 * @var array<string, bool>
-	 */
-	private $allPrintingFunctions = array();
-
-	/**
-	 * Retrieve a list of all known printing functions.
-	 *
-	 * @since 3.0.0
-	 *
-	 * @return array<string, bool>
-	 */
-	final public function get_printing_functions() {
-		if ( array() === $this->allPrintingFunctions
-			|| $this->customPrintingFunctions !== $this->addedCustomPrintingFunctions
-		) {
-			$this->allPrintingFunctions = RulesetPropertyHelper::merge_custom_array(
-				$this->customPrintingFunctions,
-				$this->printingFunctions
-			);
-
-			$this->addedCustomPrintingFunctions = $this->customPrintingFunctions;
-		}
-
-		return $this->allPrintingFunctions;
-	}
-
-	/**
-	 * Check if a particular function is regarded as a printing function.
-	 *
-	 * @since 3.0.0
-	 *
-	 * @param string $functionName The name of the function to check.
-	 *
-	 * @return bool
-	 */
-	final public function is_printing_function( $functionName ) {
-		return isset( $this->get_printing_functions()[ strtolower( $functionName ) ] );
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Helpers/RulesetPropertyHelper.php

@@ -1,73 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Helpers;
-
-/**
- * Helper utilities for working with user provided property values.
- *
- * ---------------------------------------------------------------------------------------------
- * This class is only intended for internal use by WordPressCS and is not part of the public API.
- * This also means that it has no promise of backward compatibility. Use at your own risk.
- * ---------------------------------------------------------------------------------------------
- *
- * @internal
- *
- * @since 3.0.0 The method in this class was previously contained in the
- *              `WordPressCS\WordPress\Sniff` class and has been moved here.
- */
-final class RulesetPropertyHelper {
-
-	/**
-	 * Merge a pre-set array with a ruleset provided array.
-	 *
-	 * - By default flips custom lists to allow for using `isset()` instead
-	 *   of `in_array()`.
-	 * - When `$flip` is true:
-	 *   * Presumes the base array is in a `'value' => true` format.
-	 *   * Any custom items will be given the value `false` to be able to
-	 *     distinguish them from pre-set (base array) values.
-	 *   * Will filter previously added custom items out from the base array
-	 *     before merging/returning to allow for resetting to the base array.
-	 *
-	 * {@internal Function is static as it doesn't use any of the properties or others
-	 * methods anyway.}
-	 *
-	 * @since 0.11.0
-	 * @since 2.0.0  No longer supports custom array properties which were incorrectly
-	 *               passed as a string.
-	 * @since 3.0.0  Moved from the Sniff class to this class.
-	 *
-	 * @param array $custom Custom list as provided via a ruleset.
-	 * @param array $base   Optional. Base list. Defaults to an empty array.
-	 *                      Expects `value => true` format when `$flip` is true.
-	 * @param bool  $flip   Optional. Whether or not to flip the custom list.
-	 *                      Defaults to true.
-	 * @return array
-	 */
-	public static function merge_custom_array( $custom, array $base = array(), $flip = true ) {
-		if ( true === $flip ) {
-			$base = array_filter( $base );
-		}
-
-		if ( empty( $custom ) || ! \is_array( $custom ) ) {
-			return $base;
-		}
-
-		if ( true === $flip ) {
-			$custom = array_fill_keys( $custom, false );
-		}
-
-		if ( empty( $base ) ) {
-			return $custom;
-		}
-
-		return array_merge( $base, $custom );
-	}
-}