daemail 0.3.0

Daemonize a command and e-mail the results

daemail (pronounced “DEE-mayl”, like “e-mail” but with a D) is a Python script for running a normally-foreground command in the background and sending an e-mail with its output (by default, the combined stdout and stderr) once it’s done. It should work in both Python 2.7 and Python 3.2+, the only external dependencies being the python-daemon package and the ubiquitous six package.

Usage

daemail [--chdir <directory>]
        [-D|--dead-letter <mbox>]
        [-e|--encoding <encoding>]
        [-E|--err-encoding <encoding>]
        [-f|--from|--from-addr <address>]
        [-F|--failure-only]
        [-l|--logfile <logfile>]
        [-m|--mail-cmd <command>]
        [-M|--mime-type|--mime <mime-type>]
        [-n|--nonempty]
        [--no-stdout]
        [--no-stderr]
        [--smtp-host <host>]
        [--smtp-port <port>]
        [--smtp-username <username>]
        [--smtp-password <password> | --smtp-password-file <file>]
        [--smtp-ssl | --smtp-starttls]
        [--split]
        [-Z|--utc]
        -t|--to|--to-addr <address>
        <command> [<arg> ...]

Options

• --chdir <directory> — Change to <directory> after daemonizing but before running <command>; defaults to the current directory

• -D <mbox>, --dead-letter <mbox> — If an error occurs when trying to send, append the e-mail (including a description of the error) to the file <mbox>; defaults to dead.letter. The file path is resolved relative to the directory specified with --chdir or its default. If the file does not already exist, it must be a valid mbox file.

• -e <encoding>, --encoding <encoding> — Expect the stdout (and stderr, if --split is not in effect) of <command> to be in the given encoding; defaults to the preferred encoding returned by Python’s locale.getpreferredencoding. If decoding fails, the output will be attached to the e-mail as an application/octet-stream file.

  When --mime-type is also given, this option has no effect other than to set the default value for --err-encoding.

• -E <encoding>, --err-encoding <encoding> — Expect the stderr of <command> to be in the given encoding; defaults to the value specified via --encoding or its default. If decoding fails, the stderr output will be attached to the e-mail as an application/octet-stream file.

  This option only has an effect when --split is given, either implicitly or explicitly.

• -f <address>, --from <address>, --from-addr <address> — Set the From: address of the e-mail. If not specified, daemail will not set the From: header and will expect the mail command or SMTP server to do it instead.

• -F, --failure-only — Only send an e-mail if the command failed to run or exited with a nonzero status

• -l <logfile>, --logfile <logfile> — If an unexpected & unhandleable fatal error occurs after daemonization, append a report to <logfile>; defaults to daemail.log. The file path is resolved relative to the directory specified with --chdir or its default.

  • Such an error is a deficiency in the program; please report it!

• -m <command>, --mail-cmd <command> — Send e-mail by passing the message on stdin to <command> (executed via the shell); default command: sendmail -t

  --mail-cmd and --smtp-host are mutually exclusive.

• -M <mime-type>, --mime-type <mime-type>, --mime <mime-type> — Attach the standard output of <command> to the e-mail as an inline attachment with the given MIME type. The MIME type may include parameters, e.g., --mime-type "text/html; charset=utf-16". Implies --split.

• -n, --nonempty — Do not send an e-mail if the command exited successfully and both the command’s stdout & stderr were empty or not captured

• --no-stdout — Don’t capture the command’s stdout; implies --split

• --no-stderr — Don’t capture the command’s stderr; implies --split

• --smtp-host <host> — Send e-mail via SMTP, connecting to the given host. When this option is not given, e-mail is instead sent using the command specified via --mail-cmd or its default.

  --smtp-host and --mail-cmd are mutually exclusive.

  --smtp-host may be accompanied by the following options:

  • --smtp-port <port> — Connect to <host> on the given port; defaults to 25, or to 465 if --smtp-ssl is specified

  • --smtp-username <username> — Authenticate to the SMTP server using the given username. If --smtp-username is supplied but neither --smtp-password nor --smtp-password-file is, daemail will prompt the user for the SMTP password before daemonizing.

  • --smtp-password <password> — Authenticate to the SMTP server using the given password

  • --smtp-password-file <file> — Authenticate to the SMTP server using the contents of the given file (after stripping trailing newlines) as the password

  • --smtp-ssl — Use the SMTPS protocol to communicate with the server

  • --smtp-starttls — Use the SMTP protocol with the STARTTLS extension to communicate with the server

• --split — Capture the command’s stdout and stderr separately rather than as a single stream

• -t <address>, --to <address>, --to-addr <address> — Set the recipient of the e-mail; this option is required

• -Z, --utc — Show start & end times in UTC instead of local time