From 35eceb3307fdd0f1f4566ee05cebdb648c25841f Mon Sep 17 00:00:00 2001
From: Jan Dittberner <jan@dittberner.info>
Date: Mon, 19 Jan 2015 22:43:29 +0100
Subject: [PATCH] add task stub for ldaptasks.tasks.set_ldap_user_password

---
 docs/changelog.rst               |  1 +
 gnuviechadmin/ldaptasks/tasks.py | 14 ++++++++++++++
 2 files changed, 15 insertions(+)

diff --git a/docs/changelog.rst b/docs/changelog.rst
index 1c90633..abb13bb 100644
--- a/docs/changelog.rst
+++ b/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
diff --git a/gnuviechadmin/ldaptasks/tasks.py b/gnuviechadmin/ldaptasks/tasks.py
index 3a2ef31..d7fed5c 100644
--- a/gnuviechadmin/ldaptasks/tasks.py
+++ b/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):
     """