From 473dc6f50d27b2e5349bb2e7c8bc07b48e9834d1 Mon Sep 17 00:00:00 2001
From: Eric Sabouraud <esabouraud@users.noreply.github.com>
Date: Fri, 8 Jun 2018 19:11:11 +0200
Subject: Add support for project-level MR approval configuration

---
 docs/gl_objects/mr_approvals.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 docs/gl_objects/mr_approvals.rst

(limited to 'docs')

diff --git a/docs/gl_objects/mr_approvals.rst b/docs/gl_objects/mr_approvals.rst
new file mode 100644
index 0000000..69d44a5
--- /dev/null
+++ b/docs/gl_objects/mr_approvals.rst
@@ -0,0 +1,30 @@
+##############################################
+Project-level merge request approvals settings
+##############################################
+
+References
+----------
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.ProjectApproval`
+  + :class:`gitlab.v4.objects.ProjectApprovalManager`
+  + :attr:`gitlab.v4.objects.Project.approvals`
+
+* GitLab API: https://docs.gitlab.com/ee/api/merge_request_approvals.html#project-level-mr-approvals
+
+Examples
+--------
+
+Get project-level MR approvals settings::
+
+    mras = project.approvals.get()
+
+Change project-level MR approvals settings::
+
+    mras.approvals_before_merge = 2
+    mras.save()
+
+Change project-level MR allowed approvers::
+
+	project.approvals.set_approvers(approver_ids = [105], approver_group_ids=[653, 654])
-- 
cgit v1.2.1