diff options
| author | Gauvain Pocentek <gauvain@pocentek.net> | 2018-05-20 09:01:05 +0200 |
|---|---|---|
| committer | Gauvain Pocentek <gauvain@pocentek.net> | 2018-05-20 09:01:05 +0200 |
| commit | 5292ffb366f97e4dc611dfd49a1dca7d1e934f4c (patch) | |
| tree | 220659b39e0e5384504de3c63bbff003ad50eec2 /docs/gl_objects/messages.rst | |
| parent | 2c342372814bbac2203d7b4c0f2cd32541bab979 (diff) | |
| download | gitlab-5292ffb366f97e4dc611dfd49a1dca7d1e934f4c.tar.gz | |
[docs] Rework the examples pages
* Get rid of the .py files and bring all the python examples in the RST
files
* Fix a few things
Diffstat (limited to 'docs/gl_objects/messages.rst')
| -rw-r--r-- | docs/gl_objects/messages.rst | 42 |
1 files changed, 15 insertions, 27 deletions
diff --git a/docs/gl_objects/messages.rst b/docs/gl_objects/messages.rst index 452370d..32fbb95 100644 --- a/docs/gl_objects/messages.rst +++ b/docs/gl_objects/messages.rst @@ -15,46 +15,34 @@ References + :class:`gitlab.v4.objects.BroadcastMessageManager` + :attr:`gitlab.Gitlab.broadcastmessages` -* v3 API: - - + :class:`gitlab.v3.objects.BroadcastMessage` - + :class:`gitlab.v3.objects.BroadcastMessageManager` - + :attr:`gitlab.Gitlab.broadcastmessages` - * GitLab API: https://docs.gitlab.com/ce/api/broadcast_messages.html Examples -------- -List the messages: +List the messages:: -.. literalinclude:: messages.py - :start-after: # list - :end-before: # end list + msgs = gl.broadcastmessages.list() -Get a single message: +Get a single message:: -.. literalinclude:: messages.py - :start-after: # get - :end-before: # end get + msg = gl.broadcastmessages.get(msg_id) -Create a message: +Create a message:: -.. literalinclude:: messages.py - :start-after: # create - :end-before: # end create + msg = gl.broadcastmessages.create({'message': 'Important information'}) -The date format for ``starts_at`` and ``ends_at`` parameters is +The date format for the ``starts_at`` and ``ends_at`` parameters is ``YYYY-MM-ddThh:mm:ssZ``. -Update a message: +Update a message:: -.. literalinclude:: messages.py - :start-after: # update - :end-before: # end update + msg.font = '#444444' + msg.color = '#999999' + msg.save() -Delete a message: +Delete a message:: -.. literalinclude:: messages.py - :start-after: # delete - :end-before: # end delete + gl.broadcastmessages.delete(msg_id) + # or + msg.delete() |