Provided flag to remove role forcefully

Author: BhargavBhandari90

features/user.feature

@@ -455,10 +455,16 @@ Feature: Manage WordPress users
     Then the return code should be 1
     And STDERR should be:
       """
-      Error: There is a role similar to 'contributor' capability. Use `wp user remove-role` instead.
+      Error: There is a role similar to 'contributor' capability. Use `wp user remove-cap {USER_ID} contributor --force` to remove capability.
       """
     And STDOUT should be empty
 
+    When I run `wp user remove-cap {USER_ID} contributor --force`
+    Then STDOUT should be:
+      """
+      Success: Removed 'contributor' cap for testuser2 ({USER_ID}).
+      """
+
   Scenario: Show password when creating a user
     Given a WP install
 

src/User_Command.php

@@ -861,6 +861,9 @@ public function add_cap( $args, $assoc_args ) {
 	 * <cap>
 	 * : The capability to be removed.
 	 *
+	 * [--force]
+	 * : Forcefully remove a capability.
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     $ wp user remove-cap 11 publish_newsletters
@@ -872,6 +875,9 @@ public function add_cap( $args, $assoc_args ) {
 	 *     $ wp user remove-cap 11 nonexistent_cap
 	 *     Error: No such 'nonexistent_cap' cap for supervisor (11).
 	 *
+	 *     $ wp user remove-cap 11 publish_newsletters --force
+	 *     Success: Removed 'publish_newsletters' cap for supervisor (11).
+	 *
 	 * @subcommand remove-cap
 	 */
 	public function remove_cap( $args, $assoc_args ) {
@@ -886,8 +892,8 @@ public function remove_cap( $args, $assoc_args ) {
 			}
 
 			$user_roles = $user->roles;
-			if ( ! empty( $user_roles ) && in_array( $cap, $user_roles, true ) ) {
-				WP_CLI::error( "There is a role similar to '{$cap}' capability. Use `wp user remove-role` instead." );
+			if ( ! empty( $user_roles ) && in_array( $cap, $user_roles, true ) && ! Utils\get_flag_value( $assoc_args, 'force' ) ) {
+				WP_CLI::error( "There is a role similar to '{$cap}' capability. Use `wp user remove-cap {$user->ID} {$cap} --force` to remove capability." );
 			}
 			$user->remove_cap( $cap );