wp-cli · schlessera · May 29, 2018 · May 27, 2018 · May 27, 2018 · May 27, 2018
diff --git a/composer.json b/composer.json
@@ -63,7 +63,8 @@
             "theme path",
             "theme search",
             "theme status",
-            "theme update"
+            "theme update",
+            "theme mod list"
         ]
     }
 }
diff --git a/features/theme-mod-list.feature b/features/theme-mod-list.feature
@@ -0,0 +1,51 @@
+Feature: Manage WordPress theme mods list
+
+  Background:
+    Given a WP install
+    And I run `wp theme mod set key_a value_a`
+    And I run `wp theme mod set key_b value_b`
+
+  Scenario: Getting theme mods
+    When I run `wp theme mod list`
+    Then STDOUT should be a table containing rows:
+      | key  | value   |
+
+    When I run `wp theme mod list --field=key`
+    Then STDOUT should be:
+      """
+      key_a
+      key_b
+      """
+
+    When I run `wp theme mod list --field=value`
+    Then STDOUT should be:
+      """
+      value_a
+      value_b
+      """
+
+    When I run `wp theme mod list --format=json`
+    Then STDOUT should be:
+      """
+      [{"key":"key_a","value":"value_a"},{"key":"key_b","value":"value_b"}]
+      """
+
+    When I run `wp theme mod list --format=csv`
+    Then STDOUT should be:
+      """
+      key,value
+      key_a,value_a
+      key_b,value_b
+      """
+
+    When I run `wp theme mod list --format=yaml`
+    Then STDOUT should be:
+      """
+      ---
+      - 
+        key: key_a
+        value: value_a
+      - 
+        key: key_b
+        value: value_b
+      """
diff --git a/src/Theme_Mod_Command.php b/src/Theme_Mod_Command.php
@@ -121,6 +121,46 @@ public function get( $args = array(), $assoc_args = array() ) {
 
 	}
 
+	/**
+	 * Gets a list of theme mods.
+	 *
+	 * ## OPTIONS
+	 *
+	 * [--field=<field>]
+	 * : Returns the value of a single field.
+	 *
+	 * [--format=<format>]
+	 * : Render output in a particular format.
+	 * ---
+	 * default: table
+	 * options:
+	 *   - table
+	 *   - json
+	 *   - csv
+	 *   - yaml
+	 * ---
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     # Gets a list of theme mods.
+	 *     $ wp theme mod list
+	 *     +------------------+---------+
+	 *     | key              | value   |
+	 *     +------------------+---------+
+	 *     | background_color | dd3333  |
+	 *     | link_color       | #dd9933 |
+	 *     | main_text_color  | #8224e3 |
+	 *     +------------------+---------+
+	 *
+	 * @subcommand list
+	 */
+	public function list_( $args = array(), $assoc_args = array() ) {
+
+		$assoc_args['all'] = 1;
+
+		$this->get( $args, $assoc_args );
+	}
+
 	/**
 	 * Removes one or more theme mods.
 	 *