Add support for broadcast messages API

2 files changed, 69 insertions, 0 deletions

diff --git a/docs/gl_objects/messages.py b/docs/gl_objects/messages.py
new file mode 100644
index 0000000..74714e5
--- /dev/null
+++ b/docs/gl_objects/messages.py
@@ -0,0 +1,23 @@
+# list
+msgs = gl.broadcastmessages.list()
+# end list
+
+# get
+msg = gl.broadcastmessages.get(msg_id)
+# end get
+
+# create
+msg = gl.broadcastmessages.create({'message': 'Important information'})
+# end create
+
+# update
+msg.font = '#444444'
+msg.color = '#999999'
+msg.save()
+# end update
+
+# delete
+gl.broadcastmessages.delete(msg_id)
+# or
+msg.delete()
+# end delete
diff --git a/docs/gl_objects/messages.rst b/docs/gl_objects/messages.rst
new file mode 100644
index 0000000..9f183ba
--- /dev/null
+++ b/docs/gl_objects/messages.rst
@@ -0,0 +1,46 @@
+##################
+Broadcast messages
+##################
+
+You can use broadcast messages to display information on all pages of the
+gitlab web UI. You must have administration permissions to manipulate broadcast
+messages.
+
+* Object class: :class:`gitlab.objects.BroadcastMessage`
+* Manager object: :attr:`gitlab.Gitlab.broadcastmessages`
+
+Examples
+--------
+
+List the messages:
+
+.. literalinclude:: messages.py
+   :start-after: # list
+   :end-before: # end list
+
+Get a single message:
+
+.. literalinclude:: messages.py
+   :start-after: # get
+   :end-before: # end get
+
+Create a message:
+
+.. literalinclude:: messages.py
+   :start-after: # create
+   :end-before: # end create
+
+The date format for ``starts_at`` and ``ends_at`` parameters is
+``YYYY-MM-ddThh:mm:ssZ``.
+
+Update a message:
+
+.. literalinclude:: messages.py
+   :start-after: # update
+   :end-before: # end update
+
+Delete a message:
+
+.. literalinclude:: messages.py
+   :start-after: # delete
+   :end-before: # end delete