Send notifications to Slack or Mattermost using Robot Framework.
Project description
RobotNotifications
Send notifications to Slack or Mattermost using Robot Framework.
Installation
The recommended installation method is pip:
pip install robotframework-notifications
Running this command installs also the latest version of Requests
Import Library
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.
*** Settings ***
Library RobotNotifications https://hooks.slack.com/services/--your-webhook--
You can retrieve this webhook url in Slack or Mattermost.
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
Usage
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--
Suite Setup Start Suite
Test Teardown Message On Failure
*** Keywords ***
Start Suite
Post Message To Channel Testing has started! icon_emoji=robot_face username=Robot
... channel=robot-notifications
Message On Failure
Run Keyword If Test Failed Post Message To Channel ${TEST_NAME}\n${TEST_MESSAGE}
... icon_emoji=rage username=Robot Error channel=robot-notifications
*** Test Cases ***
This Test Will Pass
Log This Test Will Pass
This Test Will Fail
Log ${ERROR}
The above example shows how the Post Message To Channel
can be used in Robot Framework.
You can for example use the keyword in a test teardown to post a message if the test failed containing the test name and error message.
Automatic variables
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.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c87161076a0c30f853c127ecfe8b36679c528d277c877571069729710e3e4aee |
|
MD5 | d3815842ac13bca5c495268acf238ca0 |
|
BLAKE2b-256 | 6dc8307f96870a0c2c02514f2768a382c66ae0b9ef9fc3903455eaddee762e59 |
Hashes for robotframework_notifications-1.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 69a45ad978e0d552756f97e27d95339f73f19a9b25d2b1ac36b030632dd9ecd7 |
|
MD5 | e33c258e58fcccb2de2351ed0e47a6c7 |
|
BLAKE2b-256 | 0ea77ae2fd9b46394bbba23055e485d88eb4a9fcef65514adc1a12d5ffecc35a |