Add support for project-level MR approval configuration

1 files changed, 30 insertions, 0 deletions

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])