add pluck command to cache

Author: petitphp

features/cache.feature

@@ -210,3 +210,35 @@ Feature: Managed the WordPress object cache
 
     When I run `wp cache supports set_multiple`
     Then the return code should be 0
+
+  Scenario: Nested values can be retrieved at any depth.
+    Given a WP install
+    And a wp-content/mu-plugins/test-harness.php file:
+      """
+      <?php
+      $set_foo = function(){
+        wp_cache_set( 'my_key', ['foo' => 'bar'] );
+        wp_cache_set( 'my_key_2', ['foo' => ['bar' => 'baz']] );
+        wp_cache_set( 'my_key_custom', ['foo_custom' => ['bar_custom' => 'baz_custom']], 'my_custom_group' );
+      };
+
+      WP_CLI::add_hook( 'before_invoke:cache pluck', $set_foo );
+      """
+
+    When I try `wp cache pluck my_key foo`
+    Then STDOUT should be:
+      """
+      bar
+      """
+
+    When I try `wp cache pluck my_key_2 foo bar`
+    Then STDOUT should be:
+      """
+      baz
+      """
+
+    When I try `wp cache pluck my_key_custom foo_custom bar_custom --group=my_custom_group`
+    Then STDOUT should be:
+      """
+      baz_custom
+      """

src/Cache_Command.php

@@ -1,5 +1,8 @@
 <?php
 
+use WP_CLI\Cache\RecursiveDataStructureTraverser;
+use WP_CLI\Utils;
+
 /**
  * Adds, removes, fetches, and flushes the WP Object Cache object.
  *
@@ -407,4 +410,58 @@ public function flush_group( $args, $assoc_args ) {
 		WP_CLI::success( "Cache group '$group' was flushed." );
 	}
 
+	/**
+	 * Get a nested value from the cache.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <key>
+	 * : Cache key.
+	 *
+	 * <key-path>...
+	 * : The name(s) of the keys within the value to locate the value to pluck.
+	 *
+	 * [--group=<group>]
+	 * : Method for grouping data within the cache which allows the same key to be used across groups.
+	 * ---
+	 * default: default
+	 * ---
+	 *
+	 * [--format=<format>]
+	 * : The output format of the value.
+	 * ---
+	 * default: plaintext
+	 * options:
+	 *   - plaintext
+	 *   - json
+	 *   - yaml
+	 * ---
+	 */
+	public function pluck( $args, $assoc_args ) {
+		list($key) = $args;
+		$group = Utils\get_flag_value($assoc_args, 'group');
+
+		$value = wp_cache_get( $key, $group );
+
+		if ( false === $value ) {
+			WP_CLI::halt( 1 );
+		}
+
+		$key_path = array_map( function( $key ) {
+			if ( is_numeric( $key ) && ( $key === (string) intval( $key ) ) ) {
+				return (int) $key;
+			}
+			return $key;
+		}, array_slice( $args, 1 ) );
+
+		$traverser = new RecursiveDataStructureTraverser( $value );
+
+		try {
+			$value = $traverser->get( $key_path );
+		} catch ( \Exception $e ) {
+			die( 1 );
+		}
+
+		WP_CLI::print_value( $value, $assoc_args );
+	}
 }