CLI tool to send messages to the Incoming webhook of mattermost (https://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.
- Massimiliano Torromeo <[email protected]>