wafflesbot sends form replies to unreplied emails in a JMAP mailbox (such as Fastmail).

wafflesbot excels at automatically asking tech recruiters for compensation information.

Built on:

• JMAP client: jmapc
• Quoted email reply assembly: replyowl

A Docker container is provided which runs wafflesbot to reply to emails via JMAP server events. JMAP API authentication and reply details should be configured using environment variables.

Example docker-compose.yaml:

Start the container by running:

Debugging information can be viewed in the container log:

wafflesbot is available on PyPI:

wafflesbot provides the waffles command, which can either:

1. Run as a service and reply to emails received via JMAP server events (the default)
2. Run as a script to examine recent emails (such as interactively or via a cronjob)

Environment variables:

• JMAP_HOST: JMAP server hostname
• JMAP_API_TOKEN: JMAP account API token

Required arguments:

• -m/--mailbox: Name of the folder to process
• -r/--reply-content: Path to file with an HTML reply message

Optional arguments:

• -d/--debug: Enable debug logging
• -l/--limit: Maximum number of emails replies to send (only valid with -s/--script)
• -n/--days: Only process email received this many days ago or newer (only valid with -s/--script)
• -p/--pretend: Print messages to standard output instead of sending email
• -s/--script: Set to run as a script instead of an event-driven service

Listen for new emails, and reply to unreplied messages that appear in the "Recruiters" folder with the message in my-reply.html:

Run as a script and reply to unreplied messages in the "Recruiters" folder with the message in my-reply.html:

Via pipx:

Via pip:

• Setup: poetry install
• Run static checks: poetry run poe lint or poetry run pre-commit run --all-files
• Run static checks and tests: poetry run poe test

Created from smkent/cookie-python using cookiecutter