When a list’s
digests_enabled setting is
True, Mailman accumulates
list posts in a mailbox for eventual sending to digest members. When the size
of this mailbox reaches the list’s
digest_size_threshold, a digest is sent
to the digest members and the mailbox is cleared.
A list may also have its
True in which
case accumulated digests should be sent periodically even if
digest_size_threshold hasn’t been reached.
mailman digests command is run by cron to do the sending of periodic
digests. For this use, the
--periodic option is used with the command
run by cron at intervals determined by the site, but normally daily.
There is also a
--send option which will send accummulated digest for a
list or lists even if the list’s
digest_send_periodic setting is
Complete information about command options may be obtained by running
mailman digests --help.
>>> from mailman.testing.documentation import cli >>> command = cli('mailman.commands.cli_digests.digests') >>> command('mailman digests --help') Usage: digests [OPTIONS] Operate on digests. Options: -l, --list list Operate on this mailing list. Multiple --list options can be given. The argument can either be a List-ID or a fully qualified list name. Without this option, operate on the digests for all mailing lists. -s, --send Send any collected digests right now, even if the size threshold has not yet been met. -b, --bump Increment the digest volume number and reset the digest number to one. If given with --send, the volume number is incremented before any current digests are sent. -n, --dry-run Don't actually do anything, but in conjunction with --verbose, show what would happen. -v, --verbose Print some additional status. -p, --periodic Send any collected digests for the List only if their digest_send_periodic is set to True. --help Show this message and exit.