Library and CLI utility to send messages to mattermost's incoming webhooks
CLI tool to send messages to the Incoming webhook of mattermost (http://www.mattermost.org/).
usage: mattersend [-h] [-V] [-C CONFIG] [-s SECTION] [-c CHANNEL] [-U URL] [-u USERNAME] [-i ICON] [-t [DIALECT] | -y SYNTAX] [-n] [-f FILE] Sends messages to mattermost's incoming webhooks via CLI optional arguments: -h, --help show this help message and exit -V, --version show program's version number and exit -C CONFIG, --config CONFIG Use a different configuration file -s SECTION, --section SECTION Configuration file section -c CHANNEL, --channel CHANNEL Send to this channel or @username -U URL, --url URL Mattermost webhook URL -u USERNAME, --username USERNAME Username -i ICON, --icon ICON Icon -t [DIALECT], --tabular [DIALECT] Parse input as CSV and format it as a table (DIALECT can be one of sniff, excel, excel-tab, unix) -y SYNTAX, --syntax SYNTAX -n, --dry-run, --just-print Don't send, just print the payload -f FILE, --file FILE Read content from FILE. If - reads from standard input (DEFAULT: -)
The only required option to start sending messages to mattermost is the webhook url. You can either set this in a configurations file (globally in /etc/mattersend.conf or locally in $HOME/.mattersend.conf) or specify it on the CLI with the –url argument.
You can have multiple sections to override DEFAULT settings and later select them from the CLI with the –section argument.
This is an example of a configuration file for mattersend:
[DEFAULT] url = https://mattermost.example.com/hooks/XXXXXXXXXXXXXXXXXXXXXXX icon = :ghost: username = This is a bot channel = @myself [angrybot] icon = :angry: username = AngryBot
echo "Hello world!" | mattersend -U https://mattermost.example.com/hooks/XXX # you can omit -U with mattersend.conf echo "Hello world!" | mattersend # send file content mattersend -f todo.txt # table data echo -e "ABC;DEF;GHI\nfoo;bar;baz" | mattersend -t
Copyright (c) 2016 Massimiliano Torromeo
mattersend is free software released under the terms of the BSD license.
See the LICENSE file provided with the source distribution for full details.