Adds new get and exists subcommands to the sidebar command

features/sidebar.feature

@@ -1,28 +1,61 @@
 Feature: Manage WordPress sidebars
-
   Scenario: List available sidebars
     Given a WP install
-
-    When I try `wp theme delete twentytwelve --force`
-    And I run `wp theme install twentytwelve --activate`
-    Then STDOUT should not be empty
-
+    When I run `wp theme install twentytwelve`
+    And I run `wp theme activate twentytwelve`
+    Then the return code should be 0
     When I run `wp sidebar list --fields=name,id`
     Then STDOUT should be a table containing rows:
       | name                          | id                  |
       | Main Sidebar                  | sidebar-1           |
       | First Front Page Widget Area  | sidebar-2           |
       | Second Front Page Widget Area | sidebar-3           |
       | Inactive Widgets              | wp_inactive_widgets |
-
     When I run `wp sidebar list --format=ids`
     Then STDOUT should be:
       """
       sidebar-1 sidebar-2 sidebar-3 wp_inactive_widgets
       """
-
     When I run `wp sidebar list --format=count`
     Then STDOUT should be:
       """
       4
       """
+
+  Scenario: Get sidebar details
+    Given a WP install
+    When I run `wp theme install twentytwelve`
+    And I run `wp theme activate twentytwelve`
+    Then the return code should be 0
+    When I run `wp sidebar get sidebar-1`
+    Then STDOUT should contain:
+      """
+      sidebar-1
+      """
+
+  Scenario: Sidebar exists command returns success
+    Given a WP install
+    When I run `wp theme install twentytwelve`
+    And I run `wp theme activate twentytwelve`
+    Then the return code should be 0
+    When I run `wp sidebar exists sidebar-1`
+    Then the return code should be 0
+
+  Scenario: Sidebar exists command returns failure
+    Given a WP install
+    When I run `wp theme install twentytwelve`
+    And I run `wp theme activate twentytwelve`
+    Then the return code should be 0
+    When I try `wp sidebar exists does-not-exist`
+    Then the return code should be 1
+
+  Scenario: Get non-existing sidebar returns error
+    Given a WP install
+    When I run `wp theme install twentytwelve`
+    And I run `wp theme activate twentytwelve`
+    Then the return code should be 0
+    When I try `wp sidebar get does-not-exist`
+    Then STDERR should contain:
+      """
+      does not exist
+      """

src/Sidebar_Command.php

@@ -84,4 +84,74 @@ public function list_( $args, $assoc_args ) {
 		$formatter = new Formatter( $assoc_args, $this->fields );
 		$formatter->display_items( $sidebars );
 	}
+
+	/**
+	 * Get details about a specific sidebar.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <id>
+	 * : The sidebar ID.
+	 *
+	 * [--fields=<fields>]
+	 * : Limit the output to specific object fields.
+	 *
+	 * [--format=<format>]
+	 * : Render output in a particular format.
+	 * ---
+	 * default: table
+	 * options:
+	 *   - table
+	 *   - json
+	 *   - yaml
+	 * ---
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     $ wp sidebar get sidebar-1
+	 *     $ wp sidebar get wp_inactive_widgets --format=json
+	 *
+	 * @when after_wp_load
+	 */
+	public function get( $args, $assoc_args ) {
+		global $wp_registered_sidebars;
+
+		Utils\wp_register_unused_sidebar();
+
+		$id = $args[0];
+
+		if ( ! isset( $wp_registered_sidebars[ $id ] ) ) {
+			WP_CLI::error( "Sidebar '{$id}' does not exist." );
+		}
+
+		$formatter = new Formatter( $assoc_args, $this->fields );
+		$formatter->display_item( $wp_registered_sidebars[ $id ] );
+	}
+
+	/**
+	 * Check if a sidebar exists.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <id>
+	 * : The sidebar ID.
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     $ wp sidebar exists sidebar-1
+	 *     $ wp sidebar exists wp_inactive_widgets && echo "exists"
+	 *
+	 * @when after_wp_load
+	 */
+	public function exists( $args ) {
+		global $wp_registered_sidebars;
+
+		Utils\wp_register_unused_sidebar();
+
+		if ( isset( $wp_registered_sidebars[ $args[0] ] ) ) {
+			WP_CLI::halt( 0 );
+		}
+
+		WP_CLI::halt( 1 );
+	}
 }