ENH: allow setting the REALM of a user in admin tools for password changes

src/caosdb/utils/caosdb_admin.py

@@ -42,6 +42,13 @@ __updated__ = '2018-12-11'
 
 
 def do_update_role(args):
+    """
+    Update the description of a role.
+
+    Allowed keyword arguments:
+    role_name: Name of the role to update
+    role_description: New description of the role
+    """
     admin._update_role(name=args.role_name, description=args.role_description)
 
 
@@ -137,7 +144,7 @@ def do_deactivate_user(args):
 
 def do_set_user_password(args):
     password = _promt_for_pw()
-    admin._update_user(name=args.user_name, password=password)
+    admin._update_user(name=args.user_name, password=password, realm=args.realm)
 
 
 def do_add_user_roles(args):
@@ -337,6 +344,12 @@ USAGE
         metavar='USERNAME',
         dest="user_name",
         help="The name of the user who's password is to be set.")
+    subparser.add_argument(
+        metavar='REALM',
+        dest="realm",
+        nargs="?",
+        default=None,
+        help="The realm of the user who's password is to be set.")
 
     subparser = subparsers.add_parser(
         "set_user_entity",