Add components support to JIRA

It's now possible to add "components" argument when creating/updating
JIRAs

read-the-docs/source/JIRA.rst

@@ -70,10 +70,11 @@ particular JIRA instance during ticket creation:
     duedate='2017-01-13'
     parent='KEY-XX'
     customfield_XXXXX='Custom field text'
+    components=['component1', 'component2']
 
 While creating a Sub task, parent ticket id is required, otherwise create()
 method fails with KeyError - "Parent field is required while creating a Sub
-Task"
+Task". Components are referenced using their names.
 
 edit()
 ------

tests/test_jira.py

@@ -512,6 +512,17 @@ def test_prepare_ticket_fields_no_parent(self):
         with self.assertRaises(KeyError):
             jira._prepare_ticket_fields(fields)
 
+    def test_prepare_ticket_fields_components(self):
+        fields = {'components': ["c1", "c2"]}
+        expected_fields = {
+            'components': [
+                {"name": "c1"},
+                {"name": "c2"}
+            ]
+        }
+        prepared_fields = jira._prepare_ticket_fields(fields)
+        self.assertEqual(prepared_fields, expected_fields)
+
 
 if __name__ == '__main__':
     main()

ticketutil/jira.py

@@ -515,6 +515,10 @@ def _prepare_ticket_fields(fields):
                 fields[key] = {'name': value}
             if key in ['parent']:
                 fields[key] = {'key': value}
+            if key in ['components']:
+                # we take in list of strings (names) and turn it into list of
+                # dicts with key "name" and value of the component name
+                fields[key] = [{"name": name} for name in fields[key]]
             if key == 'type':
                 fields['issuetype'] = {'name': value}
                 fields.pop('type')