[docs] Add an example of pipeline schedule vars listing

Gauvain Pocentek · Gauvain Pocentek · commit f7fbfca7e6a3 · 2018-11-03T09:59:42.000+01:00
Closes python-gitlab#595
diff --git a/docs/gl_objects/builds.rst b/docs/gl_objects/builds.rst
@@ -141,6 +141,13 @@ Delete a schedule::
 
     sched.delete()
 
+List schedule variables::
+
+    # note: you need to use get() to retrieve the schedule variables. The
+    # attribute is not present in the response of a list() call
+    sched = projects.pipelineschedules.get(schedule_id)
+    vars = sched.attributes['variables']
+
 Create a schedule variable::
 
     var = sched.variables.create({'key': 'foo', 'value': 'bar'})
