Send notifications to Slack or Mattermost using Robot Framework.
Project description
RobotNotifications
Send notifications to Slack or Mattermost using Robot Framework. Can be used both as library or listener.
Installation
The recommended installation method is pip:
pip install robotframework-notifications
Running this command installs also the latest version of Requests
Use as listener
robot --listener "RobotNotifications;https://webhook_url;end_test;summary" test.robot
Listeners are taken into use from the command line with the --listener option.
- The first argument is the name of the library.
- The second argument is the webhook url.
- Based on your preferences pick the next argument(s) from the table
Seperate the arguments with a semicolon ;
Optional Arguments
Argument | Description | Example |
---|---|---|
end_suite | Post suite results | |
summary | Post a report summary | |
end_test | Post failing tests | |
end_test_all | Post all tests |
Use as library
Besides the listener functionality this library allows you to post a custom message with the use of the keyword "Post Message To Channel"
To use RobotNotifications in Robot Framework, the library needs to be imported using the Library
setting as any other library. The library needs the webhook url from Slack or Mattermost as an argument.
Example:
*** Settings ***
Library RobotNotifications https://hooks.slack.com/services/--your-webhook--
You can retrieve this webhook url in Slack or Mattermost.
Example 2:
*** Settings ***
Library RobotNotifications https://hooks.slack.com/services/--your-webhook--
... end_suite end_test
Write a custom message
After importing the library you have access to the keyword Post Message To Channel
This keyword has one mandatory argument which is the message to post to the channel, and several optional arguments.
Argument | Description | Required |
---|---|---|
text | Markdown-formatted message to display in the post. | YES |
channel | Overrides the channel the message posts in. Use the channel’s name and not the display name. Defaults to the channel set during webhook creation. | NO |
username | Overrides the username the message posts as. Defaults to the username set during webhook creation or the webhook creator’s username if the former was not set. | NO |
icon_url | Overrides the profile picture the message posts with. Defaults to the URL set during webhook creation or the webhook creator’s profile picture if the former was not set. | NO |
icon_emoji | Overrides the profile picture and icon_url parameter. Defaults to none and is not set during webhook creation. |
NO |
props | Sets the post props , a JSON property bag for storing extra or meta data on the post. |
NO |
Example:
*** Settings ***
Library RobotNotifications https://hooks.slack.com/services/--your-webhook--
*** Test Cases ***
Example Test
Post Message To Channel This is a custom message! icon_emoji=robot_face username=Robot
... channel=robot-notifications
The above example shows how the Post Message To Channel
can be used in Robot Framework.
Retrieve webhook
Slack
https://slack.com/intl/en-lv/help/articles/115005265063-incoming-webhooks-for-slack
Mattermost
https://docs.mattermost.com/developer/webhooks-incoming.html#simple-incoming-webhook
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for robotframework-notifications-1.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 954be09efd013d027c09854834ca5d11681ffeb164813271474227bcc9993bbe |
|
MD5 | 7e59a95fd5326762bcee5d4de0d1c0ff |
|
BLAKE2b-256 | 86b892110915a598b412f8502aaae10cb083b37f488c536d4bd7af9a540aaf9d |
Hashes for robotframework_notifications-1.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d843f63b63faa92d5c30d6d36eb0857b617da1f70190d04802f0accdded9caff |
|
MD5 | dd7a583b758cb8a2577f5cef688f2bda |
|
BLAKE2b-256 | 9d079ae00d15f0093865d372bde9837ffd16a16ec1c6bd6788c9830559ef5751 |