Add support for project deployments

3 files changed, 35 insertions, 0 deletions

diff --git a/docs/api-objects.rst b/docs/api-objects.rst
index 82171d0..eabefc8 100644
--- a/docs/api-objects.rst
+++ b/docs/api-objects.rst
@@ -10,6 +10,7 @@ API objects manipulation
    gl_objects/builds
    gl_objects/commits
    gl_objects/deploy_keys
+   gl_objects/deployments
    gl_objects/environments
    gl_objects/groups
    gl_objects/issues
diff --git a/docs/gl_objects/deployments.py b/docs/gl_objects/deployments.py
new file mode 100644
index 0000000..fe1613a
--- /dev/null
+++ b/docs/gl_objects/deployments.py
@@ -0,0 +1,11 @@
+# list
+deployments = gl.project_deployments.list(project_id=1)
+# or
+deployments = project.deployments.list()
+# end list
+
+# get
+deployment = gl.project_deployments.get(deployment_id, project_id=1)
+# or
+deployment = project.deployments.get(deployment_id)
+# end get
diff --git a/docs/gl_objects/deployments.rst b/docs/gl_objects/deployments.rst
new file mode 100644
index 0000000..1a679da
--- /dev/null
+++ b/docs/gl_objects/deployments.rst
@@ -0,0 +1,23 @@
+###########
+Deployments
+###########
+
+Use :class:`~gitlab.objects.ProjectDeployment` objects to manipulate project
+deployments. The :attr:`gitlab.Gitlab.project_deployments`, and
+:attr:`Project.deployments <gitlab.objects.Project.deployments>` manager
+objects provide helper functions.
+
+Examples
+--------
+
+List deployments for a project:
+
+.. literalinclude:: deployments.py
+   :start-after: # list
+   :end-before: # end list
+
+Get a single deployment:
+
+.. literalinclude:: deployments.py
+   :start-after: # get
+   :end-before: # end get