summaryrefslogtreecommitdiff
path: root/docs/gl_objects/badges.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/gl_objects/badges.rst')
-rw-r--r--docs/gl_objects/badges.rst52
1 files changed, 0 insertions, 52 deletions
diff --git a/docs/gl_objects/badges.rst b/docs/gl_objects/badges.rst
deleted file mode 100644
index 2a26bb3..0000000
--- a/docs/gl_objects/badges.rst
+++ /dev/null
@@ -1,52 +0,0 @@
-######
-Badges
-######
-
-Badges can be associated with groups and projects.
-
-Reference
----------
-
-* v4 API:
-
- + :class:`gitlab.v4.objects.GroupBadge`
- + :class:`gitlab.v4.objects.GroupBadgeManager`
- + :attr:`gitlab.v4.objects.Group.badges`
- + :class:`gitlab.v4.objects.ProjectBadge`
- + :class:`gitlab.v4.objects.ProjectBadgeManager`
- + :attr:`gitlab.v4.objects.Project.badges`
-
-* GitLab API:
-
- + https://docs.gitlab.com/ce/api/group_badges.html
- + https://docs.gitlab.com/ce/api/project_badges.html
-
-Examples
---------
-
-List badges::
-
- badges = group_or_project.badges.list()
-
-Get a badge::
-
- badge = group_or_project.badges.get(badge_id)
-
-Create a badge::
-
- badge = group_or_project.badges.create({'link_url': link, 'image_url': image_link})
-
-Update a badge::
-
- badge.image_link = new_link
- badge.save()
-
-Delete a badge::
-
- badge.delete()
-
-Render a badge (preview the generate URLs)::
-
- output = group_or_project.badges.render(link, image_link)
- print(output['rendered_link_url'])
- print(output['rendered_image_url'])