feat: introduce exclude feature (WIP)

features/checksum-core.feature

@@ -228,3 +228,24 @@ Feature: Validate checksums for WordPress install
       Success: WordPress installation verifies against checksums.
       """
     And STDERR should be empty
+
+  Scenario: Verify core checksums with excluded files
+  Given a WP install
+  And "WordPress" replaced with "Wordpress" in the readme.html file
+  And a wp-includes/some-filename.php file:
+    """
+    sample content of some file
+    """
+  And a readme.html file:
+    """
+    # You really should read me
+    """
+
+  When I try `wp core verify-checksums --exclude='readme.html wp-includes/some-filename.php'`
+  Then STDERR should be empty
+  And STDOUT should be:
+    """
+    Success: WordPress installation verifies against checksums.
+    """
+  And the return code should be 0
+

src/Checksum_Core_Command.php

@@ -17,6 +17,13 @@ class Checksum_Core_Command extends Checksum_Base_Command {
 	 */
 	private $include_root = false;
 
+	/**
+	 * Files to exclude from the verification.
+	 *
+	 * @var array
+	 */
+	private $exclude_files = [];
+
 	/**
 	 * Verifies WordPress files against WordPress.org's checksums.
 	 *
@@ -44,6 +51,9 @@ class Checksum_Core_Command extends Checksum_Base_Command {
 	 * [--insecure]
 	 * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.
 	 *
+	 * [--exclude=<files>]
+	 * : Exclude specific files from the checksum verification. Provide a space-separated list of file paths.
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     # Verify checksums
@@ -64,6 +74,10 @@ class Checksum_Core_Command extends Checksum_Base_Command {
 	 *     Warning: File doesn't verify against checksum: readme.html
 	 *     Warning: File doesn't verify against checksum: wp-config-sample.php
 	 *     Error: WordPress installation doesn't verify against checksums.
+	 * 
+	 * 	   # Verify checksums
+	 *     $ wp core verify-checksums --exclude="readme.html"
+	 *     Success: WordPress installation verifies against checksums.
 	 *
 	 * @when before_wp_load
 	 */
@@ -83,6 +97,10 @@ public function __invoke( $args, $assoc_args ) {
 			$this->include_root = true;
 		}
 
+		if ( ! empty( $assoc_args['exclude'] ) ) {
+			$this->exclude_files = explode( ' ', $assoc_args['exclude'] );
+		}
+
 		if ( empty( $wp_version ) ) {
 			$details    = self::get_wp_details();
 			$wp_version = $details['wp_version'];
@@ -112,6 +130,10 @@ public function __invoke( $args, $assoc_args ) {
 				continue;
 			}
 
+			if ( in_array( $file, $this->exclude_files, true ) ) {
+				continue;
+			}
+
 			if ( ! file_exists( ABSPATH . $file ) ) {
 				WP_CLI::warning( "File doesn't exist: {$file}" );
 				$has_errors = true;
@@ -131,6 +153,9 @@ public function __invoke( $args, $assoc_args ) {
 
 		if ( ! empty( $additional_files ) ) {
 			foreach ( $additional_files as $additional_file ) {
+				if ( in_array( $additional_file, $this->exclude_files, true ) ) {
+					continue;
+				}
 				WP_CLI::warning( "File should not exist: {$additional_file}" );
 			}
 		}