1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
|
#####
Epics
#####
Epics
=====
Reference
---------
* v4 API:
+ :class:`gitlab.v4.objects.GroupEpic`
+ :class:`gitlab.v4.objects.GroupEpicManager`
+ :attr:`gitlab.Gitlab.Group.epics`
* GitLab API: https://docs.gitlab.com/ee/api/epics.html (EE feature)
Examples
--------
List the epics for a group::
epics = groups.epics.list()
Get a single epic for a group::
epic = group.epics.get(epic_iid)
Create an epic for a group::
epic = group.epics.create({'title': 'My Epic'})
Edit an epic::
epic.title = 'New title'
epic.labels = ['label1', 'label2']
epic.save()
Delete an epic::
epic.delete()
Epics issues
============
Reference
---------
* v4 API:
+ :class:`gitlab.v4.objects.GroupEpicIssue`
+ :class:`gitlab.v4.objects.GroupEpicIssueManager`
+ :attr:`gitlab.Gitlab.GroupEpic.issues`
* GitLab API: https://docs.gitlab.com/ee/api/epic_issues.html (EE feature)
Examples
--------
List the issues associated with an issue::
ei = epic.issues.list()
Associate an issue with an epic::
# use the issue id, not its iid
ei = epic.issues.create({'issue_id': 4})
Move an issue in the list::
ei.move_before_id = epic_issue_id_1
# or
ei.move_after_id = epic_issue_id_2
ei.save()
Delete an issue association::
ei.delete()
|