add task stub for ldaptasks.tasks.set_ldap_user_password

docs/changelog.rst

@@ -1,6 +1,7 @@
 Changelog
 =========
 
+* :feature:`-` add new task stub to set an ldap user's password
 * :support:`-` refactor osusers.tasks, split into fileservertasks.tasks and
   ldaptasks.tasks
 * :feature:`-` show hosting package information on user dashboard

gnuviechadmin/ldaptasks/tasks.py

@@ -51,6 +51,20 @@ def create_ldap_user(username, uid, gid, gecos, homedir, shell, password):
     """
 
 
+@shared_task
+def set_ldap_user_password(self, username, password):
+    """
+    This task sets the password of an existing :py:class:`LDAP user
+    <ldapentities.models.LdapUser>`.
+
+    :param str username: the user name
+    :param str password: teh clear text password
+    :return: :py:const:`True` if the password has been set, :py:const:`False`
+        if the user does not exist.
+
+    """
+
+
 @shared_task
 def add_ldap_user_to_group(username, groupname):
     """