From 0aaa5e0a4663ad8ead207171eb2cf0cf45a86f42 Mon Sep 17 00:00:00 2001
From: Pierre-Yves Chibon <pingou@pingoured.fr>
Date: Jun 08 2016 09:50:48 +0000
Subject: Add an API endpoint to assign issue to someone


---

diff --git a/pagure/api/issue.py b/pagure/api/issue.py
index 4430177..805f34c 100644
--- a/pagure/api/issue.py
+++ b/pagure/api/issue.py
@@ -633,3 +633,91 @@ def api_comment_issue(repo, issueid, username=None):
 
     jsonout = flask.jsonify(output)
     return jsonout
+
+
+@API.route('/<repo>/issue/<int:issueid>/assign', methods=['POST'])
+@API.route('/fork/<username>/<repo>/issue/<int:issueid>/assign', methods=['POST'])
+@api_login_required(acls=['issue_assign'])
+@api_method
+def api_assign_issue(repo, issueid, username=None):
+    """
+    Assign an issue
+    ---------------
+    Assign an issue to someone.
+
+    ::
+
+        POST /api/0/<repo>/issue/<issue id>/assign
+
+    ::
+
+        POST /api/0/fork/<username>/<repo>/issue/<issue id>/assign
+
+    Input
+    ^^^^^
+
+    +--------------+----------+---------------+---------------------------+
+    | Key          | Type     | Optionality   | Description               |
+    +==============+==========+===============+===========================+
+    | ``assignee`` | string   | Mandatory     | | The username of the user|
+    |              |          |               |   to assign the issue to. |
+    +--------------+----------+---------------+---------------------------+
+
+    Sample response
+    ^^^^^^^^^^^^^^^
+
+    ::
+
+        {
+          "message": "Issue assigned"
+        }
+
+    """
+    repo = pagure.lib.get_project(SESSION, repo, user=username)
+    output = {}
+
+    if repo is None:
+        raise pagure.exceptions.APIError(404, error_code=APIERROR.ENOPROJECT)
+
+    if not repo.settings.get('issue_tracker', True):
+        raise pagure.exceptions.APIError(
+            404, error_code=APIERROR.ETRACKERDISABLED)
+
+    if repo.fullname != flask.g.token.project.fullname:
+        raise pagure.exceptions.APIError(401, error_code=APIERROR.EINVALIDTOK)
+
+    issue = pagure.lib.search_issues(SESSION, repo, issueid=issueid)
+
+    if issue is None or issue.project != repo:
+        raise pagure.exceptions.APIError(404, error_code=APIERROR.ENOISSUE)
+
+    if issue.private and not is_repo_admin(repo) \
+            and (not api_authenticated() or
+                 not issue.user.user == flask.g.fas_user.username):
+        raise pagure.exceptions.APIError(
+            403, error_code=APIERROR.EISSUENOTALLOWED)
+
+    form = pagure.forms.AssigneIssueForm(csrf_enabled=False)
+    if form.validate_on_submit():
+        assignee = form.assignee.data
+        try:
+            # New comment
+            message = pagure.lib.add_issue_assignee(
+                SESSION,
+                issue=issue,
+                assignee=assignee,
+                user=flask.g.fas_user.username,
+                ticketfolder=APP.config['TICKETS_FOLDER'],
+            )
+            SESSION.commit()
+            output['message'] = message
+        except SQLAlchemyError as err:  # pragma: no cover
+            SESSION.rollback()
+            APP.logger.exception(err)
+            raise pagure.exceptions.APIError(400, error_code=APIERROR.EDBERROR)
+
+    else:
+        raise pagure.exceptions.APIError(400, error_code=APIERROR.EINVALIDREQ)
+
+    jsonout = flask.jsonify(output)
+    return jsonout
diff --git a/pagure/forms.py b/pagure/forms.py
index 2aae91c..63868bb 100644
--- a/pagure/forms.py
+++ b/pagure/forms.py
@@ -262,6 +262,13 @@ class AddUserForm(wtf.Form):
     )
 
 
+class AssigneIssueForm(wtf.Form):
+    ''' Form to asiggn an user to an issue. '''
+    assignee = wtforms.TextField(
+        'Assignee <span class="error">*</span>',
+        [wtforms.validators.Required()]
+    )
+
 class AddGroupForm(wtf.Form):
     ''' Form to add a group to a project. '''
     group = wtforms.TextField(