Add wp user check-password to readme

Author: swissspidy

README.md

@@ -6680,6 +6680,39 @@ wp user application-password update <user> <uuid> [--<field>=<value>]
 
 
 
+### wp user check-password
+
+Checks if a user's password is valid or not.
+
+~~~
+wp user check-password <user> <user_pass> [--escape-chars]
+~~~
+
+**OPTIONS**
+
+	<user>
+		The user login, user email or user ID of the user to check credentials for.
+
+	<user_pass>
+		A string that contains the plain text password for the user.
+
+	[--escape-chars]
+		Escape password with `wp_slash()` to mimic the same behavior as `wp-login.php`.
+
+**EXAMPLES**
+
+    # Check whether given credentials are valid; exit status 0 if valid, otherwise 1
+    $ wp user check-password admin adminpass
+    $ echo $?
+    1
+
+    # Bash script for checking whether given credentials are valid or not
+    if ! $(wp user check-password admin adminpass); then
+     notify-send "Invalid Credentials";
+    fi
+
+
+
 ### wp user create
 
 Creates a new user.

composer.json

@@ -202,6 +202,7 @@
             "user application-password list",
             "user application-password record-usage",
             "user application-password update",
+            "user check-password",
             "user create",
             "user delete",
             "user exists",