cmail

Crates.iocmail
lib.rscmail
version0.3.0
sourcesrc
created_at2015-07-14 04:22:32.362295
updated_at2018-08-01 00:14:27.854557
descriptionSend email with the output of long running commands.
homepagehttps://github.com/BurntSushi/rust-cmail
repositoryhttps://github.com/BurntSushi/rust-cmail
max_upload_size
id2603
size26,291
Andrew Gallant (BurntSushi)

documentation

README

A command line utility for sending periodic email with the output of long running commands.

Build status

Dual-licensed under MIT or the UNLICENSE.

Installation

Currently, you have to build with Cargo, Rust's package manager. I'll hopefully release binaries soon.

git clone git://github.com/BurntSushi/rust-cmail
cd rust-cmail
cargo build --release
./target/release/cmail --help

Usage

Usage: cmail [options] [<args> ...]

Options:
    -h, --help             Display this help message.
    -p ARG, --period ARG   Data is emailed at this period in seconds.
                           Set to 0 to disable and send only one email
                           when the command completes.
                           [default: 900]
    -s, --silent           Don't pass the command's stdout/stderr to the
                           terminal. Instead, only send stdout/stderr
                           in email.
    -a, --send-all         Send the entire command's output on each email.
                           N.B. This saves all output in memory.
    -t ARG, --to ARG       The email address to send to. By default, this
                           is set to $EMAIL. If neither $EMAIL nor --to
                           are set, then an error is returned.

cmail responds gracefully to signals or if the command being run is terminated unexpectedly. Internally, cmail uses sendmail to send email.

Examples

Send whatever is on stdin:

cmail <<EOF
This is going to
my email
EOF

Report all 80 column violations in Lua files. Don't show output in terminal:

find ./ -name '*.lua' -print0 | xargs -0 colcheck | cmail -s

Run a du command on a huge directory, and send an incremental email update every 10 seconds (the default is 15 minutes):

cmail -p 10 du -csh *

Port from Go

This is ported from an earlier version I wrote in Go: https://github.com/BurntSushi/rust-cmail

Since this is my second run at writing this, it's a little clean this time around. All in all, I'm quite fond of the structure of both programs (well, the structure is quite similar!).

Commit count: 19

cargo fmt